@astryxdesign/cli 0.1.7 → 0.1.8-canary.07362a9

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;

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

@@ -23,24 +23,30 @@ const TITLE_PROP_COMPONENTS = new Set([
   'XDSTopNavHeading',
 ]);
 
+/** @type {Record<string, string>} */
 const IMPORT_RENAMES = {
   XDSTopNavTitle: 'XDSTopNavHeading',
   XDSTopNavTitleProps: 'XDSTopNavHeadingProps',
 };
 
+/**
+ * @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 `title` prop to `heading` 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' || !TITLE_PROP_COMPONENTS.has(name.name)) {
       return;
     }
 
-    path.node.attributes.forEach((attr) => {
+    path.node.attributes.forEach((/** @type {any} */ attr) => {
       if (attr.type === 'JSXAttribute' && attr.name.name === 'title') {
         attr.name.name = 'heading';
         hasChanges = true;
@@ -49,13 +55,13 @@ export default function transformer(file, api) {
   });
 
   // 2. Rename <XDSTopNavTitle> to <XDSTopNavHeading> (opening and closing tags)
-  root.find(j.JSXIdentifier, {name: 'XDSTopNavTitle'}).forEach((path) => {
+  root.find(j.JSXIdentifier, {name: 'XDSTopNavTitle'}).forEach((/** @type {any} */ path) => {
     path.node.name = 'XDSTopNavHeading';
     hasChanges = true;
   });
 
   // 3. Rename import specifiers: XDSTopNavTitle → XDSTopNavHeading, XDSTopNavTitleProps → XDSTopNavHeadingProps
-  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;

package/{src/codemods → codemods}/transforms/v0.0.2/unify-uncontrolled-to-defaultX.mjs

@@ -32,6 +32,11 @@ const RENAMES = [
   },
 ];
 
+/**
+ * @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);
@@ -42,8 +47,8 @@ export default function transformer(file, api) {
       .find(j.JSXOpeningElement, {
         name: {name: component},
       })
-      .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 === oldProp) {
             attr.name.name = newProp;
             hasChanges = true;

package/{src/codemods → codemods}/transforms/v0.0.2/unify-visibility-to-onOpenChange.mjs

@@ -33,6 +33,11 @@ const SIMPLE_RENAMES = [
  */
 const MERGE_COMPONENTS = ['XDSHoverCard', 'XDSTooltip'];
 
+/**
+ * @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);
@@ -44,8 +49,8 @@ export default function transformer(file, api) {
       .find(j.JSXOpeningElement, {
         name: {name: component},
       })
-      .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 === oldProp) {
             attr.name.name = 'onOpenChange';
             hasChanges = true;
@@ -60,13 +65,13 @@ export default function transformer(file, api) {
       .find(j.JSXOpeningElement, {
         name: {name: component},
       })
-      .forEach((path) => {
+      .forEach((/** @type {any} */ path) => {
         const attrs = path.node.attributes;
         const onShowAttr = attrs.find(
-          (a) => a.type === 'JSXAttribute' && a.name.name === 'onShow',
+          (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name.name === 'onShow',
         );
         const onHideAttr = attrs.find(
-          (a) => a.type === 'JSXAttribute' && a.name.name === 'onHide',
+          (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name.name === 'onHide',
         );
 
         if (onShowAttr && onHideAttr) {

package/{src/codemods → codemods}/transforms/v0.0.6/migrate-badge-children-to-label.mjs

@@ -19,6 +19,11 @@ export const meta = {
   pr: '#706',
 };
 
+/**
+ * @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,7 +33,7 @@ export default function transformer(file, api) {
     .find(j.JSXElement, {
       openingElement: {name: {name: 'XDSBadge'}},
     })
-    .forEach((path) => {
+    .forEach((/** @type {any} */ path) => {
       const {children} = path.node;
 
       // Skip if already self-closing or no children
@@ -36,7 +41,7 @@ export default function transformer(file, api) {
 
       // Filter out whitespace-only JSXText nodes
       const meaningful = children.filter(
-        (c) => !(c.type === 'JSXText' && !c.value.trim()),
+        (/** @type {any} */ c) => !(c.type === 'JSXText' && !c.value.trim()),
       );
 
       // Only transform single-child cases

package/{src/codemods → codemods}/transforms/v0.0.6/migrate-collapse-to-collapsible.mjs

@@ -36,6 +36,11 @@ const APPSHELL_DEPRECATED_PROPS = [
   'defaultIsSideNavCollapsed',
 ];
 
+/**
+ * @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);
@@ -46,16 +51,17 @@ export default function transformer(file, api) {
     .find(j.JSXOpeningElement, {
       name: {name: 'XDSSideNav'},
     })
-    .forEach((path) => {
+    .forEach((/** @type {any} */ path) => {
       const attrs = path.node.attributes;
 
       // Find isCollapsible
       const isCollapsibleIdx = attrs.findIndex(
-        (a) => a.type === 'JSXAttribute' && a.name.name === 'isCollapsible',
+        (/** @type {any} */ a) => a.type === 'JSXAttribute' && a.name.name === 'isCollapsible',
       );
       if (isCollapsibleIdx === -1) return;
 
       // Collect all collapse-related props
+      /** @type {Record<string, any>} */
       const collapseProps = {};
       const indicesToRemove = [];
 
@@ -129,7 +135,7 @@ export default function transformer(file, api) {
     .find(j.JSXOpeningElement, {
       name: {name: 'XDSAppShell'},
     })
-    .forEach((path) => {
+    .forEach((/** @type {any} */ path) => {
       const attrs = path.node.attributes;
       for (let i = attrs.length - 1; i >= 0; i--) {
         const attr = attrs[i];

package/{src/codemods → codemods}/transforms/v0.0.6/migrate-radius-tokens.mjs

@@ -22,6 +22,7 @@ export const meta = {
     'Renames --radius-inner/content/element/container/page to --radius-0/1/2/3/4.',
 };
 
+/** @type {Record<string, string>} */
 const TOKEN_MAP = {
   '--radius-inner': '--radius-0',
   '--radius-content': '--radius-1',
@@ -38,17 +39,22 @@ const OLD_TOKENS_PATTERN = new RegExp(
   'g',
 );
 
-function replaceTokens(str) {
-  return str.replace(OLD_TOKENS_PATTERN, (match) => TOKEN_MAP[match] || match);
+function replaceTokens(/** @type {any} */ str) {
+  return str.replace(OLD_TOKENS_PATTERN, (/** @type {any} */ match) => TOKEN_MAP[match] || match);
 }
 
+/**
+ * @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;
 
   // Replace in string literals (StringLiteral or Literal with string value)
-  const replaceInStringNode = (path) => {
+  const replaceInStringNode = (/** @type {any} */ path) => {
     if (typeof path.node.value !== 'string') return;
     const original = path.node.value;
     const replaced = replaceTokens(original);
@@ -59,14 +65,14 @@ export default function transformer(file, api) {
   };
 
   root.find(j.StringLiteral).forEach(replaceInStringNode);
-  root.find(j.Literal).forEach((path) => {
+  root.find(j.Literal).forEach((/** @type {any} */ path) => {
     if (typeof path.node.value === 'string') {
       replaceInStringNode(path);
     }
   });
 
   // Replace in template literal quasis
-  root.find(j.TemplateLiteral).forEach((path) => {
+  root.find(j.TemplateLiteral).forEach((/** @type {any} */ path) => {
     for (const quasi of path.node.quasis) {
       const original = quasi.value.raw;
       const replaced = replaceTokens(original);