docs: address Talkor's review feedback on changelog and migration guide

Remove internal implementation details (usePopover, Refable, CustomSvgIcon section),
fix codemod CLI syntax to use correct -m v4 flag, move MCP tip below migration steps,
add missing --docs suffix to changelog link, and improve Chips/DatePicker descriptions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rivka-ungar

packages/docs/src/pages/migration-guide/vibe-4-changelog.md

@@ -2,7 +2,7 @@
 
 This is the complete list of changes in the Vibe 4 release. Changes that are marked with a 🔀 are covered by a migration script (codemod).
 
-For the complete migration guide see the [Vibe 4 Migration Guide](https://vibe.monday.com/?path=/docs/vibe-4-migration-guide).
+For the complete migration guide see the [Vibe 4 Migration Guide](https://vibe.monday.com/?path=/docs/vibe-4-migration-guide--docs).
 
 ## General
 
@@ -63,20 +63,16 @@ Note: Component-specific compound props like `inputAriaLabel`, `menuAriaLabel`,
 
 ### Chips
 
-- The `disableClickableBehavior` prop has been removed 🔀
+- The `disableClickableBehavior` prop has been removed — Chips now always uses the clickable wrapper when click handlers are provided 🔀
 
 ### Clickable
 
 - `ariaHasPopup` now accepts `boolean` only (was `boolean | string`)
 - `tabIndex` now accepts `number` only (was `string | number`)
 
-### CustomSvgIcon
-
-- The `onClick` and `clickable` props have been removed — wrap with a clickable element instead
-
 ### DatePicker
 
-- Legacy DatePicker (`react-dates` + `moment`) replaced with new implementation (`react-day-picker` + `date-fns`)
+- Legacy DatePicker (`react-dates` + `moment`) replaced with new implementation (`react-day-picker` + `date-fns`) with an updated visual design
 - `date` prop type changed from `moment.Moment` to `Date`
 - `onPickDate` renamed to `onDateChange`
 - `range` boolean prop replaced with `mode: "single" | "range"`
@@ -88,8 +84,6 @@ Note: Component-specific compound props like `inputAriaLabel`, `menuAriaLabel`,
 - `modifiers` prop removed — use `middleware` prop instead
 - `enableNestedDialogLayer` prop removed — `LayerProvider` is always used
 - `addKeyboardHideShowTriggersByDefault` default changed to `true`
-- `usePopover` hook removed from `@vibe/dialog`
-- `Refable` component removed from public exports
 - Removed dependencies: `react-popper`, `@popperjs/core`
 - Added dependency: `@floating-ui/react-dom`
 
@@ -117,6 +111,7 @@ Note: Component-specific compound props like `inputAriaLabel`, `menuAriaLabel`,
 - `iconType` prop renamed to `type` 🔀
 - `iconSize` prop renamed to `size` 🔀
 - `size` prop now applies to `type="src"` icons (previously only affected `type="svg"`)
+- `onClick` and `clickable` props removed from internal `CustomSvgIcon` — wrap with a clickable element (e.g. `<IconButton>`) instead
 
 ### LinearProgressBar (ProgressBar)
 

packages/docs/src/pages/migration-guide/vibe-4-migration-guide.mdx

@@ -8,15 +8,6 @@ import { DiffCodeBlock } from "./DiffCodeBlock";
 
 <br />
 
-<Tip type="success" title="NEW! AI-powered migration available!" emoji={false}>
-  **Skip the manual work and let AI handle your entire Vibe 4 migration!** With the [Vibe MCP
-  server](?path=/docs/mcp-new--docs), simply ask your AI assistant: *"Help me migrate this
-  project from Vibe 3 to Vibe 4"* and it will automatically scan your codebase, identify all breaking changes, and run
-  the exact codemods you need.
-  <br /> <br /> **[Install the MCP →](?path=/docs/mcp-new--docs) and turn your migration into
-  minutes!**
-</Tip>
-
 <div style={{ lineHeight: "1.8" }}>
 
 - [Intro](#intro)
@@ -96,6 +87,12 @@ Input components (TextField, TextArea, Dropdown) now have reduced inline padding
 
 5. Run your code formatter to clean up any formatting changes from the codemod (optional).
 
+<Tip type="success" title="AI-powered migration" emoji={false}>
+  You can also use the [Vibe MCP server](?path=/docs/mcp-new--docs) with your AI assistant to automate
+  the migration. Ask: *"Help me migrate this project from Vibe 3 to Vibe 4"* and it will scan your
+  codebase, identify breaking changes, and run the codemods for you.
+</Tip>
+
 ## Breaking Changes 🚨
 
 The following changes are **complementary to the migration codemod** and may require manual intervention. If you prefer to migrate entirely by hand (without `@vibe/codemod`), refer to the [Complete Vibe 4 changelog](https://github.com/mondaycom/vibe/blob/master/packages/docs/src/pages/migration-guide/vibe-4-changelog.md).
@@ -282,7 +279,7 @@ The `"stretch"` value has been removed from the `justify` prop:
 
 Props have been renamed to remove the redundant "icon" prefix:
 
-**Codemod available**: `npx @vibe/codemod icon-props-rename`
+**Handled by codemod** (`npx @vibe/codemod -m v4`)
 
 <ul>
   <DiffCodeBlock
@@ -392,7 +389,7 @@ The finish button now renders by default on the last step. To hide it, explicitl
 
 The `tooltipPosition` prop has been removed. Use `tooltipProps` instead:
 
-**Codemod available**: `npx @vibe/codemod TextWithHighlight-component-migration`
+**Handled by codemod** (`npx @vibe/codemod -m v4`)
 
 <ul>
   <DiffCodeBlock
@@ -406,7 +403,7 @@ The `tooltipPosition` prop has been removed. Use `tooltipProps` instead:
 
 `TipseenImage` has been removed. Use `TipseenMedia` with an `<img>` child:
 
-**Codemod available**: `npx @vibe/codemod TipseenImage-component-migration`
+**Handled by codemod** (`npx @vibe/codemod -m v4`)
 
 <ul>
   <DiffCodeBlock
@@ -422,7 +419,7 @@ The `tooltipPosition` prop has been removed. Use `tooltipProps` instead:
 
 1. The `noSpacing` prop has been removed. When `areLabelsHidden` is `true`, margin is removed automatically:
 
-   **Codemod available**: `npx @vibe/codemod Toggle-component-migration`
+   **Handled by codemod** (`npx @vibe/codemod -m v4`)
 
 <ul>
   <DiffCodeBlock
@@ -565,7 +562,7 @@ Most components from `@vibe/core/next` (AttentionBox, Dropdown, DatePicker, Dial
 
 **Do I need to update my ARIA props?**
 
-Yes. All custom camelCase ARIA props (`ariaLabel`, `ariaHidden`, etc.) have been replaced with standard `aria-*` attributes. Run `npx @vibe/codemod aria-props-migration` to migrate automatically.
+Yes. All custom camelCase ARIA props (`ariaLabel`, `ariaHidden`, etc.) have been replaced with standard `aria-*` attributes. Run `npx @vibe/codemod -m v4` to migrate automatically.
 
 **What if the codemod doesn't cover my use case?**