feat: explain the limitations of serialization

src/content/docs/en/guides/framework-components.mdx

@@ -119,13 +119,16 @@ import Counter from '../components/Counter.svelte';
 </div>
 ```
 
-:::caution[Passing functions as props]
-You can pass a function as a prop to a framework component, but it only works during server rendering. If you try to use the function in a hydrated component (for example, as an event handler), an error will occur.
 
-This is because functions can't be _serialized_ (transferred from the server to the client) by Astro.
-:::
 
 
+Props that are passed to interactive framework components [using a `client:*` directive](/en/reference/directives-reference/#client-directives) must be [serialized](https://developer.mozilla.org/en-US/docs/Glossary/Serialization): translated into a format suitable for transfer over a network, or storage. However, for performance and/or security reasons, Astro does not serialize every type of data structure. Therefore, there are some limitations on what can be passed as props to hydrated components.
+
+The following prop types are supported: 
+`plain object`, `number`, `string`, `Array`, `Map`, `Set`, `RegExp`, `Date`, `BigInt`, `URL`, `Uint8Array`, `Uint16Array`, `Uint32Array`, and `Infinity`
+
+Non-supported data structures passed to components, such as functions, can only be used during the component's server rendering and cannot be used to provide interactivity. For example, passing functions to hydrated components is not supported because Astro cannot pass functions from the server in a way that make them executable on the client.
+
 ## Passing children to framework components
 
 Inside of an Astro component, you **can** pass children to framework components. Each framework has its own patterns for how to reference these children: React, Preact, and Solid all use a special prop named `children`, while Svelte and Vue use the `<slot />` element.

src/content/docs/en/guides/server-islands.mdx

@@ -33,6 +33,15 @@ const avatarURL = await getUserAvatar(userSession);
 ---
 <img alt="User avatar" src={avatarURL} />
 ```
+:::caution[Server Island Prop Limitations]
+You can pass a function as a prop to a server island component, but this only works during server rendering. If you try to use the function in a hydrated component (for example, as an event handler), an error will occur.
+
+This is because functions cannot be _serialized_ (transferred from the server to the client) by Astro. Objects with circular references are also not serializable.
+
+Props provided to hydrated components must be serializable. The following prop types are supported: 
+`plain object`, `number`, `string`, `Array`, `Map`, `Set`, `RegExp`, `Date`, `BigInt`, `URL`, `Uint8Array`, `Uint16Array`, `Uint32Array`, and `Infinity`
+:::
+
 
 ## Server island fallback content