refactor(motion_utils): apply clang-tidy result

[zulfaqar-azmi-t4]

Description

🤖[deprecated] Generated by Copilot at 29e9f44

This pull request improves the code quality, readability, and consistency of the motion_utils package, by refactoring, simplifying, and fixing some parts of the header and source files. It also updates the header include conventions to follow the ROS 2 style and the detail subdirectory for message struct headers.

Additional note

What are the things that is not fixed

1. Function case: not going to fix camelCase to snake_case
2. Narrowing conversion
3. Unincluded header due to extern template being used.

Tests performed

Not applicable.

Effects on system behavior

Not applicable.

Pre-review checklist for the PR author

The PR author must check the checkboxes below when creating the PR.

• I've confirmed the contribution guidelines.
• The PR follows the pull request guidelines.

In-review checklist for the PR reviewers

The PR reviewers must check the checkboxes below before approval.

• The PR follows the pull request guidelines.

Post-review checklist for the PR author

The PR author must check the checkboxes below before merging.

• There are no open discussions or they are tracked via tickets.

After all checkboxes are checked, anyone who has write access can merge the PR.

[codecov]

Codecov Report

Attention: 13 lines in your changes are missing coverage. Please review.

Comparison is base (f41d3fa) 15.28% compared to head (29e9f44) 15.26%.
Report is 5 commits behind head on main.

Files	Patch %	Lines
...ils/include/motion_utils/trajectory/trajectory.hpp	21.42%	6 Missing and 5 partials ⚠️
common/motion_utils/src/distance/distance.cpp	0.00%	0 Missing and 1 partial ⚠️
...n_utils/src/marker/virtual_wall_marker_creator.cpp	88.88%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5829      +/-   ##
==========================================
- Coverage   15.28%   15.26%   -0.03%     
==========================================
  Files        1739     1739              
  Lines      119756   120012     +256     
  Branches    36369    36446      +77     
==========================================
+ Hits        18301    18314      +13     
- Misses      80976    81214     +238     
- Partials    20479    20484       +5     

Flag	Coverage Δ		*Carryforward flag
differential	18.47% <55.17%> (?)
total	15.27% <ø> (-0.02%)	⬇️	Carriedforward from f41d3fa

*This pull request uses carry forward flags. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.