Added downloadPoster attribute to the docs

Author: sas-news

docs/src/content/docs/components/link-preview.mdx

@@ -105,6 +105,32 @@ The `<LinkPreview>` component supports the following API for controlling its sty
 - `.link-preview--no-media`: Class applied to the card when it includes no image or video.
 - `.link-preview--no-metadata`: Class applied when metadata scraping failed, or no valid title was found. In this case the only contents of the card is the original URL link.
 
+## Optional props
+
+In addition to the required `id` prop, the following props are available to customise how the `<LinkPreview>` component renders:
+
+### `downloadPoster`
+
+**Type:** `boolean`
+
+Download the poster image and host it on the same server as your website.
+
+This attribute can only be used if the `og:image` metadata exists.
+
+```astro
+<LinkPreview id="https://astro.build/blog/welcome-world/" downloadPoster />
+```
+
+To use the `downloadPoster` attribute, need to add the address of the image server to astro.config.mjs as follows:
+
+```js
+export default defineConfig({
+	image: {
+		domains: ['astro.build'],
+	},
+});
+```
+
 ## Standalone installation
 
 If you only need the `<LinkPreview>` component, you can install the package directly instead of the main `astro-embed` package:

docs/src/content/docs/components/vimeo.mdx

@@ -110,6 +110,27 @@ If you want to customise this, for example to match the language of your website
 <Vimeo id="32001208" playlabel="Play the video" />
 ```
 
+### `downloadPoster`
+
+**Type:** `boolean`
+
+Download the poster image and host it on the same server as your website.
+
+```astro
+<Vimeo id="32001208" downloadPoster />
+```
+
+To use the `downloadPoster` attribute, need to add the address of the image server to astro.config.mjs as follows:
+
+
+```js
+export default defineConfig({
+	image: {
+		domains: ['i.vimeocdn.com'],
+	},
+});
+```
+
 ## Standalone installation
 
 If you only need the `<Vimeo>` component, you can install the package directly instead of the main `astro-embed` package:

docs/src/content/docs/components/youtube.mdx

@@ -128,6 +128,27 @@ Set a visible title to overlay on the video.
 	title="The Astro Community: where contributors find a home"
 />
 
+### `downloadPoster`
+
+**Type:** `boolean`
+
+Download the poster image and host it on the same server as your website.
+
+```astro
+<YouTube id="TtRtkTzHVBU" downloadPoster />
+```
+
+To use the `downloadPoster` attribute, need to add the address of the image server to astro.config.mjs as follows:
+
+
+```js
+export default defineConfig({
+	image: {
+		domains: ['i.ytimg.com'],
+	},
+});
+```
+
 ## Standalone installation
 
 If you only need the `<YouTube>` component, you can install the package directly instead of the main `astro-embed` package: