Skip to content

Commit ac8e28d

Browse files
committed
chore(guide): update migration guide (#1652)
BREAKING CHANGE: list all the migration changes to ease migration
1 parent fe7e65e commit ac8e28d

2 files changed

Lines changed: 40 additions & 0 deletions

File tree

.github/workflows/ci.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ on:
77
push:
88
branches: [master]
99
pull_request:
10+
branches: [master]
1011
merge_group:
1112
branches: [master]
1213

doc/migration-guide.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,45 @@ Mistica 17 is a major release. Among other breaking changes, the `extra` prop fa
1616
- `AdvancedDataCard`: `extraDividerPadding` has been renamed to `slotDividerPadding`, and `noExtraDivider` has
1717
been renamed to `noSlotDivider`.
1818

19+
### Removed deprecated props and hooks
20+
21+
- `isInverse` prop across all components (`Boxed`, `DataCard`, `CoverCard`, `MediaCard`, `BoxedRow`,
22+
`ResponsiveLayout`, `LoadingScreen`, `BoxedAccordionItem`, `FeedbackScreen`, `HeaderLayout`,
23+
`MainSectionHeaderLayout`, and `ThemeVariant`). Use `variant="brand"` instead.
24+
- `Spinner.rolePresentation` prop. Use `aria-hidden` instead.
25+
- `Theme.enableTabFocus` prop. Rely on native `:focus-visible` behavior; the internal TabFocus mechanism has
26+
been removed.
27+
- `NavigationBar.paddingX` prop. Use `wide` instead.
28+
- `RowList.ariaLabelledby` and `BoxedRowList.ariaLabelledby` props. Use `aria-labelledby` instead.
29+
- Sheet items no longer accept Icon components. Define icons using `url` and `urlDark` properties instead.
30+
- Card prop aliases: `button`, `actions`, `media`, `poster`, `imageUrl`, `backgroundImage`, `backgroundVideo`,
31+
`backgroundVideoRef`, and `secondaryButton`. Use the new card API with `buttonPrimary`, `buttonSecondary`,
32+
`imageSrc`, `imageSrcSet`, `videoSrc`, and related props.
33+
- `useIsInverseVariant` hook has been removed.
34+
- `useIsInverseOrMediaVariant` hook has been removed.
35+
- Sheet public exports have been removed: `ActionsSheet`, `InfoSheet`, `ActionsListSheet`, and
36+
`RadioListSheet`. Use `showSheet()` instead.
37+
38+
### Test attributes
39+
40+
- The `data-component-name` attribute has been removed from all components. Use `data-testid` instead for
41+
testing.
42+
43+
### Design tokens
44+
45+
- The `legacyDisplay` border radius token has been removed from the skin contract. Components previously using
46+
it now use the `container` token instead. This may cause visual changes to `EmptyState` and feedback screens
47+
depending on your skin.
48+
49+
### Skin changes
50+
51+
- The `vivo-new` skin has been merged into `vivo`, replacing the old vivo skin. If you were using `vivo-new`,
52+
migrate to `vivo`.
53+
- A new `vivo-evolution` skin has been introduced as an evolution path from the previous vivo-new design.
54+
- The `O2-new` skin has replaced the old O2 skin. The old O2 design is no longer available.
55+
- The `movistar-new` skin has replaced the old Movistar skin. The old Movistar design is no longer available.
56+
- The `Tu` skin has been removed entirely. No replacement is available.
57+
1958
## Migration Guide for the New Cards Ecosystem (Starting from Mistica 16.xx.xx)
2059

2160
The changes introduced in this version are backwards compatible; however, several components and props have

0 commit comments

Comments
 (0)