# milhaniq/pdf-tool architecture

> Architecture diagram of the GitHub repository milhaniq/pdf-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/milhaniq/pdf-tool
- Repository: https://github.com/milhaniq/pdf-tool

## Overview

PDF Tools Suite is a browser-based, client-side PDF toolkit. Users choose a feature, provide PDF files, configure options where available, and receive transformed files or archives. The main entry initializes the application and several feature modules; the README documents the additional PPTX converter. The graph preserves the distinct merge, split, compression, conversion, and annotation stages. Source excerpts and the README support the shown relationships; unsampled wiring is omitted where it cannot be verified.

Main entry points: [`js/utils/pdfUtils.js`](https://github.com/milhaniq/pdf-tool/blob/main/js/utils/pdfUtils.js) (PDF utilities), [`js/utils/uiUtils.js`](https://github.com/milhaniq/pdf-tool/blob/main/js/utils/uiUtils.js) (UI utilities), [`js/main.js`](https://github.com/milhaniq/pdf-tool/blob/main/js/main.js) (App entry), [`js/modules/annotate.js`](https://github.com/milhaniq/pdf-tool/blob/main/js/modules/annotate.js) (PDF annotation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["App entry<br/>[main.js]"]
  node_config["Settings<br/>[config.js]"]
end

subgraph group_pdf["PDF Operations"]
  node_merge["PDF merge<br/>[merge.js]"]
  node_split["PDF split<br/>[split.js]"]
  node_compress["PDF compression<br/>[compress.js]"]
  node_annotate["PDF annotation<br/>[annotate.js]"]
end

subgraph group_convert["Conversion"]
  node_excel["PDF to Excel<br/>[excel.js]"]
  node_ppt["PDF to PPTX<br/>[ppt.js]"]
end

subgraph group_shared["Shared Utilities"]
  node_pdfutils["PDF utilities<br/>[pdfUtils.js]"]
  node_uiutils["UI utilities<br/>[uiUtils.js]"]
  node_tables["Table detection<br/>[tableDetector.js]"]
  node_annutils["Annotation utilities<br/>[annotationUtils.js]"]
end

node_user(("User"))
node_browser["Browser"]

node_user -->|"opens app"| node_entry
node_entry -->|"initializes"| node_merge
node_entry -->|"initializes"| node_split
node_entry -->|"initializes"| node_excel
node_entry -->|"initializes"| node_compress
node_entry -->|"initializes"| node_annotate
node_merge -->|"uses PDF helpers"| node_pdfutils
node_split -->|"uses PDF helpers"| node_pdfutils
node_compress -->|"loads and creates PDFs"| node_pdfutils
node_annotate -->|"loads and saves PDFs"| node_pdfutils
node_excel -->|"loads PDF pages"| node_pdfutils
node_ppt -->|"loads PDF pages"| node_pdfutils
node_excel -->|"detects tables"| node_tables
node_annotate -->|"uses annotation logic"| node_annutils
node_annutils -->|"uses coordinate helpers"| node_pdfutils
node_merge -->|"updates interface"| node_uiutils
node_split -->|"updates interface"| node_uiutils
node_compress -->|"updates interface"| node_uiutils
node_annotate -->|"updates interface"| node_uiutils
node_excel -->|"updates interface"| node_uiutils
node_ppt -->|"updates interface"| node_uiutils
node_pdfutils -->|"reads settings"| node_config
node_tables -->|"reads thresholds"| node_config
node_uiutils -->|"reads settings"| node_config
node_merge -->|"offers download"| node_browser
node_split -->|"exports ZIP"| node_browser
node_compress -->|"exports files or ZIP"| node_browser
node_excel -->|"exports workbook"| node_browser
node_ppt -->|"exports presentation"| node_browser
node_annotate -->|"downloads annotated PDF"| node_browser

click node_entry "https://github.com/milhaniq/pdf-tool/blob/main/js/main.js"
click node_config "https://github.com/milhaniq/pdf-tool/blob/main/js/config.js"
click node_merge "https://github.com/milhaniq/pdf-tool/blob/main/js/modules/merge.js"
click node_split "https://github.com/milhaniq/pdf-tool/blob/main/js/modules/split.js"
click node_compress "https://github.com/milhaniq/pdf-tool/blob/main/js/modules/compress.js"
click node_annotate "https://github.com/milhaniq/pdf-tool/blob/main/js/modules/annotate.js"
click node_excel "https://github.com/milhaniq/pdf-tool/blob/main/js/modules/excel.js"
click node_ppt "https://github.com/milhaniq/pdf-tool/blob/main/js/modules/ppt.js"
click node_pdfutils "https://github.com/milhaniq/pdf-tool/blob/main/js/utils/pdfUtils.js"
click node_uiutils "https://github.com/milhaniq/pdf-tool/blob/main/js/utils/uiUtils.js"
click node_tables "https://github.com/milhaniq/pdf-tool/blob/main/js/utils/tableDetector.js"
click node_annutils "https://github.com/milhaniq/pdf-tool/blob/main/js/utils/annotationUtils.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_config,node_user,node_browser toneBlue
class node_merge,node_split,node_compress,node_annotate toneAmber
class node_excel,node_ppt toneMint
class node_pdfutils,node_uiutils,node_tables,node_annutils toneRose
```

## Components

### Application

- [App entry](https://github.com/milhaniq/pdf-tool/blob/main/js/main.js): `js/main.js`
- [Settings](https://github.com/milhaniq/pdf-tool/blob/main/js/config.js): `js/config.js`

### PDF Operations

- [PDF merge](https://github.com/milhaniq/pdf-tool/blob/main/js/modules/merge.js): `js/modules/merge.js`
- [PDF split](https://github.com/milhaniq/pdf-tool/blob/main/js/modules/split.js): `js/modules/split.js`
- [PDF compression](https://github.com/milhaniq/pdf-tool/blob/main/js/modules/compress.js): `js/modules/compress.js`
- [PDF annotation](https://github.com/milhaniq/pdf-tool/blob/main/js/modules/annotate.js): `js/modules/annotate.js`

### Conversion

- [PDF to Excel](https://github.com/milhaniq/pdf-tool/blob/main/js/modules/excel.js): `js/modules/excel.js`
- [PDF to PPTX](https://github.com/milhaniq/pdf-tool/blob/main/js/modules/ppt.js): `js/modules/ppt.js`

### Shared Utilities

- [PDF utilities](https://github.com/milhaniq/pdf-tool/blob/main/js/utils/pdfUtils.js): `js/utils/pdfUtils.js`
- [UI utilities](https://github.com/milhaniq/pdf-tool/blob/main/js/utils/uiUtils.js): `js/utils/uiUtils.js`
- [Table detection](https://github.com/milhaniq/pdf-tool/blob/main/js/utils/tableDetector.js): `js/utils/tableDetector.js`
- [Annotation utilities](https://github.com/milhaniq/pdf-tool/blob/main/js/utils/annotationUtils.js): `js/utils/annotationUtils.js`

### Other components

- **User**
- **Browser**

## Connections

- User → App entry: opens app (evidence: `README.md`)
- App entry → PDF merge: initializes (evidence: `js/main.js`)
- App entry → PDF split: initializes (evidence: `js/main.js`)
- App entry → PDF to Excel: initializes (evidence: `js/main.js`)
- App entry → PDF compression: initializes (evidence: `js/main.js`)
- App entry → PDF annotation: initializes (evidence: `js/main.js`)
- PDF merge → PDF utilities: uses PDF helpers (evidence: `js/modules/merge.js`)
- PDF split → PDF utilities: uses PDF helpers (evidence: `js/modules/split.js`)
- PDF compression → PDF utilities: loads and creates PDFs (evidence: `js/modules/compress.js`)
- PDF annotation → PDF utilities: loads and saves PDFs (evidence: `js/modules/annotate.js`)
- PDF to Excel → PDF utilities: loads PDF pages (evidence: `js/modules/excel.js`)
- PDF to PPTX → PDF utilities: loads PDF pages (evidence: `js/modules/ppt.js`)
- PDF to Excel → Table detection: detects tables (evidence: `js/modules/excel.js`)
- PDF annotation → Annotation utilities: uses annotation logic (evidence: `js/modules/annotate.js`)
- Annotation utilities → PDF utilities: uses coordinate helpers (evidence: `js/utils/annotationUtils.js`)
- PDF merge → UI utilities: updates interface (evidence: `js/modules/merge.js`)
- PDF split → UI utilities: updates interface (evidence: `js/modules/split.js`)
- PDF compression → UI utilities: updates interface (evidence: `js/modules/compress.js`)
- PDF annotation → UI utilities: updates interface (evidence: `js/modules/annotate.js`)
- PDF to Excel → UI utilities: updates interface (evidence: `js/modules/excel.js`)
- PDF to PPTX → UI utilities: updates interface (evidence: `js/modules/ppt.js`)
- PDF utilities → Settings: reads settings (evidence: `js/utils/pdfUtils.js`)
- Table detection → Settings: reads thresholds (evidence: `js/utils/tableDetector.js`)
- UI utilities → Settings: reads settings (evidence: `js/utils/uiUtils.js`)
- PDF merge → Browser: offers download (evidence: `README.md`)
- PDF split → Browser: exports ZIP (evidence: `README.md`)
- PDF compression → Browser: exports files or ZIP (evidence: `README.md`)
- PDF to Excel → Browser: exports workbook (evidence: `README.md`)
- PDF to PPTX → Browser: exports presentation (evidence: `README.md`)
- PDF annotation → Browser: downloads annotated PDF (evidence: `README.md`)
