From bcb9dd9f3e111d12c46515bcd231339f3ceb00d0 Mon Sep 17 00:00:00 2001
From: Princesseuh <princssdev@gmail.com>
Date: Tue, 16 May 2023 15:22:06 +0200
Subject: [PATCH 1/4] feat(typescript): Add doc for polymorphic type

---
 src/content/docs/en/guides/typescript.mdx | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/content/docs/en/guides/typescript.mdx b/src/content/docs/en/guides/typescript.mdx
index 78496cacd5d0f..7b8e017998691 100644
--- a/src/content/docs/en/guides/typescript.mdx
+++ b/src/content/docs/en/guides/typescript.mdx
@@ -235,6 +235,24 @@ type MyAttributes = astroHTML.JSX.ImgHTMLAttributes;
 ```
 :::
 
+### Polymorphic type
+
+<Since v="2.5.0" />
+
+Astro includes an helper to make it easier to build components that can render as different HTML elements. This is useful for components like `<Link>` that can render as `<a>` or `<button>` depending on the props passed to it.
+
+```astro
+---
+import { HTMLTag, Polymorphic } from 'astro/types';
+
+type Props<Tag extends HTMLTag> = Polymorphic<{ as: Tag }>;
+
+const { as: Tag, ...props } = Astro.props;
+---
+
+<Tag {...props} />
+```
+
 ### Infer `getStaticPaths()` types
 
 <Since v="2.1.0" />

From d90cb737dc9b2831c91093c3bf59686f74b971fe Mon Sep 17 00:00:00 2001
From: Erika <3019731+Princesseuh@users.noreply.github.com>
Date: Wed, 17 May 2023 13:05:27 +0200
Subject: [PATCH 2/4] Update src/content/docs/en/guides/typescript.mdx

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/content/docs/en/guides/typescript.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/typescript.mdx b/src/content/docs/en/guides/typescript.mdx
index 7b8e017998691..057f4e4ba2c72 100644
--- a/src/content/docs/en/guides/typescript.mdx
+++ b/src/content/docs/en/guides/typescript.mdx
@@ -239,7 +239,7 @@ type MyAttributes = astroHTML.JSX.ImgHTMLAttributes;
 
 <Since v="2.5.0" />
 
-Astro includes an helper to make it easier to build components that can render as different HTML elements. This is useful for components like `<Link>` that can render as `<a>` or `<button>` depending on the props passed to it.
+Astro includes a helper to make it easier to build components that can render as different HTML elements. This is useful for components like `<Link>` that can render as either `<a>` or `<button>` depending on the props passed to it.
 
 ```astro
 ---

From aea830481ce2585df0215da33b719083685d248b Mon Sep 17 00:00:00 2001
From: Princesseuh <princssdev@gmail.com>
Date: Wed, 17 May 2023 13:14:49 +0200
Subject: [PATCH 3/4] fix: expand description

---
 src/content/docs/en/guides/typescript.mdx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/typescript.mdx b/src/content/docs/en/guides/typescript.mdx
index 057f4e4ba2c72..3f79b4e7ffeaa 100644
--- a/src/content/docs/en/guides/typescript.mdx
+++ b/src/content/docs/en/guides/typescript.mdx
@@ -239,7 +239,9 @@ type MyAttributes = astroHTML.JSX.ImgHTMLAttributes;
 
 <Since v="2.5.0" />
 
-Astro includes a helper to make it easier to build components that can render as different HTML elements. This is useful for components like `<Link>` that can render as either `<a>` or `<button>` depending on the props passed to it.
+Astro includes a helper to make it easier to build components that can render as different HTML elements with full type safety. This is useful for components like `<Link>` that can render as either `<a>` or `<button>` depending on the props passed to it.
+
+The example below implements a fully typed, polymorphic component that can render as any HTML element. The [`HTMLTag`](#built-in-html-attributes) type is used to ensure that the `as` prop is a valid HTML element.
 
 ```astro
 ---

From 8c1defa3d48f068a132d877ba7f5a52cdfada897 Mon Sep 17 00:00:00 2001
From: Sarah Rainsberger <sarah@rainsberger.ca>
Date: Wed, 17 May 2023 08:30:30 -0300
Subject: [PATCH 4/4] added hyphen

---
 src/content/docs/en/guides/typescript.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/typescript.mdx b/src/content/docs/en/guides/typescript.mdx
index 3f79b4e7ffeaa..6d3857ebd4ef4 100644
--- a/src/content/docs/en/guides/typescript.mdx
+++ b/src/content/docs/en/guides/typescript.mdx
@@ -241,7 +241,7 @@ type MyAttributes = astroHTML.JSX.ImgHTMLAttributes;
 
 Astro includes a helper to make it easier to build components that can render as different HTML elements with full type safety. This is useful for components like `<Link>` that can render as either `<a>` or `<button>` depending on the props passed to it.
 
-The example below implements a fully typed, polymorphic component that can render as any HTML element. The [`HTMLTag`](#built-in-html-attributes) type is used to ensure that the `as` prop is a valid HTML element.
+The example below implements a fully-typed, polymorphic component that can render as any HTML element. The [`HTMLTag`](#built-in-html-attributes) type is used to ensure that the `as` prop is a valid HTML element.
 
 ```astro
 ---