mirror of
https://github.com/Stirling-Tools/Stirling-PDF.git
synced 2025-08-02 18:45:21 +00:00

🔄 Dynamic Processing Strategies - Adaptive routing: Same tool uses different backend endpoints based on file analysis - Combined vs separate processing: Intelligently chooses between merge operations and individual file processing - Cross-format workflows: Enable complex conversions like "mixed files → PDF" that other tools can't handle ⚙️ Format-Specific Intelligence Each conversion type gets tailored options: - HTML/ZIP → PDF: Zoom controls (0.1-3.0 increments) with live preview - Email → PDF: Attachment handling, size limits, recipient control - PDF → PDF/A: Digital signature detection with warnings - Images → PDF: Smart combining vs individual file options File Architecture Core Implementation: ├── Convert.tsx # Main stepped workflow UI ├── ConvertSettings.tsx # Centralized settings with smart detection ├── GroupedFormatDropdown.tsx # Enhanced format selector with grouping ├── useConvertParameters.ts # Smart detection & parameter management ├── useConvertOperation.ts # Multi-strategy processing logic └── Settings Components: ├── ConvertFromWebSettings.tsx # HTML zoom controls ├── ConvertFromEmailSettings.tsx # Email attachment options ├── ConvertToPdfaSettings.tsx # PDF/A with signature detection ├── ConvertFromImageSettings.tsx # Image PDF options └── ConvertToImageSettings.tsx # PDF to image options Utility Layer Utils & Services: ├── convertUtils.ts # Format detection & endpoint routing ├── fileResponseUtils.ts # Generic API response handling └── setupTests.ts # Enhanced test environment with crypto mocks Testing & Quality Comprehensive Test Coverage Test Suite: ├── useConvertParameters.test.ts # Parameter logic & smart detection ├── useConvertParametersAutoDetection.test.ts # File type analysis ├── ConvertIntegration.test.tsx # End-to-end conversion workflows ├── ConvertSmartDetectionIntegration.test.tsx # Mixed file scenarios ├── ConvertE2E.spec.ts # Playwright browser tests ├── convertUtils.test.ts # Utility function validation └── fileResponseUtils.test.ts # API response handling Advanced Test Features - Crypto API mocking: Proper test environment for file hashing - File.arrayBuffer() polyfills: Complete browser API simulation - Multi-file scenario testing: Complex batch processing validation - CI/CD integration: Vitest runs in GitHub Actions with proper artifacts --------- Co-authored-by: Connor Yoh <connor@stirlingpdf.com> Co-authored-by: Anthony Stirling <77850077+Frooodle@users.noreply.github.com>
360 lines
9.6 KiB
TypeScript
360 lines
9.6 KiB
TypeScript
import React, { useState } from 'react';
|
|
import { Text, Checkbox, Tooltip, ActionIcon, Badge, Modal } from '@mantine/core';
|
|
import { useTranslation } from 'react-i18next';
|
|
import CloseIcon from '@mui/icons-material/Close';
|
|
import VisibilityIcon from '@mui/icons-material/Visibility';
|
|
import HistoryIcon from '@mui/icons-material/History';
|
|
import DragIndicatorIcon from '@mui/icons-material/DragIndicator';
|
|
import styles from './PageEditor.module.css';
|
|
import FileOperationHistory from '../history/FileOperationHistory';
|
|
|
|
interface FileItem {
|
|
id: string;
|
|
name: string;
|
|
pageCount: number;
|
|
thumbnail: string;
|
|
size: number;
|
|
splitBefore?: boolean;
|
|
}
|
|
|
|
interface FileThumbnailProps {
|
|
file: FileItem;
|
|
index: number;
|
|
totalFiles: number;
|
|
selectedFiles: string[];
|
|
selectionMode: boolean;
|
|
draggedFile: string | null;
|
|
dropTarget: string | null;
|
|
isAnimating: boolean;
|
|
fileRefs: React.MutableRefObject<Map<string, HTMLDivElement>>;
|
|
onDragStart: (fileId: string) => void;
|
|
onDragEnd: () => void;
|
|
onDragOver: (e: React.DragEvent) => void;
|
|
onDragEnter: (fileId: string) => void;
|
|
onDragLeave: () => void;
|
|
onDrop: (e: React.DragEvent, fileId: string) => void;
|
|
onToggleFile: (fileId: string) => void;
|
|
onDeleteFile: (fileId: string) => void;
|
|
onViewFile: (fileId: string) => void;
|
|
onSetStatus: (status: string) => void;
|
|
toolMode?: boolean;
|
|
isSupported?: boolean;
|
|
}
|
|
|
|
const FileThumbnail = ({
|
|
file,
|
|
index,
|
|
totalFiles,
|
|
selectedFiles,
|
|
selectionMode,
|
|
draggedFile,
|
|
dropTarget,
|
|
isAnimating,
|
|
fileRefs,
|
|
onDragStart,
|
|
onDragEnd,
|
|
onDragOver,
|
|
onDragEnter,
|
|
onDragLeave,
|
|
onDrop,
|
|
onToggleFile,
|
|
onDeleteFile,
|
|
onViewFile,
|
|
onSetStatus,
|
|
toolMode = false,
|
|
isSupported = true,
|
|
}: FileThumbnailProps) => {
|
|
const { t } = useTranslation();
|
|
const [showHistory, setShowHistory] = useState(false);
|
|
|
|
const formatFileSize = (bytes: number) => {
|
|
if (bytes === 0) return '0 B';
|
|
const k = 1024;
|
|
const sizes = ['B', 'KB', 'MB', 'GB'];
|
|
const i = Math.floor(Math.log(bytes) / Math.log(k));
|
|
return parseFloat((bytes / Math.pow(k, i)).toFixed(1)) + ' ' + sizes[i];
|
|
};
|
|
|
|
return (
|
|
<div
|
|
ref={(el) => {
|
|
if (el) {
|
|
fileRefs.current.set(file.id, el);
|
|
} else {
|
|
fileRefs.current.delete(file.id);
|
|
}
|
|
}}
|
|
data-file-id={file.id}
|
|
data-testid="file-thumbnail"
|
|
className={`
|
|
${styles.pageContainer}
|
|
!rounded-lg
|
|
cursor-grab
|
|
select-none
|
|
w-[20rem]
|
|
h-[24rem]
|
|
flex flex-col items-center justify-center
|
|
flex-shrink-0
|
|
shadow-sm
|
|
hover:shadow-md
|
|
transition-all
|
|
relative
|
|
${selectionMode
|
|
? 'bg-white hover:bg-gray-50'
|
|
: 'bg-white hover:bg-gray-50'}
|
|
${draggedFile === file.id ? 'opacity-50 scale-95' : ''}
|
|
`}
|
|
style={{
|
|
transform: (() => {
|
|
if (!isAnimating && draggedFile && file.id !== draggedFile && dropTarget === file.id) {
|
|
return 'translateX(20px)';
|
|
}
|
|
return 'translateX(0)';
|
|
})(),
|
|
transition: isAnimating ? 'none' : 'transform 0.2s ease-in-out',
|
|
opacity: isSupported ? 1 : 0.5,
|
|
filter: isSupported ? 'none' : 'grayscale(50%)'
|
|
}}
|
|
draggable
|
|
onDragStart={() => onDragStart(file.id)}
|
|
onDragEnd={onDragEnd}
|
|
onDragOver={onDragOver}
|
|
onDragEnter={() => onDragEnter(file.id)}
|
|
onDragLeave={onDragLeave}
|
|
onDrop={(e) => onDrop(e, file.id)}
|
|
>
|
|
{selectionMode && (
|
|
<div
|
|
className={styles.checkboxContainer}
|
|
data-testid="file-thumbnail-checkbox"
|
|
style={{
|
|
position: 'absolute',
|
|
top: 8,
|
|
right: 8,
|
|
zIndex: 4,
|
|
backgroundColor: 'white',
|
|
borderRadius: '4px',
|
|
padding: '2px',
|
|
boxShadow: '0 2px 4px rgba(0,0,0,0.1)',
|
|
pointerEvents: 'auto'
|
|
}}
|
|
onMouseDown={(e) => e.stopPropagation()}
|
|
onDragStart={(e) => {
|
|
e.preventDefault();
|
|
e.stopPropagation();
|
|
}}
|
|
>
|
|
<Checkbox
|
|
checked={selectedFiles.includes(file.id)}
|
|
onChange={(event) => {
|
|
event.stopPropagation();
|
|
if (isSupported) {
|
|
onToggleFile(file.id);
|
|
}
|
|
}}
|
|
onClick={(e) => e.stopPropagation()}
|
|
disabled={!isSupported}
|
|
size="sm"
|
|
/>
|
|
</div>
|
|
)}
|
|
|
|
{/* File content area */}
|
|
<div className="file-container w-[90%] h-[80%] relative">
|
|
{/* Stacked file effect - multiple shadows to simulate pages */}
|
|
<div
|
|
style={{
|
|
width: '100%',
|
|
height: '100%',
|
|
backgroundColor: 'var(--mantine-color-gray-1)',
|
|
borderRadius: 6,
|
|
border: '1px solid var(--mantine-color-gray-3)',
|
|
padding: 4,
|
|
display: 'flex',
|
|
alignItems: 'center',
|
|
justifyContent: 'center',
|
|
position: 'relative',
|
|
boxShadow: '2px 2px 0 rgba(0,0,0,0.1), 4px 4px 0 rgba(0,0,0,0.05)'
|
|
}}
|
|
>
|
|
<img
|
|
src={file.thumbnail}
|
|
alt={file.name}
|
|
style={{
|
|
maxWidth: '100%',
|
|
maxHeight: '100%',
|
|
objectFit: 'contain',
|
|
borderRadius: 2,
|
|
}}
|
|
/>
|
|
</div>
|
|
|
|
{/* Page count badge */}
|
|
<Badge
|
|
size="sm"
|
|
variant="filled"
|
|
color="blue"
|
|
style={{
|
|
position: 'absolute',
|
|
top: 8,
|
|
left: 8,
|
|
zIndex: 3,
|
|
}}
|
|
>
|
|
{file.pageCount} pages
|
|
</Badge>
|
|
|
|
{/* Unsupported badge */}
|
|
{!isSupported && (
|
|
<Badge
|
|
size="sm"
|
|
variant="filled"
|
|
color="orange"
|
|
style={{
|
|
position: 'absolute',
|
|
top: 8,
|
|
right: selectionMode ? 48 : 8, // Avoid overlap with checkbox
|
|
zIndex: 3,
|
|
}}
|
|
>
|
|
{t("fileManager.unsupported", "Unsupported")}
|
|
</Badge>
|
|
)}
|
|
|
|
{/* File name overlay */}
|
|
<Text
|
|
className={styles.pageNumber}
|
|
size="xs"
|
|
fw={500}
|
|
c="white"
|
|
style={{
|
|
position: 'absolute',
|
|
bottom: 5,
|
|
left: 5,
|
|
right: 5,
|
|
background: 'rgba(0, 0, 0, 0.8)',
|
|
padding: '4px 6px',
|
|
borderRadius: 4,
|
|
zIndex: 2,
|
|
opacity: 0,
|
|
transition: 'opacity 0.2s ease-in-out',
|
|
textOverflow: 'ellipsis',
|
|
overflow: 'hidden',
|
|
whiteSpace: 'nowrap'
|
|
}}
|
|
>
|
|
{file.name}
|
|
</Text>
|
|
|
|
{/* Hover controls */}
|
|
<div
|
|
className={styles.pageHoverControls}
|
|
style={{
|
|
position: 'absolute',
|
|
top: '50%',
|
|
left: '50%',
|
|
transform: 'translate(-50%, -50%)',
|
|
background: 'rgba(0, 0, 0, 0.8)',
|
|
padding: '8px 12px',
|
|
borderRadius: 20,
|
|
opacity: 0,
|
|
transition: 'opacity 0.2s ease-in-out',
|
|
zIndex: 3,
|
|
display: 'flex',
|
|
gap: '8px',
|
|
alignItems: 'center',
|
|
whiteSpace: 'nowrap'
|
|
}}
|
|
>
|
|
{!toolMode && isSupported && (
|
|
<>
|
|
<Tooltip label="View File">
|
|
<ActionIcon
|
|
size="md"
|
|
variant="subtle"
|
|
c="white"
|
|
onClick={(e) => {
|
|
e.stopPropagation();
|
|
onViewFile(file.id);
|
|
onSetStatus(`Opened ${file.name}`);
|
|
}}
|
|
>
|
|
<VisibilityIcon style={{ fontSize: 20 }} />
|
|
</ActionIcon>
|
|
</Tooltip>
|
|
|
|
</>
|
|
)}
|
|
|
|
<Tooltip label="View History">
|
|
<ActionIcon
|
|
size="md"
|
|
variant="subtle"
|
|
c="white"
|
|
onClick={(e) => {
|
|
e.stopPropagation();
|
|
setShowHistory(true);
|
|
onSetStatus(`Viewing history for ${file.name}`);
|
|
}}
|
|
>
|
|
<HistoryIcon style={{ fontSize: 20 }} />
|
|
</ActionIcon>
|
|
</Tooltip>
|
|
|
|
<Tooltip label="Close File">
|
|
<ActionIcon
|
|
size="md"
|
|
variant="subtle"
|
|
c="orange"
|
|
onClick={(e) => {
|
|
e.stopPropagation();
|
|
onDeleteFile(file.id);
|
|
onSetStatus(`Closed ${file.name}`);
|
|
}}
|
|
>
|
|
<CloseIcon style={{ fontSize: 20 }} />
|
|
</ActionIcon>
|
|
</Tooltip>
|
|
</div>
|
|
|
|
<DragIndicatorIcon
|
|
style={{
|
|
position: 'absolute',
|
|
bottom: 4,
|
|
right: 4,
|
|
color: 'rgba(0,0,0,0.3)',
|
|
fontSize: 16,
|
|
zIndex: 1
|
|
}}
|
|
/>
|
|
</div>
|
|
|
|
{/* File info */}
|
|
<div className="w-full px-4 py-2 text-center">
|
|
<Text size="sm" fw={500} truncate>
|
|
{file.name}
|
|
</Text>
|
|
<Text size="xs" c="dimmed">
|
|
{formatFileSize(file.size)}
|
|
</Text>
|
|
</div>
|
|
|
|
{/* History Modal */}
|
|
<Modal
|
|
opened={showHistory}
|
|
onClose={() => setShowHistory(false)}
|
|
title={`Operation History - ${file.name}`}
|
|
size="lg"
|
|
scrollAreaComponent="div"
|
|
>
|
|
<FileOperationHistory
|
|
fileId={file.name}
|
|
showOnlyApplied={true}
|
|
maxHeight={500}
|
|
/>
|
|
</Modal>
|
|
</div>
|
|
);
|
|
};
|
|
|
|
export default FileThumbnail; |