Feature/v2/remove pages (#4445)

# Description of Changes

- Addition of the remove pages tool
- Addition of the remove blank pages tool

---

## Checklist

### General

- [ ] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [ ] I have read the [Stirling-PDF Developer
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md)
(if applicable)
- [ ] I have read the [How to add new languages to
Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md)
(if applicable)
- [ ] I have performed a self-review of my own code
- [ ] My changes generate no new warnings

### Documentation

- [ ] I have updated relevant docs on [Stirling-PDF's doc
repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/)
(if functionality has heavily changed)
- [ ] I have read the section [Add New Translation
Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags)
(for new translation tags only)

### UI Changes (if applicable)

- [ ] Screenshots or videos demonstrating the UI changes are attached
(e.g., as comments or direct attachments in the PR)

### Testing (if applicable)

- [ ] I have tested my changes locally. Refer to the [Testing
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing)
for more details.

frontend/src/hooks/tools/removeBlanks/useRemoveBlanksOperation.ts

@@ -0,0 +1,43 @@
+import { useCallback } from 'react';
+import { useTranslation } from 'react-i18next';
+import { ToolType, useToolOperation, ToolOperationConfig } from '../shared/useToolOperation';
+import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
+import { RemoveBlanksParameters, defaultParameters } from './useRemoveBlanksParameters';
+import { useToolResources } from '../shared/useToolResources';
+
+export const buildRemoveBlanksFormData = (parameters: RemoveBlanksParameters, file: File): FormData => {
+  const formData = new FormData();
+  formData.append('fileInput', file);
+  formData.append('threshold', String(parameters.threshold));
+  formData.append('whitePercent', String(parameters.whitePercent));
+  // Note: includeBlankPages is not sent to backend as it always returns both files in a ZIP
+  return formData;
+};
+
+export const removeBlanksOperationConfig = {
+  toolType: ToolType.singleFile,
+  buildFormData: buildRemoveBlanksFormData,
+  operationType: 'remove-blanks',
+  endpoint: '/api/v1/misc/remove-blanks',
+  defaultParameters,
+} as const satisfies ToolOperationConfig<RemoveBlanksParameters>;
+
+export const useRemoveBlanksOperation = () => {
+  const { t } = useTranslation();
+  const { extractZipFiles } = useToolResources();
+
+  const responseHandler = useCallback(async (blob: Blob): Promise<File[]> => {
+    // Backend always returns a ZIP file containing the processed PDFs
+    return await extractZipFiles(blob);
+  }, [extractZipFiles]);
+
+  return useToolOperation<RemoveBlanksParameters>({
+    ...removeBlanksOperationConfig,
+    responseHandler,
+    getErrorMessage: createStandardErrorHandler(
+      t('removeBlanks.error.failed', 'Failed to remove blank pages')
+    )
+  });
+};
+
+

frontend/src/hooks/tools/removeBlanks/useRemoveBlanksParameters.ts

@@ -0,0 +1,26 @@
+import { BaseParameters } from '../../../types/parameters';
+import { useBaseParameters, BaseParametersHook } from '../shared/useBaseParameters';
+
+export interface RemoveBlanksParameters extends BaseParameters {
+  threshold: number; // 0-255
+  whitePercent: number; // 0.1-100
+  includeBlankPages: boolean; // whether to include detected blank pages in output
+}
+
+export const defaultParameters: RemoveBlanksParameters = {
+  threshold: 10,
+  whitePercent: 99.9,
+  includeBlankPages: false,
+};
+
+export type RemoveBlanksParametersHook = BaseParametersHook<RemoveBlanksParameters>;
+
+export const useRemoveBlanksParameters = (): RemoveBlanksParametersHook => {
+  return useBaseParameters({
+    defaultParameters,
+    endpointName: 'remove-blanks',
+    validateFn: (p) => p.threshold >= 0 && p.threshold <= 255 && p.whitePercent > 0 && p.whitePercent <= 100,
+  });
+};
+
+

frontend/src/hooks/tools/removePages/useRemovePagesOperation.ts

@@ -0,0 +1,32 @@
+import { useTranslation } from 'react-i18next';
+import { ToolType, useToolOperation, ToolOperationConfig } from '../shared/useToolOperation';
+import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
+import { RemovePagesParameters, defaultParameters } from './useRemovePagesParameters';
+// import { useToolResources } from '../shared/useToolResources';
+
+export const buildRemovePagesFormData = (parameters: RemovePagesParameters, file: File): FormData => {
+  const formData = new FormData();
+  formData.append('fileInput', file);
+  const cleaned = parameters.pageNumbers.replace(/\s+/g, '');
+  formData.append('pageNumbers', cleaned);
+  return formData;
+};
+
+export const removePagesOperationConfig = {
+  toolType: ToolType.singleFile,
+  buildFormData: buildRemovePagesFormData,
+  operationType: 'remove-pages',
+  endpoint: '/api/v1/general/remove-pages',
+  defaultParameters,
+} as const satisfies ToolOperationConfig<RemovePagesParameters>;
+
+export const useRemovePagesOperation = () => {
+  const { t } = useTranslation();
+
+  return useToolOperation<RemovePagesParameters>({
+    ...removePagesOperationConfig,
+    getErrorMessage: createStandardErrorHandler(
+      t('removePages.error.failed', 'Failed to remove pages')
+    )
+  });
+};

frontend/src/hooks/tools/removePages/useRemovePagesParameters.ts

@@ -0,0 +1,21 @@
+import { BaseParameters } from '../../../types/parameters';
+import { useBaseParameters, BaseParametersHook } from '../shared/useBaseParameters';
+import { validatePageNumbers } from '../../../utils/pageSelection';
+
+export interface RemovePagesParameters extends BaseParameters {
+  pageNumbers: string; // comma-separated page numbers or ranges (e.g., "1,3,5-8")
+}
+
+export const defaultParameters: RemovePagesParameters = {
+  pageNumbers: '',
+};
+
+export type RemovePagesParametersHook = BaseParametersHook<RemovePagesParameters>;
+
+export const useRemovePagesParameters = (): RemovePagesParametersHook => {
+  return useBaseParameters({
+    defaultParameters,
+    endpointName: 'remove-pages',
+    validateFn: (p) => validatePageNumbers(p.pageNumbers),
+  });
+};