Merge branch 'V2' into booklet

formats and renames
2025-09-22 14:47:42 +01:00 · 2025-09-22 14:47:28 +01:00 · 2025-09-22 12:19:04 +01:00 · 2025-09-22 12:15:18 +01:00 · 2025-09-22 12:14:33 +01:00 · 2025-09-22 12:09:16 +01:00
104 changed files with 65328 additions and 15545 deletions
@@ -3,15 +3,7 @@ name: Auto PR V2 Deployment
 on:
  pull_request:
    types: [opened, synchronize, reopened, closed]
-  workflow_dispatch:
-    inputs:
-      pr:
-        description: "PR number to deploy"
-        required: true
-      allow_fork:
-        description: "Allow deploying fork PR?"
-        required: false
-        default: "false"
+

 permissions:
  contents: read
@@ -20,93 +12,102 @@ permissions:

 jobs:
  check-pr:
-    if: (github.event_name == 'pull_request' && github.event.action != 'closed') || github.event_name == 'workflow_dispatch'
+    if: github.event.action != 'closed'
    runs-on: ubuntu-latest
    outputs:
-      should_deploy: ${{ steps.decide.outputs.should_deploy }}
-      is_fork: ${{ steps.resolve.outputs.is_fork }}
-      allow_fork: ${{ steps.decide.outputs.allow_fork }}
-      pr_number: ${{ steps.resolve.outputs.pr_number }}
-      pr_repository: ${{ steps.resolve.outputs.repository }}
-      pr_ref: ${{ steps.resolve.outputs.ref }}
+      should_deploy: ${{ steps.check-conditions.outputs.should_deploy }}
+      pr_number: ${{ github.event.number }}
+      pr_repository: ${{ steps.get-pr-info.outputs.repository }}
+      pr_ref: ${{ steps.get-pr-info.outputs.ref }}
    steps:
      - name: Harden Runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@002fdce3c6a235733a90a27c80493a3241e56863 # v2.12.1
        with:
          egress-policy: audit

-      - name: Resolve PR info
-        id: resolve
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
-        with:
-          script: |
-            const { owner, repo } = context.repo;
-            let prNumber = context.eventName === 'workflow_dispatch'
-              ? parseInt(process.env.INPUT_PR, 10)
-              : context.payload.number;
-
-            if (!Number.isInteger(prNumber)) { core.setFailed('Invalid PR number'); return; }
-
-            const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number: prNumber });
-            core.setOutput('pr_number', String(prNumber));
-            core.setOutput('repository', pr.head.repo.full_name);
-            core.setOutput('ref', pr.head.ref);
-            core.setOutput('is_fork', String(pr.head.repo.fork));
-            core.setOutput('base_ref', pr.base.ref);
-            core.setOutput('author', pr.user.login);
-            core.setOutput('state', pr.state);
-
-      - name: Decide deploy
-        id: decide
-        shell: bash
+      - name: Check deployment conditions
+        id: check-conditions
        env:
-          EVENT_NAME: ${{ github.event_name }}
-          STATE: ${{ steps.resolve.outputs.state }}
-          IS_FORK: ${{ steps.resolve.outputs.is_fork }}
-          # nur bei workflow_dispatch gesetzt:
-          ALLOW_FORK_INPUT: ${{ inputs.allow_fork }}
-          # für Auto-PR-Logik:
          PR_TITLE: ${{ github.event.pull_request.title }}
+          PR_AUTHOR: ${{ github.event.pull_request.user.login }}
          PR_BRANCH: ${{ github.event.pull_request.head.ref }}
-          PR_BASE: ${{ steps.resolve.outputs.base_ref }}
-          PR_AUTHOR: ${{ steps.resolve.outputs.author }}
        run: |
-          set -e
-          # Standard: nichts deployen
-          should=false
-          allow_fork="$(echo "${ALLOW_FORK_INPUT:-false}" | tr '[:upper:]' '[:lower:]')"
-
-          if [ "$EVENT_NAME" = "workflow_dispatch" ]; then
-            if [ "$STATE" != "open" ]; then
-              echo "PR not open -> skip"
-            else
-              if [ "$IS_FORK" = "true" ] && [ "$allow_fork" != "true" ]; then
-                echo "Fork PR and allow_fork=false -> skip"
-              else
-                should=true
-              fi
+          echo "PR Title: $PR_TITLE"
+          echo "PR Author: $PR_AUTHOR"
+          echo "PR Branch: $PR_BRANCH"
+          echo "PR Base Branch: ${{ github.event.pull_request.base.ref }}"
+          
+          # Define authorized users
+          authorized_users=(
+            "Frooodle"
+            "sf298"
+            "Ludy87"
+            "LaserKaspar"
+            "sbplat"
+            "reecebrowne"
+            "DarioGii"
+            "ConnorYoh"
+            "EthanHealy01"
+            "jbrunton96"
+          )
+          
+          # Check if author is in the authorized list
+          is_authorized=false
+          for user in "${authorized_users[@]}"; do
+            if [[ "$PR_AUTHOR" == "$user" ]]; then
+              is_authorized=true
+              break
            fi
+          done
+          
+          # If PR is targeting V2 and user is authorized, deploy unconditionally
+          PR_BASE_BRANCH="${{ github.event.pull_request.base.ref }}"
+          if [[ "$PR_BASE_BRANCH" == "V2" && "$is_authorized" == "true" ]]; then
+            echo "✅ Deployment forced: PR targets V2 and author is authorized."
+            echo "should_deploy=true" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+          
+          # Otherwise, continue with original keyword checks
+          has_v2_keyword=false
+          if [[ "$PR_TITLE" =~ [Vv]2 ]] || [[ "$PR_TITLE" =~ [Vv]ersion.?2 ]] || [[ "$PR_TITLE" =~ [Vv]ersion.?[Tt]wo ]]; then
+            has_v2_keyword=true
+          fi
+          
+          has_branch_keyword=false
+          if [[ "$PR_BRANCH" =~ [Vv]2 ]] || [[ "$PR_BRANCH" =~ [Rr]eact ]]; then
+            has_branch_keyword=true
+          fi
+          
+          if [[ "$is_authorized" == "true" && ( "$has_v2_keyword" == "true" || "$has_branch_keyword" == "true" ) ]]; then
+            echo "✅ Deployment conditions met"
+            echo "should_deploy=true" >> $GITHUB_OUTPUT
          else
-            auth_users=("Frooodle" "sf298" "Ludy87" "LaserKaspar" "sbplat" "reecebrowne" "DarioGii" "ConnorYoh" "EthanHealy01" "jbrunton96")
-            is_auth=false; for u in "${auth_users[@]}"; do [ "$u" = "$PR_AUTHOR" ] && is_auth=true && break; done
-            if [ "$PR_BASE" = "V2" ] && [ "$is_auth" = true ]; then
-              should=true
-            else
-              title_has_v2=false; echo "$PR_TITLE" | grep -qiE 'v2|version.?2|version.?two' && title_has_v2=true
-              branch_has_kw=false; echo "$PR_BRANCH" | grep -qiE 'v2|react' && branch_has_kw=true
-              if [ "$is_auth" = true ] && { [ "$title_has_v2" = true ] || [ "$branch_has_kw" = true ]; }; then
-                should=true
-              fi
-            fi
+            echo "❌ Deployment conditions not met"
+            echo "  - Authorized user: $is_authorized"
+            echo "  - Has V2 keyword in title: $has_v2_keyword"
+            echo "  - Has V2/React keyword in branch: $has_branch_keyword"
+            echo "should_deploy=false" >> $GITHUB_OUTPUT
          fi

-          echo "should_deploy=$should" >> $GITHUB_OUTPUT
-          echo "allow_fork=${allow_fork:-false}" >> $GITHUB_OUTPUT
+      - name: Get PR repository and ref
+        id: get-pr-info
+        if: steps.check-conditions.outputs.should_deploy == 'true'
+        run: |
+          # For forks, use the full repository name, for internal PRs use the current repo
+          if [[ "${{ github.event.pull_request.head.repo.fork }}" == "true" ]]; then
+            repository="${{ github.event.pull_request.head.repo.full_name }}"
+          else
+            repository="${{ github.repository }}"
+          fi
+          
+          echo "repository=$repository" >> $GITHUB_OUTPUT
+          echo "ref=${{ github.event.pull_request.head.ref }}" >> $GITHUB_OUTPUT

  deploy-v2-pr:
    needs: check-pr
    runs-on: ubuntu-latest
-    if: needs.check-pr.outputs.should_deploy == 'true' && (needs.check-pr.outputs.is_fork == 'false' || needs.check-pr.outputs.allow_fork == 'true')
+    if: needs.check-pr.outputs.should_deploy == 'true'
    # Concurrency control - only one deployment per PR at a time
    concurrency:
      group: v2-deploy-pr-${{ needs.check-pr.outputs.pr_number }}
@@ -118,7 +119,7 @@ jobs:

    steps:
      - name: Harden Runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@002fdce3c6a235733a90a27c80493a3241e56863 # v2.12.1
        with:
          egress-policy: audit

@@ -153,13 +154,13 @@ jobs:
              issue_number: prNumber,
              per_page: 100
            });
-
+            
            const v2Comments = comments.filter(comment => 
              comment.body.includes('🚀 **Auto-deploying V2 version**') ||
              comment.body.includes('## 🚀 V2 Auto-Deployment Complete!') ||
              comment.body.includes('❌ **V2 Auto-deployment failed**')
            );
-
+            
            for (const comment of v2Comments) {
              console.log(`Deleting old V2 comment: ${comment.id}`);
              await github.rest.issues.deleteComment({
@@ -176,6 +177,7 @@ jobs:
              issue_number: prNumber,
              body: `🚀 **Auto-deploying V2 version** for PR #${prNumber}...\n\n_This is an automated deployment triggered by V2/version2 keywords in the PR title or V2/React keywords in the branch name._\n\n⚠️ **Note:** If new commits are pushed during deployment, this build will be cancelled and replaced with the latest version.`
            });
+            
            return newComment.id;

      - name: Checkout PR
@@ -186,6 +188,7 @@ jobs:
          token: ${{ secrets.GITHUB_TOKEN }}
          fetch-depth: 0  # Fetch full history for commit hash detection

+
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # v3.11.1

@@ -209,7 +212,7 @@ jobs:
          if [ -z "$FRONTEND_HASH" ]; then
            FRONTEND_HASH="no-frontend-changes"
          fi
-
+          
          # Get last commit that touched backend code, docker/backend, or docker/compose
          BACKEND_HASH=$(git log -1 --format="%H" -- app/ docker/backend/ docker/compose/ 2>/dev/null || echo "")
          if [ -z "$BACKEND_HASH" ]; then
@@ -318,7 +321,7 @@ jobs:
                SWAGGER_SERVER_URL: "https://${V2_PORT}.ssl.stirlingpdf.cloud"
                baseUrl: "https://${V2_PORT}.ssl.stirlingpdf.cloud"
              restart: on-failure:5
-
+              
            stirling-pdf-v2-frontend:
              container_name: stirling-pdf-v2-frontend-pr-${{ needs.check-pr.outputs.pr_number }}
              image: ${{ secrets.DOCKER_HUB_USERNAME }}/test:v2-frontend-${{ steps.commit-hashes.outputs.frontend_short }}
@@ -351,7 +354,7 @@ jobs:
            
            # Clean up unused Docker resources to save space
            docker system prune -af --volumes || true
-
+            
            # Clean up old backend/frontend images (older than 2 weeks)
            docker image prune -af --filter "until=336h" --filter "label!=keep=true" || true
          ENDSSH
@@ -489,7 +492,7 @@ jobs:
            
            # Clean up old unused images (older than 2 weeks) but keep recent ones for reuse
            docker image prune -af --filter "until=336h" --filter "label!=keep=true" || true
-
+            
            # Note: We don't remove the commit-based images since they can be reused across PRs
            # Only remove PR-specific containers and directories
          ENDSSH
@@ -498,4 +501,5 @@ jobs:
        if: always()
        run: |
          rm -f ../private.key
-        continue-on-error: true
+        continue-on-error: true
+
@@ -32,29 +32,18 @@ jobs:
        with:
          egress-policy: audit

-      - name: Checkout PR head (default)
+      - name: Check out code
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
        with:
          fetch-depth: 0
-          persist-credentials: false

      - name: Setup GitHub App Bot
-        if: github.event_name == 'push' || (github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == false)
        id: setup-bot
        uses: ./.github/actions/setup-bot
        with:
          app-id: ${{ secrets.GH_APP_ID }}
          private-key: ${{ secrets.GH_APP_PRIVATE_KEY }}

-      - name: Checkout BASE branch (safe script)
-        if: github.event_name == 'pull_request'
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-        with:
-          ref: ${{ github.event.pull_request.base.sha }}
-          path: base
-          fetch-depth: 1
-          persist-credentials: false
-
      - name: Set up Node.js
        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
        with:
@@ -64,45 +53,12 @@ jobs:

      - name: Install frontend dependencies
        working-directory: frontend
-        env:
-          NPM_CONFIG_IGNORE_SCRIPTS: "true"
-        run: npm ci --ignore-scripts --audit=false --fund=false
+        run: npm ci

-      - name: Generate frontend license report (internal PR)
-        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == false
+      - name: Generate frontend license report
        working-directory: frontend
-        env:
-          PR_IS_FORK: "false"
        run: npm run generate-licenses

-      - name: Generate frontend license report (fork PRs, pinned)
-        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == true
-        env:
-          NPM_CONFIG_IGNORE_SCRIPTS: "true"
-        working-directory: frontend
-        run: |
-          mkdir -p src/assets
-          npx --yes license-report --only=prod --output=json > src/assets/3rdPartyLicenses.json
-
-      - name: Postprocess with project script (BASE version)
-        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == true
-        env:
-          PR_IS_FORK: "true"
-        run: |
-          node base/frontend/scripts/generate-licenses.js \
-            --input frontend/src/assets/3rdPartyLicenses.json
-
-      - name: Copy postprocessed artifacts back (fork PRs)
-        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == true
-        run: |
-          mkdir -p frontend/src/assets
-          if [ -f "base/frontend/src/assets/3rdPartyLicenses.json" ]; then
-            cp base/frontend/src/assets/3rdPartyLicenses.json frontend/src/assets/3rdPartyLicenses.json
-          fi
-          if [ -f "base/frontend/src/assets/license-warnings.json" ]; then
-            cp base/frontend/src/assets/license-warnings.json frontend/src/assets/license-warnings.json
-          fi
-
      - name: Check for license warnings
        run: |
          if [ -f "frontend/src/assets/license-warnings.json" ]; then
@@ -113,7 +69,7 @@ jobs:

      # PR Event: Check licenses and comment on PR
      - name: Delete previous license check comments
-        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == false
+        if: github.event_name == 'pull_request'
        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
        with:
          github-token: ${{ steps.setup-bot.outputs.token }}
@@ -145,28 +101,8 @@ jobs:
              });
            }

-      - name: Summarize results (fork PRs)
-        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == true
-        run: |
-          {
-            echo "## Frontend License Check"
-            echo ""
-            if [ "${LICENSE_WARNINGS_EXIST}" = "true" ]; then
-              echo "❌ **Failed** – incompatible or unknown licenses found."
-              if [ -f "frontend/src/assets/license-warnings.json" ]; then
-                echo ""
-                echo "### Warnings"
-                jq -r '.warnings[] | "- \(.message)"' frontend/src/assets/license-warnings.json || true
-              fi
-            else
-              echo "✅ **Passed** – no license warnings detected."
-            fi
-            echo ""
-            echo "_Note: This is a fork PR. PR comments are disabled; use this summary._"
-          } >> "$GITHUB_STEP_SUMMARY"
-
      - name: Comment on PR - License Check Results
-        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.fork == false
+        if: github.event_name == 'pull_request'
        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
        with:
          github-token: ${{ steps.setup-bot.outputs.token }}
@@ -203,10 +203,3 @@ id_ed25519.pub

 # node_modules
 node_modules/
