feat: comprehensive HEIC/HEIF support and edit-metadata ExifTool overhaul

- Add ensureSharpCompat() helper for automatic HEIC detection and decode
- Fix HEIC support in all 14 custom-route tools (image-to-pdf, split,
  barcode-read, compose, collage, stitch, compare, find-duplicates,
  color-palette, watermark-image, vectorize, favicon, info, branding)
- Fix PdfPagePreview using store's decoded blobUrl instead of raw File
- Add onError fallback in ImageViewer for unrenderable formats
- Fix image-to-pdf progress bar with flushSync for reliable rendering
- Add ExifTool backend for edit-metadata (GPS, keywords, IPTC, dates)
- Rename Strip Metadata to Remove Metadata with interactive Leaflet map
- Fix user-files thumbnail generation for stored HEIC files
- Fix info tool stats() histogram for HEIC via decoded buffer
- Skip HEIC preprocessing in batch route for metadata tools

apps/api/src/routes/tools/image-to-pdf.ts

@@ -5,6 +5,7 @@ import type { FastifyInstance } from "fastify";
 import PDFDocument from "pdfkit";
 import sharp from "sharp";
 import { z } from "zod";
+import { ensureSharpCompat } from "../../lib/heic-converter.js";
 import { createWorkspace } from "../../lib/workspace.js";
 
 const settingsSchema = z.object({
@@ -95,8 +96,9 @@ export function registerImageToPdf(app: FastifyInstance) {
       for (const file of files) {
         doc.addPage({ size: [pageW, pageH], margin });
 
-        // Convert to PNG for PDFKit compatibility
-        const pngBuffer = await sharp(file.buffer).png().toBuffer();
+        // Decode HEIC/HEIF if needed, then convert to PNG for PDFKit compatibility
+        const compatBuffer = await ensureSharpCompat(file.buffer);
+        const pngBuffer = await sharp(compatBuffer).png().toBuffer();
 
         const meta = await sharp(pngBuffer).metadata();
         const imgW = meta.width ?? 100;