@carbon/upgrade 11.43.0 → 11.44.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/upgrade",
   "description": "A tool for upgrading Carbon versions",
-  "version": "11.43.0",
+  "version": "11.44.0",
   "license": "Apache-2.0",
   "bin": {
     "carbon-upgrade": "./bin/carbon-upgrade.js"
@@ -40,10 +40,10 @@
   },
   "devDependencies": {
     "chalk": "^6.0.0",
-    "execa": "^9.6.0",
+    "execa": "^10.0.0",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.0.0",
-    "inquirer": "^12.5.0",
+    "inquirer": "^14.0.0",
     "is-git-clean": "^1.1.0",
     "jest-diff": "^30.0.0",
     "lodash.clonedeep": "^4.5.0",
@@ -60,5 +60,5 @@
     "@ibm/telemetry-js": "^1.5.0",
     "jscodeshift": "^17.0.0"
   },
-  "gitHead": "188d23202ec1092322dee92cf0df9d9958224ae4"
+  "gitHead": "7518c84ffd00f22434fe19d83119692c12fccb2f"
 }

package/transforms/__testfixtures__/preview-pagination-no-sizer.input.tsx

@@ -0,0 +1,21 @@
+// @ts-nocheck — preview_Pagination and preview_PageSelector are untyped JS
+// components with no TypeScript declarations, so TS would error on every prop.
+import React from 'react';
+import {
+  preview_PageSelector as PageSelector,
+  preview_Pagination as Pagination,
+} from '@carbon/react';
+
+// No `pageSizes` — the stable Pagination must render without crashing on
+// `sizes[0]` (regression guarded by making `pageSizes` optional).
+export const WithoutPageSizes = () => (
+  <Pagination onChange={() => {}} pageSize={10} totalItems={100}>
+    {({ currentPage, onSetPage, totalPages }) => (
+      <PageSelector
+        currentPage={currentPage}
+        onChange={(e) => onSetPage(e.target.value)}
+        totalPages={totalPages}
+      />
+    )}
+  </Pagination>
+);

package/transforms/__testfixtures__/preview-pagination-no-sizer.output.tsx

@@ -0,0 +1,11 @@
+// @ts-nocheck — preview_Pagination and preview_PageSelector are untyped JS
+// components with no TypeScript declarations, so TS would error on every prop.
+import React from 'react';
+import { Pagination } from '@carbon/react';
+
+// No `pageSizes` — the stable Pagination must render without crashing on
+// `sizes[0]` (regression guarded by making `pageSizes` optional).
+export const WithoutPageSizes = () => (
+  // TODO: manually migrate children to the renderPageSelect prop if necessary.
+  <Pagination onChange={() => {}} pageSize={10} totalItems={100} />
+);

package/transforms/__testfixtures__/preview-pagination-to-pagination.input.tsx

@@ -0,0 +1,23 @@
+// @ts-nocheck — preview_Pagination and preview_PageSelector are untyped JS
+// components with no TypeScript declarations, so TS would error on every prop.
+import React from 'react';
+import {
+  preview_PageSelector as PageSelector,
+  preview_Pagination as Pagination,
+} from '@carbon/react';
+
+export const Demo = () => (
+  <Pagination
+    onChange={() => {}}
+    pageSize={10}
+    pageSizes={[10, 20]}
+    totalItems={100}>
+    {({ currentPage, onSetPage, totalPages }) => (
+      <PageSelector
+        currentPage={currentPage}
+        onChange={(e) => onSetPage(e.target.value)}
+        totalPages={totalPages}
+      />
+    )}
+  </Pagination>
+);

package/transforms/__testfixtures__/preview-pagination-to-pagination.output.tsx

@@ -0,0 +1,9 @@
+// @ts-nocheck — preview_Pagination and preview_PageSelector are untyped JS
+// components with no TypeScript declarations, so TS would error on every prop.
+import React from 'react';
+import { Pagination } from '@carbon/react';
+
+export const Demo = () => (
+  // TODO: manually migrate children to the renderPageSelect prop if necessary.
+  <Pagination onChange={() => {}} pageSize={10} pageSizes={[10, 20]} totalItems={100} />
+);

