From 5b0ef139b3427d9208aa1ff161f2c76bd7f057d9 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 27 Feb 2026 17:59:30 -0600
Subject: [PATCH 01/15] fixed TabList render function children kept Item
 instead of converting to Tab

---
 .../__tests__/__snapshots__/tabs.test.ts.snap | 38 ++++++++++++++++--
 .../src/s1-to-s2/__tests__/tabs.test.ts       | 40 +++++++++++++++++++
 .../src/codemods/components/Tabs/transform.ts | 15 +++----
 3 files changed, 82 insertions(+), 11 deletions(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/tabs.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/tabs.test.ts.snap
index d69fa9a6648..0725e2952c3 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/tabs.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/tabs.test.ts.snap
@@ -1,8 +1,27 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`Converts dynamic TabList Item to Tab 1`] = `
+"import { Tab, Collection, TabPanel, Tabs, TabList } from "@react-spectrum/s2";
+
+let tabs = [{name: 'Tab 1', children: 'Tab Body 1'}];
+
+<Tabs aria-label="Dynamic tabs"><TabList items={tabs}>
+    {(item) => (
+      <Tab id={item.name}>
+        {item.name}
+      </Tab>
+    )}
+  </TabList><Collection items={tabs}>
+    {(item) => (
+      <TabPanel id={item.name}>
+        {item.children}
+      </TabPanel>
+    )}
+  </Collection></Tabs>"
+`;
+
 exports[`Move items from Tabs to TabList 1`] = `
-"import { Collection, TabPanel, Tabs, TabList } from "@react-spectrum/s2";
-import { Item } from '@adobe/react-spectrum';
+"import { Tab, Collection, TabPanel, Tabs, TabList } from "@react-spectrum/s2";
 
 let items = [
   {name: 'Tab 1', children: 'Tab Body 1'},
@@ -15,9 +34,9 @@ let items = [
 
 <Tabs aria-label="Dynamic tabs"><TabList items={tabs}>
     {(item) => (
-      <Item key={item.name}>
+      <Tab id={item.name}>
         {item.name}
-      </Item>
+      </Tab>
     )}
   </TabList><Collection items={tabs}>
     {(item) => (
@@ -96,6 +115,17 @@ let props = {isQuiet: true};
 </div>"
 `;
 
+exports[`Removes TabPanels from v3 import when s2 import exists first 1`] = `
+"import { Tabs as S2Tabs, Tab, TabPanel, Tabs as RSPTabs, TabList } from '@react-spectrum/s2';
+
+<>
+  <S2Tabs />
+  <RSPTabs aria-label="Test tabs"><TabList>
+      <Tab id="a">A</Tab>
+    </TabList><TabPanel id="a">A panel</TabPanel></RSPTabs>
+</>"
+`;
+
 exports[`Update to use new API 1`] = `
 "import { Tab, TabPanel, Tabs, TabList } from "@react-spectrum/s2";
 
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/tabs.test.ts b/packages/dev/codemods/src/s1-to-s2/__tests__/tabs.test.ts
index 409a0503106..c6b8af6b70f 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/tabs.test.ts
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/tabs.test.ts
@@ -254,3 +254,43 @@ let items = [
   </TabPanels>
 </Tabs>
 `);
