saulteafarmer/Stirling-PDF
1
0
Fork 0
mirror of https://github.com/Stirling-Tools/Stirling-PDF.git synced 2025-09-18 01:19:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

Flattern Split by size, count and document

Browse Source
This commit is contained in:
Connor Yoh 2025-09-12 14:18:33 +01:00
parent 8a367aab54
commit b2032023f8
4 changed files with 90 additions and 69 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
frontend/src/components/tools/split/SplitSettings.tsx
View File

@ -1,6 +1,6 @@
import { Stack, TextInput, Select, Checkbox } from '@mantine/core'; import { Stack, TextInput, Select, Checkbox } from '@mantine/core';
import { useTranslation } from 'react-i18next'; import { useTranslation } from 'react-i18next';
import { isSplitMode, isSplitType, SPLIT_MODES, SPLIT_TYPES } from '../../../constants/splitConstants'; import { isSplitMethod, SPLIT_METHODS, METHOD_TO_SPLIT_TYPE, SPLIT_TYPES } from '../../../constants/splitConstants';
import { SplitParameters } from '../../../hooks/tools/split/useSplitParameters'; import { SplitParameters } from '../../../hooks/tools/split/useSplitParameters';
export interface SplitSettingsProps { export interface SplitSettingsProps {
@ -57,27 +57,14 @@ const SplitSettings = ({
</Stack> </Stack>
); );
const renderBySizeOrCountForm = () => ( const renderSplitValueForm = () => (
<Stack gap="sm"> <TextInput
<Select label={t("split-by-size-or-count.value.label", "Split Value")}
label={t("split-by-size-or-count.type.label", "Split Type")} placeholder={t("split-by-size-or-count.value.placeholder", "e.g. 10MB or 5 pages")}
value={parameters.splitType} value={parameters.splitValue}
onChange={(v) => isSplitType(v) && onParameterChange('splitType', v)} onChange={(e) => onParameterChange('splitValue', e.target.value)}
disabled={disabled} disabled={disabled}
data={[ />
{ value: SPLIT_TYPES.SIZE, label: t("split-by-size-or-count.type.size", "By Size") },
{ value: SPLIT_TYPES.PAGES, label: t("split-by-size-or-count.type.pageCount", "By Page Count") },
{ value: SPLIT_TYPES.DOCS, label: t("split-by-size-or-count.type.docCount", "By Document Count") },
]}
/>
<TextInput
label={t("split-by-size-or-count.value.label", "Split Value")}
placeholder={t("split-by-size-or-count.value.placeholder", "e.g. 10MB or 5 pages")}
value={parameters.splitValue}
onChange={(e) => onParameterChange('splitValue', e.target.value)}
disabled={disabled}
/>
</Stack>
); );
const renderByChaptersForm = () => ( const renderByChaptersForm = () => (
@ -106,26 +93,30 @@ const SplitSettings = ({
return ( return (
<Stack gap="md"> <Stack gap="md">
{/* Mode Selector */} {/* Method Selector */}
<Select <Select
label="Choose split method" label={t("split.method.label", "Choose split method")}
placeholder="Select how to split the PDF" placeholder={t("split.method.placeholder", "Select how to split the PDF")}
value={parameters.mode} value={parameters.method}
onChange={(v) => isSplitMode(v) && onParameterChange('mode', v)} onChange={(v) => isSplitMethod(v) && onParameterChange('method', v)}
disabled={disabled} disabled={disabled}
data={[ data={[
{ value: SPLIT_MODES.BY_PAGES, label: t("split.header", "Split by Pages") + " (e.g. 1,3,5-10)" }, { value: SPLIT_METHODS.BY_PAGES, label: t("split.header", "Split by Pages") + " (e.g. 1,3,5-10)" },
{ value: SPLIT_MODES.BY_SECTIONS, label: t("split-by-sections.title", "Split by Grid Sections") }, { value: SPLIT_METHODS.BY_SECTIONS, label: t("split-by-sections.title", "Split by Grid Sections") },
{ value: SPLIT_MODES.BY_SIZE_OR_COUNT, label: t("split-by-size-or-count.title", "Split by Size or Count") }, { value: SPLIT_METHODS.BY_SIZE, label: t("split-by-size-or-count.type.size", "By Size") },
{ value: SPLIT_MODES.BY_CHAPTERS, label: t("splitByChapters.title", "Split by Chapters") }, { value: SPLIT_METHODS.BY_PAGE_COUNT, label: t("split-by-size-or-count.type.pageCount", "By Page Count") },
{ value: SPLIT_METHODS.BY_DOC_COUNT, label: t("split-by-size-or-count.type.docCount", "By Document Count") },
{ value: SPLIT_METHODS.BY_CHAPTERS, label: t("splitByChapters.title", "Split by Chapters") },
]} ]}
/> />
{/* Parameter Form */} {/* Parameter Form */}
{parameters.mode === SPLIT_MODES.BY_PAGES && renderByPagesForm()} {parameters.method === SPLIT_METHODS.BY_PAGES && renderByPagesForm()}
{parameters.mode === SPLIT_MODES.BY_SECTIONS && renderBySectionsForm()} {parameters.method === SPLIT_METHODS.BY_SECTIONS && renderBySectionsForm()}
{parameters.mode === SPLIT_MODES.BY_SIZE_OR_COUNT && renderBySizeOrCountForm()} {(parameters.method === SPLIT_METHODS.BY_SIZE ||
{parameters.mode === SPLIT_MODES.BY_CHAPTERS && renderByChaptersForm()} parameters.method === SPLIT_METHODS.BY_PAGE_COUNT ||
parameters.method === SPLIT_METHODS.BY_DOC_COUNT) && renderSplitValueForm()}
{parameters.method === SPLIT_METHODS.BY_CHAPTERS && renderByChaptersForm()}
</Stack> </Stack>
); );
} }

31
frontend/src/constants/splitConstants.ts
View File

@ -1,3 +1,13 @@
export const SPLIT_METHODS = {
BY_PAGES: 'byPages',
BY_SECTIONS: 'bySections',
BY_SIZE: 'bySize',
BY_PAGE_COUNT: 'byPageCount',
BY_DOC_COUNT: 'byDocCount',
BY_CHAPTERS: 'byChapters'
} as const;
// Legacy constants for backward compatibility
export const SPLIT_MODES = { export const SPLIT_MODES = {
BY_PAGES: 'byPages', BY_PAGES: 'byPages',
BY_SECTIONS: 'bySections', BY_SECTIONS: 'bySections',
@ -12,15 +22,28 @@ export const SPLIT_TYPES = {
} as const; } as const;
export const ENDPOINTS = { export const ENDPOINTS = {
[SPLIT_MODES.BY_PAGES]: 'split-pages', [SPLIT_METHODS.BY_PAGES]: 'split-pages',
[SPLIT_MODES.BY_SECTIONS]: 'split-pdf-by-sections', [SPLIT_METHODS.BY_SECTIONS]: 'split-pdf-by-sections',
[SPLIT_MODES.BY_SIZE_OR_COUNT]: 'split-by-size-or-count', [SPLIT_METHODS.BY_SIZE]: 'split-by-size-or-count',
[SPLIT_MODES.BY_CHAPTERS]: 'split-pdf-by-chapters' [SPLIT_METHODS.BY_PAGE_COUNT]: 'split-by-size-or-count',
[SPLIT_METHODS.BY_DOC_COUNT]: 'split-by-size-or-count',
[SPLIT_METHODS.BY_CHAPTERS]: 'split-pdf-by-chapters'
} as const; } as const;
export const METHOD_TO_SPLIT_TYPE = {
[SPLIT_METHODS.BY_SIZE]: SPLIT_TYPES.SIZE,
[SPLIT_METHODS.BY_PAGE_COUNT]: SPLIT_TYPES.PAGES,
[SPLIT_METHODS.BY_DOC_COUNT]: SPLIT_TYPES.DOCS
} as const;
export type SplitMethod = typeof SPLIT_METHODS[keyof typeof SPLIT_METHODS];
export type SplitMode = typeof SPLIT_MODES[keyof typeof SPLIT_MODES]; export type SplitMode = typeof SPLIT_MODES[keyof typeof SPLIT_MODES];
export type SplitType = typeof SPLIT_TYPES[keyof typeof SPLIT_TYPES]; export type SplitType = typeof SPLIT_TYPES[keyof typeof SPLIT_TYPES];
export const isSplitMethod = (value: string | null): value is SplitMethod => {
return Object.values(SPLIT_METHODS).includes(value as SplitMethod);
}
export const isSplitMode = (value: string | null): value is SplitMode => { export const isSplitMode = (value: string | null): value is SplitMode => {
return Object.values(SPLIT_MODES).includes(value as SplitMode); return Object.values(SPLIT_MODES).includes(value as SplitMode);
} }

41
frontend/src/hooks/tools/split/useSplitOperation.ts
View File

@ -3,7 +3,7 @@ import { useTranslation } from 'react-i18next';
import { ToolType, useToolOperation, ToolOperationConfig } from '../shared/useToolOperation'; import { ToolType, useToolOperation, ToolOperationConfig } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler'; import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
import { SplitParameters, defaultParameters } from './useSplitParameters'; import { SplitParameters, defaultParameters } from './useSplitParameters';
import { SPLIT_MODES } from '../../../constants/splitConstants'; import { SPLIT_METHODS, METHOD_TO_SPLIT_TYPE } from '../../../constants/splitConstants';
import { useToolResources } from '../shared/useToolResources'; import { useToolResources } from '../shared/useToolResources';
// Static functions that can be used by both the hook and automation executor // Static functions that can be used by both the hook and automation executor
@ -12,46 +12,53 @@ export const buildSplitFormData = (parameters: SplitParameters, file: File): For
formData.append("fileInput", file); formData.append("fileInput", file);
switch (parameters.mode) { switch (parameters.method) {
case SPLIT_MODES.BY_PAGES: case SPLIT_METHODS.BY_PAGES:
formData.append("pageNumbers", parameters.pages); formData.append("pageNumbers", parameters.pages);
break; break;
case SPLIT_MODES.BY_SECTIONS: case SPLIT_METHODS.BY_SECTIONS:
formData.append("horizontalDivisions", parameters.hDiv); formData.append("horizontalDivisions", parameters.hDiv);
formData.append("verticalDivisions", parameters.vDiv); formData.append("verticalDivisions", parameters.vDiv);
formData.append("merge", parameters.merge.toString()); formData.append("merge", parameters.merge.toString());
break; break;
case SPLIT_MODES.BY_SIZE_OR_COUNT: case SPLIT_METHODS.BY_SIZE:
formData.append( formData.append("splitType", "0");
"splitType",
parameters.splitType === "size" ? "0" : parameters.splitType === "pages" ? "1" : "2"
);
formData.append("splitValue", parameters.splitValue); formData.append("splitValue", parameters.splitValue);
break; break;
case SPLIT_MODES.BY_CHAPTERS: case SPLIT_METHODS.BY_PAGE_COUNT:
formData.append("splitType", "1");
formData.append("splitValue", parameters.splitValue);
break;
case SPLIT_METHODS.BY_DOC_COUNT:
formData.append("splitType", "2");
formData.append("splitValue", parameters.splitValue);
break;
case SPLIT_METHODS.BY_CHAPTERS:
formData.append("bookmarkLevel", parameters.bookmarkLevel); formData.append("bookmarkLevel", parameters.bookmarkLevel);
formData.append("includeMetadata", parameters.includeMetadata.toString()); formData.append("includeMetadata", parameters.includeMetadata.toString());
formData.append("allowDuplicates", parameters.allowDuplicates.toString()); formData.append("allowDuplicates", parameters.allowDuplicates.toString());
break; break;
default: default:
throw new Error(`Unknown split mode: ${parameters.mode}`); throw new Error(`Unknown split method: ${parameters.method}`);
} }
return formData; return formData;
}; };
export const getSplitEndpoint = (parameters: SplitParameters): string => { export const getSplitEndpoint = (parameters: SplitParameters): string => {
switch (parameters.mode) { switch (parameters.method) {
case SPLIT_MODES.BY_PAGES: case SPLIT_METHODS.BY_PAGES:
return "/api/v1/general/split-pages"; return "/api/v1/general/split-pages";
case SPLIT_MODES.BY_SECTIONS: case SPLIT_METHODS.BY_SECTIONS:
return "/api/v1/general/split-pdf-by-sections"; return "/api/v1/general/split-pdf-by-sections";
case SPLIT_MODES.BY_SIZE_OR_COUNT: case SPLIT_METHODS.BY_SIZE:
case SPLIT_METHODS.BY_PAGE_COUNT:
case SPLIT_METHODS.BY_DOC_COUNT:
return "/api/v1/general/split-by-size-or-count"; return "/api/v1/general/split-by-size-or-count";
case SPLIT_MODES.BY_CHAPTERS: case SPLIT_METHODS.BY_CHAPTERS:
return "/api/v1/general/split-pdf-by-chapters"; return "/api/v1/general/split-pdf-by-chapters";
default: default:
throw new Error(`Unknown split mode: ${parameters.mode}`); throw new Error(`Unknown split method: ${parameters.method}`);
} }
}; };

26
frontend/src/hooks/tools/split/useSplitParameters.ts
View File

@ -1,14 +1,13 @@
import { SPLIT_MODES, SPLIT_TYPES, ENDPOINTS, type SplitMode, SplitType } from '../../../constants/splitConstants'; import { SPLIT_METHODS, SPLIT_MODES, SPLIT_TYPES, ENDPOINTS, METHOD_TO_SPLIT_TYPE, type SplitMethod, SplitMode, SplitType } from '../../../constants/splitConstants';
import { BaseParameters } from '../../../types/parameters'; import { BaseParameters } from '../../../types/parameters';
import { useBaseParameters, BaseParametersHook } from '../shared/useBaseParameters'; import { useBaseParameters, BaseParametersHook } from '../shared/useBaseParameters';
export interface SplitParameters extends BaseParameters { export interface SplitParameters extends BaseParameters {
mode: SplitMode | ''; method: SplitMethod | '';
pages: string; pages: string;
hDiv: string; hDiv: string;
vDiv: string; vDiv: string;
merge: boolean; merge: boolean;
splitType: SplitType | '';
splitValue: string; splitValue: string;
bookmarkLevel: string; bookmarkLevel: string;
includeMetadata: boolean; includeMetadata: boolean;
@ -18,12 +17,11 @@ export interface SplitParameters extends BaseParameters {
export type SplitParametersHook = BaseParametersHook<SplitParameters>; export type SplitParametersHook = BaseParametersHook<SplitParameters>;
export const defaultParameters: SplitParameters = { export const defaultParameters: SplitParameters = {
mode: '', method: '',
pages: '', pages: '',
hDiv: '2', hDiv: '2',
vDiv: '2', vDiv: '2',
merge: false, merge: false,
splitType: SPLIT_TYPES.SIZE,
splitValue: '', splitValue: '',
bookmarkLevel: '1', bookmarkLevel: '1',
includeMetadata: false, includeMetadata: false,
@ -34,20 +32,22 @@ export const useSplitParameters = (): SplitParametersHook => {
return useBaseParameters({ return useBaseParameters({
defaultParameters, defaultParameters,
endpointName: (params) => { endpointName: (params) => {
if (!params.mode) return ENDPOINTS[SPLIT_MODES.BY_PAGES]; if (!params.method) return ENDPOINTS[SPLIT_METHODS.BY_PAGES];
return ENDPOINTS[params.mode as SplitMode]; return ENDPOINTS[params.method as SplitMethod];
}, },
validateFn: (params) => { validateFn: (params) => {
if (!params.mode) return false; if (!params.method) return false;
switch (params.mode) { switch (params.method) {
case SPLIT_MODES.BY_PAGES: case SPLIT_METHODS.BY_PAGES:
return params.pages.trim() !== ""; return params.pages.trim() !== "";
case SPLIT_MODES.BY_SECTIONS: case SPLIT_METHODS.BY_SECTIONS:
return params.hDiv !== "" && params.vDiv !== ""; return params.hDiv !== "" && params.vDiv !== "";
case SPLIT_MODES.BY_SIZE_OR_COUNT: case SPLIT_METHODS.BY_SIZE:
case SPLIT_METHODS.BY_PAGE_COUNT:
case SPLIT_METHODS.BY_DOC_COUNT:
return params.splitValue.trim() !== ""; return params.splitValue.trim() !== "";
case SPLIT_MODES.BY_CHAPTERS: case SPLIT_METHODS.BY_CHAPTERS:
return params.bookmarkLevel !== ""; return params.bookmarkLevel !== "";
default: default:
return false; return false;