From 595b9e5b3a5b17da32348e62d3f963b02a5250fe Mon Sep 17 00:00:00 2001
From: paanSinghCoder <gaurav3017@gmail.com>
Date: Thu, 12 Mar 2026 09:52:20 +0530
Subject: [PATCH 1/2] feat: expose key prop

---
 apps/www/src/content/docs/components/breadcrumb/props.ts    | 2 ++
 packages/raystack/components/breadcrumb/breadcrumb-item.tsx | 4 +++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/apps/www/src/content/docs/components/breadcrumb/props.ts b/apps/www/src/content/docs/components/breadcrumb/props.ts
index 02b7d4ed9..fd6ea6895 100644
--- a/apps/www/src/content/docs/components/breadcrumb/props.ts
+++ b/apps/www/src/content/docs/components/breadcrumb/props.ts
@@ -22,6 +22,8 @@ export interface BreadcrumbItem {
    * When `dropdownItems` is provided, the `as` and `href` props are ignored.
    */
   dropdownItems?: {
+    /** Optional stable key for list reconciliation. Falls back to index if omitted. */
+    key?: string;
     /** Text to display for the dropdown item */
     label: string;
     /** Callback function when a dropdown item is clicked */
diff --git a/packages/raystack/components/breadcrumb/breadcrumb-item.tsx b/packages/raystack/components/breadcrumb/breadcrumb-item.tsx
index 0b3471ac2..9f26ce1e0 100644
--- a/packages/raystack/components/breadcrumb/breadcrumb-item.tsx
+++ b/packages/raystack/components/breadcrumb/breadcrumb-item.tsx
@@ -13,6 +13,8 @@ import { Menu } from '../menu';
 import styles from './breadcrumb.module.css';
 
 export interface BreadcrumbDropdownItem {
+  /** Optional stable key for list reconciliation (use when items can reorder). Falls back to index if omitted. */
+  key?: string;
   label: string;
   onClick?: React.MouseEventHandler<HTMLElement>;
 }
@@ -62,7 +64,7 @@ export const BreadcrumbItem = forwardRef<
           <Menu.Content className={styles['breadcrumb-dropdown-content']}>
             {dropdownItems.map((dropdownItem, dropdownIndex) => (
               <Menu.Item
-                key={dropdownIndex}
+                key={dropdownItem.key ?? dropdownIndex}
                 className={styles['breadcrumb-dropdown-item']}
                 onClick={dropdownItem?.onClick}
               >

From d07a5ef09b88eb3375f124244d13a93fba5e26f6 Mon Sep 17 00:00:00 2001
From: paanSinghCoder <gaurav3017@gmail.com>
Date: Thu, 12 Mar 2026 09:55:49 +0530
Subject: [PATCH 2/2] chore: remove comment

---
 packages/raystack/components/breadcrumb/breadcrumb-item.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/raystack/components/breadcrumb/breadcrumb-item.tsx b/packages/raystack/components/breadcrumb/breadcrumb-item.tsx
index 9f26ce1e0..36f00e6f9 100644
--- a/packages/raystack/components/breadcrumb/breadcrumb-item.tsx
+++ b/packages/raystack/components/breadcrumb/breadcrumb-item.tsx
@@ -13,7 +13,6 @@ import { Menu } from '../menu';
 import styles from './breadcrumb.module.css';
 
 export interface BreadcrumbDropdownItem {
-  /** Optional stable key for list reconciliation (use when items can reorder). Falls back to index if omitted. */
   key?: string;
   label: string;
   onClick?: React.MouseEventHandler<HTMLElement>;