From 27c2c24a1ae4e37ed65931fe1f643e2be62c16cb Mon Sep 17 00:00:00 2001
From: Charles de Dreuille <charles.dedreuille@gmail.com>
Date: Thu, 12 Mar 2026 16:27:40 +0000
Subject: [PATCH] Add migration notes

Signed-off-by: Charles de Dreuille <charles.dedreuille@gmail.com>
---
 .changeset/young-squids-end.md                   | 3 +++
 packages/ui/src/components/Checkbox/Checkbox.tsx | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/.changeset/young-squids-end.md b/.changeset/young-squids-end.md
index d5b5b97c1a..9ea2cee92b 100644
--- a/.changeset/young-squids-end.md
+++ b/.changeset/young-squids-end.md
@@ -4,4 +4,7 @@
 
 Removed redundant `selected` and `indeterminate` props from the `Checkbox` component. Use the `isSelected` and `isIndeterminate` props instead, which are the standard React Aria props and already handle both the checkbox behaviour and the corresponding CSS data attributes.
 
+**Migration:**
+Replace any usage of the `selected` and `indeterminate` props on `Checkbox` with the `isSelected` and `isIndeterminate` props. Note that the checked state and related CSS data attributes (such as `data-selected` and `data-indeterminate`) are now driven by React Aria, so any custom logic that previously inspected or set these via the old props should instead rely on the React Aria-managed state and attributes exposed through the new props.
+
 **Affected components:** Checkbox
diff --git a/packages/ui/src/components/Checkbox/Checkbox.tsx b/packages/ui/src/components/Checkbox/Checkbox.tsx
index 62599d7ae9..d7b0bd6f76 100644
--- a/packages/ui/src/components/Checkbox/Checkbox.tsx
+++ b/packages/ui/src/components/Checkbox/Checkbox.tsx
@@ -46,7 +46,7 @@ export const Checkbox = forwardRef<HTMLLabelElement, CheckboxProps>(
                 <RiCheckLine size={12} />
               )}
             </div>
-            <span>{children}</span>
+            <div>{children}</div>
           </>
         )}
       </RACheckbox>