feat: deduplicate context types

[florian-lefebvre]

Changes

• Found in feat: better internal types #15120
• Many types were duplicated, this cleans them up

Testing

Manually in examples, should pass

Docs

Changeset + jsdoc

[changeset-bot]

🦋 Changeset detected

Latest commit: 3f74cfa

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[codspeed-hq]

CodSpeed Performance Report

Merging this PR will not alter performance

_{Comparing feat/deduplicate-context-types (3f74cfa) with main (b1e8e32)}

Summary

✅ 6 untouched benchmarks

[ArmandPhilippot]

Sorry for the diff, not really easy to read... To summarize the commits I pushed, this:

• fixes the links to Astro Docs: most of the section has been renamed (this might be a good idea to check the other files exposing public APIs... I can add that to my TODO list)
• fixes props and params descriptions (not only static builds, and params was describing props)
• replaces a few things for consistency. Doing a search in the code base to check what is most commonly used:
  • "Example usage:" > ## Example
  • Reference > Astro reference as anchor for links
• rewords some descriptions to match what we have in the docs (not a full copy/paste, I only took inspiration from the docs) and add some examples to improve consistency between properties

For my last commit, in addition to having taken some wording from the docs, I was inspired by packages/astro/src/virtual-modules/i18n.ts that I recently updated. Hence the additional @params/@returns. I wasn't sure where to add them... they are not always in the same place in the file I linked... Maybe I should have done that in a separate commit if this is unwanted. 😅

I wasn't sure what you expected exactly regarding the structure. So, feel free to ask me additional changes, to revert some changes that might be too much, or to update my changes directly!

[florian-lefebvre]

Perfect thank you!

[Princesseuh]

Diff is a lot but as far as I can tell this looks great