📝 Add docstrings to issue-bundle-fixes

Docstrings generation was requested by @Arun-kushwaha007.

The following files were modified:

* `apps/mobile/app/components/ui/MoneyText.tsx`
* `apps/mobile/app/screens/ActivityScreen.tsx`
* `apps/mobile/app/screens/ExpenseDetailScreen.tsx`
* `apps/mobile/app/screens/GuestGroupDetailScreen.tsx`
* `apps/mobile/app/screens/HomeScreen.tsx`
* `apps/web/app/dashboard/groups/[groupId]/page.tsx`
* `apps/web/app/dashboard/page.tsx`
* `apps/web/src/components/activity/ActivityFeed.tsx`
* `apps/web/src/components/dashboard/ActivityList.tsx`
* `apps/web/src/components/groups/GroupSummaryPanel.tsx`
* `apps/web/src/components/groups/RecurringExpenseList.tsx`
* `apps/web/src/components/groups/SettlementList.tsx`
* `packages/shared-types/src/index.ts`

These files were kept as they were:
* `apps/mobile/app/screens/AddExpenseScreen.tsx`
* `apps/mobile/app/screens/GroupDetailScreen.tsx`
* `apps/web/app/dashboard/activity/page.tsx`
* `apps/web/app/share/[token]/page.tsx`
* `apps/web/src/components/groups/ExpenseDetailCard.tsx`
* `apps/web/src/components/groups/ExpenseRow.tsx`
* `apps/web/src/components/groups/ExpenseTable.tsx`

These files were ignored:
* `apps/backend/src/activity/activity.service.spec.ts`

These file types are not supported:
* `README.md`
* `packages/shared-types/tsconfig.json`
* `tsconfig.base.json`

Author: coderabbitai[bot]

apps/mobile/app/components/ui/MoneyText.tsx

