[@astrojs/image] support additional resize options

[obennaci]

Changes

Add support for additional Sharp resize options; fit, position, background, kernel, withoutReduction and withoutEnlargement.

Fixes #4341

Testing

Manually so far.

Docs

• Adding the new props/options to docs

[changeset-bot]

🦋 Changeset detected

Latest commit: 12150e4

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

This PR includes changesets to release 1 package

Name	Type
@astrojs/image	Minor

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

[matthewp]

@obennaci still marked as draft, is this ready?

[obennaci]

Should be good now 👍

[tony-sull]

Thanks for opening this, @obennaci!

Looks like I missed the #4341 issue while traveling last week 👀 We're actually still a little too early in the @astrojs/image integration to add more complex transforms to the API right now, unfortunately.

We're working on making Squoosh the default image transformer to add support for web containers and Stackblitz. Sharp will still be an option, but we may paint ourselves into a corner adding support for sharp-specific features early on

I'm going to close this PR for now only because the integration needs a bit more time to bake to make sure the core API surface is the right basis for a 1.0 version of the integration. Hopefully we can pull this back up pretty soon though to revisit how to add more fine-grained transform controls here!

[tony-sull]

Reopening this PR, we're further down the path towards the Squoosh migration now and I think we should be fine here to add more specific resize options 🥳

@obennaci if you don't mind, I'll get this branch caught up to main and prepped for a final review and merge

PR #4642 came through today and shock loose the sharp vs. Squoosh concerns for me. The APIs are close enough that it won't be a problem to have a few specific checks where the Squoosh loader can just warn that a specific transform option is only supported in sharp

[obennaci]

Happy to hear that, can't wait 🥳

[tony-sull]

Excited to bring this one back now that we have a better idea of how it will work with Squoosh!

We'll need to add docs and test coverage before merging this in, happy to help answer any questions you have or pick the docs/testing work up on my end to get this across the finish line 👍

[Jutanium]

On the docs side, it's worth defining the CropFit and CropPosition types, as it currently isn't clear what they represent. You can define them once on the page, and then link to them each time.

[tony-sull]

This is excellent, thanks for all the updates here! I'm just running a quick test locally against the astro.build project and then we'll merge this in ready for the next release 🎉