feat(autoware_cmake): support USE_SCOPED_HEADER_INSTALL_DIR in autoware_ament_auto_package

[vish0012]

Description

This PR updates autoware_ament_auto_package() to support USE_SCOPED_HEADER_INSTALL_DIR.

This change is based on the scoped header installation investigation for avoiding resolution against apt-installed Autoware packages and prioritizing vcs-imported source packages.

Changes:

• parse USE_SCOPED_HEADER_INSTALL_DIR in cmake_parse_arguments()
• avoid forwarding this custom argument to ament_package()
• install and export headers under include/${PROJECT_NAME} when the option is enabled
• keep the default flat include behavior when the option is not enabled

This fixes the configure-time error on Humble where ament_package() receives an unsupported argument, and also makes the scoped header install option actually functional.

How was this PR tested?

Tested with clean build investigation using autoware_point_types.

Before the fix, enabling USE_SCOPED_HEADER_INSTALL_DIR caused:

ament_package() called with unused arguments: USE_SCOPED_HEADER_INSTALL_DIR

After this change:

• build succeeds while keeping USE_SCOPED_HEADER_INSTALL_DIR enabled
• headers are installed under the scoped path as expected

Notes for reviewers

This is the base change needed before replacing ament_auto_package() with autoware_ament_auto_package() in affected packages.

Effects on system behavior

None, unless USE_SCOPED_HEADER_INSTALL_DIR is explicitly enabled.

[github-actions]

Thank you for contributing to the Autoware project!

🚧 If your pull request is in progress, switch it to draft mode.

Please ensure:

• You've checked our contribution guidelines.
• Your PR follows our pull request guidelines.
• All required CI checks pass before marking the PR ready for review.