mirror of
https://github.com/Stirling-Tools/Stirling-PDF.git
synced 2025-08-26 14:19:24 +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>
156 lines
4.9 KiB
TypeScript
156 lines
4.9 KiB
TypeScript
import React, { useState, useMemo } from "react";
|
|
import { Stack, Text, Group, Button, Box, Popover, UnstyledButton, useMantineTheme, useMantineColorScheme } from "@mantine/core";
|
|
import KeyboardArrowDownIcon from "@mui/icons-material/KeyboardArrowDown";
|
|
|
|
interface FormatOption {
|
|
value: string;
|
|
label: string;
|
|
group: string;
|
|
enabled?: boolean;
|
|
}
|
|
|
|
interface GroupedFormatDropdownProps {
|
|
value?: string;
|
|
placeholder?: string;
|
|
options: FormatOption[];
|
|
onChange: (value: string) => void;
|
|
disabled?: boolean;
|
|
minWidth?: string;
|
|
name?: string;
|
|
}
|
|
|
|
const GroupedFormatDropdown = ({
|
|
value,
|
|
placeholder = "Select an option",
|
|
options,
|
|
onChange,
|
|
disabled = false,
|
|
minWidth = "18.75rem",
|
|
name
|
|
}: GroupedFormatDropdownProps) => {
|
|
const [dropdownOpened, setDropdownOpened] = useState(false);
|
|
const theme = useMantineTheme();
|
|
const { colorScheme } = useMantineColorScheme();
|
|
|
|
const groupedOptions = useMemo(() => {
|
|
const groups: Record<string, FormatOption[]> = {};
|
|
|
|
options.forEach(option => {
|
|
if (!groups[option.group]) {
|
|
groups[option.group] = [];
|
|
}
|
|
groups[option.group].push(option);
|
|
});
|
|
|
|
return groups;
|
|
}, [options]);
|
|
|
|
const selectedLabel = useMemo(() => {
|
|
if (!value) return placeholder;
|
|
const selected = options.find(opt => opt.value === value);
|
|
return selected ? `${selected.group} (${selected.label})` : value.toUpperCase();
|
|
}, [value, options, placeholder]);
|
|
|
|
const handleOptionSelect = (selectedValue: string) => {
|
|
onChange(selectedValue);
|
|
setDropdownOpened(false);
|
|
};
|
|
|
|
return (
|
|
<Popover
|
|
opened={dropdownOpened}
|
|
onDismiss={() => setDropdownOpened(false)}
|
|
position="bottom-start"
|
|
withArrow
|
|
shadow="sm"
|
|
disabled={disabled}
|
|
closeOnEscape={true}
|
|
trapFocus
|
|
>
|
|
<Popover.Target>
|
|
<UnstyledButton
|
|
name={name}
|
|
data-testid={name}
|
|
onClick={() => setDropdownOpened(!dropdownOpened)}
|
|
disabled={disabled}
|
|
style={{
|
|
padding: '0.5rem 0.75rem',
|
|
border: `0.0625rem solid ${theme.colors.gray[4]}`,
|
|
borderRadius: theme.radius.sm,
|
|
backgroundColor: disabled
|
|
? theme.colors.gray[1]
|
|
: colorScheme === 'dark'
|
|
? theme.colors.dark[6]
|
|
: theme.white,
|
|
cursor: disabled ? 'not-allowed' : 'pointer',
|
|
width: '100%',
|
|
color: disabled
|
|
? colorScheme === 'dark' ? theme.colors.dark[1] : theme.colors.dark[7]
|
|
: colorScheme === 'dark' ? theme.colors.dark[0] : theme.colors.dark[9]
|
|
}}
|
|
>
|
|
<Group justify="space-between">
|
|
<Text size="sm" c={value ? undefined : 'dimmed'}>
|
|
{selectedLabel}
|
|
</Text>
|
|
<KeyboardArrowDownIcon
|
|
style={{
|
|
fontSize: '1rem',
|
|
transform: dropdownOpened ? 'rotate(180deg)' : 'rotate(0deg)',
|
|
transition: 'transform 0.2s ease',
|
|
color: colorScheme === 'dark' ? theme.colors.dark[2] : theme.colors.gray[6]
|
|
}}
|
|
/>
|
|
</Group>
|
|
</UnstyledButton>
|
|
</Popover.Target>
|
|
<Popover.Dropdown
|
|
style={{
|
|
minWidth: Math.min(350, parseInt(minWidth.replace('rem', '')) * 16),
|
|
maxWidth: '90vw',
|
|
maxHeight: '40vh',
|
|
overflow: 'auto',
|
|
backgroundColor: colorScheme === 'dark' ? theme.colors.dark[7] : theme.white,
|
|
border: `0.0625rem solid ${colorScheme === 'dark' ? theme.colors.dark[4] : theme.colors.gray[4]}`,
|
|
}}
|
|
>
|
|
<Stack gap="md">
|
|
{Object.entries(groupedOptions).map(([groupName, groupOptions]) => (
|
|
<Box key={groupName}>
|
|
<Text
|
|
size="sm"
|
|
fw={600}
|
|
c={colorScheme === 'dark' ? 'dark.2' : 'gray.6'}
|
|
mb="xs"
|
|
>
|
|
{groupName}
|
|
</Text>
|
|
<Group gap="xs" style={{ flexWrap: 'wrap' }}>
|
|
{groupOptions.map((option) => (
|
|
<Button
|
|
key={option.value}
|
|
data-testid={`format-option-${option.value}`}
|
|
variant={value === option.value ? "filled" : "outline"}
|
|
size="sm"
|
|
onClick={() => handleOptionSelect(option.value)}
|
|
disabled={option.enabled === false}
|
|
style={{
|
|
fontSize: '0.75rem',
|
|
height: '2rem',
|
|
padding: '0 0.75rem',
|
|
flexShrink: 0
|
|
}}
|
|
>
|
|
{option.label}
|
|
</Button>
|
|
))}
|
|
</Group>
|
|
</Box>
|
|
))}
|
|
</Stack>
|
|
</Popover.Dropdown>
|
|
</Popover>
|
|
);
|
|
};
|
|
|
|
export default GroupedFormatDropdown; |