Fix default parameter consistency and cleanup formatting

- Update tolerance default from 20 to 30 to match documentation - Update min_area default from 8000 to 10000 to match documentation - Add missing period to minimum contour area description - Replace double dashes with single hyphens in tooltip translations 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Fix TypeScript linting error in zipFileService
2025-09-26 00:05:55 +01:00 · 2025-09-26 00:01:21 +01:00 · 2025-09-25 23:55:57 +01:00 · 2025-09-25 23:44:20 +01:00 · 2025-09-25 23:23:17 +01:00 · 2025-09-25 23:17:49 +01:00
16 changed files with 568 additions and 274 deletions
@@ -229,7 +229,7 @@ public class MergeController {
            if (!invalidIndexes.isEmpty()) {
                // Parse client file IDs (always present from frontend)
                String[] clientIds = parseClientFileIds(request.getClientFileIds());
-                
+
                // Map invalid indexes to client IDs
                List<String> errorFileIds = new ArrayList<>();
                for (Integer index : invalidIndexes) {
@@ -237,12 +237,12 @@ public class MergeController {
                        errorFileIds.add(clientIds[index]);
                    }
                }
-                
-                String payload = String.format(
-                    "{\"errorFileIds\":%s,\"message\":\"Some of the selected files can't be merged\"}",
-                    errorFileIds.toString()
-                );
-                
+
+                String payload =
+                        String.format(
+                                "{\"errorFileIds\":%s,\"message\":\"Some of the selected files can't be merged\"}",
+                                errorFileIds.toString());
+
                return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY)
                        .header("Content-Type", MediaType.APPLICATION_JSON_VALUE)
                        .body(payload.getBytes(StandardCharsets.UTF_8));
@@ -6,11 +6,6 @@ http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

-    # Add .mjs MIME type mapping
-    types {
-        text/javascript mjs;
-    }
-
    # Gzip compression
    gzip on;
    gzip_vary on;
@@ -95,14 +90,6 @@ http {
            proxy_set_header X-Forwarded-Port $server_port;
        }

-        # Serve .mjs files with correct MIME type (must come before general static assets)
-        location ~* \.mjs$ {
-            try_files $uri =404;
-            add_header Content-Type "text/javascript; charset=utf-8" always;
-            expires 1y;
-            add_header Cache-Control "public, immutable";
-        }
-
        # Cache static assets
        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
            expires 1y;
@@ -10,22 +10,21 @@
      "license": "SEE LICENSE IN https://raw.githubusercontent.com/Stirling-Tools/Stirling-PDF/refs/heads/main/proprietary/LICENSE",
      "dependencies": {
        "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
-        "@embedpdf/core": "^1.3.0",
+        "@embedpdf/core": "^1.2.1",
        "@embedpdf/engines": "^1.2.1",
-        "@embedpdf/plugin-export": "^1.3.0",
-        "@embedpdf/plugin-interaction-manager": "^1.3.0",
-        "@embedpdf/plugin-loader": "^1.3.0",
-        "@embedpdf/plugin-pan": "^1.3.0",
-        "@embedpdf/plugin-render": "^1.3.0",
-        "@embedpdf/plugin-rotate": "^1.3.0",
-        "@embedpdf/plugin-scroll": "^1.3.0",
-        "@embedpdf/plugin-search": "^1.3.0",
-        "@embedpdf/plugin-selection": "^1.3.0",
-        "@embedpdf/plugin-spread": "^1.3.0",
-        "@embedpdf/plugin-thumbnail": "^1.3.0",
-        "@embedpdf/plugin-tiling": "^1.3.0",
-        "@embedpdf/plugin-viewport": "^1.3.0",
-        "@embedpdf/plugin-zoom": "^1.3.0",
+        "@embedpdf/plugin-interaction-manager": "^1.2.1",
+        "@embedpdf/plugin-loader": "^1.2.1",
+        "@embedpdf/plugin-pan": "^1.2.1",
+        "@embedpdf/plugin-render": "^1.2.1",
+        "@embedpdf/plugin-rotate": "^1.2.1",
+        "@embedpdf/plugin-scroll": "^1.2.1",
+        "@embedpdf/plugin-search": "^1.2.1",
+        "@embedpdf/plugin-selection": "^1.2.1",
+        "@embedpdf/plugin-spread": "^1.2.1",
+        "@embedpdf/plugin-thumbnail": "^1.2.1",
+        "@embedpdf/plugin-tiling": "^1.2.1",
+        "@embedpdf/plugin-viewport": "^1.2.1",
+        "@embedpdf/plugin-zoom": "^1.2.1",
        "@emotion/react": "^11.14.0",
        "@emotion/styled": "^11.14.1",
        "@iconify/react": "^6.0.2",
@@ -489,13 +488,12 @@
      }
    },
    "node_modules/@embedpdf/core": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/core/-/core-1.3.0.tgz",
-      "integrity": "sha512-KEic1NA9JrtNRoTq3O3m93YTglRKweR6uqjzX3sLGCmy+LsUjiH5WOCJAztlSlmZEXysAlZlyzG/09gz4tpBAg==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/core/-/core-1.2.1.tgz",
+      "integrity": "sha512-2VwRPsN3+LmaBrD8TCN1t1ni/Vc9CxAfl/SApDjZYwE7zOieQT4ZHt+nkgF0F4I3xSgvvyHDjmOonhjBIrT6xA==",
      "dependencies": {
-        "@embedpdf/engines": "1.3.0",
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/engines": "1.2.1",
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
        "preact": "^10.26.4",
@@ -505,13 +503,13 @@
      }
    },
    "node_modules/@embedpdf/engines": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/engines/-/engines-1.3.0.tgz",
-      "integrity": "sha512-6WbYwxtCCjOazEMGKbhKRkos6S1VkzI4R2u6dUuIsUw9G2HLP4bwJCBKj9A0FuMAJkKQ3VL5eVCSGfqaCaRoyQ==",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/engines/-/engines-1.2.1.tgz",
+      "integrity": "sha512-nhycZ7Buq2B34dcpo6n7RdFwdhwTvKzvnRy7QX+uU00Dz5vftkCG4OK+pBVzxE4y7vAu+Yb4wNpdc7HmIj3B6w==",
      "license": "MIT",
      "dependencies": {
-        "@embedpdf/models": "1.3.0",
-        "@embedpdf/pdfium": "1.3.0"
+        "@embedpdf/models": "1.2.1",
+        "@embedpdf/pdfium": "1.2.1"
      },
      "peerDependencies": {
        "preact": "^10.26.4",
@@ -521,43 +519,26 @@
      }
    },
    "node_modules/@embedpdf/models": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/models/-/models-1.3.0.tgz",