+
+test('Converts dynamic TabList Item to Tab', `
+import {Tabs, TabList, TabPanels, Item} from '@adobe/react-spectrum';
+
+let tabs = [{name: 'Tab 1', children: 'Tab Body 1'}];
+
+<Tabs aria-label="Dynamic tabs" items={tabs}>
+  <TabList>
+    {(item) => (
+      <Item key={item.name}>
+        {item.name}
+      </Item>
+    )}
+  </TabList>
+  <TabPanels>
+    {(item) => (
+      <Item key={item.name}>
+        {item.children}
+      </Item>
+    )}
+  </TabPanels>
+</Tabs>
+`);
+
+test('Removes TabPanels from v3 import when s2 import exists first', `
+import {Tabs as S2Tabs} from '@react-spectrum/s2';
+import {Tabs as RSPTabs, TabList, TabPanels, Item} from '@adobe/react-spectrum';
+
+<>
+  <S2Tabs />
+  <RSPTabs aria-label="Test tabs">
+    <TabList>
+      <Item key="a">A</Item>
+    </TabList>
+    <TabPanels>
+      <Item key="a">A panel</Item>
+    </TabPanels>
+  </RSPTabs>
+</>
+`);
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts
index d29e52987d5..b0ef32be6f5 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts
@@ -4,13 +4,14 @@ import {removeProp, updateComponentWithinCollection, updateToNewComponentName} f
 import * as t from '@babel/types';
 
 function transformTabList(tabListPath: NodePath<t.JSXElement>): t.JSXElement {
-  tabListPath.get('children').forEach(itemPath => {
-    if (
-      t.isJSXElement(itemPath.node) &&
-      t.isJSXIdentifier(itemPath.node.openingElement.name) &&
-      getName(itemPath as NodePath<t.JSXElement>, itemPath.node.openingElement.name) === 'Item'
-    ) {
-      updateComponentWithinCollection(itemPath as NodePath<t.JSXElement>, {parentComponentName: 'TabList', newComponentName: 'Tab'});
+  tabListPath.traverse({
+    JSXElement(itemPath) {
+      if (
+        t.isJSXIdentifier(itemPath.node.openingElement.name) &&
+        getName(itemPath as NodePath<t.JSXElement>, itemPath.node.openingElement.name) === 'Item'
+      ) {
+        updateComponentWithinCollection(itemPath as NodePath<t.JSXElement>, {parentComponentName: 'TabList', newComponentName: 'Tab'});
+      }
     }
   });
   return tabListPath.node;

From be66290b2e45eb360646b1eecd443d4c0b4f22a3 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 27 Feb 2026 18:03:15 -0600
Subject: [PATCH 02/15] import cleanup: removeComponentImport was only checking
 the first matching import and could miss v3 imports when an
 @react-spectrum/s2 import appears first

---
 .../src/s1-to-s2/src/codemods/shared/utils.ts | 30 +++++++++++--------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
index e3a4e6df920..9e1458c3353 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
@@ -119,20 +119,26 @@ export function addComponentImport(path: NodePath<t.Program>, newComponentName:
 }
 
 export function removeComponentImport(path: NodePath<t.Program>, component: string): void {
-  let existingImport = path.node.body.find((node) => t.isImportDeclaration(node) && node.source.value === '@adobe/react-spectrum' || t.isImportDeclaration(node) &&  node.source.value.startsWith('@react-spectrum/'));
-  if (existingImport && t.isImportDeclaration(existingImport)) {
-    let specifier = existingImport.specifiers.find((specifier) => {
-      return (
-        t.isImportSpecifier(specifier) &&
-        specifier.imported.type === 'Identifier' &&
-        specifier.imported.name === component
+  let imports = path.node.body.filter((node): node is t.ImportDeclaration => {
+    return t.isImportDeclaration(node)
+      && (
+        node.source.value === '@adobe/react-spectrum'
+        || (node.source.value.startsWith('@react-spectrum/') && node.source.value !== '@react-spectrum/s2')
+      );
+  });
+
+  for (let importDecl of imports) {
+    let previousLength = importDecl.specifiers.length;
+    importDecl.specifiers = importDecl.specifiers.filter((specifier) => {
+      return !(
+        t.isImportSpecifier(specifier)
+        && specifier.imported.type === 'Identifier'
+        && specifier.imported.name === component
       );
     });
-    if (specifier) {
-      existingImport.specifiers = existingImport.specifiers.filter((s) => s !== specifier);
-      if (existingImport.specifiers.length === 0) {
-        path.node.body = path.node.body.filter((node) => node !== existingImport);
-      }
+
+    if (importDecl.specifiers.length === 0 && previousLength > 0) {
+      path.node.body = path.node.body.filter((node) => node !== importDecl);
     }
   }
 }

From 914f03cfc35656cd9ba93557bd385a5b1fc96932 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 27 Feb 2026 18:04:27 -0600
Subject: [PATCH 03/15] dynamic import('@react-spectrum/s2') was incorrectly
 flagged as a v3 dynamic import

---
 packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
index ce3467f356a..729d877347e 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
@@ -147,7 +147,9 @@ export default function transformer(file: FileInfo, api: API, options: Options):
         return;
       }
 
-      if (arg.value !== '@adobe/react-spectrum' && !arg.value.startsWith('@react-spectrum/')) {
+      let isV3ImportSource = arg.value === '@adobe/react-spectrum'
+        || (arg.value.startsWith('@react-spectrum/') && arg.value !== '@react-spectrum/s2');
+      if (!isV3ImportSource) {
         return;
       }
 

From d596a6cafd60e7e8e3863f74aa473210da6b48ad Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 27 Feb 2026 18:04:54 -0600
Subject: [PATCH 04/15] Fixed in codemod options parsing

---
 packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
index 729d877347e..3d1c2c17c18 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
@@ -46,7 +46,9 @@ export default function transformer(file: FileInfo, api: API, options: Options):
     }
   });
   let root = j(file.source);
-  let componentsToTransform = options.components ? new Set(options.components.split(',').filter(s => availableComponents.has(s))) : availableComponents;
+  let componentsToTransform = options.components
+    ? new Set(options.components.split(',').map(s => s.trim()).filter(s => availableComponents.has(s)))
+    : availableComponents;
   let v3ComponentsToRename = new Set(Object.keys(renamedComponents));
   let S2ComponentsToImport = new Set<string>();
 

From 171529ab691fb76b072e8ed4c8339a606ae43495 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 27 Feb 2026 18:05:25 -0600
Subject: [PATCH 05/15] more import fixes

---
 .../__snapshots__/imports.test.ts.snap        |  4 +++
 .../src/s1-to-s2/__tests__/imports.test.ts    |  7 +++++
 .../src/s1-to-s2/src/codemods/codemod.ts      | 30 ++++++++++++++-----
 3 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap
index 4b07144fd42..6bb15e8013e 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap
@@ -1,10 +1,14 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`does not leave a comment on dynamic s2 imports 1`] = `"const LazyButton = React.lazy(() => import('@react-spectrum/s2'))"`;
+
 exports[`leaves a comment on dynamic imports 1`] = `
 "const LazyButton = React.lazy(() => // TODO(S2-upgrade): check this dynamic import
 import('@react-spectrum/button'))"
 `;
 
+exports[`should handle empty files safely 1`] = `""`;
+
 exports[`should keep import aliases 1`] = `
 "import { Button as RSPButton } from "@react-spectrum/s2";
 
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/imports.test.ts b/packages/dev/codemods/src/s1-to-s2/__tests__/imports.test.ts
index 8c6fe0ce5c5..b5f67d89959 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/imports.test.ts
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/imports.test.ts
@@ -18,6 +18,9 @@ import {Button} from '@react-spectrum/button';
 <Button>Test</Button>
 `);
 
+test('should handle empty files safely', `
+`);
+
 test('should leave unimplemented components untouched', `
 import {Button, Fake} from '@adobe/react-spectrum';
 
@@ -64,6 +67,10 @@ test('leaves a comment on dynamic imports', `
 const LazyButton = React.lazy(() => import('@react-spectrum/button'))
 `);
 
+test('does not leave a comment on dynamic s2 imports', `
+const LazyButton = React.lazy(() => import('@react-spectrum/s2'))
+`);
+
 test('should not import Item from S2', `
 import {Menu, ListView, Item} from '@adobe/react-spectrum';
 
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
index 3d1c2c17c18..821eeffd5f4 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
@@ -259,16 +259,30 @@ export default function transformer(file: FileInfo, api: API, options: Options):
 
     if (existingImport.length) {
       let importDecl = existingImport.get();
-      for (let specifier of importDecl.node.specifiers) {
-        if (specifier.type === 'ImportSpecifier'
-          && importedComponents.has(specifier.imported.name)) {
-          importSpecifiers.add(specifier);
-        }
-      }
+      let existingSpecifiers = importDecl.value.specifiers;
       // add importSpecifiers to existing import
       importDecl.value.specifiers = [...importDecl.value.specifiers, ...[...importSpecifiers].filter(specifier => {
-        // @ts-ignore
-        return specifier.imported.name !== 'Item' && ![...importDecl.value.specifiers].find(s => s.imported.name === specifier.imported.name);
+        if (t.isImportSpecifier(specifier) && t.isIdentifier(specifier.imported)) {
+          if (specifier.imported.name === 'Item') {
+            return false;
+          }
+
+          let localName = specifier.local?.name || specifier.imported.name;
+          return !existingSpecifiers.find((s) =>
+            t.isImportSpecifier(s)
+            && t.isIdentifier(s.imported)
+            && s.imported.name === specifier.imported.name
+            && (s.local?.name || s.imported.name) === localName
+          );
+        }
+
+        if (t.isImportNamespaceSpecifier(specifier)) {
+          return !existingSpecifiers.find((s) =>
+            t.isImportNamespaceSpecifier(s) && s.local.name === specifier.local.name
+          );
+        }
+
+        return false;
       })];
     } else {
       if (importSpecifiers.size > 0) {

From a2509b5f2316b9591c936b053b47b3bb221e5691 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 6 Mar 2026 13:28:21 -0600
Subject: [PATCH 06/15] add agent mode (non-interactive, run transforms only)

---
 packages/dev/codemods/src/index.ts            | 36 ++++++++++++-------
 .../src/s1-to-s2/src/codemods/codemod.ts      |  9 ++---
 .../src/s1-to-s2/src/getComponents.ts         | 17 +++++++--
 .../dev/codemods/src/s1-to-s2/src/index.ts    | 28 ++++++++++++---
 .../codemods/src/s1-to-s2/src/transform.ts    |  9 ++---
 5 files changed, 69 insertions(+), 30 deletions(-)

diff --git a/packages/dev/codemods/src/index.ts b/packages/dev/codemods/src/index.ts
index 3bb350ba739..e6859e47d7d 100644
--- a/packages/dev/codemods/src/index.ts
+++ b/packages/dev/codemods/src/index.ts
@@ -35,7 +35,14 @@ export interface S1ToS2CodemodOptions extends JSCodeshiftOptions {
    * An optional subset of components to have the s1-to-s2 codemod apply to.
    * Provide a comma-separated list of component names.
    */
-  components?: string
+  components?: string,
+  /**
+   * Whether to run the codemod in agent mode, which skips interactive prompts
+   * and package installation. This matches the shipped CLI behavior.
+   *
+   * @default false
+   */
+  agent?: boolean
 }
 
 export interface UseMonopackagesCodemodOptions extends JSCodeshiftOptions {
@@ -67,6 +74,9 @@ const options = {
   },
   'components': {
     type: 'string'
+  },
+  'agent': {
+    type: 'boolean'
   }
 };
 
@@ -80,22 +90,24 @@ if (positionals.length < 1) {
   process.exit(1);
 }
 
-const codemodName = positionals[0];
-const codemodFunction = codemods[codemodName];
+async function main() {
+  const codemodName = positionals[0];
+  const codemodFunction = codemods[codemodName];
 
-if (!codemodFunction) {
-  console.error(`Unknown codemod: ${codemodName}, available codemods: ${Object.keys(codemods).join(', ')}`);
-  process.exit(1);
-}
+  if (!codemodFunction) {
+    console.error(`Unknown codemod: ${codemodName}, available codemods: ${Object.keys(codemods).join(', ')}`);
+    process.exit(1);
+  }
 
-try {  
-  codemodFunction({
+  await Promise.resolve(codemodFunction({
     parser: 'tsx',
     ignorePattern: '**/node_modules/**',
     path: '.',
     ...values
-  });
-} catch (error) {
+  }));
+}
+
+main().catch((error) => {
   console.error(`Error running codemod: ${error}`);
   process.exit(1);
-}
+});
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
index 821eeffd5f4..2865a032074 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
@@ -267,17 +267,18 @@ export default function transformer(file: FileInfo, api: API, options: Options):
             return false;
           }
 
-          let localName = specifier.local?.name || specifier.imported.name;
-          return !existingSpecifiers.find((s) =>
+          let importedName = specifier.imported.name;
+          let localName = specifier.local?.name || importedName;
+          return !existingSpecifiers.find((s: t.ImportSpecifier | t.ImportDefaultSpecifier | t.ImportNamespaceSpecifier) =>
             t.isImportSpecifier(s)
             && t.isIdentifier(s.imported)
-            && s.imported.name === specifier.imported.name
+            && s.imported.name === importedName
             && (s.local?.name || s.imported.name) === localName
           );
         }
 
         if (t.isImportNamespaceSpecifier(specifier)) {
-          return !existingSpecifiers.find((s) =>
+          return !existingSpecifiers.find((s: t.ImportSpecifier | t.ImportDefaultSpecifier | t.ImportNamespaceSpecifier) =>
             t.isImportNamespaceSpecifier(s) && s.local.name === specifier.local.name
           );
         }
diff --git a/packages/dev/codemods/src/s1-to-s2/src/getComponents.ts b/packages/dev/codemods/src/s1-to-s2/src/getComponents.ts
index 7398553633a..e894c50b022 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/getComponents.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/getComponents.ts
@@ -1,6 +1,6 @@
+import {existsSync, readFileSync} from 'fs';
 import {parse} from '@babel/parser';
 const path = require('path');
-import {readFileSync} from 'fs';
 import traverse from '@babel/traverse';
 
 // These are exported but there are no codemods written for them yet.
@@ -15,8 +15,19 @@ const skipped = new Set([
 export function getComponents(): Set<string> {
   // Determine list of available components in S2 from index.ts
   let availableComponents = new Set<string>();
-  const packagePath = require.resolve('@react-spectrum/s2');
-  const indexPath = path.join(path.dirname(packagePath), process.env.NODE_ENV === 'test' ? 'src/index.ts' : '../src/index.ts');
+  let indexPath: string;
+
+  try {
+    const packagePath = require.resolve('@react-spectrum/s2');
+    indexPath = path.join(path.dirname(packagePath), process.env.NODE_ENV === 'test' ? 'src/index.ts' : '../src/index.ts');
+  } catch {
+    const workspaceIndexPath = path.resolve(__dirname, '../../../../../@react-spectrum/s2/src/index.ts');
+    if (!existsSync(workspaceIndexPath)) {
+      throw new Error('Could not resolve @react-spectrum/s2 source for codemods.');
+    }
+    indexPath = workspaceIndexPath;
+  }
+
   let index = parse(readFileSync(indexPath, 'utf8'), {sourceType: 'module', plugins: ['typescript']});
   traverse(index, {
     ExportNamedDeclaration(path) {
diff --git a/packages/dev/codemods/src/s1-to-s2/src/index.ts b/packages/dev/codemods/src/s1-to-s2/src/index.ts
index ee42521583c..1bff92cbb05 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/index.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/index.ts
@@ -7,7 +7,29 @@ import {transform} from './transform.js';
 import {waitForKeypress} from './utils/waitForKeypress.js';
 const boxen = require('boxen');
 
+function printNextSteps(nextSteps: string[]) {
+  console.log(boxen(
+    `Next steps:\n\n ${nextSteps.map((step, i) => `${i + 1}. ${step}`).join('\n\n\n')}`,
+    {borderStyle: 'round', padding: 1, borderColor: 'green'}
+  ));
+}
+
 export async function s1_to_s2(options: S1ToS2CodemodOptions): Promise<void> {
+  if (options.agent) {
+    logger.info('Running s1-to-s2 in agent mode (non-interactive, transform-only).');
+    logger.info('Upgrading components...');
+    await transform(options);
+    logger.success('Upgrade complete!');
+    printNextSteps([
+      `Ensure ${chalk.bold('@react-spectrum/s2')} is installed.`,
+      `If your bundler is not Parcel v2.12.0+, configure the Spectrum 2 style macro support. See: ${chalk.underline('https://react-spectrum.adobe.com/s2/index.html?path=/docs/intro--docs#configuring-your-bundler')}`,
+      `Add ${chalk.bold('import \'@react-spectrum/s2/page.css\';')} to your entry component if needed.`,
+      `Search for ${chalk.bold('TODO(S2-upgrade)')} and resolve remaining manual migration updates.`,
+      `Reference the migration guide: ${chalk.underline('https://react-spectrum.adobe.com/s2/index.html?path=/docs/migrating--docs')}`
+    ]);
+    return;
+  }
+
   console.log(boxen(
     'Welcome to the React Spectrum v3 to Spectrum 2 upgrade assistant!\n\n' +
     'This tool will:\n\n' +
@@ -66,11 +88,7 @@ export async function s1_to_s2(options: S1ToS2CodemodOptions): Promise<void> {
     `For additional help, reference the Spectrum 2 Migration Guide: ${chalk.underline('https://react-spectrum.adobe.com/s2/index.html?path=/docs/migrating--docs')}`
   );
 
-  console.log(boxen(
-    `Next steps:\n\n ${nextSteps.map((step, i) => `${i + 1}. ${step}`).join('\n\n\n')}`,
-    {borderStyle: 'round', padding: 1, borderColor: 'green'}
-  ));
+  printNextSteps(nextSteps);
 
   process.exit(0);
 }
-
diff --git a/packages/dev/codemods/src/s1-to-s2/src/transform.ts b/packages/dev/codemods/src/s1-to-s2/src/transform.ts
index a410568d8ce..6c31e3e2b03 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/transform.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/transform.ts
@@ -5,10 +5,7 @@ import {S1ToS2CodemodOptions} from '../..';
 const transformPath = path.join(__dirname, 'codemods', 'codemod.js');
 
 export async function transform(options: S1ToS2CodemodOptions): Promise<ReturnType<typeof jscodeshift>> {
-  let {
-    path: filePath = '.',
-    ...rest
-  } = options;
-
-  return await jscodeshift(transformPath, [filePath], rest);
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  const {path: filePath = '.', components, agent, ...jscodeshiftOptions} = options;
+  return await jscodeshift(transformPath, [filePath], jscodeshiftOptions);
 }

From 48f17680eb484788dc2531b379251d0de981c9f2 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 6 Mar 2026 13:32:10 -0600
Subject: [PATCH 07/15] add e2e tests

---
 eslint.config.mjs                             |   5 +-
 packages/dev/codemods/package.json            |   1 +
 .../full-project/input/package.fixture.json   |   7 +
 .../cli/full-project/input/src/App.tsx        |  10 +
 .../cli/full-project/input/src/Form.tsx       |   6 +
 .../cli/full-project/input/yarn.lock          |   1 +
 .../full-project/output/package.fixture.json  |   7 +
 .../cli/full-project/output/src/App.tsx       |   6 +
 .../cli/full-project/output/src/Form.tsx      |   6 +
 .../cli/full-project/output/yarn.lock         |   1 +
 .../subset-project/input/package.fixture.json |   7 +
 .../cli/subset-project/input/src/Form.tsx     |  11 +
 .../cli/subset-project/input/yarn.lock        |   1 +
 .../output/package.fixture.json               |   7 +
 .../cli/subset-project/output/src/Form.tsx    |  10 +
 .../cli/subset-project/output/yarn.lock       |   1 +
 .../src/s1-to-s2/__tests__/cli.e2e.test.ts    | 248 ++++++++++++++++++
 packages/dev/codemods/tsconfig.json           |   2 +-
 18 files changed, 334 insertions(+), 3 deletions(-)
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/package.fixture.json
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/App.tsx
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/Form.tsx
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/yarn.lock
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/package.fixture.json
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/App.tsx
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/Form.tsx
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/yarn.lock
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/package.fixture.json
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/src/Form.tsx
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/yarn.lock
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/package.fixture.json
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/src/Form.tsx
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/yarn.lock
 create mode 100644 packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts

diff --git a/eslint.config.mjs b/eslint.config.mjs
index d7c27a8dbee..5bc31d6cf6c 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -60,7 +60,8 @@ export default [{
         "packages/dev/storybook-builder-parcel/*",
         "packages/dev/storybook-react-parcel/*",
         "packages/dev/s2-docs/pages/**",
-        "packages/dev/mcp/*/dist"
+        "packages/dev/mcp/*/dist",
+        "packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/**"
     ],
 }, ...compat.extends("eslint:recommended"), {
     plugins: {
@@ -533,4 +534,4 @@ export default [{
             ...globals.browser
         }
     }
-}];
\ No newline at end of file
+}];
diff --git a/packages/dev/codemods/package.json b/packages/dev/codemods/package.json
index 434acaf918c..6085213ed3a 100644
--- a/packages/dev/codemods/package.json
+++ b/packages/dev/codemods/package.json
@@ -21,6 +21,7 @@
     "url": "https://github.com/adobe/react-spectrum"
   },
   "dependencies": {
+    "@adobe/react-spectrum": "^3.46.1",
     "@babel/parser": "^7.24.5",
     "@babel/traverse": "^7.24.5",
     "@babel/types": "^7.24.5",
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/package.fixture.json b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/package.fixture.json
new file mode 100644
index 00000000000..edb334cd571
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/package.fixture.json
@@ -0,0 +1,7 @@
+{
+  "name": "s1-to-s2-cli-fixture",
+  "private": true,
+  "devDependencies": {
+    "parcel": "^2.12.0"
+  }
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/App.tsx b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/App.tsx
new file mode 100644
index 00000000000..52665e97a53
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/App.tsx
@@ -0,0 +1,10 @@
+import {Button} from '@adobe/react-spectrum';
+import React from 'react';
+
+export function App() {
+  return (
+    <Button variant="cta">
+      Save
+    </Button>
+  );
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/Form.tsx b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/Form.tsx
new file mode 100644
index 00000000000..057d14955fb
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/src/Form.tsx
@@ -0,0 +1,6 @@
+import React from 'react';
+import {TextArea} from '@adobe/react-spectrum';
+
+export function Form() {
+  return <TextArea isQuiet />;
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/yarn.lock b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/yarn.lock
new file mode 100644
index 00000000000..ef452491215
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/input/yarn.lock
@@ -0,0 +1 @@
+# yarn lockfile v1
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/package.fixture.json b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/package.fixture.json
new file mode 100644
index 00000000000..edb334cd571
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/package.fixture.json
@@ -0,0 +1,7 @@
+{
+  "name": "s1-to-s2-cli-fixture",
+  "private": true,
+  "devDependencies": {
+    "parcel": "^2.12.0"
+  }
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/App.tsx b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/App.tsx
new file mode 100644
index 00000000000..d24d5cee786
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/App.tsx
@@ -0,0 +1,6 @@
+import { Button } from "@react-spectrum/s2";
+import React from 'react';
+
+export function App() {
+  return (<Button variant="accent">Save</Button>);
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/Form.tsx b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/Form.tsx
new file mode 100644
index 00000000000..9e17e86f426
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/src/Form.tsx
@@ -0,0 +1,6 @@
+import React from 'react';
+import { TextArea } from "@react-spectrum/s2";
+
+export function Form() {
+  return <TextArea />;
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/yarn.lock b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/yarn.lock
new file mode 100644
index 00000000000..ef452491215
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/full-project/output/yarn.lock
@@ -0,0 +1 @@
+# yarn lockfile v1
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/package.fixture.json b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/package.fixture.json
new file mode 100644
index 00000000000..5a72be6a3e4
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/package.fixture.json
@@ -0,0 +1,7 @@
+{
+  "name": "s1-to-s2-cli-subset-fixture",
+  "private": true,
+  "devDependencies": {
+    "parcel": "^2.12.0"
+  }
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/src/Form.tsx b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/src/Form.tsx
new file mode 100644
index 00000000000..8decf53f365
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/src/Form.tsx
@@ -0,0 +1,11 @@
+import {Button, TextArea} from '@adobe/react-spectrum';
+import React from 'react';
+
+export function Form() {
+  return (
+    <>
+      <Button variant="cta">Save</Button>
+      <TextArea isQuiet />
+    </>
+  );
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/yarn.lock b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/yarn.lock
new file mode 100644
index 00000000000..ef452491215
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/input/yarn.lock
@@ -0,0 +1 @@
+# yarn lockfile v1
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/package.fixture.json b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/package.fixture.json
new file mode 100644
index 00000000000..5a72be6a3e4
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/package.fixture.json
@@ -0,0 +1,7 @@
+{
+  "name": "s1-to-s2-cli-subset-fixture",
+  "private": true,
+  "devDependencies": {
+    "parcel": "^2.12.0"
+  }
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/src/Form.tsx b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/src/Form.tsx
new file mode 100644
index 00000000000..91655eaead1
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/src/Form.tsx
@@ -0,0 +1,10 @@
+import { TextArea } from '@adobe/react-spectrum';
+import { Button } from "@react-spectrum/s2";
+import React from 'react';
+
+export function Form() {
+  return (<>
+    <Button variant="accent">Save</Button>
+    <TextArea isQuiet />
+  </>);
+}
diff --git a/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/yarn.lock b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/yarn.lock
new file mode 100644
index 00000000000..ef452491215
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__testfixtures__/cli/subset-project/output/yarn.lock
@@ -0,0 +1 @@
+# yarn lockfile v1
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts b/packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts
new file mode 100644
index 00000000000..6d95e58c23e
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts
@@ -0,0 +1,248 @@
+import {chmodSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync} from 'fs';
+import os from 'os';
+import path from 'path';
+import {spawn, spawnSync} from 'child_process';
+
+const REPO_ROOT = path.resolve(__dirname, '../../../../../..');
+const CODEMODS_ROOT = path.join(REPO_ROOT, 'packages/dev/codemods');
+const CODEMODS_DIST_DIR = path.join(CODEMODS_ROOT, 'dist');
+const CODEMODS_TSCONFIG = path.join(CODEMODS_ROOT, 'tsconfig.json');
+const CLI_PATH = path.join(CODEMODS_DIST_DIR, 'index.js');
+const FIXTURES_ROOT = path.join(CODEMODS_ROOT, 'src/s1-to-s2/__testfixtures__/cli');
+const PROMPT_TO_START = 'Press Enter to get started...';
+const PROMPT_TO_UPGRADE = 'Press Enter to upgrade components...';
+
+let tempDirs: string[] = [];
+
+jest.setTimeout(60000);
+
+function normalizeText(content: string) {
+  return content.replace(/\r\n/g, '\n');
+}
+
+function normalizeFixtureRelativePath(relativePath: string) {
+  return relativePath.replace(/package\.fixture\.json$/, 'package.json');
+}
+
+function listFiles(root: string, currentDir = root): string[] {
+  return readdirSync(currentDir).sort().flatMap((entry) => {
+    let fullPath = path.join(currentDir, entry);
+    let stats = statSync(fullPath);
+    if (stats.isDirectory()) {
+      return listFiles(root, fullPath);
+    }
+
+    let relativePath = path.relative(root, fullPath).split(path.sep).join('/');
+    return [normalizeFixtureRelativePath(relativePath)];
+  });
+}
+
+function expectProjectToMatchFixture(projectDir: string, fixtureName: string) {
+  let expectedDir = path.join(FIXTURES_ROOT, fixtureName, 'output');
+  let actualFiles = listFiles(projectDir);
+  let expectedFiles = listFiles(expectedDir);
+
+  expect(actualFiles).toEqual(expectedFiles);
+
+  for (let relativePath of expectedFiles) {
+    let actualContent = normalizeText(readFileSync(path.join(projectDir, relativePath), 'utf8'));
+    let fixtureRelativePath = relativePath.replace(/package\.json$/, 'package.fixture.json');
+    let expectedContent = normalizeText(readFileSync(path.join(expectedDir, fixtureRelativePath), 'utf8'));
+    expect(actualContent).toBe(expectedContent);
+  }
+}
+
+function copyFixtureProject(sourceDir: string, destinationDir: string) {
+  mkdirSync(destinationDir, {recursive: true});
+
+  for (let entry of readdirSync(sourceDir).sort()) {
+    let sourcePath = path.join(sourceDir, entry);
+    let destinationEntry = entry === 'package.fixture.json' ? 'package.json' : entry;
+    let destinationPath = path.join(destinationDir, destinationEntry);
+    let stats = statSync(sourcePath);
+
+    if (stats.isDirectory()) {
+      copyFixtureProject(sourcePath, destinationPath);
+    } else {
+      mkdirSync(path.dirname(destinationPath), {recursive: true});
+      writeFileSync(destinationPath, readFileSync(sourcePath));
+    }
+  }
+}
+
+function createFakeYarn(tempRoot: string) {
+  let fakeBinDir = path.join(tempRoot, 'fake-bin');
+  let packageManagerLog = path.join(tempRoot, 'package-manager.log');
+
+  mkdirSync(fakeBinDir, {recursive: true});
+  writeFileSync(
+    path.join(fakeBinDir, 'yarn'),
+    '#!/bin/sh\nprintf "%s\\n" "$*" >> "$FAKE_PM_LOG"\nexit 0\n'
+  );
+  chmodSync(path.join(fakeBinDir, 'yarn'), 0o755);
+
+  return {fakeBinDir, packageManagerLog};
+}
+
+async function runFixtureCLI(options: {
+  fixtureName: string,
+  args?: string[],
+  interactive?: boolean
+}) {
+  let {
+    fixtureName,
+    args = [],
+    interactive = false
+  } = options;
+
+  let tempRoot = mkdtempSync(path.join(os.tmpdir(), 's1-to-s2-cli-'));
+  tempDirs.push(tempRoot);
+
+  let projectDir = path.join(tempRoot, 'project');
+  copyFixtureProject(path.join(FIXTURES_ROOT, fixtureName, 'input'), projectDir);
+
+  let {fakeBinDir, packageManagerLog} = createFakeYarn(tempRoot);
+  let env = {
+    ...process.env,
+    FORCE_COLOR: '0',
+    NODE_ENV: 'test',
+    FAKE_PM_LOG: packageManagerLog,
+    PATH: `${fakeBinDir}${path.delimiter}${process.env.PATH ?? ''}`
+  };
+
+  let child = spawn(process.execPath, [CLI_PATH, 's1-to-s2', '--path', 'src', ...args], {
+    cwd: projectDir,
+    env,
+    stdio: ['pipe', 'pipe', 'pipe']
+  });
+
+  let stdout = '';
+  let stderr = '';
+  let startPromptHandled = false;
+  let upgradePromptHandled = false;
+
+  let maybeRespondToPrompt = () => {
+    if (!interactive) {
+      return;
+    }
+
+    if (!startPromptHandled && stdout.includes(PROMPT_TO_START)) {
+      startPromptHandled = true;
+      child.stdin.write('\n');
+    }
+
+    if (!upgradePromptHandled && stdout.includes(PROMPT_TO_UPGRADE)) {
+      upgradePromptHandled = true;
+      child.stdin.write('\n');
+      child.stdin.end();
+    }
+  };
+
+  child.stdout.on('data', (chunk) => {
+    stdout += chunk.toString();
+    maybeRespondToPrompt();
+  });
+
+  child.stderr.on('data', (chunk) => {
+    stderr += chunk.toString();
+  });
+
+  if (!interactive) {
+    child.stdin.end();
+  }
+
+  let exitCode = await new Promise<number>((resolve, reject) => {
+    let timeout = setTimeout(() => {
+      child.kill('SIGKILL');
+      reject(new Error(`CLI test timed out for fixture ${fixtureName}.`));
+    }, 15000);
+
+    child.on('error', (error) => {
+      clearTimeout(timeout);
+      reject(error);
+    });
+
+    child.on('close', (code) => {
+      clearTimeout(timeout);
+      resolve(code ?? -1);
+    });
+  });
+
+  let packageManagerCalls = existsSync(packageManagerLog)
+    ? normalizeText(readFileSync(packageManagerLog, 'utf8')).trim().split('\n').filter(Boolean)
+    : [];
+
+  return {
+    exitCode,
+    stdout: normalizeText(stdout),
+    stderr: normalizeText(stderr),
+    projectDir,
+    packageManagerCalls
+  };
+}
+
+beforeAll(() => {
+  rmSync(CODEMODS_DIST_DIR, {recursive: true, force: true});
+
+  let buildResult = spawnSync(process.execPath, [require.resolve('typescript/bin/tsc'), '-p', CODEMODS_TSCONFIG], {
+    cwd: REPO_ROOT,
+    env: {
+      ...process.env,
+      FORCE_COLOR: '0'
+    },
+    encoding: 'utf8'
+  });
+
+  if (buildResult.status !== 0) {
+    throw new Error(
+      'Failed to build @react-spectrum/codemods for CLI e2e tests.\n' +
+      `${buildResult.stdout}\n${buildResult.stderr}`
+    );
+  }
+});
+
+afterEach(() => {
+  for (let tempDir of tempDirs) {
+    rmSync(tempDir, {recursive: true, force: true});
+  }
+
+  tempDirs = [];
+});
+
+test('runs the shipped assistant in agent mode', async () => {
+  let result = await runFixtureCLI({
+    fixtureName: 'full-project',
+    args: ['--agent']
+  });
+
+  expect(result.exitCode).toBe(0);
+  expect(result.stderr).toBe('');
+  expect(result.stdout).toContain('Running s1-to-s2 in agent mode (non-interactive, transform-only).');
+  expect(result.stdout).toContain('Upgrade complete!');
+  expect(result.stdout).toContain('Next steps:');
+  expect(result.stdout).not.toContain(PROMPT_TO_START);
+  expect(result.stdout).not.toContain(PROMPT_TO_UPGRADE);
+  expect(result.packageManagerCalls).toEqual([]);
+  expectProjectToMatchFixture(result.projectDir, 'full-project');
+});
+
+test('runs the interactive assistant flow against a real project fixture', async () => {
+  let result = await runFixtureCLI({
+    fixtureName: 'full-project',
+    interactive: true
+  });
+
+  expect(result.exitCode).toBe(0);
+  expect(result.stderr).toBe('');
+  expect(result.stdout).toContain('Welcome to the React Spectrum v3 to Spectrum 2 upgrade assistant!');
+  expect(result.stdout).toContain(PROMPT_TO_START);
+  expect(result.stdout).toContain('Installing @react-spectrum/s2 using yarn...');
+  expect(result.stdout).toContain('Successfully installed @react-spectrum/s2!');
+  expect(result.stdout).toContain('Parcel detected in package.json. Macros are supported by default in v2.12.0 and newer.');
+  expect(result.stdout).toContain(PROMPT_TO_UPGRADE);
+  expect(result.stdout).toContain('Upgrade complete!');
+  expect(result.stdout).toContain('Next steps:');
+  expect(result.stdout).not.toContain('Running s1-to-s2 in agent mode');
+  expect(result.packageManagerCalls).toEqual(['add @react-spectrum/s2@latest']);
+  expectProjectToMatchFixture(result.projectDir, 'full-project');
+});
diff --git a/packages/dev/codemods/tsconfig.json b/packages/dev/codemods/tsconfig.json
index 400010f4b37..cc7fd39c9d6 100644
--- a/packages/dev/codemods/tsconfig.json
+++ b/packages/dev/codemods/tsconfig.json
@@ -8,5 +8,5 @@
     "moduleResolution": "node",
   },
   "include": ["src/**/*"],
-  "exclude": ["node_modules", "**/*.test.ts", "**/__mocks__"]
+  "exclude": ["node_modules", "**/*.test.ts", "**/__mocks__", "**/__testfixtures__"]
 }

From ff6271fe30e4a9a066736929b9320e2774be2d68 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 6 Mar 2026 14:06:56 -0600
Subject: [PATCH 08/15] have --components include related components

---
 .../__snapshots__/dialog.test.ts.snap         |  10 +-
 .../__snapshots__/subset.test.ts.snap         | 129 +++++++++++++++
 .../src/s1-to-s2/__tests__/cli.e2e.test.ts    |  16 ++
 .../src/s1-to-s2/__tests__/subset.test.ts     | 120 ++++++++++++++
 .../src/s1-to-s2/src/codemods/codemod.ts      | 149 +++++++++++++++++-
 .../components/ActionGroup/transform.ts       |   8 +-
 .../ContextualHelpTrigger/transform.ts        |   4 +-
 .../components/DialogTrigger/transform.ts     |  22 ++-
 .../src/codemods/components/Tabs/transform.ts |   4 +-
 .../src/s1-to-s2/src/codemods/shared/utils.ts |  59 +++++--
 .../codemods/src/s1-to-s2/src/transform.ts    |   2 +-
 11 files changed, 492 insertions(+), 31 deletions(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap
index fcc1a32b352..586564dd67c 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap
@@ -127,7 +127,7 @@ exports[`Replaces type="fullscreen" with FullscreenDialog component 1`] = `
   <Button>Test</Button>
   <FullscreenDialog isKeyboardDismissDisabled>
     <Heading>Test</Heading>
-    <Divider />
+
     <Content>Content</Content>
   </FullscreenDialog>
 </DialogTrigger>"
@@ -147,12 +147,12 @@ exports[`Replaces type="fullscreen" with FullscreenDialog component in DialogCon
 <DialogContainer>
   {showDialog1 && <FullscreenDialog isKeyboardDismissDisabled>
     <Heading>Test</Heading>
-    <Divider />
+
     <Content>Content</Content>
   </FullscreenDialog>}
   {showDialog2 && <FullscreenDialog isKeyboardDismissDisabled>
     <Heading>Test</Heading>
-    <Divider />
+
     <Content>Content</Content>
   </FullscreenDialog>}
 </DialogContainer>"
@@ -165,7 +165,7 @@ exports[`Replaces type="fullscreenTakeover" with FullscreenDialog component 1`]
   <Button>Test</Button>
   <FullscreenDialog variant="fullscreenTakeover">
     <Heading>Test</Heading>
-    <Divider />
+
     <Content>Content</Content>
   </FullscreenDialog>
 </DialogTrigger>"
@@ -195,7 +195,7 @@ exports[`Replaces type="popover" with Popover component 1`] = `
   <Button>Test</Button>
   <Popover hideArrow>
     <Heading>Test</Heading>
-    <Divider />
+
     <Content>Content</Content>
   </Popover>
 </DialogTrigger>"
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap
index 4d313138b30..d811c3d3a11 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap
@@ -10,6 +10,28 @@ exports[`Should not update components that are not provided to --components opti
 </div>"
 `;
 
+exports[`Should only update ComboBox related shared components provided to --components option 1`] = `
+"import { ComboBoxSection, ComboBoxItem, ComboBox } from "@react-spectrum/s2";
+import { Menu, MenuTrigger, Button, Section, Item } from '@adobe/react-spectrum';
+
+<>
+  <ComboBox>
+    <ComboBoxSection><Header>Animals</Header>
+      <ComboBoxItem id="dog">Dog</ComboBoxItem>
+      <ComboBoxItem id="cat">Cat</ComboBoxItem>
+    </ComboBoxSection>
+  </ComboBox>
+  <MenuTrigger>
+    <Button>Open</Button>
+    <Menu>
+      <Section title="Actions">
+        <Item key="cut">Cut</Item>
+      </Section>
+    </Menu>
+  </MenuTrigger>
+</>"
+`;
+
 exports[`Should only update components provided to --components option 1`] = `
 "import { TextArea } from '@adobe/react-spectrum';
 
@@ -22,6 +44,92 @@ import { Button } from "@react-spectrum/s2";
 </div>"
 `;
 
+exports[`Should update ActionGroup related components provided to --components option 1`] = `
+"import { ActionButtonGroup, ActionButton } from "@react-spectrum/s2";
+
+<ActionButtonGroup>
+  <ActionButton key="add" onPress={() => onAction("add")}>Add</ActionButton>
+  <ActionButton key="delete" onPress={() => onAction("delete")}>Delete</ActionButton>
+  <ActionButton key="edit" onPress={() => onAction("edit")}>Edit</ActionButton>
+</ActionButtonGroup>"
+`;
+
+exports[`Should update DialogTrigger related components provided to --components option 1`] = `
+"import { Button, Heading, Content } from '@adobe/react-spectrum';
+
+import { DialogTrigger, Dialog } from "@react-spectrum/s2";
+
+<DialogTrigger>
+  <Button>Test</Button>
+  <Dialog>
+    <Heading>Test</Heading>
+
+    <Content>Content</Content>
+  </Dialog>
+</DialogTrigger>"
+`;
+
+exports[`Should update Menu related components provided to --components option 1`] = `
+"import {
+  UnavailableMenuItemTrigger,
+  ContextualHelpPopover,
+  MenuItem,
+  MenuSection,
+  Menu,
+  MenuTrigger,
+  SubmenuTrigger,
+} from "@react-spectrum/s2";
+
+import { Breadcrumbs, Item, Button, Heading, Content } from '@adobe/react-spectrum';
+
+<>
+  <MenuTrigger>
+    <Button>Edit</Button>
+    <Menu>
+      <MenuItem id="undo">Undo</MenuItem>
+      <SubmenuTrigger>
+        <MenuItem id="share">Share</MenuItem>
+        <Menu>
+          <MenuItem id="sms">SMS</MenuItem>
+        </Menu>
+      </SubmenuTrigger>
+      <MenuSection><Header>Help</Header>
+        <UnavailableMenuItemTrigger isUnavailable>
+          <MenuItem id="cut">Cut</MenuItem>
+          <ContextualHelpPopover>
+            <Heading>Cut</Heading>
+            <Content>Please select text for Cut to be enabled.</Content>
+          </ContextualHelpPopover>
+        </UnavailableMenuItemTrigger>
+      </MenuSection>
+    </Menu>
+  </MenuTrigger>
+  <Breadcrumbs>
+    <Item key="home">Home</Item>
+  </Breadcrumbs>
+</>"
+`;
+
+exports[`Should update Tabs related components provided to --components option 1`] = `
+"import { Tab, TabPanel, Tabs, TabList } from "@react-spectrum/s2";
+
+<Tabs aria-label="History of Ancient Rome"><TabList>
+    <Tab id="FoR">Founding of Rome</Tab>
+    <Tab id="MaR">Monarchy and Republic</Tab>
+  </TabList><TabPanel id="FoR">Arma virumque cano, Troiae qui primus ab oris.</TabPanel><TabPanel id="MaR">Senatus Populusque Romanus.</TabPanel></Tabs>"
+`;
+
+exports[`Should update TooltipTrigger related components provided to --components option 1`] = `
+"import { ActionButton } from '@adobe/react-spectrum';
+
+import { TooltipTrigger, Tooltip } from "@react-spectrum/s2";
+
+<TooltipTrigger placement="bottom">
+  <ActionButton aria-label="Edit Name"><Edit /></ActionButton>
+  <Tooltip>Change Name</Tooltip>
+</TooltipTrigger>"
+`;
+
 exports[`Should update multiple components provided to --components option 1`] = `
 "import { Button, TextArea } from "@react-spectrum/s2";
 
@@ -31,3 +139,24 @@ exports[`Should update multiple components provided to --components option 1`] =
   <TextArea />
 </div>"
 `;
+
+exports[`Should update related TableView components provided to --components option 1`] = `
+"import { Cell, Column, Row, TableBody, TableHeader, TableView } from "@react-spectrum/s2";
+
+<TableView>
+  <TableHeader>
+    <Column id="test" isRowHeader={true}>Test</Column>
+    <Column id="blah">Blah</Column>
+  </TableHeader>
+  <TableBody>
+    <Row>
+      <Cell>Test1</Cell>
+      <Cell>One</Cell>
+    </Row>
+    <Row>
+      <Cell>Test2</Cell>
+      <Cell>One</Cell>
+    </Row>
+  </TableBody>
+</TableView>"
+`;
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts b/packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts
index 6d95e58c23e..dbfcb06c39a 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/cli.e2e.test.ts
@@ -226,6 +226,22 @@ test('runs the shipped assistant in agent mode', async () => {
   expectProjectToMatchFixture(result.projectDir, 'full-project');
 });
 
+test('respects --components in agent mode', async () => {
+  let result = await runFixtureCLI({
+    fixtureName: 'subset-project',
+    args: ['--agent', '--components', 'Button']
+  });
+
+  expect(result.exitCode).toBe(0);
+  expect(result.stderr).toBe('');
+  expect(result.stdout).toContain('Running s1-to-s2 in agent mode (non-interactive, transform-only).');
+  expect(result.stdout).toContain('Upgrade complete!');
+  expect(result.stdout).not.toContain(PROMPT_TO_START);
+  expect(result.stdout).not.toContain(PROMPT_TO_UPGRADE);
+  expect(result.packageManagerCalls).toEqual([]);
+  expectProjectToMatchFixture(result.projectDir, 'subset-project');
+});
+
 test('runs the interactive assistant flow against a real project fixture', async () => {
   let result = await runFixtureCLI({
     fixtureName: 'full-project',
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/subset.test.ts b/packages/dev/codemods/src/s1-to-s2/__tests__/subset.test.ts
index f56c737c83e..27246ce1344 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/subset.test.ts
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/subset.test.ts
@@ -35,3 +35,123 @@ import {Button, TextArea} from '@adobe/react-spectrum';
   <TextArea isQuiet />
 </div>
 `, 'TableView');
+
+testSubset('Should update related TableView components provided to --components option', `
+import {Cell, Column, Row, TableBody, TableHeader, TableView} from '@adobe/react-spectrum';
+
+<TableView>
+  <TableHeader>
+    <Column key="test">Test</Column>
+    <Column key="blah">Blah</Column>
+  </TableHeader>
+  <TableBody>
+    <Row>
+      <Cell>Test1</Cell>
+      <Cell>One</Cell>
+    </Row>
+    <Row>
+      <Cell>Test2</Cell>
+      <Cell>One</Cell>
+    </Row>
+  </TableBody>
+</TableView>
+`, 'TableView');
+
+testSubset('Should only update ComboBox related shared components provided to --components option', `
+import {ComboBox, Menu, MenuTrigger, Button, Section, Item} from '@adobe/react-spectrum';
+
+<>
+  <ComboBox>
+    <Section title="Animals">
+      <Item key="dog">Dog</Item>
+      <Item key="cat">Cat</Item>
+    </Section>
+  </ComboBox>
+  <MenuTrigger>
+    <Button>Open</Button>
+    <Menu>
+      <Section title="Actions">
+        <Item key="cut">Cut</Item>
+      </Section>
+    </Menu>
+  </MenuTrigger>
+</>
+`, 'ComboBox');
+
+testSubset('Should update Menu related components provided to --components option', `
+import {Breadcrumbs, Menu, MenuTrigger, SubmenuTrigger, ContextualHelpTrigger, Item, Section, Button, Dialog, Heading, Content} from '@adobe/react-spectrum';
+
+<>
+  <MenuTrigger>
+    <Button>Edit</Button>
+    <Menu>
+      <Item key="undo">Undo</Item>
+      <SubmenuTrigger>
+        <Item key="share">Share</Item>
+        <Menu>
+          <Item key="sms">SMS</Item>
+        </Menu>
+      </SubmenuTrigger>
+      <Section title="Help">
+        <ContextualHelpTrigger isUnavailable>
+          <Item key="cut">Cut</Item>
+          <Dialog>
+            <Heading>Cut</Heading>
+            <Content>Please select text for Cut to be enabled.</Content>
+          </Dialog>
+        </ContextualHelpTrigger>
+      </Section>
+    </Menu>
+  </MenuTrigger>
+  <Breadcrumbs>
+    <Item key="home">Home</Item>
+  </Breadcrumbs>
+</>
+`, 'Menu');
+
+testSubset('Should update Tabs related components provided to --components option', `
+import {Tabs, TabList, TabPanels, Item} from '@adobe/react-spectrum';
+
+<Tabs aria-label="History of Ancient Rome">
+  <TabList>
+    <Item key="FoR">Founding of Rome</Item>
+    <Item key="MaR">Monarchy and Republic</Item>
+  </TabList>
+  <TabPanels>
+    <Item key="FoR">Arma virumque cano, Troiae qui primus ab oris.</Item>
+    <Item key="MaR">Senatus Populusque Romanus.</Item>
+  </TabPanels>
+</Tabs>
+`, 'Tabs');
+
+testSubset('Should update DialogTrigger related components provided to --components option', `
+import {DialogTrigger, Button, Dialog, Heading, Content, Divider} from '@adobe/react-spectrum';
+
+<DialogTrigger>
+  <Button>Test</Button>
+  <Dialog>
+    <Heading>Test</Heading>
+    <Divider />
+    <Content>Content</Content>
+  </Dialog>
+</DialogTrigger>
+`, 'DialogTrigger');
+
+testSubset('Should update TooltipTrigger related components provided to --components option', `
+import {ActionButton, TooltipTrigger, Tooltip} from '@adobe/react-spectrum';
+
+<TooltipTrigger>
+  <ActionButton aria-label="Edit Name"><Edit /></ActionButton>
+  <Tooltip placement="bottom left" showIcon>Change Name</Tooltip>
+</TooltipTrigger>
+`, 'TooltipTrigger');
+
+testSubset('Should update ActionGroup related components provided to --components option', `
+import {ActionGroup, Item} from '@adobe/react-spectrum';
+
+<ActionGroup onAction={onAction}>
+  <Item key="add">Add</Item>
+  <Item key="delete">Delete</Item>
+  <Item key="edit">Edit</Item>
+</ActionGroup>
+`, 'ActionGroup');
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
index 2865a032074..82a8a9fa7ed 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
@@ -1,5 +1,5 @@
 /* eslint-disable max-depth */
-import {addComment} from './shared/utils';
+import {addComment, getName} from './shared/utils';
 import {API, FileInfo} from 'jscodeshift';
 import {getComponents} from '../getComponents';
 import {iconMap} from './icons/iconMap';
@@ -37,6 +37,138 @@ interface Options {
   components?: string
 }
 
+interface RelatedComponentGroup {
+  components?: string[],
+  scopedComponents?: Record<string, string[]>
+}
+
+interface ComponentSelection {
+  components: Set<string>,
+  explicitComponents: Set<string>,
+  scopedComponents: Map<string, Set<string>>
+}
+
+const relatedComponentGroups: Record<string, RelatedComponentGroup> = {
+  ActionMenu: {
+    scopedComponents: {
+      Item: ['ActionMenu']
+    }
+  },
+  Breadcrumbs: {
+    scopedComponents: {
+      Item: ['Breadcrumbs']
+    }
+  },
+  ComboBox: {
+    scopedComponents: {
+      Item: ['ComboBox'],
+      Section: ['ComboBox']
+    }
+  },
+  DialogContainer: {
+    components: ['Dialog']
+  },
+  DialogTrigger: {
+    components: ['Dialog']
+  },
+  Menu: {
+    components: ['ContextualHelpTrigger', 'MenuTrigger', 'SubmenuTrigger'],
+    scopedComponents: {
+      Item: ['Menu'],
+      Section: ['Menu']
+    }
+  },
+  Picker: {
+    scopedComponents: {
+      Item: ['Picker'],
+      Section: ['Picker']
+    }
+  },
+  TableView: {
+    components: ['Cell', 'Column', 'Row', 'TableBody', 'TableHeader']
+  },
+  Tabs: {
+    components: ['TabList', 'TabPanels']
+  },
+  TagGroup: {
+    scopedComponents: {
+      Item: ['TagGroup']
+    }
+  },
+  TooltipTrigger: {
+    components: ['Tooltip']
+  }
+};
+
+function addScopedParents(scopedComponents: Map<string, Set<string>>, component: string, parents: string[]) {
+  let existingParents = scopedComponents.get(component) ?? new Set<string>();
+  for (let parent of parents) {
+    existingParents.add(parent);
+  }
+  scopedComponents.set(component, existingParents);
+}
+
+function getComponentSelection(components?: string): ComponentSelection {
+  if (!components) {
+    return {
+      components: new Set(availableComponents),
+      explicitComponents: new Set(availableComponents),
+      scopedComponents: new Map()
+    };
+  }
+
+  let explicitComponents = new Set(
+    components.split(',').map(s => s.trim()).filter(Boolean)
+  );
+  let expandedComponents = new Set(explicitComponents);
+  let scopedComponents = new Map<string, Set<string>>();
+
+  for (let component of explicitComponents) {
+    let relatedComponents = relatedComponentGroups[component];
+    if (!relatedComponents) {
+      continue;
+    }
+
+    for (let relatedComponent of relatedComponents.components ?? []) {
+      expandedComponents.add(relatedComponent);
+    }
+
+    for (let [relatedComponent, parents] of Object.entries(relatedComponents.scopedComponents ?? {})) {
+      expandedComponents.add(relatedComponent);
+      if (!explicitComponents.has(relatedComponent)) {
+        addScopedParents(scopedComponents, relatedComponent, parents);
+      }
+    }
+  }
+
+  return {
+    components: new Set([...expandedComponents].filter(component => availableComponents.has(component))),
+    explicitComponents: new Set([...explicitComponents].filter(component => availableComponents.has(component))),
+    scopedComponents
+  };
+}
+
+function shouldTransformElement(
+  componentName: string,
+  path: NodePath<t.JSXElement>,
+  selection: ComponentSelection
+): boolean {
+  if (selection.explicitComponents.has(componentName)) {
+    return true;
+  }
+
+  let allowedParents = selection.scopedComponents.get(componentName);
+  if (!allowedParents || allowedParents.size === 0) {
+    return true;
+  }
+
+  return !!path.findParent((parentPath) =>
+    t.isJSXElement(parentPath.node)
+    && t.isJSXIdentifier(parentPath.node.openingElement.name)
+    && allowedParents.has(getName(path, parentPath.node.openingElement.name))
+  );
+}
+
 export default function transformer(file: FileInfo, api: API, options: Options):string {
   let j = api.jscodeshift.withParser({
     parse(source: string) {
@@ -46,9 +178,8 @@ export default function transformer(file: FileInfo, api: API, options: Options):
     }
   });
   let root = j(file.source);
-  let componentsToTransform = options.components
-    ? new Set(options.components.split(',').map(s => s.trim()).filter(s => availableComponents.has(s)))
-    : availableComponents;
+  let selection = getComponentSelection(options.components);
+  let componentsToTransform = selection.components;
   let v3ComponentsToRename = new Set(Object.keys(renamedComponents));
   let S2ComponentsToImport = new Set<string>();
 
@@ -74,7 +205,10 @@ export default function transformer(file: FileInfo, api: API, options: Options):
                 if (propName && path.parentPath!.parentPath?.parentPath?.isJSXElement()) {
                   if (componentsToTransform.has(propName)) {
                     importedComponents.set(propName, clonedSpecifier);
-                    elements.push([propName, path.parentPath!.parentPath.parentPath]);
+                    let elementPath = path.parentPath!.parentPath.parentPath as NodePath<t.JSXElement>;
+                    if (shouldTransformElement(propName, elementPath, selection)) {
+                      elements.push([propName, elementPath]);
+                    }
                   } else if (v3ComponentsToRename.has(propName)) {
                     S2ComponentsToImport.add(renamedComponents[propName]);
                     elements.push([propName, path.parentPath!.parentPath.parentPath]);
@@ -114,7 +248,10 @@ export default function transformer(file: FileInfo, api: API, options: Options):
               bindings.push(binding);
               for (let path of binding.referencePaths) {
                 if (path.parentPath?.isJSXOpeningElement() && path.parentPath.parentPath.isJSXElement()) {
-                  elements.push([specifier.imported.name, path.parentPath.parentPath]);
+                  let elementPath = path.parentPath.parentPath as NodePath<t.JSXElement>;
+                  if (shouldTransformElement(specifier.imported.name, elementPath, selection)) {
+                    elements.push([specifier.imported.name, elementPath]);
+                  }
                 }
               }
             }
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ActionGroup/transform.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ActionGroup/transform.ts
index 035ab57424b..ac34bb351b5 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ActionGroup/transform.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ActionGroup/transform.ts
@@ -1,4 +1,4 @@
-import {addComponentImport} from '../../shared/utils';
+import {addComponentImport, removeComponentImportIfUnused} from '../../shared/utils';
 import {commentOutProp} from '../../shared/transforms';
 import {getComponents} from '../../../getComponents';
 import {NodePath} from '@babel/traverse';
@@ -18,6 +18,8 @@ let availableComponents = getComponents();
  * - Convert dynamic collections render function to items.map.
  */
 export default function transformActionGroup(path: NodePath<t.JSXElement>): void {
+  let program = path.findParent((p) => t.isProgram(p.node)) as NodePath<t.Program>;
+
   // Comment out overflowMode
   commentOutProp(path, {propName: 'overflowMode'});
 
@@ -43,13 +45,11 @@ export default function transformActionGroup(path: NodePath<t.JSXElement>): void
 
   let localName = newComponentName;
   if (availableComponents.has(newComponentName)) {
-    let program = path.findParent((p) => t.isProgram(p.node)) as NodePath<t.Program>;
     localName = addComponentImport(program, newComponentName);
   }
 
   let localChildName = childComponentName;
   if (availableComponents.has(childComponentName)) {
-    let program = path.findParent((p) => t.isProgram(p.node)) as NodePath<t.Program>;
     localChildName = addComponentImport(program, childComponentName);
   }
 
@@ -185,4 +185,6 @@ export default function transformActionGroup(path: NodePath<t.JSXElement>): void
   if (path.node.closingElement) {
     path.node.closingElement.name = t.jsxIdentifier(localName);
   }
+
+  removeComponentImportIfUnused(program, 'Item');
 }
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ContextualHelpTrigger/transform.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ContextualHelpTrigger/transform.ts
index ba514b3a203..732736790e2 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ContextualHelpTrigger/transform.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/ContextualHelpTrigger/transform.ts
@@ -1,4 +1,4 @@
-import {addComponentImport, getName} from '../../shared/utils';
+import {addComponentImport, getName, removeComponentImportIfUnused} from '../../shared/utils';
 import {getComponents} from '../../../getComponents';
 import {NodePath} from '@babel/traverse';
 import * as t from '@babel/types';
@@ -34,4 +34,6 @@ export default function transformContextualHelpTrigger(path: NodePath<t.JSXEleme
       }
     }
   }
+
+  removeComponentImportIfUnused(program, 'Dialog');
 }
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/DialogTrigger/transform.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/DialogTrigger/transform.ts
index 6ac39078a0d..703facaef90 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/DialogTrigger/transform.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/DialogTrigger/transform.ts
@@ -1,4 +1,4 @@
-import {addComponentImport, getName} from '../../shared/utils';
+import {addComponentImport, getName, removeComponentImportIfUnused} from '../../shared/utils';
 import {
   commentOutProp,
   moveRenderPropsToChild,
@@ -22,6 +22,7 @@ let availableComponents = getComponents();
 export function updateDialogChild(
   path: NodePath<t.JSXElement>
 ): void {
+  let program = path.findParent((p) => t.isProgram(p.node)) as NodePath<t.Program>;
   let typePath = path.get('openingElement').get('attributes').find((attr) => t.isJSXAttribute(attr.node) && attr.node.name.name === 'type') as NodePath<t.JSXAttribute> | undefined;
   let type = typePath?.node.value?.type === 'StringLiteral' ? typePath.node.value?.value : 'modal';
   let newComponentName = 'Dialog';
@@ -47,7 +48,6 @@ export function updateDialogChild(
 
   let localName = newComponentName;
   if (newComponentName !== 'Dialog' && availableComponents.has(newComponentName)) {
-    let program = path.findParent((p) => t.isProgram(p.node)) as NodePath<t.Program>;
     localName = addComponentImport(program, newComponentName);
   }
 
@@ -65,6 +65,24 @@ export function updateDialogChild(
       dialog.node.openingElement.attributes.push(...props);
     }
   });
+
+  path.traverse({
+    JSXElement(childPath) {
+      if (
+        t.isJSXIdentifier(childPath.node.openingElement.name)
+        && getName(childPath as NodePath<t.JSXElement>, childPath.node.openingElement.name) === 'Divider'
+        && t.isJSXElement(childPath.parentPath.node)
+        && t.isJSXIdentifier(childPath.parentPath.node.openingElement.name)
+      ) {
+        let parentName = getName(childPath as NodePath<t.JSXElement>, childPath.parentPath.node.openingElement.name);
+        if (parentName === 'Dialog' || parentName === 'Popover' || parentName === 'FullscreenDialog') {
+          childPath.remove();
+        }
+      }
+    }
+  });
+
+  removeComponentImportIfUnused(program, 'Divider');
 }
 
 /**
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts
index b0ef32be6f5..c00bfbd3a93 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/components/Tabs/transform.ts
@@ -1,4 +1,4 @@
-import {getName, removeComponentImport} from '../../shared/utils';
+import {getName, removeComponentImport, removeComponentImportIfUnused} from '../../shared/utils';
 import {NodePath} from '@babel/traverse';
 import {removeProp, updateComponentWithinCollection, updateToNewComponentName} from '../../shared/transforms';
 import * as t from '@babel/types';
@@ -97,4 +97,6 @@ export default function transformTabs(path: NodePath<t.JSXElement>): void {
 
   // Remove isQuiet
   removeProp(path, {propName: 'isQuiet'});
+
+  removeComponentImportIfUnused(program, 'Item');
 }
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
index 9e1458c3353..eda7991251e 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
@@ -74,6 +74,20 @@ export function addComment(node: any, comment: string): void {
 }
 
 export function addComponentImport(path: NodePath<t.Program>, newComponentName: string): string {
+  let existingImport = path.node.body.find((node) => t.isImportDeclaration(node) && node.source.value === '@react-spectrum/s2');
+  if (existingImport && t.isImportDeclaration(existingImport)) {
+    let existingSpecifier = existingImport.specifiers.find((specifier) => {
+      return (
+        t.isImportSpecifier(specifier) &&
+        specifier.imported.type === 'Identifier' &&
+        specifier.imported.name === newComponentName
+      );
+    });
+    if (existingSpecifier && t.isImportSpecifier(existingSpecifier)) {
+      return existingSpecifier.local?.name ?? newComponentName;
+    }
+  }
+
   // If newComponentName variable already exists in scope, alias new import to avoid conflict.
   let existingBinding = path.scope.getBinding(newComponentName);
   let localName = newComponentName;
@@ -87,19 +101,7 @@ export function addComponentImport(path: NodePath<t.Program>, newComponentName:
     localName = newName;
   }
 
-  let existingImport = path.node.body.find((node) => t.isImportDeclaration(node) && node.source.value === '@react-spectrum/s2');
   if (existingImport && t.isImportDeclaration(existingImport)) {
-    let specifier = existingImport.specifiers.find((specifier) => {
-      return (
-        t.isImportSpecifier(specifier) &&
-        specifier.imported.type === 'Identifier' &&
-        specifier.imported.name === newComponentName
-      );
-    });
-    if (specifier) {
-      // Already imported
-      return localName;
-    }
     existingImport.specifiers.push(
       t.importSpecifier(t.identifier(localName), t.identifier(newComponentName))
     );
@@ -143,6 +145,39 @@ export function removeComponentImport(path: NodePath<t.Program>, component: stri
   }
 }
 
+export function removeComponentImportIfUnused(path: NodePath<t.Program>, component: string): void {
+  path.scope.crawl();
+
+  let imports = path.node.body.filter((node): node is t.ImportDeclaration => {
+    return t.isImportDeclaration(node)
+      && (
+        node.source.value === '@adobe/react-spectrum'
+        || (node.source.value.startsWith('@react-spectrum/') && node.source.value !== '@react-spectrum/s2')
+      );
+  });
+
+  for (let importDecl of imports) {
+    let previousLength = importDecl.specifiers.length;
+    importDecl.specifiers = importDecl.specifiers.filter((specifier) => {
+      if (
+        t.isImportSpecifier(specifier)
+        && specifier.imported.type === 'Identifier'
+        && specifier.imported.name === component
+      ) {
+        let localName = specifier.local?.name ?? specifier.imported.name;
+        let binding = path.scope.getBinding(localName);
+        return !!binding?.referencePaths.length;
+      }
+
+      return true;
+    });
+
+    if (importDecl.specifiers.length === 0 && previousLength > 0) {
+      path.node.body = path.node.body.filter((node) => node !== importDecl);
+    }
+  }
+}
+
 /**
  * Look up the name in path.scope and find the original binding.
  * Returns the original name even if an alias is used.
diff --git a/packages/dev/codemods/src/s1-to-s2/src/transform.ts b/packages/dev/codemods/src/s1-to-s2/src/transform.ts
index 6c31e3e2b03..b17bae51763 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/transform.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/transform.ts
@@ -6,6 +6,6 @@ const transformPath = path.join(__dirname, 'codemods', 'codemod.js');
 
 export async function transform(options: S1ToS2CodemodOptions): Promise<ReturnType<typeof jscodeshift>> {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const {path: filePath = '.', components, agent, ...jscodeshiftOptions} = options;
+  const {path: filePath = '.', agent, ...jscodeshiftOptions} = options;
   return await jscodeshift(transformPath, [filePath], jscodeshiftOptions);
 }

From 5c023f949ce7b9d9cb5fd6937aae626d19b30d25 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 6 Mar 2026 14:15:03 -0600
Subject: [PATCH 09/15] yarn.lock

---
 yarn.lock | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/yarn.lock b/yarn.lock
index 3d468895bcf..ced317e47a7 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -88,7 +88,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@adobe/react-spectrum@workspace:packages/@adobe/react-spectrum":
+"@adobe/react-spectrum@npm:^3.46.1, @adobe/react-spectrum@workspace:packages/@adobe/react-spectrum":
   version: 0.0.0-use.local
   resolution: "@adobe/react-spectrum@workspace:packages/@adobe/react-spectrum"
   dependencies:
@@ -6648,6 +6648,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@react-spectrum/codemods@workspace:packages/dev/codemods"
   dependencies:
+    "@adobe/react-spectrum": "npm:^3.46.1"
     "@babel/parser": "npm:^7.24.5"
     "@babel/traverse": "npm:^7.24.5"
     "@babel/types": "npm:^7.24.5"

From b871a88b18e0d437b786062077e52205eba8b914 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 6 Mar 2026 16:10:07 -0600
Subject: [PATCH 10/15] update outdated links

---
 packages/dev/codemods/src/s1-to-s2/src/index.ts | 8 ++++----
 rules/README.md                                 | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/src/index.ts b/packages/dev/codemods/src/s1-to-s2/src/index.ts
index 1bff92cbb05..5c5b889a625 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/index.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/index.ts
@@ -22,10 +22,10 @@ export async function s1_to_s2(options: S1ToS2CodemodOptions): Promise<void> {
     logger.success('Upgrade complete!');
     printNextSteps([
       `Ensure ${chalk.bold('@react-spectrum/s2')} is installed.`,
-      `If your bundler is not Parcel v2.12.0+, configure the Spectrum 2 style macro support. See: ${chalk.underline('https://react-spectrum.adobe.com/s2/index.html?path=/docs/intro--docs#configuring-your-bundler')}`,
+      `If your bundler is not Parcel v2.12.0+, configure the Spectrum 2 style macro support. See: ${chalk.underline('https://react-spectrum.adobe.com/getting-started#framework-setup')}`,
       `Add ${chalk.bold('import \'@react-spectrum/s2/page.css\';')} to your entry component if needed.`,
       `Search for ${chalk.bold('TODO(S2-upgrade)')} and resolve remaining manual migration updates.`,
-      `Reference the migration guide: ${chalk.underline('https://react-spectrum.adobe.com/s2/index.html?path=/docs/migrating--docs')}`
+      `Reference the migration guide: ${chalk.underline('https://react-spectrum.adobe.com/migrating')}`
     ]);
     return;
   }
@@ -75,7 +75,7 @@ export async function s1_to_s2(options: S1ToS2CodemodOptions): Promise<void> {
       `  - Vite: ${chalk.underline('https://github.com/adobe/react-spectrum/tree/main/examples/s2-vite-project')}\n` +
       `  - Rollup: ${chalk.underline('https://github.com/adobe/react-spectrum/tree/main/examples/s2-rollup-starter-app')}\n` +
       `  - ESBuild: ${chalk.underline('https://github.com/adobe/react-spectrum/tree/main/examples/s2-esbuild-starter-app')}\n\n` +
-      `or view documentation here: ${chalk.underline('https://react-spectrum.adobe.com/s2/index.html?path=/docs/intro--docs#configuring-your-bundler')}`
+      `or view documentation here: ${chalk.underline('https://react-spectrum.adobe.com/getting-started#framework-setup')}`
     );
   }
 
@@ -85,7 +85,7 @@ export async function s1_to_s2(options: S1ToS2CodemodOptions): Promise<void> {
     `${chalk.bold('TODO(S2-upgrade)')}\n\n` +
     'You should be able to search your codebase and handle these manually. \n\n' +
     'We also recommend running your project\'s code formatter (i.e. Prettier, ESLint) after the upgrade process to clean up any extraneous formatting from the codemod.\n\n' +
-    `For additional help, reference the Spectrum 2 Migration Guide: ${chalk.underline('https://react-spectrum.adobe.com/s2/index.html?path=/docs/migrating--docs')}`
+    `For additional help, reference the Spectrum 2 Migration Guide: ${chalk.underline('https://react-spectrum.adobe.com/migrating')}`
   );
 
   printNextSteps(nextSteps);
diff --git a/rules/README.md b/rules/README.md
index 2885e79a276..007eddad3b0 100644
--- a/rules/README.md
+++ b/rules/README.md
@@ -14,7 +14,7 @@ For React Spectrum (Spectrum 2) (i.e. `@react-spectrum/s2`).
 
 ### `style-macro.mdc`
 
-For the React Spectrum S2 [style macro](https://react-spectrum.adobe.com/s2/index.html?path=/docs/style-macro--docs).
+For the React Spectrum S2 [style macro](https://react-spectrum.adobe.com/styling).
 
 ### `react-spectrum-v3-to-s2-migration.mdc`
 

From 4d6af4c98aeba0ef3ad9b05a260ec3688445a5d8 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Mon, 9 Mar 2026 10:39:21 -0500
Subject: [PATCH 11/15] bump @adobe/react-spectrum version

---
 packages/dev/codemods/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/dev/codemods/package.json b/packages/dev/codemods/package.json
index ea1e39f17f3..5e7a927b54e 100644
--- a/packages/dev/codemods/package.json
+++ b/packages/dev/codemods/package.json
@@ -21,7 +21,7 @@
     "url": "https://github.com/adobe/react-spectrum"
   },
   "dependencies": {
-    "@adobe/react-spectrum": "^3.46.1",
+    "@adobe/react-spectrum": "^3.46.2",
     "@babel/parser": "^7.24.5",
     "@babel/traverse": "^7.24.5",
     "@babel/types": "^7.24.5",

From 323ad016bca80933b7c8869c4e90463d4bd71f15 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Mon, 9 Mar 2026 10:47:20 -0500
Subject: [PATCH 12/15] fix missing imports and remove unused

---
 .../__snapshots__/combobox.test.ts.snap       |  2 +-
 .../__snapshots__/dialog.test.ts.snap         | 36 ++++++++-----------
 .../__snapshots__/imports.test.ts.snap        |  8 ++---
 .../__tests__/__snapshots__/menu.test.ts.snap | 11 +++---
 .../__snapshots__/picker.test.ts.snap         |  2 +-
 .../__snapshots__/subset.test.ts.snap         |  3 +-
 .../src/s1-to-s2/src/codemods/codemod.ts      | 10 +++++-
 .../src/codemods/shared/transforms.ts         |  9 +++--
 .../src/s1-to-s2/src/codemods/shared/utils.ts | 31 +++++++++++++++-
 9 files changed, 71 insertions(+), 41 deletions(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/combobox.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/combobox.test.ts.snap
index 4d74b2d5c4b..947628eee33 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/combobox.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/combobox.test.ts.snap
@@ -205,7 +205,7 @@ let props = {validationState: 'invalid'};
 `;
 
 exports[`handles sections 1`] = `
-"import { ComboBoxSection, ComboBoxItem, ComboBox } from "@react-spectrum/s2";
+"import { ComboBoxSection, Header, ComboBoxItem, ComboBox } from "@react-spectrum/s2";
 <ComboBox>
   <ComboBoxSection><Header>Section title</Header>
     <ComboBoxItem>Item one</ComboBoxItem>
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap
index 586564dd67c..bd1eec0bd3b 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dialog.test.ts.snap
@@ -1,7 +1,7 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`Comments out if type might be "tray" 1`] = `
-"import { DialogTrigger, ActionButton, Dialog, Heading, Divider, Content, Text } from "@react-spectrum/s2";
+"import { DialogTrigger, ActionButton, Dialog } from "@react-spectrum/s2";
 
 // TODO(S2-upgrade): type="tray" has not been implemented yet.
 <DialogTrigger>
@@ -13,7 +13,7 @@ exports[`Comments out if type might be "tray" 1`] = `
 `;
 
 exports[`Comments out mobileType 1`] = `
-"import { DialogTrigger, ActionButton, Dialog, Heading, Divider, Content, Text } from "@react-spectrum/s2";
+"import { DialogTrigger, ActionButton, Dialog } from "@react-spectrum/s2";
 
 <>
   // TODO(S2-upgrade): mobileType has not been implemented yet.
@@ -34,7 +34,7 @@ exports[`Comments out mobileType 1`] = `
 `;
 
 exports[`Comments out type="tray" 1`] = `
-"import { DialogTrigger, ActionButton, Dialog, Heading, Divider, Content, Text } from "@react-spectrum/s2";
+"import { DialogTrigger, ActionButton, Dialog } from "@react-spectrum/s2";
 
 // TODO(S2-upgrade): type="tray" has not been implemented yet.
 <DialogTrigger>
@@ -46,7 +46,7 @@ exports[`Comments out type="tray" 1`] = `
 `;
 
 exports[`Moves close function from DialogTrigger to Dialog 1`] = `
-"import { DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { DialogTrigger, Button, Dialog, Heading, Content } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
@@ -63,7 +63,7 @@ exports[`Moves close function from DialogTrigger to Dialog 1`] = `
 `;
 
 exports[`Moves isDismissable 1`] = `
-"import { DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { DialogTrigger, Button, Dialog, Heading, Content } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
@@ -76,7 +76,7 @@ exports[`Moves isDismissable 1`] = `
 `;
 
 exports[`Moves isDismissable from DialogContainer 1`] = `
-"import { DialogContainer, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { DialogContainer, Dialog, Heading, Content } from "@react-spectrum/s2";
 
 <DialogContainer>
   {showDialog1 && <Dialog isDismissible>
@@ -93,7 +93,7 @@ exports[`Moves isDismissable from DialogContainer 1`] = `
 `;
 
 exports[`Removes divider 1`] = `
-"import { Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { Dialog, Heading, Content } from "@react-spectrum/s2";
 
 <Dialog>
   <Heading>Test</Heading>
@@ -103,7 +103,7 @@ exports[`Removes divider 1`] = `
 `;
 
 exports[`Removes onDismiss and leaves a comment 1`] = `
-"import { DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { DialogTrigger, Button, Dialog, Heading, Content } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
@@ -121,7 +121,7 @@ exports[`Removes onDismiss and leaves a comment 1`] = `
 `;
 
 exports[`Replaces type="fullscreen" with FullscreenDialog component 1`] = `
-"import { FullscreenDialog, DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { FullscreenDialog, DialogTrigger, Button, Heading, Content } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
@@ -134,15 +134,7 @@ exports[`Replaces type="fullscreen" with FullscreenDialog component 1`] = `
 `;
 
 exports[`Replaces type="fullscreen" with FullscreenDialog component in DialogContainer 1`] = `
-"import {
-  FullscreenDialog,
-  DialogContainer,
-  Button,
-  Dialog,
-  Heading,
-  Content,
-  Divider,
-} from "@react-spectrum/s2";
+"import { FullscreenDialog, DialogContainer, Heading, Content } from "@react-spectrum/s2";
 
 <DialogContainer>
   {showDialog1 && <FullscreenDialog isKeyboardDismissDisabled>
@@ -159,7 +151,7 @@ exports[`Replaces type="fullscreen" with FullscreenDialog component in DialogCon
 `;
 
 exports[`Replaces type="fullscreenTakeover" with FullscreenDialog component 1`] = `
-"import { FullscreenDialog, DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { FullscreenDialog, DialogTrigger, Button, Heading, Content } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
@@ -172,7 +164,7 @@ exports[`Replaces type="fullscreenTakeover" with FullscreenDialog component 1`]
 `;
 
 exports[`Replaces type="fullscreenTakeover" with FullscreenDialog component and close function 1`] = `
-"import { FullscreenDialog, DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { FullscreenDialog, DialogTrigger, Button, Heading, Content } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
@@ -189,7 +181,7 @@ exports[`Replaces type="fullscreenTakeover" with FullscreenDialog component and
 `;
 
 exports[`Replaces type="popover" with Popover component 1`] = `
-"import { Popover, DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { Popover, DialogTrigger, Button, Heading, Content } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
@@ -202,7 +194,7 @@ exports[`Replaces type="popover" with Popover component 1`] = `
 `;
 
 exports[`bails when it cannot move the close function 1`] = `
-"import { DialogTrigger, Button, Dialog, Heading, Content, Divider } from "@react-spectrum/s2";
+"import { DialogTrigger, Button } from "@react-spectrum/s2";
 
 <DialogTrigger>
   <Button>Test</Button>
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap
index eef08ee8bca..850b4f778aa 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/imports.test.ts.snap
@@ -35,8 +35,6 @@ import { Button } from "@react-spectrum/s2";
 exports[`should leave unimplemented components untouched in namespace imports 1`] = `
 "import * as RSP from '@adobe/react-spectrum';
 
-import * as RSP1 from "@react-spectrum/s2";
-
 <>
   <RSP.Button>Test</RSP.Button>
   <RSP.Fake>Foo</RSP.Fake>
@@ -62,7 +60,7 @@ import { ListBox, Item } from '@adobe/react-spectrum';
 `;
 
 exports[`should not import Section from S2 1`] = `
-"import { MenuSection, MenuItem, Menu } from "@react-spectrum/s2";
+"import { MenuSection, Header, MenuItem, Menu } from "@react-spectrum/s2";
 import { Section, Item, ListBox } from '@adobe/react-spectrum';
 
 <div>
@@ -105,7 +103,7 @@ import { Button, StatusLight } from "@react-spectrum/s2";
 `;
 
 exports[`should remove unused Item/Section import even if name taken in different scope 1`] = `
-"import { MenuSection, MenuItem, Menu } from "@react-spectrum/s2";
+"import { MenuSection, Header, MenuItem, Menu } from "@react-spectrum/s2";
 
 function foo() {
   let Item = 'something else';
@@ -123,7 +121,7 @@ function foo() {
 `;
 
 exports[`should remove unused Item/Section import if aliased 1`] = `
-"import { MenuSection, MenuItem, Menu } from "@react-spectrum/s2";
+"import { MenuSection, Header, MenuItem, Menu } from "@react-spectrum/s2";
 import {Section, Item} from 'elsewhere';
 
 <div>
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/menu.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/menu.test.ts.snap
index ad8c4f9bbbd..bf4bf187f32 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/menu.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/menu.test.ts.snap
@@ -159,7 +159,6 @@ exports[`Renames ContextualHelpTrigger to UnavailableMenuItemTrigger and Dialog
   Menu,
   MenuTrigger,
   Button,
-  Dialog,
   Heading,
   Content,
 } from "@react-spectrum/s2";
@@ -184,12 +183,11 @@ exports[`Static - Renames Item to MenuItem, Section to MenuSection 1`] = `
 "import {
   MenuItem,
   MenuSection,
+  Header as Header1,
   Menu,
   MenuTrigger,
   SubmenuTrigger,
   Button,
-  Header,
-  Heading,
 } from "@react-spectrum/s2";
 <div>
   <MenuTrigger>
@@ -205,7 +203,7 @@ exports[`Static - Renames Item to MenuItem, Section to MenuSection 1`] = `
           <MenuItem>Email</MenuItem>
         </Menu>
       </SubmenuTrigger>
-      <MenuSection><Header>Section heading</Header>
+      <MenuSection><Header1>Section heading</Header1>
         <MenuItem>Save</MenuItem>
       </MenuSection>
     </Menu>
@@ -217,12 +215,11 @@ exports[`Static - Renames key to id 1`] = `
 "import {
   MenuItem,
   MenuSection,
+  Header as Header1,
   Menu,
   MenuTrigger,
   SubmenuTrigger,
   Button,
-  Header,
-  Heading,
 } from "@react-spectrum/s2";
 <div>
   <MenuTrigger>
@@ -238,7 +235,7 @@ exports[`Static - Renames key to id 1`] = `
           <MenuItem id="email">Email</MenuItem>
         </Menu>
       </SubmenuTrigger>
-      <MenuSection><Header>Section heading</Header>
+      <MenuSection><Header1>Section heading</Header1>
         <MenuItem id="save">Save</MenuItem>
       </MenuSection>
     </Menu>
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/picker.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/picker.test.ts.snap
index d244b730bc7..29264af6bb8 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/picker.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/picker.test.ts.snap
@@ -140,7 +140,7 @@ let props = {validationState: 'invalid'};
 `;
 
 exports[`handles sections 1`] = `
-"import { PickerSection, PickerItem, Picker } from "@react-spectrum/s2";
+"import { PickerSection, Header, PickerItem, Picker } from "@react-spectrum/s2";
 <Picker>
   <PickerSection><Header>Section title</Header>
     <PickerItem>Item one</PickerItem>
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap
index d811c3d3a11..890842abf47 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/subset.test.ts.snap
@@ -11,7 +11,7 @@ exports[`Should not update components that are not provided to --components opti
 `;
 
 exports[`Should only update ComboBox related shared components provided to --components option 1`] = `
-"import { ComboBoxSection, ComboBoxItem, ComboBox } from "@react-spectrum/s2";
+"import { ComboBoxSection, Header, ComboBoxItem, ComboBox } from "@react-spectrum/s2";
 import { Menu, MenuTrigger, Button, Section, Item } from '@adobe/react-spectrum';
 
 <>
@@ -75,6 +75,7 @@ exports[`Should update Menu related components provided to --components option 1
   ContextualHelpPopover,
   MenuItem,
   MenuSection,
+  Header,
   Menu,
   MenuTrigger,
   SubmenuTrigger,
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
index 82a8a9fa7ed..f371ba744b6 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
@@ -1,5 +1,5 @@
 /* eslint-disable max-depth */
-import {addComment, getName} from './shared/utils';
+import {addComment, getName, removeUnusedImports} from './shared/utils';
 import {API, FileInfo} from 'jscodeshift';
 import {getComponents} from '../getComponents';
 import {iconMap} from './icons/iconMap';
@@ -188,8 +188,12 @@ export default function transformer(file: FileInfo, api: API, options: Options):
   let elements: [string, NodePath<t.JSXElement>][] = [];
   let lastImportPath: NodePath<t.ImportDeclaration> | null = null;
   let iconImports: Map<string, {path: NodePath<t.ImportDeclaration>, newName: string | null}> = new Map();
+  let programPath: NodePath<t.Program> | null = null;
   const leadingComments = root.find(j.Program).get('body', 0).node.leadingComments;
   traverse(root.paths()[0].node, {
+    Program(path) {
+      programPath = path;
+    },
     ImportDeclaration(path) {
       if (path.node.source.value === '@adobe/react-spectrum' || (path.node.source.value.startsWith('@react-spectrum/') && path.node.source.value !== '@react-spectrum/s2')) {
         lastImportPath = path;
@@ -456,6 +460,10 @@ export default function transformer(file: FileInfo, api: API, options: Options):
     });
   }
 
+  if (programPath) {
+    removeUnusedImports(programPath, ['@react-spectrum/s2']);
+  }
+
   root.find(j.Program).get('body', 0).node.comments = leadingComments;
   return root.toSource().replace(/assert\s*\{\s*type:\s*"macro"\s*\}/g, 'with { type: "macro" }');
 }
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/transforms.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/transforms.ts
index ea758136c24..d0cf4f5e5c1 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/transforms.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/transforms.ts
@@ -533,6 +533,7 @@ export function movePropToNewChildComponentName(
     getName(path, path.parentPath.node.openingElement.name) === parentComponentName
   ) {
     let propValue: t.JSXAttribute['value'] | void;
+    let localName = newChildComponentName;
     path.node.openingElement.attributes =
       path.node.openingElement.attributes.filter((attr) => {
         if (t.isJSXAttribute(attr) && attr.name.name === propName) {
@@ -543,10 +544,14 @@ export function movePropToNewChildComponentName(
       });
 
     if (propValue) {
+      if (availableComponents.has(newChildComponentName)) {
+        let program = path.findParent((p) => t.isProgram(p.node)) as NodePath<t.Program>;
+        localName = addComponentImport(program, newChildComponentName);
+      }
       path.node.children.unshift(
         t.jsxElement(
-          t.jsxOpeningElement(t.jsxIdentifier(newChildComponentName), []),
-          t.jsxClosingElement(t.jsxIdentifier(newChildComponentName)),
+          t.jsxOpeningElement(t.jsxIdentifier(localName), []),
+          t.jsxClosingElement(t.jsxIdentifier(localName)),
           [t.isStringLiteral(propValue) ? t.jsxText(propValue.value) : propValue]
         )
       );
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
index eda7991251e..7e198d4b530 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/shared/utils.ts
@@ -152,7 +152,7 @@ export function removeComponentImportIfUnused(path: NodePath<t.Program>, compone
     return t.isImportDeclaration(node)
       && (
         node.source.value === '@adobe/react-spectrum'
-        || (node.source.value.startsWith('@react-spectrum/') && node.source.value !== '@react-spectrum/s2')
+        || node.source.value.startsWith('@react-spectrum/')
       );
   });
 
@@ -178,6 +178,35 @@ export function removeComponentImportIfUnused(path: NodePath<t.Program>, compone
   }
 }
 
+export function removeUnusedImports(path: NodePath<t.Program>, sources: string[]): void {
+  path.scope.crawl();
+
+  let sourceSet = new Set(sources);
+  let imports = path.node.body.filter((node): node is t.ImportDeclaration => {
+    return t.isImportDeclaration(node) && sourceSet.has(node.source.value);
+  });
+
+  for (let importDecl of imports) {
+    let previousLength = importDecl.specifiers.length;
+    importDecl.specifiers = importDecl.specifiers.filter((specifier) => {
+      if (
+        t.isImportSpecifier(specifier)
+        || t.isImportDefaultSpecifier(specifier)
+        || t.isImportNamespaceSpecifier(specifier)
+      ) {
+        let binding = path.scope.getBinding(specifier.local.name);
+        return !!binding?.referencePaths.length;
+      }
+
+      return true;
+    });
+
+    if (importDecl.specifiers.length === 0 && previousLength > 0) {
+      path.node.body = path.node.body.filter((node) => node !== importDecl);
+    }
+  }
+}
+
 /**
  * Look up the name in path.scope and find the original binding.
  * Returns the original name even if an alias is used.

From 3e71ffb78cd749edcea553053000f55cb37dfbbc Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Mon, 9 Mar 2026 10:55:44 -0500
Subject: [PATCH 13/15] fix snapshot

---
 .../src/s1-to-s2/__tests__/__snapshots__/form.test.ts.snap     | 3 +--
 .../src/s1-to-s2/__tests__/__snapshots__/well.test.ts.snap     | 3 +--
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/form.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/form.test.ts.snap
index 5f7a67516dc..f2f8f911162 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/form.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/form.test.ts.snap
@@ -35,8 +35,7 @@ let props = {isQuiet: true};
 `;
 
 exports[`removes validationState and validationBehavior 1`] = `
-"import { TextArea } from "@react-spectrum/s2";
-let validationState = 'invalid';
+"let validationState = 'invalid';
 let validationBehavior = 'native';
 let props = {validationState: 'invalid', validationBehavior: 'native'};
 <div>
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/well.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/well.test.ts.snap
index 09bf02b3554..74450eaa09a 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/well.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/well.test.ts.snap
@@ -1,8 +1,7 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`Updates Well to be div with style macro 1`] = `
-"import { Well } from "@react-spectrum/s2";
-import { style } from "@react-spectrum/s2/style" with { type: "macro" };
+"import { style } from "@react-spectrum/s2/style" with { type: "macro" };
 
 <div>
   <div

From 83b52c6254200579e20256156a412934e2420b2d Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Mon, 9 Mar 2026 10:57:38 -0500
Subject: [PATCH 14/15] yarn.lock

---
 yarn.lock | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/yarn.lock b/yarn.lock
index 5f861ca31af..036d6a3ce3a 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -88,7 +88,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@adobe/react-spectrum@npm:^3.46.1, @adobe/react-spectrum@workspace:packages/@adobe/react-spectrum":
+"@adobe/react-spectrum@npm:^3.46.2, @adobe/react-spectrum@workspace:packages/@adobe/react-spectrum":
   version: 0.0.0-use.local
   resolution: "@adobe/react-spectrum@workspace:packages/@adobe/react-spectrum"
   dependencies:
@@ -6648,7 +6648,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@react-spectrum/codemods@workspace:packages/dev/codemods"
   dependencies:
-    "@adobe/react-spectrum": "npm:^3.46.1"
+    "@adobe/react-spectrum": "npm:^3.46.2"
     "@babel/parser": "npm:^7.24.5"
     "@babel/traverse": "npm:^7.24.5"
     "@babel/types": "npm:^7.24.5"

From 62a60ab7b75cafa7b4087e32f94064371e056102 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Tue, 10 Mar 2026 10:29:47 -0500
Subject: [PATCH 15/15] map illustrations to s2 illustrations

---
 .../__snapshots__/dropzone.test.ts.snap       |  4 +-
 .../illustratedmessage.test.ts.snap           | 19 ++++++--
 .../src/s1-to-s2/__tests__/dropzone.test.ts   |  2 +-
 .../__tests__/illustratedmessage.test.ts      | 15 +++++-
 .../src/s1-to-s2/src/codemods/codemod.ts      | 46 +++++++++++++++++++
 .../codemods/illustrations/illustrationMap.ts | 11 +++++
 6 files changed, 90 insertions(+), 7 deletions(-)
 create mode 100644 packages/dev/codemods/src/s1-to-s2/src/codemods/illustrations/illustrationMap.ts

diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dropzone.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dropzone.test.ts.snap
index 9d29d6ecc5a..512bd382394 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dropzone.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/dropzone.test.ts.snap
@@ -1,8 +1,8 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`Does nothing 1`] = `
+exports[`Rewrites illustration import to S2 1`] = `
 "import { DropZone, IllustratedMessage, Heading } from "@react-spectrum/s2";
-import Upload from '@spectrum-icons/illustrations/Upload';
+import Upload from "@react-spectrum/s2/illustrations/linear/Upload";
 
 <div>
   <DropZone>
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/illustratedmessage.test.ts.snap b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/illustratedmessage.test.ts.snap
index d13016d6fc2..c901dba63a6 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/illustratedmessage.test.ts.snap
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/__snapshots__/illustratedmessage.test.ts.snap
@@ -1,14 +1,27 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`Does nothing 1`] = `
+exports[`Rewrites illustration import to S2 with name change 1`] = `
 "import { IllustratedMessage, Heading, Content } from "@react-spectrum/s2";
-import NotFound from '@spectrum-icons/illustrations/NotFound';
+import NoSearchResults from "@react-spectrum/s2/illustrations/linear/NoSearchResults";
 
 <div>
   <IllustratedMessage>
-    <NotFound />
+    <NoSearchResults />
     <Heading>No results</Heading>
     <Content>Try another search</Content>
   </IllustratedMessage>
 </div>"
 `;
+
+exports[`Rewrites illustration import to S2 with same name 1`] = `
+"import { IllustratedMessage, Heading, Content } from "@react-spectrum/s2";
+import Upload from "@react-spectrum/s2/illustrations/linear/Upload";
+
+<div>
+  <IllustratedMessage>
+    <Upload />
+    <Heading>Upload a file</Heading>
+    <Content>Drag and drop to upload</Content>
+  </IllustratedMessage>
+</div>"
+`;
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/dropzone.test.ts b/packages/dev/codemods/src/s1-to-s2/__tests__/dropzone.test.ts
index 64d1739f139..27bccfa1c57 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/dropzone.test.ts
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/dropzone.test.ts
@@ -6,7 +6,7 @@ const test = (name: string, input: string) => {
   defineSnapshotTest(transform, {}, input, name);
 };
 
-test('Does nothing', `
+test('Rewrites illustration import to S2', `
 import {DropZone, IllustratedMessage, Heading} from '@adobe/react-spectrum';
 import Upload from '@spectrum-icons/illustrations/Upload';
 
diff --git a/packages/dev/codemods/src/s1-to-s2/__tests__/illustratedmessage.test.ts b/packages/dev/codemods/src/s1-to-s2/__tests__/illustratedmessage.test.ts
index e9fdda91f01..dd5f3395cf0 100644
--- a/packages/dev/codemods/src/s1-to-s2/__tests__/illustratedmessage.test.ts
+++ b/packages/dev/codemods/src/s1-to-s2/__tests__/illustratedmessage.test.ts
@@ -6,7 +6,7 @@ const test = (name: string, input: string) => {
   defineSnapshotTest(transform, {}, input, name);
 };
 
-test('Does nothing', `
+test('Rewrites illustration import to S2 with name change', `
 import {IllustratedMessage, Heading, Content} from '@adobe/react-spectrum';
 import NotFound from '@spectrum-icons/illustrations/NotFound';
 
@@ -18,3 +18,16 @@ import NotFound from '@spectrum-icons/illustrations/NotFound';
   </IllustratedMessage>
 </div>
 `);
+
+test('Rewrites illustration import to S2 with same name', `
+import {IllustratedMessage, Heading, Content} from '@adobe/react-spectrum';
+import Upload from '@spectrum-icons/illustrations/Upload';
+
+<div>
+  <IllustratedMessage>
+    <Upload />
+    <Heading>Upload a file</Heading>
+    <Content>Drag and drop to upload</Content>
+  </IllustratedMessage>
+</div>
+`);
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
index f371ba744b6..6f87c34027b 100644
--- a/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/codemod.ts
@@ -3,6 +3,7 @@ import {addComment, getName, removeUnusedImports} from './shared/utils';
 import {API, FileInfo} from 'jscodeshift';
 import {getComponents} from '../getComponents';
 import {iconMap} from './icons/iconMap';
+import {illustrationMap} from './illustrations/illustrationMap';
 import {parse as recastParse} from 'recast';
 import * as t from '@babel/types';
 import transformStyleProps from './shared/styleProps';
@@ -188,6 +189,7 @@ export default function transformer(file: FileInfo, api: API, options: Options):
   let elements: [string, NodePath<t.JSXElement>][] = [];
   let lastImportPath: NodePath<t.ImportDeclaration> | null = null;
   let iconImports: Map<string, {path: NodePath<t.ImportDeclaration>, newName: string | null}> = new Map();
+  let illustrationImports: Map<string, {path: NodePath<t.ImportDeclaration>, newName: string | null}> = new Map();
   let programPath: NodePath<t.Program> | null = null;
   const leadingComments = root.find(j.Program).get('body', 0).node.leadingComments;
   traverse(root.paths()[0].node, {
@@ -277,6 +279,21 @@ export default function transformer(file: FileInfo, api: API, options: Options):
         } else {
           iconImports.set(localName, {path, newName: null});
         }
+      } else if (path.node.source.value.startsWith('@spectrum-icons/illustrations/')) {
+        let illustrationName = path.node.source.value.split('/').pop();
+        if (!illustrationName) {return;}
+
+        let specifier = path.node.specifiers[0];
+        if (!specifier || !t.isImportDefaultSpecifier(specifier)) {return;}
+
+        let localName = specifier.local.name;
+
+        if (illustrationMap.has(illustrationName)) {
+          let newIllustrationName = illustrationMap.get(illustrationName)!;
+          illustrationImports.set(localName, {path, newName: newIllustrationName});
+        } else {
+          illustrationImports.set(localName, {path, newName: null});
+        }
       }
     },
     Import(path) {
@@ -307,6 +324,12 @@ export default function transformer(file: FileInfo, api: API, options: Options):
           addComment(path.node, ` TODO(S2-upgrade): A Spectrum 2 equivalent to '${name.name}' was not found. Please update this icon manually.`);
         }
       }
+      if (t.isJSXIdentifier(name) && illustrationImports.has(name.name)) {
+        let illustrationInfo = illustrationImports.get(name.name)!;
+        if (illustrationInfo.newName === null) {
+          addComment(path.node, ` TODO(S2-upgrade): A Spectrum 2 equivalent to '${name.name}' was not found. Please update this illustration manually.`);
+        }
+      }
     }
   });
 
@@ -336,6 +359,29 @@ export default function transformer(file: FileInfo, api: API, options: Options):
     }
   });
 
+  illustrationImports.forEach((illustrationInfo, localName) => {
+    let {path, newName} = illustrationInfo;
+    if (newName) {
+      let newImportSource = `@react-spectrum/s2/illustrations/linear/${newName}`;
+
+      let newLocalName = localName;
+      if (localName === path.node.source.value.split('/').pop() && localName !== newName) {
+        let binding = path.scope.getBinding(localName);
+        if (binding && !path.scope.hasBinding(newName)) {
+          newLocalName = newName;
+          binding.referencePaths.forEach(refPath => {
+            if (t.isJSXIdentifier(refPath.node)) {
+              refPath.node.name = newName;
+            }
+          });
+        }
+      }
+
+      path.node.source = t.stringLiteral(newImportSource);
+      path.node.specifiers = [t.importDefaultSpecifier(t.identifier(newLocalName))];
+    }
+  });
+
   let hasMacros = false;
   let usedLightDark = false;
   elements.forEach(([elementName, path]) => {
diff --git a/packages/dev/codemods/src/s1-to-s2/src/codemods/illustrations/illustrationMap.ts b/packages/dev/codemods/src/s1-to-s2/src/codemods/illustrations/illustrationMap.ts
new file mode 100644
index 00000000000..4983c94a419
--- /dev/null
+++ b/packages/dev/codemods/src/s1-to-s2/src/codemods/illustrations/illustrationMap.ts
@@ -0,0 +1,11 @@
+export const illustrationMap: Map<string, string> = new Map([
+  ['Error', 'Error'],
+  ['File', 'Document'],
+  ['Folder', 'FolderClose'],
+  ['NoSearchResults', 'NoSearchResults'],
+  ['NotFound', 'NoSearchResults'],
+  ['Timeout', 'Clock'],
+  ['Unauthorized', 'LockClose'],
+  ['Unavailable', 'Error'],
+  ['Upload', 'Upload']
+]);