@@ -11,13 +11,11 @@ interface MoneyTextProps {
 }
 
 /**
- * Render a Text element showing a formatted currency amount.
+ * Renders a Text element that displays a currency amount formatted from a cents string and sets the accessibility label to the same formatted string.
  *
- * @param cents - Amount in cents as a string (e.g., `"150"` for $1.50)
- * @param size - One of `'sm' | 'md' | 'lg'`; controls the text font size
- * @param variant - One of `'default' | 'success' | 'danger'`; controls the text color
- * @param currency - Currency code used for formatting (defaults to `'USD'`)
- * @returns A React Native Text element displaying the formatted currency string; the same string is used for the accessibility label
+ * @param cents - Amount in cents as a string (for example, `"150"` represents $1.50)
+ * @param currency - ISO currency code used for formatting (defaults to `'USD'`)
+ * @returns A React element that renders the formatted currency string
  */
 export function MoneyText({ cents, size = 'md', variant = 'default', currency = 'USD' }: MoneyTextProps) {
   const { colors } = useAppTheme();

apps/mobile/app/screens/ActivityScreen.tsx

@@ -83,13 +83,13 @@ const relativeTime = (iso: string): string => {
 };
 
 /**
- * Render the Activity screen showing a scrollable, paginated list of activity events for a specific group or the current user.
+ * Renders the Activity screen with a paginated, refreshable list of activity events for a group or the current user.
  *
- * The screen loads the first page on mount, supports pull-to-refresh and infinite scroll pagination, animates item entry,
- * and displays loading or empty states as appropriate. Amounts and currencies are resolved from activity metadata when available.
+ * The screen supports pull-to-refresh, infinite scroll pagination, animated item entry, and displays loading or empty states.
+ * Amounts and currencies are derived from activity metadata when available.
  *
- * @param route - Optional navigation route; if `route.params.groupId` is provided the screen shows that group's activity, otherwise it shows the current user's activity.
- * @returns The rendered Activity screen element.
+ * @param route - Optional navigation route. If `route.params.groupId` is provided the screen shows that group's activity; otherwise it shows the current user's activity.
+ * @returns The rendered Activity screen React element.
  */
 export function ActivityScreen({ route }: { route?: { params?: { groupId?: string } } }) {
   const groupId = route?.params?.groupId;

apps/mobile/app/screens/ExpenseDetailScreen.tsx

@@ -30,6 +30,12 @@ function getReceiptUrl(fileKey?: string | null): string | null {
   return `${base.replace(/\/$/, '')}/${fileKey}`;
 }
 
+/**
+ * Infers a file extension for an image asset from its filename or MIME type.
+ *
+ * @param asset - The ImagePicker asset to inspect (may include `fileName` and `mimeType`)
+ * @returns The inferred file extension in lowercase (e.g., `png`, `heic`, `jpg`), or `undefined` if no information is available
+ */
 function inferExtension(asset: ImagePicker.ImagePickerAsset): string | undefined {
   const fileName = asset.fileName ?? '';
   const fileExtension = fileName.includes('.') ? fileName.split('.').pop() : undefined;

apps/mobile/app/screens/GuestGroupDetailScreen.tsx

@@ -13,15 +13,14 @@ import { SectionHeader } from '../components/SectionHeader';
 import { useToastStore } from '../store/toastStore';
 
 /**
- * Render a view-only detail screen for a shared group link.
+ * Render a read-only detail screen for a shared group link.
  *
- * Fetches group details, summary statistics, recent expenses, members, and recent activity for the guest token;
- * displays loading and error states, a read-only UI with stats, recent expenses, and activity history,
- * and offers a prompt to register. On fetch failure a toast is shown and navigation goes back.
+ * Fetches guest-visible group data on mount and displays group header, stats, recent expenses, and activity history,
+ * along with a prompt to register. On fetch failure a toast is shown and navigation goes back.
  *
- * @param route - The navigation route; expects `route.params.token` containing the shared guest token.
- * @param navigation - Navigation object used to go back on error and navigate to the Register screen.
- * @returns A `JSX.Element` representing the guest group detail screen.
+ * @param route - Navigation route; expects `route.params.token` containing the shared guest token.
+ * @param navigation - Navigation object used to navigate to the Register screen and to go back on error.
+ * @returns A JSX.Element representing the guest group detail screen.
  */
 export function GuestGroupDetailScreen({ route, navigation }: { route: any; navigation: any }) {
   const { token } = route.params;

apps/mobile/app/screens/HomeScreen.tsx

@@ -101,11 +101,11 @@ const subtitleForActivity = (activity: ActivityDto): string => {
 };
 
 /**
- * Renders the app's dashboard home screen with summary, quick actions, attention items, and recent activity.
+ * Display the app dashboard with balance, quick actions, attention items, and recent activity.
  *
- * Loads user summary, recent activities, and per-group attention items on mount; displays a balance card, quick action tiles, a "Needs Attention" list (when present), and a recent activity feed with navigation handlers for related screens.
+ * On mount, loads user summary, recent activities, and per-group attention items to populate the screen.
  *
- * @param navigation - React Navigation prop used to navigate to other screens (e.g., 'AddExpense', 'Groups', 'SettleUp', 'GroupDetail', 'Activity', 'Profile')
+ * @param navigation - React Navigation prop used to navigate to other screens
  * @returns The Home screen React element
  */
 export function HomeScreen({ navigation }: { navigation: any }) {

apps/web/app/dashboard/groups/[groupId]/page.tsx

@@ -25,8 +25,8 @@ interface GroupDetailPageProps {
 /**
  * Renders the group detail dashboard for a specified group.
  *
- * @param params - A Promise that resolves to an object containing `groupId`, used to fetch all data for the group.
- * @returns The page JSX showing the group header (name, creation date, currency, member count, total spend), current user's balance status, summary panel, recurring expenses, expense table, member list, and group actions.
+ * @param params - An object containing `groupId` that identifies which group's data to load and display.
+ * @returns The page JSX for the group's detail dashboard, including the header (name, creation date, currency, member count, total spend), current user's balance pill, summary panel, recurring expenses, expense table, member list, and group actions.
  */
 export default async function GroupDetailPage({ params }: GroupDetailPageProps) {
   const { groupId } = await params;

apps/web/app/dashboard/page.tsx

@@ -18,14 +18,14 @@ import { GlassCard } from '../../components/ui/GlassCard';
 type Group = { id: string; name: string; currency: string };
 
 /**
- * Format an amount given in cents into a localized currency string.
+ * Format an amount in cents into a localized currency string.
  *
- * If `cents` or `currency` is missing, returns "$0.00". For supported currency codes
- * "USD", "EUR", and "INR" the value is formatted using that currency; for any other
- * currency code the value is formatted using "USD" as a fallback.
+ * If `cents` or `currency` is missing, returns "$0.00". For currency codes "USD",
+ * "EUR", and "INR" the value is formatted using that currency; for any other code
+ * the value is formatted using "USD" as a fallback.
  *
- * @param cents - The amount in the smallest currency unit (cents) as a string, or `null`
- * @param currency - An ISO currency code (e.g., "USD", "EUR", "INR"), or `null`
+ * @param cents - The amount in the smallest currency unit (e.g., cents) as a string or `null`
+ * @param currency - An ISO currency code (e.g., "USD", "EUR", "INR") or `null`
  * @returns A formatted currency string (for example, "$1.23")
  */
 function formatMoney(cents: string | null, currency: string | null): string {

apps/web/src/components/activity/ActivityFeed.tsx

@@ -64,12 +64,10 @@ function labelFor(activity: ActivityDto): string {
 }
 
 /**
- * Format an activity's monetary amount using cents and currency from its metadata.
+ * Format an activity's monetary amount using cents and a currency code from its metadata.
  *
- * Uses `metadata.amountCents` or `metadata.totalAmountCents` (preferring `amountCents`) and the optional `metadata.currency`.
- *
- * @param activity - Activity object whose `metadata` should contain a string cents value and optional currency
- * @returns A formatted currency string when cents are present as a string; `null` if no string cents value is available. Values with currency `USD`, `EUR`, or `INR` are formatted with that currency; other currencies are formatted as `USD`.
+ * @param activity - Activity whose `metadata` should contain cents as a string (`amountCents` or `totalAmountCents`) and may include a `currency` code
+ * @returns A formatted currency string when cents are present as a string; `null` otherwise. Uses `metadata.currency` when it is `USD`, `EUR`, or `INR`; otherwise formats using `USD`.
  */
 function formatAmount(activity: ActivityDto): string | null {
   const cents = activity.metadata?.amountCents ?? activity.metadata?.totalAmountCents;

apps/web/src/components/dashboard/ActivityList.tsx

@@ -5,6 +5,12 @@ import { ActivityDto, formatCurrencyFromCents } from '@fairshare/shared-types';
 import { Clock, Receipt, Users, Plus, Trash2, UserPlus, Milestone, ArrowUpRight, BellRing, ActivitySquare } from 'lucide-react';
 import { motion } from 'framer-motion';
 
+/**
+ * Selects the icon component and Tailwind color classes for a given activity type.
+ *
+ * @param type - Activity event type used to determine the icon and color scheme
+ * @returns An object containing `Icon` (the React icon component) and `color` (a Tailwind CSS class string)
+ */
 function getIconForType(type: ActivityDto['type']) {
   switch (type) {
     case 'expense_created': return { Icon: Plus, color: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/20' };
@@ -64,6 +70,12 @@ function labelForActivity(activity: ActivityDto): string {
   }
 }
 
+/**
+ * Produce a concise subtitle describing an activity, including a formatted amount when available.
+ *
+ * @param activity - The activity record to generate the subtitle for
+ * @returns A short subtitle string for the given activity. If the activity contains a monetary amount, the formatted amount is included in the returned text; otherwise a fixed descriptive phrase is returned.
+ */
 function subtitleForActivity(activity: ActivityDto): string {
   const amount = formatAmount(activity);
   switch (activity.type) {

apps/web/src/components/groups/GroupSummaryPanel.tsx

@@ -1,11 +1,11 @@
 import { BalanceDto, CurrencyCode, GroupMemberSummaryDto, GroupSummaryDto, formatCurrencyFromCents } from '@fairshare/shared-types';
 
 /**
- * Compute the total balance in cents for a given user.
+ * Calculate the total amount in cents for the specified user.
  *
- * @param balances - Array of ledger balance entries to consider; each entry's `amountCents` is included when its `userId` matches `userId`
- * @param userId - The user identifier whose balances will be summed
- * @returns The sum of `amountCents` for all balances with the given `userId`
+ * @param balances - Ledger balance entries to sum
+ * @param userId - User identifier to match against each entry's `userId`
+ * @returns The sum of `amountCents` for all entries whose `userId` matches `userId`
  */
 function getNetBalanceCents(balances: BalanceDto[], userId: string) {
   return balances