@bitrise/bitkit-v2 0.3.327 → 0.3.328

package/docs/v1-to-v2-migration-guide.md

@@ -105,12 +105,14 @@ Chakra v2 → v3 prop changes on primitives:
 
 | v1 | v2 |
 |----|----|
-| `Badge colorScheme="positive"` | `BitkitBadge colorPalette="green"` |
-| `Badge colorScheme="negative"` | `BitkitBadge colorPalette="red"` |
-| `Badge colorScheme="warning"` | `BitkitBadge colorPalette="yellow"` |
-| `Badge colorScheme="progress"` | `BitkitBadge colorPalette="purple"` |
+| `Badge colorScheme="positive"` | `BitkitBadge colorVariant="green"` |
+| `Badge colorScheme="negative"` | `BitkitBadge colorVariant="red"` |
+| `Badge colorScheme="warning"` | `BitkitBadge colorVariant="yellow"` |
+| `Badge colorScheme="progress"` | `BitkitBadge colorVariant="purple"` |
 | `Tag` | `BitkitTag` |
 
+The color prop is `colorVariant`, not Chakra's `colorPalette` — `BitkitBadge` deliberately omits `colorPalette` from its props. Available values: `neutral`, `purple`, `blue`, `green`, `yellow`, `red`, `orange`, `turquoise`, `ai-gradient`.
+
 ### Toast
 
 ```tsx
@@ -134,16 +136,20 @@ createBitkitToast({ variant: 'critical', titleText: 'Oops', messageText: 'Someth
 </Dialog>
 
 // v2
-<BitkitDialog open={open} onOpenChange={({ open }) => setOpen(open)}>
-  <BitkitDialog.Body>...</BitkitDialog.Body>
-  <BitkitDialog.Footer>
-    <BitkitDialog.Buttons>...</BitkitDialog.Buttons>
-  </BitkitDialog.Footer>
+<BitkitDialog
+  open={open}
+  onOpenChange={({ open }) => setOpen(open)}
+  title="Title"
+  footerButtons={<BitkitButton onClick={save}>Save</BitkitButton>}
+>
+  ...body...
 </BitkitDialog>
 ```
 
 Key changes: `isOpen` → `open`, `onClose` → `onOpenChange` (receives `{ open: boolean }`).
 
+`BitkitDialog` is a flat component, not a compound one: the body is `children`, the header comes from the required `title`, and the footer is filled via `footerButtons` (the right-aligned button row) and/or `footerContent`. Its only sub-component is `BitkitDialog.ActionTrigger`.
+
 Other prop mappings:
 
 | v1 | v2 |
@@ -151,9 +157,7 @@ Other prop mappings:
 | `isClosable={false}` | `closable={false}` |
 | `onCloseComplete={fn}` | `onExitComplete={fn}` (fires when the close animation finishes) |
 
-`closable={false}` matches v1: the header close button is **rendered but disabled** (kept in place so the header layout stays consistent), **ESC is blocked**, and overlay/outside clicks are ignored (`closeOnInteractOutside` is already `false` by default on `BitkitDialogRoot`). The only way to dismiss the dialog is through an explicit footer action.
-
-If you're composing the lower-level primitives directly, you have to set the same controls explicitly: pass `closeOnEscape={false}` to `BitkitDialogRoot` and `closable={false}` to `BitkitDialogContent`.
+`closable={false}` matches v1: the header close button is **rendered but disabled** (kept in place so the header layout stays consistent) and **ESC is blocked**. Overlay/outside clicks are ignored regardless of `closable` — the dialog always sets `closeOnInteractOutside={false}` internally. With `closable={false}` the only way to dismiss the dialog is through an explicit footer action.
 
 ```tsx
 // Acknowledge-only dialog
@@ -226,12 +230,15 @@ For password fields with an eye-toggle: use `BitkitField` + Chakra v3 `InputGrou
 
 | v1 | v2 |
 |----|----|
-| `Card` | `BitkitCard` |
+| `Card` | `Card.Root` from `@chakra-ui/react/card` |
+| `CardProps` | `CardRootProps` from `@chakra-ui/react/card` |
 | `ExpandableCard` | `BitkitExpandableCard` |
 
-`BitkitCard` accepts `paddingSize` and `elevation` (boolean). Common `BitkitExpandableCard` props: `title`, `secdText`, `size`; use `defaultExpanded` for uncontrolled or `expanded`/`onChange` for controlled usage. It also supports `icon`, `suffix`, and other options — see the component API for the full list.
+There is no plain `BitkitCard` — it was removed in `0.3.239` ([#223](https://github.com/bitrise-io/bitkit-v2/pull/223)), since a closed component earned nothing over the Chakra primitive. A plain card is Chakra's compound `Card.Root` / `Card.Body`.
+
+Common `BitkitExpandableCard` props: `title`, `subtitle`, `size`; use `defaultExpanded` for uncontrolled or `expanded`/`onChange` for controlled usage. It also supports `icon`, `suffix`, and other options — see the component API for the full list.
 
-If your codebase has a local `card.tsx` wrapper around v1 Card (e.g. Shadcn-style `CardHeader`, `CardContent` etc.), remove the wrapper entirely and migrate to `BitkitCard` directly — keeping the wrapper layer just adds indirection you'll need to unwind later.
+If your codebase has a local `card.tsx` wrapper around v1 Card (e.g. Shadcn-style `CardHeader`, `CardContent` etc.), remove the wrapper entirely and use `Card.Root` directly — keeping the wrapper layer just adds indirection you'll need to unwind later.
 
 ### Notifications / Alert
 
@@ -281,9 +288,9 @@ Use `text/*` tokens on `<Text>` (and other text elements), and `icon/*` tokens o
 |---|---|---|
 | `text/secondary` | `icon/secondary` | ✓ |
 | `text/tertiary` | `icon/tertiary` | ✓ |
-| `text/link` | `icon/interactive` | ✓ (both → `sys.interactive`) |
+| `text/link` | `icon/interactive` | ✓ (both → `color/purple/base`) |
 
-**Gotcha**: `icon/link` does **not** exist. Use `icon/interactive` instead — it resolves to the same `sys.interactive` color as `text/link`.
+**Gotcha**: `icon/link` does **not** exist. Use `icon/interactive` instead — it resolves to the same `color/purple/base` as `text/link`.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitrise/bitkit-v2",
   "private": false,
-  "version": "0.3.327",
+  "version": "0.3.328",
   "description": "Bitrise Design System Components built with Chakra UI V3",
   "keywords": [
     "react",