-      "integrity": "sha512-LIY6T+nQoc1hi6nq1NlH6sR43J3PYOg9Bux8ouEnKjEGiZMgyd1cMxhBfrrY+Ft6DsSkqqujFOVEwjeYQYy3dg==",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/models/-/models-1.2.1.tgz",
+      "integrity": "sha512-FzJU51jsqihfgt50B00FEpgyym87/Dn2iGmMq4++Vu/oO6qBx/y69m4/cCAh4p4KkTJsvKNWC7T7dwSKa0FjHA==",
      "license": "MIT"
    },
    "node_modules/@embedpdf/pdfium": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/pdfium/-/pdfium-1.3.0.tgz",
-      "integrity": "sha512-rSBFYjxwQ58L/HcqR0l5Vv4G5t+CCOKlFYrDReTZYNN7fhzKPUWbXUn4ARahZWCNmF8svHumV2P4ArakJJviuw==",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/pdfium/-/pdfium-1.2.1.tgz",
+      "integrity": "sha512-QWf1jg7EqUlku2q6KYhlXCNfk5IAykFerPuzKJepHTeAEaRcAfu84fJgEsoUTCK4D6dfzVNp2Iuxw6Kv7MpSeg==",
      "license": "MIT"
    },
-    "node_modules/@embedpdf/plugin-export": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-export/-/plugin-export-1.3.0.tgz",
-      "integrity": "sha512-R6VItLmXmXbb0/4AsH1YGUZd0c64K/8kxQd0XAvgUJwcL7Z4s8bLsqRx4sVQqwVllaPEJbAdFn1CC/ymkGB+fg==",
-      "license": "MIT",
-      "dependencies": {
-        "@embedpdf/models": "1.3.0"
-      },
-      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "preact": "^10.26.4",
-        "react": ">=16.8.0",
-        "react-dom": ">=16.8.0",
-        "vue": ">=3.2.0"
-      }
-    },
    "node_modules/@embedpdf/plugin-interaction-manager": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-interaction-manager/-/plugin-interaction-manager-1.3.0.tgz",
-      "integrity": "sha512-iMG7mW+4YpNjBeSAcC5kK9VnjwmNu71HTxVtKnN73t3EBfukbMH4y7Tp2ds+4I97H6vc18RK5xuUCSesEOBgww==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-interaction-manager/-/plugin-interaction-manager-1.2.1.tgz",
+      "integrity": "sha512-HhEBuDjDNMH6wu76Eo3yHwjG01U1lNZShkOsFoib/rtx8HByTgZS8iVpovaOprr6gfS04ZLqWcsN1nt5qAH90w==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
+        "@embedpdf/core": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -565,15 +546,14 @@
      }
    },
    "node_modules/@embedpdf/plugin-loader": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-loader/-/plugin-loader-1.3.0.tgz",
-      "integrity": "sha512-tkOa1UwFOimueSxxm2hRAAh64K75itDvUO6wHjb5X5s0Hx4DccfrJ7KusDhxBkeQLFXtZknPG0Q2/9T+joAqeQ==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-loader/-/plugin-loader-1.2.1.tgz",
+      "integrity": "sha512-VblKErfEiHcVao18TfCmc0UJlKAkqxE29DaLJrXQHGUw/qc+pC9HlvMVpDz3+Eb13UafYS6ZUZuEng2/fQ+JJw==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
+        "@embedpdf/core": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -581,17 +561,16 @@
      }
    },
    "node_modules/@embedpdf/plugin-pan": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-pan/-/plugin-pan-1.3.0.tgz",
-      "integrity": "sha512-tZxUpX9dvd/VDHCTqM9Yjss4M8pkJWFUA5GDNmPkExRXIASuB98wEP8fh0rQt13TEZ30rV77cEsNXngju56kjg==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-pan/-/plugin-pan-1.2.1.tgz",
+      "integrity": "sha512-/BTOyRl31tvnCmoLs4qNPROMRLaG34jGYNyMQquB0uPUXZjwdMloikriwos91qCOLUrhvs4SaDpC3Ghv2BO5kA==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-interaction-manager": "1.3.0",
-        "@embedpdf/plugin-viewport": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-interaction-manager": "1.2.1",
+        "@embedpdf/plugin-viewport": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -599,15 +578,14 @@
      }
    },
    "node_modules/@embedpdf/plugin-render": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-render/-/plugin-render-1.3.0.tgz",
-      "integrity": "sha512-ZyxoGIIUa2HBLt1IB64EdWqBxHh01AX/1HJ7/cnoQK1h/oKXRbMAX6Mb23JCh2PGa4sGeyV3psoFMt037Eew3g==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-render/-/plugin-render-1.2.1.tgz",
+      "integrity": "sha512-iMfuVJqttJmm7Zb8oOaqNVNrC3NS57bDNNAc4MIc2f2TxIFSznvBPlwWN+PN45qNcTQiGzFc1ZMqIQDOG4qFnQ==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
+        "@embedpdf/core": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -615,15 +593,14 @@
      }
    },
    "node_modules/@embedpdf/plugin-rotate": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-rotate/-/plugin-rotate-1.3.0.tgz",
-      "integrity": "sha512-EyLLwf9VKQCsMRTe0KwGe+ZAaFqmcYS5WW/qqPBNfvSuBaybNpdI+C72IQFr41X7cYQV58OgEL3bfDb1MBPGHQ==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-rotate/-/plugin-rotate-1.2.1.tgz",
+      "integrity": "sha512-UhHds5donLDXm3i9nKrhSmo3yawVtjb6gID0MDrhj3+Lci/YQ3wDvGUhk7dNmgLcOt7G8pMa0wesnnpVWirUXA==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
+        "@embedpdf/core": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -631,16 +608,15 @@
      }
    },
    "node_modules/@embedpdf/plugin-scroll": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-scroll/-/plugin-scroll-1.3.0.tgz",
-      "integrity": "sha512-o1n6Mkoc92BHAkoCX0mSLXgOj4uAkokNbvP+2QMijShzTsl95gU5UzK6siZ5o6WgZBznJcceYmLuPR5ODqZDWg==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-scroll/-/plugin-scroll-1.2.1.tgz",
+      "integrity": "sha512-I1haDXIOzs59uhOWEP6UvP5jzjcQHMLQuQbfRVJM0zdWU6t3jwSfcwPUI7iv4CAAepbuyJKL328yc8736r/FYw==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-viewport": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-viewport": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -648,16 +624,15 @@
      }
    },
    "node_modules/@embedpdf/plugin-search": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-search/-/plugin-search-1.3.0.tgz",
