fix(aws-cdk-lib): make grants factory methods public

[mrgrain]

Issue # (if applicable)

N/A

Reason for this change

The grants factory methods BucketGrants.fromBucket() and StateMachineGrants.fromStateMachine() were marked as internal but are useful for construct authors who want to create custom grant patterns or extend existing grant functionality.

Description of changes

• Removed @internal JSDoc markers from factory methods
• Renamed methods from _fromBucket to fromBucket and _fromStateMachine to fromStateMachine to follow public API naming conventions
• Updated all internal usages to use the new public method names

This change makes it possible for construct authors to create grants objects for custom resources that implement IBucketRef or IStateMachineRef.

Describe any new or updated permissions being added

No new or updated IAM permissions are being added. This change only exposes existing grant functionality through a public API.

Description of how you validated changes

Existing unit tests continue to pass with the renamed methods.

Checklist

• My code adheres to the CONTRIBUTING GUIDE and DESIGN GUIDELINES

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[github-actions]

	Tests	Passed ❌️	Skipped	Failed
Security Guardian Results	0 ran	0 passed	0 skipped	0 failed

Test	Result
No test annotations available

• View Security Guardian Results

[github-actions]

	Tests	Passed ❌️	Skipped	Failed
Security Guardian Results with resolved templates	0 ran	0 passed	0 skipped	0 failed

Test	Result
No test annotations available

• View Security Guardian Results with resolved templates

[mergify]

Merge Queue Status

✅ The pull request has been merged

This pull request spent 5 seconds in the queue, with no time running CI.
The checks were run in-place.

Required conditions to merge

• #approved-reviews-by >= 1 [🛡 GitHub branch protection]
  • fix(aws-cdk-lib): make grants factory methods public #36317
• #changes-requested-reviews-by = 0 [🛡 GitHub branch protection]
  • fix(aws-cdk-lib): make grants factory methods public #36317
• any of [🛡 GitHub branch protection]:
  • check-success = validate-pr
  • check-neutral = validate-pr
  • check-skipped = validate-pr
• any of [🛡 GitHub branch protection]:
  • check-success = build
  • check-neutral = build
  • check-skipped = build

[mergify]

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

[github-actions]

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.