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.
2026-07-15 02:54:06 +02:00 · 2025-09-18 09:51:55 +01:00
parent 7ff1c66d09
commit 756cbc4780
14 changed files with 626 additions and 20 deletions
@@ -0,0 +1,75 @@
+import { Stack, Text, Checkbox, Slider, NumberInput, Group } from "@mantine/core";
+import { useTranslation } from "react-i18next";
+import NumberInputWithUnit from "../shared/NumberInputWithUnit";
+import { RemoveBlanksParameters } from "../../../hooks/tools/removeBlanks/useRemoveBlanksParameters";
+
+interface RemoveBlanksSettingsProps {
+  parameters: RemoveBlanksParameters;
+  onParameterChange: <K extends keyof RemoveBlanksParameters>(key: K, value: RemoveBlanksParameters[K]) => void;
+  disabled?: boolean;
+}
+
+const RemoveBlanksSettings = ({ parameters, onParameterChange, disabled = false }: RemoveBlanksSettingsProps) => {
+  const { t } = useTranslation();
+
+  return (
+    <Stack gap="lg" mt="md">
+      <Stack gap="xs">
+        <NumberInputWithUnit
+          label={t('removeBlanks.threshold.label', 'Pixel Whiteness Threshold')}
+          value={parameters.threshold}
+          onChange={(v) => onParameterChange('threshold', typeof v === 'string' ? Number(v) : v)}
+          unit=''
+          min={0}
+          max={255}
+          disabled={disabled}
+        />
+      </Stack>
+
+      <Stack gap="xs">
+        <Text size="sm" fw={500}>
+          {t('removeBlanks.whitePercent.label', 'White Percent')}
+        </Text>
+        <Group align="center">
+          <NumberInput
+            value={parameters.whitePercent}
+            onChange={(v) => onParameterChange('whitePercent', typeof v === 'number' ? v : 0.1)}
+            min={0.1}
+            max={100}
+            step={0.1}
+            size="sm"
+            rightSection="%"
+            style={{ width: '80px' }}
+            disabled={disabled}
+          />
+          <Slider
+            value={parameters.whitePercent}
+            onChange={(value) => onParameterChange('whitePercent', value)}
+            min={0.1}
+            max={100}
+            step={0.1}
+            style={{ flex: 1 }}
+            disabled={disabled}
+          />
+        </Group>
+      </Stack>
+
+      <Stack gap="xs">
+        <Checkbox
+          checked={parameters.includeBlankPages}
+          onChange={(event) => onParameterChange('includeBlankPages', event.currentTarget.checked)}
+          disabled={disabled}
+          label={
+            <div>
+              <Text size="sm">{t('removeBlanks.includeBlankPages.label', 'Include detected blank pages')}</Text>
+            </div>
+          }
+        />
+      </Stack>
+    </Stack>
+  );
+};
+
+export default RemoveBlanksSettings;
+
+
@@ -0,0 +1,39 @@
+import { Stack, TextInput } from "@mantine/core";
+import { useTranslation } from "react-i18next";
+import { RemovePagesParameters } from "../../../hooks/tools/removePages/useRemovePagesParameters";
+import { validatePageNumbers } from "../../../utils/pageSelection";
+
+interface RemovePagesSettingsProps {
+  parameters: RemovePagesParameters;
+  onParameterChange: <K extends keyof RemovePagesParameters>(key: K, value: RemovePagesParameters[K]) => void;
+  disabled?: boolean;
+}
+
+const RemovePagesSettings = ({ parameters, onParameterChange, disabled = false }: RemovePagesSettingsProps) => {
+  const { t } = useTranslation();
+
+  const handlePageNumbersChange = (value: string) => {
+    // Allow user to type naturally - don't normalize input in real-time
+    onParameterChange('pageNumbers', value);
+  };
+
+  // Check if current input is valid
+  const isValid = validatePageNumbers(parameters.pageNumbers);
+  const hasValue = parameters.pageNumbers.trim().length > 0;
+
+  return (
+    <Stack gap="md">
+      <TextInput
+        label={t('removePages.pageNumbers.label', 'Pages to Remove')}
+        value={parameters.pageNumbers}
+        onChange={(event) => handlePageNumbersChange(event.currentTarget.value)}
+        placeholder={t('removePages.pageNumbers.placeholder', 'e.g., 1,3,5-8,10')}
+        disabled={disabled}
+        required
+        error={hasValue && !isValid ? t('removePages.pageNumbers.error', 'Invalid page number format. Use numbers, ranges (1-5), or mathematical expressions (2n+1)') : undefined}
+      />
+    </Stack>
+  );
+};
+
+export default RemovePagesSettings;
@@ -0,0 +1,41 @@
+import { useTranslation } from 'react-i18next';
+import { TooltipContent } from '../../types/tips';
+
+export const useRemoveBlanksTips = (): TooltipContent => {
+  const { t } = useTranslation();
+
+  return {
+    header: {
+      title: t("removeBlanks.tooltip.header.title", "Remove Blank Pages Settings"),
+    },
+    tips: [
+      {
+        title: t("removeBlanks.tooltip.threshold.title", "Pixel Whiteness Threshold"),
+        description: t("removeBlanks.tooltip.threshold.text", "Controls how white a pixel must be to be considered 'white'. This helps determine what counts as a blank area on the page."),
+        bullets: [
+          t("removeBlanks.tooltip.threshold.bullet1", "0 = Pure black (most restrictive)"),
+          t("removeBlanks.tooltip.threshold.bullet2", "128 = Medium gray"),
+          t("removeBlanks.tooltip.threshold.bullet3", "255 = Pure white (least restrictive)")
+        ]
+      },
+      {
+        title: t("removeBlanks.tooltip.whitePercent.title", "White Percentage Threshold"),
+        description: t("removeBlanks.tooltip.whitePercent.text", "Sets the minimum percentage of white pixels required for a page to be considered blank and removed."),
+        bullets: [
+          t("removeBlanks.tooltip.whitePercent.bullet1", "Lower values (e.g., 80%) = More pages removed"),
+          t("removeBlanks.tooltip.whitePercent.bullet2", "Higher values (e.g., 95%) = Only very blank pages removed"),
+          t("removeBlanks.tooltip.whitePercent.bullet3", "Use higher values for documents with light backgrounds")
+        ]
+      },
+      {
+        title: t("removeBlanks.tooltip.includeBlankPages.title", "Include Detected Blank Pages"),
+        description: t("removeBlanks.tooltip.includeBlankPages.text", "When enabled, creates a separate PDF containing all the blank pages that were detected and removed from the original document."),
+        bullets: [
+          t("removeBlanks.tooltip.includeBlankPages.bullet1", "Useful for reviewing what was removed"),
+          t("removeBlanks.tooltip.includeBlankPages.bullet2", "Helps verify the detection accuracy"),
+          t("removeBlanks.tooltip.includeBlankPages.bullet3", "Can be disabled to reduce output file size")
+        ]
+      }
+    ]
+  };
+};
@@ -0,0 +1,34 @@
+import { useTranslation } from 'react-i18next';
+import { TooltipContent } from '../../types/tips';
+
+export const useRemovePagesTips = (): TooltipContent => {
+  const { t } = useTranslation();
+
+  return {
+    header: {
+      title: t("removePages.tooltip.header.title", "Remove Pages Settings"),
+    },
+    tips: [
+      {
+        title: t("removePages.tooltip.pageNumbers.title", "Page Selection"),
+        description: t("removePages.tooltip.pageNumbers.text", "Specify which pages to remove from your PDF. You can select individual pages, ranges, or use mathematical expressions."),
+        bullets: [
+          t("removePages.tooltip.pageNumbers.bullet1", "Individual pages: 1,3,5 (removes pages 1, 3, and 5)"),
+          t("removePages.tooltip.pageNumbers.bullet2", "Page ranges: 1-5,10-15 (removes pages 1-5 and 10-15)"),
+          t("removePages.tooltip.pageNumbers.bullet3", "Mathematical: 2n+1 (removes odd pages)"),
+          t("removePages.tooltip.pageNumbers.bullet4", "Open ranges: 5- (removes from page 5 to end)")
+        ]
+      },
+      {
+        title: t("removePages.tooltip.examples.title", "Common Examples"),
+        description: t("removePages.tooltip.examples.text", "Here are some common page selection patterns:"),
+        bullets: [
+          t("removePages.tooltip.examples.bullet1", "Remove first page: 1"),
+          t("removePages.tooltip.examples.bullet2", "Remove last 3 pages: -3"),
+          t("removePages.tooltip.examples.bullet3", "Remove every other page: 2n"),
+          t("removePages.tooltip.examples.bullet4", "Remove specific scattered pages: 1,5,10,15")
+        ]
+      }
+    ]
+  };
+};