fix(astro:assets): add docs for missing imports and types

[ArmandPhilippot]

Description (required)

• Moves astro/assets/utils from the Image Service API to astro:assets module because we're now documenting the slash versions alongside the virtual modules. No content has changed except the following:
  • Updates the line breaks/indentation while moving the existing content.
  • Simplifies the code snippets
  • Updates matchProtocol() description (default value)
  • Adds default for matchPort()
• Formats headings for consistent use of inline code
• Adds new imports for astro:assets:
  • getConfiguredImageService(): added in fix(assets): Fix types to be more accurate astro#6530
  • imageConfig: added in fix: missing imageConfig type in astro:assets astro#8414
• Adds astro:assets types
  • LocalImageProps
  • RemoteImageProps
• Adds astro/assets imports:
  • baseService
  • getConfiguredImageService(): same as astro:assets
  • getImage(): because this is internal code we probably don't want to expose it? Maybe this should be the astro:assets version instead.
  • isLocalService()
• Adds astro/assets types (same as astro:assets)
• Adds astro types related to assets (instead of listing them alphabetically, I tried to group them by usage)
  • ImageInputFormat
  • ImageMetadata: added in fix(assets): Fix types to be more accurate astro#6530
    • orientation: added in fix(assets): Fix images not following EXIF rotation astro#7637
  • ImageOutputFormat
  • ImageQuality
  • ImageQualityPreset
  • ImageTransform
    • densities and widths: added in feat(assets): Add support for srcset and a Picture component astro#8620
    • fit and position: added in feat: experimental responsive images astro#12377 Note that responsive images have been stabilized in feat: unflag responsive images astro#13917 but this doesn't update ImageTransform, so saying "since v5" is probably fine?
  • UnresolvedImageTransform
  • GetImageResult
    • srcSet: added in feat(assets): Add support for srcset and a Picture component astro#8620
  • RemotePattern: exported in withastro/astro@6ee63bf / [ci] release astro#14466
  • ImageServiceConfig: added in feat(image): Update image service config to allow passing settings to the service astro#6848
  • ImageService
  • ExternalImageService
  • LocalImageService
• Updates some existing types to flatten the type when it depends on non-exported types.
• Removes the GetImageResult code snippet in getImage()
• Reword a section in Image Service API and in the Images guide to replace a type displayed as a code snippet with a link
• Adds more link to astro:assets from the Image Service API

Related issues & labels (optional)

• Suggested label: add new content, improve or update documentation

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	333cabf
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/69419be4e199dd000931ea6e
😎 Deploy Preview	https://deploy-preview-12867--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[astrobot-houston]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
en/guides/images.mdx	Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-gatsby.mdx	Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nextjs.mdx	Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nuxtjs.mdx	Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v3.mdx	Source changed, localizations will be marked as outdated.
en/reference/image-service-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/modules/astro-assets.mdx	Source changed, localizations will be marked as outdated.
ru/guides/upgrade-to/v3.mdx	Localization changed, will be marked as complete.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[ArmandPhilippot]

This should be ready to review now!

• the TOC is a bit heavy now, but if we hide the h4 this would hide the <Image /> properties...
• getImage() from astro/assets is internal code. I don't know if this is expected or if this should be the astro:assets version instead.

[sarah11918]

OK, just a few comments here before we decide what to do about the table of contents!

This could mean showing fewer levels, I think this should include avoiding "Image properties" so we can just have the image component, then each property etc. and we might end up strategically hiding some of the "building an image service only" content.

We'll figure that out!

[ArmandPhilippot]

I believe we would need this because of the ru file:

@lunaria-track:src/content/docs/en/**.mdx

https://lunaria.dev/guides/tracking/#lunaria-track

[sarah11918]

Preview with the new h2 and h3 only looks good! Thanks for this amazing work, Armand!