@pantheon-systems/pds-toolkit-react 2.0.0-alpha.36 → 2.0.0-alpha.38

package/codemods/v1-to-v2/mappings.json

@@ -6,7 +6,7 @@
 			{
 				"from": "IndicatorBadge",
 				"to": "Badge",
-				"reason": "IndicatorBadge has been renamed to Badge in v2. The component API has also changed \u2014 see props.typeChanges for color and size migration details."
+				"reason": "IndicatorBadge has been renamed to Badge in v2. The component API has also changed — see props.typeChanges for color and size migration details."
 			},
 			{
 				"from": "NavMenu",
@@ -75,6 +75,54 @@
 			{
 				"component": "SiteDashboardHeading",
 				"reason": "Component removed. Compose locally using Icon, Badge, Button, and optionally Popover with SiteTypeIcon from custom-types. See Patterns/Site Dashboard Heading in Storybook for the recipe."
+			},
+			{
+				"component": "Navbar",
+				"prop": "hideLogo",
+				"reason": "Removed in V2. The logo is now passed via the logo slot. Omit the slot to show no logo.",
+				"replacement": "Remove this prop. To hide the logo, simply omit the logo slot."
+			},
+			{
+				"component": "Navbar",
+				"prop": "logoDisplayType",
+				"reason": "Removed in V2. Logo display type is now controlled by the PantheonLogo component's displayType prop, passed directly into the logo slot.",
+				"replacement": "Pass <PantheonLogo displayType='...' slot='logo' /> into the Navbar children."
+			},
+			{
+				"component": "Navbar",
+				"prop": "logoLinkContent",
+				"reason": "Removed in V2. Logo link is now passed via the PantheonLogo component in the logo slot.",
+				"replacement": "Pass <PantheonLogo linkContent={<a href='...'>...</a>} slot='logo' /> into the Navbar children."
+			},
+			{
+				"component": "Navbar",
+				"prop": "logoSrc",
+				"reason": "Removed in V2. Custom logo images should be placed directly in the logo slot.",
+				"replacement": "Place your logo image element directly in the logo slot: <img src='...' slot='logo' />."
+			},
+			{
+				"component": "Navbar",
+				"prop": "logoSubBrand",
+				"reason": "Removed in V2 along with sub-brand logo support.",
+				"replacement": "Remove this prop. Sub-brand display is no longer supported in Navbar."
+			},
+			{
+				"component": "PantheonLogo",
+				"prop": "subBrand",
+				"reason": "Removed in V2. Sub-brand display has been removed from the PantheonLogo component.",
+				"replacement": "Remove this prop. Compose your own sub-brand treatment using a separator and text element alongside PantheonLogo."
+			},
+			{
+				"component": "PantheonLogo",
+				"prop": "displayType",
+				"reason": "The sub-brand and sub-brand-small values have been removed in V2.",
+				"replacement": "Use 'full', 'icon', or 'wordmark' instead. Remove any usage of displayType='sub-brand' or displayType='sub-brand-small'."
+			},
+			{
+				"component": "WorkspaceSelector",
+				"prop": "planTier (on WorkspaceSelectorItem)",
+				"reason": "Removed in V2. Plan tier badges are no longer displayed in the workspace selector trigger button.",
+				"replacement": "Remove the planTier field from WorkspaceSelectorItem objects."
 			}
 		],
 		"additions": [
@@ -87,6 +135,42 @@
 				"component": "PaginationCompact",
 				"description": "New for V2. A space-efficient pagination control combining a page selector dropdown with previous/next buttons. Suited for dense layouts such as table toolbars or sidebars.",
 				"usage": "Use when horizontal space is limited or the total page count is high and users need direct access to any page."
+			},
+			{
+				"component": "Navbar",
+				"prop": "logo slot",
+				"description": "New logo named slot renders the logo in both the desktop bar and the mobile top bar. Replaces the logoLinkContent, logoSrc, logoDisplayType, logoSubBrand, and hideLogo props.",
+				"usage": "Pass <PantheonLogo linkContent={<a href='...'>...</a>} slot='logo' /> as a child of Navbar."
+			},
+			{
+				"component": "Navbar",
+				"prop": "items-center slot",
+				"description": "New items-center named slot renders content in the center of the desktop navbar, truly centered using CSS grid. On mobile, the slot content collapses into the slide-out panel alongside items-left and items-right.",
+				"usage": "Pass content with slot='items-center' to place it in the center of the navbar (e.g. a search input)."
+			},
+			{
+				"component": "PantheonLogo",
+				"prop": "size",
+				"description": "New size prop controls logo scale. The wordmark height is the sizing basis and maps to PDS typography size tokens: s = --pds-typography-size-s, m = --pds-typography-size-m, l = --pds-typography-size-l. The full and icon variants scale proportionally so the fist matches the wordmark height.",
+				"usage": "Use size='s' for compact contexts (e.g. navbar), size='m' for default, size='l' for hero or marketing use."
+			},
+			{
+				"component": "AppLayout",
+				"prop": "header slot",
+				"description": "New header named slot renders a full-width region (typically a Navbar) above the sidebar and main content. When present, AppLayout stacks the header on top and positions the sidebar directly below it, so consumers no longer need an external flex-column wrapper to combine a Navbar with AppLayout.",
+				"usage": "Pass a component such as <Navbar slot='header'>...</Navbar> as a child of AppLayout."
+			},
+			{
+				"component": "AppLayout",
+				"prop": "footer slot",
+				"description": "New footer named slot renders a region (typically a SiteFooter) below the main content and aligned with it, while the sidebar spans the full height alongside the main + footer column. Gives the footer its own landmark instead of nesting it inside the main element.",
+				"usage": "Pass a component such as <SiteFooter as='footer' slot='footer' /> as a child of AppLayout."
+			},
+			{
+				"component": "Navbar",
+				"prop": "inlinePadding",
+				"description": "New inlinePadding prop overrides the desktop bar's horizontal (inline) padding with any CSS length, applied symmetrically. Defaults to the Container's standard gutter, so existing navbars are unaffected.",
+				"usage": "Set inlinePadding (e.g. 'var(--pds-spacing-m)') to align the navbar content with an adjacent app shell, such as the AppLayout sidebar when the navbar is in a header slot."
 			}
 		],
 		"deprecations": [
@@ -153,13 +237,13 @@
 				"component": "GlobalWrapper",
 				"from": "mobileMenuMaxWidth",
 				"to": "mobileMaxWidth",
-				"reason": "Renamed for clarity \u2014 the value is the maximum viewport width at which mobile styles are active. The prop now drives the data-pds-mobile attribute on :root used by component CSS to apply mobile styles, replacing the ResponsiveContext isMobile pattern. The default value has changed from 640 to 767 to align exactly with --pds-bp-s-only (max-width: 767px)."
+				"reason": "Renamed for clarity — the value is the maximum viewport width at which mobile styles are active. The prop now drives the data-pds-mobile attribute on :root used by component CSS to apply mobile styles, replacing the ResponsiveContext isMobile pattern. The default value has changed from 640 to 767 to align exactly with --pds-bp-s-only (max-width: 767px)."
 			},
 			{
 				"component": "ComboboxMultiselect",
 				"from": "auxiliaryPanel",
 				"to": "aiSuggestions",
-				"reason": "Renamed for clarity \u2014 the auxiliary panel is specifically for AI suggestions. General-purpose floating panels can now be built with the Dropdown compound component."
+				"reason": "Renamed for clarity — the auxiliary panel is specifically for AI suggestions. General-purpose floating panels can now be built with the Dropdown compound component."
 			},
 			{
 				"component": "Button",
@@ -171,19 +255,19 @@
 				"component": "Icon",
 				"from": "iconSize",
 				"to": "size",
-				"reason": "The iconSize prop has been renamed to size for consistency across V2 icon components. The available size values and defaults remain unchanged."
+				"reason": "The iconSize prop has been renamed to size for consistency across V2 icon components. The default ('l') is unchanged, but the 'xs' (10px) value has been removed (see props.typeChanges) — use 's' instead."
 			},
 			{
 				"component": "CloseButton",
 				"from": "iconSize",
 				"to": "size",
-				"reason": "The iconSize prop has been renamed to size for consistency with other button components. The available size values remain the same ('m', 'l', 'xl')."
+				"reason": "The iconSize prop has been renamed to size for consistency with other button components. Size values have also been standardized to 's', 'm', 'l' (see props.typeChanges)."
 			},
 			{
 				"component": "PlatformIcon",
 				"from": "iconSize",
 				"to": "size",
-				"reason": "The iconSize prop has been renamed to size for consistency with V2 component conventions. Size values have also changed to align with the Icon component scale \u2014 'xs', 's', 'm', 'l', 'xl', '2xl', '3xl' \u2014 replacing the previous 1.2\u00d7 ratio scale. The pixel sizes for 'l', 'xl', and '2xl' are different: l is now 1.25rem (was 1.2rem), xl is 1.5rem (was 1.44rem), 2xl is 2rem (was 1.728rem)."
+				"reason": "The iconSize prop has been renamed to size for consistency with V2 component conventions. Size values have also changed to align with the Icon component scale — 'xs', 's', 'm', 'l', 'xl', '2xl', '3xl' — replacing the previous 1.2× ratio scale. The pixel sizes for 'l', 'xl', and '2xl' are different: l is now 1.25rem (was 1.2rem), xl is 1.5rem (was 1.44rem), 2xl is 2rem (was 1.728rem)."
 			},
 			{
 				"component": "FileDiff",
@@ -259,6 +343,12 @@
 				"description": "New size prop adds two tab height variants. Defaults to 's' (32px). 'm' gives 40px tabs with larger text and icons.",
 				"usage": "Use size='s' (default) for standard navigation, size='m' for more prominent tab navigation."
 			},
