[Bug]: V2 - Clicking a single multi-select file sometimes highlights multiple files at once

[EthanHealy01]

Installation Method

Docker fat

The Problem

This happens after a couple of edge cases. Easiest way to replicate is to upload the same file 2-3 times from your computer into the file selector view. Selecting the 2nd file will highlight the 3rd and 4th file also.

Another way to replicate is when outputting files, changing settings, then outputting those files again.

SS1 & SS2: I uploaded an OCR file, going to process it with the "remove images after OCR setting". SS3 & SS4: After generating, I got the blank file (removed the OCR image), then I'll change the settings to include the images after OCR and I get the following SS5: When selecting either of those two outputs, it highlights both of them

Version of Stirling-PDF

2

Last Working Version of Stirling-PDF

N/A

Page Where the Problem Occurred

any page with multi-select files enabled

Docker Configuration

Relevant Log Output

Additional Information

No response

Browsers Affected

No response

No Duplicate of the Issue

• [x] I have verified that there are no existing issues raised related to my problem.

[dosubot[bot]]

Hi @EthanHealy01! I'm Dosu and I’m helping the Stirling-PDF team.

This is a newly identified issue in Stirling-PDF v2. The root cause is inconsistent use of unique file identifiers in the multi-select logic: while each file gets a unique ID on upload, the selection and highlighting logic often falls back to using file names, which can be duplicated if you upload the same file multiple times or regenerate outputs. This leads to multiple files being highlighted or selected together when only one should be, especially in edge cases like yours. There’s no official workaround or fix yet. For now, try to avoid uploading identical files or be aware that selection quirks may occur in these scenarios. A robust fix would require consistently using the unique file ID for all selection and highlighting logic throughout the UI and state management, rather than relying on file names or indices. This has been surfaced by recent frontend refactors and is not yet addressed in the current version source source.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}