-      "integrity": "sha512-DilSRfPQR38picjx7eyyuXNeduD7hcW/PjT9DZrjXxfLrAQtd17CXJs7HtJevl1wErh/CCSvZlHhjp1++O6GAg==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-search/-/plugin-search-1.2.1.tgz",
+      "integrity": "sha512-sl9FBQzbOBtdmPpf6UI0bnWCTPWDkj47rTxyK07bpnGfGuFof4zhcxmMaFdyP7zqBh4Y9XqGu4A0uMTO2d/t7g==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-loader": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-loader": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -665,17 +640,16 @@
      }
    },
    "node_modules/@embedpdf/plugin-selection": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-selection/-/plugin-selection-1.3.0.tgz",
-      "integrity": "sha512-1PEtreNofysaLxZvgO2CSNCxXhevjYnBdu4IHTFeJKXoq3ckKwkX8fJjyyN4D6+6uXZsnFkHhewl1yKCfKWAWw==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-selection/-/plugin-selection-1.2.1.tgz",
+      "integrity": "sha512-wgG1X1sl6sed3pv7WLIO74SX0x3389/ax+/OLMty/LFbDNYMRO+n8ZQss8aUM700HARIqkPJy7UoSQt91o4nwA==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-interaction-manager": "1.3.0",
-        "@embedpdf/plugin-viewport": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-interaction-manager": "1.2.1",
+        "@embedpdf/plugin-viewport": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -683,16 +657,15 @@
      }
    },
    "node_modules/@embedpdf/plugin-spread": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-spread/-/plugin-spread-1.3.0.tgz",
-      "integrity": "sha512-oRLimcod8RhdknN94CQeG+0QndQeiZKIhFUCXDIGxN1Z/qvspZCUty2TC+1kc3G318nZi55pWWphq9sB7ZpqEw==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-spread/-/plugin-spread-1.2.1.tgz",
+      "integrity": "sha512-rpadnutT1wSdBQV7RQz40zYdKgCRgmJde/tamgB8oHQypcnZGQcAG6/ZfX5j12s9pG18hKwwL+KmMoBnXD9IjQ==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-loader": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-loader": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -700,34 +673,32 @@
      }
    },
    "node_modules/@embedpdf/plugin-thumbnail": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-thumbnail/-/plugin-thumbnail-1.3.0.tgz",
-      "integrity": "sha512-w2wzL7m6/sUF54sMVEi8Y8+7VE3BcZqI8THDqobkEkno4Dgmb77FHNPFD6YtAhaRmIoyPnlZf05RDd6Z8ohhkQ==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-thumbnail/-/plugin-thumbnail-1.2.1.tgz",
+      "integrity": "sha512-TjHPkK8p3+FDMLcUdb3/4VREjm+liVooufLPVZ3FCXHbiC0PeUkqnwAxpCS2Jw1n+EtkY8pefRdRJeZhO6plOQ==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-render": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-render": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0"
      }
    },
    "node_modules/@embedpdf/plugin-tiling": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-tiling/-/plugin-tiling-1.3.0.tgz",
-      "integrity": "sha512-huYi4BJa9KSfqC424bEHw72KBLCR2rfApMeKnpUzAFSdWA6MSYmVBSk8ghnU7XbcLuL6fFBarNsziNrSSnVWTw==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-tiling/-/plugin-tiling-1.2.1.tgz",
+      "integrity": "sha512-C9uOGVIsoxUw+uQMXfJFZ8ibRLQeNOnaKC2izjx967iGu0ZoecAv+mKtH/Ge0vMEKYM1109AlF5T2EGwKQW2YA==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-render": "1.3.0",
-        "@embedpdf/plugin-scroll": "1.3.0",
-        "@embedpdf/plugin-viewport": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-render": "1.2.1",
+        "@embedpdf/plugin-scroll": "1.2.1",
+        "@embedpdf/plugin-viewport": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -735,15 +706,14 @@
      }
    },
    "node_modules/@embedpdf/plugin-viewport": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-viewport/-/plugin-viewport-1.3.0.tgz",
-      "integrity": "sha512-AZ7U8DEgEQ8nK5kdrqtukLl5au9NE3mIlFmloyo6Ddrt2rN/Jw1Lt9dsl6wU20GcFQX+hWsg9uAJboLq6AdOCA==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-viewport/-/plugin-viewport-1.2.1.tgz",
+      "integrity": "sha512-yvftOis7FLBjM3w2VYO5LXVKXoHkmFV/SPy7U6SbuLJTX126F4ohSij9euMHJjaqOgr5tBNvrf4xemVRglxM9w==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0"
+        "@embedpdf/models": "1.2.1"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
+        "@embedpdf/core": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -751,19 +721,18 @@
      }
    },
    "node_modules/@embedpdf/plugin-zoom": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-zoom/-/plugin-zoom-1.3.0.tgz",
