Adds a new "astro:build:generated" hook for SSG builds

[tony-sull]

This feature was originally reviewed in #4772 but accidentally merged in as a minor release too early. #4774 reverted the feature to avoid blocking patch releases

---

Changes

This adds a new astro:build:generated hook that runs after all SSG pages are generated but before build artifacts are cleaned up.

Why?

This handles a very specific use case for @astrojs/image. The new wasm-based image service uses a worker pool to build multiple images in parallel. The workers need to reference the build's main entrypoint bundle before it's removed by the cleanup process

Alternatives considered

• fire astro:build:done before the cleanup process

This would technically be a breaking change, and feels a little gross in general since the build really isn't done until it's finished cleanup and is exiting

• refactor the SSG image service to build images during the page generation rather than building all images at the end.

This is a huge performance hit, doing all images at once allows the process to read a local image file once and build all needed versions at once without hitting fs.readFile again

Testing

Test added to make sure the event fires with the correct output directory

Docs

Docs PR #1572

/cc @withastro/maintainers-docs for feedback!

[changeset-bot]

🦋 Changeset detected

Latest commit: 74c8133

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

This PR includes changesets to release 16 packages

Name	Type
astro	Minor
@e2e/astro-component	Patch
@e2e/error-cyclic	Patch
@e2e/error-react-spectrum	Patch
@e2e/error-sass	Patch
@e2e/errors	Patch
@e2e/hydration-race	Patch
@e2e/lit-component	Patch
@e2e/preact-component	Patch
@e2e/react-component	Patch
@e2e/solid-component	Patch
@e2e/solid-recurse	Patch
@e2e/svelte-component	Patch
@e2e/e2e-tailwindcss	Patch
@e2e/ts-resolution	Patch
@e2e/third-party-astro	Patch

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

[sarah11918]

Unrequested Docs Maintainers review, since this was triggered automatically by a change to @types/astro.ts. But, changes don't affect public-facing docs on configuration-reference page. We're on the separate Docs PR for this one!