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

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' ||

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;