@astryxdesign/cli 0.1.8-canary.0c4d8d7 → 0.1.8-canary.0db5dfd

package/{src/codemods → codemods}/transforms/v0.0.12/add-is-icon-only.mjs

@@ -50,6 +50,11 @@ export const meta = {
   pr: '#1321',
 };
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
@@ -61,7 +66,7 @@ export default function transformer(file, api) {
   // Uses direct body manipulation instead of jscodeshift's insertAfter(),
   // which has a known bug that corrupts 'use client' directives into
   // double semicolons ('use client';;).
-  function insertAfterInBody(targetPath, newNode) {
+  function insertAfterInBody(/** @type {any} */ targetPath, /** @type {any} */ newNode) {
     const body = root.get().node.program.body;
     const targetIndex = body.indexOf(targetPath.node);
     if (targetIndex !== -1) {
@@ -69,14 +74,14 @@ export default function transformer(file, api) {
     } else {
       // Fallback: insert after all imports
       const lastImportIdx = body.findLastIndex(
-        (n) => n.type === 'ImportDeclaration',
+        (/** @type {any} */ n) => n.type === 'ImportDeclaration',
       );
       body.splice(lastImportIdx + 1, 0, newNode);
     }
   }
 
   // ---- 1. JSX elements: convert icon-only XDSButton to XDSIconButton ----
-  root.find(j.JSXOpeningElement).forEach((path) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     const componentName =
       name.type === 'JSXIdentifier' ? name.name : null;
@@ -85,13 +90,13 @@ export default function transformer(file, api) {
     const attrs = path.node.attributes;
 
     const hasIcon = attrs.some(
-      (a) => a.type === 'JSXAttribute' && a.name?.name === 'icon',
+      (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name?.name === 'icon',
     );
     const hasChildren = attrs.some(
-      (a) => a.type === 'JSXAttribute' && a.name?.name === 'children',
+      (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name?.name === 'children',
     );
     const hasIsIconOnly = attrs.some(
-      (a) => a.type === 'JSXAttribute' && a.name?.name === 'isIconOnly',
+      (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name?.name === 'isIconOnly',
     );
 
     if (!hasIcon || hasChildren || hasIsIconOnly) return;
@@ -101,7 +106,7 @@ export default function transformer(file, api) {
     const hasJSXChildren =
       parent.type === 'JSXElement' &&
       parent.children &&
-      parent.children.some((child) => {
+      parent.children.some((/** @type {any} */ child) => {
         if (child.type === 'JSXText') return child.value.trim() !== '';
         return true;
       });
@@ -128,7 +133,7 @@ export default function transformer(file, api) {
   });
 
   // ---- 2. Remove redundant children that match label ----
-  root.find(j.JSXElement).forEach((path) => {
+  root.find(j.JSXElement).forEach((/** @type {any} */ path) => {
     const opening = path.node.openingElement;
     const name = opening.name;
     const componentName =
@@ -137,13 +142,13 @@ export default function transformer(file, api) {
 
     const attrs = opening.attributes;
     const hasIcon = attrs.some(
-      (a) => a.type === 'JSXAttribute' && a.name?.name === 'icon',
+      (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name?.name === 'icon',
     );
     if (!hasIcon) return;
 
     // Get label value
     const labelAttr = attrs.find(
-      (a) => a.type === 'JSXAttribute' && a.name?.name === 'label',
+      (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name?.name === 'label',
     );
     if (!labelAttr || !labelAttr.value) return;
 
@@ -177,7 +182,7 @@ export default function transformer(file, api) {
   });
 
   // ---- 3. Object literals: add isIconOnly to button config objects ----
-  root.find(j.JSXOpeningElement).forEach((path) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     const componentName =
       name.type === 'JSXIdentifier' ? name.name : null;
@@ -185,7 +190,7 @@ export default function transformer(file, api) {
 
     const attrs = path.node.attributes;
     const buttonAttr = attrs.find(
-      (a) =>
+      (/** @type {any} */ a) =>
         a.type === 'JSXAttribute' &&
         a.name?.name === 'button' &&
         a.value?.type === 'JSXExpressionContainer' &&
@@ -197,13 +202,13 @@ export default function transformer(file, api) {
     const props = obj.properties;
 
     const hasIcon = props.some(
-      (p) => (p.type === 'Property' || p.type === 'ObjectProperty') && p.key?.name === 'icon',
+      (/** @type {any} */ p) => (p.type === 'Property' || p.type === 'ObjectProperty') && p.key?.name === 'icon',
     );
     const hasChildren = props.some(
-      (p) => (p.type === 'Property' || p.type === 'ObjectProperty') && p.key?.name === 'children',
+      (/** @type {any} */ p) => (p.type === 'Property' || p.type === 'ObjectProperty') && p.key?.name === 'children',
     );
     const hasIsIconOnly = props.some(
-      (p) => (p.type === 'Property' || p.type === 'ObjectProperty') && p.key?.name === 'isIconOnly',
+      (/** @type {any} */ p) => (p.type === 'Property' || p.type === 'ObjectProperty') && p.key?.name === 'isIconOnly',
     );
 
     if (hasIcon && !hasChildren && !hasIsIconOnly) {
@@ -222,7 +227,7 @@ export default function transformer(file, api) {
     hasRemainingXDSButton = true;
   });
   // Also check for XDSButton in type annotations (e.g. typeof XDSButton)
-  root.find(j.Identifier, {name: 'XDSButton'}).forEach((path) => {
+  root.find(j.Identifier, {name: 'XDSButton'}).forEach((/** @type {any} */ path) => {
     // Skip JSX identifiers (already counted above) and import specifiers
     if (path.parent.node.type === 'JSXOpeningElement' ||
         path.parent.node.type === 'JSXClosingElement' ||
@@ -232,9 +237,9 @@ export default function transformer(file, api) {
 
   if (needsIconButtonImport) {
     let alreadyImported = false;
-    root.find(j.ImportDeclaration).forEach((path) => {
+    root.find(j.ImportDeclaration).forEach((/** @type {any} */ path) => {
       if (path.node.specifiers.some(
-        (s) => s.type === 'ImportSpecifier' && s.imported.name === 'XDSIconButton',
+        (/** @type {any} */ s) => s.type === 'ImportSpecifier' && s.imported.name === 'XDSIconButton',
       )) {
         alreadyImported = true;
       }
@@ -244,13 +249,13 @@ export default function transformer(file, api) {
       // Handle @xds/core/Button import — may need splitting if it has
       // other specifiers (type imports, other components)
       if (!hasRemainingXDSButton) {
-        root.find(j.ImportDeclaration).forEach((path) => {
+        root.find(j.ImportDeclaration).forEach((/** @type {any} */ path) => {
           if (alreadyImported) return;
           const source = path.node.source.value;
           if (source !== '@xds/core/Button') return;
           const specs = path.node.specifiers;
           const btnIdx = specs.findIndex(
-            (s) => s.type === 'ImportSpecifier' && s.imported.name === 'XDSButton',
+            (/** @type {any} */ s) => s.type === 'ImportSpecifier' && s.imported.name === 'XDSButton',
           );
           if (btnIdx === -1) return;
 
@@ -276,7 +281,7 @@ export default function transformer(file, api) {
 
       // For barrel imports, add the specifier
       if (!alreadyImported) {
-        root.find(j.ImportDeclaration).forEach((path) => {
+        root.find(j.ImportDeclaration).forEach((/** @type {any} */ path) => {
           if (alreadyImported) return;
           if (path.node.source.value === '@xds/core') {
             path.node.specifiers.push(
@@ -296,7 +301,7 @@ export default function transformer(file, api) {
 
         const xdsImports = root
           .find(j.ImportDeclaration)
-          .filter((p) => p.node.source.value.startsWith('@xds/'));
+          .filter((/** @type {any} */ p) => p.node.source.value.startsWith('@xds/'));
 
         if (xdsImports.length > 0) {
           insertAfterInBody(xdsImports.at(-1), newImport);

package/{src/codemods → codemods}/transforms/v0.0.13/icon-name-deprecations.mjs

@@ -23,6 +23,7 @@ export const meta = {
   pr: '#1503',
 };
 
+/** @type {Record<string, string>} */
 const RENAMES = {
   checkCircle: 'success',
   xCircle: 'error',
@@ -31,13 +32,18 @@ const RENAMES = {
 /** Prop names that accept XDSIconName values */
 const ICON_PROPS = new Set(['icon', 'name', 'selectedIcon']);
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
   let hasChanges = false;
 
   // Helper: rename a string literal node if it matches a deprecated name
-  function renameStringLiteral(node) {
+  function renameStringLiteral(/** @type {any} */ node) {
     if (!node) return false;
     if (node.type === 'StringLiteral' || node.type === 'Literal') {
       const newName = RENAMES[node.value];
@@ -51,7 +57,8 @@ export default function transformer(file, api) {
   }
 
   // Helper: recursively rename deprecated icon strings inside an expression
-  function renameInExpression(node) {
+  /** @returns {boolean} */
+  function renameInExpression(/** @type {any} */ node) {
     if (!node) return false;
     let changed = false;
     if (node.type === 'StringLiteral' || node.type === 'Literal') {
@@ -67,7 +74,7 @@ export default function transformer(file, api) {
   }
 
   // 1. JSX attributes: icon="checkCircle" or icon={cond ? 'checkCircle' : 'copy'}
-  root.find(j.JSXAttribute).forEach((path) => {
+  root.find(j.JSXAttribute).forEach((/** @type {any} */ path) => {
     const attrName = path.node.name?.name;
     if (!ICON_PROPS.has(attrName)) return;
 
@@ -92,7 +99,7 @@ export default function transformer(file, api) {
 
   if (looksLikeIconRegistry) {
     const PropertyType = j.ObjectProperty ?? j.Property;
-    root.find(PropertyType).forEach((path) => {
+    root.find(PropertyType).forEach((/** @type {any} */ path) => {
       const key = path.node.key;
       if (!key) return;
       const keyName =
@@ -110,7 +117,7 @@ export default function transformer(file, api) {
   // 3. String literals in objects with icon-related keys
   //    e.g. { label: "TestX", href: "/pages/testx", icon: "checkCircle" }
   const PropertyType2 = j.ObjectProperty ?? j.Property;
-  root.find(PropertyType2).forEach((path) => {
+  root.find(PropertyType2).forEach((/** @type {any} */ path) => {
     const key = path.node.key;
     const keyName = key?.type === 'Identifier' ? key.name : key?.value;
     if (!ICON_PROPS.has(keyName)) return;

package/{src/codemods → codemods}/transforms/v0.0.13/rename-attachments-to-drawer.mjs

@@ -22,15 +22,22 @@ export const meta = {
   pr: '#1714',
 };
 
+/** @type {Record<string, string>} */
 const IMPORT_RENAMES = {
   XDSChatComposerAttachments: 'XDSChatComposerDrawer',
   XDSChatComposerAttachmentsProps: 'XDSChatComposerDrawerProps',
 };
 
+/** @type {Record<string, string>} */
 const CSS_CLASS_RENAMES = {
   'xds-chat-composer-attachments': 'xds-chat-composer-drawer',
 };
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
@@ -40,7 +47,7 @@ export default function transformer(file, api) {
   const localToComponent = new Map();
 
   // --- 1. Rename imports ---
-  root.find(j.ImportSpecifier).forEach((path) => {
+  root.find(j.ImportSpecifier).forEach((/** @type {any} */ path) => {
     const importedName = path.node.imported.name;
     const newName = IMPORT_RENAMES[importedName];
     if (!newName) return;
@@ -66,7 +73,7 @@ export default function transformer(file, api) {
 
     root
       .find(j.JSXIdentifier, {name: oldName})
-      .forEach((path) => {
+      .forEach((/** @type {any} */ path) => {
         const parent = path.parent.node;
         if (
           parent.type === 'JSXOpeningElement' ||
@@ -79,7 +86,7 @@ export default function transformer(file, api) {
   }
 
   // --- 3. Rename `attachments` prop → `drawer` on XDSChatComposer ---
-  root.find(j.JSXOpeningElement).forEach((path) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     const componentName = name.type === 'JSXIdentifier' ? name.name : null;
     if (componentName !== 'XDSChatComposer') return;
@@ -97,7 +104,7 @@ export default function transformer(file, api) {
   });
 
   // --- 4. Rename type references ---
-  root.find(j.TSTypeReference).forEach((path) => {
+  root.find(j.TSTypeReference).forEach((/** @type {any} */ path) => {
     const typeName = path.node.typeName;
     if (typeName.type === 'Identifier') {
       const newName = IMPORT_RENAMES[typeName.name];
@@ -109,7 +116,7 @@ export default function transformer(file, api) {
   });
 
   // Also handle plain Identifier references (e.g. typeof, React.ComponentProps<typeof X>)
-  root.find(j.Identifier, {name: 'XDSChatComposerAttachments'}).forEach((path) => {
+  root.find(j.Identifier, {name: 'XDSChatComposerAttachments'}).forEach((/** @type {any} */ path) => {
     const parent = path.parent.node;
     if (
       parent.type === 'ImportSpecifier' ||
@@ -122,7 +129,7 @@ export default function transformer(file, api) {
     hasChanges = true;
   });
 
-  root.find(j.Identifier, {name: 'XDSChatComposerAttachmentsProps'}).forEach((path) => {
+  root.find(j.Identifier, {name: 'XDSChatComposerAttachmentsProps'}).forEach((/** @type {any} */ path) => {
     const parent = path.parent.node;
     if (parent.type === 'ImportSpecifier') return;
     path.node.name = 'XDSChatComposerDrawerProps';
@@ -130,7 +137,7 @@ export default function transformer(file, api) {
   });
 
   // --- 5. Rename CSS class strings ---
-  root.find(j.StringLiteral).forEach((path) => {
+  root.find(j.StringLiteral).forEach((/** @type {any} */ path) => {
     for (const [oldClass, newClass] of Object.entries(CSS_CLASS_RENAMES)) {
       if (path.node.value.includes(oldClass)) {
         path.node.value = path.node.value.replace(
@@ -143,7 +150,7 @@ export default function transformer(file, api) {
   });
 
   // Also check template literals
-  root.find(j.TemplateLiteral).forEach((path) => {
+  root.find(j.TemplateLiteral).forEach((/** @type {any} */ path) => {
     for (const quasi of path.node.quasis) {
       for (const [oldClass, newClass] of Object.entries(CSS_CLASS_RENAMES)) {
         if (quasi.value.raw.includes(oldClass)) {

package/{src/codemods → codemods}/transforms/v0.0.13/toolbar-density-to-size.mjs

@@ -24,17 +24,23 @@ export const meta = {
 };
 
 /** Map from old density values to new size values (null = remove prop). */
+/** @type {Record<string, string | null>} */
 const DENSITY_TO_SIZE = {
   compact: 'sm',
   default: null, // md is the default, no prop needed
 };
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
   let hasChanges = false;
 
-  root.find(j.JSXOpeningElement).forEach((path) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     const componentName =
       name.type === 'JSXIdentifier' ? name.name : null;
@@ -42,7 +48,7 @@ export default function transformer(file, api) {
 
     const attrs = path.node.attributes;
     const densityIdx = attrs.findIndex(
-      (a) => a.type === 'JSXAttribute' && a.name?.name === 'density',
+      (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name?.name === 'density',
     );
     if (densityIdx === -1) return;
 
@@ -106,7 +112,7 @@ export default function transformer(file, api) {
   if (importsToolbar) {
     // jscodeshift uses Property (default parser) or ObjectProperty (babel/tsx parser)
     const PropertyType = j.ObjectProperty ?? j.Property;
-    root.find(PropertyType, {key: {name: 'density'}}).forEach((path) => {
+    root.find(PropertyType, {key: {name: 'density'}}).forEach((/** @type {any} */ path) => {
       const value = path.node.value;
 
       // args: { density: 'compact' } → args: { size: 'sm' }
@@ -140,7 +146,7 @@ export default function transformer(file, api) {
         path.node.key = j.identifier('size');
         // Update options array if present
         const optionsProp = value.properties.find(
-          (p) => p.key?.name === 'options',
+          (/** @type {any} */ p) => p.key?.name === 'options',
         );
         if (optionsProp && optionsProp.value.type === 'ArrayExpression') {
           optionsProp.value = j.arrayExpression([

package/{src/codemods → codemods}/transforms/v0.0.14/rename-action-props.mjs

@@ -30,6 +30,7 @@ export const meta = {
  * Map of old prop names → new prop names.
  * Ordered longest-first to avoid partial matches during iteration.
  */
+/** @type {Record<string, string>} */
 const PROP_RENAMES = {
   onPressedChangeAction: 'pressedChangeAction',
   onScrollToTopAction: 'scrollToTopAction',
@@ -37,13 +38,18 @@ const PROP_RENAMES = {
   onClickAction: 'clickAction',
 };
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
   let hasChanges = false;
 
   // --- 1. Rename JSX attributes ---
-  root.find(j.JSXAttribute).forEach((path) => {
+  root.find(j.JSXAttribute).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     if (name.type !== 'JSXIdentifier') return;
 
@@ -59,7 +65,7 @@ export default function transformer(file, api) {
   // Must run before step 3 so the ObjectPattern keys are renamed first and tracked.
   const renamedBindings = new Map(); // oldLocalName → newLocalName
 
-  root.find(j.ObjectPattern).forEach((path) => {
+  root.find(j.ObjectPattern).forEach((/** @type {any} */ path) => {
     for (const prop of path.node.properties) {
       if (prop.type !== 'ObjectProperty') continue;
       const key = prop.key;
@@ -97,7 +103,7 @@ export default function transformer(file, api) {
   // --- 3. Rename object property keys (e.g. { onChangeAction: fn }) ---
   // Covers cases like useXDSImperativeAlertDialog({ onAction: ... })
   // Skips ObjectProperty inside ObjectPattern (already handled in step 2).
-  root.find(j.ObjectProperty).forEach((path) => {
+  root.find(j.ObjectProperty).forEach((/** @type {any} */ path) => {
     // Skip if inside a destructuring pattern
     if (path.parent.node.type === 'ObjectPattern') return;
 
@@ -121,7 +127,7 @@ export default function transformer(file, api) {
 
   // --- 4. Rename interface/type property signatures ---
   // Covers: interface Props { onChangeAction?: ... } → { changeAction?: ... }
-  root.find(j.TSPropertySignature).forEach((path) => {
+  root.find(j.TSPropertySignature).forEach((/** @type {any} */ path) => {
     const key = path.node.key;
     if (key.type === 'Identifier') {
       const newName = PROP_RENAMES[key.name];
@@ -136,7 +142,7 @@ export default function transformer(file, api) {
   // When { onChangeAction } was renamed to { changeAction }, all references
   // to the local variable `onChangeAction` must become `changeAction`.
   if (renamedBindings.size > 0) {
-    root.find(j.Identifier).forEach((path) => {
+    root.find(j.Identifier).forEach((/** @type {any} */ path) => {
       const newName = renamedBindings.get(path.node.name);
       if (!newName) return;
 

package/{src/codemods → codemods}/transforms/v0.0.14/rename-section-wash-to-muted.mjs

@@ -26,6 +26,11 @@ export const meta = {
 /** Components affected by this rename. */
 const TARGET_COMPONENTS = new Set(['XDSSection', 'XDSToolbar']);
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
@@ -33,12 +38,12 @@ export default function transformer(file, api) {
 
   // 1. Rename JSX attribute value: variant="wash" → variant="muted"
   //    Only on XDSSection and XDSToolbar.
-  root.find(j.JSXOpeningElement).forEach((path) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     const componentName = name.type === 'JSXIdentifier' ? name.name : null;
     if (!componentName || !TARGET_COMPONENTS.has(componentName)) return;
 
-    path.node.attributes.forEach((attr) => {
+    path.node.attributes.forEach((/** @type {any} */ attr) => {
       if (attr.type !== 'JSXAttribute') return;
       if (attr.name.name !== 'variant') return;
 
@@ -79,7 +84,7 @@ export default function transformer(file, api) {
 
   if (importsTarget) {
     const PropertyType = j.ObjectProperty ?? j.Property;
-    root.find(PropertyType, {key: {name: 'variant'}}).forEach((path) => {
+    root.find(PropertyType, {key: {name: 'variant'}}).forEach((/** @type {any} */ path) => {
       const value = path.node.value;
 
       // variant: 'wash' → variant: 'muted'
@@ -95,10 +100,10 @@ export default function transformer(file, api) {
       // variant: { options: ['...', 'wash', '...'] } → replace 'wash' with 'muted'
       if (value.type === 'ObjectExpression') {
         const optionsProp = value.properties.find(
-          (p) => p.key && p.key.name === 'options',
+          (/** @type {any} */ p) => p.key && p.key.name === 'options',
         );
         if (optionsProp && optionsProp.value.type === 'ArrayExpression') {
-          optionsProp.value.elements.forEach((el) => {
+          optionsProp.value.elements.forEach((/** @type {any} */ el) => {
             if (
               el &&
               (el.type === 'StringLiteral' || el.type === 'Literal') &&
@@ -117,7 +122,7 @@ export default function transformer(file, api) {
   // 3. JSX text children: replace "wash" text content adjacent to target components.
   //    Covers labels like <h4>wash</h4> that describe the variant in Storybook stories.
   if (importsTarget) {
-    root.find(j.JSXText).forEach((path) => {
+    root.find(j.JSXText).forEach((/** @type {any} */ path) => {
       if (path.node.value.trim() === 'wash') {
         path.node.value = path.node.value.replace('wash', 'muted');
         if (path.node.raw) path.node.raw = path.node.raw.replace('wash', 'muted');

package/{src/codemods → codemods}/transforms/v0.0.14/rename-status-variants.mjs

@@ -77,7 +77,7 @@ for (const props of COMPONENT_PROPS.values()) {
  * Check if a key matches a target prop — exact or case-insensitive suffix.
  * e.g. "dotVariant" matches because it ends with "variant".
  */
-function matchesPropName(keyName) {
+function matchesPropName(/** @type {any} */ keyName) {
   if (TARGET_PROP_NAMES.has(keyName)) return true;
   const lower = keyName.toLowerCase();
   for (const prop of TARGET_PROP_NAMES) {
@@ -86,6 +86,11 @@ function matchesPropName(keyName) {
   return false;
 }
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
@@ -96,7 +101,7 @@ export default function transformer(file, api) {
    * Unwraps TSAsExpression (e.g. 'positive' as const) to reach the literal.
    * @returns {boolean} whether a rename occurred
    */
-  function renameValue(node, {precise = false} = {}) {
+  function renameValue(/** @type {any} */ node, {precise = false} = {}) {
     if (!node) return false;
 
     // Unwrap TSAsExpression (e.g. 'positive' as const → StringLiteral)
@@ -123,11 +128,11 @@ export default function transformer(file, api) {
   /**
    * Rename elements in an array (handles TSAsExpression wrapping).
    */
-  function renameArrayElements(node, {precise = false} = {}) {
+  function renameArrayElements(/** @type {any} */ node, {precise = false} = {}) {
     let arrayNode = node;
     if (arrayNode.type === 'TSAsExpression') arrayNode = arrayNode.expression;
     if (arrayNode.type !== 'ArrayExpression') return;
-    arrayNode.elements.forEach((el) => {
+    arrayNode.elements.forEach((/** @type {any} */ el) => {
       if (renameValue(el, {precise})) hasChanges = true;
     });
   }
@@ -139,7 +144,7 @@ export default function transformer(file, api) {
   );
 
   // 1. JSX attributes on target components
-  root.find(j.JSXOpeningElement).forEach((path) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     const componentName = name.type === 'JSXIdentifier' ? name.name : null;
     if (!componentName) return;
@@ -148,14 +153,14 @@ export default function transformer(file, api) {
     // For non-target components, only check suffixed props if file imports targets
     if (!isDirectTarget && !importsTarget) return;
 
-    path.node.attributes.forEach((attr) => {
+    path.node.attributes.forEach((/** @type {any} */ attr) => {
       if (attr.type !== 'JSXAttribute') return;
       const attrName = attr.name.name;
 
       if (isDirectTarget) {
         // Direct targets: only their specific props
         const targetProps = COMPONENT_PROPS.get(componentName);
-        if (!targetProps.has(attrName)) return;
+        if (!targetProps || !targetProps.has(attrName)) return;
       } else {
         // Non-target components: suffixed prop names only
         // (e.g. dotVariant on ChangelogSection wrapping XDSStatusDot)
@@ -201,7 +206,7 @@ export default function transformer(file, api) {
   //    Handles args objects, config objects, Storybook argTypes, etc.
   if (importsTarget) {
     const PropertyType = j.ObjectProperty ?? j.Property;
-    root.find(PropertyType).forEach((path) => {
+    root.find(PropertyType).forEach((/** @type {any} */ path) => {
       const key = path.node.key;
       const keyName =
         key.type === 'Identifier'
@@ -223,7 +228,7 @@ export default function transformer(file, api) {
       // variant: { options: ['positive', 'negative', ...] }
       if (value.type === 'ObjectExpression') {
         const optionsProp = value.properties.find(
-          (p) => p.key && (p.key.name === 'options' || p.key.value === 'options'),
+          (/** @type {any} */ p) => p.key && (p.key.name === 'options' || p.key.value === 'options'),
         );
         if (optionsProp) {
           renameArrayElements(optionsProp.value);
@@ -237,7 +242,7 @@ export default function transformer(file, api) {
 
   // 3. TypeScript type references: 'positive' | 'negative' in union types
   if (importsTarget) {
-    root.find(j.TSLiteralType).forEach((path) => {
+    root.find(j.TSLiteralType).forEach((/** @type {any} */ path) => {
       const lit = path.node.literal;
       if (renameValue(lit)) hasChanges = true;
     });

package/{src/codemods → codemods}/transforms/v0.0.15/migrate-item-children-to-endcontent.mjs

@@ -30,24 +30,24 @@ export const meta = {
     'Moves trailing content on `XDSDropdownMenuItem`, `XDSContextMenuItem`, and `XDSSelectorOption` from deprecated `children` usage to the `endContent` prop.',
 };
 
-function isWhitespaceText(node) {
+function isWhitespaceText(/** @type {any} */ node) {
   return node.type === 'JSXText' && node.value.trim() === '';
 }
 
-function isEmptyExpression(node) {
+function isEmptyExpression(/** @type {any} */ node) {
   return (
     node.type === 'JSXExpressionContainer' &&
     node.expression.type === 'JSXEmptyExpression'
   );
 }
 
-function getMeaningfulChildren(children) {
+function getMeaningfulChildren(/** @type {any} */ children) {
   return children.filter(
-    child => !isWhitespaceText(child) && !isEmptyExpression(child),
+    (/** @type {any} */ child) => !isWhitespaceText(child) && !isEmptyExpression(child),
   );
 }
 
-function createEndContentValue(j, children) {
+function createEndContentValue(/** @type {any} */ j, /** @type {any} */ children) {
   if (children.length === 0) {
     return null;
   }
@@ -74,18 +74,23 @@ function createEndContentValue(j, children) {
   );
 }
 
-function getJSXAttribute(openingElement, name) {
+function getJSXAttribute(/** @type {any} */ openingElement, /** @type {any} */ name) {
   return openingElement.attributes.find(
-    attr => attr.type === 'JSXAttribute' && attr.name.name === name,
+    (/** @type {any} */ attr) => attr.type === 'JSXAttribute' && attr.name.name === name,
   );
 }
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @param {import('../../../types/codemod').CodemodTransformApi} api
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file, api) {
   const j = api.jscodeshift;
   const root = j(file.source);
   let hasChanges = false;
 
-  root.find(j.JSXElement).forEach(path => {
+  root.find(j.JSXElement).forEach((/** @type {any} */ path) => {
       const elementName = path.node.openingElement.name;
       if (
         elementName.type !== 'JSXIdentifier' ||