Deprecate <Tokens /> (#1308)

Author: lgrammel

.changeset/popular-cherries-invite.md

@@ -0,0 +1,5 @@
+---
+'ai': patch
+---
+
+Deprecate <Tokens/>

docs/pages/docs/api-reference/tokens.mdx

@@ -9,6 +9,14 @@ layout:
 The Tokens component is a React Server Component for streaming in tokens in a React Component.
 You can view a live demo with Next.js [here](https://rsc-llm-on-the-edge.vercel.app)
 
+<Callout>
+  <strong>
+    This API has been deprecated and will be removed in a future release. See
+    [Generative UI](/docs/concepts/ai-rsc) for the recommended approach to
+    streaming React UI.
+  </strong>
+</Callout>
+
 ## Props
 
 ```typescript

packages/core/react/tokens.tsx

@@ -8,8 +8,10 @@ type Props = {
 };
 
 /**
- * A React Server Component that recursively renders a stream of tokens.
- * Can only be used inside of server components.
+A React Server Component that recursively renders a stream of tokens.
+Can only be used inside of server components.
+
+@deprecated Use RSCs / Generative AI instead.
  */
 export async function Tokens(props: Props) {
   const { stream } = props;