Codemods
Automated migrations that move a consuming app across Pluma breaking changes, grouped by the
@customerio/pluma-components version each change lands in. Run them with the Pluma CLI.5.0.0
Color Variant Rename
Rename palette hue values (grey to gray, raspberry to pink, clementine to orange, plum to fuchsia, purple to violet) on Badge, Coin, StatusIndicator, PageHeaderIconTile, TimelineItem and ConditionViewerItem, and Badge accent/*-outline colors to variant + color.
Text Icon Color Rename
Rename Text/Icon color values (base/bold/active to primary, subtle/minimal/placeholder to secondary), Box backgroundColor and Coin borderColor values to the semantic layer.
Theme Tokens Rename
Rename themeVars and --pluma-* CSS custom property reads to the semantic color layer (surface planes, scopes, text/mark roles, rebuilt palette steps), and defaultTheme to lightTheme. Hover, pressed and selected reads go to the 5.0 state recipes rather than the resting rung; sites that need a human land in the findings report.
3.0.0
Button Variant Rename
Rename Button variant props: tertiary→secondary, subtle→tertiary.
Css Token Rename
Rename the CSS custom properties the token rename moved: --font-size-s/m/l→sm/md/lg, --text-product-ps→product-psm, and the Banner/Snackbar error names→critical (both the --pluma-* and the bare @customerio/pluma-css spelling).
Data Table Tanstack V9
Migrate DataTable to TanStack Table v9: Ember flexRenderWrapper→flexRenderComponent (@props→@options), sortingFn→sortFn, table.getState()→table.store.state, and the createColumnHelper features type parameter.
Deprecated Props Removal
Migrate removed deprecated props: Button/Snackbar/Link isError, isDanger→isCritical on Button and the dropdown/filters components that inherit it, Popover content, Banner/Snackbar variant "warning"→"caution" and "error"→"critical".
Event Handler Rename
Rename the deprecated onChange handler to onCheckedChange on Checkbox, Radio, and OptionCard.
Icon Deprecations
Migrate deprecated icons: rename/merge icon names (including error→critical, warning→caution), fold v1-only sizes (xxs/xs→sm), and remove the Icon sizeVersion prop.
Label Icon To Coin
Migrate the removed LabelIcon component to Coin with a child Icon.
Label To Badge
Replace the deprecated Label with Badge, and Badge isOutline/isEmphasized with variant and color values.
Primitive Rename
Rename the primitive components: PopoverPrimitive→PlainPopover, ModalPrimitive→PlainModal, SelectPrimitive→SelectController (and their subcomponents/types).
Size Longhand Rename
Rename long-hand size props (medium→md, small→sm, large→lg) on Button, ButtonGroup, ProgressBar, SegmentedControl, Select, TextField, Toggle, and friends.
Test Helper Get Rename
Migrate the removed PlumaTestHelpers.get test helper to find (review notes flag sites that should use extract).
Text Size Shorthand Rename
Rename Text/Heading/Paragraph short-hand size props: s→sm, m→md, l→lg (and product-ps text style→product-psm).
Toggle Button To Button
Migrate the removed ToggleButton component to Button (defaults to variant="tertiary").