[DRAFT] ITEP-66486 - Replace clipperjs Part 1

[jpggvilaca]

📝 Description

Previous PR was too big so i will make this change in multiple PRs.
This will be the biggest since it has 2.5k lines on the package-lock file alone

PR 1 (current)

• Add turf and geojson
• Add geometry-utils and its tests
• Replace clipper on selecting-tool

PR 2 (next)

• Replace a few more utils (clipper -> turf)

PR 3 (final)

• Replace leftover methods
• Uninstall clipperjs

✨ Type of Change

Select the type of change your PR introduces:

• 🐞 Bug fix – Non-breaking change which fixes an issue
• 🚀 New feature – Non-breaking change which adds functionality
• 🔨 Refactor – Non-breaking change which refactors the code base
• 💥 Breaking change – Changes that break existing functionality
• 📚 Documentation update
• 🔒 Security update
• 🧪 Tests

🧪 Testing Scenarios

Describe how the changes were tested and how reviewers can test them too:

• ✅ Tested manually
• 🤖 Run automated end-to-end tests

✅ Checklist

Before submitting the PR, ensure the following:

• 🔍 PR title is clear and descriptive
• 📝 For internal contributors: If applicable, include the JIRA ticket number (e.g., ITEP-123456) in the PR title. Do not include full URLs
• 💬 I have commented my code, especially in hard-to-understand areas
• 📄 I have made corresponding changes to the documentation
• ✅ I have added tests that prove my fix is effective or my feature works

[Copilot]

Pull Request Overview

This PR refactors the annotation intersection logic by replacing clipper-js operations with Turf-based geometry utilities and adds a new geometry-utils module. Key changes include:

• Removal of clipper-js imports and transformation logic in the selecting-tool utilities.
• Introduction of a new geometry-utils file that wraps Turf functions for various geometry operations.
• Addition of tests for the new geometry utilities.

Reviewed Changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 1 comment.

File	Description
web_ui/src/pages/annotator/tools/selecting-tool/utils.ts	Removed clipper-js logic and replaced it with a Turf-based shapesIntersect function to check geometry intersections.
web_ui/src/core/annotations/geometry-utils.ts	Introduced a suite of Turf-based functions for polygon conversion, area calculation, union/difference, and point-in-polygon checks.

Files not reviewed (1)

• web_ui/package.json: Language not supported

Comments suppressed due to low confidence (1)

web_ui/src/pages/annotator/tools/selecting-tool/utils.ts:44

• Ensure that the updated intersection logic using shapesIntersect is comprehensively covered by unit tests, verifying behavior that matches the previous clipper-js implementation.

if (shapesIntersect(shape, annotationShape)) {

[MarkRedeman]

What's the use case of geojson versus turf? From their readme it looks like it is very specific to geo-data (e.g. latitude and longitude information), do we need this to be able to use turf?

[jpggvilaca]

More context: https://turfjs.org/docs/getting-started#typescript . But perhaps i can add it to devDependencies?

[MarkRedeman]

Hmm but if they're only types then could we skip installing it completely? To me it would be fine if we don't use these type explicitly as they won't be part of any type contract.