mirror of
https://github.com/Stirling-Tools/Stirling-PDF.git
synced 2025-08-22 20:29:23 +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>
173 lines
5.4 KiB
TypeScript
173 lines
5.4 KiB
TypeScript
import React, { useState } from "react";
|
|
import { Box, Flex, Group, Text, Button, TextInput, Select, Badge } from "@mantine/core";
|
|
import { useTranslation } from "react-i18next";
|
|
import SearchIcon from "@mui/icons-material/Search";
|
|
import SortIcon from "@mui/icons-material/Sort";
|
|
import FileCard from "../fileManagement/FileCard";
|
|
import { FileWithUrl } from "../../types/file";
|
|
|
|
interface FileGridProps {
|
|
files: FileWithUrl[];
|
|
onRemove?: (index: number) => void;
|
|
onDoubleClick?: (file: FileWithUrl) => void;
|
|
onView?: (file: FileWithUrl) => void;
|
|
onEdit?: (file: FileWithUrl) => void;
|
|
onSelect?: (fileId: string) => void;
|
|
selectedFiles?: string[];
|
|
showSearch?: boolean;
|
|
showSort?: boolean;
|
|
maxDisplay?: number; // If set, shows only this many files with "Show All" option
|
|
onShowAll?: () => void;
|
|
showingAll?: boolean;
|
|
onDeleteAll?: () => void;
|
|
isFileSupported?: (fileName: string) => boolean; // Function to check if file is supported
|
|
}
|
|
|
|
type SortOption = 'date' | 'name' | 'size';
|
|
|
|
const FileGrid = ({
|
|
files,
|
|
onRemove,
|
|
onDoubleClick,
|
|
onView,
|
|
onEdit,
|
|
onSelect,
|
|
selectedFiles = [],
|
|
showSearch = false,
|
|
showSort = false,
|
|
maxDisplay,
|
|
onShowAll,
|
|
showingAll = false,
|
|
onDeleteAll,
|
|
isFileSupported
|
|
}: FileGridProps) => {
|
|
const { t } = useTranslation();
|
|
const [searchTerm, setSearchTerm] = useState("");
|
|
const [sortBy, setSortBy] = useState<SortOption>('date');
|
|
|
|
// Filter files based on search term
|
|
const filteredFiles = files.filter(file =>
|
|
file.name.toLowerCase().includes(searchTerm.toLowerCase())
|
|
);
|
|
|
|
// Sort files
|
|
const sortedFiles = [...filteredFiles].sort((a, b) => {
|
|
switch (sortBy) {
|
|
case 'date':
|
|
return (b.lastModified || 0) - (a.lastModified || 0);
|
|
case 'name':
|
|
return a.name.localeCompare(b.name);
|
|
case 'size':
|
|
return (b.size || 0) - (a.size || 0);
|
|
default:
|
|
return 0;
|
|
}
|
|
});
|
|
|
|
// Apply max display limit if specified
|
|
const displayFiles = maxDisplay && !showingAll
|
|
? sortedFiles.slice(0, maxDisplay)
|
|
: sortedFiles;
|
|
|
|
const hasMoreFiles = maxDisplay && !showingAll && sortedFiles.length > maxDisplay;
|
|
|
|
return (
|
|
<Box >
|
|
{/* Search and Sort Controls */}
|
|
{(showSearch || showSort || onDeleteAll) && (
|
|
<Group mb="md" justify="space-between" wrap="wrap" gap="sm">
|
|
<Group gap="sm">
|
|
{showSearch && (
|
|
<TextInput
|
|
placeholder={t("fileManager.searchFiles", "Search files...")}
|
|
leftSection={<SearchIcon size={16} />}
|
|
value={searchTerm}
|
|
onChange={(e) => setSearchTerm(e.currentTarget.value)}
|
|
style={{ flexGrow: 1, maxWidth: 300, minWidth: 200 }}
|
|
/>
|
|
)}
|
|
|
|
{showSort && (
|
|
<Select
|
|
data={[
|
|
{ value: 'date', label: t("fileManager.sortByDate", "Sort by Date") },
|
|
{ value: 'name', label: t("fileManager.sortByName", "Sort by Name") },
|
|
{ value: 'size', label: t("fileManager.sortBySize", "Sort by Size") }
|
|
]}
|
|
value={sortBy}
|
|
onChange={(value) => setSortBy(value as SortOption)}
|
|
leftSection={<SortIcon size={16} />}
|
|
style={{ minWidth: 150 }}
|
|
/>
|
|
)}
|
|
</Group>
|
|
|
|
{onDeleteAll && (
|
|
<Button
|
|
color="red"
|
|
size="sm"
|
|
onClick={onDeleteAll}
|
|
>
|
|
{t("fileManager.deleteAll", "Delete All")}
|
|
</Button>
|
|
)}
|
|
</Group>
|
|
)}
|
|
|
|
{/* File Grid */}
|
|
<Flex
|
|
direction="row"
|
|
wrap="wrap"
|
|
gap="md"
|
|
h="30rem"
|
|
style={{ overflowY: "auto", width: "100%" }}
|
|
>
|
|
{displayFiles.map((file, idx) => {
|
|
const fileId = file.id || file.name;
|
|
const originalIdx = files.findIndex(f => (f.id || f.name) === fileId);
|
|
const supported = isFileSupported ? isFileSupported(file.name) : true;
|
|
return (
|
|
<FileCard
|
|
key={fileId + idx}
|
|
file={file}
|
|
onRemove={onRemove ? () => onRemove(originalIdx) : undefined}
|
|
onDoubleClick={onDoubleClick && supported ? () => onDoubleClick(file) : undefined}
|
|
onView={onView && supported ? () => onView(file) : undefined}
|
|
onEdit={onEdit && supported ? () => onEdit(file) : undefined}
|
|
isSelected={selectedFiles.includes(fileId)}
|
|
onSelect={onSelect && supported ? () => onSelect(fileId) : undefined}
|
|
isSupported={supported}
|
|
/>
|
|
);
|
|
})}
|
|
</Flex>
|
|
|
|
{/* Show All Button */}
|
|
{hasMoreFiles && onShowAll && (
|
|
<Group justify="center" mt="md">
|
|
<Button
|
|
variant="light"
|
|
onClick={onShowAll}
|
|
>
|
|
{t("fileManager.showAll", "Show All")} ({sortedFiles.length} files)
|
|
</Button>
|
|
</Group>
|
|
)}
|
|
|
|
{/* Empty State */}
|
|
{displayFiles.length === 0 && (
|
|
<Box style={{ textAlign: 'center', padding: '2rem' }}>
|
|
<Text c="dimmed">
|
|
{searchTerm
|
|
? t("fileManager.noFilesFound", "No files found matching your search")
|
|
: t("fileManager.noFiles", "No files available")
|
|
}
|
|
</Text>
|
|
</Box>
|
|
)}
|
|
</Box>
|
|
);
|
|
};
|
|
|
|
export default FileGrid;
|