+			{
+				"component": "SegmentedButton",
+				"prop": "size",
+				"description": "New size prop adds two height/font-size variants. Defaults to 's' (32px, matching the small button height). 'xs' gives 24px segments for compact layouts.",
+				"usage": "Use size='s' (default) for standard usage, size='xs' for dense or space-constrained layouts."
+			},
 			{
 				"component": "ComboboxMultiselect",
 				"prop": "size",
@@ -396,11 +486,41 @@
 			{
 				"component": "SideNav",
 				"prop": "hasMobileDropdown",
-				"description": "New hasMobileDropdown prop opts in to rendering a dropdown menu in place of the standard navigation at mobile viewports. Defaults to false \u2014 the standard navigation is shown at all breakpoints.",
+				"description": "New hasMobileDropdown prop opts in to rendering a dropdown menu in place of the standard navigation at mobile viewports. Defaults to false — the standard navigation is shown at all breakpoints.",
 				"usage": "Use hasMobileDropdown={true} if your layout requires a dropdown menu at mobile. The mobile breakpoint is controlled by the mobileBreakpoint prop on GlobalWrapper."
 			}
 		],
 		"removals": [
+			{
+				"component": "Spinner",
+				"prop": "colorType",
+				"replacement": "Replace with the `color` prop — pass any CSS color string or `var(--token)` reference. Use `'var(--pds-color-foreground-reverse)'` in place of `'monochromatic-reverse'`, and omit the prop entirely in place of `'monochromatic'` or `'full-color'` (the default is now foreground default).",
+				"reason": "The colorType prop ('full-color' | 'monochromatic' | 'monochromatic-reverse') has been removed in v2. The spinner now accepts a single `color` prop; the track ring renders at 30% opacity of the same color automatically. The default color is now the foreground default token."
+			},
+			{
+				"component": "CodeBlock",
+				"prop": "colorType",
+				"replacement": "Remove the prop. CodeBlock now renders in a single unified style.",
+				"reason": "The colorType prop ('dark' | 'light') has been removed in v2. CodeBlock now renders in one consistent style that works across both page themes."
+			},
+			{
+				"component": "Tabs",
+				"prop": "size",
+				"replacement": "Remove the prop. Tabs now render at a single size equivalent to the former size='m'.",
+				"reason": "The size prop has been removed in v2. The component now renders at one size only. Remove any size='s' or size='m' usage."
+			},
+			{
+				"component": "TabMenu",
+				"prop": "size",
+				"replacement": "Remove the prop. TabMenu now renders at a single size equivalent to the former size='m'.",
+				"reason": "The size prop has been removed in v2. The component now renders at one size only. Remove any size='s' or size='m' usage."
+			},
+			{
+				"component": "ButtonNav",
+				"prop": "size",
+				"replacement": "Remove the prop. ButtonNav now renders at a single size equivalent to the former size='s'.",
+				"reason": "The size prop and the medium size have been removed in v2. The component now renders at one size only. Remove any size='s' or size='m' usage. A smaller size may be reintroduced later if a need arises."
+			},
 			{
 				"component": "SiteSearch",
 				"prop": "horizontalOffset",
@@ -430,7 +550,7 @@
 				"prop": "variant",
 				"oldValue": "navbar",
 				"replacement": "Use variant=\"subtle\"",
-				"reason": "The navbar variant has been removed in v2. It was visually identical to subtle \u2014 replace with subtle."
+				"reason": "The navbar variant has been removed in v2. It was visually identical to subtle — replace with subtle."
 			},
 			{
 				"component": "MenuButton",
@@ -498,7 +618,7 @@
 			{
 				"component": "Switch",
 				"prop": "statusLabelPlacement",
-				"replacement": "Remove the prop. No replacement \u2014 the status label is no longer rendered visually.",
+				"replacement": "Remove the prop. No replacement — the status label is no longer rendered visually.",
 				"reason": "The visual status label has been removed in V2, making its placement prop obsolete."
 			},
 			{
@@ -516,7 +636,7 @@
 			{
 				"component": "MenuButton",
 				"prop": "withinNavbar",
-				"reason": "Removed in V2. The dropdown no longer adjusts its border radius based on navbar context \u2014 it floats normally regardless of placement.",
+				"reason": "Removed in V2. The dropdown no longer adjusts its border radius based on navbar context — it floats normally regardless of placement.",
 				"migration": "Remove the withinNavbar prop. No replacement needed."
 			},
 			{
@@ -627,6 +747,132 @@
 			}
 		],
 		"typeChanges": [
+			{
+				"component": "Icon",
+				"prop": "size",
+				"description": "The 'xs' size value has been removed",
+				"v1Type": "'xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl'",
+				"v2Type": "'s' | 'm' | 'l' | 'xl' | '2xl' | '3xl'",
+				"migration": {
+					"xs": "s (removed, use 's' instead)"
+				},
+				"reason": "The 10px 'xs' icon size has been removed in v2. It had a single internal usage (the TagsInput remove button, now 's'/12px) and is superseded by 's'. Use size='s' instead."
+			},
+			{
+				"component": "FlexContainer",
+				"prop": "gap",
+				"description": "The named gap scale was replaced by the numbered spacing scale (`GapScale`). Fixed at all breakpoints; use `mobileGap` to change the gap on small screens.",
+				"v1Type": "'minimal' | 'narrow' | 'standard' | 'wide' | 'none'",
+				"v2Type": "'none' | 'xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl'",
+				"migration": {
+					"minimal": "s",
+					"narrow": "m",
+					"standard": "xl",
+					"wide": "3xl"
+				},
+				"reason": "Unifies gap onto one predictable, fixed spacing scale across FlexContainer, Grid, and the layout components."
+			},
+			{
+				"component": "FlexContainer",
+				"prop": "mobileGap",
+				"description": "The named gap scale was replaced by the numbered spacing scale (`GapScale`).",
+				"v1Type": "'minimal' | 'narrow' | 'standard' | 'wide' | 'none'",
+				"v2Type": "'none' | 'xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl'",
+				"migration": {
+					"minimal": "s",
+					"narrow": "m",
+					"standard": "xl",
+					"wide": "3xl"
+				},
+				"reason": "Unifies gap onto one predictable, fixed spacing scale across FlexContainer, Grid, and the layout components."
+			},
+			{
+				"component": "SidebarLayout",
+				"prop": "gridGap",
+				"description": "The named gap scale was replaced by the numbered spacing scale (`GapScale`).",
+				"v1Type": "'narrow' | 'standard' | 'wide' | 'none'",
+				"v2Type": "'none' | 'xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl'",
+				"migration": {
+					"narrow": "m",
+					"standard": "xl",
+					"wide": "3xl"
+				},
+				"reason": "Unifies gap onto one predictable, fixed spacing scale across FlexContainer, Grid, and the layout components."
+			},
+			{
+				"component": "TwoItemLayout",
+				"prop": "gridGap",
+				"description": "The named gap scale was replaced by the numbered spacing scale (`GapScale`).",
+				"v1Type": "'narrow' | 'standard' | 'wide' | 'none'",
+				"v2Type": "'none' | 'xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl'",
+				"migration": {
+					"narrow": "m",
+					"standard": "xl",
+					"wide": "3xl"
+				},
+				"reason": "Unifies gap onto one predictable, fixed spacing scale across FlexContainer, Grid, and the layout components."
+			},
+			{
+				"component": "ThreeItemLayout",
+				"prop": "gridGap",
+				"description": "The named gap scale was replaced by the numbered spacing scale (`GapScale`).",
+				"v1Type": "'narrow' | 'standard' | 'wide' | 'none'",
+				"v2Type": "'none' | 'xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl'",
+				"migration": {
+					"narrow": "m",
+					"standard": "xl",
+					"wide": "3xl"
+				},
+				"reason": "Unifies gap onto one predictable, fixed spacing scale across FlexContainer, Grid, and the layout components."
+			},
+			{
+				"component": "Panel",
+				"prop": "padding",
+				"description": "The padding prop moved from the shared GridGapOptions scale to a dedicated, curated PaddingScale. Values were renamed: narrow → condensed, wide → spacious. standard and none are unchanged. The underlying spacing values are preserved.",
+				"v1Type": "'wide' | 'standard' | 'narrow' | 'none'",
+				"v2Type": "'none' | 'condensed' | 'standard' | 'spacious'",
+				"migration": {
+					"narrow": "condensed",
+					"wide": "spacious"
+				},
+				"reason": "Padding is a container-internal concern with its own curated semantic scale, separated from the numbered gap scale used for layout spacing."
+			},
+			{
+				"component": "Card",
+				"prop": "padding",
+				"description": "The padding prop moved from the shared GridGapOptions scale to a dedicated, curated PaddingScale. Values were renamed: narrow → condensed, wide → spacious. standard and none are unchanged. The underlying spacing values are preserved.",
+				"v1Type": "'wide' | 'standard' | 'narrow' | 'none'",
+				"v2Type": "'none' | 'condensed' | 'standard' | 'spacious'",
+				"migration": {
+					"narrow": "condensed",
+					"wide": "spacious"
+				},
+				"reason": "Padding is a container-internal concern with its own curated semantic scale, separated from the numbered gap scale used for layout spacing."
+			},
+			{
+				"component": "ActionCard",
+				"prop": "padding",
+				"description": "The padding prop moved from the shared GridGapOptions scale to a dedicated, curated PaddingScale. Values were renamed: narrow → condensed, wide → spacious. standard and none are unchanged. The underlying spacing values are preserved.",
+				"v1Type": "'wide' | 'standard' | 'narrow' | 'none'",
+				"v2Type": "'none' | 'condensed' | 'standard' | 'spacious'",
+				"migration": {
+					"narrow": "condensed",
+					"wide": "spacious"
+				},
+				"reason": "Padding is a container-internal concern with its own curated semantic scale, separated from the numbered gap scale used for layout spacing."
+			},
+			{
+				"component": "UtilityBar",
+				"prop": "padding",
+				"description": "The padding prop moved from the shared GridGapOptions scale to a dedicated, curated PaddingScale. Values were renamed: narrow → condensed, wide → spacious. standard and none are unchanged. The underlying spacing values are preserved.",
+				"v1Type": "'wide' | 'standard' | 'narrow' | 'none'",
+				"v2Type": "'none' | 'condensed' | 'standard' | 'spacious'",
+				"migration": {
+					"narrow": "condensed",
+					"wide": "spacious"
+				},
+				"reason": "Padding is a container-internal concern with its own curated semantic scale, separated from the numbered gap scale used for layout spacing."
+			},
 			{
 				"component": "StepList",
 				"prop": "steps",
@@ -634,9 +880,9 @@
 				"v1Type": "FlowStep[]",
 				"v2Type": "StepListItem[]",
 				"migration": {
-					"note": "Update any FlowStep type imports to StepListItem. The shape of the type is unchanged \u2014 { header: string | ReactNode, content?: string | ReactNode }."
+					"note": "Update any FlowStep type imports to StepListItem. The shape of the type is unchanged — { header: string | ReactNode, content?: string | ReactNode }."
 				},
-				"reason": "Renamed alongside the FlowSteps \u2192 StepList component rename for naming consistency."
+				"reason": "Renamed alongside the FlowSteps → StepList component rename for naming consistency."
 			},
 			{
 				"component": "CloseButton",
@@ -645,7 +891,7 @@
 				"v1Type": "() => void",
 				"v2Type": "(e: React.MouseEvent<HTMLButtonElement>) => void",
 				"migration": {
-					"note": "Backwards compatible \u2014 existing handlers that ignore the event parameter continue to work. Update handlers if you need access to the event."
+					"note": "Backwards compatible — existing handlers that ignore the event parameter continue to work. Update handlers if you need access to the event."
 				},
 				"reason": "Updated to allow consumers to call e.stopPropagation() or access other event properties when needed."
 			},
@@ -705,15 +951,15 @@
 			{
 				"component": "CloseButton",
 				"prop": "size",
-				"description": "Prop renamed from iconSize to size, and size naming convention updated to match standardized naming",
+				"description": "Prop renamed from iconSize to size, and size naming convention standardized to s/m/l",
 				"v1Type": "'md' | 'lg' | 'xl' (on iconSize prop)",
-				"v2Type": "'m' | 'l' | 'xl' (on size prop)",
+				"v2Type": "'s' | 'm' | 'l' (on size prop)",
 				"migration": {
-					"md": "m",
-					"lg": "l",
-					"xl": "xl (unchanged)"
+					"md": "s",
+					"lg": "m",
+					"xl": "l"
 				},
-				"reason": "Prop renamed from iconSize to size for consistency with other button components. Size value naming also standardized - the 'md' and 'lg' values have been shortened to 'm' and 'l' for consistency."
+				"reason": "Prop renamed from iconSize to size for consistency with other button components. Size values standardized to the single-letter s/m/l scale used across V2 (smallest rung is now 's'); pixel sizes are unchanged, only the labels shifted (md→s, lg→m, xl→l)."
 			},
 			{
 				"component": "Icon",
@@ -726,6 +972,18 @@
 				},
 				"reason": "The 'Outline' and 'Line' suffixed icon names have been removed. The base names (circlePlus, circleMinus, globe) now render the outlined/regular style by default."
 			},
+			{
+				"component": "Icon",
+				"prop": "iconName",
+				"description": "Several verbose icon names were shortened for clarity.",
+				"migration": {
+					"arrowDownLeftAndArrowUpRightToCenter": "collapseToCenter",
+					"arrowsUpDownLeftRight": "move",
+					"linkSimple": "link",
+					"linkSimpleSlash": "unlink"
+				},
+				"reason": "Renamed for brevity and clarity: 'arrowDownLeftAndArrowUpRightToCenter' → 'collapseToCenter' (pairs with 'expandFromCenter'), 'arrowsUpDownLeftRight' → 'move', 'linkSimple' → 'link', 'linkSimpleSlash' → 'unlink'. Run the icon-name-updates codemod to migrate."
+			},
 			{
 				"component": "Tooltip",
 				"prop": "triggerIconSize",
@@ -814,14 +1072,14 @@
 			{
 				"component": "CTALink",
 				"prop": "size",
-				"description": "Size naming convention updated and default changed",
+				"description": "Size naming convention updated (sm → s, md → m), default changed from 'md' to 's', and an 'xs' variant added. v2 accepts 'xs' | 's' | 'm'.",
 				"v1Type": "'sm' | 'md'",
-				"v2Type": "'s' | 'm'",
+				"v2Type": "'xs' | 's' | 'm'",
 				"migration": {
 					"sm": "s",
 					"md": "m"
 				},
-				"reason": "Standardized size naming. Default changed from 'md' to 's'."
+				"reason": "Standardized size naming and added 'xs' to support compact contexts such as the Payment Card pattern footer."
 			},
 			{
 				"component": "LinkNewWindow",
@@ -851,7 +1109,7 @@
 					"md": "m",
 					"lg": "l"
 				},
-				"reason": "Standardized size naming. The '4xs' and '3xs' sizes have been removed \u2014 use '2xs' instead. Default changed from 'md' to 'm'."
+				"reason": "Standardized size naming. The '4xs' and '3xs' sizes have been removed — use '2xs' instead. Default changed from 'md' to 'm'."
 			},
 			{
 				"component": "StatusChecker",
@@ -872,7 +1130,7 @@
 				"oldType": "'color-1' | 'color-2' | ... | 'color-20'",
 				"newType": "'apollo' | 'iris' | 'hypnos' | 'gaia' | 'aether' | 'success' | 'warning' | 'critical' | 'info' | 'discovery' | 'amber' | 'orange' | 'lime' | 'teal' | 'sky' | 'indigo' | 'rose' | 'slate' | 'sand' | 'mint' | 'silver' | 'stone'",
 				"description": "Tag color values are now named instead of numbered. Two new colors added: silver and stone.",
-				"migration": "Replace numbered color values with their named equivalents: color-1\u2192apollo, color-2\u2192iris, color-3\u2192hypnos, color-4\u2192gaia, color-5\u2192aether, color-6\u2192success, color-7\u2192warning, color-8\u2192critical, color-9\u2192info, color-10\u2192discovery, color-11\u2192amber, color-12\u2192orange, color-13\u2192lime, color-14\u2192teal, color-15\u2192sky, color-16\u2192indigo, color-17\u2192rose, color-18\u2192slate, color-19\u2192sand, color-20\u2192mint. Two new values (silver, stone) have no v1 equivalent."
+				"migration": "Replace numbered color values with their named equivalents: color-1→apollo, color-2→iris, color-3→hypnos, color-4→gaia, color-5→aether, color-6→success, color-7→warning, color-8→critical, color-9→info, color-10→discovery, color-11→amber, color-12→orange, color-13→lime, color-14→teal, color-15→sky, color-16→indigo, color-17→rose, color-18→slate, color-19→sand, color-20→mint. Two new values (silver, stone) have no v1 equivalent."
 			},
 			{
 				"component": "SidebarLayout",
@@ -880,7 +1138,7 @@
 				"v1Type": "'narrow' | 'standard' | 'wide'",
 				"v2Type": "string",
 				"description": "sidebarWidth is now a percentage string instead of a preset option.",
-				"migration": "Replace preset values with percentage equivalents: 'narrow' \u2192 '25%', 'standard' \u2192 '33%', 'wide' \u2192 '42%'. Adjust as needed for your layout."
+				"migration": "Replace preset values with percentage equivalents: 'narrow' → '25%', 'standard' → '33%', 'wide' → '42%'. Adjust as needed for your layout."
 			},
 			{
 				"component": "Table",
@@ -910,17 +1168,6 @@
 				"newType": "(key: string, order: SortOrder) => void",
 				"reason": "The sort callback now receives a column id string instead of a positional index."
 			},
-			{
-				"component": "CTALink",
-				"prop": "size",
-				"description": "Added xs size variant. The size prop now accepts xs | s | m (previously s | m).",
-				"v1Type": "'s' | 'm'",
-				"v2Type": "'xs' | 's' | 'm'",
-				"migration": {
-					"note": "Backwards compatible \u2014 existing size values are unchanged. Use size=\"xs\" when a smaller CTA link is needed."
-				},
-				"reason": "Added to support compact contexts such as the Payment Card pattern footer."
-			},
 			{
 				"component": "MenuButton",
 				"prop": "displayType",
@@ -958,6 +1205,16 @@
 	},
 	"cssClasses": {
 		"renames": [
+			{
+				"old": "pds-grid--narrow",
+				"new": "pds-grid--gap-m",
+				"reason": "The grid gap moved to the numbered spacing scale. The old responsive `narrow` gutter maps to a fixed `m` (16px) gap."
+			},
+			{
+				"old": "pds-grid--wide",
+				"new": "pds-grid--gap-3xl",
+				"reason": "The grid gap moved to the numbered spacing scale. The old responsive `wide` gutter maps to a fixed `3xl` (40px) gap."
+			},
 			{
 				"old": "pds-overline-text",
 				"new": "pds-overline-m",
@@ -1054,6 +1311,27 @@
 		"removals": []
 	},
 	"behaviorChanges": [
+		{
+			"component": "Container",
+			"prop": "full width",
+			"description": "The 'full' container width is now edge-to-edge with no inline padding.",
+			"v1Behavior": "containerWidth='full' (class pds-container--full) removed the max-width but kept the standard 2xl inline padding, so full-width sections still had a gutter.",
+			"v2Behavior": "The 'full' width now has no inline padding (padding-inline: 0), so content spans edge-to-edge. Add your own padding for full-width sections that need a gutter.",
+			"migration": "If you used containerWidth='full' (or the pds-container--full class) and relied on its inline padding, add the padding yourself (e.g. a spacing utility or wrapper).",
+			"affectedAreas": [
+				"Container",
+				"Any full-width sections using pds-container--full"
+			]
+		},
+		{
+			"component": "SiteFooter",
+			"prop": "containerWidth",
+			"description": "Default containerWidth changed from 'standard' to 'full'; the footer no longer applies its own inline padding or max-width by default.",
+			"v1Behavior": "SiteFooter wrapped its content in a standard Container, applying a max-width and inline padding (gutter) by default, plus 2xl vertical padding.",
+			"v2Behavior": "SiteFooter defaults to containerWidth='full', which is now edge-to-edge (no max-width, no inline padding); the containing layout or app provides the gutter. Vertical padding is reduced to xl.",
+			"migration": "If you relied on the footer's built-in gutter or max-width, set containerWidth explicitly (e.g. 'x-wide') or wrap the footer in your layout's container. When placing SiteFooter in AppLayout's footer slot, the region provides the inline padding.",
+			"affectedAreas": ["SiteFooter", "Footers in app and docs layouts"]
+		},
 		{
 			"component": "TextInput, RadioGroup, FileUpload, Combobox, ComboboxMultiselect, Select, Textarea, Checkbox, Switch, TagsInput, Datepicker",
 			"prop": "inputWidth",
@@ -1102,7 +1380,7 @@
 		},
 		{
 			"component": "Panel",
-			"description": "Panel simplified \u2014 status indicators removed",
+			"description": "Panel simplified — status indicators removed",
 			"v1Behavior": "Panel supported hasStatusIndicator, statusType, and typeLabels props which rendered a colored bar on the left side of the panel.",
 			"v2Behavior": "Panel is now a general-purpose container with five variants: default, sunken, raised, overlay, and critical. Status indicators have been removed.",
 			"migration": "Remove hasStatusIndicator, statusType, and typeLabels props. Remove any custom CSS targeting .pds-panel__status elements.",
@@ -1125,7 +1403,7 @@
 			"description": "Previous and next arrow buttons now hidden when at boundaries instead of disabled",
 			"v1Behavior": "Previous button rendered with aria-disabled and reduced opacity when on the first page. Next button rendered with aria-disabled and reduced opacity when on the last page.",
 			"v2Behavior": "Previous button is not rendered when on the first page. Next button is not rendered when on the last page.",
-			"migration": "No prop changes required. Remove any custom CSS targeting .pds-pagination__item--disabled \u2014 that class no longer exists.",
+			"migration": "No prop changes required. Remove any custom CSS targeting .pds-pagination__item--disabled — that class no longer exists.",
 			"affectedAreas": [
 				"Pagination component",
 				"Visual design",
@@ -1149,7 +1427,7 @@
 			"description": "Dropdown positioning may shift slightly from V1. The menu is no longer in the DOM when closed.",
 			"v1Behavior": "MenuButton used manual keyboard handling, aria-activedescendant focus management, and a custom click-outside handler. The menu element was always present in the DOM with visibility toggled via inline styles.",
 			"v2Behavior": "MenuButton now uses the shared useDropdown hook with roving tabIndex focus management (useListNavigation), built-in typeahead (useTypeahead), and automatic dismiss handling (useDismiss). The menu unmounts from the DOM when closed.",
-			"migration": "No prop changes required. If you relied on aria-activedescendant for screen readers, test with the updated component \u2014 it now uses a roving tabIndex pattern.",
+			"migration": "No prop changes required. If you relied on aria-activedescendant for screen readers, test with the updated component — it now uses a roving tabIndex pattern.",
 			"affectedAreas": [
 				"MenuButton component",
 				"Keyboard navigation",
@@ -1208,7 +1486,7 @@
 		},
 		{
 			"component": "CompactEmptyState",
-			"description": "V2 style update \u2014 typography tokens and color token correction",
+			"description": "V2 style update — typography tokens and color token correction",
 			"v1Behavior": "Heading font size and weight applied via pds-ts-l and pds-fw-bold utility classes on the element. Message color used the deprecated pds-color-text-default-secondary token.",
 			"v2Behavior": "Heading font size and weight defined in component CSS using pds-typography-size-l and pds-typography-fw-bold tokens. Message color uses the correct pds-color-fg-default-secondary token.",
 			"migration": "No prop changes. Visual appearance is the same. Remove any overrides targeting pds-color-text-default-secondary on this component.",
@@ -1220,7 +1498,7 @@
 		},
 		{
 			"component": "VerticalEmptyState",
-			"description": "V2 style update \u2014 typography tokens and color token correction",
+			"description": "V2 style update — typography tokens and color token correction",
 			"v1Behavior": "Heading font size and weight applied via pds-ts-2xl and pds-fw-bold utility classes on the element. Root color used the deprecated pds-color-text-default token.",
 			"v2Behavior": "Heading font size and weight defined in component CSS using pds-typography-size-2xl and pds-typography-fw-bold tokens. Root color uses the correct pds-color-fg-default token.",
 			"migration": "No prop changes. Visual appearance is the same. Remove any overrides targeting pds-color-text-default on this component.",

package/codemods/v1-to-v2/transforms/__testfixtures__/component-renames/basic.input.tsx

@@ -0,0 +1,33 @@
+import React from 'react';
+import {
+	IndicatorBadge,
+	NavMenu,
+	RefreshChecker,
+	FlowSteps,
+	CardSelectGroup,
+	DashboardSearch,
+	SideNavCompact,
+} from '@pantheon-systems/pds-toolkit-react';
+// Aliased import — imported name changes, local alias and JSX stay the same
+import { IndicatorBadge as LegacyBadge } from '@pantheon-systems/pds-toolkit-react';
+// Non-PDS import with the same name — untouched
+import { IndicatorBadge as ThirdPartyBadge } from 'some-other-library';
+// Deep path import — path and specifier name should both be updated
+import { IndicatorBadge as DeepBadge } from '@pantheon-systems/pds-toolkit-react/components/badges/IndicatorBadge/IndicatorBadge';
+// Deep path aliased import — path and imported name updated, local alias preserved
+import { IndicatorBadge as LegacyDeepBadge } from '@pantheon-systems/pds-toolkit-react/components/badges/IndicatorBadge/IndicatorBadge';
+
+// Non-aliased — both import specifier and JSX tags should be renamed
+const A = () => <IndicatorBadge color='blue' label='v1 badge' />;
+const B = () => <NavMenu ariaLabel='Main nav' menuItems={[]} />;
+const C = () => <RefreshChecker />;
+const D = () => <FlowSteps steps={[]} />;
+const E = () => <CardSelectGroup options={[]} />;
+const F = () => <DashboardSearch id='search' label='Search' siteList={[]} />;
+const G = () => <SideNavCompact items={[]} />;
+
+// Aliased — only the import specifier changes, JSX stays as <LegacyBadge>
+const H = () => <LegacyBadge color='blue' label='aliased' />;
+
+// Non-PDS import — untouched
+const I = () => <ThirdPartyBadge />;