package/transforms/__testfixtures__/unstable-pagination-to-pagination.input.tsx

@@ -0,0 +1,25 @@
+// @ts-nocheck — unstable_Pagination and unstable_PageSelector are untyped JS
+// components with no TypeScript declarations, so TS would error on every prop.
+import React from 'react';
+import {
+  unstable_PageSelector as PageSelector,
+  unstable_Pagination as Pagination,
+} from '@carbon/react';
+
+// Basic usage: unstable Pagination with a PageSelector
+export const WithPageSelector = () => (
+  <Pagination
+    onChange={() => {}}
+    pageSize={10}
+    pageSizes={[10, 20, 30]}
+    totalItems={350}>
+    {({ currentPage, onSetPage, totalPages }) => (
+      <PageSelector
+        currentPage={currentPage}
+        id="select-1"
+        onChange={(event) => onSetPage(event.target.value)}
+        totalPages={totalPages}
+      />
+    )}
+  </Pagination>
+);

package/transforms/__testfixtures__/unstable-pagination-to-pagination.output.tsx

@@ -0,0 +1,15 @@
+// @ts-nocheck — unstable_Pagination and unstable_PageSelector are untyped JS
+// components with no TypeScript declarations, so TS would error on every prop.
+import React from 'react';
+import { Pagination } from '@carbon/react';
+
+// Basic usage: unstable Pagination with a PageSelector
+export const WithPageSelector = () => (
+  // TODO: manually migrate children to the renderPageSelect prop if necessary.
+  <Pagination
+    onChange={() => {}}
+    pageSize={10}
+    pageSizes={[10, 20, 30]}
+    totalItems={350} />
+);
+

package/transforms/__tests__/unstable-pagination-to-pagination-test.js