-      "integrity": "sha512-1VA9aFxoP+BoEpwlR0//jtlD9ESS8nhU8OGGHBRu7IgoWzIx4GqOHgpgXVxzFl9IaLOv69E9DVmwe/yaC6F+0g==",
-      "license": "MIT",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@embedpdf/plugin-zoom/-/plugin-zoom-1.2.1.tgz",
+      "integrity": "sha512-hsp/nM4C8q0FM9P6FkpQLbU8IYawUgmiYgD3HXqHWBVRk30OIaXs4N0KC9vsHwn8ZAiyLl7jhlAXpgoacH5xEQ==",
      "dependencies": {
-        "@embedpdf/models": "1.3.0",
+        "@embedpdf/models": "1.2.1",
        "hammerjs": "^2.0.8"
      },
      "peerDependencies": {
-        "@embedpdf/core": "1.3.0",
-        "@embedpdf/plugin-interaction-manager": "1.3.0",
-        "@embedpdf/plugin-scroll": "1.3.0",
-        "@embedpdf/plugin-viewport": "1.3.0",
+        "@embedpdf/core": "1.2.1",
+        "@embedpdf/plugin-interaction-manager": "1.2.1",
+        "@embedpdf/plugin-scroll": "1.2.1",
+        "@embedpdf/plugin-viewport": "1.2.1",
        "preact": "^10.26.4",
        "react": ">=16.8.0",
        "react-dom": ">=16.8.0",
@@ -6,22 +6,21 @@
  "proxy": "http://localhost:8080",
  "dependencies": {
    "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
-    "@embedpdf/core": "^1.3.0",
+    "@embedpdf/core": "^1.2.1",
    "@embedpdf/engines": "^1.2.1",
-    "@embedpdf/plugin-export": "^1.3.0",
-    "@embedpdf/plugin-interaction-manager": "^1.3.0",
-    "@embedpdf/plugin-loader": "^1.3.0",
-    "@embedpdf/plugin-pan": "^1.3.0",
-    "@embedpdf/plugin-render": "^1.3.0",
-    "@embedpdf/plugin-rotate": "^1.3.0",
-    "@embedpdf/plugin-scroll": "^1.3.0",
-    "@embedpdf/plugin-search": "^1.3.0",
-    "@embedpdf/plugin-selection": "^1.3.0",
-    "@embedpdf/plugin-spread": "^1.3.0",
-    "@embedpdf/plugin-thumbnail": "^1.3.0",
-    "@embedpdf/plugin-tiling": "^1.3.0",
-    "@embedpdf/plugin-viewport": "^1.3.0",
-    "@embedpdf/plugin-zoom": "^1.3.0",
+    "@embedpdf/plugin-interaction-manager": "^1.2.1",
+    "@embedpdf/plugin-loader": "^1.2.1",
+    "@embedpdf/plugin-pan": "^1.2.1",
+    "@embedpdf/plugin-render": "^1.2.1",
+    "@embedpdf/plugin-rotate": "^1.2.1",
+    "@embedpdf/plugin-scroll": "^1.2.1",
+    "@embedpdf/plugin-search": "^1.2.1",
+    "@embedpdf/plugin-selection": "^1.2.1",
+    "@embedpdf/plugin-spread": "^1.2.1",
+    "@embedpdf/plugin-thumbnail": "^1.2.1",
+    "@embedpdf/plugin-tiling": "^1.2.1",
+    "@embedpdf/plugin-viewport": "^1.2.1",
+    "@embedpdf/plugin-zoom": "^1.2.1",
    "@emotion/react": "^11.14.0",
    "@emotion/styled": "^11.14.1",
    "@iconify/react": "^6.0.2",
@@ -436,8 +436,8 @@
    },
    "scannerImageSplit": {
      "tags": "detect,split,photos",
-      "title": "Detect/Split Scanned photos",
-      "desc": "Splits multiple photos from within a photo/PDF"
+      "title": "Detect & Split Scanned Photos",
+      "desc": "Detect and split scanned photos into separate pages"
    },
    "sign": {
      "tags": "signature,autograph",
@@ -1656,18 +1656,48 @@
    "tags": "separate,auto-detect,scans,multi-photo,organize",
    "selectText": {
      "1": "Angle Threshold:",
-      "2": "Sets the minimum absolute angle required for the image to be rotated (default: 10).",
+      "2": "Tilt (in degrees) needed before we auto-straighten a photo.",
      "3": "Tolerance:",
-      "4": "Determines the range of colour variation around the estimated background colour (default: 30).",
+      "4": "How closely a colour must match the page background to count as background. Higher = looser, lower = stricter.",
      "5": "Minimum Area:",
-      "6": "Sets the minimum area threshold for a photo (default: 10000).",
+      "6": "Smallest photo size (in pixels²) we'll keep to avoid tiny fragments.",
      "7": "Minimum Contour Area:",
-      "8": "Sets the minimum contour area threshold for a photo",
+      "8": "Smallest edge/shape we consider when finding photos (filters dust and specks).",
      "9": "Border Size:",
-      "10": "Sets the size of the border added and removed to prevent white borders in the output (default: 1)."
+      "10": "Extra padding (in pixels) around each saved photo so edges aren't cut."
    },
    "info": "Python is not installed. It is required to run."
  },
+  "scannerImageSplit": {
+    "title": "Extracted Images",
+    "submit": "Extract Image Scans",
+    "error": {
+      "failed": "An error occurred while extracting image scans."
+    },
+    "tooltip": {
+      "title": "Photo Splitter",
+      "whatThisDoes": "What this does",
+      "whatThisDoesDesc": "Automatically finds and extracts each photo from a scanned page or composite image—no manual cropping.",
+      "whenToUse": "When to use",
+      "useCase1": "Scan whole album pages in one go",
+      "useCase2": "Split flatbed batches into separate files",
+      "useCase3": "Break collages into individual photos",
+      "useCase4": "Pull photos from documents",
+      "quickFixes": "Quick fixes",
+      "problem1": "Photos not detected → increase Tolerance to 30-50",
+      "problem2": "Too many false detections → increase Minimum Area to 15,000-20,000",
+      "problem3": "Crops are too tight → increase Border Size to 5-10",
+      "problem4": "Tilted photos not straightened → lower Angle Threshold to ~5°",
+      "problem5": "Dust/noise boxes → increase Minimum Contour Area to 1000-2000",
+      "setupTips": "Setup tips",
+      "tip1": "Use a plain, light background",
+      "tip2": "Leave a small gap (≈1 cm) between photos",
+      "tip3": "Scan at 300-600 DPI",
+      "tip4": "Clean the scanner glass",
+      "headsUp": "Heads-up",
+      "headsUpDesc": "Overlapping photos or backgrounds very close in colour to the photos can reduce accuracy-try a lighter or darker background and leave more space."
+    }
+  },
  "sign": {
    "title": "Sign",
    "header": "Sign PDFs",
@@ -66,9 +66,6 @@ export default function RightRail() {

  const { totalItems, selectedCount } = getSelectionState();

-  // Get export state for viewer mode
-  const exportState = viewerContext?.getExportState?.();
-
  const handleSelectAll = useCallback(() => {
    if (currentView === 'fileEditor' || currentView === 'viewer') {
      // Select all file IDs
@@ -99,10 +96,7 @@ export default function RightRail() {
  }, [currentView, setSelectedFiles, pageEditorFunctions]);

  const handleExportAll = useCallback(() => {
-    if (currentView === 'viewer') {
-      // Use EmbedPDF export functionality for viewer mode
-      viewerContext?.exportActions?.download();
-    } else if (currentView === 'fileEditor') {
+    if (currentView === 'fileEditor' || currentView === 'viewer') {
      // Download selected files (or all if none selected)
      const filesToDownload = selectedFiles.length > 0 ? selectedFiles : activeFiles;

@@ -119,7 +113,7 @@ export default function RightRail() {
      // Export all pages (not just selected)
      pageEditorFunctions?.onExportAll?.();
    }
-  }, [currentView, activeFiles, selectedFiles, pageEditorFunctions, viewerContext]);
+  }, [currentView, activeFiles, selectedFiles, pageEditorFunctions]);

  const handleCloseSelected = useCallback(() => {
    if (currentView !== 'fileEditor') return;
@@ -451,9 +445,7 @@ export default function RightRail() {
                radius="md"
                className="right-rail-icon"
                onClick={handleExportAll}
-                disabled={
-                  currentView === 'viewer' ? !exportState?.canExport : totalItems === 0
-                }
+                disabled={currentView === 'viewer' || totalItems === 0}
              >
                <LocalIcon icon="download" width="1.5rem" height="1.5rem" />
              </ActionIcon>
@@ -0,0 +1,74 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+import { NumberInput, Stack } from '@mantine/core';
+import { ScannerImageSplitParameters } from '../../../hooks/tools/scannerImageSplit/useScannerImageSplitParameters';
+
+interface ScannerImageSplitSettingsProps {
+  parameters: ScannerImageSplitParameters;
+  onParameterChange: <K extends keyof ScannerImageSplitParameters>(key: K, value: ScannerImageSplitParameters[K]) => void;
+  disabled?: boolean;
+}
+
+const ScannerImageSplitSettings: React.FC<ScannerImageSplitSettingsProps> = ({
+  parameters,
+  onParameterChange,
+  disabled = false
+}) => {
+  const { t } = useTranslation();
+
+  return (
+    <Stack gap="md">
+      <NumberInput
+        label={t('ScannerImageSplit.selectText.1', 'Angle Threshold:')}
+        description={t('ScannerImageSplit.selectText.2', 'Sets the minimum absolute angle required for the image to be rotated (default: 10).')}
+        value={parameters.angle_threshold}
+        onChange={(value) => onParameterChange('angle_threshold', Number(value) || 10)}
+        min={0}
+        step={1}
+        disabled={disabled}
+      />
+
+      <NumberInput
+        label={t('ScannerImageSplit.selectText.3', 'Tolerance:')}
+        description={t('ScannerImageSplit.selectText.4', 'Determines the range of colour variation around the estimated background colour (default: 30).')}
+        value={parameters.tolerance}
+        onChange={(value) => onParameterChange('tolerance', Number(value) || 30)}
+        min={0}
+        step={1}
+        disabled={disabled}
+      />
+
+      <NumberInput
+        label={t('ScannerImageSplit.selectText.5', 'Minimum Area:')}
+        description={t('ScannerImageSplit.selectText.6', 'Sets the minimum area threshold for a photo (default: 10000).')}
+        value={parameters.min_area}
+        onChange={(value) => onParameterChange('min_area', Number(value) || 10000)}
+        min={0}
+        step={100}
+        disabled={disabled}
+      />
+
+      <NumberInput
+        label={t('ScannerImageSplit.selectText.7', 'Minimum Contour Area:')}
+        description={t('ScannerImageSplit.selectText.8', 'Sets the minimum contour area threshold for a photo.')}
+        value={parameters.min_contour_area}
+        onChange={(value) => onParameterChange('min_contour_area', Number(value) || 500)}
+        min={0}
+        step={10}
+        disabled={disabled}
+      />
+
+      <NumberInput
+        label={t('ScannerImageSplit.selectText.9', 'Border Size:')}
+        description={t('ScannerImageSplit.selectText.10', 'Sets the size of the border added and removed to prevent white borders in the output (default: 1).')}
+        value={parameters.border_size}
+        onChange={(value) => onParameterChange('border_size', Number(value) || 1)}
+        min={0}
+        step={1}
+        disabled={disabled}
+      />
+    </Stack>
+  );
+};
+
+export default ScannerImageSplitSettings;
@@ -0,0 +1,54 @@
+import { useTranslation } from 'react-i18next';
+import { TooltipContent } from '../../types/tips';
+
+export const useScannerImageSplitTips = (): TooltipContent => {
+  const { t } = useTranslation();
+
+  return {
+    header: {
+      title: t('scannerImageSplit.tooltip.title', 'Photo Splitter')
+    },
+    tips: [
+      {
+        title: t('scannerImageSplit.tooltip.whatThisDoes', 'What this does'),
+        description: t('scannerImageSplit.tooltip.whatThisDoesDesc',
+          'Automatically finds and extracts each photo from a scanned page or composite image—no manual cropping.'
+        )
+      },
+      {
+        title: t('scannerImageSplit.tooltip.whenToUse', 'When to use'),
+        bullets: [
+          t('scannerImageSplit.tooltip.useCase1', 'Scan whole album pages in one go'),
+          t('scannerImageSplit.tooltip.useCase2', 'Split flatbed batches into separate files'),
+          t('scannerImageSplit.tooltip.useCase3', 'Break collages into individual photos'),
+          t('scannerImageSplit.tooltip.useCase4', 'Pull photos from documents')
+        ]
+      },
+      {
+        title: t('scannerImageSplit.tooltip.quickFixes', 'Quick fixes'),
+        bullets: [
+          t('scannerImageSplit.tooltip.problem1', 'Photos not detected → increase Tolerance to 30–50'),
+          t('scannerImageSplit.tooltip.problem2', 'Too many false detections → increase Minimum Area to 15,000–20,000'),
+          t('scannerImageSplit.tooltip.problem3', 'Crops are too tight → increase Border Size to 5–10'),
+          t('scannerImageSplit.tooltip.problem4', 'Tilted photos not straightened → lower Angle Threshold to ~5°'),
+          t('scannerImageSplit.tooltip.problem5', 'Dust/noise boxes → increase Minimum Contour Area to 1000–2000')
+        ]
+      },
+      {
+        title: t('scannerImageSplit.tooltip.setupTips', 'Setup tips'),
+        bullets: [
+          t('scannerImageSplit.tooltip.tip1', 'Use a plain, light background'),
+          t('scannerImageSplit.tooltip.tip2', 'Leave a small gap (≈1 cm) between photos'),
+          t('scannerImageSplit.tooltip.tip3', 'Scan at 300–600 DPI'),
+          t('scannerImageSplit.tooltip.tip4', 'Clean the scanner glass')
+        ]
+      },
+      {
+        title: t('scannerImageSplit.tooltip.headsUp', 'Heads-up'),
+        description: t('scannerImageSplit.tooltip.headsUpDesc',
+          'Overlapping photos or backgrounds very close in colour to the photos can reduce accuracy—try a lighter or darker background and leave more space.'
+        )
+      }
+    ]
+  };
+};
@@ -1,25 +0,0 @@
-import { useEffect } from 'react';
-import { useExportCapability } from '@embedpdf/plugin-export/react';
-import { useViewer } from '../../contexts/ViewerContext';
-
-/**
- * Component that runs inside EmbedPDF context and provides export functionality
- */
-export function ExportAPIBridge() {
-  const { provides: exportApi } = useExportCapability();
-  const { registerBridge } = useViewer();
-
-  useEffect(() => {
-    if (exportApi) {
-      // Register this bridge with ViewerContext
-      registerBridge('export', {
-        state: {
-          canExport: true,
-        },
-        api: exportApi
-      });
-    }
-  }, [exportApi, registerBridge]);
-
-  return null;
-}
@@ -17,7 +17,6 @@ import { SpreadPluginPackage, SpreadMode } from '@embedpdf/plugin-spread/react';
 import { SearchPluginPackage } from '@embedpdf/plugin-search/react';
 import { ThumbnailPluginPackage } from '@embedpdf/plugin-thumbnail/react';
 import { RotatePluginPackage, Rotate } from '@embedpdf/plugin-rotate/react';
-import { ExportPluginPackage } from '@embedpdf/plugin-export/react';
 import { Rotation } from '@embedpdf/models';
 import { CustomSearchLayer } from './CustomSearchLayer';
 import { ZoomAPIBridge } from './ZoomAPIBridge';
@@ -30,7 +29,6 @@ import { SpreadAPIBridge } from './SpreadAPIBridge';
 import { SearchAPIBridge } from './SearchAPIBridge';
 import { ThumbnailAPIBridge } from './ThumbnailAPIBridge';
 import { RotateAPIBridge } from './RotateAPIBridge';
-import { ExportAPIBridge } from './ExportAPIBridge';

 interface LocalEmbedPDFProps {
  file?: File | Blob;
@@ -114,11 +112,6 @@ export function LocalEmbedPDF({ file, url }: LocalEmbedPDFProps) {
      createPluginRegistration(RotatePluginPackage, {
        defaultRotation: Rotation.Degree0, // Start with no rotation
      }),
-
-      // Register export plugin for downloading PDFs
-      createPluginRegistration(ExportPluginPackage, {
-        defaultFileName: 'document.pdf',
-      }),
    ];
  }, [pdfUrl]);

@@ -177,7 +170,6 @@ export function LocalEmbedPDF({ file, url }: LocalEmbedPDFProps) {
        <SearchAPIBridge />
        <ThumbnailAPIBridge />
        <RotateAPIBridge />
-        <ExportAPIBridge />
        <GlobalPointerProvider>
          <Viewport
            style={{
@@ -51,11 +51,6 @@ interface ThumbnailAPIWrapper {
  renderThumb: (pageIndex: number, scale: number) => { toPromise: () => Promise<Blob> };
 }

-interface ExportAPIWrapper {
-  download: () => void;
-  saveAsCopy: () => { toPromise: () => Promise<ArrayBuffer> };
-}
-

 // State interfaces - represent the shape of data from each bridge
 interface ScrollState {
@@ -98,10 +93,6 @@ interface SearchState {
  activeIndex: number;
 }

-interface ExportState {
-  canExport: boolean;
-}
-
 // Bridge registration interface - bridges register with state and API
 interface BridgeRef<TState = unknown, TApi = unknown> {
  state: TState;
@@ -131,7 +122,6 @@ interface ViewerContextType {
  getRotationState: () => RotationState;
  getSearchState: () => SearchState;
  getThumbnailAPI: () => ThumbnailAPIWrapper | null;
-  getExportState: () => ExportState;

  // Immediate update callbacks
  registerImmediateZoomUpdate: (callback: (percent: number) => void) => void;
@@ -189,11 +179,6 @@ interface ViewerContextType {
    clear: () => void;
  };

-  exportActions: {
-    download: () => void;
-    saveAsCopy: () => Promise<ArrayBuffer | null>;
-  };
-
  // Bridge registration - internal use by bridges  
  registerBridge: (type: string, ref: BridgeRef) => void;
 }
@@ -218,7 +203,6 @@ export const ViewerProvider: React.FC<ViewerProviderProps> = ({ children }) => {
    spread: null as BridgeRef<SpreadState, SpreadAPIWrapper> | null,
    rotation: null as BridgeRef<RotationState, RotationAPIWrapper> | null,
    thumbnail: null as BridgeRef<unknown, ThumbnailAPIWrapper> | null,
-    export: null as BridgeRef<ExportState, ExportAPIWrapper> | null,
  });

  // Immediate zoom callback for responsive display updates
@@ -254,9 +238,6 @@ export const ViewerProvider: React.FC<ViewerProviderProps> = ({ children }) => {
      case 'thumbnail':
        bridgeRefs.current.thumbnail = ref as BridgeRef<unknown, ThumbnailAPIWrapper>;
        break;
-      case 'export':
-        bridgeRefs.current.export = ref as BridgeRef<ExportState, ExportAPIWrapper>;
-        break;
    }
  };

@@ -297,10 +278,6 @@ export const ViewerProvider: React.FC<ViewerProviderProps> = ({ children }) => {
    return bridgeRefs.current.thumbnail?.api || null;
  };

-  const getExportState = (): ExportState => {
-    return bridgeRefs.current.export?.state || { canExport: false };
-  };
-
  // Action handlers - call APIs directly
  const scrollActions = {
    scrollToPage: (page: number) => {
@@ -496,28 +473,6 @@ export const ViewerProvider: React.FC<ViewerProviderProps> = ({ children }) => {
    }
  };

-  const exportActions = {
-    download: () => {
-      const api = bridgeRefs.current.export?.api;
-      if (api?.download) {
-        api.download();
-      }
-    },
-    saveAsCopy: async () => {
-      const api = bridgeRefs.current.export?.api;
-      if (api?.saveAsCopy) {
-        try {
-          const result = api.saveAsCopy();
-          return await result.toPromise();
-        } catch (error) {
-          console.error('Failed to save PDF copy:', error);
-          return null;
-        }
-      }
-      return null;
-    }
-  };
-
  const registerImmediateZoomUpdate = (callback: (percent: number) => void) => {
    immediateZoomUpdateCallback.current = callback;
  };
@@ -552,7 +507,6 @@ export const ViewerProvider: React.FC<ViewerProviderProps> = ({ children }) => {
    getRotationState,
    getSearchState,
    getThumbnailAPI,
-    getExportState,

    // Immediate updates
    registerImmediateZoomUpdate,
@@ -568,7 +522,6 @@ export const ViewerProvider: React.FC<ViewerProviderProps> = ({ children }) => {
    spreadActions,
    rotationActions,
    searchActions,
-    exportActions,

    // Bridge registration
    registerBridge,
@@ -68,10 +68,13 @@ import RedactSingleStepSettings from "../components/tools/redact/RedactSingleSte
 import RotateSettings from "../components/tools/rotate/RotateSettings";
 import Redact from "../tools/Redact";
 import AdjustPageScale from "../tools/AdjustPageScale";
+import ScannerImageSplit from "../tools/ScannerImageSplit";
 import { ToolId } from "../types/toolId";
 import MergeSettings from '../components/tools/merge/MergeSettings';
 import { adjustPageScaleOperationConfig } from "../hooks/tools/adjustPageScale/useAdjustPageScaleOperation";
+import { scannerImageSplitOperationConfig } from "../hooks/tools/scannerImageSplit/useScannerImageSplitOperation";
 import AdjustPageScaleSettings from "../components/tools/adjustPageScale/AdjustPageScaleSettings";
+import ScannerImageSplitSettings from "../components/tools/scannerImageSplit/ScannerImageSplitSettings";
 import ChangeMetadataSingleStep from "../components/tools/changeMetadata/ChangeMetadataSingleStep";
 import CropSettings from "../components/tools/crop/CropSettings";

@@ -624,10 +627,14 @@ export function useFlatToolRegistry(): ToolRegistry {
      scannerImageSplit: {
        icon: <LocalIcon icon="scanner-rounded" width="1.5rem" height="1.5rem" />,
        name: t("home.scannerImageSplit.title", "Detect & Split Scanned Photos"),
-        component: null,
+        component: ScannerImageSplit,
        description: t("home.scannerImageSplit.desc", "Detect and split scanned photos into separate pages"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
+        maxFiles: -1,
+        endpoints: ["extract-image-scans"],
+        operationConfig: scannerImageSplitOperationConfig,
+        settingsComponent: ScannerImageSplitSettings,
        synonyms: getSynonyms(t, "ScannerImageSplit"),
      },
      overlayPdfs: {
@@ -0,0 +1,54 @@
+import { useTranslation } from 'react-i18next';
+import { ToolType, useToolOperation } from '../shared/useToolOperation';
+import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
+import { ScannerImageSplitParameters, defaultParameters } from './useScannerImageSplitParameters';
+import { zipFileService } from '../../../services/zipFileService';
+
+export const buildScannerImageSplitFormData = (parameters: ScannerImageSplitParameters, file: File): FormData => {
+  const formData = new FormData();
+  formData.append('fileInput', file);
+  formData.append('angle_threshold', parameters.angle_threshold.toString());
+  formData.append('tolerance', parameters.tolerance.toString());
+  formData.append('min_area', parameters.min_area.toString());
+  formData.append('min_contour_area', parameters.min_contour_area.toString());
+  formData.append('border_size', parameters.border_size.toString());
+  return formData;
+};
+
+// Custom response handler to handle ZIP files that might be misidentified
+const scannerImageSplitResponseHandler = async (responseData: Blob, inputFiles: File[]): Promise<File[]> => {
+  try {
+    // Always try to extract as ZIP first, regardless of content-type
+    const extractionResult = await zipFileService.extractAllFiles(responseData);
+    if (extractionResult.success && extractionResult.extractedFiles.length > 0) {
+      return extractionResult.extractedFiles;
+    }
+  } catch (error) {
+    console.warn('Failed to extract as ZIP, treating as single file:', error);
+  }
+
+  // Fallback: treat as single file (PNG image)
+  const inputFileName = inputFiles[0]?.name || 'document';
+  const baseFileName = inputFileName.replace(/\.[^.]+$/, '');
+  const singleFile = new File([responseData], `${baseFileName}.png`, { type: 'image/png' });
+  return [singleFile];
+};
+
+export const scannerImageSplitOperationConfig = {
+  toolType: ToolType.singleFile,
+  buildFormData: buildScannerImageSplitFormData,
+  operationType: 'scannerImageSplit',
+  endpoint: '/api/v1/misc/extract-image-scans',
+  multiFileEndpoint: false,
+  responseHandler: scannerImageSplitResponseHandler,
+  defaultParameters,
+} as const;
+
+export const useScannerImageSplitOperation = () => {
+  const { t } = useTranslation();
+
+  return useToolOperation<ScannerImageSplitParameters>({
+    ...scannerImageSplitOperationConfig,
+    getErrorMessage: createStandardErrorHandler(t('scannerImageSplit.error.failed', 'An error occurred while extracting image scans.'))
+  });
+};
@@ -0,0 +1,31 @@
+import { BaseParameters } from '../../../types/parameters';
+import { useBaseParameters, BaseParametersHook } from '../shared/useBaseParameters';
+
+export interface ScannerImageSplitParameters extends BaseParameters {
+  angle_threshold: number;
+  tolerance: number;
+  min_area: number;
+  min_contour_area: number;
+  border_size: number;
+}
+
+export const defaultParameters: ScannerImageSplitParameters = {
+  angle_threshold: 10,
+  tolerance: 30,
+  min_area: 10000,
+  min_contour_area: 500,
+  border_size: 1,
+};
+
+export type ScannerImageSplitParametersHook = BaseParametersHook<ScannerImageSplitParameters>;
+
+export const useScannerImageSplitParameters = (): ScannerImageSplitParametersHook => {
+  return useBaseParameters({
+    defaultParameters,
+    endpointName: 'extract-image-scans',
+    validateFn: () => {
+      // All parameters are numeric with defaults, validation handled by form
+      return true;
+    },
+  });
+};
@@ -338,6 +338,125 @@ export class ZipFileService {
      return errorMessage.includes('password') || errorMessage.includes('encrypted');
    }
  }
+
+  /**
+   * Extract all files from a ZIP archive (not limited to PDFs)
+   */
+  async extractAllFiles(
+    file: File | Blob,
+    onProgress?: (progress: ZipExtractionProgress) => void
+  ): Promise<ZipExtractionResult> {
+    const result: ZipExtractionResult = {
+      success: false,
+      extractedFiles: [],
+      errors: [],
+      totalFiles: 0,
+      extractedCount: 0
+    };
+
+    try {
+      // Load ZIP contents
+      const zip = new JSZip();
+      const zipContents = await zip.loadAsync(file);
+
+      // Get all files (not directories)
+      const allFiles = Object.entries(zipContents.files).filter(([, zipEntry]) =>
+        !zipEntry.dir
+      );
+
+      result.totalFiles = allFiles.length;
+
+      // Extract each file
+      for (let i = 0; i < allFiles.length; i++) {
+        const [filename, zipEntry] = allFiles[i];
+
+        try {
+          // Report progress
+          if (onProgress) {
+            onProgress({
+              currentFile: filename,
+              extractedCount: i,
+              totalFiles: allFiles.length,
+              progress: (i / allFiles.length) * 100
+            });
+          }
+
+          // Extract file content
+          const content = await zipEntry.async('blob');
+
+          // Create File object with appropriate MIME type
+          const mimeType = this.getMimeTypeFromExtension(filename);
+          const extractedFile = new File([content], filename, { type: mimeType });
+
+          result.extractedFiles.push(extractedFile);
+          result.extractedCount++;
+
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+          result.errors.push(`Failed to extract "${filename}": ${errorMessage}`);
+        }
+      }
+
+      // Final progress report
+      if (onProgress) {
+        onProgress({
+          currentFile: '',
+          extractedCount: result.extractedCount,
+          totalFiles: result.totalFiles,
+          progress: 100
+        });
+      }
+
+      result.success = result.extractedFiles.length > 0;
+
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+      result.errors.push(`Failed to process ZIP file: ${errorMessage}`);
+    }
+
+    return result;
+  }
+
+  /**
+   * Get MIME type based on file extension
+   */
+  private getMimeTypeFromExtension(fileName: string): string {
+    const ext = fileName.toLowerCase().split('.').pop();
+
+    const mimeTypes: Record<string, string> = {
+      // Images
+      'png': 'image/png',
+      'jpg': 'image/jpeg',
+      'jpeg': 'image/jpeg',
+      'gif': 'image/gif',
+      'webp': 'image/webp',
+      'bmp': 'image/bmp',
+      'svg': 'image/svg+xml',
+      'tiff': 'image/tiff',
+      'tif': 'image/tiff',
+
+      // Documents
+      'pdf': 'application/pdf',
+      'txt': 'text/plain',
+      'html': 'text/html',
+      'css': 'text/css',
+      'js': 'application/javascript',
+      'json': 'application/json',
+      'xml': 'application/xml',
+
+      // Office documents
+      'doc': 'application/msword',
+      'docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+      'xls': 'application/vnd.ms-excel',
+      'xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+
+      // Archives
+      'zip': 'application/zip',
+      'rar': 'application/x-rar-compressed',
+    };
+
+    return mimeTypes[ext || ''] || 'application/octet-stream';
+  }
 }

 // Export singleton instance
@@ -0,0 +1,58 @@
+import { useTranslation } from "react-i18next";
+import { createToolFlow } from "../components/tools/shared/createToolFlow";
+import ScannerImageSplitSettings from "../components/tools/scannerImageSplit/ScannerImageSplitSettings";
+import { useScannerImageSplitParameters } from "../hooks/tools/scannerImageSplit/useScannerImageSplitParameters";
+import { useScannerImageSplitOperation } from "../hooks/tools/scannerImageSplit/useScannerImageSplitOperation";
+import { useBaseTool } from "../hooks/tools/shared/useBaseTool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
+import { useScannerImageSplitTips } from "../components/tooltips/useScannerImageSplitTips";
+
+const ScannerImageSplit = (props: BaseToolProps) => {
+  const { t } = useTranslation();
+  const scannerImageSplitTips = useScannerImageSplitTips();
+
+  const base = useBaseTool(
+    'scannerImageSplit',
+    useScannerImageSplitParameters,
+    useScannerImageSplitOperation,
+    props
+  );
+
+  return createToolFlow({
+    files: {
+      selectedFiles: base.selectedFiles,
+      isCollapsed: base.hasResults,
+    },
+    steps: [
+      {
+        title: "Settings",
+        isCollapsed: base.settingsCollapsed,
+        onCollapsedClick: base.settingsCollapsed ? base.handleSettingsReset : undefined,
+        tooltip: scannerImageSplitTips,
+        content: (
+          <ScannerImageSplitSettings
+            parameters={base.params.parameters}
+            onParameterChange={base.params.updateParameter}
+            disabled={base.endpointLoading}
+          />
+        ),
+      },
+    ],
+    executeButton: {
+      text: t("scannerImageSplit.submit", "Extract Image Scans"),
+      isVisible: !base.hasResults,
+      loadingText: t("loading"),
+      onClick: base.handleExecute,
+      disabled: !base.params.validateParameters() || !base.hasFiles || !base.endpointEnabled,
+    },
+    review: {
+      isVisible: base.hasResults,
+      operation: base.operation,
+      title: t("scannerImageSplit.title", "Extracted Images"),
+      onFileClick: base.handleThumbnailClick,
+      onUndo: base.handleUndo,
+    },
+  });
+};
+
+export default ScannerImageSplit as ToolComponent;
Author	SHA1	Message	Date
Anthony StirlingandClaude	2ef63566f1	Fix default parameter consistency and cleanup formatting - Update tolerance default from 20 to 30 to match documentation - Update min_area default from 8000 to 10000 to match documentation - Add missing period to minimum contour area description - Replace double dashes with single hyphens in tooltip translations 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-26 00:05:55 +01:00
Anthony StirlingandClaude	00efc8802c	Fix TypeScript linting error in zipFileService Remove unused filename parameter from filter function to resolve @typescript-eslint/no-unused-vars error. Also include spotless formatting changes. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-26 00:01:21 +01:00
Anthony StirlingandClaude	9973c6b1d3	Rewrite tooltip with concise, actionable content focused on real-world usage Transform verbose tooltip into practical guidance: New structure: • "What this does" - Clear one-liner about functionality • "When to use" - 4 concrete use cases (album pages, batches, collages, documents) • "Quick fixes" - Problem → solution pairs with specific values • "Setup tips" - Practical scanning advice (DPI, gaps, backgrounds) • "Heads-up" - Important limitations and workarounds Benefits: - Shorter, scannable content - Action-oriented language ("increase Tolerance to 30-50") - Real-world scenarios users actually face - Specific numeric guidance instead of vague descriptions - Proactive troubleshooting before problems occur Content matches professional but accessible tone throughout. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-25 23:55:57 +01:00
Anthony StirlingandClaude	5d828040a7	Replace abstract tooltip explanations with practical troubleshooting guide - Remove unhelpful technical descriptions with meaningless numbers - Add problem-solution pairs with specific value recommendations: • Photos not detected → increase Tolerance to 30-50 • Too many false detections → increase Minimum Area to 15000-20000 • Photos cropped tight → increase Border Size to 5-10 • Tilted photos → lower Angle Threshold to 5 • Dust detection → increase Minimum Contour Area to 1000 - Improve setup tips with concrete measurements: • Use white/light backgrounds • Leave 1cm gaps between photos • Scan at 300+ DPI • Try defaults before adjusting Now users get actionable solutions instead of abstract technical jargon. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-25 23:44:20 +01:00
Anthony StirlingandClaude	d6a3774e9b	Add comprehensive tooltip support for scanner image split tool - Create useScannerImageSplitTips with detailed explanations - Explain use cases: photo album digitisation, flatbed scanning, collage splitting - Add technical explanations for all 5 parameters with user-friendly language - Include practical tips for optimal results - Full GB translation support with British spelling consistency - Integrate tooltip into main tool component The tooltip helps users understand: - What the tool does and when to use it - How each technical parameter affects processing - Best practices for scanning and image preparation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-25 23:23:17 +01:00
Anthony StirlingandClaude	ce2065aec4	Add complete GB translations for scanner image split tool - Add scannerImageSplit section with submit/title/error translations - Update home.scannerImageSplit title and description to match registry expectations - Ensure all React component translation keys are properly supported - Maintain British spelling ("colour") in existing translations 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-25 23:17:49 +01:00
Anthony StirlingandClaude	e7109bb4e9	Convert extract-image-scans to React component - Create full React implementation for scanner image split tool - Add ScannerImageSplit component with settings and operation hooks - Enhance zipFileService with extractAllFiles() method for general ZIP handling - Add custom response handler to properly extract ZIP files containing images - Integrate tool into registry with complete operation config - Support both single image and ZIP responses from backend 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-25 23:13:08 +01:00