docs: added documentation for toast component changes (#7141)

* docs: added documentation for toast component changes

* added redirect from use-toast docs to upgrade guide

* remove unused file

* content linting fixes

* update UI package version

* updated ui preset

* fix upgrade guides main page

www/apps/ui/src/content/docs/components/toast.mdx

@@ -10,31 +10,25 @@ component: true
 
 ---
 
-Add the Toaster component somewhere in your tree
+Import the `toast` utility and `Toaster` component from `@medusajs/ui`:
 
 ```tsx
-import { Toaster } from "@medusajs/ui"
+import { Toaster, toast } from "@medusajs/ui"
 ```
 
+Then, add the `Toaster` component somewhere in your tree:
+
 ```tsx
 <Toaster />
 ```
 
-The `useToast` hook returns a `toast` function that you can use to display a toast.
+Finally, use the `toast` utility to display a toast:
 
 ```tsx
-import { useToast } from "@medusajs/ui"
-```
-
-```tsx
-const { toast } = useToast()
-
 return (
-
   <Button 
     onClick={() => 
-      toast({ 
-        title: "Toast title",
+      toast.info("Toast title", {
         description: "Toast body",
       })
     }
@@ -46,12 +40,39 @@ return (
 
 ## API Reference
 
+---
+
+### Toast Utility Functions
+
+The `toast` utility has the following functions to display different variants of toasts:
+
+- `info`
+- `error`
+- `success`
+- `warning`
+- `loading`
+
+Each of these functions accept two parameters:
+
+1. A string indicating the title of the toast.
+2. An object of props to pass to the underlying `Toast` component.
+
+### Toast Props
+
 <ComponentReference mainComponent="Toast" />
 
+### Toaster Props
+
+<ComponentReference mainComponent="Toaster" />
+
 ## Examples
 
 ---
 
+### Dismissable Toast
+
+<ComponentExample name="toaster-dismiss" />
+
 ### Warning
 
 <ComponentExample name="toaster-warning" />

www/apps/ui/src/content/docs/hooks/use-toast.mdx

@@ -1,30 +0,0 @@
----
-title: "useToast"
-description: ""
-component: true
----
-
-
-This hook is used to display and manage toasts. To learn how to make it usable and to see some examples, please check the [Toast component page](/components/toast).
-
-```tsx
-import { useToast } from "@medusajs/ui"
-```
-
-## API Reference
-
----
-
-### Call Signature
-
-`useToast()`
-
-### useToast return
-
-<HookValues hook="useToast" />
-
-### ToasterToast
-
-Important type used when pushing or retrieving toasts. This extends the [Radix UI Toast Root](https://www.radix-ui.com/primitives/docs/components/toast#root) primitive type.
-
-<HookValues hook="ToasterToast" />