Add option to suppress adapter feature support log

[yanthomasdev]

Changes

This adds a new suppress option to the supportedAstroFeatures of setAdapter in core. You can either set "all" to suppress both the default and custom log, or "default" to only suppress the default log.

The idea is that integration authors can suppress the log if a feature is supported in a specific condition, or if the default log can be conflicting and confuse users. You can take #13817 as an example of when this happens.

Originally, I intended to make suppress a boolean option while also changing so you only log the custom message if provided, but doing so would imply a breaking change (I think?). So I went with this solution.

Testing

Added a new fixture: packages/astro/test/fixtures/feature-support-message-suppresion

Not sure how I'd go about testing this automatically, but manually:

pnpm install
pnpm build
cd packages/astro/test/fixtures/feature-support-message-suppresion
pnpm dev

You should see that the dev server has only a "This should be logged." warning from [adapter]. You can see in the fixture that there's an example of both using a suppress: "default" and suppress: "all".

setAdapter({
  name: 'astro-test-feature-support-message-suppression',
  supportedAstroFeatures: {
    staticOutput: "stable",
    hybridOutput: "stable",
    serverOutput: {
      support: "experimental",
      message: "This should be logged.",
      suppress: "default",
    },
    sharpImageService: {
      support: 'limited',
      message: 'This shouldn\'t be logged.',
      suppress: "all",
    },
  }
})

Docs

PR: withastro/docs#11825

[changeset-bot]

🦋 Changeset detected

Latest commit: 7fbd8a6

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 #13842 will not alter performance

_{Comparing suppress-supported-features-log-option (908afe9) with main (fbcfa68)}

Summary

✅ 6 untouched benchmarks

[ematipico]

Thank you @yanthomasdev! This is a new feature, so we need to add a minor changeset. If you really want you could direct this PR to the cloudflare one and do everything in one go. The next minor is in two weeks, so we have time

[github-actions]

This PR is blocked because it contains a minor changeset. A reviewer will merge this at the next release if approved.

[ascorbic]

Just a few typos in docs, otherwise all good

[sarah11918]

Two tiny suggestions for the changeset @yanthomasdev , but the messages look fantastic!