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

package/{src/codemods → codemods}/transforms/v0.0.15/migrate-selector-children-to-render-option.mjs

@@ -27,7 +27,7 @@ export const meta = {
 
 const COMPONENTS = new Set(['XDSSelector', 'XDSMultiSelector']);
 
-function isXDSCoreSource(source) {
+function isXDSCoreSource(/** @type {any} */ source) {
   return (
     source === '@xds/core' ||
     source === '@xds/core/Selector' ||
@@ -35,7 +35,7 @@ function isXDSCoreSource(source) {
   );
 }
 
-function sourceCanImport(source, importedName) {
+function sourceCanImport(/** @type {any} */ source, /** @type {any} */ importedName) {
   if (source === '@xds/core') {
     return COMPONENTS.has(importedName);
   }
@@ -48,11 +48,11 @@ function sourceCanImport(source, importedName) {
   return false;
 }
 
-function collectSelectorNames(root, j) {
+function collectSelectorNames(/** @type {any} */ root, /** @type {any} */ j) {
   const localNames = new Map();
   const namespaceNames = new Set();
 
-  root.find(j.ImportDeclaration).forEach(path => {
+  root.find(j.ImportDeclaration).forEach((/** @type {any} */ path) => {
     const source = path.node.source.value;
     if (typeof source !== 'string' || !isXDSCoreSource(source)) {
       return;
@@ -80,7 +80,7 @@ function collectSelectorNames(root, j) {
   return {localNames, namespaceNames};
 }
 
-function getComponentName(name, localNames, namespaceNames) {
+function getComponentName(/** @type {any} */ name, /** @type {any} */ localNames, /** @type {any} */ namespaceNames) {
   if (name.type === 'JSXIdentifier') {
     return localNames.get(name.name) ?? null;
   }
@@ -98,24 +98,24 @@ function getComponentName(name, localNames, namespaceNames) {
   return null;
 }
 
-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 isRenderableExpression(expression) {
+function isRenderableExpression(/** @type {any} */ expression) {
   return (
     expression.type === 'ArrowFunctionExpression' ||
     expression.type === 'FunctionExpression' ||
@@ -124,12 +124,17 @@ function isRenderableExpression(expression) {
   );
 }
 
-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);
@@ -140,7 +145,7 @@ export default function transformer(file, api) {
     return undefined;
   }
 
-  root.find(j.JSXElement).forEach(path => {
+  root.find(j.JSXElement).forEach((/** @type {any} */ path) => {
     const componentName = getComponentName(
       path.node.openingElement.name,
       localNames,

package/{src/codemods → codemods}/transforms/v0.0.15/migrate-theme-selectors-to-data-attrs.mjs

@@ -104,11 +104,11 @@ const SECTION_VARIANTS = new Set(['section', 'transparent', 'muted']);
 const DIVIDER_VARIANTS = new Set(['subtle', 'strong']);
 const ORIENTATIONS = new Set(['horizontal', 'vertical']);
 
-function attr(name, value) {
+function attr(/** @type {any} */ name, /** @type {any} */ value) {
   return `[data-${name}="${value}"]`;
 }
 
-function valueToAttr(component, value) {
+function valueToAttr(/** @type {any} */ component, /** @type {any} */ value) {
   // Numeric-prefixed classes emitted as prop-value (level-2, gap-4, cols-3).
   let match = value.match(/^level-(\d+)$/);
   if (match) return attr('level', match[1]);
@@ -211,8 +211,8 @@ function valueToAttr(component, value) {
 
 const SELECTOR_RE = /\.((?:xds-[a-z0-9-]+))(\.(?:-?[_a-zA-Z][_a-zA-Z0-9-]*))+/g;
 
-export function migrateThemeSelectors(source) {
-  return source.replace(SELECTOR_RE, (full, component) => {
+export function migrateThemeSelectors(/** @type {any} */ source) {
+  return source.replace(SELECTOR_RE, (/** @type {any} */ full, /** @type {any} */ component) => {
     const classChain = full.slice(component.length + 1);
     const values = classChain.split('.').filter(Boolean);
 
@@ -229,6 +229,10 @@ export function migrateThemeSelectors(source) {
   });
 }
 
+/**
+ * @param {import('../../../types/codemod').AstryxCodemodFile} file
+ * @returns {string | null | undefined}
+ */
 export default function transformer(file) {
   const result = migrateThemeSelectors(file.source);
   return result === file.source ? undefined : result;

package/{src/codemods → codemods}/transforms/v0.0.15/rename-date-picker-to-input.mjs

@@ -45,13 +45,18 @@ const IDENTIFIER_RENAMES = new Map([
   ['XDSDateRangePickerStatusType', 'XDSDateRangeInputStatusType'],
 ]);
 
+/**
+ * @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 import/export source paths
-  root.find(j.ImportDeclaration).forEach((path) => {
+  root.find(j.ImportDeclaration).forEach((/** @type {any} */ path) => {
     const source = path.node.source.value;
     const renamed = IMPORT_PATH_RENAMES.get(source);
     if (renamed) {
@@ -60,7 +65,7 @@ export default function transformer(file, api) {
     }
   });
 
-  root.find(j.ExportNamedDeclaration).forEach((path) => {
+  root.find(j.ExportNamedDeclaration).forEach((/** @type {any} */ path) => {
     if (path.node.source) {
       const source = path.node.source.value;
       const renamed = IMPORT_PATH_RENAMES.get(source);
@@ -72,7 +77,7 @@ export default function transformer(file, api) {
   });
 
   // 2. Rename all identifiers (covers imports, type refs, variable names)
-  root.find(j.Identifier).forEach((path) => {
+  root.find(j.Identifier).forEach((/** @type {any} */ path) => {
     const renamed = IDENTIFIER_RENAMES.get(path.node.name);
     if (renamed) {
       path.node.name = renamed;
@@ -81,7 +86,7 @@ export default function transformer(file, api) {
   });
 
   // 3. Rename JSX element names
-  root.find(j.JSXIdentifier).forEach((path) => {
+  root.find(j.JSXIdentifier).forEach((/** @type {any} */ path) => {
     const renamed = IDENTIFIER_RENAMES.get(path.node.name);
     if (renamed) {
       path.node.name = renamed;
@@ -90,7 +95,7 @@ export default function transformer(file, api) {
   });
 
   // 4. Rename string literals (covers displayName assignments)
-  root.find(j.StringLiteral).forEach((path) => {
+  root.find(j.StringLiteral).forEach((/** @type {any} */ path) => {
     const renamed = IDENTIFIER_RENAMES.get(path.node.value);
     if (renamed) {
       path.node.value = renamed;
@@ -99,7 +104,7 @@ export default function transformer(file, api) {
   });
 
   // Also handle Literal nodes (parser-dependent)
-  root.find(j.Literal).forEach((path) => {
+  root.find(j.Literal).forEach((/** @type {any} */ path) => {
     if (typeof path.node.value === 'string') {
       const renamed = IDENTIFIER_RENAMES.get(path.node.value);
       if (renamed) {

package/{src/codemods → codemods}/transforms/v0.0.15/rename-imperative-ref-to-handleRef.mjs

@@ -29,12 +29,17 @@ const IMPERATIVE_REF_COMPONENTS = new Set([
   'XDSChartStreamGL',
 ]);
 
+/**
+ * @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;
     if (componentName == null) return;

package/{src/codemods → codemods}/transforms/v0.0.15/rename-isStreaming-to-isStopShown.mjs

@@ -26,13 +26,18 @@ export const meta = {
 
 const TARGET_COMPONENTS = new Set(['XDSChatComposer', 'XDSChatSendButton']);
 
+/**
+ * @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;
 
   // Rename JSX prop on target components only
-  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 (!TARGET_COMPONENTS.has(componentName)) return;

package/{src/codemods → codemods}/transforms/v0.0.15/rename-stack-element-to-as.mjs

@@ -17,6 +17,11 @@ const TARGET_COMPONENTS = new Set([
   'XDSStackItem',
 ]);
 
+/**
+ * @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);
@@ -24,12 +29,12 @@ export default function transformer(file, api) {
 
   root
     .find(j.JSXOpeningElement)
-    .filter((path) => {
+    .filter((/** @type {any} */ path) => {
       const name = path.node.name;
       return name.type === 'JSXIdentifier' && TARGET_COMPONENTS.has(name.name);
     })
-    .forEach((path) => {
-      path.node.attributes.forEach((attr) => {
+    .forEach((/** @type {any} */ path) => {
+      path.node.attributes.forEach((/** @type {any} */ attr) => {
         if (attr.type === 'JSXAttribute' && attr.name.name === 'element') {
           attr.name.name = 'as';
           hasChanges = true;

package/{src/codemods → codemods}/transforms/v0.0.2/migrate-badge-dot-to-statusdot.mjs

@@ -15,6 +15,7 @@ export const meta = {
   pr: '#945',
 };
 
+/** @type {Record<string, string>} */
 const VARIANT_MAP = {
   success: 'positive',
   error: 'negative',
@@ -23,12 +24,12 @@ const VARIANT_MAP = {
   neutral: 'neutral',
 };
 
-function isDotMode(path) {
+function isDotMode(/** @type {any} */ path) {
   const opening = path.node.openingElement;
 
   // Dot mode is indicated by shape="dot" prop
   const hasShapeDot = opening.attributes.some(
-    (attr) =>
+    (/** @type {any} */ attr) =>
       attr.type === 'JSXAttribute' &&
       attr.name.type === 'JSXIdentifier' &&
       attr.name.name === 'shape' &&
@@ -40,7 +41,7 @@ function isDotMode(path) {
 
   // If icon prop is present, leave alone
   const hasIcon = opening.attributes.some(
-    (attr) =>
+    (/** @type {any} */ attr) =>
       attr.type === 'JSXAttribute' &&
       attr.name.type === 'JSXIdentifier' &&
       attr.name.name === 'icon',
@@ -50,13 +51,18 @@ function isDotMode(path) {
   return true;
 }
 
+/**
+ * @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;
 
   // Find all XDSBadge JSX elements
-  root.find(j.JSXElement).forEach((path) => {
+  root.find(j.JSXElement).forEach((/** @type {any} */ path) => {
     const opening = path.node.openingElement;
     if (
       opening.name.type !== 'JSXIdentifier' ||
@@ -69,11 +75,12 @@ export default function transformer(file, api) {
 
     // Map variant
     const variantAttr = opening.attributes.find(
-      (attr) =>
+      (/** @type {any} */ attr) =>
         attr.type === 'JSXAttribute' &&
         attr.name.name === 'variant',
     );
 
+    /** @type {string | null} */
     let newVariantValue = 'neutral'; // default
     if (variantAttr) {
       if (
@@ -140,7 +147,7 @@ export default function transformer(file, api) {
   if (!hasChanges) return undefined;
 
   // Handle imports
-  const badgeImports = root.find(j.ImportDeclaration).filter((path) => {
+  const badgeImports = root.find(j.ImportDeclaration).filter((/** @type {any} */ path) => {
     const source = path.node.source.value;
     return (
       typeof source === 'string' &&
@@ -165,7 +172,7 @@ export default function transformer(file, api) {
     root
       .find(j.ImportDefaultSpecifier)
       .filter(
-        (path) => path.node.local.name === 'XDSStatusDot',
+        (/** @type {any} */ path) => path.node.local.name === 'XDSStatusDot',
       )
       .size() > 0;
 
@@ -176,7 +183,7 @@ export default function transformer(file, api) {
     );
 
     // Insert after the last existing xds import, or at the top
-    const xdsImports = root.find(j.ImportDeclaration).filter((path) => {
+    const xdsImports = root.find(j.ImportDeclaration).filter((/** @type {any} */ path) => {
       const source = path.node.source.value;
       return typeof source === 'string' && source.includes('@xds/core');
     });
@@ -195,11 +202,11 @@ export default function transformer(file, api) {
 
   // Remove XDSBadge import if no remaining usages
   if (remainingBadgeUsages === 0) {
-    badgeImports.forEach((path) => {
+    badgeImports.forEach((/** @type {any} */ path) => {
       const specifiers = path.node.specifiers;
       if (!specifiers) return;
 
-      const filtered = specifiers.filter((s) => {
+      const filtered = specifiers.filter((/** @type {any} */ s) => {
         if (
           s.type === 'ImportSpecifier' &&
           s.imported.type === 'Identifier' &&

package/{src/codemods → codemods}/transforms/v0.0.2/migrate-gap-to-numeric.mjs

@@ -23,6 +23,7 @@ export const meta = {
 /**
  * Mapping from string token to numeric value.
  */
+/** @type {Record<string, number>} */
 const TOKEN_TO_NUMBER = {
   space0: 0,
   'space0.5': 0.5,
@@ -58,12 +59,17 @@ const XDS_LAYOUT_ELEMENTS = new Set([
   'XDSStackItem',
 ]);
 
+/**
+ * @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((elementPath) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ elementPath) => {
     const nameNode = elementPath.node.name;
     // Only handle simple identifier element names like <XDSStack>. Skip member
     // expressions (e.g. <Foo.Bar>) and namespaced names — they're never XDS.

package/{src/codemods → codemods}/transforms/v0.0.2/migrate-isFullBleed-to-padding.mjs

@@ -29,6 +29,11 @@ const TARGET_COMPONENTS = [
   'XDSLayoutPanel',
 ];
 
+/**
+ * @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);
@@ -39,10 +44,10 @@ export default function transformer(file, api) {
       .find(j.JSXOpeningElement, {
         name: {name: componentName},
       })
-      .forEach((path) => {
+      .forEach((/** @type {any} */ path) => {
         const attrs = path.node.attributes;
         const isFullBleedIndex = attrs.findIndex(
-          (attr) =>
+          (/** @type {any} */ attr) =>
             attr.type === 'JSXAttribute' && attr.name.name === 'isFullBleed',
         );
 
@@ -57,7 +62,7 @@ export default function transformer(file, api) {
         if (value === null) {
           attrs.splice(isFullBleedIndex, 1);
           const hasPadding = attrs.some(
-            (a) => a.type === 'JSXAttribute' && a.name.name === 'padding',
+            (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name.name === 'padding',
           );
           if (!hasPadding) {
             attrs.push(
@@ -82,7 +87,7 @@ export default function transformer(file, api) {
             // isFullBleed={true} → padding={0}
             attrs.splice(isFullBleedIndex, 1);
             const hasPadding = attrs.some(
-              (a) => a.type === 'JSXAttribute' && a.name.name === 'padding',
+              (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name.name === 'padding',
             );
             if (!hasPadding) {
               attrs.push(

package/{src/codemods → codemods}/transforms/v0.0.2/migrate-useXDSIcon-to-getIcon.mjs

@@ -18,6 +18,11 @@ export const meta = {
   pr: '#531',
 };
 
+/**
+ * @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);
@@ -28,13 +33,13 @@ export default function transformer(file, api) {
     .find(j.CallExpression, {
       callee: {type: 'Identifier', name: 'useXDSIcon'},
     })
-    .forEach((path) => {
+    .forEach((/** @type {any} */ path) => {
       path.node.callee.name = 'getIcon';
       hasChanges = true;
     });
 
   // 2. Update import specifiers: useXDSIcon → getIcon
-  root.find(j.ImportSpecifier).forEach((path) => {
+  root.find(j.ImportSpecifier).forEach((/** @type {any} */ path) => {
     const imported = path.node.imported;
     if (imported.type === 'Identifier' && imported.name === 'useXDSIcon') {
       const oldLocal = path.node.local ? path.node.local.name : null;
@@ -48,11 +53,11 @@ export default function transformer(file, api) {
   });
 
   // 3. Remove IconRegistryContext from import specifiers
-  root.find(j.ImportDeclaration).forEach((path) => {
+  root.find(j.ImportDeclaration).forEach((/** @type {any} */ path) => {
     const specifiers = path.node.specifiers;
     if (!specifiers) return;
 
-    const filtered = specifiers.filter((s) => {
+    const filtered = specifiers.filter((/** @type {any} */ s) => {
       if (
         s.type === 'ImportSpecifier' &&
         s.imported.type === 'Identifier' &&
@@ -73,7 +78,7 @@ export default function transformer(file, api) {
   });
 
   // 4. Update import source: '../Icon/IconRegistry' or similar → '../Icon/globalIconRegistry'
-  root.find(j.ImportDeclaration).forEach((path) => {
+  root.find(j.ImportDeclaration).forEach((/** @type {any} */ path) => {
     const source = path.node.source.value;
     if (typeof source === 'string' && source.includes('IconRegistry') && !source.includes('globalIconRegistry')) {
       path.node.source.value = source.replace(
@@ -85,7 +90,7 @@ export default function transformer(file, api) {
   });
 
   // 5. Remove <IconRegistryContext.Provider> wrappers — replace with children
-  root.find(j.JSXElement).forEach((path) => {
+  root.find(j.JSXElement).forEach((/** @type {any} */ path) => {
     const opening = path.node.openingElement;
     if (
       opening.name.type === 'JSXMemberExpression' &&
@@ -113,7 +118,7 @@ export default function transformer(file, api) {
     .find(j.VariableDeclarator, {
       init: {type: 'Identifier', name: 'IconRegistryContext'},
     })
-    .forEach((path) => {
+    .forEach((/** @type {any} */ path) => {
       j(path.parent).remove();
       hasChanges = true;
     });

package/{src/codemods → codemods}/transforms/v0.0.2/rename-banner-endButton-to-endContent.mjs

@@ -11,6 +11,11 @@ export const meta = {
   pr: '#437',
 };
 
+/**
+ * @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);
@@ -20,8 +25,8 @@ export default function transformer(file, api) {
     .find(j.JSXOpeningElement, {
       name: {name: 'XDSBanner'},
     })
-    .forEach((path) => {
-      path.node.attributes.forEach((attr) => {
+    .forEach((/** @type {any} */ path) => {
+      path.node.attributes.forEach((/** @type {any} */ attr) => {
         if (attr.type === 'JSXAttribute' && attr.name.name === 'endButton') {
           attr.name.name = 'endContent';
           hasChanges = true;

package/{src/codemods → codemods}/transforms/v0.0.2/rename-form-tooltip-startIcon.mjs

@@ -25,23 +25,29 @@ const FORM_COMPONENTS = new Set([
   'XDSTimeInput',
 ]);
 
+/** @type {Record<string, string>} */
 const PROP_RENAMES = {
   tooltip: 'labelTooltip',
   startIcon: 'labelIcon',
 };
 
+/**
+ * @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;
     if (name.type !== 'JSXIdentifier' || !FORM_COMPONENTS.has(name.name)) {
       return;
     }
 
-    path.node.attributes.forEach((attr) => {
+    path.node.attributes.forEach((/** @type {any} */ attr) => {
       if (attr.type === 'JSXAttribute' && attr.name.name in PROP_RENAMES) {
         attr.name.name = PROP_RENAMES[attr.name.name];
         hasChanges = true;

package/{src/codemods → codemods}/transforms/v0.0.2/rename-isShown-to-isOpen.mjs

@@ -14,6 +14,11 @@ export const meta = {
 
 const TARGET_COMPONENTS = ['XDSDialog', 'XDSPopover'];
 
+/**
+ * @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);
@@ -24,8 +29,8 @@ export default function transformer(file, api) {
       .find(j.JSXOpeningElement, {
         name: {name: componentName},
       })
-      .forEach((path) => {
-        path.node.attributes.forEach((attr) => {
+      .forEach((/** @type {any} */ path) => {
+        path.node.attributes.forEach((/** @type {any} */ attr) => {
           if (attr.type === 'JSXAttribute' && attr.name.name === 'isShown') {
             attr.name.name = 'isOpen';
             hasChanges = true;

package/{src/codemods → codemods}/transforms/v0.0.2/rename-selector-items-to-options.mjs

@@ -11,6 +11,11 @@ export const meta = {
   pr: '#479',
 };
 
+/**
+ * @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);
@@ -21,8 +26,8 @@ export default function transformer(file, api) {
     .find(j.JSXOpeningElement, {
       name: {name: 'XDSSelector'},
     })
-    .forEach((path) => {
-      path.node.attributes.forEach((attr) => {
+    .forEach((/** @type {any} */ path) => {
+      path.node.attributes.forEach((/** @type {any} */ attr) => {
         if (attr.type === 'JSXAttribute' && attr.name.name === 'items') {
           attr.name.name = 'options';
           hasChanges = true;

package/{src/codemods → codemods}/transforms/v0.0.2/rename-sidenav-header-to-heading.mjs

@@ -26,6 +26,7 @@ const TARGET_COMPONENTS = new Set([
   'XDSSideNavHeading',
 ]);
 
+/** @type {Record<string, string>} */
 const PROP_RENAMES = {
   title: 'heading',
   titleHref: 'headingHref',
@@ -35,24 +36,30 @@ const PROP_RENAMES = {
   subtitleHref: 'subheadingHref',
 };
 
+/** @type {Record<string, string>} */
 const IMPORT_RENAMES = {
   XDSSideNavHeader: 'XDSSideNavHeading',
   XDSSideNavHeaderProps: 'XDSSideNavHeadingProps',
 };
 
+/**
+ * @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 props on target components
-  root.find(j.JSXOpeningElement).forEach((path) => {
+  root.find(j.JSXOpeningElement).forEach((/** @type {any} */ path) => {
     const name = path.node.name;
     if (name.type !== 'JSXIdentifier' || !TARGET_COMPONENTS.has(name.name)) {
       return;
     }
 
-    path.node.attributes.forEach((attr) => {
+    path.node.attributes.forEach((/** @type {any} */ attr) => {
       if (attr.type === 'JSXAttribute' && attr.name.name in PROP_RENAMES) {
         attr.name.name = PROP_RENAMES[attr.name.name];
         hasChanges = true;
@@ -61,13 +68,13 @@ export default function transformer(file, api) {
   });
 
   // 2. Rename <XDSSideNavHeader> to <XDSSideNavHeading> (opening and closing tags)
-  root.find(j.JSXIdentifier, {name: 'XDSSideNavHeader'}).forEach((path) => {
+  root.find(j.JSXIdentifier, {name: 'XDSSideNavHeader'}).forEach((/** @type {any} */ path) => {
     path.node.name = 'XDSSideNavHeading';
     hasChanges = true;
   });
 
   // 3. Rename import specifiers
-  root.find(j.ImportSpecifier).forEach((path) => {
+  root.find(j.ImportSpecifier).forEach((/** @type {any} */ path) => {
     const imported = path.node.imported;
     if (imported.type === 'Identifier' && imported.name in IMPORT_RENAMES) {
       const oldName = imported.name;