[ENH] Add primitive type hints to segmentation module

[vickysharma-prog]

Reference Issues / PRs

Relates to #1454

---

What does this implement / fix?

This PR adds type hints for primitive and string parameters (int, float, bool, str) in the segmentation module, following the scope defined in issue #1454.

Files modified:

• aeon/segmentation/_clasp.py
• aeon/segmentation/_fluss.py
• aeon/segmentation/_binseg.py
• aeon/segmentation/_random.py
• aeon/segmentation/_eagglo.py

Changes made:

• Added type hints to function and constructor parameters with primitive defaults.
• Complex types (e.g., NumPy arrays, unions, optional types) were intentionally left unchanged to align with project guidance.
• No logic or behavior was modified.

Testing:

• All segmentation tests were executed locally and passed successfully ✅
• No new warnings introduced

---

Does your contribution introduce a new dependency?

No. This change does not introduce any new dependencies.

---

Additional comments

Please let me know if you'd prefer the scope to be split into smaller PRs or adjusted further.

---

PR Checklist

For all contributions

• I've added myself to the list of contributors (can be done after merge).
• The PR title starts with [ENH].

For new estimators and functions

• Not applicable — no new estimators or functions were added.

[aeon-actions-bot]

Thank you for contributing to aeon

I have added the following labels to this PR based on the title: [ enhancement ].
I have added the following labels to this PR based on the changes made: [ segmentation ]. Feel free to change these if they do not properly represent the PR.

The Checks tab will show the status of our automated tests. You can click on individual test runs in the tab or "Details" in the panel below to see more information if there is a failure.

If our pre-commit code quality check fails, any trivial fixes will automatically be pushed to your PR unless it is a draft.

Don't hesitate to ask questions on the aeon Discord channel if you have any.

PR CI actions

These checkboxes will add labels to enable/disable CI functionality for this PR. This may not take effect immediately, and a new commit may be required to run the new configuration.

• Run pre-commit checks for all files
• Run mypy typecheck tests
• Run all pytest tests and configurations
• Run all notebook example tests
• Run numba-disabled codecov tests
• Stop automatic pre-commit fixes (always disabled for drafts)
• Disable numba cache loading
• Regenerate expected results for testing
• Push an empty commit to re-run CI checks

[vickysharma-prog]

Hi maintainers
Just a gentle ping on this PR.
CI is now passing successfully
The earlier failure was related to the shallow clone / merge-base issue and is resolved.
PR is ready for review whenever convenient.
Thanks!

[vickysharma-prog]

Hi @MatthewMiddlehurst 👋
I’ve submitted PR #3252 adding type hints in segmentation — thanks for reviewing when you get a chance.
I’m looking to make my next contribution but finding it a bit hard to identify unclaimed issues that would be suitable for someone getting familiar with the codebase.
If you have any suggestions for good starter or medium-sized issues (bugs, enhancements, docs, or tests), I’d be happy to take them on.
Thanks!

[MatthewMiddlehurst]

Thank you for addressing the comments. Please view the failing test output.

[vickysharma-prog]

All checks passing now! Fixed the doctest issues in _random.py and resolved merge conflicts.
Ready for review whenever you get a chance. Thanks!

[MatthewMiddlehurst]

Please avoid force pushing in the future is makes reviewing more difficult.

[vickysharma-prog]

Hi @SebastianSchmidl
I've addressed all the feedback from your earlier review.
Could you please take another look when you get a chance?
Thanks!

[vickysharma-prog]

@MatthewMiddlehurst @SebastianSchmidl
Apologies for the force push - I had accidentally merged upstream/main
which added unrelated files to the PR. Force pushed to restore the
original clean state with only the 5 segmentation file changes.

The pre-commit CI is failing due to a shallow clone/merge-base issue
caused by the force push (Unable to locate commit sha: ae3293...).
This is not a code issue - all pre-commit checks pass locally.
All other 16 checks (pytest, ReadTheDocs, examples, imports) are passing.

Ready for re-review whenever you get a chance. Thanks and again apologies for my mistake!

[vickysharma-prog]

@MatthewMiddlehurst The failing test (test_kshapes in aeon/clustering/) is unrelated to my type hint changes in the segmentation module.
All segmentation tests pass locally (31 passed, 2 skipped).
This looks like an upstream issue or flaky test - happy to rebase once it's resolved!