@@ -0,0 +1,29 @@
+/**
+ * Copyright IBM Corp. 2026
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+const { defineTest } = require('jscodeshift/dist/testUtils');
+
+// unstable_ prefix — PageSelector render-prop child + bare usage
+defineTest(__dirname, 'unstable-pagination-to-pagination');
+
+// preview_ prefix — same transform, different fixtures
+defineTest(
+  __dirname,
+  'unstable-pagination-to-pagination',
+  null,
+  'preview-pagination-to-pagination'
+);
+
+// No `pageSizes` — migrated code must not crash on `sizes[0]`
+defineTest(
+  __dirname,
+  'unstable-pagination-to-pagination',
+  null,
+  'preview-pagination-no-sizer'
+);

package/transforms/unstable-pagination-to-pagination.js

@@ -0,0 +1,157 @@
+/**
+ * Copyright IBM Corp. 2026
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Migrate unstable_Pagination / preview_Pagination to the stable Pagination
+ * component. Removes the PageSelector import and children render-prop, since
+ * the stable Pagination renders an equivalent page-select control by default.
+ */
+
+'use strict';
+
+const defaultOptions = {
+  quote: 'single',
+  trailingComma: true,
+};
+
+// All known import names for the deprecated components
+const UNSTABLE_PAGINATION_NAMES = new Set([
+  'unstable_Pagination',
+  'preview_Pagination',
+]);
+
+const UNSTABLE_PAGE_SELECTOR_NAMES = new Set([
+  'unstable_PageSelector',
+  'preview_PageSelector',
+]);
+
+function transform(fileInfo, api, options) {
+  const j = api.jscodeshift;
+  const root = j(fileInfo.source);
+  const printOptions = options.printOptions || defaultOptions;
+
+  // Collect the local names for the deprecated components from @carbon/react imports
+  let paginationLocalName = null; // local JSX name, e.g. "Pagination"
+  let paginationLocalAlias = null; // stable replacement name, e.g. "Pagination"
+
+  const carbonImports = root.find(j.ImportDeclaration, {
+    source: { value: '@carbon/react' },
+  });
+
+  if (!carbonImports.length) {
+    return null;
+  }
+
+  carbonImports.forEach((path) => {
+    path.node.specifiers.forEach((spec) => {
+      if (spec.type !== 'ImportSpecifier') return;
+      const importedName = spec.imported.name;
+      if (UNSTABLE_PAGINATION_NAMES.has(importedName) && !paginationLocalName) {
+        paginationLocalName = spec.local.name;
+        paginationLocalAlias =
+          paginationLocalName === importedName
+            ? 'Pagination'
+            : paginationLocalName;
+      }
+    });
+  });
+
+  if (!paginationLocalName) {
+    return null; // nothing to transform
+  }
+
+  // Rewrite import specifiers — swap unstable/preview for stable Pagination,
+  // drop PageSelector (no longer needed)
+  carbonImports.forEach((path) => {
+    const kept = [];
+    path.node.specifiers.forEach((spec) => {
+      if (spec.type !== 'ImportSpecifier') {
+        kept.push(spec);
+        return;
+      }
+      const importedName = spec.imported.name;
+
+      if (UNSTABLE_PAGINATION_NAMES.has(importedName)) {
+        // Replace with stable `Pagination`.
+        // Only emit `as localName` when the user chose a different local alias.
+        const localName = paginationLocalAlias;
+        const newSpec =
+          localName === 'Pagination'
+            ? j.importSpecifier(j.identifier('Pagination'))
+            : j.importSpecifier(
+                j.identifier('Pagination'),
+                j.identifier(localName)
+              );
+        kept.push(newSpec);
+        return;
+      }
+
+      if (UNSTABLE_PAGE_SELECTOR_NAMES.has(importedName)) {
+        // Drop — no longer needed once the children block is removed
+        return;
+      }
+
+      kept.push(spec);
+    });
+    path.node.specifiers = kept;
+  });
+
+  // Sort alphabetically for consistency
+  carbonImports
+    .get(0)
+    .node.specifiers.sort((a, b) =>
+      (a.imported?.name ?? '').localeCompare(b.imported?.name ?? '')
+    );
+
+  // Rename JSX elements to use the stable Pagination name
+  root
+    .find(j.JSXOpeningElement, { name: { name: paginationLocalName } })
+    .forEach((path) => {
+      path.node.name = j.jsxIdentifier(paginationLocalAlias);
+    });
+  root
+    .find(j.JSXClosingElement, { name: { name: paginationLocalName } })
+    .forEach((path) => {
+      path.node.name = j.jsxIdentifier(paginationLocalAlias);
+    });
+
+  // Drop any children and make the element self-closing, adding a TODO comment
+  // so the user knows to migrate manually using the renderPageSelect prop
+  root
+    .find(j.JSXElement, {
+      openingElement: { name: { name: paginationLocalAlias } },
+    })
+    .forEach((path) => {
+      const element = path.node;
+
+      // Filter out whitespace-only JSX text children
+      const meaningfulChildren = element.children.filter(
+        (child) => !(child.type === 'JSXText' && child.value.trim() === '')
+      );
+
+      if (meaningfulChildren.length === 0) return;
+
+      // Drop children, make self-closing, and attach a TODO comment so the
+      // user knows to migrate manually using the renderPageSelect prop
+      element.children = [];
+      element.openingElement.selfClosing = true;
+      element.closingElement = null;
+
+      const todoComment = j.line(
+        ' TODO: manually migrate children to the renderPageSelect prop if necessary.'
+      );
+      path.node.comments = path.node.comments || [];
+      todoComment.leading = true;
+      todoComment.trailing = false;
+      path.node.comments.push(todoComment);
+    });
+
+  return root.toSource(printOptions);
+}
+
+module.exports = transform;
+module.exports.parser = 'tsx';