feat(gif-tools): SOTA upgrade with 6 processing modes (#52)

* feat(find-duplicates): upgrade to 128-bit dHash with metadata and thumbnails

* feat(find-duplicates): add custom-results display mode and duplicate store

* feat(find-duplicates): add results overview grid and detail comparison view

* feat(find-duplicates): overhaul settings with sensitivity presets and download actions

* feat(find-duplicates): update i18n description

* chore: replace jsqr with zxing-wasm for barcode reading

* feat(barcode-read): rewrite backend with zxing-wasm for all barcode types

* feat(barcode-read): rewrite frontend with multi-file, results table, progress, export

- Multi-file sequential processing with per-file progress
- Structured results table with type badges and copy per-result
- Copy All and Export CSV functionality
- Thorough scan toggle (maps to tryHarder in zxing-wasm)
- Before/after view shows annotated image with bounding boxes
- Updated tool description in constants and i18n

* feat(stitch): update tool name and description for redesign

* feat(stitch): add grid layout, alignment, border, radius, quality, and new resize modes

* feat(stitch): redesign settings UI with grid, alignment, border, radius, quality

* test(stitch): add stitch to e2e tool navigation suite

* feat(vectorize): redesign with dual-engine backend and preset-driven UI

- Backend: potrace for B&W, VTracer (@neplex/vectorizer) for full-color vectorization
- Frontend: 5 presets (logo, illustration, photo, sketch, custom)
- Settings: color precision, gradient step, detail, smoothing, corner threshold, invert
- Updated OpenAPI spec and i18n description

* feat(border): redesign with presets, shadow, padding color, swatches

- Add 8 one-click presets (Clean White, Gallery Black, Shadow, Rounded, Polaroid, Vintage, Minimal, Cinematic)
- Implement proper shadow rendering with blur, offset X/Y, color, opacity
- Add padding color control (was hardcoded white)
- Add color swatches for quick color selection
- Wrap in form for Enter key submission
- Add smart validation (requires at least one effect active)
- Align frontend/backend slider ranges
- Organize UI with sections and collapsible shadow toggle

* feat(split): overhaul image splitting with live grid overlay and tile preview

- Add interactive-split display mode with SplitCanvas component
- Live SVG grid overlay on uploaded image showing split boundaries
- Two split modes: Grid (NxM) and Tile Size (px dimensions)
- 9 grid presets (2x1, 1x2, 2x2, 3x1, 1x3, 3x3, 2x3, 3x2, 4x4)
- Output format selection (original/PNG/JPG/WebP) with quality slider
- Post-split tile preview thumbnails with individual download
- Download All as ZIP button
- HEIC/HEIF preview with loading spinner
- Backend: tile-size mode, output format conversion, quality control
- Zustand store for split state management

* feat(split): rewrite backend and frontend settings

Backend: tile-size mode, output format conversion, quality control.
Frontend: split modes, presets, format selector, tile preview grid.

* feat(border): add live CSS preview and remove before/after slider

- Add imageWrapperStyle prop to ImageViewer for live border preview
- Add onImageStyle callback through tool-page to settings components
- Change border displayMode to no-comparison (no slider)
- BorderControls sends live CSS styles (border, padding, radius, shadow)
- Preview updates instantly as user adjusts sliders or clicks presets

* fix: repair i18n file corrupted by formatter during merge conflict resolution

* feat(border): enable live CSS preview in right pane as settings change

* fix(border): keep CSS preview visible after processing for WYSIWYG consistency

* chore(gif-tools): scaffold for SOTA upgrade

- Add animated GIF test fixture (3 frames, 100x100)
- Update tool description to reflect new capabilities
- Add fflate dependency to API for ZIP creation

* feat(gif-tools): rewrite backend with 6 processing modes

Modes: resize (with percentage), optimize (colors/dither/effort),
speed (delay manipulation), reverse (frame reorder), extract
(single/range/all with ZIP), rotate (90/180/270 + flip).

Adds /api/v1/tools/gif-tools/info metadata endpoint.

* test(gif-tools): add integration tests for all 6 modes

Tests metadata endpoint, resize (pixel + percentage), optimize,
speed, reverse, extract (single/range/all), and rotate (angle + flip).

Fix animated.gif fixture to be a real 3-frame animation (was a single
100x300 frame). Fix reverse and rotate modes to process frames
individually and reassemble via GIF binary concatenation, since
Sharp 0.33.x loses page-height metadata when reconstructing from raw
pixel data.

* feat(gif-tools): rewrite frontend with tabbed 6-mode UI

- useGifInfo hook for metadata (frame count, dimensions, duration)
- Info bar showing GIF properties
- 3x2 mode grid: Resize, Optimize, Speed, Reverse, Extract, Rotate
- Animation modes disabled for static images
- Loop control (infinite/once/custom)
- Batch processing support

* test(gif-tools): add to representative tools in e2e suite

---------

Co-authored-by: Siddharth Kumar Sah <siddharth123sk@gmail.com>

packages/shared/src/constants.ts

@@ -238,7 +238,7 @@ export const TOOLS: Tool[] = [
   {
     id: "barcode-read",
     name: "Barcode Reader",
-    description: "Read QR codes and barcodes from images",
+    description: "Scan images for QR codes, barcodes, and 2D codes",
     category: "utilities",
     icon: "ScanLine",
     route: "/barcode-read",
@@ -247,15 +247,15 @@ export const TOOLS: Tool[] = [
   {
     id: "collage",
     name: "Collage / Grid",
-    description: "Combine images into a grid layout",
+    description: "Combine images into beautiful grid collages with 25+ templates",
     category: "layout",
     icon: "LayoutGrid",
     route: "/collage",
   },
   {
     id: "stitch",
-    name: "Stitch",
-    description: "Join images side by side or top to bottom",
+    name: "Stitch / Combine",
+    description: "Join images side by side, stacked, or in a grid",
     category: "layout",
     icon: "Columns",
     route: "/stitch",
@@ -263,7 +263,7 @@ export const TOOLS: Tool[] = [
   {
     id: "split",
     name: "Image Splitting",
-    description: "Split image into grid parts",
+    description: "Split images into grid tiles or by pixel size with live preview",
     category: "layout",
     icon: "Grid3x3",
     route: "/split",
@@ -296,7 +296,8 @@ export const TOOLS: Tool[] = [
   {
     id: "gif-tools",
     name: "GIF Tools",
-    description: "Resize/crop/convert animated GIFs",
+    description:
+      "Resize, optimize, change speed, reverse, extract frames, and rotate animated GIFs",
     category: "format",
     icon: "Film",
     route: "/gif-tools",

packages/shared/src/i18n/en.ts

@@ -95,16 +95,29 @@ export const en = {
       description: "Read QR codes and barcodes from images",
     },
     collage: { name: "Collage / Grid", description: "Combine images into a grid layout" },
-    stitch: { name: "Stitch", description: "Join images side by side or top to bottom" },
-    split: { name: "Image Splitting", description: "Split image into grid parts" },
-    border: { name: "Border & Frame", description: "Add borders, rounded corners, shadows" },
+    stitch: {
+      name: "Stitch / Combine",
+      description: "Join images side by side, stacked, or in a grid",
+    },
+    split: {
+      name: "Image Splitting",
+      description: "Split images into grid tiles or by pixel size with live preview",
+    },
+    border: {
+      name: "Border & Frame",
+      description: "Add borders, padding, rounded corners, and shadows with one-click presets",
+    },
     "svg-to-raster": {
       name: "SVG to Raster",
       description:
         "Convert SVG to PNG, JPEG, WebP, AVIF, TIFF, GIF, or HEIF at custom scale and DPI",
     },
-    vectorize: { name: "Image to SVG", description: "Vectorize images using tracing" },
-    "gif-tools": { name: "GIF Tools", description: "Resize/crop/convert animated GIFs" },
+    vectorize: { name: "Image to SVG", description: "Convert images to scalable vector graphics" },
+    "gif-tools": {
+      name: "GIF Tools",
+      description:
+        "Resize, optimize, change speed, reverse, extract frames, and rotate animated GIFs",
+    },
     pipeline: { name: "Pipeline Builder", description: "Chain multiple tools into a workflow" },
     batch: { name: "Batch Processing", description: "Apply any tool to multiple images" },
   },