my idea

[Chaitanya-Parab]

This Pull Request fixes/closes #{4524}.

It changes the following:

• Proposes an approach for auditing and stabilizing Boa’s public API in preparation for the 1.0 release
• Outlines potential improvements such as:
  • Replacing public struct fields with getter methods to reduce future breaking changes
  • Adding #[non_exhaustive] to enums/structs where extensibility is expected
  • Reviewing visibility (pub vs pub(crate)) to minimize unnecessary API exposure
• Suggests an incremental, module-by-module approach with small, reviewable PRs

This PR does not introduce code changes but is intended to align on the approach and gather feedback before starting implementation.

Next steps (based on feedback):

• Identify specific modules for initial API audit
• Submit small PRs implementing the proposed changes
• Improve documentation and consistency across public APIs

[jedel1043]

Please open a new discussion instead of pushing docs to the repo.

[Chaitanya-Parab]

Closing this PR as per maintainer feedback. I’ll move this proposal to a discussion instead. Thanks!