chore: add comments

Author: eshankvaish

src/Shared/Services/ToastManager/ToastContent.tsx

@@ -9,7 +9,7 @@ export const ToastContent = ({
 }: Pick<ToastProps, 'title' | 'description' | 'buttonProps'>) => (
     <div className="flexbox-col dc__gap-8 custom-toast__content">
         <div className="flexbox-col dc__gap-4">
-            <h3 className="m-0 fs-13 fw-6 lh-20 cn-0 dc__truncate">{title}</h3>
+            <h3 className="m-0 fs-13 fw-6 lh-20 cn-0 dc__truncate dc__first-letter-capitalize">{title}</h3>
             <p className="fs-12 fw-4 lh-18 m-0 dc__truncate--clamp-6">{description}</p>
         </div>
         {buttonProps && (

src/Shared/Services/ToastManager/toastManager.service.tsx

@@ -5,6 +5,65 @@ import { TOAST_BASE_CONFIG, TOAST_VARIANT_TO_CONFIG_MAP } from './constants'
 import { ToastContent } from './ToastContent'
 import './toastManager.scss'
 
+/**
+ * Service for handling toast across the application
+ *
+ * Note: The application needs to have `ToastManagerContainer` at the root
+ * level for the toast to work
+ *
+ * @example Default Usage
+ * ```ts
+ * ToastManager.showToast({
+ *   description: 'Lorem ipsum'
+ * })
+ * ```
+ *
+ * @example Custom Title
+ * ```ts
+ * ToastManager.showToast({
+ *   description: 'Lorem ipsum',
+ *   title: 'Toast title'
+ * })
+ * ```
+ *
+ * @example With Button
+ * ```ts
+ * ToastManager.showToast({
+ *   description: 'Lorem ipsum',
+ *   buttonProps: {
+ *     dataTestId: 'toast-btn',
+ *     text: 'Reload',
+ *     startIcon: <ICArrowClockwise />
+ *   }
+ * })
+ * ```
+ *
+ * @example Auto close disabled
+ * ```ts
+ * ToastManager.showToast({
+ *   description: 'Lorem ipsum',
+ *   toastOptions: {
+ *     autoClose: false,
+ *   },
+ * })
+ * ```
+ *
+ * @example Custom progress bar color
+ * ```ts
+ * ToastManager.showToast({
+ *   description: 'Lorem ipsum',
+ *   progressBarBg: 'var(--N700)',
+ * })
+ * ```
+ *
+ * @example Custom icon
+ * ```ts
+ * ToastManager.showToast({
+ *   description: 'Lorem ipsum',
+ *   icon: <ICCube />,
+ * })
+ * ```
+ */
 class ToastManager {
     // eslint-disable-next-line no-use-before-define
     static #instance: ToastManager