Repository: withastro/astro
File: packages/astro/src/types/public/config.ts (TypeScript)

Code before:
		 *   - Start with '**.' to allow all subdomains ('endsWith').
		 *   - Start with '*.' to allow only one level of subdomain.
		 *
		 * `pathname`:
		 *   - End with '/**' to allow all sub-routes ('startsWith').
		 *   - End with '/*' to allow only one level of sub-route.

		 */
		remotePatterns?: Partial<RemotePattern>[];

		/**
		 * @docs
		 * @name image.layout
		 * @type {ImageLayout}
		 * @default `undefined`
		 * @version 5.10.0
		 * @description
		 * The default layout type for responsive images. Can be overridden by the `layout` prop on the image component.
		 * - `constrained` - The image will scale to fit the container, maintaining its aspect ratio, but will not exceed the specified dimensions.
		 * - `fixed` - The image will maintain its original dimensions.
		 * - `full-width` - The image will scale to fit the container, maintaining its aspect ratio.
		 */
		layout?: ImageLayout | undefined;
		/**
		 * @docs
		 * @name image.objectFit
		 * @type {ImageFit}
		 * @default `"cover"`
		 * @version 5.10.0
		 * @description
		 * The default object-fit value for responsive images. Can be overridden by the `fit` prop on the image component.
		 * Requires a value for `layout` to be set.
		 */
		objectFit?: ImageFit;
		/**
		 * @docs
		 * @name image.objectPosition
		 * @type {string}
		 * @default `"center"`
		 * @version 5.10.0
		 * @description
		 * The default object-position value for responsive images. Can be overridden by the `position` prop on the image component.
		 * Requires a value for `layout` to be set.
		 */
		objectPosition?: string;
		/**
		 * @docs
		 * @name image.breakpoints
		 * @type {number[]}
		 * @default `[640, 750, 828, 1080, 1280, 1668, 2048, 2560] | [640, 750, 828, 960, 1080, 1280, 1668, 1920, 2048, 2560, 3200, 3840, 4480, 5120, 6016]`
		 * @version 5.10.0

Review comment (suggestion):
```suggestion
		 *
		 * See [the layout component property](https://docs.astro.build/en/reference/modules/astro-assets/#layout) for more details.
		 */
```

@ascorbic We can match these up to whatever the stable docs end up being, but in my draft branch, all of these properties have a link to their corresponding component attribute in `astro:assets` reference. [Examples start here](https://deploy-preview-11741--astro-docs-2.netlify.app/en/reference/configuration-reference/#imagelayout)) What do you think about this?

This keeps the already huge config page nice and minimal, and allows us to do more extensive documenting as needed on a page specifically dedicated to image content, since extra context there may be helpful/of interest.

Code after:
		 * You can use wildcards to define the permitted `hostname` and `pathname` values as described below. Otherwise, only the exact values provided will be configured:
		 * `hostname`:
		 *   - Start with '**.' to allow all subdomains ('endsWith').
		 *   - Start with '*.' to allow only one level of subdomain.
		 *
		 * `pathname`:
		 *   - End with '/**' to allow all sub-routes ('startsWith').
		 *   - End with '/*' to allow only one level of sub-route.

		 */
		remotePatterns?: Partial<RemotePattern>[];

		/**
		 * @docs
		 * @name image.layout
		 * @type {ImageLayout}
		 * @default `undefined`
		 * @version 5.10.0
		 * @description
		 * The default layout type for responsive images. Can be overridden by the `layout` prop on the image component.
		 * - `constrained` - The image will scale to fit the container, maintaining its aspect ratio, but will not exceed the specified dimensions.
		 * - `fixed` - The image will maintain its original dimensions.
		 * - `full-width` - The image will scale to fit the container, maintaining its aspect ratio.
		 *
		 * See [the `layout` component property](https://docs.astro.build/en/reference/modules/astro-assets/#layout) for more details.
		 */
		layout?: ImageLayout | undefined;
		/**
		 * @docs
		 * @name image.objectFit
		 * @type {ImageFit}
		 * @default `"cover"`
		 * @version 5.10.0
		 * @description
		 * The default object-fit value for responsive images. Can be overridden by the `fit` prop on the image component.
		 * Requires a value for `layout` to be set.
		 * 
		 * See [the `fit` component property](https://docs.astro.build/en/reference/modules/astro-assets/#fit) for more details.
		 */
		objectFit?: ImageFit;
		/**
		 * @docs
		 * @name image.objectPosition
		 * @type {string}
		 * @default `"center"`
		 * @version 5.10.0
		 * @description
		 * The default object-position value for responsive images. Can be overridden by the `position` prop on the image component.
		 * Requires a value for `layout` to be set.
		 * 
		 * See [the `position` component property](https://docs.astro.build/en/reference/modules/astro-assets/#position) for more details.