Stirling-PDF/frontend/src/core
Balázs Szücs 43a5f72b01
[V2] feat(crop): add auto-crop whitespace option to crop tool UI (#5275)
# Description of Changes

This pull request adds an auto-crop feature to the PDF crop tool,
allowing users to automatically crop whitespace from PDFs. The UI now
includes an "Auto-crop whitespace" checkbox, and when enabled, manual
crop controls are hidden. The crop operation logic and form data
submission have been updated to support this new option.

**Auto-crop Feature Implementation**

* Added an `autoCrop` boolean parameter to the `CropParameters`
interface and set its default value to `false` in
`useCropParameters.ts`.
* Updated the crop operation logic in `useCropOperation.ts` to include
the `autoCrop` parameter in the form data and only send manual crop
coordinates if `autoCrop` is disabled.

**User Interface Updates**

* Added an "Auto-crop whitespace" checkbox to the crop settings UI in
`CropSettings.tsx`, which toggles the auto-crop feature
* Modified the crop settings UI to hide manual crop controls and
validation alerts when auto-crop is enabled

**Localization**

* Added a new translation string for "Auto-crop whitespace" in the
English locale file `translation.toml`.



<img width="363" height="998" alt="image"
src="https://github.com/user-attachments/assets/a92988b8-eea0-47e7-961f-b4a6e018ff2f"
/>

<!--
Please provide a summary of the changes, including:

- What was changed
- Why the change was made
- Any challenges encountered

Closes #(issue_number)
-->

---

## Checklist

### General

- [X] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [X] 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)
- [X] I have performed a self-review of my own code
- [X] 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)

### Translations (if applicable)

- [ ] I ran
[`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md)

### UI Changes (if applicable)

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

### Testing (if applicable)

- [X] 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.

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>
2025-12-25 14:22:46 +00:00
..
components [V2] feat(crop): add auto-crop whitespace option to crop tool UI (#5275) 2025-12-25 14:22:46 +00:00
constants Shorten onbaording (#5198) 2025-12-15 09:31:41 +00:00
contexts added a flag to hide settings (#5263) 2025-12-24 20:56:22 +00:00
data Feature/annotations (#5260) 2025-12-18 15:47:54 +00:00
hooks [V2] feat(crop): add auto-crop whitespace option to crop tool UI (#5275) 2025-12-25 14:22:46 +00:00
i18n [V2] feat(pdfa): add PDF/A-3b option with updated descriptions and translations (#5286) 2025-12-22 15:17:47 +00:00
pages couple of small fixes for text editor (#5155) 2025-12-03 20:37:23 +00:00
services Shorten onbaording (#5198) 2025-12-15 09:31:41 +00:00
styles Fiix colours (#5211) 2025-12-10 11:10:34 +00:00
testing V1 merge (#5193) 2025-12-21 10:40:32 +00:00
tests Convert V2 translations to Toml 2025-11-26 14:13:54 +00:00
theme Restructure frontend code to allow for extensions (#4721) 2025-10-28 10:29:36 +00:00
tools Cleanup/v2/text editor (#5169) 2025-12-22 18:25:25 +00:00
types [V2] feat(getPdfInfo): add attachment, embedded file, and image info display (#5278) 2025-12-22 23:05:52 +00:00
utils Feature/annotations (#5260) 2025-12-18 15:47:54 +00:00
workers Feature/v2/compare tool (#4751) 2025-11-12 14:54:01 +00:00
App.tsx Chore/v2/onboarding flow cleanup (#5065) 2025-12-02 12:40:20 +00:00
i18n.ts Handle restricted language configuration fallback V2 (#5154) 2025-12-10 11:12:18 +00:00
setupTests.js Restructure frontend code to allow for extensions (#4721) 2025-10-28 10:29:36 +00:00
setupTests.ts OAuth Provider Buttons (#5103) 2025-12-03 10:54:53 +00:00