Add migration guide (#9497)

Author: NigelBreslaw

ui-libraries/material/MIGRATION.md

@@ -0,0 +1,130 @@
+<!-- Copyright © SixtyFPS GmbH <[email protected]> ; SPDX-License-Identifier: MIT -->
+
+## Technical Preview -> 1.0 migration guide
+
+This document summarizes all changes made to the Material Components between the Technical Preview and the 1.0 release.
+
+## Major System-Wide Changes
+
+### Styling System Renaming
+- **`Animation` → `MaterialAnimation`**
+  - All animation imports now use `MaterialAnimation` instead of `Animation`
+  - Affects: bottom-sheet, check-box, chip, dialog, drawer, extended-touch-area, modal, navigation-drawer, radio-button, search-bar, segmented-button, snack-bar, state-layer, switch, tab-bar, text-field
+
+- **`typography` → `MaterialTypography`**
+  - Typography system renamed for consistency
+  - Affects: app-bar, badge, base-button, chip, date-picker, dialog, drawer, elevated-button, filled-button, filled-icon-button, floating-action-button, icon-button, list, material-text, menu, navigation-bar, navigation-drawer, outline-button, outline-icon-button, search-bar, snack-bar, tab-bar, text-button, text-field, time-picker, tonal-button, tonal-icon-button, tooltip
+
+## Component Changes
+
+### Navigation Components
+
+#### Navigation Drawer
+- **New**: ModalNavigationDrawer documentation added
+- **API Changes**:
+  - `leading_clicked` → `leading_button_clicked`
+  - `trailing_clicked` → `trailing_button_clicked`
+  - `leading_icon` → `leading_button`
+  - `trailing_icon` → `trailing_button`
+  - `current_item` → `current_index`
+- **New Features**: Added `index_changed` callback
+
+#### Navigation Bar
+- **API Changes**: Same navigation-related changes as Navigation Drawer
+
+### Form Components
+
+#### Check-Box
+- **Component Rename**: `CheckBoxListTile` → `CheckBoxTile`
+- **Various fixes** implemented
+
+#### Radio-Button
+- **New Components**: Added RadioButton and RadioButtonTile
+
+#### Progress-Indicator
+- **API Change**: `value` property → `progress` property
+
+#### Slider
+- **New Feature**: Added `released` callback
+- **Improvements**: Various slider enhancements
+
+#### Segmented-Button
+- **API Changes**:
+  - `model` → `items`
+  - `icon-selected` → `selected-icon`
+- **New Feature**: Added `index-changed` callback
+
+### Input Components
+
+#### Text-Field
+- **API Changes**:
+  - `placeholder` → `placeholder-text`
+
+#### Time-Picker
+- **Component Rename**: `TimePicker` → `TimePickerPopup`
+- **API Changes**:
+  - `twelf_hour_model` → `twelfth_hour_model` (typo fix)
+  - `current_item` → `current_index`
+  - `hour_labl` → `hour_label` (typo fix)
+- **New Properties**: Added various time picker properties (radius, picker_diameter, center, outer_padding, inner_padding, etc.)
+- **New Properties**: Added `use_24_hour_format`, `title`, `cancel_text` properties
+
+#### Date-Picker
+- **New Component**: Added DatePickerPopup
+
+### Button Components
+
+#### All Button Types
+- **API Changes**: Same typography and animation system updates as listed above
+
+### Layout Components
+
+#### List
+- **API Changes**:
+  - `action-icon` → `action-button-icon`
+
+#### Badge
+- **API Changes**:
+  - `empty-badge` → `show-badge`
+
+### Menu Components
+
+#### Menu
+- **New Component**: Added Menu component
+- **API Changes**:
+  - `item_clicked` → `activated` callback
+  - Component rename: `Menu` → `PopupMenu`
+
+#### Drop-Down-Menu
+- **New Component**: Added DropDownMenu
+- **API Changes**:
+  - Added `selected` callback
+
+### Dialog Components
+
+#### Dialog & SnackBar
+- **Multi-rename changes**
+
+#### Action-Chip & Search-Bar
+- **API Changes**:
+  - `avatar` → `avatar-icon`
+
+### Visual Components
+
+#### Check-Box (Icon Properties)
+- **API Changes**:
+  - `icon-checked` → `checked-icon`
+
+#### Various Components
+- **API Changes**:
+  - `container-background` → `show-background`
+
+## New Components Added
+
+1. **Radio-Button** and **RadioButtonTile**
+2. **Menu** component
+3. **Drop-Down-Menu** component
+4. **Date-Picker-Popup** component
+5. **Modal-Navigation-Drawer** documentation
+
+