add the reorganize pages tool (#4506)

frontend/src/hooks/tools/reorganizePages/useReorganizePagesOperation.ts

@@ -0,0 +1,36 @@
+import { useTranslation } from 'react-i18next';
+import { ToolOperationConfig, ToolType, useToolOperation } from '../shared/useToolOperation';
+import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
+import { ReorganizePagesParameters } from './useReorganizePagesParameters';
+
+const buildFormData = (parameters: ReorganizePagesParameters, file: File): FormData => {
+  const formData = new FormData();
+  formData.append('fileInput', file);
+  if (parameters.customMode) {
+    formData.append('customMode', parameters.customMode);
+  }
+  if (parameters.pageNumbers) {
+    const cleaned = parameters.pageNumbers.replace(/\s+/g, '');
+    formData.append('pageNumbers', cleaned);
+  }
+  return formData;
+};
+
+export const reorganizePagesOperationConfig: ToolOperationConfig<ReorganizePagesParameters> = {
+  toolType: ToolType.singleFile,
+  buildFormData,
+  operationType: 'reorganizePages',
+  endpoint: '/api/v1/general/rearrange-pages',
+};
+
+export const useReorganizePagesOperation = () => {
+  const { t } = useTranslation();
+  return useToolOperation<ReorganizePagesParameters>({
+    ...reorganizePagesOperationConfig,
+    getErrorMessage: createStandardErrorHandler(
+      t('reorganizePages.error.failed', 'Failed to reorganize pages')
+    )
+  });
+};
+
+

frontend/src/hooks/tools/reorganizePages/useReorganizePagesParameters.ts

@@ -0,0 +1,39 @@
+import { useState } from 'react';
+
+export interface ReorganizePagesParameters {
+  customMode: string; // empty string means custom order using pageNumbers
+  pageNumbers: string; // e.g. "1,3,2,4-6"
+}
+
+export const defaultReorganizePagesParameters: ReorganizePagesParameters = {
+  customMode: '',
+  pageNumbers: '',
+};
+
+export const useReorganizePagesParameters = () => {
+  const [parameters, setParameters] = useState<ReorganizePagesParameters>(defaultReorganizePagesParameters);
+
+  const updateParameter = <K extends keyof ReorganizePagesParameters>(
+    key: K,
+    value: ReorganizePagesParameters[K]
+  ) => {
+    setParameters(prev => ({ ...prev, [key]: value }));
+  };
+
+  const resetParameters = () => setParameters(defaultReorganizePagesParameters);
+
+  // If customMode is '' (custom) or 'DUPLICATE', a page order is required; otherwise it's optional/ignored
+  const validateParameters = (): boolean => {
+    const requiresOrder = parameters.customMode === '' || parameters.customMode === 'DUPLICATE';
+    return requiresOrder ? parameters.pageNumbers.trim().length > 0 : true;
+  };
+
+  return {
+    parameters,
+    updateParameter,
+    resetParameters,
+    validateParameters,
+  };
+};
+
+