-
-# Translation temp files
-*_compact.json
-*compact*.json
-test_batch.json
-*.backup.*.json
-frontend/public/locales/*/translation.backup*.json
@@ -3,7 +3,6 @@ package stirling.software.SPDF.controller.api;
 import java.io.ByteArrayOutputStream;
 import java.io.File;
 import java.io.IOException;
-import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Paths;
 import java.nio.file.attribute.BasicFileAttributes;
@@ -21,8 +20,6 @@ import org.apache.pdfbox.pdmodel.interactive.documentnavigation.outline.PDOutlin
 import org.apache.pdfbox.pdmodel.interactive.form.PDAcroForm;
 import org.apache.pdfbox.pdmodel.interactive.form.PDField;
 import org.apache.pdfbox.pdmodel.interactive.form.PDSignatureField;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.ModelAttribute;
 import org.springframework.web.multipart.MultipartFile;
@@ -114,32 +111,6 @@ public class MergeController {
        }
    }

-    // Parse client file IDs from JSON string
-    private String[] parseClientFileIds(String clientFileIds) {
-        if (clientFileIds == null || clientFileIds.trim().isEmpty()) {
-            return new String[0];
-        }
-        try {
-            // Simple JSON array parsing - remove brackets and split by comma
-            String trimmed = clientFileIds.trim();
-            if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
-                String inside = trimmed.substring(1, trimmed.length() - 1).trim();
-                if (inside.isEmpty()) {
-                    return new String[0];
-                }
-                String[] parts = inside.split(",");
-                String[] result = new String[parts.length];
-                for (int i = 0; i < parts.length; i++) {
-                    result[i] = parts[i].trim().replaceAll("^\"|\"$", "");
-                }
-                return result;
-            }
-        } catch (Exception e) {
-            log.warn("Failed to parse client file IDs: {}", clientFileIds, e);
-        }
-        return new String[0];
-    }
-
    // Adds a table of contents to the merged document using filenames as chapter titles
    private void addTableOfContents(PDDocument mergedDocument, MultipartFile[] files) {
        // Create the document outline
@@ -206,48 +177,15 @@ public class MergeController {

            PDFMergerUtility mergerUtility = new PDFMergerUtility();
            long totalSize = 0;
-            List<Integer> invalidIndexes = new ArrayList<>();
-            for (int index = 0; index < files.length; index++) {
-                MultipartFile multipartFile = files[index];
+            for (MultipartFile multipartFile : files) {
                totalSize += multipartFile.getSize();
                File tempFile =
                        GeneralUtils.convertMultipartFileToFile(
                                multipartFile); // Convert MultipartFile to File
                filesToDelete.add(tempFile); // Add temp file to the list for later deletion
-
-                // Pre-validate each PDF so we can report which one(s) are broken
-                // Use the original MultipartFile to avoid deleting the tempFile during validation
-                try (PDDocument ignored = pdfDocumentFactory.load(multipartFile)) {
-                    // OK
-                } catch (IOException e) {
-                    ExceptionUtils.logException("PDF pre-validate", e);
-                    invalidIndexes.add(index);
-                }
                mergerUtility.addSource(tempFile); // Add source file to the merger utility
            }

-            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) {
-                    if (index < clientIds.length) {
-                        errorFileIds.add(clientIds[index]);
-                    }
-                }
-
-                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));
-            }
-
            mergedTempFile = Files.createTempFile("merged-", ".pdf").toFile();
            mergerUtility.setDestinationFileName(mergedTempFile.getAbsolutePath());

@@ -237,54 +237,34 @@ public class StampController {

        PDRectangle pageSize = page.getMediaBox();
        float x, y;
-        // Split the stampText into multiple lines
-        String[] lines = stampText.split("\\r?\\n|\\\\n");
-
-        // Calculate dynamic line height based on font ascent and descent
-        float ascent = font.getFontDescriptor().getAscent();
-        float descent = font.getFontDescriptor().getDescent();
-        float lineHeight = ((ascent - descent) / 1000) * fontSize;
-
-        // Compute a single pivot for the entire text block to avoid line-by-line wobble
-        float capHeight = calculateTextCapHeight(font, fontSize);
-        float blockHeight = Math.max(lineHeight, lineHeight * Math.max(1, lines.length));
-        float maxWidth = 0f;
-        for (String ln : lines) {
-            maxWidth = Math.max(maxWidth, calculateTextWidth(ln, font, fontSize));
-        }

        if (overrideX >= 0 && overrideY >= 0) {
            // Use override values if provided
            x = overrideX;
            y = overrideY;
        } else {
-            // Base positioning on the true multi-line block size
-            x = calculatePositionX(pageSize, position, maxWidth, null, 0, null, margin);
-            y = calculatePositionY(pageSize, position, blockHeight, margin);
+            x = calculatePositionX(pageSize, position, fontSize, font, fontSize, stampText, margin);
+            y =
+                    calculatePositionY(
+                            pageSize, position, calculateTextCapHeight(font, fontSize), margin);
        }
+        // Split the stampText into multiple lines
+        String[] lines = stampText.split("\\\\n");

-        // After anchoring the block, draw from the top line downward
-        float adjustedX = x;
-        float adjustedY = y;
-        float pivotX = adjustedX + maxWidth / 2f;
-        float pivotY = adjustedY + blockHeight / 2f;
-
-        // Apply rotation about the block center at the graphics state level
-        contentStream.saveGraphicsState();
-        contentStream.transform(Matrix.getTranslateInstance(pivotX, pivotY));
-        contentStream.transform(Matrix.getRotateInstance(Math.toRadians(rotation), 0, 0));
-        contentStream.transform(Matrix.getTranslateInstance(-pivotX, -pivotY));
+        // Calculate dynamic line height based on font ascent and descent
+        float ascent = font.getFontDescriptor().getAscent();
+        float descent = font.getFontDescriptor().getDescent();
+        float lineHeight = ((ascent - descent) / 1000) * fontSize;

        contentStream.beginText();
        for (int i = 0; i < lines.length; i++) {
            String line = lines[i];
-            // Start from top line: yTop = adjustedY + blockHeight - capHeight
-            float yLine = adjustedY + blockHeight - capHeight - (i * lineHeight);
-            contentStream.setTextMatrix(Matrix.getTranslateInstance(adjustedX, yLine));
+            // Set the text matrix for each line with rotation
+            contentStream.setTextMatrix(
+                    Matrix.getRotateInstance(Math.toRadians(rotation), x, y - (i * lineHeight)));
            contentStream.showText(line);
        }
        contentStream.endText();
-        contentStream.restoreGraphicsState();
    }

    private void addImageStamp(
@@ -328,17 +308,9 @@ public class StampController {
        }

        contentStream.saveGraphicsState();
-        // Rotate and scale about the center of the image
-        float centerX = x + (desiredPhysicalWidth / 2f);
-        float centerY = y + (desiredPhysicalHeight / 2f);
-        contentStream.transform(Matrix.getTranslateInstance(centerX, centerY));
+        contentStream.transform(Matrix.getTranslateInstance(x, y));
        contentStream.transform(Matrix.getRotateInstance(Math.toRadians(rotation), 0, 0));
-        contentStream.drawImage(
-                xobject,
-                -desiredPhysicalWidth / 2f,
-                -desiredPhysicalHeight / 2f,
-                desiredPhysicalWidth,
-                desiredPhysicalHeight);
+        contentStream.drawImage(xobject, 0, 0, desiredPhysicalWidth, desiredPhysicalHeight);
        contentStream.restoreGraphicsState();
    }

@@ -39,10 +39,4 @@ public class MergePdfsRequest extends MultiplePDFFiles {
            requiredMode = Schema.RequiredMode.NOT_REQUIRED,
            defaultValue = "false")
    private boolean generateToc = false;
-
-    @Schema(
-            description =
-                    "JSON array of client-provided IDs for each uploaded file (same order as fileInput)",
-            requiredMode = Schema.RequiredMode.NOT_REQUIRED)
-    private String clientFileIds;
 }
@@ -2,7 +2,6 @@
 <html lang="en-GB">
  <head>
    <meta charset="UTF-8" />
-    <base href="%BASE_URL%" />
    <link rel="icon" href="/favicon.ico" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="theme-color" content="#000000" />
@@ -5,49 +5,52 @@
  "license": "SEE LICENSE IN https://raw.githubusercontent.com/Stirling-Tools/Stirling-PDF/refs/heads/main/proprietary/LICENSE",
  "proxy": "http://localhost:8080",
  "dependencies": {
-    "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
-    "@embedpdf/core": "^1.2.1",
-    "@embedpdf/engines": "^1.2.1",
-    "@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",
+    "@atlaskit/pragmatic-drag-and-drop": "^1.7.4",
+    "@embedpdf/core": "^1.1.1",
+    "@embedpdf/engines": "^1.1.1",
+    "@embedpdf/plugin-interaction-manager": "^1.1.1",
+    "@embedpdf/plugin-loader": "^1.1.1",
+    "@embedpdf/plugin-pan": "^1.1.1",
+    "@embedpdf/plugin-render": "^1.1.1",
+    "@embedpdf/plugin-rotate": "^1.1.1",
+    "@embedpdf/plugin-scroll": "^1.1.1",
+    "@embedpdf/plugin-search": "^1.1.1",
+    "@embedpdf/plugin-selection": "^1.1.1",
+    "@embedpdf/plugin-spread": "^1.1.1",
+    "@embedpdf/plugin-thumbnail": "^1.1.1",
+    "@embedpdf/plugin-tiling": "^1.1.1",
+    "@embedpdf/plugin-viewport": "^1.1.1",
+    "@embedpdf/plugin-zoom": "^1.1.1",
    "@emotion/react": "^11.14.0",
-    "@emotion/styled": "^11.14.1",
-    "@iconify/react": "^6.0.2",
-    "@mantine/core": "^8.3.1",
-    "@mantine/dates": "^8.3.1",
-    "@mantine/dropzone": "^8.3.1",
-    "@mantine/hooks": "^8.3.1",
-    "@mui/icons-material": "^7.3.2",
-    "@mui/material": "^7.3.2",
-    "@tailwindcss/postcss": "^4.1.13",
+    "@emotion/styled": "^11.14.0",
+    "@iconify/react": "^6.0.0",
+    "@mantine/core": "^8.0.1",
+    "@mantine/dates": "^8.0.1",
+    "@mantine/dropzone": "^8.0.1",
+    "@mantine/hooks": "^8.0.1",
+    "@mui/icons-material": "^7.1.0",
+    "@mui/material": "^7.1.0",
+    "@tailwindcss/postcss": "^4.1.8",
    "@tanstack/react-virtual": "^3.13.12",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^13.5.0",
    "autoprefixer": "^10.4.21",
-    "axios": "^1.12.2",
-    "i18next": "^25.5.2",
-    "i18next-browser-languagedetector": "^8.2.0",
+    "axios": "^1.9.0",
+    "i18next": "^25.2.1",
+    "i18next-browser-languagedetector": "^8.1.0",
    "i18next-http-backend": "^3.0.2",
    "jszip": "^3.10.1",
-    "license-report": "^6.8.0",
    "pdf-lib": "^1.17.1",
-    "pdfjs-dist": "^5.4.149",
-    "posthog-js": "^1.268.0",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "react-i18next": "^15.7.3",
-    "react-router-dom": "^7.9.1",
-    "tailwindcss": "^4.1.13",
-    "web-vitals": "^5.1.0"
+    "pdfjs-dist": "^3.11.174",
+    "posthog-js": "^1.261.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "react-i18next": "^15.5.2",
+    "react-router-dom": "^7.6.0",
+    "tailwindcss": "^4.1.8",
+    "web-vitals": "^2.1.4"
  },
  "scripts": {
    "predev": "npm run generate-icons",
@@ -67,17 +70,12 @@
    "test:coverage": "vitest --coverage",
    "test:e2e": "playwright test",
    "test:e2e:ui": "playwright test --ui",
-    "test:e2e:install": "playwright install",
-    "update:minor": "npm outdated || npm update && npm audit fix && npm test",
-    "update:major": "npx npm-check-updates -u && npm install",
-    "update:interactive": "npx npm-check-updates -i",
-    "update:minor-strict": "npx npm-check-updates -u --target minor && npm install"
+    "test:e2e:install": "playwright install"
  },
  "eslintConfig": {
    "extends": [
-      "eslint:recommended",
-      "plugin:@typescript-eslint/recommended",
-      "plugin:react-hooks/recommended"
+      "react-app",
+      "react-app/jest"
    ]
  },
  "browserslist": {
@@ -93,41 +91,26 @@
    ]
  },
  "devDependencies": {
-    "@eslint/js": "^9.36.0",
-    "@iconify-json/material-symbols": "^1.2.37",
-    "@iconify/utils": "^3.0.2",
-    "@playwright/test": "^1.55.0",
-    "@testing-library/dom": "^10.4.1",
-    "@testing-library/jest-dom": "^6.8.0",
-    "@testing-library/react": "^16.3.0",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/node": "^24.5.2",
-    "@types/react": "^19.1.13",
-    "@types/react-dom": "^19.1.9",
-    "@typescript-eslint/eslint-plugin": "^8.44.1",
-    "@typescript-eslint/parser": "^8.44.1",
-    "@vitejs/plugin-react-swc": "^4.1.0",
-    "@vitest/coverage-v8": "^3.2.4",
-    "eslint": "^9.36.0",
-    "eslint-plugin-react-hooks": "^5.2.0",
-    "jsdom": "^27.0.0",
+    "@eslint/js": "^9.34.0",
+    "@iconify-json/material-symbols": "^1.2.33",
+    "@iconify/utils": "^3.0.1",
+    "@playwright/test": "^1.40.0",
+    "@types/node": "^24.2.1",
+    "@types/react": "^19.1.4",
+    "@types/react-dom": "^19.1.5",
+    "@vitejs/plugin-react": "^4.5.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^9.34.0",
+    "jsdom": "^23.0.0",
    "license-checker": "^25.0.1",
    "madge": "^8.0.0",
-    "postcss": "^8.5.6",
+    "postcss": "^8.5.3",
    "postcss-cli": "^11.0.1",
-    "postcss-preset-mantine": "^1.18.0",
+    "postcss-preset-mantine": "^1.17.0",
    "postcss-simple-vars": "^7.0.1",
    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.44.1",
-    "vite": "^7.1.7",
-    "vitest": "^3.2.4"
-  },
-  "depcheck": {
-    "ignoreMatches": [
-      "@emotion/*",
-      "tailwindcss",
-      "@testing-library/user-event",
-      "@vitest/coverage-v8"
-    ]
+    "typescript-eslint": "^8.42.0",
+    "vite": "^6.3.5",
+    "vitest": "^1.0.0"
  }
 }
@@ -74,10 +74,7 @@
  },
  "error": {
    "pdfPassword": "The PDF Document is passworded and either the password was not provided or was incorrect",
-    "encryptedPdfMustRemovePassword": "This PDF is encrypted or password-protected. Please unlock it before converting to PDF/A.",
-    "incorrectPasswordProvided": "The PDF password is incorrect or not provided.",
    "_value": "Error",
-    "dismissAllErrors": "Dismiss All Errors",
    "sorry": "Sorry for the issue!",
    "needHelp": "Need help / Found an issue?",
    "contactTip": "If you're still having trouble, don't hesitate to reach out to us for help. You can submit a ticket on our GitHub page or contact us through Discord:",
@@ -148,7 +145,6 @@
  "noFileSelected": "No file selected. Please upload one.",
  "legal": {
    "privacy": "Privacy Policy",
-    "iAgreeToThe": "I agree to all of the",
    "terms": "Terms and Conditions",
    "accessibility": "Accessibility",
    "cookie": "Cookie Policy",
@@ -360,277 +356,222 @@
    "globalPopularity": "Global Popularity",
    "sortBy": "Sort by:",
    "multiTool": {
-      "tags": "multiple,tools",
      "title": "PDF Multi Tool",
      "desc": "Merge, Rotate, Rearrange, Split, and Remove pages"
    },
    "merge": {
-      "tags": "combine,join,unite",
      "title": "Merge",
      "desc": "Easily merge multiple PDFs into one."
    },
    "split": {
-      "tags": "divide,separate,break",
      "title": "Split",
      "desc": "Split PDFs into multiple documents"
    },
    "rotate": {
-      "tags": "turn,flip,orient",
      "title": "Rotate",
      "desc": "Easily rotate your PDFs."
    },
    "convert": {
-      "tags": "transform,change",
      "title": "Convert",
      "desc": "Convert files between different formats"
    },
    "pdfOrganiser": {
-      "tags": "organize,rearrange,reorder",
      "title": "Organise",
      "desc": "Remove/Rearrange pages in any order"
    },
    "addImage": {
-      "tags": "insert,embed,place",
      "title": "Add image",
      "desc": "Adds a image onto a set location on the PDF"
    },
    "addAttachments": {
-      "tags": "embed,attach,include",
      "title": "Add Attachments",
      "desc": "Add or remove embedded files (attachments) to/from a PDF"
    },
    "watermark": {
-      "tags": "stamp,mark,overlay",
      "title": "Add Watermark",
      "desc": "Add a custom watermark to your PDF document."
    },
    "removePassword": {
-      "tags": "unlock",
      "title": "Remove Password",
      "desc": "Remove password protection from your PDF document."
    },
    "compress": {
-      "tags": "shrink,reduce,optimize",
      "title": "Compress",
      "desc": "Compress PDFs to reduce their file size."
    },
    "unlockPDFForms": {
-      "tags": "unlock,enable,edit",
      "title": "Unlock PDF Forms",
      "desc": "Remove read-only property of form fields in a PDF document."
    },
    "changeMetadata": {
-      "tags": "edit,modify,update",
      "title": "Change Metadata",
      "desc": "Change/Remove/Add metadata from a PDF document"
    },
    "ocr": {
-      "tags": "extract,scan",
      "title": "OCR / Cleanup scans",
      "desc": "Cleanup scans and detects text from images within a PDF and re-adds it as text."
    },
    "extractImages": {
-      "tags": "pull,save,export",
      "title": "Extract Images",
      "desc": "Extracts all images from a PDF and saves them to zip"
    },
    "scannerImageSplit": {
-      "tags": "detect,split,photos",
-      "title": "Detect & Split Scanned Photos",
-      "desc": "Detect and split scanned photos into separate pages"
+      "title": "Detect/Split Scanned photos",
+      "desc": "Splits multiple photos from within a photo/PDF"
    },
    "sign": {
-      "tags": "signature,autograph",
      "title": "Sign",
      "desc": "Adds signature to PDF by drawing, text or image"
    },
    "flatten": {
-      "tags": "simplify,remove,interactive",
      "title": "Flatten",
      "desc": "Remove all interactive elements and forms from a PDF"
    },
    "certSign": {
-      "tags": "authenticate,PEM,P12,official,encrypt,sign,certificate,PKCS12,JKS,server,manual,auto",
      "title": "Sign with Certificate",
      "desc": "Signs a PDF with a Certificate/Key (PEM/P12)"
    },
    "repair": {
-      "tags": "fix,restore",
      "title": "Repair",
      "desc": "Tries to repair a corrupt/broken PDF"
    },
    "removeBlanks": {
-      "tags": "delete,clean,empty",
      "title": "Remove Blank pages",
      "desc": "Detects and removes blank pages from a document"
    },
    "removeAnnotations": {
-      "tags": "delete,clean,strip",
      "title": "Remove Annotations",
      "desc": "Removes all comments/annotations from a PDF"
    },
    "compare": {
-      "tags": "difference",
      "title": "Compare",
      "desc": "Compares and shows the differences between 2 PDF Documents"
    },
    "removeCertSign": {
-      "tags": "remove,delete,unlock",
      "title": "Remove Certificate Sign",
      "desc": "Remove certificate signature from PDF"
    },
    "pageLayout": {
-      "tags": "layout,arrange,combine",
      "title": "Multi-Page Layout",
      "desc": "Merge multiple pages of a PDF document into a single page"
    },
    "bookletImposition": {
-      "tags": "booklet,print,binding",
      "title": "Booklet Imposition",
      "desc": "Create booklets with proper page ordering and multi-page layout for printing and binding"
    },
    "scalePages": {
-      "tags": "resize,adjust,scale",
      "title": "Adjust page size/scale",
      "desc": "Change the size/scale of a page and/or its contents."
    },
    "addPageNumbers": {
-      "tags": "number,pagination,count",
      "title": "Add Page Numbers",
      "desc": "Add Page numbers throughout a document in a set location"
    },
    "autoRename": {
-      "tags": "auto-detect,header-based,organize,relabel",
      "title": "Auto Rename PDF File",
      "desc": "Auto renames a PDF file based on its detected header"
    },
    "adjustContrast": {
-      "tags": "contrast,brightness,saturation",
      "title": "Adjust Colours/Contrast",
      "desc": "Adjust Contrast, Saturation and Brightness of a PDF"
    },
    "crop": {
-      "tags": "trim,cut,resize",
      "title": "Crop PDF",
      "desc": "Crop a PDF to reduce its size (maintains text!)"
    },
    "autoSplitPDF": {
-      "tags": "auto,split,QR",
      "title": "Auto Split Pages",
      "desc": "Auto Split Scanned PDF with physical scanned page splitter QR Code"
    },
    "sanitize": {
-      "tags": "clean,purge,remove",
      "title": "Sanitise",
      "desc": "Remove potentially harmful elements from PDF files"
    },
    "getPdfInfo": {
-      "tags": "info,metadata,details",
      "title": "Get ALL Info on PDF",
      "desc": "Grabs any and all information possible on PDFs"
    },
    "pdfToSinglePage": {
-      "tags": "combine,merge,single",
      "title": "PDF to Single Large Page",
      "desc": "Merges all PDF pages into one large single page"
    },
    "showJS": {
-      "tags": "javascript,code,script",
      "title": "Show Javascript",
      "desc": "Searches and displays any JS injected into a PDF"
    },
    "redact": {
-      "tags": "censor,blackout,hide",
      "title": "Redact",
      "desc": "Redacts (blacks out) a PDF based on selected text, drawn shapes and/or selected page(s)"
    },
    "overlayPdfs": {
-      "tags": "overlay,combine,stack",
      "title": "Overlay PDFs",
      "desc": "Overlays PDFs on-top of another PDF"
    },
    "splitBySections": {
-      "tags": "split,sections,divide",
      "title": "Split PDF by Sections",
      "desc": "Divide each page of a PDF into smaller horizontal and vertical sections"
    },
    "addStamp": {
-      "tags": "stamp,mark,seal",
      "title": "Add Stamp to PDF",
      "desc": "Add text or add image stamps at set locations"
    },
    "removeImage": {
-      "tags": "remove,delete,clean",
      "title": "Remove image",
      "desc": "Remove image from PDF to reduce file size"
    },
    "splitByChapters": {
-      "tags": "split,chapters,structure",
      "title": "Split PDF by Chapters",
      "desc": "Split a PDF into multiple files based on its chapter structure."
    },
    "validateSignature": {
-      "tags": "validate,verify,certificate",
      "title": "Validate PDF Signature",
      "desc": "Verify digital signatures and certificates in PDF documents"
    },
    "swagger": {
-      "tags": "API,documentation,test",
      "title": "API Documentation",
      "desc": "View API documentation and test endpoints"
    },
    "fakeScan": {
-      "tags": "scan,simulate,create",
      "title": "Fake Scan",
      "desc": "Create a PDF that looks like it was scanned"
    },
    "editTableOfContents": {
-      "tags": "bookmarks,contents,edit",
      "title": "Edit Table of Contents",
      "desc": "Add or edit bookmarks and table of contents in PDF documents"
    },
    "manageCertificates": {
-      "tags": "certificates,import,export",
      "title": "Manage Certificates",
      "desc": "Import, export, or delete digital certificate files used for signing PDFs."
    },
-  "read": {
-    "tags": "view,open,display",
-    "title": "Read",
+    "read": {
+      "title": "Read",
      "desc": "View and annotate PDFs. Highlight text, draw, or insert comments for review and collaboration."
    },
    "reorganizePages": {
-      "tags": "rearrange,reorder,organize",
      "title": "Reorganize Pages",
      "desc": "Rearrange, duplicate, or delete PDF pages with visual drag-and-drop control."
    },
    "extractPages": {
-      "tags": "pull,select,copy",
      "title": "Extract Pages",
      "desc": "Extract specific pages from a PDF document"
    },
    "removePages": {
-      "tags": "delete,extract,exclude",
      "title": "Remove Pages",
      "desc": "Remove specific pages from a PDF document"
    },
    "autoSizeSplitPDF": {
-      "tags": "auto,split,size",
      "title": "Auto Split by Size/Count",
      "desc": "Automatically split PDFs by file size or page count"
    },
    "replaceColorPdf": {
-      "tags": "color,replace,invert",
      "title": "Replace & Invert Colour",
      "desc": "Replace or invert colours in PDF documents"
    },
    "devApi": {
-      "tags": "API,development,documentation",
      "title": "API",
      "desc": "Link to API documentation"
    },
    "devFolderScanning": {
-      "tags": "automation,folder,scanning",
      "title": "Automated Folder Scanning",
      "desc": "Link to automated folder scanning guide"
    },
@@ -651,7 +592,6 @@
      "desc": "Change document restrictions and permissions"
    },
    "automate": {
-      "tags": "workflow,sequence,automation",
      "title": "Automate",
      "desc": "Build multi-step workflows by chaining together PDF actions. Ideal for recurring tasks."
    }
@@ -718,6 +658,7 @@
    }
  },
  "split": {
+    "tags": "Page operations,divide,Multi Page,cut,server side",
    "title": "Split PDF",
    "header": "Split PDF",
    "desc": {
@@ -843,6 +784,7 @@
    }
  },
  "rotate": {
+    "tags": "server side",
    "title": "Rotate PDF",
    "submit": "Apply Rotation",
    "error": {
@@ -1355,6 +1297,7 @@
    }
  },
  "changeMetadata": {
+    "tags": "Title,author,date,creation,time,publisher,producer,stats",
    "header": "Change Metadata",
    "submit": "Change",
    "filenamePrefix": "metadata",
@@ -1656,49 +1599,20 @@
    "tags": "separate,auto-detect,scans,multi-photo,organize",
    "selectText": {
      "1": "Angle Threshold:",
-      "2": "Tilt (in degrees) needed before we auto-straighten a photo.",
+      "2": "Sets the minimum absolute angle required for the image to be rotated (default: 10).",
      "3": "Tolerance:",
-      "4": "How closely a colour must match the page background to count as background. Higher = looser, lower = stricter.",
+      "4": "Determines the range of colour variation around the estimated background colour (default: 30).",
      "5": "Minimum Area:",
-      "6": "Smallest photo size (in pixels²) we'll keep to avoid tiny fragments.",
+      "6": "Sets the minimum area threshold for a photo (default: 10000).",
      "7": "Minimum Contour Area:",
-      "8": "Smallest edge/shape we consider when finding photos (filters dust and specks).",
+      "8": "Sets the minimum contour area threshold for a photo",
      "9": "Border Size:",
-      "10": "Extra padding (in pixels) around each saved photo so edges aren't cut."
+      "10": "Sets the size of the border added and removed to prevent white borders in the output (default: 1)."
    },
    "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": {
+    "tags": "authorize,initials,drawn-signature,text-sign,image-signature",
    "title": "Sign",
    "header": "Sign PDFs",
    "upload": "Upload Image",
@@ -1722,6 +1636,7 @@
    "redo": "Redo"
  },
  "flatten": {
+    "tags": "static,deactivate,non-interactive,streamline",
    "title": "Flatten",
    "header": "Flatten PDF",
    "flattenOnlyForms": "Flatten only forms",
@@ -1786,6 +1701,7 @@
    }
  },
  "removeBlanks": {
+    "tags": "cleanup,streamline,non-content,organize",
    "title": "Remove Blanks",
    "header": "Remove Blank Pages",
    "settings": {
@@ -2182,6 +2098,7 @@
    "tags": "color-correction,tune,modify,enhance,colour-correction"
  },
  "crop": {
+    "tags": "trim,shrink,edit,shape",
    "title": "Crop",
    "header": "Crop PDF",
    "submit": "Apply Crop",
@@ -2465,7 +2382,6 @@
    "tags": "Stamp, Add image, center image, Watermark, PDF, Embed, Customize,Customise",
    "header": "Stamp PDF",
    "title": "Stamp PDF",
-    "stampSetup": "Stamp Setup",
    "stampType": "Stamp Type",
    "stampText": "Stamp Text",
    "stampImage": "Stamp Image",
@@ -2478,8 +2394,7 @@
    "overrideY": "Override Y Coordinate",
    "customMargin": "Custom Margin",
    "customColor": "Custom Text Colour",
-    "submit": "Submit",
-    "noStampSelected": "No stamp selected. Return to Step 1."
+    "submit": "Submit"
  },
  "removeImagePdf": {
    "tags": "Remove Image,Page operations,Back end,server side"
@@ -2558,8 +2473,6 @@
    "title": "Sign in",
    "header": "Sign in",
    "signin": "Sign in",
-    "signInWith": "Sign in with",
-    "signInAnonymously": "Sign Up as a Guest",
    "rememberme": "Remember me",
    "invalid": "Invalid username or password.",
    "locked": "Your account has been locked.",
@@ -2578,54 +2491,7 @@
    "alreadyLoggedIn": "You are already logged in to",
    "alreadyLoggedIn2": "devices. Please log out of the devices and try again.",
    "toManySessions": "You have too many active sessions",
-    "logoutMessage": "You have been logged out.",
-    "youAreLoggedIn": "You are logged in!",
-    "email": "Email",
-    "password": "Password",
-    "enterEmail": "Enter your email",
-    "enterPassword": "Enter your password",
-    "loggingIn": "Logging In...",
-    "signingIn": "Signing in...",
-    "login": "Login",
-    "or": "Or",
-    "useMagicLink": "Use magic link instead",
-    "enterEmailForMagicLink": "Enter your email for magic link",
-    "sending": "Sending…",
-    "sendMagicLink": "Send Magic Link",
-    "cancel": "Cancel",
-    "dontHaveAccount": "Don't have an account? Sign up",
-    "home": "Home",
-    "debug": "Debug",
-    "signOut": "Sign Out",
-    "pleaseEnterBoth": "Please enter both email and password",
-    "pleaseEnterEmail": "Please enter your email address",
-    "magicLinkSent": "Magic link sent to {{email}}! Check your email and click the link to sign in.",
-    "passwordResetSent": "Password reset link sent to {{email}}! Check your email and follow the instructions.",
-    "failedToSignIn": "Failed to sign in with {{provider}}: {{message}}",
-    "unexpectedError": "Unexpected error: {{message}}"
-  },
-  "signup": {
-    "title": "Create an account",
-    "subtitle": "Join Stirling PDF to get started",
-    "name": "Name",
-    "email": "Email",
-    "password": "Password",
-    "confirmPassword": "Confirm password",
-    "enterName": "Enter your name",
-    "enterEmail": "Enter your email",
-    "enterPassword": "Enter your password",
-    "confirmPasswordPlaceholder": "Confirm password",
-    "or": "or",
-    "creatingAccount": "Creating Account...",
-    "signUp": "Sign Up",
-    "alreadyHaveAccount": "Already have an account? Sign in",
-    "pleaseFillAllFields": "Please fill in all fields",
-    "passwordsDoNotMatch": "Passwords do not match",
-    "passwordTooShort": "Password must be at least 6 characters long",
-    "invalidEmail": "Please enter a valid email address",
-    "checkEmailConfirmation": "Check your email for a confirmation link to complete your registration.",
-    "accountCreatedSuccessfully": "Account created successfully! You can now sign in.",
-    "unexpectedError": "Unexpected error: {{message}}"
+    "logoutMessage": "You have been logged out."
  },
  "pdfToSinglePage": {
    "title": "PDF To Single Page",
@@ -2683,28 +2549,6 @@
    "grayscale": {
      "label": "Apply Grayscale for Compression"
    },
-    "tooltip": {
-      "header": {
-        "title": "Compress Settings Overview"
-      },
-      "description": {
-        "title": "Description",
-        "text": "Compression is an easy way to reduce your file size. Pick File Size to enter a target size and have us adjust quality for you. Pick Quality to set compression strength manually."
-      },
-      "qualityAdjustment": {
-        "title": "Quality Adjustment",
-        "text": "Drag the slider to adjust the compression strength. Lower values (1-3) preserve quality but result in larger files. Higher values (7-9) shrink the file more but reduce image clarity.",
-        "bullet1": "Lower values preserve quality",
-        "bullet2": "Higher values reduce file size"
-      },
-      "grayscale": {
-        "title": "Grayscale",
-        "text": "Select this option to convert all images to black and white, which can significantly reduce file size especially for scanned PDFs or image-heavy documents."
-      }
-    },
-    "error": {
-      "failed": "An error occurred while compressing the PDF."
-    },
    "selectText": {
      "1": {
        "_value": "Compression Settings",
@@ -2953,16 +2797,6 @@
    "rotateRight": "Rotate Right",
    "toggleSidebar": "Toggle Sidebar"
  },
-  "search": {
-    "title": "Search PDF",
-    "placeholder": "Enter search term..."
-  },
-  "guestBanner": {
-    "title": "You're using Stirling PDF as a guest!",
-    "message": "Create a free account to save your work, access more features, and support the project.",
-    "dismiss": "Dismiss banner",
-    "signUp": "Sign Up Free"
-  },
  "toolPicker": {
    "searchPlaceholder": "Search tools...",
    "noToolsFound": "No tools found",
@@ -3327,63 +3161,5 @@
      "processImages": "Process Images",
      "processImagesDesc": "Converts multiple image files into a single PDF document, then applies OCR technology to extract searchable text from the images."
    }
-  },
-  "common": {
-    "copy": "Copy",
-    "copied": "Copied!",
-    "refresh": "Refresh",
-    "retry": "Retry",
-    "remaining": "remaining",
-    "used": "used",
-    "available": "available",
-    "cancel": "Cancel"
-  },
-  "config": {
-    "account": {
-      "overview": {
-        "title": "Account Settings",
-        "manageAccountPreferences": "Manage your account preferences",
-        "guestDescription": "You are signed in as a guest. Consider upgrading your account above."
-      },
-      "upgrade": {
-        "title": "Upgrade Guest Account",
-        "description": "Link your account to preserve your history and access more features!",
-        "socialLogin": "Upgrade with Social Account",
-        "linkWith": "Link with",
-        "emailPassword": "or enter your email & password",
-        "email": "Email",
-        "emailPlaceholder": "Enter your email",
-        "password": "Password (optional)",
-        "passwordPlaceholder": "Set a password",
-        "passwordNote": "Leave empty to use email verification only",
-        "upgradeButton": "Upgrade Account"
-      }
-    },
-    "apiKeys": {
-      "description": "Your API key for accessing Stirling's suite of PDF tools. Copy it to your project or refresh to generate a new one.",
-      "publicKeyAriaLabel": "Public API key",
-      "copyKeyAriaLabel": "Copy API key",
-      "refreshAriaLabel": "Refresh API key",
-      "includedCredits": "Included credits",
-      "purchasedCredits": "Purchased credits",
-      "totalCredits": "Total Credits",
-      "chartAriaLabel": "Credits usage: included {{includedUsed}} of {{includedTotal}}, purchased {{purchasedUsed}} of {{purchasedTotal}}",
-      "nextReset": "Next Reset",
-      "lastApiUse": "Last API Use",
-      "overlayMessage": "Generate a key to see credits and available credits",
-      "label": "API Key",
-      "guestInfo": "Guest users do not receive API keys. Create an account to get an API key you can use in your applications.",
-      "goToAccount": "Go to Account",
-      "refreshModal": {
-        "title": "Refresh API Keys",
-        "warning": "⚠️ Warning: This action will generate new API keys and make your previous keys invalid.",
-        "impact": "Any applications or services currently using these keys will stop working until you update them with the new keys.",
-        "confirmPrompt": "Are you sure you want to continue?",
-        "confirmCta": "Refresh Keys"
-      },
-      "generateError": "We couldn't generate your API key."
-    }
-  },
-  "termsAndConditions": "Terms & Conditions",
-  "logOut": "Log out"
+  }
 }
@@ -68,8 +68,6 @@
  },
  "error": {
    "pdfPassword": "The PDF Document is passworded and either the password was not provided or was incorrect",
-    "encryptedPdfMustRemovePassword": "This PDF is encrypted or password-protected. Please unlock it before converting to PDF/A.",
-    "incorrectPasswordProvided": "The PDF password is incorrect or not provided.",
    "_value": "Error",
    "sorry": "Sorry for the issue!",
    "needHelp": "Need help / Found an issue?",
@@ -350,257 +348,206 @@
    "globalPopularity": "Global Popularity",
    "sortBy": "Sort by:",
    "multiTool": {
-      "tags": "multiple,tools",
      "title": "PDF Multi Tool",
      "desc": "Merge, Rotate, Rearrange, Split, and Remove pages"
    },
    "merge": {
-      "tags": "combine,join,unite",
      "title": "Merge",
      "desc": "Easily merge multiple PDFs into one."
    },
    "split": {
-      "tags": "divide,separate,break",
      "title": "Split",
      "desc": "Split PDFs into multiple documents"
    },
    "rotate": {
-      "tags": "turn,flip,orient",
      "title": "Rotate",
      "desc": "Easily rotate your PDFs."
    },
    "imageToPDF": {
-      "tags": "convert,image,transform",
      "title": "Image to PDF",
      "desc": "Convert a image (PNG, JPEG, GIF) to PDF."
    },
    "pdfToImage": {
-      "tags": "convert,image,extract",
      "title": "PDF to Image",
      "desc": "Convert a PDF to a image. (PNG, JPEG, GIF)"
    },
    "pdfOrganiser": {
-      "tags": "organize,rearrange,reorder",
      "title": "Organize",
      "desc": "Remove/Rearrange pages in any order"
    },
    "addImage": {
-      "tags": "insert,embed,place",
      "title": "Add image",
      "desc": "Adds a image onto a set location on the PDF"
    },
    "watermark": {
-      "tags": "stamp,mark,overlay",
      "title": "Add Watermark",
      "desc": "Add a custom watermark to your PDF document."
    },
    "permissions": {
-      "tags": "permissions,security,access",
      "title": "Change Permissions",
      "desc": "Change the permissions of your PDF document"
    },
    "pageRemover": {
-      "tags": "remove,delete,pages",
      "title": "Remove",
      "desc": "Delete unwanted pages from your PDF document."
    },
    "addPassword": {
-      "tags": "password,encrypt,secure",
      "title": "Add Password",
      "desc": "Encrypt your PDF document with a password."
    },
    "changePermissions": {
-      "tags": "permissions,restrictions,security",
      "title": "Change Permissions",
      "desc": "Change document restrictions and permissions."
    },
    "removePassword": {
-      "tags": "unlock,remove,password",
      "title": "Remove Password",
      "desc": "Remove password protection from your PDF document."
    },
    "compress": {
-      "tags": "shrink,reduce,optimize",
      "title": "Compress",
      "desc": "Compress PDFs to reduce their file size."
    },
    "sanitize": {
-      "tags": "clean,purge,remove",
      "title": "Sanitize",
      "desc": "Remove potentially harmful elements from PDF files."
    },
    "unlockPDFForms": {
-      "tags": "unlock,enable,edit",
      "title": "Unlock PDF Forms",
      "desc": "Remove read-only property of form fields in a PDF document."
    },
    "changeMetadata": {
-      "tags": "edit,modify,update",
      "title": "Change Metadata",
      "desc": "Change/Remove/Add metadata from a PDF document"
    },
    "fileToPDF": {
-      "tags": "convert,transform,change",
      "title": "Convert file to PDF",
      "desc": "Convert nearly any file to PDF (DOCX, PNG, XLS, PPT, TXT and more)"
    },
    "ocr": {
-      "tags": "extract,scan",
      "title": "OCR / Cleanup scans",
      "desc": "Cleanup scans and detects text from images within a PDF and re-adds it as text."
    },
    "extractImages": {
-      "tags": "pull,save,export",
      "title": "Extract Images",
      "desc": "Extracts all images from a PDF and saves them to zip"
    },
    "pdfToPDFA": {
-      "tags": "convert,archive,long-term",
      "title": "PDF to PDF/A",
      "desc": "Convert PDF to PDF/A for long-term storage"
    },
    "PDFToWord": {
-      "tags": "convert,word,doc",
      "title": "PDF to Word",
      "desc": "Convert PDF to Word formats (DOC, DOCX and ODT)"
    },
    "PDFToPresentation": {
-      "tags": "convert,presentation,ppt",
      "title": "PDF to Presentation",
      "desc": "Convert PDF to Presentation formats (PPT, PPTX and ODP)"
    },
    "PDFToText": {
-      "tags": "convert,text,rtf",
      "title": "PDF to RTF (Text)",
      "desc": "Convert PDF to Text or RTF format"
    },
    "PDFToHTML": {
-      "tags": "convert,html,web",
      "title": "PDF to HTML",
      "desc": "Convert PDF to HTML format"
    },
    "PDFToXML": {
-      "tags": "convert,xml,data",
      "title": "PDF to XML",
      "desc": "Convert PDF to XML format"
    },
    "ScannerImageSplit": {
-      "tags": "detect,split,photos",
      "title": "Detect/Split Scanned photos",
      "desc": "Splits multiple photos from within a photo/PDF"
    },
    "sign": {
-      "tags": "signature,autograph",
      "title": "Sign",
      "desc": "Adds signature to PDF by drawing, text or image"
    },
    "flatten": {
-      "tags": "simplify,remove,interactive",
      "title": "Flatten",
      "desc": "Remove all interactive elements and forms from a PDF"
    },
    "repair": {
-      "tags": "fix,restore",
      "title": "Repair",
      "desc": "Tries to repair a corrupt/broken PDF"
    },
    "removeBlanks": {
-      "tags": "delete,clean,empty",
      "title": "Remove Blank pages",
      "desc": "Detects and removes blank pages from a document"
    },
    "removeAnnotations": {
-      "tags": "delete,clean,strip",
      "title": "Remove Annotations",
      "desc": "Removes all comments/annotations from a PDF"
    },
    "compare": {
-      "tags": "difference",
      "title": "Compare",
      "desc": "Compares and shows the differences between 2 PDF Documents"
    },
    "certSign": {
-      "tags": "authenticate,PEM,P12,official,encrypt,sign,certificate,PKCS12,JKS,server,manual,auto",
      "title": "Sign with Certificate",
      "desc": "Signs a PDF with a Certificate/Key (PEM/P12)"
    },
    "removeCertSign": {
-      "tags": "remove,delete,unlock",
      "title": "Remove Certificate Sign",
      "desc": "Remove certificate signature from PDF"
    },
    "pageLayout": {
-      "tags": "layout,arrange,combine",
      "title": "Multi-Page Layout",
      "desc": "Merge multiple pages of a PDF document into a single page"
    },
    "bookletImposition": {
-      "tags": "booklet,print,binding",
      "title": "Booklet Imposition",
      "desc": "Create booklets with proper page ordering and multi-page layout for printing and binding"
    },
    "scalePages": {
-      "tags": "resize,adjust,scale",
      "title": "Adjust page size/scale",
      "desc": "Change the size/scale of a page and/or its contents."
    },
    "pipeline": {
-      "tags": "automation,script,workflow",
      "title": "Pipeline",
      "desc": "Run multiple actions on PDFs by defining pipeline scripts"
    },
    "addPageNumbers": {
-      "tags": "number,pagination,count",
      "title": "Add Page Numbers",
      "desc": "Add Page numbers throughout a document in a set location"
    },
    "auto-rename": {
-      "tags": "auto-detect,header-based,organize,relabel",
      "title": "Auto Rename PDF File",
      "desc": "Auto renames a PDF file based on its detected header"
    },
    "adjustContrast": {
-      "tags": "contrast,brightness,saturation",
      "title": "Adjust Colors/Contrast",
      "desc": "Adjust Contrast, Saturation and Brightness of a PDF"
    },
    "crop": {
-      "tags": "trim,cut,resize",
      "title": "Crop PDF",
      "desc": "Crop a PDF to reduce its size (maintains text!)"
    },
    "autoSplitPDF": {
-      "tags": "auto,split,QR",
      "title": "Auto Split Pages",
      "desc": "Auto Split Scanned PDF with physical scanned page splitter QR Code"
    },
    "sanitizePDF": {
-      "tags": "clean,purge,remove",
      "title": "Sanitize",
      "desc": "Remove scripts and other elements from PDF files"
    },
    "URLToPDF": {
-      "tags": "convert,url,website",
      "title": "URL/Website To PDF",
      "desc": "Converts any http(s)URL to PDF"
    },
    "HTMLToPDF": {
-      "tags": "convert,html,web",
      "title": "HTML to PDF",
      "desc": "Converts any HTML file or zip to PDF"
    },
    "MarkdownToPDF": {
-      "tags": "convert,markdown,md",
      "title": "Markdown to PDF",
      "desc": "Converts any Markdown file to PDF"
    },
    "PDFToMarkdown": {
-      "tags": "convert,markdown,md",
      "title": "PDF to Markdown",
      "desc": "Converts any PDF to Markdown"
    },
    "getPdfInfo": {
-      "tags": "info,metadata,details",
      "title": "Get ALL Info on PDF",
      "desc": "Grabs any and all information possible on PDFs"
    },
@@ -617,62 +564,50 @@
      "desc": "Searches and displays any JS injected into a PDF"
    },
    "autoRedact": {
-      "tags": "auto,redact,censor",
      "title": "Auto Redact",
      "desc": "Auto Redacts(Blacks out) text in a PDF based on input text"
    },
    "redact": {
-      "tags": "censor,blackout,hide",
      "title": "Manual Redaction",
      "desc": "Redacts a PDF based on selected text, drawn shapes and/or selected page(s)"
    },
    "PDFToCSV": {
-      "tags": "convert,csv,table",
      "title": "PDF to CSV",
      "desc": "Extracts Tables from a PDF converting it to CSV"
    },
    "split-by-size-or-count": {
-      "tags": "auto,split,size",
      "title": "Auto Split by Size/Count",
      "desc": "Split a single PDF into multiple documents based on size, page count, or document count"
    },
    "overlay-pdfs": {
-      "tags": "overlay,combine,stack",
      "title": "Overlay PDFs",
      "desc": "Overlays PDFs on-top of another PDF"
    },
    "split-by-sections": {
-      "tags": "split,sections,divide",
      "title": "Split PDF by Sections",
      "desc": "Divide each page of a PDF into smaller horizontal and vertical sections"
    },
    "AddStampRequest": {
-      "tags": "stamp,mark,seal",
      "title": "Add Stamp to PDF",
      "desc": "Add text or add image stamps at set locations"
    },
    "removeImage": {
-      "tags": "remove,delete,clean",
      "title": "Remove image",
      "desc": "Remove image from PDF to reduce file size"
    },
    "splitByChapters": {
-      "tags": "split,chapters,structure",
      "title": "Split PDF by Chapters",
      "desc": "Split a PDF into multiple files based on its chapter structure."
    },
    "validateSignature": {
-      "tags": "validate,verify,certificate",
      "title": "Validate PDF Signature",
      "desc": "Verify digital signatures and certificates in PDF documents"
    },
    "swagger": {
-      "tags": "API,documentation,test",
      "title": "API Documentation",
      "desc": "View API documentation and test endpoints"
    },
    "replace-color": {
-      "tags": "color,replace,invert",
      "title": "Replace and Invert Color",
      "desc": "Replace color for text and background in PDF and invert full color of pdf to reduce file size"
    }
@@ -1129,6 +1064,7 @@
    "info": "Python is not installed. It is required to run."
  },
  "sign": {
+    "tags": "authorize,initials,drawn-signature,text-sign,image-signature",
    "title": "Sign",
    "header": "Sign PDFs",
    "upload": "Upload Image",
@@ -1534,7 +1470,6 @@
    "tags": "Stamp, Add image, center image, Watermark, PDF, Embed, Customize",
    "header": "Stamp PDF",
    "title": "Stamp PDF",
-    "stampSetup": "Stamp Setup",
    "stampType": "Stamp Type",
    "stampText": "Stamp Text",
    "stampImage": "Stamp Image",
@@ -1547,8 +1482,7 @@
    "overrideY": "Override Y Coordinate",
    "customMargin": "Custom Margin",
    "customColor": "Custom Text Color",
-    "submit": "Submit",
-    "noStampSelected": "No stamp selected. Return to Step 1."
+    "submit": "Submit"
  },
  "removeImagePdf": {
    "tags": "Remove Image,Page operations,Back end,server side"
@@ -1,17 +1,8 @@
 #!/usr/bin/env node

-import { execSync } from 'node:child_process';
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
-import * as path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { argv } from 'node:process';
-const inputIdx = argv.indexOf('--input');
-const INPUT_FILE = inputIdx > -1 ? argv[inputIdx + 1] : null;
-const POSTPROCESS_ONLY = !!INPUT_FILE;
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');

 /**
 * Generate 3rd party licenses for frontend dependencies
@@ -23,54 +14,59 @@ const PACKAGE_JSON = path.join(__dirname, '..', 'package.json');

 // Ensure the output directory exists
 const outputDir = path.dirname(OUTPUT_FILE);
-if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
+if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
 }

 console.log('🔍 Generating frontend license report...');

 try {
-    // Safety guard: don't run this script on fork PRs (workflow setzt PR_IS_FORK)
-    if (process.env.PR_IS_FORK === 'true' && !POSTPROCESS_ONLY) {
-        console.error('Fork PR detected: only --input (postprocess-only) mode is allowed.');
-        process.exit(2);
+    // Install license-checker if not present
+    try {
+        require.resolve('license-checker');
+    } catch {
+        console.log('📦 Installing license-checker...');
+        execSync('npm install --save-dev license-checker', { stdio: 'inherit' });
    }

+    // Generate license report using license-checker (more reliable)
+    const licenseReport = execSync('npx license-checker --production --json', {
+        encoding: 'utf8',
+        cwd: path.dirname(PACKAGE_JSON)
+    });
+
    let licenseData;
-    // Generate license report using pinned license-checker; disable lifecycle scripts
-    if (POSTPROCESS_ONLY) {
-      if (!INPUT_FILE || !existsSync(INPUT_FILE)) {
-        console.error('❌ --input file missing or not found');
+    try {
+        licenseData = JSON.parse(licenseReport);
+    } catch (parseError) {
+        console.error('❌ Failed to parse license data:', parseError.message);
+        console.error('Raw output:', licenseReport.substring(0, 500) + '...');
        process.exit(1);
-      }
-      licenseData = JSON.parse(readFileSync(INPUT_FILE, 'utf8'));
-    } else {
-      const licenseReport = execSync(
-          // 'npx --yes license-checker@25.0.1 --production --json',
-          'npx --yes license-report --only=prod --output=json',
-          {
-              encoding: 'utf8',
-              cwd: path.dirname(PACKAGE_JSON),
-              env: { ...process.env, NPM_CONFIG_IGNORE_SCRIPTS: 'true' }
-          }
-      );
-      try {
-          licenseData = JSON.parse(licenseReport);
-      } catch (parseError) {
-          console.error('❌ Failed to parse license data:', parseError.message);
-          console.error('Raw output:', licenseReport.substring(0, 500) + '...');
-          process.exit(1);
-      }
    }

-    if (!Array.isArray(licenseData)) {
+    if (!licenseData || typeof licenseData !== 'object') {
        console.error('❌ Invalid license data structure');
        process.exit(1);
    }

    // Convert license-checker format to array
-    const licenseArray = licenseData.map(dep => {
-        let licenseType = dep.licenseType;
+    const licenseArray = Object.entries(licenseData).map(([key, value]) => {
+        let name, version;
+
+        // Handle scoped packages like @mantine/core@1.0.0
+        if (key.startsWith('@')) {
+            const parts = key.split('@');
+            name = `@${parts[1]}`;
+            version = parts[2];
+        } else {
+            // Handle regular packages like react@18.0.0
+            const lastAtIndex = key.lastIndexOf('@');
+            name = key.substring(0, lastAtIndex);
+            version = key.substring(lastAtIndex + 1);
+        }
+
+        // Normalize license types for edge cases
+        let licenseType = value.licenses;

        // Handle missing or null licenses
        if (!licenseType || licenseType === null || licenseType === undefined) {
@@ -92,17 +88,13 @@ try {
            licenseType = 'Unknown';
        }

-        if ( "posthog-js" === dep.name && licenseType.startsWith("SEE LICENSE IN LICENSE")) {
-            licenseType = "SEE LICENSE IN LICENSE https://github.com/PostHog/posthog-js/blob/main/LICENSE";
-        }
-
        return {
-            name: dep.name,
-            version: dep.installedVersion || dep.definedVersion || dep.remoteVersion || 'unknown',
+            name: name,
+            version: version || value.version || 'unknown',
            licenseType: licenseType,
-            repository: dep.link,
-            url: dep.link,
-            link: dep.link
+            repository: value.repository,
+            url: value.url,
+            link: value.licenseUrl
        };
    });

@@ -161,7 +153,7 @@ try {

        // Write license warnings to a separate file for CI/CD
        const warningsFile = path.join(__dirname, '..', 'src', 'assets', 'license-warnings.json');
-        writeFileSync(warningsFile, JSON.stringify({
+        fs.writeFileSync(warningsFile, JSON.stringify({
            warnings: problematicLicenses,
            generated: new Date().toISOString()
        }, null, 2));
@@ -171,7 +163,7 @@ try {
    }

    // Write to file
-    writeFileSync(OUTPUT_FILE, JSON.stringify(transformedData, null, 4));
+    fs.writeFileSync(OUTPUT_FILE, JSON.stringify(transformedData, null, 4));

    console.log(`✅ License report generated successfully!`);
    console.log(`📄 Found ${transformedData.dependencies.length} dependencies`);
@@ -282,8 +274,7 @@ function checkLicenseCompatibility(licenseSummary, licenseArray) {
        'MIT', 'MIT*', 'Apache-2.0', 'Apache License 2.0', 'BSD-2-Clause', 'BSD-3-Clause', 'BSD',
        'ISC', 'CC0-1.0', 'Public Domain', 'Unlicense', '0BSD', 'BlueOak-1.0.0',
        'Zlib', 'Artistic-2.0', 'Python-2.0', 'Ruby', 'MPL-2.0', 'CC-BY-4.0',
-        'SEE LICENSE IN https://raw.githubusercontent.com/Stirling-Tools/Stirling-PDF/refs/heads/main/proprietary/LICENSE',
-        'SEE LICENSE IN LICENSE https://github.com/PostHog/posthog-js/blob/main/LICENSE'
+        'SEE LICENSE IN https://raw.githubusercontent.com/Stirling-Tools/Stirling-PDF/refs/heads/main/proprietary/LICENSE'
    ]);

    // Helper function to normalize license names for comparison
@@ -56,20 +56,6 @@
  border-bottom: 1px solid var(--header-selected-bg);
 }

-/* Error highlight (transient) */
-.headerError {
-  background: var(--color-red-200);
-  color: var(--text-primary);
-  border-bottom: 2px solid var(--color-red-500);
-}
-
-/* Unsupported (but not errored) header appearance */
-.headerUnsupported {
-  background: var(--unsupported-bar-bg); /* neutral gray */
-  color: #FFFFFF;
-  border-bottom: 1px solid var(--unsupported-bar-border);
-}
-
 /* Selected border color in light mode */
 :global([data-mantine-color-scheme="light"]) .card[data-selected="true"] {
  outline-color: var(--card-selected-border);
@@ -94,7 +80,6 @@

 .kebab {
  justify-self: end;
-  color: #FFFFFF !important;
 }

 /* Menu dropdown */
@@ -232,22 +217,6 @@
  height: 20px;
 }

-/* Error pill shown when a file failed processing */
-.errorPill {
-  margin-left: 1.75rem;
-  background: var(--color-red-500);
-  color: #ffffff;
-  padding: 4px 8px;
-  border-radius: 12px;
-  font-size: 10px;
-  font-weight: 600;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  min-width: 56px;
-  height: 20px;
-}
-
 /* Animations */
