mirror of
https://github.com/Stirling-Tools/Stirling-PDF.git
synced 2025-08-02 18:45:21 +00:00
9c9acbfb5b
🔄 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>
82 lines
3.2 KiB
TypeScript
82 lines
3.2 KiB
TypeScript
import React from "react";
|
|
import { Stack, Text, Select, Switch } from "@mantine/core";
|
|
import { useTranslation } from "react-i18next";
|
|
import { COLOR_TYPES, FIT_OPTIONS } from "../../../constants/convertConstants";
|
|
import { ConvertParameters } from "../../../hooks/tools/convert/useConvertParameters";
|
|
|
|
interface ConvertFromImageSettingsProps {
|
|
parameters: ConvertParameters;
|
|
onParameterChange: (key: keyof ConvertParameters, value: any) => void;
|
|
disabled?: boolean;
|
|
}
|
|
|
|
const ConvertFromImageSettings = ({
|
|
parameters,
|
|
onParameterChange,
|
|
disabled = false
|
|
}: ConvertFromImageSettingsProps) => {
|
|
const { t } = useTranslation();
|
|
|
|
return (
|
|
<Stack gap="sm" data-testid="pdf-options-section">
|
|
<Text size="sm" fw={500}>{t("convert.pdfOptions", "PDF Options")}:</Text>
|
|
<Select
|
|
data-testid="color-type-select"
|
|
label={t("convert.colorType", "Color Type")}
|
|
value={parameters.imageOptions.colorType}
|
|
onChange={(val) => val && onParameterChange('imageOptions', {
|
|
...parameters.imageOptions,
|
|
colorType: val as typeof COLOR_TYPES[keyof typeof COLOR_TYPES]
|
|
})}
|
|
data={[
|
|
{ value: COLOR_TYPES.COLOR, label: t("convert.color", "Color") },
|
|
{ value: COLOR_TYPES.GREYSCALE, label: t("convert.greyscale", "Greyscale") },
|
|
{ value: COLOR_TYPES.BLACK_WHITE, label: t("convert.blackwhite", "Black & White") },
|
|
]}
|
|
disabled={disabled}
|
|
/>
|
|
|
|
<Select
|
|
data-testid="fit-option-select"
|
|
label={t("convert.fitOption", "Fit Option")}
|
|
value={parameters.imageOptions.fitOption}
|
|
onChange={(val) => val && onParameterChange('imageOptions', {
|
|
...parameters.imageOptions,
|
|
fitOption: val as typeof FIT_OPTIONS[keyof typeof FIT_OPTIONS]
|
|
})}
|
|
data={[
|
|
{ value: FIT_OPTIONS.MAINTAIN_ASPECT, label: t("convert.maintainAspectRatio", "Maintain Aspect Ratio") },
|
|
{ value: FIT_OPTIONS.FIT_PAGE, label: t("convert.fitDocumentToPage", "Fit Document to Page") },
|
|
{ value: FIT_OPTIONS.FILL_PAGE, label: t("convert.fillPage", "Fill Page") },
|
|
]}
|
|
disabled={disabled}
|
|
/>
|
|
|
|
<Switch
|
|
data-testid="auto-rotate-switch"
|
|
label={t("convert.autoRotate", "Auto Rotate")}
|
|
description={t("convert.autoRotateDescription", "Automatically rotate images to better fit the PDF page")}
|
|
checked={parameters.imageOptions.autoRotate}
|
|
onChange={(event) => onParameterChange('imageOptions', {
|
|
...parameters.imageOptions,
|
|
autoRotate: event.currentTarget.checked
|
|
})}
|
|
disabled={disabled}
|
|
/>
|
|
|
|
<Switch
|
|
data-testid="combine-images-switch"
|
|
label={t("convert.combineImages", "Combine Images")}
|
|
description={t("convert.combineImagesDescription", "Combine all images into one PDF, or create separate PDFs for each image")}
|
|
checked={parameters.imageOptions.combineImages}
|
|
onChange={(event) => onParameterChange('imageOptions', {
|
|
...parameters.imageOptions,
|
|
combineImages: event.currentTarget.checked
|
|
})}
|
|
disabled={disabled}
|
|
/>
|
|
</Stack>
|
|
);
|
|
};
|
|
|
|
export default ConvertFromImageSettings; |