@keyframes pulse {
  0%, 100% {
@@ -1,6 +1,6 @@
 import React, { useState, useCallback, useRef, useMemo } from 'react';
 import {
-  Text, Center, Box, LoadingOverlay, Stack, Group
+  Text, Center, Box, Notification, LoadingOverlay, Stack, Group, Portal
 } from '@mantine/core';
 import { Dropzone } from '@mantine/dropzone';
 import { useFileSelection, useFileState, useFileManagement } from '../../contexts/FileContext';
@@ -11,7 +11,6 @@ import FileEditorThumbnail from './FileEditorThumbnail';
 import FilePickerModal from '../shared/FilePickerModal';
 import SkeletonLoader from '../shared/SkeletonLoader';
 import { FileId, StirlingFile } from '../../types/fileContext';
-import { alert } from '../toast';
 import { downloadBlob } from '../../utils/downloadUtils';


@@ -47,16 +46,8 @@ const FileEditor = ({
  // Get file selection context
  const { setSelectedFiles } = useFileSelection();

-  const [_status, _setStatus] = useState<string | null>(null);
-  const [_error, _setError] = useState<string | null>(null);
-
-  // Toast helpers
-  const showStatus = useCallback((message: string, type: 'neutral' | 'success' | 'warning' | 'error' = 'neutral') => {
-    alert({ alertType: type, title: message, expandable: false, durationMs: 4000 });
-  }, []);
-  const showError = useCallback((message: string) => {
-    alert({ alertType: 'error', title: 'Error', body: message, expandable: true });
-  }, []);
+  const [status, setStatus] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
  const [selectionMode, setSelectionMode] = useState(toolMode);

  // Enable selection mode automatically in tool mode
@@ -91,7 +82,7 @@ const FileEditor = ({

  // Process uploaded files using context
  const handleFileUpload = useCallback(async (uploadedFiles: File[]) => {
-    _setError(null);
+    setError(null);

    try {
      const allExtractedFiles: File[] = [];
@@ -166,18 +157,18 @@ const FileEditor = ({

      // Show any errors
      if (errors.length > 0) {
-        showError(errors.join('\n'));
+        setError(errors.join('\n'));
      }

      // Process all extracted files
      if (allExtractedFiles.length > 0) {
        // Add files to context (they will be processed automatically)
        await addFiles(allExtractedFiles);
-        showStatus(`Added ${allExtractedFiles.length} files`, 'success');
+        setStatus(`Added ${allExtractedFiles.length} files`);
      }
    } catch (err) {
      const errorMessage = err instanceof Error ? err.message : 'Failed to process files';
-      showError(errorMessage);
+      setError(errorMessage);
      console.error('File processing error:', err);

      // Reset extraction progress on error
@@ -215,7 +206,7 @@ const FileEditor = ({
      } else {
        // Check if we've hit the selection limit
        if (maxAllowed > 1 && currentSelectedIds.length >= maxAllowed) {
-          showStatus(`Maximum ${maxAllowed} files can be selected`, 'warning');
+          setStatus(`Maximum ${maxAllowed} files can be selected`);
          return;
        }
        newSelection = [...currentSelectedIds, contextFileId];
@@ -224,7 +215,7 @@ const FileEditor = ({

    // Update context (this automatically updates tool selection since they use the same action)
    setSelectedFiles(newSelection);
-  }, [setSelectedFiles, toolMode, _setStatus, activeStirlingFileStubs]);
+  }, [setSelectedFiles, toolMode, setStatus, activeStirlingFileStubs]);


  // File reordering handler for drag and drop
@@ -280,8 +271,8 @@ const FileEditor = ({

    // Update status
    const moveCount = filesToMove.length;
-    showStatus(`${moveCount > 1 ? `${moveCount} files` : 'File'} reordered`);
-  }, [activeStirlingFileStubs, reorderFiles, _setStatus]);
+    setStatus(`${moveCount > 1 ? `${moveCount} files` : 'File'} reordered`);
+  }, [activeStirlingFileStubs, reorderFiles, setStatus]);



@@ -306,7 +297,7 @@ const FileEditor = ({
    if (record && file) {
       downloadBlob(file, file.name);
    }
-  }, [activeStirlingFileStubs, selectors, _setStatus]);
+  }, [activeStirlingFileStubs, selectors, setStatus]);

  const handleViewFile = useCallback((fileId: FileId) => {
    const record = activeStirlingFileStubs.find(r => r.id === fileId);
@@ -323,10 +314,10 @@ const FileEditor = ({
    try {
      // Use FileContext to handle loading stored files
      // The files are already in FileContext, just need to add them to active files
-      showStatus(`Loaded ${selectedFiles.length} files from storage`);
+      setStatus(`Loaded ${selectedFiles.length} files from storage`);
    } catch (err) {
      console.error('Error loading files from storage:', err);
-      showError('Failed to load some files from storage');
+      setError('Failed to load some files from storage');
    }
  }, []);

@@ -417,7 +408,7 @@ const FileEditor = ({
                  onToggleFile={toggleFile}
                  onDeleteFile={handleDeleteFile}
                  onViewFile={handleViewFile}
-                  _onSetStatus={showStatus}
+                  onSetStatus={setStatus}
                  onReorderFiles={handleReorderFiles}
                  onDownloadFile={handleDownloadFile}
                  toolMode={toolMode}
@@ -437,7 +428,31 @@ const FileEditor = ({
        onSelectFiles={handleLoadFromStorage}
      />

-      
+      {status && (
+        <Portal>
+          <Notification
+            color="blue"
+            mt="md"
+            onClose={() => setStatus(null)}
+            style={{ position: 'fixed', bottom: 40, right: 80, zIndex: 10001 }}
+          >
+            {status}
+          </Notification>
+        </Portal>
+      )}
+
+      {error && (
+        <Portal>
+          <Notification
+            color="red"
+            mt="md"
+            onClose={() => setError(null)}
+            style={{ position: 'fixed', bottom: 80, right: 20, zIndex: 10001 }}
+          >
+            {error}
+          </Notification>
+        </Portal>
+      )}
      </Box>
    </Dropzone>
  );
@@ -1,6 +1,5 @@
 import React, { useState, useCallback, useRef, useMemo, useEffect } from 'react';
 import { Text, ActionIcon, CheckboxIndicator } from '@mantine/core';
-import { alert } from '../toast';
 import { useTranslation } from 'react-i18next';
 import MoreVertIcon from '@mui/icons-material/MoreVert';
 import DownloadOutlinedIcon from '@mui/icons-material/DownloadOutlined';
@@ -13,7 +12,6 @@ import { StirlingFileStub } from '../../types/fileContext';

 import styles from './FileEditor.module.css';
 import { useFileContext } from '../../contexts/FileContext';
-import { useFileState } from '../../contexts/file/fileHooks';
 import { FileId } from '../../types/file';
 import { formatFileSize } from '../../utils/fileUtils';
 import ToolChain from '../shared/ToolChain';
@@ -29,7 +27,7 @@ interface FileEditorThumbnailProps {
  onToggleFile: (fileId: FileId) => void;
  onDeleteFile: (fileId: FileId) => void;
  onViewFile: (fileId: FileId) => void;
-  _onSetStatus: (status: string) => void;
+  onSetStatus: (status: string) => void;
  onReorderFiles?: (sourceFileId: FileId, targetFileId: FileId, selectedFileIds: FileId[]) => void;
  onDownloadFile: (fileId: FileId) => void;
  toolMode?: boolean;
@@ -42,15 +40,13 @@ const FileEditorThumbnail = ({
  selectedFiles,
  onToggleFile,
  onDeleteFile,
-  _onSetStatus,
+  onSetStatus,
  onReorderFiles,
  onDownloadFile,
  isSupported = true,
 }: FileEditorThumbnailProps) => {
  const { t } = useTranslation();
-  const { pinFile, unpinFile, isFilePinned, activeFiles, actions: fileActions } = useFileContext();
-  const { state } = useFileState();
-  const hasError = state.ui.errorFileIds.includes(file.id);
+  const { pinFile, unpinFile, isFilePinned, activeFiles } = useFileContext();

  // ---- Drag state ----
  const [isDragging, setIsDragging] = useState(false);
@@ -191,20 +187,9 @@ const FileEditorThumbnail = ({
  // ---- Card interactions ----
  const handleCardClick = () => {
    if (!isSupported) return;
-    // Clear error state if file has an error (click to clear error)
-    if (hasError) {
-      try { fileActions.clearFileError(file.id); } catch (_e) { void _e; }
-    }
    onToggleFile(file.id);
  };

-  // ---- Style helpers ----
-  const getHeaderClassName = () => {
-    if (hasError) return styles.headerError;
-    if (!isSupported) return styles.headerUnsupported;
-    return isSelected ? styles.headerSelected : styles.headerResting;
-  };
-

  return (
    <div
@@ -214,7 +199,10 @@ const FileEditorThumbnail = ({
      data-selected={isSelected}
      data-supported={isSupported}
      className={`${styles.card} w-[18rem] h-[22rem] select-none flex flex-col shadow-sm transition-all relative`}
-      style={{opacity: isDragging ? 0.9 : 1}}
+      style={{
+        opacity: isSupported ? (isDragging ? 0.9 : 1) : 0.5,
+        filter: isSupported ? 'none' : 'grayscale(50%)',
+      }}
      tabIndex={0}
      role="listitem"
      aria-selected={isSelected}
@@ -222,16 +210,13 @@ const FileEditorThumbnail = ({
    >
      {/* Header bar */}
      <div
-        className={`${styles.header} ${getHeaderClassName()}`}
-        data-has-error={hasError}
+        className={`${styles.header} ${
+          isSelected ? styles.headerSelected : styles.headerResting
+        }`}
      >
        {/* Logo/checkbox area */}
        <div className={styles.logoMark}>
-          {hasError ? (
-            <div className={styles.errorPill}>
-              <span>{t('error._value', 'Error')}</span>
-            </div>
-          ) : isSupported ? (
+          {isSupported ? (
            <CheckboxIndicator
              checked={isSelected}
              onChange={() => onToggleFile(file.id)}
@@ -278,10 +263,10 @@ const FileEditorThumbnail = ({
              if (actualFile) {
                if (isPinned) {
                  unpinFile(actualFile);
-                  alert({ alertType: 'neutral', title: `Unpinned ${file.name}`, expandable: false, durationMs: 3000 });
+                  onSetStatus?.(`Unpinned ${file.name}`);
                } else {
                  pinFile(actualFile);
-                  alert({ alertType: 'success', title: `Pinned ${file.name}`, expandable: false, durationMs: 3000 });
+                  onSetStatus?.(`Pinned ${file.name}`);
                }
              }
              setShowActions(false);
@@ -293,7 +278,7 @@ const FileEditorThumbnail = ({

          <button
            className={styles.actionRow}
-            onClick={() => { onDownloadFile(file.id); alert({ alertType: 'success', title: `Downloading ${file.name}`, expandable: false, durationMs: 2500 }); setShowActions(false); }}
+            onClick={() => { onDownloadFile(file.id); setShowActions(false); }}
          >
            <DownloadOutlinedIcon fontSize="small" />
            <span>{t('download', 'Download')}</span>
@@ -305,7 +290,7 @@ const FileEditorThumbnail = ({
            className={`${styles.actionRow} ${styles.actionDanger}`}
            onClick={() => {
              onDeleteFile(file.id);
-              alert({ alertType: 'neutral', title: `Deleted ${file.name}`, expandable: false, durationMs: 3500 });
+              onSetStatus(`Deleted ${file.name}`);
              setShowActions(false);
            }}
          >
@@ -343,10 +328,7 @@ const FileEditorThumbnail = ({
      </div>

      {/* Preview area */}
-      <div
-        className={`${styles.previewBox} mx-6 mb-4 relative flex-1`}
-        style={isSupported || hasError ? undefined : { filter: 'grayscale(80%)', opacity: 0.6 }}
-      >
+      <div className={`${styles.previewBox} mx-6 mb-4 relative flex-1`}>
        <div className={styles.previewPaper}>
          {file.thumbnailUrl && (
            <img
@@ -4,6 +4,7 @@ import { useToolWorkflow } from '../../contexts/ToolWorkflowContext';
 import { useFileHandler } from '../../hooks/useFileHandler';
 import { useFileState } from '../../contexts/FileContext';
 import { useNavigationState, useNavigationActions } from '../../contexts/NavigationContext';
+import { useToolManagement } from '../../hooks/useToolManagement';
 import './Workbench.css';

 import TopControls from '../shared/TopControls';
@@ -13,7 +14,6 @@ import PageEditorControls from '../pageEditor/PageEditorControls';
 import Viewer from '../viewer/Viewer';
 import LandingPage from '../shared/LandingPage';
 import Footer from '../shared/Footer';
-import DismissAllErrorsButton from '../shared/DismissAllErrorsButton';

 // No props needed - component uses contexts directly
 export default function Workbench() {
@@ -39,8 +39,8 @@ export default function Workbench() {
  // Get navigation state - this is the source of truth
  const { selectedTool: selectedToolId } = useNavigationState();

-  // Get tool registry from context (instead of direct hook call)
-  const { toolRegistry } = useToolWorkflow();
+  // Get tool registry to look up selected tool
+  const { toolRegistry } = useToolManagement();
  const selectedTool = selectedToolId ? toolRegistry[selectedToolId] : null;
  const { addFiles } = useFileHandler();

@@ -152,9 +152,6 @@ export default function Workbench() {
        selectedToolKey={selectedToolId}
      />

-      {/* Dismiss All Errors Button */}
-      <DismissAllErrorsButton />
-
      {/* Main content area */}
      <Box
        className="flex-1 min-h-0 relative z-10 workbench-scrollable "
@@ -1,5 +1,4 @@
 import { Button, Group, Stack, Text } from "@mantine/core";
-import FitText from "./FitText";

 export interface ButtonOption<T> {
  value: T;
@@ -14,8 +13,6 @@ interface ButtonSelectorProps<T> {
  label?: string;
  disabled?: boolean;
  fullWidth?: boolean;
-  buttonClassName?: string;
-  textClassName?: string;
 }

 const ButtonSelector = <T extends string | number>({
@@ -25,8 +22,6 @@ const ButtonSelector = <T extends string | number>({
  label = undefined,
  disabled = false,
  fullWidth = true,
-  buttonClassName,
-  textClassName,
 }: ButtonSelectorProps<T>) => {
  return (
    <Stack gap='var(--mantine-spacing-sm)'>
@@ -46,7 +41,6 @@ const ButtonSelector = <T extends string | number>({
            color={value === option.value ? 'var(--color-primary-500)' : 'var(--text-muted)'}
            onClick={() => onChange(option.value)}
            disabled={disabled || option.disabled}
-            className={buttonClassName}
            style={{
              flex: fullWidth ? 1 : undefined,
              height: 'auto',
@@ -57,13 +51,7 @@ const ButtonSelector = <T extends string | number>({
              paddingBottom: '0.5rem'
            }}
          >
-            <FitText
-              text={option.label}
-              lines={1}
-              minimumFontScale={0.5}
-              fontSize={10}
-              className={textClassName}
-            />
+            {option.label}
          </Button>
        ))}
      </Group>
@@ -1,51 +0,0 @@
-import React from 'react';
-import { Button, Group } from '@mantine/core';
-import { useTranslation } from 'react-i18next';
-import { useFileState } from '../../contexts/FileContext';
-import { useFileActions } from '../../contexts/file/fileHooks';
-import CloseIcon from '@mui/icons-material/Close';
-
-interface DismissAllErrorsButtonProps {
-  className?: string;
-}
-
-const DismissAllErrorsButton: React.FC<DismissAllErrorsButtonProps> = ({ className }) => {
-  const { t } = useTranslation();
-  const { state } = useFileState();
-  const { actions } = useFileActions();
-  
-  // Check if there are any files in error state
-  const hasErrors = state.ui.errorFileIds.length > 0;
-  
-  // Don't render if there are no errors
-  if (!hasErrors) {
-    return null;
-  }
-  
-  const handleDismissAllErrors = () => {
-    actions.clearAllFileErrors();
-  };
-  
-  return (
-    <Group className={className}>
-      <Button
-        variant="light"
-        color="red"
-        size="sm"
-        leftSection={<CloseIcon fontSize="small" />}
-        onClick={handleDismissAllErrors}
-        style={{
-          position: 'absolute',
-          top: '1rem',
-          right: '1rem',
-          zIndex: 1000,
-          pointerEvents: 'auto'
-        }}
-      >
-        {t('error.dismissAllErrors', 'Dismiss All Errors')} ({state.ui.errorFileIds.length})
-      </Button>
-    </Group>
-  );
-};
-
-export default DismissAllErrorsButton;
@@ -5,7 +5,6 @@ import LocalIcon from './LocalIcon';
 import { useTranslation } from 'react-i18next';
 import { useFileHandler } from '../../hooks/useFileHandler';
 import { useFilesModalContext } from '../../contexts/FilesModalContext';
-import { BASE_PATH } from '../../constants/app';

 const LandingPage = () => {
  const { addFiles } = useFileHandler();
@@ -73,7 +72,7 @@ const LandingPage = () => {
          }}
        >
          <img
-            src={colorScheme === 'dark' ? `${BASE_PATH}/branding/StirlingPDFLogoNoTextDark.svg` : `${BASE_PATH}/branding/StirlingPDFLogoNoTextLight.svg`}
+            src={colorScheme === 'dark' ? '/branding/StirlingPDFLogoNoTextDark.svg' : '/branding/StirlingPDFLogoNoTextLight.svg'}
            alt="Stirling PDF Logo"
            style={{
              height: 'auto',
@@ -99,7 +98,7 @@ const LandingPage = () => {
            {/* Stirling PDF Branding */}
            <Group gap="xs" align="center">
              <img
-                src={colorScheme === 'dark' ? `${BASE_PATH}/branding/StirlingPDFLogoWhiteText.svg` : `${BASE_PATH}/branding/StirlingPDFLogoGreyText.svg`}
+                src={colorScheme === 'dark' ? '/branding/StirlingPDFLogoWhiteText.svg' : '/branding/StirlingPDFLogoGreyText.svg'}
                alt="Stirling PDF"
                style={{ height: '2.2rem', width: 'auto' }}
              />
@@ -1,50 +0,0 @@
-import React from 'react';
-import styles from './ObscuredOverlay/ObscuredOverlay.module.css';
-
-type ObscuredOverlayProps = {
-  obscured: boolean;
-  overlayMessage?: React.ReactNode;
-  buttonText?: string;
-  onButtonClick?: () => void;
-  children: React.ReactNode;
-  // Optional border radius for the overlay container. If undefined, no radius is applied.
-  borderRadius?: string | number;
-};
-
-export default function ObscuredOverlay({
-  obscured,
-  overlayMessage,
-  buttonText,
-  onButtonClick,
-  children,
-  borderRadius,
-}: ObscuredOverlayProps) {
-  return (
-    <div className={styles.container}>
-      {children}
-      {obscured && (
-        <div
-          className={styles.overlay}
-          style={{
-            ...(borderRadius !== undefined ? { borderRadius } : {}),
-          }}
-        >
-          <div className={styles.overlayContent}>
-            {overlayMessage && (
-              <div className={styles.overlayMessage}>
-                {overlayMessage}
-              </div>
-            )}
-            {buttonText && onButtonClick && (
-              <button type="button" onClick={onButtonClick} className={styles.overlayButton}>
-                {buttonText}
-              </button>
-            )}
-          </div>
-        </div>
-      )}
-    </div>
-  );
-}
-
-
@@ -1,41 +0,0 @@
-.container {
-  position: relative;
-}
-
-.overlay {
-  position: absolute;
-  inset: 0;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  text-align: center;
-  padding: 16px;
-  color: #ffffff;
-  font-weight: 600;
-  background: rgba(16, 18, 27, 0.55);
-  backdrop-filter: blur(6px);
-  -webkit-backdrop-filter: blur(6px);
-  border: 1px solid rgba(255, 255, 255, 0.06);
-  z-index: 2;
-}
-
-.overlayContent {
-  display: flex;
-  flex-direction: column;
-  gap: 12px;
-  align-items: center;
-}
-
-.overlayMessage {
-  color: #ffffff;
-  font-weight: 600;
-}
-
-.overlayButton {
-  padding: 8px 12px;
-  border-radius: 8px;
-  border: 1px solid rgba(255, 255, 255, 0.12);
-  background: rgba(255, 255, 255, 0.06);
-  color: #ffffff;
-  cursor: pointer;
-}
@@ -3,9 +3,6 @@ import { MantineProvider } from '@mantine/core';
 import { useRainbowTheme } from '../../hooks/useRainbowTheme';
 import { mantineTheme } from '../../theme/mantineTheme';
 import rainbowStyles from '../../styles/rainbow.module.css';
-import { ToastProvider } from '../toast';
-import ToastRenderer from '../toast/ToastRenderer';
-import { ToastPortalBinder } from '../toast';

 interface RainbowThemeContextType {
  themeMode: 'light' | 'dark' | 'rainbow';
@@ -47,11 +44,7 @@ export function RainbowThemeProvider({ children }: RainbowThemeProviderProps) {
          className={rainbowTheme.isRainbowMode ? rainbowStyles.rainbowMode : ''}
          style={{ minHeight: '100vh' }}
        >
-          <ToastProvider>
-            <ToastPortalBinder />
-            {children}
-            <ToastRenderer />
-          </ToastProvider>
+          {children}
        </div>
      </MantineProvider>
    </RainbowThemeContext.Provider>
@@ -4,7 +4,7 @@ import LocalIcon from './LocalIcon';
 import './rightRail/RightRail.css';
 import { useToolWorkflow } from '../../contexts/ToolWorkflowContext';
 import { useRightRail } from '../../contexts/RightRailContext';
-import { useFileState, useFileSelection, useFileManagement, useFileContext } from '../../contexts/FileContext';
+import { useFileState, useFileSelection, useFileManagement } from '../../contexts/FileContext';
 import { useNavigationState } from '../../contexts/NavigationContext';
 import { useTranslation } from 'react-i18next';

@@ -39,7 +39,6 @@ export default function RightRail() {

  // File state and selection
  const { state, selectors } = useFileState();
-  const { actions: fileActions } = useFileContext();
  const { selectedFiles, selectedFileIds, setSelectedFiles } = useFileSelection();
  const { removeFiles } = useFileManagement();

@@ -71,8 +70,6 @@ export default function RightRail() {
      // Select all file IDs
      const allIds = state.files.ids;
      setSelectedFiles(allIds);
-      // Clear any previous error flags when selecting all
-      try { fileActions.clearAllFileErrors(); } catch (_e) { void _e; }
      return;
    }

@@ -85,8 +82,6 @@ export default function RightRail() {
  const handleDeselectAll = useCallback(() => {
    if (currentView === 'fileEditor' || currentView === 'viewer') {
      setSelectedFiles([]);
-      // Clear any previous error flags when deselecting all
-      try { fileActions.clearAllFileErrors(); } catch (_e) { void _e; }
      return;
    }
    if (currentView === 'pageEditor') {
@@ -6,7 +6,6 @@ import { useTooltipPosition } from '../../hooks/useTooltipPosition';
 import { TooltipTip } from '../../types/tips';
 import { TooltipContent } from './tooltip/TooltipContent';
 import { useSidebarContext } from '../../contexts/SidebarContext';
-import { BASE_PATH } from '../../constants/app';
 import styles from './tooltip/Tooltip.module.css';

 export interface TooltipProps {
@@ -329,7 +328,7 @@ export const Tooltip: React.FC<TooltipProps> = ({
          <div className={styles['tooltip-logo']}>
            {header.logo || (
              <img
-                src={`${BASE_PATH}/logo-tooltip.svg`}
+                src="/logo-tooltip.svg"
                alt="Stirling PDF"
                style={{ width: '1.4rem', height: '1.4rem', display: 'block' }}
              />
@@ -1,309 +0,0 @@
-# Toast Component
-
-A global notification system with expandable content, progress tracking, and smart error coalescing. Provides an imperative API for showing success, error, warning, and neutral notifications with customizable content and behavior.
-
---
-
-## Highlights
-
-* 🎯 **Global System**: Imperative API accessible from anywhere in the app via `alert()` function.
-* 🎨 **Four Alert Types**: Success (green), Error (red), Warning (yellow), Neutral (theme-aware).
-* 📱 **Expandable Content**: Collapsible toasts with chevron controls and smooth animations.
-* ⚡ **Smart Coalescing**: Duplicate error toasts merge with count badges (e.g., "Server error 4").
-* 📊 **Progress Tracking**: Built-in progress bars with completion animations.
-* 🎛️ **Customizable**: Rich JSX content, buttons with callbacks, custom icons.
-* 🌙 **Themeable**: Uses CSS variables; supports light/dark mode out of the box.
-* ♿ **Accessible**: Proper ARIA roles, keyboard navigation, and screen reader support.
-* 🔄 **Auto-dismiss**: Configurable duration with persistent popup option.
-* 📍 **Positioning**: Four corner positions with proper stacking.
-
---
-
-## Behavior
-
-### Default
-* **Auto-dismiss**: Toasts disappear after 6 seconds unless `isPersistentPopup: true`.
-* **Expandable**: Click chevron to expand/collapse body content (default: collapsed).
-* **Coalescing**: Identical error toasts merge with count badges.
-* **Progress**: Progress bars always visible when present, even when collapsed.
-
-### Error Handling
-* **Network Errors**: Automatically caught by Axios and fetch interceptors.
-* **Friendly Fallbacks**: Shows "There was an error processing your request" for unhelpful backend responses.
-* **Smart Titles**: "Server error" for 5xx, "Request error" for 4xx, "Network error" for others.
-
---
-
-## Installation
-
-The toast system is already integrated at the app root. No additional setup required.
-
-```tsx
-import { alert, updateToast, dismissToast } from '@/components/toast';
-```
-
---
-
-## Basic Usage
-
-### Simple Notifications
-
-```tsx
-// Success notification
-alert({
-  alertType: 'success',
-  title: 'File processed successfully',
-  body: 'Your document has been converted to PDF.'
-});
-
-// Error notification
-alert({
-  alertType: 'error',
-  title: 'Processing failed',
-  body: 'Unable to process the selected files.'
-});
-
-// Warning notification
-alert({
-  alertType: 'warning',
-  title: 'Low disk space',
-  body: 'Consider freeing up some storage space.'
-});
-
-// Neutral notification
-alert({
-  alertType: 'neutral',
-  title: 'Information',
-  body: 'This is a neutral notification.'
-});
-```
-
-### With Custom Content
-
-```tsx
-// Rich JSX content with buttons
-alert({
-  alertType: 'success',
-  title: 'Download complete',
-  body: (
-    <div>
-      <p>File saved to Downloads folder</p>
-      <button onClick={() => openFolder()}>Open folder</button>
-    </div>
-  ),
-  buttonText: 'View file',
-  buttonCallback: () => openFile(),
-  isPersistentPopup: true
-});
-```
-
-### Progress Tracking
-
-```tsx
-// Show progress
-const toastId = alert({
-  alertType: 'neutral',
-  title: 'Processing files...',
-  body: 'Converting your documents',
-  progressBarPercentage: 0
-});
-
-// Update progress
-updateToast(toastId, { progressBarPercentage: 50 });
-
-// Complete with success
-updateToast(toastId, { 
-  alertType: 'success',
-  title: 'Processing complete',
-  body: 'All files converted successfully',
-  progressBarPercentage: 100
-});
-```
-
-### Custom Positioning
-
-```tsx
-alert({
-  alertType: 'error',
-  title: 'Connection lost',
-  body: 'Please check your internet connection.',
-  location: 'top-right'
-});
-```
-
---
-
-## API
-
-### `alert(options: ToastOptions)`
-
-The primary function for showing toasts.
-
-```ts
-interface ToastOptions {
-  alertType?: 'success' | 'error' | 'warning' | 'neutral';
-  title: string;
-  body?: React.ReactNode;
-  buttonText?: string;
-  buttonCallback?: () => void;
-  isPersistentPopup?: boolean;
-  location?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-  icon?: React.ReactNode;
-  progressBarPercentage?: number; // 0-1 as fraction or 0-100 as percent
-  durationMs?: number;
-  id?: string;
-  expandable?: boolean;
-}
-```
-
-### `updateToast(id: string, options: Partial<ToastOptions>)`
-
-Update an existing toast.
-
-```tsx
-const toastId = alert({ title: 'Processing...', progressBarPercentage: 0 });
-updateToast(toastId, { progressBarPercentage: 75 });
-```
-
-### `dismissToast(id: string)`
-
-Dismiss a specific toast.
-
-```tsx
-dismissToast(toastId);
-```
-
-### `dismissAllToasts()`
-
-Dismiss all visible toasts.
-
-```tsx
-dismissAllToasts();
-```
-
---
-
-## Alert Types
-
-| Type | Color | Icon | Use Case |
-|------|-------|------|----------|
-| `success` | Green | ✓ | Successful operations, completions |
-| `error` | Red | ✗ | Failures, errors, exceptions |
-| `warning` | Yellow | ⚠ | Warnings, cautions, low resources |
-| `neutral` | Theme | ℹ | Information, general messages |
-
---
-
-## Positioning
-
-| Location | Description |
-|----------|-------------|
-| `top-left` | Top-left corner |
-| `top-right` | Top-right corner |
-| `bottom-left` | Bottom-left corner |
-| `bottom-right` | Bottom-right corner (default) |
-
---
-
-## Accessibility
-
-* Toasts use `role="status"` for screen readers.
-* Chevron and close buttons have proper `aria-label` attributes.
-* Keyboard navigation supported (Escape to dismiss).
-* Focus management for interactive content.
-
---
-
-## Examples
-
-### File Processing Workflow
-
-```tsx
-// Start processing
-const toastId = alert({
-  alertType: 'neutral',
-  title: 'Processing files...',
-  body: 'Converting 5 documents',
-  progressBarPercentage: 0,
-  isPersistentPopup: true
-});
-
-// Update progress
-updateToast(toastId, { progressBarPercentage: 30 });
-updateToast(toastId, { progressBarPercentage: 60 });
-
-// Complete successfully
-updateToast(toastId, {
-  alertType: 'success',
-  title: 'Processing complete',
-  body: 'All 5 documents converted successfully',
-  progressBarPercentage: 100,
-  isPersistentPopup: false
-});
-```
-
-### Error with Action
-
-```tsx
-alert({
-  alertType: 'error',
-  title: 'Upload failed',
-  body: 'File size exceeds the 10MB limit.',
-  buttonText: 'Try again',
-  buttonCallback: () => retryUpload(),
-  isPersistentPopup: true
-});
-```
-
-### Non-expandable Toast
-
-```tsx
-alert({
-  alertType: 'success',
-  title: 'Settings saved',
-  body: 'Your preferences have been updated.',
-  expandable: false,
-  durationMs: 3000
-});
-```
-
-### Custom Icon
-
-```tsx
-alert({
-  alertType: 'neutral',
-  title: 'New feature available',
-  body: 'Check out the latest updates.',
-  icon: <LocalIcon icon="star" />
-});
-```
-
---
-
-## Integration
-
-### Network Error Handling
-
-The toast system automatically catches network errors from Axios and fetch requests:
-
-```tsx
-// These automatically show error toasts
-axios.post('/api/convert', formData);
-fetch('/api/process', { method: 'POST', body: data });
-```
-
-### Manual Error Handling
-
-```tsx
-try {
-  await processFiles();
-  alert({ alertType: 'success', title: 'Files processed' });
-} catch (error) {
-  alert({ 
-    alertType: 'error', 
-    title: 'Processing failed',
-    body: error.message 
-  });
-}
-```
-
@@ -1,150 +0,0 @@
-import React, { createContext, useCallback, useContext, useMemo, useRef, useState, useEffect } from 'react';
-import { ToastApi, ToastInstance, ToastOptions } from './types';
-
-function normalizeProgress(value: number | undefined): number | undefined {
-  if (typeof value !== 'number' || Number.isNaN(value)) return undefined;
-  // Accept 0..1 as fraction or 0..100 as percent
-  if (value <= 1) return Math.max(0, Math.min(1, value)) * 100;
-  return Math.max(0, Math.min(100, value));
-}
-
-function generateId() {
-  return `toast_${Math.random().toString(36).slice(2, 9)}`;
-}
-
-type DefaultOpts = Required<Pick<ToastOptions, 'alertType' | 'title' | 'isPersistentPopup' | 'location' | 'durationMs'>> &
-  Partial<Omit<ToastOptions, 'id' | 'alertType' | 'title' | 'isPersistentPopup' | 'location' | 'durationMs'>>;
-
-const defaultOptions: DefaultOpts = {
-  alertType: 'neutral',
-  title: '',
-  isPersistentPopup: false,
-  location: 'bottom-right',
-  durationMs: 6000,
-};
-
-interface ToastContextShape extends ToastApi {
-  toasts: ToastInstance[];
-}
-
-const ToastContext = createContext<ToastContextShape | null>(null);
-
-export function useToast() {
-  const ctx = useContext(ToastContext);
-  if (!ctx) throw new Error('useToast must be used within ToastProvider');
-  return ctx;
-}
-
-export function ToastProvider({ children }: { children: React.ReactNode }) {
-  const [toasts, setToasts] = useState<ToastInstance[]>([]);
-  const timers = useRef<Record<string, number>>({});
-
-  const scheduleAutoDismiss = useCallback((toast: ToastInstance) => {
-    if (toast.isPersistentPopup) return;
-    window.clearTimeout(timers.current[toast.id]);
-    timers.current[toast.id] = window.setTimeout(() => {
-      setToasts(prev => prev.filter(t => t.id !== toast.id));
-    }, toast.durationMs);
-  }, []);
-
-  const show = useCallback<ToastApi['show']>((options) => {
-    const id = options.id || generateId();
-    const hasButton = !!(options.buttonText && options.buttonCallback);
-    const merged: ToastInstance = {
-      ...defaultOptions,
-      ...options,
-      id,
-      progress: normalizeProgress(options.progressBarPercentage),
-      justCompleted: false,
-      expandable: hasButton ? false : (options.expandable !== false),
-      isExpanded: hasButton ? true : (options.expandable === false ? true : (options.alertType === 'error' ? true : false)),
-      createdAt: Date.now(),
-    } as ToastInstance;
-    setToasts(prev => {
-      // Coalesce duplicates by alertType + title + body text if no explicit id was provided
-      if (!options.id) {
-        const bodyText = typeof merged.body === 'string' ? merged.body : '';
-        const existingIndex = prev.findIndex(t => t.alertType === merged.alertType && t.title === merged.title && (typeof t.body === 'string' ? t.body : '') === bodyText);
-        if (existingIndex !== -1) {
-          const updated = [...prev];
-          const existing = updated[existingIndex];
-          const nextCount = (existing.count ?? 1) + 1;
-          updated[existingIndex] = { ...existing, count: nextCount, createdAt: Date.now() };
-          return updated;
-        }
-      }
-      const next = [...prev.filter(t => t.id !== id), merged];
-      return next;
-    });
-    scheduleAutoDismiss(merged);
-    return id;
-  }, [scheduleAutoDismiss]);
-
-  const update = useCallback<ToastApi['update']>((id, updates) => {
-    setToasts(prev => prev.map(t => {
-      if (t.id !== id) return t;
-      const progress = updates.progressBarPercentage !== undefined
-        ? normalizeProgress(updates.progressBarPercentage)
-        : t.progress;
-
-      const next: ToastInstance = {
-        ...t,
-        ...updates,
-        progress,
-      } as ToastInstance;
-
-      // Detect completion
-      if (typeof progress === 'number' && progress >= 100 && !t.justCompleted) {
-        // On completion: finalize type as success unless explicitly provided otherwise
-        next.justCompleted = false;
-        if (!updates.alertType) {
-          next.alertType = 'success';
-        }
-      }
-
-      return next;
-    }));
-  }, []);
-
-  const updateProgress = useCallback<ToastApi['updateProgress']>((id, progress) => {
-    update(id, { progressBarPercentage: progress });
-  }, [update]);
-
-  const dismiss = useCallback<ToastApi['dismiss']>((id) => {
-    setToasts(prev => prev.filter(t => t.id !== id));
-    window.clearTimeout(timers.current[id]);
-    delete timers.current[id];
-  }, []);
-
-  const dismissAll = useCallback<ToastApi['dismissAll']>(() => {
-    setToasts([]);
-    Object.values(timers.current).forEach(t => window.clearTimeout(t));
-    timers.current = {};
-  }, []);
-
-  const value = useMemo<ToastContextShape>(() => ({
-    toasts,
-    show,
-    update,
-    updateProgress,
-    dismiss,
-    dismissAll,
-  }), [toasts, show, update, updateProgress, dismiss, dismissAll]);
-
-  // Handle expand/collapse toggles from renderer without widening API
-  useEffect(() => {
-    const handler = (e: Event) => {
-      const detail = (e as CustomEvent).detail as { id: string } | undefined;
-      if (!detail?.id) return;
-      setToasts(prev => prev.map(t => t.id === detail.id ? { ...t, isExpanded: !t.isExpanded } : t));
-    };
-    window.addEventListener('toast:toggle', handler as EventListener);
-    return () => window.removeEventListener('toast:toggle', handler as EventListener);
-  }, []);
-
-  return (
-    <ToastContext.Provider value={value}>{children}</ToastContext.Provider>
-  );
-}
-
-
@@ -1,209 +0,0 @@
-/* Toast Container Styles */
-.toast-container {
-  position: fixed;
-  z-index: 1200;
-  display: flex;
-  gap: 12px;
-  pointer-events: none;
-}
-
-.toast-container--top-left {
-  top: 16px;
-  left: 16px;
-  flex-direction: column;
-}
-
-.toast-container--top-right {
-  top: 16px;
-  right: 16px;
-  flex-direction: column;
-}
-
-.toast-container--bottom-left {
-  bottom: 16px;
-  left: 16px;
-  flex-direction: column-reverse;
-}
-
-.toast-container--bottom-right {
-  bottom: 16px;
-  right: 16px;
-  flex-direction: column-reverse;
-}
-
-/* Toast Item Styles */
-.toast-item {
-  min-width: 320px;
-  max-width: 560px;
-  box-shadow: var(--shadow-lg);
-  border-radius: 16px;
-  padding: 16px;
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-  pointer-events: auto;
-}
-
-/* Toast Alert Type Colors */
-.toast-item--success {
-  background: var(--color-green-100);
-  color: var(--text-primary);
-  border: 1px solid var(--color-green-400);
-}
-
-.toast-item--error {
-  background: var(--color-red-100);
-  color: var(--text-primary);
-  border: 1px solid var(--color-red-400);
-}
-
-.toast-item--warning {
-  background: var(--color-yellow-100);
-  color: var(--text-primary);
-  border: 1px solid var(--color-yellow-400);
-}
-
-.toast-item--neutral {
-  background: var(--bg-surface);
-  color: var(--text-primary);
-  border: 1px solid var(--border-default);
-}
-
-/* Toast Header Row */
-.toast-header {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-}
-
-.toast-icon {
-  width: 24px;
-  height: 24px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-
-.toast-title-container {
-  font-weight: 700;
-  flex: 1;
-  display: flex;
-  align-items: center;
-  gap: 8px;
-}
-
-.toast-count-badge {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  min-width: 20px;
-  height: 20px;
-  padding: 0 6px;
-  border-radius: 999px;
-  background: rgba(0, 0, 0, 0.08);
-  color: inherit;
-  font-size: 12px;
-  font-weight: 700;
-}
-
-.toast-controls {
-  display: flex;
-  gap: 4px;
-  align-items: center;
-}
-
-.toast-button {
-  width: 28px;
-  height: 28px;
-  border-radius: 999px;
-  border: none;
-  background: transparent;
-  color: var(--text-secondary);
-  cursor: pointer;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-
-.toast-expand-button {
-  transform: rotate(0deg);
-  transition: transform 160ms ease;
-}
-
-.toast-expand-button--expanded {
-  transform: rotate(180deg);
-}
-
-/* Progress Bar */
-.toast-progress-container {
-  margin-top: 8px;
-  height: 6px;
-  background: var(--bg-muted);
-  border-radius: 999px;
-  overflow: hidden;
-}
-
-.toast-progress-bar {
-  height: 100%;
-  transition: width 160ms ease;
-}
-
-.toast-progress-bar--success {
-  background: var(--color-green-500);
-}
-
-.toast-progress-bar--error {
-  background: var(--color-red-500);
-}
-
-.toast-progress-bar--warning {
-  background: var(--color-yellow-500);
-}
-
-.toast-progress-bar--neutral {
-  background: var(--color-gray-500);
-}
-
-/* Toast Body */
-.toast-body {
-  font-size: 14px;
-  opacity: 0.9;
-  margin-top: 8px;
-}
-
-/* Toast Action Button */
-.toast-action-container {
-  margin-top: 12px;
-  display: flex;
-  justify-content: flex-start;
-}
-
-.toast-action-button {
-  padding: 8px 12px;
-  border-radius: 12px;
-  border: 1px solid;
-  background: transparent;
-  font-weight: 600;
-  cursor: pointer;
-  margin-left: auto;
-}
-
-.toast-action-button--success {
-  color: var(--text-primary);
-  border-color: var(--color-green-400);
-}
-
-.toast-action-button--error {
-  color: var(--text-primary);
-  border-color: var(--color-red-400);
-}
-
-.toast-action-button--warning {
-  color: var(--text-primary);
-  border-color: var(--color-yellow-400);
-}
-
-.toast-action-button--neutral {
-  color: var(--text-primary);
-  border-color: var(--border-default);
-}
@@ -1,138 +0,0 @@
-import React from 'react';
-import { useToast } from './ToastContext';
-import { ToastInstance, ToastLocation } from './types';
-import { LocalIcon } from '../shared/LocalIcon';
-import './ToastRenderer.css';
-
-const locationToClass: Record<ToastLocation, string> = {
-  'top-left': 'toast-container--top-left',
-  'top-right': 'toast-container--top-right',
-  'bottom-left': 'toast-container--bottom-left',
-  'bottom-right': 'toast-container--bottom-right',
-};
-
-function getToastItemClass(t: ToastInstance): string {
-  return `toast-item toast-item--${t.alertType}`;
-}
-
-function getProgressBarClass(t: ToastInstance): string {
-  return `toast-progress-bar toast-progress-bar--${t.alertType}`;
-}
-
-function getActionButtonClass(t: ToastInstance): string {
-  return `toast-action-button toast-action-button--${t.alertType}`;
-}
-
-function getDefaultIconName(t: ToastInstance): string {
-  switch (t.alertType) {
-    case 'success':
-      return 'check-circle-rounded';
-    case 'error':
-      return 'close-rounded';
-    case 'warning':
-      return 'warning-rounded';
-    case 'neutral':
-    default:
-      return 'info-rounded';
-  }
-}
-
-export default function ToastRenderer() {
-  const { toasts, dismiss } = useToast();
-
-  const grouped = toasts.reduce<Record<ToastLocation, ToastInstance[]>>((acc, t) => {
-    const key = t.location;
-    if (!acc[key]) acc[key] = [] as ToastInstance[];
-    acc[key].push(t);
-    return acc;
-  }, { 'top-left': [], 'top-right': [], 'bottom-left': [], 'bottom-right': [] });
-
-  return (
-    <>
-      {(Object.keys(grouped) as ToastLocation[]).map((loc) => (
-        <div key={loc} className={`toast-container ${locationToClass[loc]}`}>
-          {grouped[loc].map(t => {
-            return (
-              <div
-                key={t.id}
-                role="status"
-                className={getToastItemClass(t)}
-              >
-                {/* Top row: Icon + Title + Controls */}
-                <div className="toast-header">
-                  {/* Icon */}
-                  <div className="toast-icon">
-                    {t.icon ?? (
-                      <LocalIcon icon={`material-symbols:${getDefaultIconName(t)}`} width={20} height={20} />
-                    )}
-                  </div>
-                  
-                  {/* Title + count badge */}
-                  <div className="toast-title-container">
-                    <span>{t.title}</span>
-                    {typeof t.count === 'number' && t.count > 1 && (
-                      <span className="toast-count-badge">{t.count}</span>
-                    )}
-                  </div>
-                  
-                  {/* Controls */}
-                  <div className="toast-controls">
-                    {t.expandable && (
-                      <button
-                        aria-label="Toggle details"
-                        onClick={() => {
-                          const evt = new CustomEvent('toast:toggle', { detail: { id: t.id } });
-                          window.dispatchEvent(evt);
-                        }}
-                        className={`toast-button toast-expand-button ${t.isExpanded ? 'toast-expand-button--expanded' : ''}`}
-                      >
-                        <LocalIcon icon="material-symbols:expand-more-rounded" />
-                      </button>
-                    )}
-                    <button
-                      aria-label="Dismiss"
-                      onClick={() => dismiss(t.id)}
-                      className="toast-button"
-                    >
-                      <LocalIcon icon="material-symbols:close-rounded" width={20} height={20} />
-                    </button>
-                  </div>
-                </div>
-                {/* Progress bar - always show when present */}
-                {typeof t.progress === 'number' && (
-                  <div className="toast-progress-container">
-                    <div 
-                      className={getProgressBarClass(t)}
-                      style={{ width: `${t.progress}%` }}
-                    />
-                  </div>
-                )}
-                
-                {/* Body content - only show when expanded */}
-                {(t.isExpanded || !t.expandable) && (
-                  <div className="toast-body">
-                    {t.body}
-                  </div>
-                )}
-                
-                {/* Button - always show when present, positioned below body */}
-                {t.buttonText && t.buttonCallback && (
-                  <div className="toast-action-container">
-                    <button
-                      onClick={t.buttonCallback}
-                      className={getActionButtonClass(t)}
-                    >
-                      {t.buttonText}
-                    </button>
-                  </div>
-                )}
-              </div>
-            );
-          })}
-        </div>
-      ))}
-    </>
-  );
-}
-
-
@@ -1,61 +0,0 @@
-import { ToastOptions } from './types';
-import { useToast, ToastProvider } from './ToastContext';
-import ToastRenderer from './ToastRenderer';
-
-export { useToast, ToastProvider, ToastRenderer };
-
-// Global imperative API via module singleton
-let _api: ReturnType<typeof createImperativeApi> | null = null;
-
-function createImperativeApi() {
-  const subscribers: Array<(fn: any) => void> = [];
-  let api: any = null;
-  return {
-    provide(instance: any) {
-      api = instance;
-      subscribers.splice(0).forEach(cb => cb(api));
-    },
-    get(): any | null { return api; },
-    onReady(cb: (api: any) => void) {
-      if (api) cb(api); else subscribers.push(cb);
-    }
-  };
-}
-
-if (!_api) _api = createImperativeApi();
-
-// Hook helper to wire context API back to singleton
-export function ToastPortalBinder() {
-  const ctx = useToast();
-  // Provide API once mounted
-  _api!.provide(ctx);
-  return null;
-}
-
-export function alert(options: ToastOptions) {
-  if (_api?.get()) {
-    return _api.get()!.show(options);
-  }
-  // Queue until provider mounts
-  let id = '';
-  _api?.onReady((api) => { id = api.show(options); });
-  return id;
-}
-
-export function updateToast(id: string, options: Partial<ToastOptions>) {
-  _api?.get()?.update(id, options);
-}
-
-export function updateToastProgress(id: string, progress: number) {
-  _api?.get()?.updateProgress(id, progress);
-}
-
-export function dismissToast(id: string) {
-  _api?.get()?.dismiss(id);
-}
-
-export function dismissAllToasts() {
-  _api?.get()?.dismissAll();
-}
-
-
@@ -1,50 +0,0 @@
-import { ReactNode } from 'react';
-
-export type ToastLocation = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-export type ToastAlertType = 'success' | 'error' | 'warning' | 'neutral';
-
-export interface ToastOptions {
-  alertType?: ToastAlertType;
-  title: string;
-  body?: ReactNode;
-  buttonText?: string;
-  buttonCallback?: () => void;
-  isPersistentPopup?: boolean;
-  location?: ToastLocation;
-  icon?: ReactNode;
-  /** number 0-1 as fraction or 0-100 as percent */
-  progressBarPercentage?: number;
-  /** milliseconds to auto-close if not persistent */
-  durationMs?: number;
-  /** optional id to control/update later */
-  id?: string;
-  /** If true, show chevron and collapse/expand animation. Defaults to true. */
-  expandable?: boolean;
-}
-
-export interface ToastInstance extends Omit<ToastOptions, 'id' | 'progressBarPercentage'> {
-  id: string;
-  alertType: ToastAlertType;
-  isPersistentPopup: boolean;
-  location: ToastLocation;
-  durationMs: number;
-  expandable: boolean;
-  isExpanded: boolean;
-  /** Number of coalesced duplicates */
-  count?: number;
-  /** internal progress normalized 0..100 */
-  progress?: number;
-  /** if progress completed, briefly show check icon */
-  justCompleted: boolean;
-  createdAt: number;
-}
-
-export interface ToastApi {
-  show: (options: ToastOptions) => string;
-  update: (id: string, options: Partial<ToastOptions>) => void;
-  updateProgress: (id: string, progress: number) => void;
-  dismiss: (id: string) => void;
-  dismissAll: () => void;
-}
-
-
@@ -9,22 +9,13 @@ import NoToolsFound from './shared/NoToolsFound';
 import "./toolPicker/ToolPicker.css";

 interface SearchResultsProps {
-  filteredTools: Array<{ item: [string, ToolRegistryEntry]; matchedText?: string }>;
+  filteredTools: [string, ToolRegistryEntry][];
  onSelect: (id: string) => void;
-  searchQuery?: string;
 }

-const SearchResults: React.FC<SearchResultsProps> = ({ filteredTools, onSelect, searchQuery }) => {
+const SearchResults: React.FC<SearchResultsProps> = ({ filteredTools, onSelect }) => {
  const { t } = useTranslation();
-  const { searchGroups } = useToolSections(filteredTools, searchQuery);
-
-  // Create a map of matched text for quick lookup
-  const matchedTextMap = new Map<string, string>();
-  if (filteredTools && Array.isArray(filteredTools)) {
-    filteredTools.forEach(({ item: [id], matchedText }) => {
-      if (matchedText) matchedTextMap.set(id, matchedText);
-    });
-  }
+  const { searchGroups } = useToolSections(filteredTools);

  if (searchGroups.length === 0) {
    return <NoToolsFound />;
@@ -37,27 +28,15 @@ const SearchResults: React.FC<SearchResultsProps> = ({ filteredTools, onSelect,
        <Box key={group.subcategoryId}  w="100%">
          <SubcategoryHeader label={getSubcategoryLabel(t, group.subcategoryId)} />
          <Stack  gap="xs">
-            {group.tools.map(({ id, tool }) => {
-              const matchedText = matchedTextMap.get(id);
-              // Check if the match was from synonyms and show the actual synonym that matched
-              const isSynonymMatch = matchedText && tool.synonyms?.some(synonym => 
-                matchedText.toLowerCase().includes(synonym.toLowerCase())
-              );
-              const matchedSynonym = isSynonymMatch ? tool.synonyms?.find(synonym => 
-                matchedText.toLowerCase().includes(synonym.toLowerCase())
-              ) : undefined;
-              
-              return (
-                <ToolButton
-                  key={id}
-                  id={id}
-                  tool={tool}
-                  isSelected={false}
-                  onSelect={onSelect}
-                  matchedSynonym={matchedSynonym}
-                />
-              );
-            })}
+            {group.tools.map(({ id, tool }) => (
+              <ToolButton
+                key={id}
+                id={id}
+                tool={tool}
+                isSelected={false}
+                onSelect={onSelect}
+              />
+            ))}
          </Stack>
        </Box>
      ))}
@@ -72,7 +72,6 @@ export default function ToolPanel() {
              <SearchResults
                filteredTools={filteredTools}
                onSelect={handleToolSelect}
-                searchQuery={searchQuery}
              />
          </div>
        ) : leftPanelView === 'toolPicker' ? (
@@ -10,7 +10,7 @@ import { renderToolButtons } from "./shared/renderToolButtons";
 interface ToolPickerProps {
  selectedToolKey: string | null;
  onSelect: (id: string) => void;
-  filteredTools: Array<{ item: [string, ToolRegistryEntry]; matchedText?: string }>;
+  filteredTools: [string, ToolRegistryEntry][];
  isSearching?: boolean;
 }

@@ -1,5 +1,5 @@
 import React, { Suspense } from "react";
-import { useToolWorkflow } from "../../contexts/ToolWorkflowContext";
+import { useToolManagement } from "../../hooks/useToolManagement";
 import { BaseToolProps } from "../../types/tool";
 import ToolLoadingFallback from "./ToolLoadingFallback";

@@ -14,8 +14,8 @@ const ToolRenderer = ({
  onComplete,
  onError,
 }: ToolRendererProps) => {
-  // Get the tool from context (instead of direct hook call)
-  const { toolRegistry } = useToolWorkflow();
+  // Get the tool from registry
+  const { toolRegistry } = useToolManagement();
  const selectedTool = toolRegistry[selectedToolKey];

  if (!selectedTool || !selectedTool.component) {
@@ -1,195 +0,0 @@
-/* StampPreview.module.css */
-
-/* Container styles */
-.container {
-  position: relative;
-  width: 100%;
-  overflow: hidden;
-}
-
-.containerWithThumbnail {
-  background-color: transparent;
-}
-
-.containerWithoutThumbnail {
-  background-color: rgba(255, 255, 255, 0.03);
-}
-
-.containerBorder {
-  border: 1px solid var(--border-default, #333);
-}
-
-/* Page thumbnail styles */
-.pageThumbnail {
-  position: absolute;
-  inset: 0;
-  width: 100%;
-  height: 100%;
-  object-fit: contain;
-  filter: grayscale(10%) contrast(95%) brightness(105%);
-}
-
-/* Stamp item styles */
-.stampItem {
-  position: absolute;
-  display: flex;
-  flex-direction: column;
-  justify-content: flex-start;
-  line-height: 1;
-  transform-origin: left bottom;
-}
-
-.stampItemDraggable {
-  cursor: move;
-  pointer-events: auto;
-}
-
-.stampItemGridMode {
-  cursor: default;
-  pointer-events: none;
-}
-
-/* Text stamp styles */
-.textLine {
-  white-space: pre;
-  display: block;
-  word-break: keep-all;
-  overflow: visible;
-}
-
-/* Image stamp styles */
-.stampImage {
-  position: absolute;
-  left: 0;
-  bottom: 0;
-  width: 100%;
-  height: 100%;
-  object-fit: contain;
-}
-
-/* Quick grid overlay styles */
-.quickGrid {
-  position: absolute;
-  inset: 0;
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  grid-template-rows: repeat(3, 1fr);
-  gap: 8px;
-  padding: 8px;
-  pointer-events: auto;
-}
-
-.gridTile {
-  border: 1px dashed rgba(0, 0, 0, 0.15);
-  background-color: transparent;
-  color: transparent;
-  border-radius: 10px;
-  cursor: pointer;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-size: 14px;
-  user-select: none;
-}
-
-.gridTileSelected,
-.gridTileHovered {
-  border: 2px solid var(--mantine-primary-color-filled, #3b82f6);
-}
-
-/* Preview header */
-.previewHeader {
-  margin-bottom: 12px;
-}
-
-.divider {
-  height: 1px;
-  background-color: var(--border-default, #333);
-  margin-bottom: 8px;
-}
-
-.previewLabel {
-  font-size: 14px;
-  font-weight: 500;
-  color: var(--text-primary);
-  text-align: center;
-}
-
-/* Preview disclaimer */
-.previewDisclaimer {
-  margin-top: 8px;
-  opacity: 0.7;
-  font-size: 12px;
-}
-
-/* AddStamp.tsx specific styles */
-
-/* Information text container */
-.informationContainer {
-  background-color: var(--information-text-bg);
-  padding: 2px;
-  padding-left: 8px;
-  padding-right: 8px;
-  border-radius: 10px;
-  margin-top: 8px;
-  margin-bottom: 8px;
-  width: 100%;
-  align-items: center;
-  justify-content: center;
-  text-align: center;
-}
-
-.informationText {
-  font-size: 0.75rem;
-  font-weight: 400;
-  color: var(--information-text-color);
-}
-
-/* Mode toggle buttons */
-.modeToggleGroup {
-  gap: 0.25rem;
-  flex-grow: 1;
-}
-
-.modeToggleButton {
-  border-radius: 0.125rem;
-  font-size: 0.75rem;
-  width: 100%;
-}
-
-/* Icon pill buttons */
-.iconPillGroup {
-  gap: 0.25rem;
-  flex-grow: 1;
-}
-
-.iconPillButton {
-  border-radius: 0.125rem;
-  font-size: 0.75rem;
-  width: 100%;
-}
-
-/* Slider controls */
-.sliderGroup {
-  gap: 1rem;
-  align-items: center;
-}
-
-.numberInput {
-  width: 80px;
-  font-size: 0.875rem;
-}
-
-.slider {
-  flex: 1;
-}
-
-.sliderWide {
-  flex: 1.2;
-}
-
-/* Label text */
-.labelText {
-  font-size: 0.875rem;
-  font-weight: 500;
-}
@@ -1,343 +0,0 @@
-import React, { useEffect, useMemo, useRef, useState } from 'react';
-import { AddStampParameters } from './useAddStampParameters';
-import { pdfWorkerManager } from '../../../services/pdfWorkerManager';
-import { useThumbnailGeneration } from '../../../hooks/useThumbnailGeneration';
-import { A4_ASPECT_RATIO, getFirstSelectedPage, getFontFamily, computeStampPreviewStyle, getAlphabetPreviewScale } from './StampPreviewUtils';
-import styles from './StampPreview.module.css';
-
-type Props = {
-  parameters: AddStampParameters;
-  onParameterChange: <K extends keyof AddStampParameters>(key: K, value: AddStampParameters[K]) => void;
-  file?: File | null;
-  showQuickGrid?: boolean;
-};
-
-export default function StampPreview({ parameters, onParameterChange, file, showQuickGrid }: Props) {
-  const containerRef = useRef<HTMLDivElement>(null);
-  const [containerSize, setContainerSize] = useState<{ width: number; height: number }>({ width: 0, height: 0 });
-  const [imageMeta, setImageMeta] = useState<{ url: string; width: number; height: number } | null>(null);
-  const [pageSize, setPageSize] = useState<{ widthPts: number; heightPts: number } | null>(null);
-  const [pageThumbnail, setPageThumbnail] = useState<string | null>(null);
-  const { requestThumbnail } = useThumbnailGeneration();
-  const [hoverTile, setHoverTile] = useState<number | null>(null);
-
-  // Load image URL and meta for aspect ratio if an image is selected
-  useEffect(() => {
-    if (parameters.stampType === 'image' && parameters.stampImage) {
-      const url = URL.createObjectURL(parameters.stampImage);
-      const img = new Image();
-      img.onload = () => {
-        setImageMeta({ url, width: img.width, height: img.height });
-      };
-      img.src = url;
-      return () => URL.revokeObjectURL(url);
-    } else {
-      setImageMeta(null);
-    }
-  }, [parameters.stampType, parameters.stampImage]);
-
-  // Observe container size for responsive positioning
-  useEffect(() => {
-    const node = containerRef.current;
-    if (!node) return;
-    const resize = () => {
-      const aspect = pageSize ? (pageSize.widthPts / pageSize.heightPts) : A4_ASPECT_RATIO;
-      setContainerSize({ width: node.clientWidth, height: node.clientWidth / aspect });
-    };
-    resize();
-    const ro = new ResizeObserver(resize);
-    ro.observe(node);
-    return () => ro.disconnect();
-  }, [pageSize]);
-
-  // Load first PDF page size in points for accurate scaling
-  useEffect(() => {
-    let cancelled = false;
-    const load = async () => {
-      if (!file || file.type !== 'application/pdf') {
-        setPageSize(null);
-        return;
-      }
-      try {
-        const buffer = await file.arrayBuffer();
-        const pdf = await pdfWorkerManager.createDocument(buffer, { disableAutoFetch: true, disableStream: true });
-        const page = await pdf.getPage(1);
-        const viewport = page.getViewport({ scale: 1 });
-        if (!cancelled) {
-          setPageSize({ widthPts: viewport.width, heightPts: viewport.height });
-        }
-        pdfWorkerManager.destroyDocument(pdf);
-      } catch {
-        // Fallback to A4 if we cannot read page
-        if (!cancelled) setPageSize(null);
-      }
-    };
-    load();
-    return () => { cancelled = true; };
-  }, [file]);
-
-  // Load first-page thumbnail for background preview so users see the content
-  useEffect(() => {
-    let isActive = true;
-    const loadThumb = async () => {
-      if (!file || file.type !== 'application/pdf') {
-        setPageThumbnail(null);
-        return;
-      }
-      try {
-        const pageNumber = Math.max(1, getFirstSelectedPage(parameters.pageNumbers));
-        const pageId = `${file.name}:${file.size}:${file.lastModified}:page:${pageNumber}`;
-        const thumb = await requestThumbnail(pageId, file, pageNumber);
-        if (isActive) setPageThumbnail(thumb || null);
-      } catch {
-        if (isActive) setPageThumbnail(null);
-      }
-    };
-    loadThumb();
-    return () => { isActive = false; };
-  }, [file, parameters.pageNumbers, requestThumbnail]);
-
-  const style = useMemo(() => (
-    computeStampPreviewStyle(
-      parameters,
-      imageMeta,
-      pageSize,
-      containerSize,
-      showQuickGrid,
-      hoverTile,
-      !!pageThumbnail
-    )
-  ), [containerSize, parameters, imageMeta, pageSize, showQuickGrid, hoverTile, pageThumbnail]);
-
-  // Keep center fixed when scaling via slider (or any fontSize changes)
-  const prevDimsRef = useRef<{ fontSize: number; widthPx: number; heightPx: number; leftPx: number; bottomPx: number } | null>(null);
-  useEffect(() => {
-    const itemStyle = style.item as any;
-    if (!itemStyle || containerSize.width <= 0 || containerSize.height <= 0) return;
-
-    const parse = (v: any) => parseFloat(String(v).replace('px', '')) || 0;
-    const leftPx = parse(itemStyle.left);
-    const bottomPx = parse(itemStyle.bottom);
-    const widthPx = parse(itemStyle.width);
-    const heightPx = parse(itemStyle.height);
-
-    const prev = prevDimsRef.current;
-    const hasOverrides = parameters.overrideX >= 0 && parameters.overrideY >= 0;
-    const canAdjust = hasOverrides && !showQuickGrid;
-    if (
-      prev &&
-      canAdjust &&
-      parameters.fontSize !== prev.fontSize &&
-      prev.widthPx > 0 &&
-      prev.heightPx > 0 &&
-      widthPx > 0 &&
-      heightPx > 0
-    ) {
-      const centerX = prev.leftPx + prev.widthPx / 2;
-      const centerY = prev.bottomPx + prev.heightPx / 2;
-      const newLeftPx = centerX - widthPx / 2;
-      const newBottomPx = centerY - heightPx / 2;
-
-      const widthPts = pageSize?.widthPts ?? 595.28;
-      const heightPts = pageSize?.heightPts ?? 841.89;
-      const scaleX = containerSize.width / widthPts;
-      const scaleY = containerSize.height / heightPts;
-      const newLeftPts = Math.max(0, Math.min(containerSize.width, newLeftPx)) / scaleX;
-      const newBottomPts = Math.max(0, Math.min(containerSize.height, newBottomPx)) / scaleY;
-      onParameterChange('overrideX', newLeftPts as any);
-      onParameterChange('overrideY', newBottomPts as any);
-    }
-
-    prevDimsRef.current = { fontSize: parameters.fontSize, widthPx, heightPx, leftPx, bottomPx };
-  }, [parameters.fontSize, style.item, containerSize, pageSize, showQuickGrid, parameters.overrideX, parameters.overrideY, onParameterChange]);
-
-  // Drag/resize/rotate interactions
-  const draggingRef = useRef<{ type: 'move' | 'resize' | 'rotate'; startX: number; startY: number; initLeft: number; initBottom: number; initHeight: number; centerX: number; centerY: number } | null>(null);
-
-  const ensureOverrides = () => {
-    const pageWidth = containerSize.width;
-    const pageHeight = containerSize.height;
-    if (pageWidth <= 0 || pageHeight <= 0) return;
-
-    // Recompute current x,y from style (so that we start from visual position)
-    const itemStyle = style.item as any;
-    const leftPx = parseFloat(String(itemStyle.left).replace('px', '')) || 0;
-    const bottomPx = parseFloat(String(itemStyle.bottom).replace('px', '')) || 0;
-    const widthPts = pageSize?.widthPts ?? 595.28;
-    const heightPts = pageSize?.heightPts ?? 841.89;
-    const scaleX = containerSize.width / widthPts;
-    const scaleY = containerSize.height / heightPts;
-    if (parameters.overrideX < 0 || parameters.overrideY < 0) {
-      onParameterChange('overrideX', Math.max(0, Math.min(pageWidth, leftPx)) / scaleX as any);
-      onParameterChange('overrideY', Math.max(0, Math.min(pageHeight, bottomPx)) / scaleY as any);
-    }
-  };
-
-  const handlePointerDown = (e: React.PointerEvent, type: 'move' | 'resize' | 'rotate') => {
-    e.preventDefault();
-    ensureOverrides();
-
-    const item = style.item as any;
-    const left = parseFloat(String(item.left).replace('px', '')) || 0;
-    const bottom = parseFloat(String(item.bottom).replace('px', '')) || 0;
-    const width = parseFloat(String(item.width).replace('px', '')) || parameters.fontSize;
-    const height = parseFloat(String(item.height).replace('px', '')) || parameters.fontSize;
-
-    const rect = (e.currentTarget.parentElement as HTMLElement)?.getBoundingClientRect();
-    const centerX = left + width / 2;
-    const centerY = bottom + height / 2;
-
-    draggingRef.current = {
-      type,
-      startX: e.clientX - (rect?.left || 0),
-      startY: (rect ? rect.bottom - e.clientY : 0), // convert to bottom-based coords
-      initLeft: left,
-      initBottom: bottom,
-      initHeight: height,
-      centerX,
-      centerY,
-    };
-
-    (e.currentTarget as HTMLElement).setPointerCapture(e.pointerId);
-  };
-
-  const handlePointerMove = (e: React.PointerEvent) => {
-    if (!draggingRef.current) return;
-    const node = containerRef.current;
-    if (!node) return;
-    const rect = node.getBoundingClientRect();
-    const x = e.clientX - rect.left;
-    const y = rect.bottom - e.clientY; // bottom-based
-
-    const drag = draggingRef.current;
-
-    if (drag.type === 'move') {
-      const dx = x - drag.startX;
-      const dy = y - drag.startY;
-      const newLeftPx = Math.max(0, Math.min(containerSize.width, drag.initLeft + dx));
-      const newBottomPx = Math.max(0, Math.min(containerSize.height, drag.initBottom + dy));
-      const widthPts = pageSize?.widthPts ?? 595.28;
-      const heightPts = pageSize?.heightPts ?? 841.89;
-      const scaleX = containerSize.width / widthPts;
-      const scaleY = containerSize.height / heightPts;
-      const newLeftPts = newLeftPx / scaleX;
-      const newBottomPts = newBottomPx / scaleY;
-      onParameterChange('overrideX', newLeftPts as any);
-      onParameterChange('overrideY', newBottomPts as any);
-    }
-
-    if (drag.type === 'resize') {
-      // Height is our canonical size (fontSize)
-      const heightPts = pageSize?.heightPts ?? 841.89;
-      const scaleY = containerSize.height / heightPts;
-      const newHeightPx = Math.max(1, drag.initHeight + (y - drag.startY));
-      const newHeightPts = newHeightPx / scaleY;
-      onParameterChange('fontSize', newHeightPts as any);
-    }
-
-    if (drag.type === 'rotate') {
-      const angle = Math.atan2(y - drag.centerY, x - drag.centerX) * (180 / Math.PI);
-      onParameterChange('rotation', angle as any);
-    }
-  };
-
-  const handlePointerUp = (e: React.PointerEvent) => {
-    if (!draggingRef.current) return;
-    draggingRef.current = null;
-    (e.currentTarget as HTMLElement).releasePointerCapture(e.pointerId);
-  };
-
-  const itemHandles = null; // Drag-only per request
-
-  return (
-    <div>
-      <div className={styles.previewHeader}>
-        <div className={styles.divider} />
-        <div className={styles.previewLabel}>Preview Stamp</div>
-      </div>
-      <div 
-        ref={containerRef} 
-        className={`${styles.container} ${styles.containerBorder} ${pageThumbnail ? styles.containerWithThumbnail : styles.containerWithoutThumbnail}`}
-        style={style.container as React.CSSProperties} 
-        onPointerMove={handlePointerMove} 
-        onPointerUp={handlePointerUp}
-      >
-        {pageThumbnail && (
-          <img
-            src={pageThumbnail}
-            alt="page preview"
-            className={styles.pageThumbnail}
-            draggable={false}
-          />
-        )}
-        {parameters.stampType === 'text' && (
-          <div
-            className={`${styles.stampItem} ${styles.stampItemGridMode}`}
-            style={style.item as React.CSSProperties}
-          >
-            {(parameters.stampText || '').split('\n').map((line, idx) => (
-              <span
-                key={idx}
-                className={styles.textLine}
-                style={{
-                  fontFamily: getFontFamily(parameters.alphabet),
-                  fontSize: `${Math.max(1, (parameters.fontSize * getAlphabetPreviewScale(parameters.alphabet)) / 2)}px`,
-                  whiteSpace: 'nowrap',
-                }}
-              >
-                {line || '\u00A0'}
-              </span>
-            ))}
-            {itemHandles}
-          </div>
-        )}
-        {parameters.stampType === 'image' && imageMeta && (
-          <div
-            className={`${styles.stampItem} ${showQuickGrid ? styles.stampItemGridMode : styles.stampItemDraggable}`}
-            style={style.item as React.CSSProperties}
-            onPointerDown={(e) => handlePointerDown(e, 'move')}
-          >
-            <img
-              src={imageMeta.url}
-              alt="stamp preview"
-              className={styles.stampImage}
-            />
-            {itemHandles}
-          </div>
-        )}
-
-        {/* Quick position overlay grid */}
-        {showQuickGrid && (
-          <div className={styles.quickGrid}>
-            {Array.from({ length: 9 }).map((_, i) => {
-              const idx = (i + 1) as 1|2|3|4|5|6|7|8|9;
-              const selected = parameters.position === idx && (parameters.overrideX < 0 || parameters.overrideY < 0);
-              return (
-                <button
-                  key={idx}
-                  type="button"
-                  className={`${styles.gridTile} ${selected || hoverTile === idx ? styles.gridTileSelected : ''} ${hoverTile === idx ? styles.gridTileHovered : ''}`}
-                  onClick={() => {
-                    // Clear overrides to use grid positioning and set position
-                    onParameterChange('overrideX', -1 as any);
-                    onParameterChange('overrideY', -1 as any);
-                    onParameterChange('position', idx as any);
-                  }}
-                  onMouseEnter={() => setHoverTile(idx)}
-                  onMouseLeave={() => setHoverTile(null)}
-                >
-                  {idx}
-                </button>
-              );
-            })}
-          </div>
-        )}
-      </div>
-      <div className={styles.previewDisclaimer}>
-        Preview is approximate. Final output may vary due to PDF font metrics.
-      </div>
-    </div>
-  );
-}
-
-
@@ -1,235 +0,0 @@
-import type { AddStampParameters } from './useAddStampParameters';
-
-export type ContainerSize = { width: number; height: number };
-export type PageSizePts = { widthPts: number; heightPts: number } | null;
-export type ImageMeta = { url: string; width: number; height: number } | null;
-
-// Map UI margin option to backend margin factor
-export const marginFactorMap: Record<AddStampParameters['customMargin'], number> = {
-  'small': 0.02,
-  'medium': 0.035,
-  'large': 0.05,
-  'x-large': 0.075,
-};
-
-export const A4_ASPECT_RATIO = 0.707; // width/height used elsewhere in legacy UI
-
-// Get font family based on selected alphabet (matching backend logic)
-export const getFontFamily = (alphabet: string): string => {
-  switch (alphabet) {
-    case 'arabic':
-      return 'Noto Sans Arabic, Arial Unicode MS, sans-serif';
-    case 'japanese':
-      return 'Meiryo, Yu Gothic, Hiragino Sans, sans-serif';
-    case 'korean':
-      return 'Malgun Gothic, Dotum, sans-serif';
-    case 'chinese':
-      return 'SimSun, Microsoft YaHei, sans-serif';
-    case 'thai':
-      return 'Noto Sans Thai, Tahoma, sans-serif';
-    case 'roman':
-    default:
-      return 'Noto Sans, Arial, Helvetica, sans-serif';
-  }
-};
-
-// Lightweight parser: returns first page number from CSV/range input, otherwise 1
-export const getFirstSelectedPage = (input: string): number => {
-  if (!input) return 1;
-  const parts = input.split(',').map(s => s.trim()).filter(Boolean);
-  for (const part of parts) {
-    if (/^\d+\s*-\s*\d+$/.test(part)) {
-      const low = parseInt(part.split('-')[0].trim(), 10);
-      if (Number.isFinite(low) && low > 0) return low;
-    }
-    const n = parseInt(part, 10);
-    if (Number.isFinite(n) && n > 0) return n;
-  }
-  return 1;
-};
-
-export type StampPreviewStyle = { container: any; item: any };
-
-// Unified per-alphabet preview adjustments
-export type Alphabet = 'roman' | 'arabic' | 'japanese' | 'korean' | 'chinese' | 'thai';
-export type AlphabetTweaks = { scale: number; rowOffsetRem: [number, number, number]; lineHeight: number; capHeightRatio: number; defaultFontSize: number };
-export const ALPHABET_PREVIEW_TWEAKS: Record<Alphabet, AlphabetTweaks> = {
-  // [top, middle, bottom] row offsets in rem
-  roman: { scale: 1.0/1.18, rowOffsetRem: [0, 1, 2.2], lineHeight: 1.28, capHeightRatio: 0.70, defaultFontSize: 80 },
-  arabic: { scale: 1.2, rowOffsetRem: [0, 1.5, 2.5], lineHeight: 1, capHeightRatio: 0.68, defaultFontSize: 80 },
-  japanese: { scale: 1/1.2, rowOffsetRem: [-0.1, 1, 2], lineHeight: 1, capHeightRatio: 0.72, defaultFontSize: 80 },
-  korean: { scale: 1.0/1.05, rowOffsetRem: [-0.2, 0.5, 1.4], lineHeight: 1, capHeightRatio: 0.72, defaultFontSize: 80 },
-  chinese: { scale: 1/1.2, rowOffsetRem: [0, 2, 2.8], lineHeight: 1, capHeightRatio: 0.72, defaultFontSize: 30 }, // temporary default font size so that it fits on the PDF
-  thai: { scale: 1/1.2, rowOffsetRem: [-1, 0, .8], lineHeight: 1, capHeightRatio: 0.66, defaultFontSize: 80 },
-};
-export const getAlphabetPreviewScale = (alphabet: string): number => (ALPHABET_PREVIEW_TWEAKS as any)[alphabet]?.scale ?? 1.0;
-
-export const getDefaultFontSizeForAlphabet = (alphabet: string): number => {
-  return (ALPHABET_PREVIEW_TWEAKS as any)[alphabet]?.defaultFontSize ?? 80;
-};
-
-export function computeStampPreviewStyle(
-  parameters: AddStampParameters,
-  imageMeta: ImageMeta,
-  pageSize: PageSizePts,
-  containerSize: ContainerSize,
-  showQuickGrid: boolean | undefined,
-  _hoverTile: number | null,
-  hasPageThumbnail: boolean
-): StampPreviewStyle {
-  const pageWidthPx = containerSize.width;
-  const pageHeightPx = containerSize.height;
-  const widthPts = pageSize?.widthPts ?? 595.28; // A4 width at 72 DPI
-  const heightPts = pageSize?.heightPts ?? 841.89; // A4 height at 72 DPI
-  const scaleX = pageWidthPx / widthPts;
-  const scaleY = pageHeightPx / heightPts;
-  if (pageWidthPx <= 0 || pageHeightPx <= 0) return { item: {}, container: {} } as any;
-
-  const marginPts = (widthPts + heightPts) / 2 * (marginFactorMap[parameters.customMargin] ?? 0.035);
-
-  // Compute content dimensions
-  const heightPtsContent = parameters.fontSize * getAlphabetPreviewScale(parameters.alphabet);
-  let widthPtsContent = heightPtsContent;
-
-
-  if (parameters.stampType === 'image' && imageMeta) {
-    const aspect = imageMeta.width / imageMeta.height;
-    widthPtsContent = heightPtsContent * aspect;
-  } else if (parameters.stampType === 'text') {
-    // Use Canvas 2D to measure text width for better fidelity than DOM spans
-    const textLine = (parameters.stampText || '').split('\n')[0] ?? '';
-    const fontPx = heightPtsContent * scaleY; // Convert point size to px using vertical scale
-    const fontFamily = getFontFamily(parameters.alphabet);
-
-    const canvas = document.createElement('canvas');
-    const ctx = canvas.getContext('2d');
-    if (ctx) {
-      ctx.font = `${fontPx}px ${fontFamily}`;
-      const metrics = ctx.measureText(textLine);
-      const measuredWidthPx = metrics.width;
-      // Convert measured px width back to PDF points using horizontal scale
-      widthPtsContent = measuredWidthPx / scaleX;
-
-      let adjustmentFactor = 1.0;
-      switch (parameters.alphabet) {
-        case 'roman':
-          adjustmentFactor = 0.90;
-          break;
-        case 'arabic':
-        case 'thai':
-          adjustmentFactor = 0.92;
-          break;
-        case 'japanese':
-        case 'korean':
-        case 'chinese':
-          adjustmentFactor = 0.88;
-          break;
-        default:
-          adjustmentFactor = 0.93;
-      }
-      widthPtsContent *= adjustmentFactor;
-    }
-  }
-
-  // Positioning helpers - mirror backend logic
-  const position = parameters.position;
-  const calcX = () => {
-    if (parameters.overrideX >= 0 && parameters.overrideY >= 0) return parameters.overrideX;
-    switch (position % 3) {
-      case 1: // Left
-        return marginPts;
-      case 2: // Center
-        return (widthPts - widthPtsContent) / 2;
-      case 0: // Right
-        return widthPts - widthPtsContent - marginPts;
-      default:
-        return 0;
-    }
-  };
-  const calcY = () => {
-    if (parameters.overrideX >= 0 && parameters.overrideY >= 0) return parameters.overrideY;
-    // For text, backend positions using cap height, not full font size
-    const heightForY = parameters.stampType === 'text'
-      ? heightPtsContent * ((ALPHABET_PREVIEW_TWEAKS as any)[parameters.alphabet]?.capHeightRatio ?? 0.70)
-      : heightPtsContent;
-    switch (Math.floor((position - 1) / 3)) {
-      case 0: // Top
-        return heightPts - heightForY - marginPts;
-      case 1: // Middle
-        return (heightPts - heightForY) / 2;
-      case 2: // Bottom
-        return marginPts;
-      default:
-        return 0;
-    }
-  };
-
-  const xPts = calcX();
-  const yPts = calcY();
-  let xPx = xPts * scaleX;
-  let yPx = yPts * scaleY;
-  if (parameters.stampType === 'text') {
-    try {
-      const rootFontSizePx = parseFloat(getComputedStyle(document.documentElement).fontSize || '16') || 16;
-      const rowIndex = Math.floor((position - 1) / 3); // 0 top, 1 middle, 2 bottom
-      const offsets = (ALPHABET_PREVIEW_TWEAKS as any)[parameters.alphabet]?.rowOffsetRem ?? [0, 0, 0];
-      const offsetRem = offsets[rowIndex] ?? 0;
-      yPx += offsetRem * rootFontSizePx;
-    } catch (e) {
-      // no-op
-      console.error(e);
-    }
-  }
-  const widthPx = widthPtsContent * scaleX;
-  const heightPx = heightPtsContent * scaleY;
-
-  xPx = Math.max(0, Math.min(xPx, pageWidthPx - widthPx));
-  yPx = Math.max(0, Math.min(yPx, pageHeightPx - heightPx));
-
-  const opacity = Math.max(0, Math.min(1, parameters.opacity / 100));
-  const displayOpacity = opacity;
-
-  let alignItems: 'flex-start' | 'center' | 'flex-end' = 'flex-start';
-  if (parameters.stampType === 'text') {
-    const colIndex = position % 3; // 1: left, 2: center, 0: right
-    switch (colIndex) {
-      case 2: // center column
-        alignItems = 'center';
-        break;
-      case 0: // right column
-        alignItems = 'flex-end';
-        break;
-      default:
-        alignItems = 'flex-start';
-    }
-  }
-
-  return {
-    container: {
-      position: 'relative',
-      width: '100%',
-      aspectRatio: `${(pageSize?.widthPts ?? 595.28) / (pageSize?.heightPts ?? 841.89)} / 1`,
-      backgroundColor: hasPageThumbnail ? 'transparent' : 'rgba(255,255,255,0.03)',
-      border: '1px solid var(--border-default, #333)',
-      overflow: 'hidden'
-    },
-    item: {
-      position: 'absolute',
-      left: `${xPx}px`,
-      bottom: `${yPx}px`,
-      width: `${widthPx}px`,
-      height: `${heightPx}px`,
-      opacity: displayOpacity,
-      transform: `rotate(${-parameters.rotation}deg)`,
-      transformOrigin: 'center center',
-      color: parameters.customColor,
-      display: 'flex',
-      flexDirection: 'column',
-      justifyContent: 'flex-start',
-      lineHeight: (ALPHABET_PREVIEW_TWEAKS as any)[parameters.alphabet]?.lineHeight ?? 1,
-      alignItems,
-      cursor: showQuickGrid ? 'default' : 'move',
-      pointerEvents: showQuickGrid ? 'none' : 'auto',
-    }
-  };
-}
@@ -1,51 +0,0 @@
-import { useTranslation } from 'react-i18next';
-import { ToolType, useToolOperation } from '../../../hooks/tools/shared/useToolOperation';
-import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { AddStampParameters, defaultParameters } from './useAddStampParameters';
-
-export const buildAddStampFormData = (parameters: AddStampParameters, file: File): FormData => {
-  const formData = new FormData();
-  formData.append('fileInput', file);
-  formData.append('pageNumbers', parameters.pageNumbers);
-  formData.append('customMargin', parameters.customMargin || 'medium'); 
-  formData.append('position', String(parameters.position));
-  const effectiveFontSize = parameters.fontSize;
-  formData.append('fontSize', String(effectiveFontSize));
-  formData.append('rotation', String(parameters.rotation));
-  formData.append('opacity', String(parameters.opacity / 100));
-  formData.append('overrideX', String(parameters.overrideX));
-  formData.append('overrideY', String(parameters.overrideY));
-  formData.append('customColor', parameters.customColor.startsWith('#') ? parameters.customColor : `#${parameters.customColor}`);
-  formData.append('alphabet', parameters.alphabet);
-
-  // Stamp type and payload
-  formData.append('stampType', parameters.stampType || 'text');
-  if (parameters.stampType === 'text') {
-    formData.append('stampText', parameters.stampText);
-  } else if (parameters.stampType === 'image' && parameters.stampImage) {
-    formData.append('stampImage', parameters.stampImage);
-  }
-
-  return formData;
-};
-
-export const addStampOperationConfig = {
-  toolType: ToolType.singleFile,
-  buildFormData: buildAddStampFormData,
-  operationType: 'addStamp',
-  endpoint: '/api/v1/misc/add-stamp',
-  defaultParameters,
-} as const;
-
-export const useAddStampOperation = () => {
-  const { t } = useTranslation();
-
-  return useToolOperation<AddStampParameters>({
-    ...addStampOperationConfig,
-    getErrorMessage: createStandardErrorHandler(
-      t('AddStampRequest.error.failed', 'An error occurred while adding stamp to the PDF.')
-    ),
-  });
-};
-
-
@@ -1,53 +0,0 @@
-import { BaseParameters } from '../../../types/parameters';
-import { useBaseParameters, type BaseParametersHook } from '../../../hooks/tools/shared/useBaseParameters';
-
-export interface AddStampParameters extends BaseParameters {
-  stampType?: 'text' | 'image';
-  stampText: string;
-  stampImage?: File;
-  alphabet: 'roman' | 'arabic' | 'japanese' | 'korean' | 'chinese' | 'thai';
-  fontSize: number; 
-  rotation: number; 
-  opacity: number;
-  position: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9; 
-  overrideX: number;
-  overrideY: number; 
-  customMargin: 'small' | 'medium' | 'large' | 'x-large';
-  customColor: string;
-  pageNumbers: string;
-  _activePill: 'fontSize' | 'rotation' | 'opacity';
-}
-
-export const defaultParameters: AddStampParameters = {
-  stampType: 'text',
-  stampText: '',
-  alphabet: 'roman',
-  fontSize: 80,
-  rotation: 0,
-  opacity: 50,
-  position: 5,
-  overrideX: -1,
-  overrideY: -1,
-  customMargin: 'medium',
-  customColor: '#d3d3d3',
-  pageNumbers: '1',
-  _activePill: 'fontSize',
-};
-
-export type AddStampParametersHook = BaseParametersHook<AddStampParameters>;
-
-export const useAddStampParameters = (): AddStampParametersHook => {
-  return useBaseParameters<AddStampParameters>({
-    defaultParameters,
-    endpointName: 'add-stamp',
-    validateFn: (params): boolean => {
-      if (!params.stampType) return false;
-      if (params.stampType === 'text') {
-        return params.stampText.trim().length > 0;
-      }
-      return params.stampImage !== undefined;
-    },
-  });
-};
-
-
@@ -58,13 +58,8 @@ export default function ToolSelector({
    return registry;
  }, [baseFilteredTools]);

-  // Transform filteredTools to the expected format for useToolSections
-  const transformedFilteredTools = useMemo(() => {
-    return filteredTools.map(([id, tool]) => ({ item: [id, tool] as [string, ToolRegistryEntry] }));
-  }, [filteredTools]);
-
  // Use the same tool sections logic as the main ToolPicker
-  const { sections, searchGroups } = useToolSections(transformedFilteredTools);
+  const { sections, searchGroups } = useToolSections(filteredTools);

  // Determine what to display: search results or organized sections
  const isSearching = searchTerm.trim().length > 0;
@@ -1,74 +0,0 @@
-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;
@@ -15,8 +15,6 @@ export interface ReviewToolStepProps<TParams = unknown> {
  title?: string;
  onFileClick?: (file: File) => void;
  onUndo: () => void;
-  isCollapsed?: boolean;
-  onCollapsedClick?: () => void;
 }

 function ReviewStepContent<TParams = unknown>({
@@ -113,8 +111,6 @@ export function createReviewToolStep<TParams = unknown>(
    t("review", "Review"),
    {
      isVisible: props.isVisible,
-      isCollapsed: props.isCollapsed,
-      onCollapsedClick: props.onCollapsedClick,
      _excludeFromCount: true,
      _noPadding: true,
    },
@@ -113,4 +113,4 @@ export function createToolFlow(config: ToolFlowConfig) {
      </ToolStepProvider>
    </Stack>
  );
-}
+}
@@ -13,39 +13,23 @@ export const renderToolButtons = (
  selectedToolKey: string | null,
  onSelect: (id: string) => void,
  showSubcategoryHeader: boolean = true,
-  disableNavigation: boolean = false,
-  searchResults?: Array<{ item: [string, any]; matchedText?: string }>
-) => {
-  // Create a map of matched text for quick lookup
-  const matchedTextMap = new Map<string, string>();
-  if (searchResults) {
-    searchResults.forEach(({ item: [id], matchedText }) => {
-      if (matchedText) matchedTextMap.set(id, matchedText);
-    });
-  }
-
-  return (
-    <Box key={subcategory.subcategoryId} w="100%">
-      {showSubcategoryHeader && (
-        <SubcategoryHeader label={getSubcategoryLabel(t, subcategory.subcategoryId)} />
-      )}
-      <div>
-        {subcategory.tools.map(({ id, tool }) => {
-          const matchedSynonym = matchedTextMap.get(id);
-          
-          return (
-            <ToolButton
-              key={id}
-              id={id}
-              tool={tool}
-              isSelected={selectedToolKey === id}
-              onSelect={onSelect}
-              disableNavigation={disableNavigation}
-              matchedSynonym={matchedSynonym}
-            />
-          );
-        })}
-      </div>
-    </Box>
-  );
-};
+  disableNavigation: boolean = false
+) => (
+  <Box key={subcategory.subcategoryId} w="100%">
+    {showSubcategoryHeader && (
+      <SubcategoryHeader label={getSubcategoryLabel(t, subcategory.subcategoryId)} />
+    )}
+    <div>
+      {subcategory.tools.map(({ id, tool }) => (
+        <ToolButton
+          key={id}
+          id={id}
+          tool={tool}
+          isSelected={selectedToolKey === id}
+          onSelect={onSelect}
+          disableNavigation={disableNavigation}
+        />
+      ))}
+    </div>
+  </Box>
+);
@@ -13,10 +13,9 @@ interface ToolButtonProps {
  onSelect: (id: string) => void;
  rounded?: boolean;
  disableNavigation?: boolean;
-  matchedSynonym?: string;
 }

-const ToolButton: React.FC<ToolButtonProps> = ({ id, tool, isSelected, onSelect, disableNavigation = false, matchedSynonym }) => {
+const ToolButton: React.FC<ToolButtonProps> = ({ id, tool, isSelected, onSelect, disableNavigation = false }) => {
  const isUnavailable = !tool.component && !tool.link;
  const { getToolNavigation } = useToolNavigation();

@@ -41,27 +40,13 @@ const ToolButton: React.FC<ToolButtonProps> = ({ id, tool, isSelected, onSelect,
  const buttonContent = (
    <>
      <div className="tool-button-icon" style={{ color: "var(--tools-text-and-icon-color)", marginRight: "0.5rem", transform: "scale(0.8)", transformOrigin: "center", opacity: isUnavailable ? 0.25 : 1 }}>{tool.icon}</div>
-      <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'flex-start', flex: 1, overflow: 'visible' }}>
-        <FitText
-          text={tool.name}
-          lines={1}
-          minimumFontScale={0.8}
-          as="span"
-          style={{ display: 'inline-block', maxWidth: '100%', opacity: isUnavailable ? 0.25 : 1 }}
-        />
-        {matchedSynonym && (
-          <span style={{ 
-            fontSize: '0.75rem', 
-            color: 'var(--mantine-color-dimmed)', 
-            opacity: isUnavailable ? 0.25 : 1,
-            marginTop: '1px',
-            overflow: 'visible',
-            whiteSpace: 'nowrap'
-          }}>
-            {matchedSynonym}
-          </span>
-        )}
-      </div>
+      <FitText
+        text={tool.name}
+        lines={1}
+        minimumFontScale={0.8}
+        as="span"
+        style={{ display: 'inline-block', maxWidth: '100%', opacity: isUnavailable ? 0.25 : 1 }}
+      />
    </>
  );

@@ -81,10 +66,7 @@ const ToolButton: React.FC<ToolButtonProps> = ({ id, tool, isSelected, onSelect,
      fullWidth
      justify="flex-start"
      className="tool-button"
-      styles={{ 
-        root: { borderRadius: 0, color: "var(--tools-text-and-icon-color)", overflow: 'visible' },
-        label: { overflow: 'visible' }
-      }}
+      styles={{ root: { borderRadius: 0, color: "var(--tools-text-and-icon-color)" } }}
    >
      {buttonContent}
    </Button>
@@ -102,10 +84,7 @@ const ToolButton: React.FC<ToolButtonProps> = ({ id, tool, isSelected, onSelect,
      fullWidth
      justify="flex-start"
      className="tool-button"
-      styles={{ 
-        root: { borderRadius: 0, color: "var(--tools-text-and-icon-color)", overflow: 'visible' },
-        label: { overflow: 'visible' }
-      }}
+      styles={{ root: { borderRadius: 0, color: "var(--tools-text-and-icon-color)" } }}
    >
      {buttonContent}
    </Button>
@@ -120,7 +99,7 @@ const ToolButton: React.FC<ToolButtonProps> = ({ id, tool, isSelected, onSelect,
      justify="flex-start"
      className="tool-button"
      aria-disabled={isUnavailable}
-      styles={{ root: { borderRadius: 0, color: "var(--tools-text-and-icon-color)", cursor: isUnavailable ? 'not-allowed' : undefined, overflow: 'visible' }, label: { overflow: 'visible' } }}
+      styles={{ root: { borderRadius: 0, color: "var(--tools-text-and-icon-color)", cursor: isUnavailable ? 'not-allowed' : undefined } }}
    >
      {buttonContent}
    </Button>
@@ -5,7 +5,6 @@ import LocalIcon from '../../shared/LocalIcon';
 import { ToolRegistryEntry } from "../../../data/toolsTaxonomy";
 import { TextInput } from "../../shared/TextInput";
 import "./ToolPicker.css";
-import { rankByFuzzy, idToWords } from "../../../utils/fuzzySearch";

 interface ToolSearchProps {
  value: string;
@@ -39,14 +38,15 @@ const ToolSearch = ({

  const filteredTools = useMemo(() => {
    if (!value.trim()) return [];
-    const entries = Object.entries(toolRegistry).filter(([id]) => !(mode === "dropdown" && id === selectedToolKey));
-    const ranked = rankByFuzzy(entries, value, [
-      ([key]) => idToWords(key),
-      ([, v]) => v.name,
-      ([, v]) => v.description,
-      ([, v]) => v.synonyms?.join(' ') || '',
-    ]).slice(0, 6);
-    return ranked.map(({ item: [id, tool] }) => ({ id, tool }));
+    return Object.entries(toolRegistry)
+      .filter(([id, tool]) => {
+        if (mode === "dropdown" && id === selectedToolKey) return false;
+        return (
+          tool.name.toLowerCase().includes(value.toLowerCase()) || tool.description.toLowerCase().includes(value.toLowerCase())
+        );
+      })
+      .slice(0, 6)
+      .map(([id, tool]) => ({ id, tool }));
  }, [value, toolRegistry, mode, selectedToolKey]);

  const handleSearchChange = (searchValue: string) => {
@@ -1,54 +0,0 @@
-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.'
-        )
-      }
-    ]
-  };
-};
@@ -5,19 +5,3 @@ export const getBaseUrl = (): string => {
  const { config } = useAppConfig();
  return config?.baseUrl || 'https://stirling.com';
 };
-
-// Base path from Vite config - build-time constant, normalized (no trailing slash)
-// When no subpath, use empty string instead of '.' to avoid relative path issues
-export const BASE_PATH = (import.meta.env.BASE_URL || '/').replace(/\/$/, '').replace(/^\.$/, '');
-
-/** For in-app navigations when you must touch window.location (rare). */
-export const withBasePath = (path: string): string => {
-  const clean = path.startsWith('/') ? path : `/${path}`;
-  return `${BASE_PATH}${clean}`;
-};
-
-/** For OAuth (needs absolute URL with scheme+host) */
-export const absoluteWithBasePath = (path: string): string => {
-  const clean = path.startsWith('/') ? path : `/${path}`;
-  return `${window.location.origin}${BASE_PATH}${clean}`;
-};
@@ -11,7 +11,6 @@ import { useNavigationActions, useNavigationState } from './NavigationContext';
 import { ToolId, isValidToolId } from '../types/toolId';
 import { useNavigationUrlSync } from '../hooks/useUrlSync';
 import { getDefaultWorkbench } from '../types/workbench';
-import { filterToolRegistryByQuery } from '../utils/toolSearch';

 // State interface
 interface ToolWorkflowState {
@@ -76,7 +75,6 @@ interface ToolWorkflowContextValue extends ToolWorkflowState {
  selectedToolKey: string | null;
  selectedTool: ToolRegistryEntry | null;
  toolRegistry: any; // From useToolManagement
-  getSelectedTool: (toolId: string | null) => ToolRegistryEntry | null;

  // UI Actions
  setSidebarsVisible: (visible: boolean) => void;
@@ -101,7 +99,7 @@ interface ToolWorkflowContextValue extends ToolWorkflowState {
  handleReaderToggle: () => void;

  // Computed values
-  filteredTools: Array<{ item: [string, ToolRegistryEntry]; matchedText?: string }>; // Filtered by search
+  filteredTools: [string, ToolRegistryEntry][]; // Filtered by search
  isPanelVisible: boolean;
 }

@@ -220,10 +218,12 @@ export function ToolWorkflowProvider({ children }: ToolWorkflowProviderProps) {
    setReaderMode(true);
  }, [setReaderMode]);

-  // Filter tools based on search query with fuzzy matching (name, description, id, synonyms)
+  // Filter tools based on search query
  const filteredTools = useMemo(() => {
    if (!toolRegistry) return [];
-    return filterToolRegistryByQuery(toolRegistry as Record<string, ToolRegistryEntry>, state.searchQuery);
+    return Object.entries(toolRegistry).filter(([_, { name }]) =>
+      name.toLowerCase().includes(state.searchQuery.toLowerCase())
+    );
  }, [toolRegistry, state.searchQuery]);

  const isPanelVisible = useMemo(() =>
@@ -247,7 +247,6 @@ export function ToolWorkflowProvider({ children }: ToolWorkflowProviderProps) {
    selectedToolKey: navigationState.selectedTool,
    selectedTool,
    toolRegistry,
-    getSelectedTool,

    // Actions
    setSidebarsVisible,
@@ -277,7 +276,6 @@ export function ToolWorkflowProvider({ children }: ToolWorkflowProviderProps) {
    navigationState.selectedTool,
    selectedTool,
    toolRegistry,
-    getSelectedTool,
    setSidebarsVisible,
    setLeftPanelView,
    setReaderMode,
@@ -21,8 +21,7 @@ export const initialFileContextState: FileContextState = {
    selectedPageNumbers: [],
    isProcessing: false,
    processingProgress: 0,
-    hasUnsavedChanges: false,
-    errorFileIds: []
+    hasUnsavedChanges: false
  }
 };

@@ -218,30 +217,6 @@ export function fileContextReducer(state: FileContextState, action: FileContextA
      };
    }

-    case 'MARK_FILE_ERROR': {
-      const { fileId } = action.payload;
-      if (state.ui.errorFileIds.includes(fileId)) return state;
-      return {
-        ...state,
-        ui: { ...state.ui, errorFileIds: [...state.ui.errorFileIds, fileId] }
-      };
-    }
-
-    case 'CLEAR_FILE_ERROR': {
-      const { fileId } = action.payload;
-      return {
-        ...state,
-        ui: { ...state.ui, errorFileIds: state.ui.errorFileIds.filter(id => id !== fileId) }
-      };
-    }
-
-    case 'CLEAR_ALL_FILE_ERRORS': {
-      return {
-        ...state,
-        ui: { ...state.ui, errorFileIds: [] }
-      };
-    }
-
    case 'PIN_FILE': {
      const { fileId } = action.payload;
      const newPinnedFiles = new Set(state.pinnedFiles);
@@ -558,8 +558,5 @@ export const createFileActions = (dispatch: React.Dispatch<FileContextAction>) =
  setHasUnsavedChanges: (hasChanges: boolean) => dispatch({ type: 'SET_UNSAVED_CHANGES', payload: { hasChanges } }),
  pinFile: (fileId: FileId) => dispatch({ type: 'PIN_FILE', payload: { fileId } }),
  unpinFile: (fileId: FileId) => dispatch({ type: 'UNPIN_FILE', payload: { fileId } }),
-  resetContext: () => dispatch({ type: 'RESET_CONTEXT' }),
-  markFileError: (fileId: FileId) => dispatch({ type: 'MARK_FILE_ERROR', payload: { fileId } }),
-  clearFileError: (fileId: FileId) => dispatch({ type: 'CLEAR_FILE_ERROR', payload: { fileId } }),
-  clearAllFileErrors: () => dispatch({ type: 'CLEAR_ALL_FILE_ERRORS' })
+  resetContext: () => dispatch({ type: 'RESET_CONTEXT' })
 });
@@ -45,8 +45,6 @@ export type ToolRegistryEntry = {
 	operationConfig?: ToolOperationConfig<any>;
 	// Settings component for automation configuration
 	settingsComponent?: React.ComponentType<any>;
-	// Synonyms for search (optional)
-	synonyms?: string[];
 }

 export type ToolRegistry = Record<ToolId, ToolRegistryEntry>;
@@ -12,9 +12,7 @@ import RemoveBlanks from "../tools/RemoveBlanks";
 import RemovePages from "../tools/RemovePages";
 import RemovePassword from "../tools/RemovePassword";
 import { SubcategoryId, ToolCategoryId, ToolRegistry } from "./toolsTaxonomy";
-import { getSynonyms } from "../utils/toolSynonyms";
 import AddWatermark from "../tools/AddWatermark";
-import AddStamp from "../tools/AddStamp";
 import Merge from '../tools/Merge';
 import Repair from "../tools/Repair";
 import AutoRename from "../tools/AutoRename";
@@ -34,7 +32,6 @@ import { removePasswordOperationConfig } from "../hooks/tools/removePassword/use
 import { sanitizeOperationConfig } from "../hooks/tools/sanitize/useSanitizeOperation";
 import { repairOperationConfig } from "../hooks/tools/repair/useRepairOperation";
 import { addWatermarkOperationConfig } from "../hooks/tools/addWatermark/useAddWatermarkOperation";
-import { addStampOperationConfig } from "../components/tools/addStamp/useAddStampOperation";
 import { unlockPdfFormsOperationConfig } from "../hooks/tools/unlockPdfForms/useUnlockPdfFormsOperation";
 import { singleLargePageOperationConfig } from "../hooks/tools/singleLargePage/useSingleLargePageOperation";
 import { ocrOperationConfig } from "../hooks/tools/ocr/useOCROperation";
@@ -68,13 +65,10 @@ 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";

@@ -176,7 +170,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.certSign.desc", "Sign PDF documents using digital certificates"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.SIGNING,
-        synonyms: getSynonyms(t, "certSign"),
        maxFiles: -1,
        endpoints: ["cert-sign"],
        operationConfig: certSignOperationConfig,
@@ -189,7 +182,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.sign.desc", "Adds signature to PDF by drawing, text or image"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.SIGNING,
-        synonyms: getSynonyms(t, "sign")
      },

      // Document Security
@@ -205,8 +197,7 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["add-password"],
        operationConfig: addPasswordOperationConfig,
        settingsComponent: AddPasswordSettings,
-        synonyms: getSynonyms(t, "addPassword")
-     },
+      },
      watermark: {
        icon: <LocalIcon icon="branding-watermark-outline-rounded" width="1.5rem" height="1.5rem" />,
        name: t("home.watermark.title", "Add Watermark"),
@@ -218,19 +209,14 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["add-watermark"],
        operationConfig: addWatermarkOperationConfig,
        settingsComponent: AddWatermarkSingleStepSettings,
-        synonyms: getSynonyms(t, "watermark")
      },
      addStamp: {
        icon: <LocalIcon icon="approval-rounded" width="1.5rem" height="1.5rem" />,
        name: t("home.addStamp.title", "Add Stamp to PDF"),
-        component: AddStamp,
+        component: null,
        description: t("home.addStamp.desc", "Add text or add image stamps at set locations"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.DOCUMENT_SECURITY,
-        synonyms: getSynonyms(t, "addStamp"),
-        maxFiles: -1,
-        endpoints: ["add-stamp"],
-        operationConfig: addStampOperationConfig,
      },
      sanitize: {
        icon: <LocalIcon icon="cleaning-services-outline-rounded" width="1.5rem" height="1.5rem" />,
@@ -243,7 +229,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["sanitize-pdf"],
        operationConfig: sanitizeOperationConfig,
        settingsComponent: SanitizeSettings,
-        synonyms: getSynonyms(t, "sanitize")
      },
      flatten: {
        icon: <LocalIcon icon="layers-clear-rounded" width="1.5rem" height="1.5rem" />,
@@ -256,7 +241,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["flatten"],
        operationConfig: flattenOperationConfig,
        settingsComponent: FlattenSettings,
-        synonyms: getSynonyms(t, "flatten")
      },
      unlockPDFForms: {
        icon: <LocalIcon icon="preview-off-rounded" width="1.5rem" height="1.5rem" />,
@@ -269,7 +253,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["unlock-pdf-forms"],
        operationConfig: unlockPdfFormsOperationConfig,
        settingsComponent: UnlockPdfFormsSettings,
-        synonyms: getSynonyms(t, "unlockPDFForms"),
      },
      manageCertificates: {
        icon: <LocalIcon icon="license-rounded" width="1.5rem" height="1.5rem" />,
@@ -281,7 +264,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        ),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.DOCUMENT_SECURITY,
-        synonyms: getSynonyms(t, "manageCertificates"),
      },
      changePermissions: {
        icon: <LocalIcon icon="lock-outline" width="1.5rem" height="1.5rem" />,
@@ -294,7 +276,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["add-password"],
        operationConfig: changePermissionsOperationConfig,
        settingsComponent: ChangePermissionsSettings,
-        synonyms: getSynonyms(t, "changePermissions"),
      },
      getPdfInfo: {
        icon: <LocalIcon icon="fact-check-rounded" width="1.5rem" height="1.5rem" />,
@@ -303,7 +284,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.getPdfInfo.desc", "Grabs any and all information possible on PDFs"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.VERIFICATION,
-        synonyms: getSynonyms(t, "getPdfInfo"),
      },
      validateSignature: {
        icon: <LocalIcon icon="verified-rounded" width="1.5rem" height="1.5rem" />,
@@ -312,12 +292,11 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.validateSignature.desc", "Verify digital signatures and certificates in PDF documents"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.VERIFICATION,
-        synonyms: getSynonyms(t, "validateSignature"),
      },

      // Document Review

-      read: {
+     read: {
        icon: <LocalIcon icon="article-rounded" width="1.5rem" height="1.5rem" />,
        name: t("home.read.title", "Read"),
        component: null,
@@ -328,7 +307,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        ),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.DOCUMENT_REVIEW,
-        synonyms: getSynonyms(t, "read")
      },
      changeMetadata: {
        icon: <LocalIcon icon="assignment-rounded" width="1.5rem" height="1.5rem" />,
@@ -341,7 +319,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["update-metadata"],
        operationConfig: changeMetadataOperationConfig,
        settingsComponent: ChangeMetadataSingleStep,
-        synonyms: getSynonyms(t, "changeMetadata")
      },
      // Page Formatting

@@ -368,7 +345,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["rotate-pdf"],
        operationConfig: rotateOperationConfig,
        settingsComponent: RotateSettings,
-        synonyms: getSynonyms(t, "rotate")
      },
      split: {
        icon: <LocalIcon icon="content-cut-rounded" width="1.5rem" height="1.5rem" />,
@@ -379,7 +355,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        subcategoryId: SubcategoryId.PAGE_FORMATTING,
        operationConfig: splitOperationConfig,
        settingsComponent: SplitSettings,
-        synonyms: getSynonyms(t, "split")
      },
      reorganizePages: {
        icon: <LocalIcon icon="move-down-rounded" width="1.5rem" height="1.5rem" />,
@@ -392,7 +367,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        ),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.PAGE_FORMATTING,
-        synonyms: getSynonyms(t, "reorganizePages")
      },
      scalePages: {
        icon: <LocalIcon icon="crop-free-rounded" width="1.5rem" height="1.5rem" />,
@@ -405,7 +379,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["scale-pages"],
        operationConfig: adjustPageScaleOperationConfig,
        settingsComponent: AdjustPageScaleSettings,
-        synonyms: getSynonyms(t, "scalePages")
      },
      addPageNumbers: {
        icon: <LocalIcon icon="123-rounded" width="1.5rem" height="1.5rem" />,
@@ -415,7 +388,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.addPageNumbers.desc", "Add Page numbers throughout a document in a set location"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.PAGE_FORMATTING,
-        synonyms: getSynonyms(t, "addPageNumbers")
      },
      pageLayout: {
        icon: <LocalIcon icon="dashboard-rounded" width="1.5rem" height="1.5rem" />,
@@ -425,7 +397,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.pageLayout.desc", "Merge multiple pages of a PDF document into a single page"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.PAGE_FORMATTING,
-        synonyms: getSynonyms(t, "pageLayout")
      },
      bookletImposition: {
        icon: <LocalIcon icon="menu-book-rounded" width="1.5rem" height="1.5rem" />,
@@ -450,7 +421,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        urlPath: '/pdf-to-single-page',
        endpoints: ["pdf-to-single-page"],
        operationConfig: singleLargePageOperationConfig,
-        synonyms: getSynonyms(t, "pdfToSinglePage")
      },
      addAttachments: {
        icon: <LocalIcon icon="attachment-rounded" width="1.5rem" height="1.5rem" />,
@@ -460,7 +430,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.addAttachments.desc", "Add or remove embedded files (attachments) to/from a PDF"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.PAGE_FORMATTING,
-        synonyms: getSynonyms(t, "addAttachments")
      },

      // Extraction
@@ -472,7 +441,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.extractPages.desc", "Extract specific pages from a PDF document"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.EXTRACTION,
-        synonyms: getSynonyms(t, "extractPages")
      },
      extractImages: {
        icon: <LocalIcon icon="filter-alt" width="1.5rem" height="1.5rem" />,
@@ -481,7 +449,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.extractImages.desc", "Extract images from PDF documents"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.EXTRACTION,
-        synonyms: getSynonyms(t, "extractImages")
      },

      // Removal
@@ -495,7 +462,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        subcategoryId: SubcategoryId.REMOVAL,
        maxFiles: 1,
        endpoints: ["remove-pages"],
-        synonyms: getSynonyms(t, "removePages")
      },
      removeBlanks: {
        icon: <LocalIcon icon="scan-delete-rounded" width="1.5rem" height="1.5rem" />,
@@ -506,7 +472,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        subcategoryId: SubcategoryId.REMOVAL,
        maxFiles: 1,
        endpoints: ["remove-blanks"],
-        synonyms: getSynonyms(t, "removeBlanks")
      },
      removeAnnotations: {
        icon: <LocalIcon icon="thread-unread-rounded" width="1.5rem" height="1.5rem" />,
@@ -515,7 +480,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.removeAnnotations.desc", "Remove annotations and comments from PDF documents"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.REMOVAL,
-        synonyms: getSynonyms(t, "removeAnnotations")
      },
      removeImage: {
        icon: <LocalIcon icon="remove-selection-rounded" width="1.5rem" height="1.5rem" />,
@@ -524,7 +488,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.removeImage.desc", "Remove images from PDF documents"),
        categoryId: ToolCategoryId.STANDARD_TOOLS,
        subcategoryId: SubcategoryId.REMOVAL,
-        synonyms: getSynonyms(t, "removeImage"),
      },
      removePassword: {
        icon: <LocalIcon icon="lock-open-right-outline-rounded" width="1.5rem" height="1.5rem" />,
@@ -537,7 +500,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        maxFiles: -1,
        operationConfig: removePasswordOperationConfig,
        settingsComponent: RemovePasswordSettings,
-        synonyms: getSynonyms(t, "removePassword")
      },
      removeCertSign: {
        icon: <LocalIcon icon="remove-moderator-outline-rounded" width="1.5rem" height="1.5rem" />,
@@ -549,7 +511,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        maxFiles: -1,
        endpoints: ["remove-certificate-sign"],
        operationConfig: removeCertificateSignOperationConfig,
-        synonyms: getSynonyms(t, "removeCertSign"),
      },

      // Automation
@@ -567,7 +528,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        maxFiles: -1,
        supportedFormats: CONVERT_SUPPORTED_FORMATS,
        endpoints: ["handleData"],
-        synonyms: getSynonyms(t, "automate"),
      },
      autoRename: {
        icon: <LocalIcon icon="match-word-rounded" width="1.5rem" height="1.5rem" />,
@@ -579,7 +539,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.autoRename.desc", "Automatically rename PDF files based on their content"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.AUTOMATION,
-        synonyms: getSynonyms(t, "autoRename"),
      },
      autoSplitPDF: {
        icon: <LocalIcon icon="split-scene-right-rounded" width="1.5rem" height="1.5rem" />,
@@ -588,7 +547,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.autoSplitPDF.desc", "Automatically split PDF pages based on content detection"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.AUTOMATION,
-        synonyms: getSynonyms(t, "autoSplitPDF"),
      },
      autoSizeSplitPDF: {
        icon: <LocalIcon icon="content-cut-rounded" width="1.5rem" height="1.5rem" />,
@@ -597,7 +555,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.autoSizeSplitPDF.desc", "Automatically split PDFs by file size or page count"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.AUTOMATION,
-        synonyms: getSynonyms(t, "autoSizeSplitPDF"),
      },

      // Advanced Formatting
@@ -609,7 +566,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.adjustContrast.desc", "Adjust colors and contrast of PDF documents"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
-        synonyms: getSynonyms(t, "adjustContrast"),
      },
      repair: {
        icon: <LocalIcon icon="build-outline-rounded" width="1.5rem" height="1.5rem" />,
@@ -622,20 +578,14 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["repair"],
        operationConfig: repairOperationConfig,
        settingsComponent: RepairSettings,
-        synonyms: getSynonyms(t, "repair")
      },
      scannerImageSplit: {
        icon: <LocalIcon icon="scanner-rounded" width="1.5rem" height="1.5rem" />,
        name: t("home.scannerImageSplit.title", "Detect & Split Scanned Photos"),
-        component: ScannerImageSplit,
+        component: null,
        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: {
        icon: <LocalIcon icon="layers-rounded" width="1.5rem" height="1.5rem" />,
@@ -644,7 +594,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.overlayPdfs.desc", "Overlay one PDF on top of another"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
-        synonyms: getSynonyms(t, "overlayPdfs"),
      },
      replaceColorPdf: {
        icon: <LocalIcon icon="format-color-fill-rounded" width="1.5rem" height="1.5rem" />,
@@ -653,7 +602,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.replaceColorPdf.desc", "Replace or invert colors in PDF documents"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
-        synonyms: getSynonyms(t, "replaceColorPdf"),
      },
      addImage: {
        icon: <LocalIcon icon="image-rounded" width="1.5rem" height="1.5rem" />,
@@ -662,7 +610,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.addImage.desc", "Add images to PDF documents"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
-        synonyms: getSynonyms(t, "addImage"),
      },
      editTableOfContents: {
        icon: <LocalIcon icon="bookmark-add-rounded" width="1.5rem" height="1.5rem" />,
@@ -671,7 +618,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.editTableOfContents.desc", "Add or edit bookmarks and table of contents in PDF documents"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
-        synonyms: getSynonyms(t, "editTableOfContents"),
      },
      fakeScan: {
        icon: <LocalIcon icon="scanner-rounded" width="1.5rem" height="1.5rem" />,
@@ -680,7 +626,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.fakeScan.desc", "Create a PDF that looks like it was scanned"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
-        synonyms: getSynonyms(t, "fakeScan"),
      },

      // Developer Tools
@@ -692,7 +637,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.showJS.desc", "Extract and display JavaScript code from PDF documents"),
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.DEVELOPER_TOOLS,
-        synonyms: getSynonyms(t, "showJS"),
      },
      devApi: {
        icon: <LocalIcon icon="open-in-new-rounded" width="1.5rem" height="1.5rem" style={{ color: "#2F7BF6" }} />,
@@ -702,7 +646,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.DEVELOPER_TOOLS,
        link: "https://stirlingpdf.io/swagger-ui/5.21.0/index.html",
-        synonyms: getSynonyms(t, "devApi"),
      },
      devFolderScanning: {
        icon: <LocalIcon icon="open-in-new-rounded" width="1.5rem" height="1.5rem" style={{ color: "#2F7BF6" }} />,
@@ -712,7 +655,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.DEVELOPER_TOOLS,
        link: "https://docs.stirlingpdf.com/Advanced%20Configuration/Folder%20Scanning/",
-        synonyms: getSynonyms(t, "devFolderScanning"),
      },
      devSsoGuide: {
        icon: <LocalIcon icon="open-in-new-rounded" width="1.5rem" height="1.5rem" style={{ color: "#2F7BF6" }} />,
@@ -722,7 +664,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.DEVELOPER_TOOLS,
        link: "https://docs.stirlingpdf.com/Advanced%20Configuration/Single%20Sign-On%20Configuration",
-        synonyms: getSynonyms(t, "devSsoGuide"),
      },
      devAirgapped: {
        icon: <LocalIcon icon="open-in-new-rounded" width="1.5rem" height="1.5rem" style={{ color: "#2F7BF6" }} />,
@@ -732,7 +673,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        categoryId: ToolCategoryId.ADVANCED_TOOLS,
        subcategoryId: SubcategoryId.DEVELOPER_TOOLS,
        link: "https://docs.stirlingpdf.com/Pro/#activation",
-        synonyms: getSynonyms(t, "devAirgapped"),
      },

      // Recommended Tools
@@ -743,7 +683,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        description: t("home.compare.desc", "Compare two PDF documents and highlight differences"),
        categoryId: ToolCategoryId.RECOMMENDED_TOOLS,
        subcategoryId: SubcategoryId.GENERAL,
-        synonyms: getSynonyms(t, "compare")
      },
      compress: {
        icon: <LocalIcon icon="zoom-in-map-rounded" width="1.5rem" height="1.5rem" />,
@@ -755,7 +694,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        maxFiles: -1,
        operationConfig: compressOperationConfig,
        settingsComponent: CompressSettings,
-        synonyms: getSynonyms(t, "compress")
      },
      convert: {
        icon: <LocalIcon icon="sync-alt-rounded" width="1.5rem" height="1.5rem" />,
@@ -785,7 +723,6 @@ export function useFlatToolRegistry(): ToolRegistry {

        operationConfig: convertOperationConfig,
        settingsComponent: ConvertSettings,
-        synonyms: getSynonyms(t, "convert")
      },
      merge: {
        icon: <LocalIcon icon="library-add-rounded" width="1.5rem" height="1.5rem" />,
@@ -797,8 +734,7 @@ export function useFlatToolRegistry(): ToolRegistry {
        maxFiles: -1,
        endpoints: ["merge-pdfs"],
        operationConfig: mergeOperationConfig,
-        settingsComponent: MergeSettings,
-        synonyms: getSynonyms(t, "merge")
+        settingsComponent: MergeSettings
      },
      multiTool: {
        icon: <LocalIcon icon="dashboard-customize-rounded" width="1.5rem" height="1.5rem" />,
@@ -809,7 +745,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        categoryId: ToolCategoryId.RECOMMENDED_TOOLS,
        subcategoryId: SubcategoryId.GENERAL,
        maxFiles: -1,
-        synonyms: getSynonyms(t, "multiTool"),
      },
      ocr: {
        icon: <LocalIcon icon="quick-reference-all-outline-rounded" width="1.5rem" height="1.5rem" />,
@@ -822,7 +757,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        urlPath: '/ocr-pdf',
        operationConfig: ocrOperationConfig,
        settingsComponent: OCRSettings,
-        synonyms: getSynonyms(t, "ocr")
      },
      redact: {
        icon: <LocalIcon icon="visibility-off-rounded" width="1.5rem" height="1.5rem" />,
@@ -835,7 +769,6 @@ export function useFlatToolRegistry(): ToolRegistry {
        endpoints: ["auto-redact"],
        operationConfig: redactOperationConfig,
        settingsComponent: RedactSingleStepSettings,
-        synonyms: getSynonyms(t, "redact")
      },
    };

@@ -17,7 +17,6 @@ declare module '../assets/material-symbols-icons.json' {
  export default value;
 }

-declare module 'pdfjs-dist/legacy/build/pdf.mjs'
 // TODO: Add proper EmbedPDF types for local submodule integration

 export {};
@@ -19,8 +19,6 @@ export const shouldProcessFilesSeparately = (
    (parameters.fromExtension === 'pdf' && isImageFormat(parameters.toExtension)) ||
    // PDF to PDF/A conversions (each PDF should be processed separately)
    (parameters.fromExtension === 'pdf' && parameters.toExtension === 'pdfa') ||
-    // PDF to text-like formats should be one output per input
-    (parameters.fromExtension === 'pdf' && ['txt', 'rtf', 'csv'].includes(parameters.toExtension)) ||
    // Web files to PDF conversions (each web file should generate its own PDF)
    ((isWebFormat(parameters.fromExtension) || parameters.fromExtension === 'web') &&
     parameters.toExtension === 'pdf') ||
@@ -9,9 +9,6 @@ const buildFormData = (parameters: MergeParameters, files: File[]): FormData =>
  files.forEach((file) => {
    formData.append("fileInput", file);
  });
-  // Provide stable client file IDs (align with files order)
-  const clientIds: string[] = files.map((f: any) => String((f as any).fileId || f.name));
-  formData.append('clientFileIds', JSON.stringify(clientIds));
  formData.append("sortType", "orderProvided"); // Always use orderProvided since UI handles sorting
  formData.append("removeCertSign", parameters.removeDigitalSignature.toString());
  formData.append("generateToc", parameters.generateTableOfContents.toString());
@@ -1,54 +0,0 @@
-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.'))
-  });
-};
@@ -1,31 +0,0 @@
-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;
-    },
-  });
-};
@@ -1,7 +1,6 @@
 import { useCallback, useRef } from 'react';
-import axios, { CancelTokenSource } from '../../../services/http';
+import axios, { CancelTokenSource } from 'axios';
 import { processResponse, ResponseHandler } from '../../../utils/toolResponseProcessor';
-import { isEmptyOutput } from '../../../services/errorUtils';
 import type { ProcessingProgress } from './useToolState';

 export interface ApiCallsConfig<TParams = void> {
@@ -20,11 +19,9 @@ export const useToolApiCalls = <TParams = void>() => {
    validFiles: File[],
    config: ApiCallsConfig<TParams>,
    onProgress: (progress: ProcessingProgress) => void,
-    onStatus: (status: string) => void,
-    markFileError?: (fileId: string) => void,
-  ): Promise<{ outputFiles: File[]; successSourceIds: string[] }> => {
+    onStatus: (status: string) => void
+  ): Promise<File[]> => {
    const processedFiles: File[] = [];
-    const successSourceIds: string[] = [];
    const failedFiles: string[] = [];
    const total = validFiles.length;

@@ -34,19 +31,16 @@ export const useToolApiCalls = <TParams = void>() => {
    for (let i = 0; i < validFiles.length; i++) {
      const file = validFiles[i];

-      console.debug('[processFiles] Start', { index: i, total, name: file.name, fileId: (file as any).fileId });
      onProgress({ current: i + 1, total, currentFileName: file.name });
      onStatus(`Processing ${file.name} (${i + 1}/${total})`);

      try {
        const formData = config.buildFormData(params, file);
        const endpoint = typeof config.endpoint === 'function' ? config.endpoint(params) : config.endpoint;
-        console.debug('[processFiles] POST', { endpoint, name: file.name });
        const response = await axios.post(endpoint, formData, {
          responseType: 'blob',
          cancelToken: cancelTokenRef.current.token,
        });
-        console.debug('[processFiles] Response OK', { name: file.name, status: (response as any)?.status });

        // Forward to shared response processor (uses tool-specific responseHandler if provided)
        const responseFiles = await processResponse(
@@ -56,35 +50,14 @@ export const useToolApiCalls = <TParams = void>() => {
          config.responseHandler,
          config.preserveBackendFilename ? response.headers : undefined
        );
-        // Guard: some endpoints may return an empty/0-byte file with 200
-        const empty = isEmptyOutput(responseFiles);
-        if (empty) {
-          console.warn('[processFiles] Empty output treated as failure', { name: file.name });
-          failedFiles.push(file.name);
-          try { 
-            (markFileError as any)?.((file as any).fileId); 
-          } catch (e) { 
-            console.debug('markFileError', e); 
-          }
-          continue;
-        }
        processedFiles.push(...responseFiles);
-        // record source id as successful
-        successSourceIds.push((file as any).fileId);
-        console.debug('[processFiles] Success', { name: file.name, produced: responseFiles.length });

      } catch (error) {
        if (axios.isCancel(error)) {
          throw new Error('Operation was cancelled');
        }
-        console.error('[processFiles] Failed', { name: file.name, error });
+        console.error(`Failed to process ${file.name}:`, error);
        failedFiles.push(file.name);
-        // mark errored file so UI can highlight
-        try { 
-          (markFileError as any)?.((file as any).fileId); 
-        } catch (e) { 
-          console.debug('markFileError', e); 
-        }
      }
    }

@@ -98,8 +71,7 @@ export const useToolApiCalls = <TParams = void>() => {
      onStatus(`Successfully processed ${processedFiles.length} file${processedFiles.length === 1 ? '' : 's'}`);
    }

-    console.debug('[processFiles] Completed batch', { total, successes: successSourceIds.length, outputs: processedFiles.length, failed: failedFiles.length });
-    return { outputFiles: processedFiles, successSourceIds };
+    return processedFiles;
  }, []);

  const cancelOperation = useCallback(() => {
@@ -1,13 +1,12 @@
 import { useCallback, useRef, useEffect } from 'react';
-import axios from '../../../services/http';
+import axios from 'axios';
 import { useTranslation } from 'react-i18next';
 import { useFileContext } from '../../../contexts/FileContext';
 import { useToolState, type ProcessingProgress } from './useToolState';
 import { useToolApiCalls, type ApiCallsConfig } from './useToolApiCalls';
 import { useToolResources } from './useToolResources';
 import { extractErrorMessage } from '../../../utils/toolErrorHandler';
-import { StirlingFile, extractFiles, FileId, StirlingFileStub, createStirlingFile } from '../../../types/fileContext';
-import { FILE_EVENTS } from '../../../services/errorUtils';
+import { StirlingFile, extractFiles, FileId, StirlingFileStub, createStirlingFile, createNewStirlingFileStub } from '../../../types/fileContext';
 import { ResponseHandler } from '../../../utils/toolResponseProcessor';
 import { createChildStub, generateProcessedFileMetadata } from '../../../contexts/file/fileActions';
 import { ToolOperation } from '../../../types/file';
@@ -149,7 +148,6 @@ export const useToolOperation = <TParams>(

  // Composed hooks
  const { state, actions } = useToolState();
-  const { actions: fileActions } = useFileContext();
  const { processFiles, cancelOperation: cancelApiCalls } = useToolApiCalls<TParams>();
  const { generateThumbnails, createDownloadInfo, cleanupBlobUrls, extractZipFiles, extractAllZipFiles } = useToolResources();

@@ -170,18 +168,7 @@ export const useToolOperation = <TParams>(
      return;
    }

-    // Handle zero-byte inputs explicitly: mark as error and continue with others
-    const zeroByteFiles = selectedFiles.filter(file => (file as any)?.size === 0);
-    if (zeroByteFiles.length > 0) {
-      try {
-        for (const f of zeroByteFiles) {
-          (fileActions.markFileError as any)((f as any).fileId);
-        }
-      } catch (e) { 
-        console.log('markFileError', e); 
-      }
-    }
-    const validFiles = selectedFiles.filter(file => (file as any)?.size > 0);
+    const validFiles = selectedFiles.filter(file => file.size > 0);
    if (validFiles.length === 0) {
      actions.setError(t('noValidFiles', 'No valid files to process'));
      return;
@@ -196,19 +183,8 @@ export const useToolOperation = <TParams>(
    // Prepare files with history metadata injection (for PDFs)
    actions.setStatus('Processing files...');

-    // Listen for global error file id events from HTTP interceptor during this run
-    let externalErrorFileIds: string[] = [];
-    const errorListener = (e: Event) => {
-      const detail = (e as CustomEvent)?.detail as any;
-      if (detail?.fileIds) {
-        externalErrorFileIds = Array.isArray(detail.fileIds) ? detail.fileIds : [];
-      }
-    };
-    window.addEventListener(FILE_EVENTS.markError, errorListener as EventListener);
-
-      try {
+    try {
      let processedFiles: File[];
-        let successSourceIds: string[] = [];

      // Use original files directly (no PDF metadata injection - history stored in IndexedDB)
      const filesForAPI = extractFiles(validFiles);
@@ -223,18 +199,13 @@ export const useToolOperation = <TParams>(
            responseHandler: config.responseHandler,
            preserveBackendFilename: config.preserveBackendFilename
          };
-          console.debug('[useToolOperation] Multi-file start', { count: filesForAPI.length });
-          const result = await processFiles(
+          processedFiles = await processFiles(
            params,
            filesForAPI,
            apiCallsConfig,
            actions.setProgress,
-            actions.setStatus,
-            fileActions.markFileError as any
+            actions.setStatus
          );
-          processedFiles = result.outputFiles;
-          successSourceIds = result.successSourceIds as any;
-          console.debug('[useToolOperation] Multi-file results', { outputFiles: processedFiles.length, successSources: result.successSourceIds.length });
          break;
        }
        case ToolType.multiFile: {
@@ -264,63 +235,13 @@ export const useToolOperation = <TParams>(
              processedFiles = await extractAllZipFiles(response.data);
            }
          }
-          // Assume all inputs succeeded together unless server provided an error earlier
-          successSourceIds = validFiles.map(f => (f as any).fileId) as any;
          break;
        }

-        case ToolType.custom: {
+        case ToolType.custom:
          actions.setStatus('Processing files...');
          processedFiles = await config.customProcessor(params, filesForAPI);
-          // Try to map outputs back to inputs by filename (before extension)
-          const inputBaseNames = new Map<string, string>();
-          for (const f of validFiles) {
-            const base = (f.name || '').replace(/\.[^.]+$/, '').toLowerCase();
-            inputBaseNames.set(base, (f as any).fileId);
-          }
-          const mappedSuccess: string[] = [];
-          for (const out of processedFiles) {
-            const base = (out.name || '').replace(/\.[^.]+$/, '').toLowerCase();
-            const id = inputBaseNames.get(base);
-            if (id) mappedSuccess.push(id);
-          }
-          // Fallback to naive alignment if names don't match
-          if (mappedSuccess.length === 0) {
-            successSourceIds = validFiles.slice(0, processedFiles.length).map(f => (f as any).fileId) as any;
-          } else {
-            successSourceIds = mappedSuccess as any;
-          }
          break;
-        }
-      }
-
-      // Normalize error flags across tool types: mark failures, clear successes
-      try {
-        const allInputIds = validFiles.map(f => (f as any).fileId) as unknown as string[];
-        const okSet = new Set((successSourceIds as unknown as string[]) || []);
-        // Clear errors on successes
-        for (const okId of okSet) {
-          try { (fileActions.clearFileError as any)(okId); } catch (_e) { void _e; }
-        }
-        // Mark errors on inputs that didn't succeed
-        for (const id of allInputIds) {
-          if (!okSet.has(id)) {
-            try { (fileActions.markFileError as any)(id); } catch (_e) { void _e; }
-          }
-        }
-      } catch (_e) { void _e; }
-
-      if (externalErrorFileIds.length > 0) {
-        // If backend told us which sources failed, prefer that mapping
-        successSourceIds = validFiles
-          .map(f => (f as any).fileId)
-          .filter(id => !externalErrorFileIds.includes(id)) as any;
-        // Also mark failed IDs immediately
-        try {
-          for (const badId of externalErrorFileIds) {
-            (fileActions.markFileError as any)(badId);
-          }
-        } catch (_e) { void _e; }
      }

      if (processedFiles.length > 0) {
@@ -365,38 +286,29 @@ export const useToolOperation = <TParams>(
        const processedFileMetadataArray = await Promise.all(
          processedFiles.map(file => generateProcessedFileMetadata(file))
        );
-        // Always create child stubs linking back to the successful source inputs
-        const successInputStubs = successSourceIds
-          .map((id) => selectors.getStirlingFileStub(id as any))
-          .filter(Boolean) as StirlingFileStub[];
-
-        if (successInputStubs.length !== processedFiles.length) {
-          console.warn('[useToolOperation] Mismatch successInputStubs vs outputs', {
-            successInputStubs: successInputStubs.length,
-            outputs: processedFiles.length,
-          });
-        }
-
-        const outputStirlingFileStubs = processedFiles.map((resultingFile, index) =>
-          createChildStub(
-            successInputStubs[index] || inputStirlingFileStubs[index] || inputStirlingFileStubs[0],
-            newToolOperation,
-            resultingFile,
-            thumbnails[index],
-            processedFileMetadataArray[index]
-          )
-        );
+        const shouldBranchHistory = processedFiles.length != inputStirlingFileStubs.length;
+        // Create output stubs with fresh metadata (no inheritance of stale processedFile data)
+        const outputStirlingFileStubs = shouldBranchHistory
+          ? processedFiles.map((file, index) =>
+              createNewStirlingFileStub(file, undefined, thumbnails[index], processedFileMetadataArray[index])
+            )
+          : processedFiles.map((resultingFile, index) =>
+              createChildStub(
+                inputStirlingFileStubs[index],
+                newToolOperation,
+                resultingFile,
+                thumbnails[index],
+                processedFileMetadataArray[index]
+              )
+            );

        // Create StirlingFile objects from processed files and child stubs
        const outputStirlingFiles = processedFiles.map((file, index) => {
          const childStub = outputStirlingFileStubs[index];
          return createStirlingFile(file, childStub.id);
        });
-        // Build consumption arrays aligned to the successful source IDs
-        const toConsumeInputIds = successSourceIds.filter((id: string) => inputFileIds.includes(id as any)) as unknown as FileId[];
-        // Outputs and stubs are already ordered by success sequence
-        console.debug('[useToolOperation] Consuming files', { inputCount: inputFileIds.length, toConsume: toConsumeInputIds.length });
-        const outputFileIds = await consumeFiles(toConsumeInputIds, outputStirlingFiles, outputStirlingFileStubs);
+
+        const outputFileIds = await consumeFiles(inputFileIds, outputStirlingFiles, outputStirlingFileStubs);

        // Store operation data for undo (only store what we need to avoid memory bloat)
        lastOperationRef.current = {
@@ -408,40 +320,10 @@ export const useToolOperation = <TParams>(
      }

    } catch (error: any) {
-      // Centralized 422 handler: mark provided IDs in errorFileIds
-      try {
-        const status = (error?.response?.status as number | undefined);
-        if (status === 422) {
-          const payload = error?.response?.data;
-          let parsed: any = payload;
-          if (typeof payload === 'string') {
-            try { parsed = JSON.parse(payload); } catch { parsed = payload; }
-          } else if (payload && typeof (payload as any).text === 'function') {
-            // Blob or Response-like object from axios when responseType='blob'
-            const text = await (payload as Blob).text();
-            try { parsed = JSON.parse(text); } catch { parsed = text; }
-          }
-          let ids: string[] | undefined = Array.isArray(parsed?.errorFileIds) ? parsed.errorFileIds : undefined;
-          if (!ids && typeof parsed === 'string') {
-            const match = parsed.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g);
-            if (match && match.length > 0) ids = Array.from(new Set(match));
-          }
-          if (ids && ids.length > 0) {
-            for (const badId of ids) {
-              try { (fileActions.markFileError as any)(badId); } catch (_e) { void _e; }
-            }
-            actions.setStatus('Process failed due to invalid/corrupted file(s)');
-            // Avoid duplicating toast messaging here
-            return;
-          }
-        }
-      } catch (_e) { void _e; }
-
      const errorMessage = config.getErrorMessage?.(error) || extractErrorMessage(error);
      actions.setError(errorMessage);
      actions.setStatus('');
    } finally {
-      window.removeEventListener(FILE_EVENTS.markError, errorListener as EventListener);
      actions.setLoading(false);
      actions.setProgress(null);
    }
@@ -1,6 +1,5 @@
 import { useEffect, useState } from 'react';
 import { useTranslation } from 'react-i18next';
-import { BASE_PATH } from '../constants/app';

 declare global {
  interface Window {
@@ -38,17 +37,17 @@ export const useCookieConsent = ({ analyticsEnabled = false }: CookieConsentConf
    // Load the cookie consent CSS files first
    const mainCSS = document.createElement('link');
    mainCSS.rel = 'stylesheet';
-    mainCSS.href = `${BASE_PATH}/css/cookieconsent.css`;
+    mainCSS.href = '/css/cookieconsent.css';
    document.head.appendChild(mainCSS);

    const customCSS = document.createElement('link');
    customCSS.rel = 'stylesheet';
-    customCSS.href = `${BASE_PATH}/css/cookieconsentCustomisation.css`;
+    customCSS.href = '/css/cookieconsentCustomisation.css';
    document.head.appendChild(customCSS);

    // Load the cookie consent library
    const script = document.createElement('script');
-    script.src = `${BASE_PATH}/js/thirdParty/cookieconsent.umd.js`;
+    script.src = '/js/thirdParty/cookieconsent.umd.js';
    script.onload = () => {
      // Small delay to ensure DOM is ready
      setTimeout(() => {
@@ -8,31 +8,31 @@ export function usePDFProcessor() {
  const [error, setError] = useState<string | null>(null);

  const generatePageThumbnail = useCallback(async (
-    file: File,
-    pageNumber: number,
+    file: File, 
+    pageNumber: number, 
    scale: number = 0.5
  ): Promise<string> => {
    try {
      const arrayBuffer = await file.arrayBuffer();
      const pdf = await pdfWorkerManager.createDocument(arrayBuffer);
      const page = await pdf.getPage(pageNumber);
-
+      
      const viewport = page.getViewport({ scale });
      const canvas = document.createElement('canvas');
      canvas.width = viewport.width;
      canvas.height = viewport.height;
-
+      
      const context = canvas.getContext('2d');
      if (!context) {
        throw new Error('Could not get canvas context');
      }
-
-      await page.render({ canvasContext: context, viewport, canvas }).promise;
+      
+      await page.render({ canvasContext: context, viewport }).promise;
      const thumbnail = canvas.toDataURL();
-
+      
      // Clean up using worker manager
      pdfWorkerManager.destroyDocument(pdf);
-
+      
      return thumbnail;
    } catch (error) {
      console.error('Failed to generate thumbnail:', error);
@@ -42,22 +42,22 @@ export function usePDFProcessor() {

  // Internal function to generate thumbnail from already-opened PDF
  const generateThumbnailFromPDF = useCallback(async (
-    pdf: any,
-    pageNumber: number,
+    pdf: any, 
+    pageNumber: number, 
    scale: number = 0.5
  ): Promise<string> => {
    const page = await pdf.getPage(pageNumber);
-
+    
    const viewport = page.getViewport({ scale });
    const canvas = document.createElement('canvas');
    canvas.width = viewport.width;
    canvas.height = viewport.height;
-
+    
    const context = canvas.getContext('2d');
    if (!context) {
      throw new Error('Could not get canvas context');
    }
-
+    
    await page.render({ canvasContext: context, viewport }).promise;
    return canvas.toDataURL();
  }, []);
@@ -65,14 +65,14 @@ export function usePDFProcessor() {
  const processPDFFile = useCallback(async (file: File): Promise<PDFDocument> => {
    setLoading(true);
    setError(null);
-
+    
    try {
      const arrayBuffer = await file.arrayBuffer();
      const pdf = await pdfWorkerManager.createDocument(arrayBuffer);
      const totalPages = pdf.numPages;
-
+      
      const pages: PDFPage[] = [];
-
+      
      // Create pages without thumbnails initially - load them lazily
      for (let i = 1; i <= totalPages; i++) {
        pages.push({
@@ -84,7 +84,7 @@ export function usePDFProcessor() {
          selected: false
        });
      }
-
+      
      // Generate thumbnails for first 10 pages immediately using the same PDF instance
      const priorityPages = Math.min(10, totalPages);
      for (let i = 1; i <= priorityPages; i++) {
@@ -95,10 +95,10 @@ export function usePDFProcessor() {
          console.warn(`Failed to generate thumbnail for page ${i}:`, error);
        }
      }
-
+      
      // Clean up using worker manager
      pdfWorkerManager.destroyDocument(pdf);
-
+      
      const document: PDFDocument = {
        id: `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
        name: file.name,
@@ -106,7 +106,7 @@ export function usePDFProcessor() {
        pages,
        totalPages
      };
-
+      
      return document;
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : 'Failed to process PDF';
@@ -123,4 +123,4 @@ export function usePDFProcessor() {
    loading,
    error
  };
-}
+}
@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 import { useToolNavigation } from './useToolNavigation';
-import { useToolWorkflow } from '../contexts/ToolWorkflowContext';
+import { useToolManagement } from './useToolManagement';
 import { handleUnlessSpecialClick } from '../utils/clickHandlers';

 export interface SidebarNavigationProps {
@@ -19,7 +19,7 @@ export function useSidebarNavigation(): {
  getToolNavigation: (toolId: string) => SidebarNavigationProps | null;
 } {
  const { getToolNavigation: getToolNavProps } = useToolNavigation();
-  const { getSelectedTool } = useToolWorkflow();
+  const { getSelectedTool } = useToolManagement();

  const defaultNavClick = useCallback((e: React.MouseEvent) => {
    handleUnlessSpecialClick(e, () => {
@@ -1,7 +1,7 @@
 import { useMemo } from 'react';
 import { useNavigationState } from '../contexts/NavigationContext';
 import { useToolNavigation } from './useToolNavigation';
-import { useToolWorkflow } from '../contexts/ToolWorkflowContext';
+import { useToolManagement } from './useToolManagement';
 import { ToolId } from '../types/toolId';

 // Material UI Icons
@@ -50,7 +50,7 @@ const ALL_SUGGESTED_TOOLS: Omit<SuggestedTool, 'href' | 'onClick'>[] = [
 export function useSuggestedTools(): SuggestedTool[] {
  const { selectedTool } = useNavigationState();
  const { getToolNavigation } = useToolNavigation();
-  const { getSelectedTool } = useToolWorkflow();
+  const { getSelectedTool } = useToolManagement();

  return useMemo(() => {
    // Filter out the current tool
@@ -27,19 +27,12 @@ export interface ToolSection {
  subcategories: SubcategoryGroup[];
 };

-export function useToolSections(
-  filteredTools: Array<{ item: [string /* FIX ME: Should be ToolId */, ToolRegistryEntry]; matchedText?: string }>,
-  searchQuery?: string
-) {
+export function useToolSections(filteredTools: [string /* FIX ME: Should be ToolId */, ToolRegistryEntry][]) {
  const { t } = useTranslation();

  const groupedTools = useMemo(() => {
-    if (!filteredTools || !Array.isArray(filteredTools)) {
-      return {} as GroupedTools;
-    }
-    
    const grouped = {} as GroupedTools;
-    filteredTools.forEach(({ item: [id, tool] }) => {
+    filteredTools.forEach(([id, tool]) => {
      const categoryId = tool.categoryId;
      const subcategoryId = tool.subcategoryId;
      if (!grouped[categoryId]) grouped[categoryId] = {} as SubcategoryIdMap;
@@ -99,13 +92,9 @@ export function useToolSections(
  }, [groupedTools]);

  const searchGroups: SubcategoryGroup[] = useMemo(() => {
-    if (!filteredTools || !Array.isArray(filteredTools)) {
-      return [];
-    }
-    
    const subMap = {} as SubcategoryIdMap;
    const seen = new Set<string /* FIX ME: Should be ToolId */>();
-    filteredTools.forEach(({ item: [id, tool] }) => {
+    filteredTools.forEach(([id, tool]) => {
      const toolId = id as string /* FIX ME: Should be ToolId */;
      if (seen.has(toolId)) return;
      seen.add(toolId);
@@ -113,31 +102,10 @@ export function useToolSections(
      if (!subMap[sub]) subMap[sub] = [];
      subMap[sub].push({ id: toolId, tool });
    });
-    const entries = Object.entries(subMap);
-
-    // If a search query is present, always order subcategories by first occurrence in
-    // the ranked filteredTools list so the top-ranked tools' subcategory appears first.
-    if (searchQuery && searchQuery.trim()) {
-      const order: SubcategoryId[] = [];
-      filteredTools.forEach(({ item: [_, tool] }) => {
-        const sc = tool.subcategoryId;
-        if (!order.includes(sc)) order.push(sc);
-      });
-      return entries
-        .sort(([a], [b]) => {
-          const ai = order.indexOf(a as SubcategoryId);
-          const bi = order.indexOf(b as SubcategoryId);
-          if (ai !== bi) return ai - bi;
-          return (a as SubcategoryId).localeCompare(b as SubcategoryId);
-        })
-        .map(([subcategoryId, tools]) => ({ subcategoryId, tools } as SubcategoryGroup));
-    }
-
-    // No search: alphabetical subcategory ordering
-    return entries
+    return Object.entries(subMap)
      .sort(([a], [b]) => a.localeCompare(b))
      .map(([subcategoryId, tools]) => ({ subcategoryId, tools } as SubcategoryGroup));
-  }, [filteredTools, searchQuery]);
+  }, [filteredTools]);

  return { sections, searchGroups };
 }
@@ -7,7 +7,6 @@ import { ToolId } from '../types/toolId';
 import { parseToolRoute, updateToolRoute, clearToolRoute } from '../utils/urlRouting';
 import { ToolRegistry } from '../data/toolsTaxonomy';
 import { firePixel } from '../utils/scarfTracking';
-import { withBasePath } from '../constants/app';

 /**
 * Hook to sync workbench and tool with URL using registry
@@ -52,8 +51,7 @@ export function useNavigationUrlSync(
    } else if (prevSelectedTool.current !== null) {
      // Only clear URL if we had a tool before (user navigated away)
      // Don't clear on initial load when both current and previous are null
-      const homePath = withBasePath('/');
-      if (window.location.pathname !== homePath) {
+      if (window.location.pathname !== '/') {
        clearToolRoute(false); // Use pushState for user navigation
      }
    }
@@ -74,9 +74,7 @@ i18n
      loadPath: (lngs: string[], namespaces: string[]) => {
        // Map 'en' to 'en-GB' for loading translations
        const lng = lngs[0] === 'en' ? 'en-GB' : lngs[0];
-        const basePath = import.meta.env.BASE_URL || '/';
-        const cleanBasePath = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;
-        return `${cleanBasePath}/locales/${lng}/${namespaces[0]}.json`;
+        return `/locales/${lng}/${namespaces[0]}.json`;
      },
    },

@@ -10,7 +10,6 @@ import App from './App';
 import './i18n'; // Initialize i18next
 import posthog from 'posthog-js';
 import { PostHogProvider } from 'posthog-js/react';
-import { BASE_PATH } from './constants/app';

 // Compute initial color scheme
 function getInitialScheme(): 'light' | 'dark' {
@@ -61,7 +60,7 @@ root.render(
    <PostHogProvider
      client={posthog}
    >
-      <BrowserRouter basename={BASE_PATH}>
+      <BrowserRouter>
        <App />
      </BrowserRouter>
    </PostHogProvider>
@@ -1,47 +0,0 @@
-export const FILE_EVENTS = {
-  markError: 'files:markError',
-} as const;
-
-const UUID_REGEX = /[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g;
-
-export function tryParseJson<T = any>(input: unknown): T | undefined {
-  if (typeof input !== 'string') return input as T | undefined;
-  try { return JSON.parse(input) as T; } catch { return undefined; }
-}
-
-export async function normalizeAxiosErrorData(data: any): Promise<any> {
-  if (!data) return undefined;
-  if (typeof data?.text === 'function') {
-    const text = await data.text();
-    return tryParseJson(text) ?? text;
-  }
-  return data;
-}
-
-export function extractErrorFileIds(payload: any): string[] | undefined {
-  if (!payload) return undefined;
-  if (Array.isArray(payload?.errorFileIds)) return payload.errorFileIds as string[];
-  if (typeof payload === 'string') {
-    const matches = payload.match(UUID_REGEX);
-    if (matches && matches.length > 0) return Array.from(new Set(matches));
-  }
-  return undefined;
-}
-
-export function broadcastErroredFiles(fileIds: string[]) {
-  if (!fileIds || fileIds.length === 0) return;
-  window.dispatchEvent(new CustomEvent(FILE_EVENTS.markError, { detail: { fileIds } }));
-}
-
-export function isZeroByte(file: File | { size?: number } | null | undefined): boolean {
-  if (!file) return true;
-  const size = (file as any).size;
-  return typeof size === 'number' ? size <= 0 : true;
-}
-
-export function isEmptyOutput(files: File[] | null | undefined): boolean {
-  if (!files || files.length === 0) return true;
-  return files.every(f => (f as any)?.size === 0);
-}
-
-
@@ -1,255 +0,0 @@
-// frontend/src/services/http.ts
-import axios from 'axios';
-import type { AxiosInstance } from 'axios';
-import { alert } from '../components/toast';
-import { broadcastErroredFiles, extractErrorFileIds, normalizeAxiosErrorData } from './errorUtils';
-import { showSpecialErrorToast } from './specialErrorToasts';
-
-const FRIENDLY_FALLBACK = 'There was an error processing your request.';
-const MAX_TOAST_BODY_CHARS = 400; // avoid massive, unreadable toasts
-
-function clampText(s: string, max = MAX_TOAST_BODY_CHARS): string {
-  return s && s.length > max ? `${s.slice(0, max)}…` : s;
-}
-
-function isUnhelpfulMessage(msg: string | null | undefined): boolean {
-  const s = (msg || '').trim();
-  if (!s) return true;
-  // Common unhelpful payloads we see
-  if (s === '{}' || s === '[]') return true;
-  if (/^request failed/i.test(s)) return true;
-  if (/^network error/i.test(s)) return true;
-  if (/^[45]\d\d\b/.test(s)) return true; // "500 Server Error" etc.
-  return false;
-}
-
-function titleForStatus(status?: number): string {
-  if (!status) return 'Network error';
-  if (status >= 500) return 'Server error';
-  if (status >= 400) return 'Request error';
-  return 'Request failed';
-}
-
-function extractAxiosErrorMessage(error: any): { title: string; body: string } {
-  if (axios.isAxiosError(error)) {
-    const status = error.response?.status;
-    const _statusText = error.response?.statusText || '';
-    let parsed: any = undefined;
-    const raw = error.response?.data;
-    if (typeof raw === 'string') {
-      try { parsed = JSON.parse(raw); } catch { /* keep as string */ }
-    } else {
-      parsed = raw;
-    }
-    const extractIds = (): string[] | undefined => {
-      if (Array.isArray(parsed?.errorFileIds)) return parsed.errorFileIds as string[];
-      const rawText = typeof raw === 'string' ? raw : '';
-      const uuidMatches = rawText.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g);
-      return uuidMatches && uuidMatches.length > 0 ? Array.from(new Set(uuidMatches)) : undefined;
-    };
-
-    const body = ((): string => {
-      const data = parsed;
-      if (!data) return typeof raw === 'string' ? raw : '';
-      const ids = extractIds();
-      if (ids && ids.length > 0) return `Failed files: ${ids.join(', ')}`;
-      if (data?.message) return data.message as string;
-      if (typeof raw === 'string') return raw;
-      try { return JSON.stringify(data); } catch { return ''; }
-    })();
-    const ids = extractIds();
-    const title = titleForStatus(status);
-    if (ids && ids.length > 0) {
-      return { title, body: 'Process failed due to invalid/corrupted file(s)' };
-    }
-    if (status === 422) {
-      const fallbackMsg = 'Process failed due to invalid/corrupted file(s)';
-      const bodyMsg = isUnhelpfulMessage(body) ? fallbackMsg : body;
-      return { title, body: bodyMsg };
-    }
-    const bodyMsg = isUnhelpfulMessage(body) ? FRIENDLY_FALLBACK : body;
-    return { title, body: bodyMsg };
-  }
-  try {
-    const msg = (error?.message || String(error)) as string;
-    return { title: 'Network error', body: isUnhelpfulMessage(msg) ? FRIENDLY_FALLBACK : msg };
-  } catch (e) {
-    // ignore extraction errors
-    console.debug('extractAxiosErrorMessage', e);
-    return { title: 'Network error', body: FRIENDLY_FALLBACK };
-  }
-}
-
-// ---------- Axios instance creation ----------
-const __globalAny = (typeof window !== 'undefined' ? (window as any) : undefined);
-
-type ExtendedAxiosInstance = AxiosInstance & {
-  CancelToken: typeof axios.CancelToken;
-  isCancel: typeof axios.isCancel;
-};
-
-const __PREV_CLIENT: ExtendedAxiosInstance | undefined =
-  __globalAny?.__SPDF_HTTP_CLIENT as ExtendedAxiosInstance | undefined;
-
-let __createdClient: any;
-if (__PREV_CLIENT) {
-  __createdClient = __PREV_CLIENT;
-} else if (typeof (axios as any)?.create === 'function') {
-  try {
-    __createdClient = (axios as any).create();
-  } catch (e) {
-    console.debug('createClient', e);
-    __createdClient = axios as any;
-  }
-} else {
-  __createdClient = axios as any;
-}
-
-const apiClient: ExtendedAxiosInstance = (__createdClient || (axios as any)) as ExtendedAxiosInstance;
-
-// Augment instance with axios static helpers for backwards compatibility 
-if (apiClient) {
-  try { (apiClient as any).CancelToken = (axios as any).CancelToken; } catch (e) { console.debug('setCancelToken', e); }
-  try { (apiClient as any).isCancel = (axios as any).isCancel; } catch (e) { console.debug('setIsCancel', e); }
-}
-
-// ---------- Base defaults  ----------
-try {
-  const env = (import.meta as any)?.env || {};
-  apiClient.defaults.baseURL = env?.VITE_API_BASE_URL ?? '/';
-  apiClient.defaults.responseType = 'json';
-  // If OSS relies on cookies, uncomment:
-  // apiClient.defaults.withCredentials = true;
-  // Sensible timeout to avoid “forever hanging”:
-  apiClient.defaults.timeout = 20000;
-} catch (e) {
-  console.debug('setDefaults', e);
-  apiClient.defaults.baseURL = apiClient.defaults.baseURL || '/';
-  apiClient.defaults.responseType = apiClient.defaults.responseType || 'json';
-  apiClient.defaults.timeout = apiClient.defaults.timeout || 20000;
-}
-
-// ---------- Install a single response error interceptor (dedup + UX) ----------
-if (__globalAny?.__SPDF_HTTP_ERR_INTERCEPTOR_ID !== undefined && __PREV_CLIENT) {
-  try {
-    __PREV_CLIENT.interceptors.response.eject(__globalAny.__SPDF_HTTP_ERR_INTERCEPTOR_ID);
-  } catch (e) {
-    console.debug('ejectInterceptor', e);
-  }
-}
-
-const __recentSpecialByEndpoint: Record<string, number> = (__globalAny?.__SPDF_RECENT_SPECIAL || {});
-const __SPECIAL_SUPPRESS_MS = 1500; // brief window to suppress generic duplicate after special toast
-
-const __INTERCEPTOR_ID__ = apiClient?.interceptors?.response?.use
-  ? apiClient.interceptors.response.use(
-    (response) => response,
-    async (error) => {
-      // Compute title/body (friendly) from the error object
-      const { title, body } = extractAxiosErrorMessage(error);
-
-      // Normalize response data ONCE, reuse for both ID extraction and special-toast matching
-      const raw = (error?.response?.data) as any;
-      let normalized: unknown = raw;
-      try { normalized = await normalizeAxiosErrorData(raw); } catch (e) { console.debug('normalizeAxiosErrorData', e); }
-
-      // 1) If server sends structured file IDs for failures, also mark them errored in UI
-      try {
-        const ids = extractErrorFileIds(normalized);
-        if (ids && ids.length > 0) {
-          broadcastErroredFiles(ids);
-        }
-      } catch (e) {
-        console.debug('extractErrorFileIds', e);
-      }
-
-      // 2) Generic-vs-special dedupe by endpoint
-      const url: string | undefined = error?.config?.url;
-      const status: number | undefined = error?.response?.status;
-      const now = Date.now();
-      const isSpecial =
-        status === 422 ||
-        status === 409 || // often actionable conflicts
-        /Failed files:/.test(body) ||
-        /invalid\/corrupted file\(s\)/i.test(body);
-
-      if (isSpecial && url) {
-        __recentSpecialByEndpoint[url] = now;
-        if (__globalAny) __globalAny.__SPDF_RECENT_SPECIAL = __recentSpecialByEndpoint;
-      }
-      if (!isSpecial && url) {
-        const last = __recentSpecialByEndpoint[url] || 0;
-        if (now - last < __SPECIAL_SUPPRESS_MS) {
-          return Promise.reject(error);
-        }
-      }
-
-      // 3) Show specialized friendly toasts if matched; otherwise show the generic one
-      let rawString: string | undefined;
-      try {
-        rawString =
-          typeof normalized === 'string'
-            ? normalized
-            : JSON.stringify(normalized);
-      } catch (e) {
-        console.debug('extractErrorFileIds', e);
-      }
-
-      const handled = showSpecialErrorToast(rawString, { status });
-      if (!handled) {
-        const displayBody = clampText(body);
-        alert({ alertType: 'error', title, body: displayBody, expandable: true, isPersistentPopup: false });
-      }
-
-      return Promise.reject(error);
-    }
-  )
-  : undefined as any;
-
-if (__globalAny) {
-  __globalAny.__SPDF_HTTP_ERR_INTERCEPTOR_ID = __INTERCEPTOR_ID__;
-  __globalAny.__SPDF_RECENT_SPECIAL = __recentSpecialByEndpoint;
-  __globalAny.__SPDF_HTTP_CLIENT = apiClient;
-}
-
-// ---------- Fetch helper ----------
-export async function apiFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {
-  const res = await fetch(input, { credentials: init?.credentials ?? 'include', ...init });
-
-  if (!res.ok) {
-    let detail = '';
-    try {
-      const ct = res.headers.get('content-type') || '';
-      if (ct.includes('application/json')) {
-        const data = await res.json();
-        detail = typeof data === 'string' ? data : (data?.message || JSON.stringify(data));
-      } else {
-        detail = await res.text();
-      }
-    } catch {
-      // ignore parse errors
-    }
-
-    const title = titleForStatus(res.status);
-    const body = isUnhelpfulMessage(detail || res.statusText) ? FRIENDLY_FALLBACK : (detail || res.statusText);
-    alert({ alertType: 'error', title, body: clampText(body), expandable: true, isPersistentPopup: false });
-
-    // Important: match Axios semantics so callers can try/catch
-    throw new Error(body || res.statusText);
-  }
-
-  return res;
-}
-
-// ---------- Convenience API surface and exports ----------
-export const api = {
-  get: apiClient.get,
-  post: apiClient.post,
-  put: apiClient.put,
-  patch: apiClient.patch,
-  delete: apiClient.delete,
-  request: apiClient.request,
-};
-
-export default apiClient;
-export type { CancelTokenSource } from 'axios';
@@ -110,7 +110,7 @@ export class PDFProcessingService {

      const context = canvas.getContext('2d');
      if (context) {
-        await page.render({ canvasContext: context, viewport, canvas }).promise;
+        await page.render({ canvasContext: context, viewport }).promise;
        const thumbnail = canvas.toDataURL();

        pages.push({
@@ -5,7 +5,9 @@
 * and ensuring proper cleanup when operations complete.
 */

-import { GlobalWorkerOptions, getDocument, PDFDocumentProxy } from 'pdfjs-dist/legacy/build/pdf.mjs';
+import * as pdfjsLib from 'pdfjs-dist';
+import { PDFDocumentProxy } from 'pdfjs-dist/types/src/display/api';
+const { getDocument, GlobalWorkerOptions } = pdfjsLib;

 class PDFWorkerManager {
  private static instance: PDFWorkerManager;
@@ -30,10 +32,7 @@ class PDFWorkerManager {
   */
  private initializeWorker(): void {
    if (!this.isInitialized) {
-      GlobalWorkerOptions.workerSrc = new URL(
-        'pdfjs-dist/legacy/build/pdf.worker.min.mjs',
-        import.meta.url
-      ).toString();
+      GlobalWorkerOptions.workerSrc = '/pdf.worker.js';
      this.isInitialized = true;
    }
  }
@@ -1,57 +0,0 @@
-import { alert } from '../components/toast';
-
-interface ErrorToastMapping {
-  regex: RegExp;
-  i18nKey: string;
-  defaultMessage: string;
-}
-
-// Centralized list of special backend error message patterns → friendly, translated toasts
-const MAPPINGS: ErrorToastMapping[] = [
-  {
-    regex: /pdf contains an encryption dictionary/i,
-    i18nKey: 'errors.encryptedPdfMustRemovePassword',
-    defaultMessage: 'This PDF is encrypted. Please unlock it using the Unlock PDF Forms tool.'
-  },
-  {
-    regex: /the pdf document is passworded and either the password was not provided or was incorrect/i,
-    i18nKey: 'errors.incorrectPasswordProvided',
-    defaultMessage: 'The PDF password is incorrect or not provided.'
-  },
-];
-
-function titleForStatus(status?: number): string {
-  if (!status) return 'Network error';
-  if (status >= 500) return 'Server error';
-  if (status >= 400) return 'Request error';
-  return 'Request failed';
-}
-
-/**
- * Match a raw backend error string against known patterns and show a friendly toast.
- * Returns true if a special toast was shown, false otherwise.
- */
-export function showSpecialErrorToast(rawError: string | undefined, options?: { status?: number }): boolean {
-  const message = (rawError || '').toString();
-  if (!message) return false;
-
-  for (const mapping of MAPPINGS) {
-    if (mapping.regex.test(message)) {
-      // Best-effort translation without hard dependency on i18n config
-      let body = mapping.defaultMessage;
-      try {
-        const anyGlobal: any = (globalThis as any);
-        const i18next = anyGlobal?.i18next;
-        if (i18next && typeof i18next.t === 'function') {
-          body = i18next.t(mapping.i18nKey, { defaultValue: mapping.defaultMessage });
-        }
-      } catch { /* ignore translation errors */ }
-      const title = titleForStatus(options?.status);
-      alert({ alertType: 'error', title, body, expandable: true, isPersistentPopup: false });
-      return true;
-    }
-  }
-  return false;
-}
-
-
@@ -338,125 +338,6 @@ 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
@@ -30,30 +30,6 @@
  --color-primary-800: #1e40af;
  --color-primary-900: #1e3a8a;

-  /* Success (green) */
-  --color-green-50: #f0fdf4;
-  --color-green-100: #dcfce7;
-  --color-green-200: #bbf7d0;
-  --color-green-300: #86efac;
-  --color-green-400: #4ade80;
-  --color-green-500: #22c55e;
-  --color-green-600: #16a34a;
-  --color-green-700: #15803d;
-  --color-green-800: #166534;
-  --color-green-900: #14532d;
-
-  /* Warning (yellow) */
-  --color-yellow-50: #fefce8;
-  --color-yellow-100: #fef9c3;
-  --color-yellow-200: #fef08a;
-  --color-yellow-300: #fde047;
-  --color-yellow-400: #facc15;
-  --color-yellow-500: #eab308;
-  --color-yellow-600: #ca8a04;
-  --color-yellow-700: #a16207;
-  --color-yellow-800: #854d0e;
-  --color-yellow-900: #713f12;
-
  --color-red-50: #fef2f2;
  --color-red-100: #fee2e2;
  --color-red-200: #fecaca;
@@ -215,15 +191,11 @@
  --checkbox-checked-bg: #3FAFFF;
  --checkbox-tick: #FFFFFF;

-  --information-text-bg: #eaeaea;
-  --information-text-color: #5e5e5e;
  /* Bulk selection panel specific colors (light mode) */
  --bulk-panel-bg: #ffffff; /* white background for parent container */
  --bulk-card-bg: #ffffff; /* white background for cards */
  --bulk-card-border: #e5e7eb; /* light gray border for cards and buttons */
  --bulk-card-hover-border: #d1d5db; /* slightly darker on hover */
-  --unsupported-bar-bg: #5a616e;
-  --unsupported-bar-border: #6B7280;
 }

 [data-mantine-color-scheme="dark"] {
@@ -267,30 +239,6 @@
  --color-gray-800: #e5e7eb;
  --color-gray-900: #f3f4f6;

-  /* Success (green) - dark */
-  --color-green-50: #052e16;
-  --color-green-100: #064e3b;
-  --color-green-200: #065f46;
-  --color-green-300: #047857;
-  --color-green-400: #059669;
-  --color-green-500: #22c55e;
-  --color-green-600: #16a34a;
-  --color-green-700: #4ade80;
-  --color-green-800: #86efac;
-  --color-green-900: #bbf7d0;
-
-  /* Warning (yellow) - dark */
-  --color-yellow-50: #451a03;
-  --color-yellow-100: #713f12;
-  --color-yellow-200: #854d0e;
-  --color-yellow-300: #a16207;
-  --color-yellow-400: #ca8a04;
-  --color-yellow-500: #eab308;
-  --color-yellow-600: #facc15;
-  --color-yellow-700: #fde047;
-  --color-yellow-800: #fef08a;
-  --color-yellow-900: #fef9c3;
-
  /* Dark theme semantic colors */
  --bg-surface: #2A2F36;
  --bg-raised: #1F2329;
@@ -403,17 +351,13 @@
  /* Tool panel search bar background colors (dark mode) */
  --tool-panel-search-bg: #1F2329;
  --tool-panel-search-border-bottom: #4B525A;
-  
-  --information-text-bg: #292e34;
-  --information-text-color: #ececec;

  /* Bulk selection panel specific colors (dark mode) */
  --bulk-panel-bg: var(--bg-raised); /* dark background for parent container */
  --bulk-card-bg: var(--bg-raised); /* dark background for cards */
  --bulk-card-border: var(--border-default); /* default border for cards and buttons */
  --bulk-card-hover-border: var(--border-strong); /* stronger border on hover */
-  --unsupported-bar-bg: #1F2329;
-  --unsupported-bar-border: #4B525A;
+
 }

 /* Dropzone drop state styling */
@@ -143,7 +143,7 @@ describe('Convert Tool Integration Tests', () => {
      expect(result.current.downloadUrl).toBeTruthy();
      expect(result.current.downloadFilename).toBe('test.png');
      expect(result.current.isLoading).toBe(false);
-      expect(result.current.errorMessage).not.toBe(null);
+      expect(result.current.errorMessage).toBe(null);
    });

    test('should handle API error responses correctly', async () => {
@@ -365,7 +365,7 @@ describe('Convert Tool Integration Tests', () => {
      expect(result.current.downloadUrl).toBeTruthy();
      expect(result.current.downloadFilename).toBe('test.csv');
      expect(result.current.isLoading).toBe(false);
-      expect(result.current.errorMessage).not.toBe(null);
+      expect(result.current.errorMessage).toBe(null);
    });

    test('should handle complete unsupported conversion workflow', async () => {
@@ -14,32 +14,6 @@ const primary: MantineColorsTuple = [
  'var(--color-primary-900)',
 ];

-const green: MantineColorsTuple = [
-  'var(--color-green-50)',
-  'var(--color-green-100)',
-  'var(--color-green-200)',
-  'var(--color-green-300)',
-  'var(--color-green-400)',
-  'var(--color-green-500)',
-  'var(--color-green-600)',
-  'var(--color-green-700)',
-  'var(--color-green-800)',
-  'var(--color-green-900)',
-];
-
-const yellow: MantineColorsTuple = [
-  'var(--color-yellow-50)',
-  'var(--color-yellow-100)',
-  'var(--color-yellow-200)',
-  'var(--color-yellow-300)',
-  'var(--color-yellow-400)',
-  'var(--color-yellow-500)',
-  'var(--color-yellow-600)',
-  'var(--color-yellow-700)',
-  'var(--color-yellow-800)',
-  'var(--color-yellow-900)',
-];
-
 const gray: MantineColorsTuple = [
  'var(--color-gray-50)',
  'var(--color-gray-100)',
@@ -60,8 +34,6 @@ export const mantineTheme = createTheme({
  // Color palette
  colors: {
    primary,
-    green,
-    yellow,
    gray,
  },

@@ -1,413 +0,0 @@
-import { useEffect, useState } from "react";
-import { useTranslation } from "react-i18next";
-import { useFileSelection } from "../contexts/FileContext";
-import { createToolFlow } from "../components/tools/shared/createToolFlow";
-import { BaseToolProps, ToolComponent } from "../types/tool";
-import { useEndpointEnabled } from "../hooks/useEndpointConfig";
-import { useAddStampParameters } from "../components/tools/addStamp/useAddStampParameters";
-import { useAddStampOperation } from "../components/tools/addStamp/useAddStampOperation";
-import { Group, Select, Stack, Textarea, TextInput, ColorInput, Button, Slider, Text, NumberInput, Divider } from "@mantine/core";
-import StampPreview from "../components/tools/addStamp/StampPreview";
-import LocalIcon from "../components/shared/LocalIcon";
-import styles from "../components/tools/addStamp/StampPreview.module.css";
-import { Tooltip } from "../components/shared/Tooltip";
-import ButtonSelector from "../components/shared/ButtonSelector";
-import { useAccordionSteps } from "../hooks/tools/shared/useAccordionSteps";
-import ObscuredOverlay from "../components/shared/ObscuredOverlay";
-import { getDefaultFontSizeForAlphabet } from "../components/tools/addStamp/StampPreviewUtils";
-
-const AddStamp = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
-  const { t } = useTranslation();
-  const { selectedFiles } = useFileSelection();
-
-  const [quickPositionModeSelected, setQuickPositionModeSelected] = useState(false);
-  const [customPositionModeSelected, setCustomPositionModeSelected] = useState(true);
-
-  const params = useAddStampParameters();
-  const operation = useAddStampOperation();
-
-  const { enabled: endpointEnabled, loading: endpointLoading } = useEndpointEnabled("add-stamp");
-
-  useEffect(() => {
-    operation.resetResults();
-    onPreviewFile?.(null);
-  }, [params.parameters]);
-
-
-  const handleExecute = async () => {
-    try {
-      await operation.executeOperation(params.parameters, selectedFiles);
-      if (operation.files && onComplete) {
-        onComplete(operation.files);
-      }
-    } catch (error: any) {
-      onError?.(error?.message || t("AddStampRequest.error.failed", "Add stamp operation failed"));
-    }
-  };
-
-  const hasFiles = selectedFiles.length > 0;
-  const hasResults = operation.files.length > 0 || operation.downloadUrl !== null;
-
-  enum AddStampStep {
-    NONE = 'none',
-    STAMP_SETUP = 'stampSetup',
-    POSITION_FORMATTING = 'positionFormatting'
-  }
-
-  const accordion = useAccordionSteps<AddStampStep>({
-    noneValue: AddStampStep.NONE,
-    initialStep: AddStampStep.STAMP_SETUP,
-    stateConditions: {
-      hasFiles,
-      hasResults
-    },
-    afterResults: () => {
-      operation.resetResults();
-      onPreviewFile?.(null);
-    }
-  });
-
-  const getSteps = () => {
-    const steps: any[] = [];
-
-    // Step 1: Stamp Setup 
-    steps.push({
-      title: t("AddStampRequest.stampSetup", "Stamp Setup"),
-      isCollapsed: accordion.getCollapsedState(AddStampStep.STAMP_SETUP),
-      onCollapsedClick: () => accordion.handleStepToggle(AddStampStep.STAMP_SETUP),
-      isVisible: hasFiles || hasResults,
-      content: (
-        <Stack gap="md">
-          <TextInput
-            label={t('pageSelectionPrompt', 'Page Selection (e.g. 1,3,2 or 4-8,2,10-12 or 2n-1)')}
-            value={params.parameters.pageNumbers}
-            onChange={(e) => params.updateParameter('pageNumbers', e.currentTarget.value)}
-            disabled={endpointLoading}
-          />
-          <Divider/>
-          <div>
-            <Text size="sm" fw={500} mb="xs">{t('AddStampRequest.stampType', 'Stamp Type')}</Text>
-            <ButtonSelector
-              value={params.parameters.stampType}
-              onChange={(v: 'text' | 'image') => params.updateParameter('stampType', v)}
-              options={[
-                { value: 'text', label: t('watermark.type.1', 'Text') },
-                { value: 'image', label: t('watermark.type.2', 'Image') },
-              ]}
-              disabled={endpointLoading}
-              buttonClassName={styles.modeToggleButton}
-              textClassName={styles.modeToggleButtonText}
-            />
-          </div>
-
-          {params.parameters.stampType === 'text' && (
-            <>
-              <Textarea
-                label={t('AddStampRequest.stampText', 'Stamp Text')}
-                value={params.parameters.stampText}
-                onChange={(e) => params.updateParameter('stampText', e.currentTarget.value)}
-                autosize
-                minRows={2}
-                disabled={endpointLoading}
-              />
-              <Select
-                label={t('AddStampRequest.alphabet', 'Alphabet')}
-                value={params.parameters.alphabet}
-                onChange={(v) => {
-                  const nextAlphabet = (v as any) || 'roman';
-                  params.updateParameter('alphabet', nextAlphabet);
-                  const nextDefault = getDefaultFontSizeForAlphabet(nextAlphabet);
-                  params.updateParameter('fontSize', nextDefault);
-                }}
-                data={[
-                  { value: 'roman', label: 'Roman' },
-                  { value: 'arabic', label: 'العربية' },
-                  { value: 'japanese', label: '日本語' },
-                  { value: 'korean', label: '한국어' },
-                  { value: 'chinese', label: '简体中文' },
-                  { value: 'thai', label: 'ไทย' },
-                ]}
-                disabled={endpointLoading}
-              />
-            </>
-          )}
-
-          {params.parameters.stampType === 'image' && (
-            <Stack gap="xs">
-              <input
-                type="file"
-                accept=".png,.jpg,.jpeg,.gif,.bmp,.tiff,.tif,.webp"
-                onChange={(e) => {
-                  const file = e.target.files?.[0];
-                  if (file) params.updateParameter('stampImage', file);
-                }}
-                disabled={endpointLoading}
-                style={{ display: 'none' }}
-                id="stamp-image-input"
-              />
-              <Button
-                size="xs"
-                component="label"
-                htmlFor="stamp-image-input"
-                disabled={endpointLoading}
-              >
-                {t('chooseFile', 'Choose File')}
-              </Button>
-              {params.parameters.stampImage && (
-                <Stack gap="xs">
-                  <img
-                    src={URL.createObjectURL(params.parameters.stampImage)}
-                    alt="Selected stamp image"
-                    className="max-h-24 w-full object-contain border border-gray-200 rounded bg-gray-50"
-                  />
-                  <Text size="xs" c="dimmed">
-                    {params.parameters.stampImage.name}
-                  </Text>
-                </Stack>
-              )}
-            </Stack>
-          )}
-        </Stack>
-      ),
-    });
-
-    // Step 3: Formatting & Position
-    steps.push({
-      title: t("AddStampRequest.positionAndFormatting", "Position & Formatting"),
-      isCollapsed: accordion.getCollapsedState(AddStampStep.POSITION_FORMATTING),
-      onCollapsedClick: () => accordion.handleStepToggle(AddStampStep.POSITION_FORMATTING),
-      isVisible: hasFiles || hasResults,
-      content: (
-        <Stack gap="md" justify="space-between">
-          {/* Mode toggle: Quick grid vs Custom drag - only show for image stamps */}
-          {params.parameters.stampType === 'image' && (
-            <ButtonSelector
-              value={quickPositionModeSelected ? 'quick' : 'custom'}
-              onChange={(v: 'quick' | 'custom') => {
-                const isQuick = v === 'quick';
-                setQuickPositionModeSelected(isQuick);
-                setCustomPositionModeSelected(!isQuick);
-              }}
-              options={[
-                { value: 'quick', label: t('quickPosition', 'Quick Position') },
-                { value: 'custom', label: t('customPosition', 'Custom Position') },
-              ]}
-              disabled={endpointLoading}
-              buttonClassName={styles.modeToggleButton}
-              textClassName={styles.modeToggleButtonText}
-            />
-          )}
-
-          {params.parameters.stampType === 'image' && customPositionModeSelected && (
-            <div className={styles.informationContainer}>
-              <Text className={styles.informationText}>{t('AddStampRequest.customPosition', 'Drag the stamp to the desired location in the preview window.')}</Text>
-            </div>
-          )}
-          {params.parameters.stampType === 'image' && !customPositionModeSelected && (
-            <div className={styles.informationContainer}>
-              <Text className={styles.informationText}>{t('AddStampRequest.quickPosition', 'Select a position on the page to place the stamp.')}</Text>
-            </div>
-          )}
-
-
-          {/* Icon pill buttons row */}
-          <div className="flex justify-between gap-[0.5rem]">
-            <Tooltip content={t('AddStampRequest.rotation', 'Rotation')} position="top">
-              <Button
-                variant={params.parameters._activePill === 'rotation' ? 'filled' : 'outline'}
-                className="flex-1"
-                onClick={() => params.updateParameter('_activePill', 'rotation')}
-              >
-                <LocalIcon icon="rotate-right-rounded" width="1.1rem" height="1.1rem" />
-              </Button>
-            </Tooltip>
-            <Tooltip content={t('AddStampRequest.opacity', 'Opacity')} position="top">
-              <Button
-                variant={params.parameters._activePill === 'opacity' ? 'filled' : 'outline'}
-                className="flex-1"
-                onClick={() => params.updateParameter('_activePill', 'opacity')}
-              >
-                <LocalIcon icon="opacity" width="1.1rem" height="1.1rem" />
-              </Button>
-            </Tooltip>
-            <Tooltip content={params.parameters.stampType === 'image' ? t('AddStampRequest.imageSize', 'Image Size') : t('AddStampRequest.fontSize', 'Font Size')} position="top">
-              <Button
-                variant={params.parameters._activePill === 'fontSize' ? 'filled' : 'outline'}
-                className="flex-1"
-                onClick={() => params.updateParameter('_activePill', 'fontSize')}
-              >
-                <LocalIcon icon="zoom-in-map-rounded" width="1.1rem" height="1.1rem" />
-              </Button>
-            </Tooltip>
-          </div>
-
-          {/* Single slider bound to selected pill */}
-          {params.parameters._activePill === 'fontSize' && (
-            <Stack gap="xs">
-              <Text className={styles.labelText}>
-                {params.parameters.stampType === 'image' 
-                  ? t('AddStampRequest.imageSize', 'Image Size')
-                  : t('AddStampRequest.fontSize', 'Font Size')
-                }
-              </Text>
-              <Group className={styles.sliderGroup} align="center">
-                <NumberInput
-                  value={params.parameters.fontSize}
-                  onChange={(v) => params.updateParameter('fontSize', typeof v === 'number' ? v : 1)}
-                  min={1}
-                  max={400}
-                  step={1}
-                  size="sm"
-                  className={styles.numberInput}
-                  disabled={endpointLoading}
-                />
-                <Slider
-                  value={params.parameters.fontSize}
-                  onChange={(v) => params.updateParameter('fontSize', v as number)}
-                  min={1}
-                  max={400}
-                  step={1}
-                  className={styles.slider}
-                />
-              </Group>
-            </Stack>
-          )}
-          {params.parameters._activePill === 'rotation' && (
-            <Stack gap="xs">
-              <Text className={styles.labelText}>{t('AddStampRequest.rotation', 'Rotation')}</Text>
-              <Group className={styles.sliderGroup} align="center">
-                <NumberInput
-                  value={params.parameters.rotation}
-                  onChange={(v) => params.updateParameter('rotation', typeof v === 'number' ? v : 0)}
-                  min={-180}
-                  max={180}
-                  step={1}
-                  size="sm"
-                  className={styles.numberInput}
-                  hideControls
-                  disabled={endpointLoading}
-                />
-                <Slider
-                  value={params.parameters.rotation}
-                  onChange={(v) => params.updateParameter('rotation', v as number)}
-                  min={-180}
-                  max={180}
-                  step={1}
-                  className={styles.sliderWide}
-                />
-              </Group>
-            </Stack>
-          )}
-          {params.parameters._activePill === 'opacity' && (
-            <Stack gap="xs">
-              <Text className={styles.labelText}>{t('AddStampRequest.opacity', 'Opacity')}</Text>
-              <Group className={styles.sliderGroup} align="center">
-                <NumberInput
-                  value={params.parameters.opacity}
-                  onChange={(v) => params.updateParameter('opacity', typeof v === 'number' ? v : 0)}
-                  min={0}
-                  max={100}
-                  step={1}
-                  size="sm"
-                  className={styles.numberInput}
-                  disabled={endpointLoading}
-                />
-                <Slider
-                  value={params.parameters.opacity}
-                  onChange={(v) => params.updateParameter('opacity', v as number)}
-                  min={0}
-                  max={100}
-                  step={1}
-                  className={styles.slider}
-                />
-              </Group>
-            </Stack>
-          )}
-
-
-          {params.parameters.stampType !== 'image' && (
-            <ColorInput
-              label={t('AddStampRequest.customColor', 'Custom Text Color')}
-              value={params.parameters.customColor}
-              onChange={(value) => params.updateParameter('customColor', value)}
-              format="hex"
-              disabled={endpointLoading}
-            />
-          )}
-
-
-          {/* Margin selection appears when using quick grid (and for text stamps) */}
-          {(params.parameters.stampType === 'text' || (params.parameters.stampType === 'image' && quickPositionModeSelected)) && (
-            <Select
-              label={t('AddStampRequest.margin', 'Margin')}
-              value={params.parameters.customMargin}
-              onChange={(v) => params.updateParameter('customMargin', (v as any) || 'medium')}
-              data={[
-                { value: 'small', label: t('margin.small', 'Small') },
-                { value: 'medium', label: t('margin.medium', 'Medium') },
-                { value: 'large', label: t('margin.large', 'Large') },
-                { value: 'x-large', label: t('margin.xLarge', 'Extra Large') },
-              ]}
-              disabled={endpointLoading}
-            />
-          )}
-
-
-          {/* Unified preview wrapped with obscured overlay if no stamp selected in step 4 */}
-          <ObscuredOverlay
-            obscured={
-              accordion.currentStep === AddStampStep.POSITION_FORMATTING &&
-              ((params.parameters.stampType === 'text' && params.parameters.stampText.trim().length === 0) ||
-               (params.parameters.stampType === 'image' && !params.parameters.stampImage))
-            }
-            overlayMessage={
-              <Text size="sm" c="white" fw={600}>
-                {t('AddStampRequest.noStampSelected', 'No stamp selected. Return to Step 1.')}
-              </Text>
-            }
-          >
-            <StampPreview
-              parameters={params.parameters}
-              onParameterChange={params.updateParameter}
-              file={selectedFiles[0] || null}
-              showQuickGrid={params.parameters.stampType === 'text' ? true : quickPositionModeSelected}
-            />
-          </ObscuredOverlay>
-        </Stack>
-      ),
-    });
-
-    return steps;
-  };
-
-  return createToolFlow({
-    files: {
-      selectedFiles,
-      isCollapsed: hasResults,
-    },
-    steps: getSteps(),
-    executeButton: {
-      text: t('AddStampRequest.submit', 'Add Stamp'),
-      isVisible: !hasResults,
-      loadingText: t('loading'),
-      onClick: handleExecute,
-      disabled: !params.validateParameters() || !hasFiles || !endpointEnabled,
-    },
-    review: {
-      isVisible: hasResults,
-      operation: operation,
-      title: t('AddStampRequest.results.title', 'Stamp Results'),
-      onFileClick: (file) => onPreviewFile?.(file),
-      onUndo: async () => {
-        await operation.undoOperation();
-        onPreviewFile?.(null);
-      },
-    },
-  });
-};
-
-AddStamp.tool = () => useAddStampOperation;
-
-export default AddStamp as ToolComponent;
-
-
@@ -1,58 +0,0 @@
-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;
@@ -1,11 +1,10 @@
 import React, { useEffect } from "react";
 import { BaseToolProps } from "../types/tool";
-import { withBasePath } from "../constants/app";

 const SwaggerUI: React.FC<BaseToolProps> = () => {
  useEffect(() => {
    // Redirect to Swagger UI
-    window.open(withBasePath("/swagger-ui/5.21.0/index.html"), "_blank");
+    window.open("/swagger-ui/5.21.0/index.html", "_blank");
  }, []);

  return (
@@ -13,7 +12,7 @@ const SwaggerUI: React.FC<BaseToolProps> = () => {
      <p>Opening Swagger UI in a new tab...</p>
      <p>
        If it didn't open automatically,{" "}
-        <a href={withBasePath("/swagger-ui/5.21.0/index.html")} target="_blank" rel="noopener noreferrer">
+        <a href="/swagger-ui/5.21.0/index.html" target="_blank" rel="noopener noreferrer">
          click here
        </a>
      </p>
@@ -219,7 +219,6 @@ export interface FileContextState {
    isProcessing: boolean;
    processingProgress: number;
    hasUnsavedChanges: boolean;
-    errorFileIds: FileId[]; // files that errored during processing
  };
 }

@@ -242,9 +241,6 @@ export type FileContextAction =
  | { type: 'SET_SELECTED_PAGES'; payload: { pageNumbers: number[] } }
  | { type: 'CLEAR_SELECTIONS' }
  | { type: 'SET_PROCESSING'; payload: { isProcessing: boolean; progress: number } }
-  | { type: 'MARK_FILE_ERROR'; payload: { fileId: FileId } }
-  | { type: 'CLEAR_FILE_ERROR'; payload: { fileId: FileId } }
-  | { type: 'CLEAR_ALL_FILE_ERRORS' }

  // Navigation guard actions (minimal for file-related unsaved changes only)
  | { type: 'SET_UNSAVED_CHANGES'; payload: { hasChanges: boolean } }
@@ -273,9 +269,6 @@ export interface FileContextActions {
  setSelectedFiles: (fileIds: FileId[]) => void;
  setSelectedPages: (pageNumbers: number[]) => void;
  clearSelections: () => void;
-  markFileError: (fileId: FileId) => void;
-  clearFileError: (fileId: FileId) => void;
-  clearAllFileErrors: () => void;

  // Processing state - simple flags only
  setProcessing: (isProcessing: boolean, progress?: number) => void;
@@ -1,5 +1,5 @@
 // Define all possible tool IDs as source of truth
-export const TOOL_IDS = [
+const TOOL_IDS = [
  'certSign',
  'sign',
  'addPassword',
@@ -1,121 +0,0 @@
-// Lightweight fuzzy search helpers without external deps
-// Provides diacritics-insensitive normalization and Levenshtein distance scoring
-
-function normalizeText(text: string): string {
-  return text
-    .toLowerCase()
-    .normalize('NFD')
-    .replace(/\p{Diacritic}+/gu, '')
-    .trim();
-}
-
-// Basic Levenshtein distance (iterative with two rows)
-function levenshtein(a: string, b: string): number {
-  if (a === b) return 0;
-  const aLen = a.length;
-  const bLen = b.length;
-  if (aLen === 0) return bLen;
-  if (bLen === 0) return aLen;
-
-  const prev = new Array(bLen + 1);
-  const curr = new Array(bLen + 1);
-
-  for (let j = 0; j <= bLen; j++) prev[j] = j;
-
-  for (let i = 1; i <= aLen; i++) {
-    curr[0] = i;
-    const aChar = a.charCodeAt(i - 1);
-    for (let j = 1; j <= bLen; j++) {
-      const cost = aChar === b.charCodeAt(j - 1) ? 0 : 1;
-      curr[j] = Math.min(
-        prev[j] + 1, // deletion
-        curr[j - 1] + 1, // insertion
-        prev[j - 1] + cost // substitution
-      );
-    }
-    for (let j = 0; j <= bLen; j++) prev[j] = curr[j];
-  }
-  return curr[bLen];
-}
-
-// Compute a heuristic match score (higher is better)
-// 1) Exact/substring hits get high base; 2) otherwise use normalized Levenshtein distance
-export function scoreMatch(queryRaw: string, targetRaw: string): number {
-  const query = normalizeText(queryRaw);
-  const target = normalizeText(targetRaw);
-  if (!query) return 0;
-  if (target.includes(query)) {
-    // Reward earlier/shorter substring matches
-    const pos = target.indexOf(query);
-    return 100 - pos - Math.max(0, target.length - query.length);
-  }
-
-  // Token-aware: check each word token too, but require better similarity
-  const tokens = target.split(/[^a-z0-9]+/g).filter(Boolean);
-  for (const token of tokens) {
-    if (token.includes(query)) {
-      // Only give high score if the match is substantial (not just "and" matching)
-      const similarity = query.length / Math.max(query.length, token.length);
-      if (similarity >= 0.6) { // Require at least 60% similarity
-        return 80 - Math.abs(token.length - query.length);
-      }
-    }
-  }
-
-  const distance = levenshtein(query, target.length > 64 ? target.slice(0, 64) : target);
-  const maxLen = Math.max(query.length, target.length, 1);
-  const similarity = 1 - distance / maxLen; // 0..1
-  return Math.floor(similarity * 60); // scale below substring scores
-}
-
-export function minScoreForQuery(query: string): number {
-  const len = normalizeText(query).length;
-  if (len <= 3) return 40; 
-  if (len <= 6) return 30; 
-  return 25; 
-}
-
-// Decide if a target matches a query based on a threshold
-export function isFuzzyMatch(query: string, target: string, minScore?: number): boolean {
-  const threshold = typeof minScore === 'number' ? minScore : minScoreForQuery(query);
-  return scoreMatch(query, target) >= threshold;
-}
-
-// Convenience: rank a list of items by best score across provided getters
-export function rankByFuzzy<T>(items: T[], query: string, getters: Array<(item: T) => string>, minScore?: number): Array<{ item: T; score: number; matchedText?: string }>{
-  const results: Array<{ item: T; score: number; matchedText?: string }> = [];
-  const threshold = typeof minScore === 'number' ? minScore : minScoreForQuery(query);
-  for (const item of items) {
-    let best = 0;
-    let matchedText = '';
-    for (const get of getters) {
-      const value = get(item);
-      if (!value) continue;
-      const s = scoreMatch(query, value);
-      if (s > best) {
-        best = s;
-        matchedText = value;
-      }
-      if (best >= 95) {
-        break;
-      }
-    }
-    if (best >= threshold) results.push({ item, score: best, matchedText });
-  }
-  results.sort((a, b) => b.score - a.score);
-  return results;
-}
-
-export function normalizeForSearch(text: string): string {
-  return normalizeText(text);
-}
-
-// Convert ids like "addPassword", "add-password", "add_password" to words for matching
-export function idToWords(id: string): string {
-  const spaced = id
-    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
-    .replace(/[._-]+/g, ' ');
-  return normalizeText(spaced);
-}
-
-
@@ -410,7 +410,7 @@ export async function generateThumbnailWithMetadata(file: File): Promise<Thumbna
      throw new Error('Could not get canvas context');
    }

-    await page.render({ canvasContext: context, viewport, canvas }).promise;
+    await page.render({ canvasContext: context, viewport }).promise;
    const thumbnail = canvas.toDataURL();

    pdfWorkerManager.destroyDocument(pdf);
@@ -12,7 +12,7 @@ export const extractErrorMessage = (error: any): string => {
  if (error.message) {
    return error.message;
  }
-  return 'There was an error processing your request.';
+  return 'Operation failed';
 };

 /**
@@ -1,99 +0,0 @@
-import { ToolRegistryEntry } from "../data/toolsTaxonomy";
-import { scoreMatch, minScoreForQuery, normalizeForSearch } from "./fuzzySearch";
-
-export interface RankedToolItem {
-  item: [string, ToolRegistryEntry];
-  matchedText?: string;
-}
-
-export function filterToolRegistryByQuery(
-  toolRegistry: Record<string, ToolRegistryEntry>,
-  query: string
-): RankedToolItem[] {
-  const entries = Object.entries(toolRegistry);
-  if (!query.trim()) {
-    return entries.map(([id, tool]) => ({ item: [id, tool] as [string, ToolRegistryEntry] }));
-  }
-
-  const nq = normalizeForSearch(query);
-  const threshold = minScoreForQuery(query);
-
-  const exactName: Array<{ id: string; tool: ToolRegistryEntry; pos: number }> = [];
-  const exactSyn: Array<{ id: string; tool: ToolRegistryEntry; text: string; pos: number }> = [];
-  const fuzzyName: Array<{ id: string; tool: ToolRegistryEntry; score: number; text: string }> = [];
-  const fuzzySyn: Array<{ id: string; tool: ToolRegistryEntry; score: number; text: string }> = [];
-
-  for (const [id, tool] of entries) {
-    const nameNorm = normalizeForSearch(tool.name || '');
-    const pos = nameNorm.indexOf(nq);
-    if (pos !== -1) {
-      exactName.push({ id, tool, pos });
-      continue;
-    }
-
-    const syns = Array.isArray(tool.synonyms) ? tool.synonyms : [];
-    let matchedExactSyn: { text: string; pos: number } | null = null;
-    for (const s of syns) {
-      const sn = normalizeForSearch(s);
-      const sp = sn.indexOf(nq);
-      if (sp !== -1) {
-        matchedExactSyn = { text: s, pos: sp };
-        break;
-      }
-    }
-    if (matchedExactSyn) {
-      exactSyn.push({ id, tool, text: matchedExactSyn.text, pos: matchedExactSyn.pos });
-      continue;
-    }
-
-    // Fuzzy name
-    const nameScore = scoreMatch(query, tool.name || '');
-    if (nameScore >= threshold) {
-      fuzzyName.push({ id, tool, score: nameScore, text: tool.name || '' });
-    }
-
-    // Fuzzy synonyms (we'll consider these only if fuzzy name results are weak)
-    let bestSynScore = 0;
-    let bestSynText = '';
-    for (const s of syns) {
-      const synScore = scoreMatch(query, s);
-      if (synScore > bestSynScore) {
-        bestSynScore = synScore;
-        bestSynText = s;
-      }
-      if (bestSynScore >= 95) break;
-    }
-    if (bestSynScore >= threshold) {
-      fuzzySyn.push({ id, tool, score: bestSynScore, text: bestSynText });
-    }
-  }
-
-  // Sort within buckets
-  exactName.sort((a, b) => a.pos - b.pos || (a.tool.name || '').length - (b.tool.name || '').length);
-  exactSyn.sort((a, b) => a.pos - b.pos || a.text.length - b.text.length);
-  fuzzyName.sort((a, b) => b.score - a.score);
-  fuzzySyn.sort((a, b) => b.score - a.score);
-
-  // Concatenate buckets with de-duplication by tool id
-  const seen = new Set<string>();
-  const ordered: RankedToolItem[] = [];
-
-  const push = (id: string, tool: ToolRegistryEntry, matchedText?: string) => {
-    if (seen.has(id)) return;
-    seen.add(id);
-    ordered.push({ item: [id, tool], matchedText });
-  };
-
-  for (const { id, tool } of exactName) push(id, tool, tool.name);
-  for (const { id, tool, text } of exactSyn) push(id, tool, text);
-  for (const { id, tool, text } of fuzzyName) push(id, tool, text);
-  for (const { id, tool, text } of fuzzySyn) push(id, tool, text);
-
-  if (ordered.length > 0) return ordered;
-
-  // Fallback: return everything unchanged
-  return entries.map(([id, tool]) => ({ item: [id, tool] as [string, ToolRegistryEntry] }));
-}
-
-
-
@@ -1,24 +0,0 @@
-import { TFunction } from 'i18next';
-
-// Helper function to get synonyms for a tool (only from translations)
-export const getSynonyms = (t: TFunction, toolId: string): string[] => {
-  try {
-    const tagsKey = `${toolId}.tags`;
-    const tags = t(tagsKey) as unknown as string;
-
-    // If the translation key doesn't exist or returns the key itself, return empty array
-    if (!tags || tags === tagsKey) {
-      return [];
-    }
-
-    // Split by comma and clean up the tags
-    return tags
-      .split(',')
-      .map((tag: string) => tag.trim())
-      .filter((tag: string) => tag.length > 0);
-  } catch (error) {
-    console.warn(`Failed to get translated synonyms for tool ${toolId}:`, error);
-    return [];
-  }};
-
-
@@ -2,20 +2,10 @@ import { ToolId } from '../types/toolId';

 // Map URL paths to tool keys (multiple URLs can map to same tool)
 export const URL_TO_TOOL_MAP: Record<string, ToolId> = {
-  // Basic tools - standard patterns
-  '/split': 'split',
  '/split-pdfs': 'split',
-  '/merge': 'merge',
+  '/split': 'split',
  '/merge-pdfs': 'merge',
-  '/compress': 'compress',
  '/compress-pdf': 'compress',
-  '/rotate': 'rotate',
-  '/rotate-pdf': 'rotate',
-  '/repair': 'repair',
-  '/flatten': 'flatten',
-  '/crop': 'crop',
-
-  // Convert tool and all its variants
  '/convert': 'convert',
  '/convert-pdf': 'convert',
  '/file-to-pdf': 'convert',
@@ -28,101 +18,20 @@ export const URL_TO_TOOL_MAP: Record<string, ToolId> = {
  '/pdf-to-pdfa': 'convert',
  '/pdf-to-word': 'convert',
  '/pdf-to-xml': 'convert',
-
-  // Security tools
  '/add-password': 'addPassword',
-  '/remove-password': 'removePassword',
  '/change-permissions': 'changePermissions',
-  '/cert-sign': 'certSign',
-  '/manage-signatures': 'certSign',
-  '/remove-certificate-sign': 'removeCertSign',
-  '/remove-cert-sign': 'removeCertSign',
-  '/unlock-pdf-forms': 'unlockPDFForms',
-  '/validate-signature': 'validateSignature',
-  '/manage-certificates': 'manageCertificates',
-
-  // Content manipulation
-  '/sanitize': 'sanitize',
  '/sanitize-pdf': 'sanitize',
  '/ocr': 'ocr',
  '/ocr-pdf': 'ocr',
-  '/watermark': 'watermark',
  '/add-watermark': 'watermark',
-  '/add-image': 'addImage',
-  '/add-stamp': 'addStamp',
-  '/add-page-numbers': 'addPageNumbers',
-  '/redact': 'redact',
-
-  // Page manipulation
-  '/remove-pages': 'removePages',
-  '/remove-blanks': 'removeBlanks',
-  '/extract-pages': 'extractPages',
-  '/reorganize-pages': 'reorganizePages',
+  '/remove-password': 'removePassword',
  '/single-large-page': 'pdfToSinglePage',
-  '/page-layout': 'pageLayout',
-  '/scale-pages': 'scalePages',
+  '/repair': 'repair',
+  '/rotate-pdf': 'rotate',
+  '/unlock-pdf-forms': 'unlockPDFForms',
+  '/remove-certificate-sign': 'removeCertSign',
+  '/remove-cert-sign': 'removeCertSign',
+  '/cert-sign': 'certSign',
+  '/manage-signatures': 'certSign',
  '/booklet-imposition': 'bookletImposition',
-
-  // Splitting tools
-  '/auto-split-pdf': 'autoSplitPDF',
-  '/auto-size-split-pdf': 'autoSizeSplitPDF',
-  '/scanner-image-split': 'scannerImageSplit',
-
-  // Annotation and content removal
-  '/remove-annotations': 'removeAnnotations',
-  '/remove-image': 'removeImage',
-
-  // Image and visual tools
-  '/extract-images': 'extractImages',
-  '/adjust-contrast': 'adjustContrast',
-  '/fake-scan': 'fakeScan',
-  '/replace-color-pdf': 'replaceColorPdf',
-
-  // Metadata and info
-  '/change-metadata': 'changeMetadata',
-  '/get-pdf-info': 'getPdfInfo',
-  '/add-attachments': 'addAttachments',
-
-  // Advanced tools
-  '/overlay-pdfs': 'overlayPdfs',
-  '/edit-table-of-contents': 'editTableOfContents',
-  '/auto-rename': 'autoRename',
-  '/compare': 'compare',
-  '/multi-tool': 'multiTool',
-  '/show-js': 'showJS',
-
-  // Special/utility tools
-  '/read': 'read',
-  '/automate': 'automate',
-  '/sign': 'sign',
-
-  // Developer tools
-  '/dev-api': 'devApi',
-  '/dev-folder-scanning': 'devFolderScanning',
-  '/dev-sso-guide': 'devSsoGuide',
-  '/dev-airgapped': 'devAirgapped',
-
-  // Legacy URL mappings from sitemap
-  '/pdf-organizer': 'reorganizePages',
-  '/multi-page-layout': 'pageLayout',
-  '/extract-page': 'extractPages',
-  '/pdf-to-single-page': 'pdfToSinglePage',
-  '/img-to-pdf': 'convert',
-  '/pdf-to-presentation': 'convert',
-  '/pdf-to-text': 'convert',
-  '/pdf-to-html': 'convert',
-  '/auto-redact': 'redact',
-  '/stamp': 'addStamp',
-  '/view-pdf': 'read',
-  '/get-info-on-pdf': 'getPdfInfo',
-  '/remove-image-pdf': 'removeImage',
-  '/replace-and-invert-color-pdf': 'replaceColorPdf',
-  '/pipeline': 'automate',
-  '/extract-image-scans': 'scannerImageSplit',
-  '/show-javascript': 'showJS',
-  '/scanner-effect': 'fakeScan',
-  '/split-by-size-or-count': 'autoSizeSplitPDF',
-  '/overlay-pdf': 'overlayPdfs',
-  '/split-pdf-by-sections': 'autoSplitPDF',
-  '/split-pdf-by-chapters': 'autoSplitPDF',
 };
@@ -8,17 +8,12 @@ import { getDefaultWorkbench } from '../types/workbench';
 import { ToolRegistry, getToolWorkbench, getToolUrlPath } from '../data/toolsTaxonomy';
 import { firePixel } from './scarfTracking';
 import { URL_TO_TOOL_MAP } from './urlMapping';
-import { BASE_PATH, withBasePath } from '../constants/app';

 /**
 * Parse the current URL to extract tool routing information
 */
 export function parseToolRoute(registry: ToolRegistry): ToolRoute {
-  const fullPath = window.location.pathname;
-  // Remove base path to get app-relative path
-  const path = BASE_PATH && fullPath.startsWith(BASE_PATH)
-    ? fullPath.slice(BASE_PATH.length) || '/'
-    : fullPath;
+  const path = window.location.pathname;
  const searchParams = new URLSearchParams(window.location.search);

  // First, check URL mapping for multiple URL aliases
@@ -88,8 +83,7 @@ export function updateToolRoute(toolId: ToolId, registry: ToolRegistry, replace:
    return;
  }

-  const toolPath = getToolUrlPath(toolId, tool);
-  const newPath = withBasePath(toolPath);
+  const newPath = getToolUrlPath(toolId, tool);
  const searchParams = new URLSearchParams(window.location.search);

  // Remove tool query parameter since we're using path-based routing
@@ -105,7 +99,7 @@ export function clearToolRoute(replace: boolean = false): void {
  const searchParams = new URLSearchParams(window.location.search);
  searchParams.delete('tool');

-  updateUrl(withBasePath('/'), searchParams, replace);
+  updateUrl('/', searchParams, replace);
 }

 /**
@@ -123,12 +117,11 @@ export function generateShareableUrl(toolId: ToolId | null, registry: ToolRegist
  const baseUrl = window.location.origin;

  if (!toolId || !registry[toolId]) {
-    return `${baseUrl}${BASE_PATH || ''}`;
+    return baseUrl;
  }

  const tool = registry[toolId];

-  const toolPath = getToolUrlPath(toolId, tool);
-  const fullPath = withBasePath(toolPath);
-  return `${baseUrl}${fullPath}`;
+  const path = getToolUrlPath(toolId, tool);
+  return `${baseUrl}${path}`;
 }
@@ -22,42 +22,6 @@ module.exports = {
          800: 'rgb(var(--gray-800) / <alpha-value>)',
          900: 'rgb(var(--gray-900) / <alpha-value>)',
        },
-        green: {
-          50: 'var(--color-green-50)',
-          100: 'var(--color-green-100)',
-          200: 'var(--color-green-200)',
-          300: 'var(--color-green-300)',
-          400: 'var(--color-green-400)',
-          500: 'var(--color-green-500)',
-          600: 'var(--color-green-600)',
-          700: 'var(--color-green-700)',
-          800: 'var(--color-green-800)',
-          900: 'var(--color-green-900)',
-        },
-        yellow: {
-          50: 'var(--color-yellow-50)',
-          100: 'var(--color-yellow-100)',
-          200: 'var(--color-yellow-200)',
-          300: 'var(--color-yellow-300)',
-          400: 'var(--color-yellow-400)',
-          500: 'var(--color-yellow-500)',
-          600: 'var(--color-yellow-600)',
-          700: 'var(--color-yellow-700)',
-          800: 'var(--color-yellow-800)',
-          900: 'var(--color-yellow-900)',
-        },
-        red: {
-          50: 'var(--color-red-50)',
-          100: 'var(--color-red-100)',
-          200: 'var(--color-red-200)',
-          300: 'var(--color-red-300)',
-          400: 'var(--color-red-400)',
-          500: 'var(--color-red-500)',
-          600: 'var(--color-red-600)',
-          700: 'var(--color-red-700)',
-          800: 'var(--color-red-800)',
-          900: 'var(--color-red-900)',
-        },
        // Custom semantic colors for app-specific usage
        surface: 'rgb(var(--surface) / <alpha-value>)',
        background: 'rgb(var(--background) / <alpha-value>)',
@@ -1,5 +1,5 @@
 import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react-swc';
+import react from '@vitejs/plugin-react';

 export default defineConfig({
  plugins: [react()],
@@ -12,5 +12,5 @@ export default defineConfig({
      },
    },
  },
-  base: process.env.RUN_SUBPATH ? `/${process.env.RUN_SUBPATH}` : './',
+  base: "./",
 });
@@ -1,5 +1,5 @@
 import { defineConfig } from 'vitest/config'
-import react from '@vitejs/plugin-react-swc';
+import react from '@vitejs/plugin-react'

 export default defineConfig({
  plugins: [react()],
@@ -37,4 +37,4 @@ export default defineConfig({
      '@': '/src'
    }
  }
-})
+})
@@ -1,403 +0,0 @@
-# Translation Management Scripts
-
-This directory contains Python scripts for managing frontend translations in Stirling PDF. These tools help analyze, merge, and manage translations against the en-GB golden truth file.
-
-## Scripts Overview
-
-### 1. `translation_analyzer.py`
-Analyzes translation files to find missing translations, untranslated entries, and provides completion statistics.
-
-**Usage:**
-```bash
-# Analyze all languages
-python scripts/translations/translation_analyzer.py
-
-# Analyze specific language
-python scripts/translations/translation_analyzer.py --language fr-FR
-
-# Show only missing translations
-python scripts/translations/translation_analyzer.py --missing-only
-
-# Show only untranslated entries
-python scripts/translations/translation_analyzer.py --untranslated-only
-
-# Show summary only
-python scripts/translations/translation_analyzer.py --summary
-
-# JSON output format
-python scripts/translations/translation_analyzer.py --format json
-```
-
-**Features:**
- Finds missing translation keys
- Identifies untranslated entries (identical to en-GB and [UNTRANSLATED] markers)
- Shows accurate completion percentages using ignore patterns
- Identifies extra keys not in en-GB
- Supports JSON and text output formats
- Uses `scripts/ignore_translation.toml` for language-specific exclusions
-
-### 2. `translation_merger.py`
-Merges missing translations from en-GB into target language files and manages translation workflows.
-
-**Usage:**
-```bash
-# Add missing translations from en-GB to French
-python scripts/translations/translation_merger.py fr-FR add-missing
-
-# Add without marking as [UNTRANSLATED]
-python scripts/translations/translation_merger.py fr-FR add-missing --no-mark-untranslated
-
-# Extract untranslated entries to a file
-python scripts/translations/translation_merger.py fr-FR extract-untranslated --output fr_untranslated.json
-
-# Create a template for AI translation
-python scripts/translations/translation_merger.py fr-FR create-template --output fr_template.json
-
-# Apply translations from a file
-python scripts/translations/translation_merger.py fr-FR apply-translations --translations-file fr_translated.json
-```
-
-**Features:**
- Adds missing keys from en-GB with optional [UNTRANSLATED] markers
- Extracts untranslated entries for external translation
- Creates structured templates for AI translation
- Applies translated content back to language files
- Automatic backup creation
-
-### 3. `ai_translation_helper.py`
-Specialized tool for AI-assisted translation workflows with batch processing and validation.
-
-**Usage:**
-```bash
-# Create batch file for AI translation (multiple languages)
-python scripts/translations/ai_translation_helper.py create-batch --languages fr-FR de-DE es-ES --output batch.json --max-entries 50
-
-# Validate AI translations
-python scripts/translations/ai_translation_helper.py validate batch.json
-
-# Apply validated AI translations
-python scripts/translations/ai_translation_helper.py apply-batch batch.json
-
-# Export for external translation services
-python scripts/translations/ai_translation_helper.py export --languages fr-FR de-DE --format csv
-```
-
-**Features:**
- Creates batch files for AI translation of multiple languages
- Prioritizes important translation keys
- Validates translations for placeholders and artifacts
- Applies batch translations with validation
- Exports to CSV/JSON for external translation services
-
-### 4. `compact_translator.py`
-Extracts untranslated entries in minimal JSON format for character-limited AI services.
-
-**Usage:**
-```bash
-# Extract all untranslated entries
-python scripts/translations/compact_translator.py it-IT --output to_translate.json
-```
-
-**Features:**
- Produces minimal JSON output with no extra whitespace
- Automatic ignore patterns for cleaner output
- Batch size control for manageable chunks
- 50-80% fewer characters than other extraction methods
-
-### 5. `json_beautifier.py`
-Restructures and beautifies translation JSON files to match en-GB structure exactly.
-
-**Usage:**
-```bash
-# Restructure single language to match en-GB structure
-python scripts/translations/json_beautifier.py --language de-DE
-
-# Restructure all languages
-python scripts/translations/json_beautifier.py --all-languages
-
-# Validate structure without modifying files
-python scripts/translations/json_beautifier.py --language de-DE --validate-only
-
-# Skip backup creation
-python scripts/translations/json_beautifier.py --language de-DE --no-backup
-```
-
-**Features:**
- Restructures JSON to match en-GB nested structure exactly
- Preserves key ordering for line-by-line comparison
- Creates automatic backups before modification
- Validates structure and key ordering
- Handles flattened dot-notation keys (e.g., "key.subkey") properly
-
-## Translation Workflows
-
-### Method 1: Compact Translation Workflow (RECOMMENDED for AI)
-
-**Best for character-limited AI services like Claude or ChatGPT**
-
-#### Step 1: Check Current Status
-```bash
-python scripts/translations/translation_analyzer.py --language it-IT --summary
-```
-
-#### Step 2: Extract Untranslated Entries
-```bash
-python scripts/translations/compact_translator.py it-IT --output to_translate.json
-```
-
-**Output format**: Compact JSON with minimal whitespace
-```json
-{"key1":"English text","key2":"Another text","key3":"More text"}
-```
-
-#### Step 3: AI Translation
-1. Copy the compact JSON output
-2. Give it to your AI with instructions:
-   ```
-   Translate this JSON to Italian. Keep the same structure, translate only the values.
-   Preserve placeholders like {n}, {total}, {filename}, {{variable}}.
-   ```
-3. Save the AI's response as `translated.json`
-
-#### Step 4: Apply Translations
-```bash
-python scripts/translations/translation_merger.py it-IT apply-translations --translations-file translated.json
-```
-
-#### Step 5: Verify Results
-```bash
-python scripts/translations/translation_analyzer.py --language it-IT --summary
-```
-
-### Method 2: Batch Translation Workflow
-
-**For complete language translation from scratch or major updates**
-
-#### Step 1: Analyze Current State
-```bash
-python scripts/translations/translation_analyzer.py --language de-DE --summary
-```
-
-#### Step 2: Create Translation Batches
-```bash
-# Create batches of 100 entries each for systematic translation
-python scripts/translations/ai_translation_helper.py create-batch --languages de-DE --output de_batch_1.json --max-entries 100
-```
-
-#### Step 3: Translate Batch with AI
-Edit the batch file and fill in ALL `translated` fields:
- Preserve all placeholders like `{n}`, `{total}`, `{filename}`, `{{toolName}}`
- Keep technical terms consistent
- Maintain JSON structure exactly
- Consider context provided for each entry
-
-#### Step 4: Apply Translations
-```bash
-# Skip validation if using legitimate placeholders ({{variable}})
-python scripts/translations/ai_translation_helper.py apply-batch de_batch_1.json --skip-validation
-```
-
-#### Step 5: Check Progress and Continue
-```bash
-python scripts/translations/translation_analyzer.py --language de-DE --summary
-```
-Repeat steps 2-5 until 100% complete.
-
-### Method 3: Quick Translation Workflow (Legacy)
-
-**For small updates or existing translations**
-
-#### Step 1: Add Missing Translations
-```bash
-python scripts/translations/translation_merger.py fr-FR add-missing --mark-untranslated
-```
-
-#### Step 2: Create AI Template
-```bash
-python scripts/translations/translation_merger.py fr-FR create-template --output fr_template.json
-```
-
-#### Step 3: Apply Translations
-```bash
-python scripts/translations/translation_merger.py fr-FR apply-translations --translations-file fr_translated.json
-```
-
-## Translation File Structure
-
-Translation files are located in `frontend/public/locales/{language}/translation.json` with nested JSON structure:
-
-```json
-{
-  "addPageNumbers": {
-    "title": "Add Page Numbers",
-    "selectText": {
-      "1": "Select PDF file:",
-      "2": "Margin Size"
-    }
-  }
-}
-```
-
-Keys use dot notation internally (e.g., `addPageNumbers.selectText.1`).
-
-## Key Features
-
-### Placeholder Preservation
-All scripts preserve placeholders like `{n}`, `{total}`, `{filename}` in translations:
-```
-"customNumberDesc": "Defaults to {n}, also accepts 'Page {n} of {total}'"
-```
-
-### Automatic Backups
-Scripts create timestamped backups before modifying files:
-```
-translation.backup.20241201_143022.json
-```
-
-### Context-Aware Translation
-Scripts provide context information to help with accurate translations:
-```json
-{
-  "addPageNumbers.title": {
-    "original": "Add Page Numbers",
-    "context": "Feature for adding page numbers to PDFs"
-  }
-}
-```
-
-### Priority-Based Translation
-Important keys (title, submit, error messages) are prioritized when limiting translation batch sizes.
-
-### Ignore Patterns System
-The `scripts/ignore_translation.toml` file defines keys that should be ignored for each language, improving completion accuracy.
-
-**Common ignore patterns:**
- `language.direction`: Text direction (ltr/rtl) - universal
- `lang.*`: Language code entries not relevant to specific locales
- `pipeline.title`, `home.devApi.title`: Technical terms kept in English
- Specific technical IDs, version numbers, and system identifiers
-
-**Format:**
-```toml
-[de_DE]
-ignore = [
-    'language.direction',
-    'pipeline.title',
-    'lang.afr',
-    'lang.ceb',
-    # ... more patterns
-]
-```
-
-## Best Practices & Lessons Learned
-
-### Critical Rules for Translation
-
-1. **NEVER skip entries**: Translate ALL entries in each batch to avoid [UNTRANSLATED] pollution
-2. **Use appropriate batch sizes**: 100 entries for systematic translation, unlimited for compact method
-3. **Skip validation for placeholders**: Use `--skip-validation` when batch contains `{{variable}}` patterns
-4. **Check progress between batches**: Use `--summary` flag to track completion percentage
-5. **Preserve all placeholders**: Keep `{n}`, `{total}`, `{filename}`, `{{toolName}}` exactly as-is
-
-### Workflow Comparison
-
-| Method | Best For | Character Usage | Complexity | Speed |
-|--------|----------|----------------|------------|-------|
-| Compact | AI services | Minimal (50-80% less) | Simple | Fastest |
-| Batch | Systematic translation | Moderate | Medium | Medium |
-| Quick | Small updates | High | Low | Slow |
-
-### Common Issues and Solutions
-
-#### [UNTRANSLATED] Pollution
-**Problem**: Hundreds of [UNTRANSLATED] markers from incomplete translation attempts
-**Solution**:
- Only translate complete batches of manageable size
- Use analyzer that counts [UNTRANSLATED] as missing translations
- Restore from backup if pollution occurs
-
-#### Validation False Positives
-**Problem**: Validator flags legitimate `{{variable}}` placeholders as artifacts
-**Solution**: Use `--skip-validation` flag when applying batches with template variables
-
-#### JSON Structure Mismatches
-**Problem**: Flattened dot-notation keys instead of proper nested objects
-**Solution**: Use `json_beautifier.py` to restructure files to match en-GB exactly
-
-## Real-World Examples
-
-### Complete Italian Translation (Compact Method)
-```bash
-# Check status
-python scripts/translations/translation_analyzer.py --language it-IT --summary
-# Result: 46.8% complete, 1147 missing
-
-# Extract all entries for translation
-python scripts/translations/compact_translator.py it-IT --output batch1.json
-
-# [Translate batch1.json with AI, save as batch1_translated.json]
-
-# Apply translations
-python scripts/translations/translation_merger.py it-IT apply-translations --translations-file batch1_translated.json
-# Result: Applied 1147 translations
-
-# Check progress
-python scripts/translations/translation_analyzer.py --language it-IT --summary
-# Result: 100% complete, 0 missing
-```
-
-### German Translation (Batch Method)
-Starting from 46.3% completion, reaching 60.3% with batch method:
-
-```bash
-# Initial analysis
-python scripts/translations/translation_analyzer.py --language de-DE --summary
-# Result: 46.3% complete, 1142 missing entries
-
-# Batch 1 (100 entries)
-python scripts/translations/ai_translation_helper.py create-batch --languages de-DE --output de_batch_1.json --max-entries 100
-# [Translate all 100 entries in batch file]
-python scripts/translations/ai_translation_helper.py apply-batch de_batch_1.json --skip-validation
-# Progress: 46.6% → 51.2%
-
-# Continue with more batches until 100% complete
-```
-
-## Error Handling
-
- **Missing Files**: Scripts create new files when language directories don't exist
- **Invalid JSON**: Clear error messages with line numbers
- **Placeholder Mismatches**: Validation warnings for missing or extra placeholders
- **[UNTRANSLATED] Entries**: Counted as missing translations to prevent pollution
- **Backup Failures**: Graceful handling with user notification
-
-## Integration with Development
-
-These scripts integrate with the existing translation system:
- Works with the current `frontend/public/locales/` structure
- Compatible with the i18n system used in the React frontend
- Respects the JSON format expected by the translation loader
- Maintains the nested structure required by the UI components
-
-## Language-Specific Notes
-
-### German Translation Notes
- Technical terms: Use German equivalents (PDF → PDF, API → API)
- UI actions: "hochladen" (upload), "herunterladen" (download), "speichern" (save)
- Error messages: Consistent pattern "Ein Fehler ist beim [action] aufgetreten"
- Formal address: Use "Sie" form for user-facing text
-
-### Italian Translation Notes
- Keep technical terms in English when commonly used (PDF, API, URL)
- Use formal address ("Lei" form) for user-facing text
- Error messages: "Si è verificato un errore durante [action]"
- UI actions: "carica" (upload), "scarica" (download), "salva" (save)
-
-## Common Use Cases
-
-1. **Complete Language Translation**: Use Compact Workflow for fastest AI-assisted translation
-2. **New Language Addition**: Start with compact workflow for comprehensive coverage
-3. **Updating Existing Language**: Use analyzer to find gaps, then compact or batch method
-4. **Quality Assurance**: Use analyzer with `--summary` for completion metrics and issue detection
-5. **External Translation Services**: Use export functionality to generate CSV files for translators
-6. **Structure Maintenance**: Use json_beautifier to keep files aligned with en-GB structure
@@ -1,408 +0,0 @@
-#!/usr/bin/env python3
-"""
-AI Translation Helper for Stirling PDF Frontend
-Provides utilities for AI-assisted translation workflows including
-batch processing, quality checks, and integration helpers.
-"""
-
-import json
-import os
-import sys
-from pathlib import Path
-from typing import Dict, List, Set, Tuple, Any, Optional
-import argparse
-import re
-from datetime import datetime
-import csv
-
-
-class AITranslationHelper:
-    def __init__(self, locales_dir: str = "frontend/public/locales"):
-        self.locales_dir = Path(locales_dir)
-        self.golden_truth_file = self.locales_dir / "en-GB" / "translation.json"
-
-    def _load_json(self, file_path: Path) -> Dict:
-        """Load JSON file with error handling."""
-        try:
-            with open(file_path, 'r', encoding='utf-8') as f:
-                return json.load(f)
-        except (FileNotFoundError, json.JSONDecodeError) as e:
-            print(f"Error loading {file_path}: {e}")
-            return {}
-
-    def _save_json(self, data: Dict, file_path: Path) -> None:
-        """Save JSON file."""
-        with open(file_path, 'w', encoding='utf-8') as f:
-            json.dump(data, f, indent=2, ensure_ascii=False)
-
-    def create_ai_batch_file(self, languages: List[str], output_file: Path,
-                            max_entries_per_language: int = 50) -> None:
-        """Create a batch file for AI translation with multiple languages."""
-        golden_truth = self._load_json(self.golden_truth_file)
-        batch_data = {
-            'metadata': {
-                'created_at': datetime.now().isoformat(),
-                'source_language': 'en-GB',
-                'target_languages': languages,
-                'max_entries_per_language': max_entries_per_language,
-                'instructions': {
-                    'format': 'Translate each entry maintaining JSON structure and placeholder variables like {n}, {total}, {filename}',
-                    'context': 'This is for a PDF manipulation tool. Keep technical terms consistent.',
-                    'placeholders': 'Preserve all placeholders: {n}, {total}, {filename}, etc.',
-                    'style': 'Keep translations concise and user-friendly'
-                }
-            },
-            'translations': {}
-        }
-
-        for lang in languages:
-            lang_file = self.locales_dir / lang / "translation.json"
-            if not lang_file.exists():
-                # Create empty translation structure
-                lang_data = {}
-            else:
-                lang_data = self._load_json(lang_file)
-
-            # Find untranslated entries
-            untranslated = self._find_untranslated_entries(golden_truth, lang_data)
-
-            # Limit entries if specified
-            if max_entries_per_language and len(untranslated) > max_entries_per_language:
-                # Prioritize by key importance
-                untranslated = self._prioritize_translation_keys(untranslated, max_entries_per_language)
-
-            batch_data['translations'][lang] = {}
-            for key, value in untranslated.items():
-                batch_data['translations'][lang][key] = {
-                    'original': value,
-                    'translated': '',  # AI fills this
-                    'context': self._get_key_context(key)
-                }
-
-        self._save_json(batch_data, output_file)
-        total_entries = sum(len(lang_data) for lang_data in batch_data['translations'].values())
-        print(f"Created AI batch file: {output_file}")
-        print(f"Total entries to translate: {total_entries}")
-
-    def _find_untranslated_entries(self, golden_truth: Dict, lang_data: Dict) -> Dict[str, str]:
-        """Find entries that need translation."""
-        golden_flat = self._flatten_dict(golden_truth)
-        lang_flat = self._flatten_dict(lang_data)
-
-        untranslated = {}
-        for key, value in golden_flat.items():
-            if (key not in lang_flat or
-                lang_flat[key] == value or
-                (isinstance(lang_flat[key], str) and lang_flat[key].startswith("[UNTRANSLATED]"))):
-                if not self._is_expected_identical(key, value):
-                    untranslated[key] = value
-
-        return untranslated
-
-    def _flatten_dict(self, d: Dict, parent_key: str = '', separator: str = '.') -> Dict[str, Any]:
-        """Flatten nested dictionary."""
-        items = []
-        for k, v in d.items():
-            new_key = f"{parent_key}{separator}{k}" if parent_key else k
-            if isinstance(v, dict):
-                items.extend(self._flatten_dict(v, new_key, separator).items())
-            else:
-                items.append((new_key, v))
-        return dict(items)
-
-    def _is_expected_identical(self, key: str, value: str) -> bool:
-        """Check if key should be identical across languages."""
-        if str(value).strip() in ['ltr', 'rtl', 'True', 'False', 'true', 'false']:
-            return True
-        return 'language.direction' in key.lower()
-
-    def _prioritize_translation_keys(self, untranslated: Dict[str, str], max_count: int) -> Dict[str, str]:
-        """Prioritize which keys to translate first based on importance."""
-        # Define priority order (higher score = higher priority)
-        priority_patterns = [
-            ('title', 10),
-            ('header', 9),
-            ('submit', 8),
-            ('selectText', 7),
-            ('prompt', 6),
-            ('desc', 5),
-            ('error', 8),
-            ('warning', 7),
-            ('save', 8),
-            ('download', 8),
-            ('upload', 7),
-        ]
-
-        scored_keys = []
-        for key, value in untranslated.items():
-            score = 1  # base score
-            for pattern, pattern_score in priority_patterns:
-                if pattern.lower() in key.lower():
-                    score = max(score, pattern_score)
-            scored_keys.append((key, value, score))
-
-        # Sort by score (descending) and return top entries
-        scored_keys.sort(key=lambda x: x[2], reverse=True)
-        return {key: value for key, value, _ in scored_keys[:max_count]}
-
-    def _get_key_context(self, key: str) -> str:
-        """Get contextual information for a translation key."""
-        parts = key.split('.')
-        contexts = {
-            'addPageNumbers': 'Feature for adding page numbers to PDFs',
-            'compress': 'PDF compression functionality',
-            'merge': 'PDF merging functionality',
-            'split': 'PDF splitting functionality',
-            'rotate': 'PDF rotation functionality',
-            'convert': 'File conversion functionality',
-            'security': 'PDF security and permissions',
-            'metadata': 'PDF metadata editing',
-            'watermark': 'Adding watermarks to PDFs',
-            'overlay': 'PDF overlay functionality',
-            'extract': 'Extracting content from PDFs'
-        }
-
-        if len(parts) > 0:
-            main_section = parts[0]
-            context = contexts.get(main_section, f'Part of {main_section} functionality')
-            if len(parts) > 1:
-                context += f', specifically for {parts[-1]}'
-            return context
-
-        return 'General application text'
-
-    def validate_ai_translations(self, batch_file: Path) -> Dict[str, List[str]]:
-        """Validate AI translations for common issues."""
-        batch_data = self._load_json(batch_file)
-        issues = {'errors': [], 'warnings': []}
-
-        for lang, translations in batch_data.get('translations', {}).items():
-            for key, translation_data in translations.items():
-                original = translation_data.get('original', '')
-                translated = translation_data.get('translated', '')
-
-                if not translated:
-                    issues['errors'].append(f"{lang}.{key}: Missing translation")
-                    continue
-
-                # Check for placeholder preservation
-                original_placeholders = re.findall(r'\{[^}]+\}', original)
-                translated_placeholders = re.findall(r'\{[^}]+\}', translated)
-
-                if set(original_placeholders) != set(translated_placeholders):
-                    issues['warnings'].append(
-                        f"{lang}.{key}: Placeholder mismatch - Original: {original_placeholders}, "
-                        f"Translated: {translated_placeholders}"
-                    )
-
-                # Check if translation is identical to original (might be untranslated)
-                if translated == original and not self._is_expected_identical(key, original):
-                    issues['warnings'].append(f"{lang}.{key}: Translation identical to original")
-
-                # Check for common AI translation artifacts
-                artifacts = ['[TRANSLATE]', '[TODO]', 'UNTRANSLATED', '{{', '}}']
-                for artifact in artifacts:
-                    if artifact in translated:
-                        issues['errors'].append(f"{lang}.{key}: Contains translation artifact: {artifact}")
-
-        return issues
-
-    def apply_ai_batch_translations(self, batch_file: Path, validate: bool = True) -> Dict[str, Any]:
-        """Apply translations from AI batch file to individual language files."""
-        batch_data = self._load_json(batch_file)
-        results = {'applied': {}, 'errors': [], 'warnings': []}
-
-        if validate:
-            validation_issues = self.validate_ai_translations(batch_file)
-            if validation_issues['errors']:
-                print("Validation errors found. Fix these before applying:")
-                for error in validation_issues['errors']:
-                    print(f"  ERROR: {error}")
-                return results
-
-            if validation_issues['warnings']:
-                print("Validation warnings (review recommended):")
-                for warning in validation_issues['warnings'][:10]:
-                    print(f"  WARNING: {warning}")
-
-        for lang, translations in batch_data.get('translations', {}).items():
-            lang_file = self.locales_dir / lang / "translation.json"
-
-            # Load existing data or create new
-            if lang_file.exists():
-                lang_data = self._load_json(lang_file)
-            else:
-                lang_data = {}
-                lang_file.parent.mkdir(parents=True, exist_ok=True)
-
-            applied_count = 0
-            for key, translation_data in translations.items():
-                translated = translation_data.get('translated', '').strip()
-                if translated and translated != translation_data.get('original', ''):
-                    self._set_nested_value(lang_data, key, translated)
-                    applied_count += 1
-
-            if applied_count > 0:
-                self._save_json(lang_data, lang_file)
-                results['applied'][lang] = applied_count
-                print(f"Applied {applied_count} translations to {lang}")
-
-        return results
-
-    def _set_nested_value(self, data: Dict, key_path: str, value: Any) -> None:
-        """Set value in nested dict using dot notation."""
-        keys = key_path.split('.')
-        current = data
-        for key in keys[:-1]:
-            if key not in current:
-                current[key] = {}
-            elif not isinstance(current[key], dict):
-                # If the current value is not a dict, we can't nest into it
-                print(f"Warning: Converting non-dict value at '{key}' to dict to allow nesting")
-                current[key] = {}
-            current = current[key]
-        current[keys[-1]] = value
-
-    def export_for_external_translation(self, languages: List[str], output_format: str = 'csv') -> None:
-        """Export translations for external translation services."""
-        golden_truth = self._load_json(self.golden_truth_file)
-        golden_flat = self._flatten_dict(golden_truth)
-
-        if output_format == 'csv':
-            output_file = Path(f'translations_export_{datetime.now().strftime("%Y%m%d")}.csv')
-
-            with open(output_file, 'w', newline='', encoding='utf-8') as csvfile:
-                fieldnames = ['key', 'context', 'en_GB'] + languages
-                writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
-                writer.writeheader()
-
-                for key, en_value in golden_flat.items():
-                    if self._is_expected_identical(key, en_value):
-                        continue
-
-                    row = {
-                        'key': key,
-                        'context': self._get_key_context(key),
-                        'en_GB': en_value
-                    }
-
-                    for lang in languages:
-                        lang_file = self.locales_dir / lang / "translation.json"
-                        if lang_file.exists():
-                            lang_data = self._load_json(lang_file)
-                            lang_flat = self._flatten_dict(lang_data)
-                            value = lang_flat.get(key, '')
-                            if value.startswith('[UNTRANSLATED]'):
-                                value = ''
-                            row[lang] = value
-                        else:
-                            row[lang] = ''
-
-                    writer.writerow(row)
-
-            print(f"Exported to {output_file}")
-
-        elif output_format == 'json':
-            output_file = Path(f'translations_export_{datetime.now().strftime("%Y%m%d")}.json')
-            export_data = {'languages': languages, 'translations': {}}
-
-            for key, en_value in golden_flat.items():
-                if self._is_expected_identical(key, en_value):
-                    continue
-
-                export_data['translations'][key] = {
-                    'en_GB': en_value,
-                    'context': self._get_key_context(key)
-                }
-
-                for lang in languages:
-                    lang_file = self.locales_dir / lang / "translation.json"
-                    if lang_file.exists():
-                        lang_data = self._load_json(lang_file)
-                        lang_flat = self._flatten_dict(lang_data)
-                        value = lang_flat.get(key, '')
-                        if value.startswith('[UNTRANSLATED]'):
-                            value = ''
-                        export_data['translations'][key][lang] = value
-
-            self._save_json(export_data, output_file)
-            print(f"Exported to {output_file}")
-
-
-def main():
-    parser = argparse.ArgumentParser(description='AI Translation Helper')
-    parser.add_argument('--locales-dir', default='frontend/public/locales',
-                        help='Path to locales directory')
-
-    subparsers = parser.add_subparsers(dest='command', help='Available commands')
-
-    # Create batch command
-    batch_parser = subparsers.add_parser('create-batch', help='Create AI translation batch file')
-    batch_parser.add_argument('--languages', nargs='+', required=True,
-                             help='Language codes to include')
-    batch_parser.add_argument('--output', required=True, help='Output batch file')
-    batch_parser.add_argument('--max-entries', type=int, default=100,
-                             help='Max entries per language')
-
-    # Validate command
-    validate_parser = subparsers.add_parser('validate', help='Validate AI translations')
-    validate_parser.add_argument('batch_file', help='Batch file to validate')
-
-    # Apply command
-    apply_parser = subparsers.add_parser('apply-batch', help='Apply AI batch translations')
-    apply_parser.add_argument('batch_file', help='Batch file with translations')
-    apply_parser.add_argument('--skip-validation', action='store_true',
-                             help='Skip validation before applying')
-
-    # Export command
-    export_parser = subparsers.add_parser('export', help='Export for external translation')
-    export_parser.add_argument('--languages', nargs='+', required=True,
-                              help='Language codes to export')
-    export_parser.add_argument('--format', choices=['csv', 'json'], default='csv',
-                              help='Export format')
-
-    args = parser.parse_args()
-
-    if not args.command:
-        parser.print_help()
-        return
-
-    helper = AITranslationHelper(args.locales_dir)
-
-    if args.command == 'create-batch':
-        output_file = Path(args.output)
-        helper.create_ai_batch_file(args.languages, output_file, args.max_entries)
-
-    elif args.command == 'validate':
-        batch_file = Path(args.batch_file)
-        issues = helper.validate_ai_translations(batch_file)
-
-        if issues['errors']:
-            print("ERRORS:")
-            for error in issues['errors']:
-                print(f"  - {error}")
-
-        if issues['warnings']:
-            print("WARNINGS:")
-            for warning in issues['warnings']:
-                print(f"  - {warning}")
-
-        if not issues['errors'] and not issues['warnings']:
-            print("No validation issues found!")
-
-    elif args.command == 'apply-batch':
-        batch_file = Path(args.batch_file)
-        results = helper.apply_ai_batch_translations(
-            batch_file,
-            validate=not args.skip_validation
-        )
-
-        total_applied = sum(results['applied'].values())
-        print(f"Total translations applied: {total_applied}")
-
-    elif args.command == 'export':
-        helper.export_for_external_translation(args.languages, args.format)
-
-
-if __name__ == "__main__":
-    main()
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Anthony StirlingandGitHub	464ab0dee0	Merge branch 'V2' into booklet	2025-09-22 14:47:42 +01:00
Anthony Stirling	68ccb0f970	formats and renames	2025-09-22 14:47:28 +01:00
Reece BrowneandGitHub	b126fb3bd6	Merge branch 'V2' into booklet	2025-09-22 12:19:04 +01:00
Anthony Stirling	d5653499ac	fix	2025-09-22 12:15:18 +01:00
Anthony Stirling	a00b636be2	fix dup	2025-09-22 12:14:33 +01:00
Anthony Stirling	5852b27d49	ids	2025-09-22 12:09:16 +01:00
Anthony StirlingandGitHub	aaafa12bc7	Merge branch 'V2' into booklet	2025-09-22 11:58:23 +01:00
Anthony Stirling GitHub ConnorYoh	1fa0ca4cd2	Update frontend/src/hooks/tools/manageSignatures/useManageSignaturesOperation.ts Co-authored-by: ConnorYoh <40631091+ConnorYoh@users.noreply.github.com>	2025-09-22 11:07:11 +01:00
Anthony Stirling GitHub ConnorYoh	e172874dbb	Update frontend/src/hooks/tools/manageSignatures/useManageSignaturesOperation.ts Co-authored-by: ConnorYoh <40631091+ConnorYoh@users.noreply.github.com>	2025-09-22 11:07:00 +01:00
Anthony Stirling GitHub ConnorYoh	37565cf7b7	Update frontend/src/hooks/tools/bookletImposition/useBookletImpositionOperation.ts Co-authored-by: ConnorYoh <40631091+ConnorYoh@users.noreply.github.com>	2025-09-22 11:06:51 +01:00
Anthony StirlingandGitHub	6947a05fdd	Merge branch 'V2' into booklet	2025-09-22 11:03:42 +01:00
Anthony Stirling	9d5674f0ca	booklet	2025-09-20 20:40:12 +01:00
Anthony StirlingandGitHub	7d3c5faacd	Merge branch 'V2' into booklet	2025-09-19 12:44:17 +01:00
Anthony StirlingandGitHub	e05a55f919	Delete .claude/settings.local.json	2025-09-18 15:26:29 +01:00
Anthony Stirling	b3a7458f44	Merge remote-tracking branch 'origin/V2' into booklet	2025-09-18 14:45:26 +01:00
Anthony Stirling	dc739efddf	translations and tooltips	2025-09-16 17:03:50 +01:00
Anthony Stirling	534064e303	allow numbers	2025-09-16 16:21:41 +01:00
Anthony Stirling	833e56826d	fix buttons and formatting	2025-09-16 16:03:08 +01:00
Anthony Stirling	f596423f75	remove placeholder thing	2025-09-16 15:40:47 +01:00
a	be5ea72ea6	Merge branch 'booklet' of git@github.com:Stirling-Tools/Stirling-PDF.git into booklet	2025-09-16 15:33:51 +01:00
Anthony Stirling	6bc78b481e	typecheck	2025-09-16 15:33:40 +01:00
Anthony StirlingandGitHub	f1d84d599d	Merge branch 'V2' into booklet	2025-09-16 15:27:50 +01:00
Anthony Stirling	ff9c0e9bd4	lots of improvements	2025-09-16 15:27:30 +01:00
Anthony Stirling	a949019d5d	conditionalCert	2025-09-16 14:22:49 +01:00
Anthony Stirling	cd71075f79	interface fies	2025-09-16 13:58:15 +01:00
Anthony StirlingandGitHub	1a8d2f3d33	Merge branch 'V2' into booklet	2025-09-16 13:39:57 +01:00
Anthony StirlingandGitHub	a660e332e3	Merge branch 'V2' into booklet	2025-09-10 10:50:44 +01:00
Anthony Stirling	ae1fa54d4a	move to propietary	2025-09-05 16:05:41 +01:00
Anthony Stirling	44e09f47ce	cleanups v2	2025-09-05 15:54:42 +01:00
Anthony Stirling	b06ae41a49	cleanups	2025-09-05 15:54:25 +01:00
a	99bc3a1ebf	Merge branch 'booklet' of git@github.com:Stirling-Tools/Stirling-PDF.git into booklet	2025-09-05 15:50:06 +01:00
Anthony Stirling	07eb28194d	fix build server vs auto	2025-09-05 15:49:59 +01:00
Anthony StirlingandGitHub	285e024b00	Merge branch 'V2' into booklet	2025-09-05 15:41:33 +01:00
Anthony Stirling GitHubCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>	6c43558975	Potential fix for code scanning alert no. 313: Information exposure through an error message Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>	2025-09-05 10:47:37 +01:00
Anthony Stirling	019fe714c5	change files around and wordings	2025-09-04 23:48:35 +01:00
Anthony Stirling	bf03a6011b	translations	2025-09-04 16:29:05 +01:00
Anthony Stirling	ac8ced8a03	move file	2025-09-04 11:25:21 +01:00
Anthony Stirling	e00baeb033	booklet and server sign	2025-09-03 22:57:58 +01:00
Anthony Stirling	6a09ec6091	fix signature apperance	2025-09-03 10:20:43 +01:00
Anthony Stirling	070f8b73e5	update manage vs certSign	2025-09-03 10:15:11 +01:00
Anthony Stirling	91631bb1de	add cert sig	2025-09-03 00:12:16 +01:00