@atlaskit/eslint-plugin-design-system 8.23.1 → 8.23.2

package/dist/esm/ast-nodes/jsx-element.js

@@ -0,0 +1,50 @@
+import { isNodeOfType, jsxIdentifier } from 'eslint-codemod-utils';
+export var JSXElementHelper = {
+  /**
+   * Names of JSXElements can be any of:
+   * `<Component></Component>` - (JSXIdentifier)
+   * `<MyComponents.Component></MyComponents.Component>` - `MyComponents` is a namespace (JSXNamespacedName)
+   * `<MyComponents.Component></MyComponents.Component>` - `MyComponents` is an object (JSXMemberExpression)
+   *
+   * Getting the name of a JSXMemberExpression is difficult, because object can contain objects, which is recursively defined in the AST.
+   * e.g. getting the name of `<MyComponents.PresentationLayer.LeftSideBar.Header />` would require `getName` to recursively resolve all parts of the name.
+   * `getName` does not currently have this functionality. Add it if you need it.
+   */
+  getName: function getName(node) {
+    if (!isNodeOfType(node.openingElement.name, 'JSXIdentifier')) {
+      // TODO: We may want to log this
+      return '';
+    }
+    return node.openingElement.name.name;
+  },
+  updateName: function updateName(node, newName, fixer) {
+    var isSelfClosing = JSXElementHelper.isSelfClosing(node);
+    var openingElementFix = fixer.replaceText(node.openingElement.name, jsxIdentifier(newName).toString());
+    if (isSelfClosing || !node.closingElement) {
+      return [openingElementFix];
+    }
+    var closingElementFix = fixer.replaceText(node.closingElement.name, jsxIdentifier(newName).toString());
+    return [openingElementFix, closingElementFix];
+  },
+  isSelfClosing: function isSelfClosing(node) {
+    return node.openingElement.selfClosing;
+  },
+  getAttributes: function getAttributes(node) {
+    return node.openingElement.attributes;
+  },
+  getAttributeByName: function getAttributeByName(node, name) {
+    return node.openingElement.attributes.find(function (attr) {
+      // Ignore anything other than JSXAttribute
+      if (!isNodeOfType(attr, 'JSXAttribute')) {
+        return false;
+      }
+      return attr.name.name === name;
+    });
+  },
+  containsSpreadAttributes: function containsSpreadAttributes(node) {
+    return node.openingElement.attributes.some(function (attr) {
+      return isNodeOfType(attr, 'JSXSpreadAttribute');
+    });
+  }
+};
+export { JSXElementHelper as JSXElement };

package/dist/esm/ast-nodes/root.js

@@ -0,0 +1,28 @@
+/* eslint-disable @repo/internal/react/require-jsdoc */
+
+import { hasImportDeclaration, insertImportDeclaration, isNodeOfType } from 'eslint-codemod-utils';
+// Little bit unreadable, but better than duplicating the type
+
+export var Root = {
+  /**
+   * Note: This can return multiple ImportDeclarations for cases like:
+   * ```
+   * import { Stack } from '@atlaskit/primitives'
+   * import type { StackProps } from '@atlaskit/primitives'
+   * ```
+   */
+  findImportsByModule: function findImportsByModule(root, name) {
+    return root.filter(function (node) {
+      if (!isNodeOfType(node, 'ImportDeclaration')) {
+        return false;
+      }
+      if (!hasImportDeclaration(node, name)) {
+        return false;
+      }
+      return true;
+    });
+  },
+  insertImport: function insertImport(root, data, fixer) {
+    return fixer.insertTextBefore(root[0], "".concat(insertImportDeclaration(data.module, data.specifiers), ";\n"));
+  }
+};

package/dist/esm/rules/use-primitives/index.js

@@ -1,8 +1,9 @@
-import { getIdentifierInParentScope, isNodeOfType } from 'eslint-codemod-utils';
+import { isNodeOfType } from 'eslint-codemod-utils';
 import { createLintRule } from '../utils/create-rule';
 import { getConfig } from './config';
-import { jsxElementToBoxTransformer, styledComponentToPrimitive } from './transformers';
-import { containsOnlySupportedAttrs, findValidJsxUsageToTransform, findValidStyledComponentCall, getAttributeValueIdentifier, getJSXAttributeByName, getVariableDefinitionValue, getVariableUsagesCount, isFunctionNamed, isValidCssPropertiesToTransform, isValidTagName } from './utils';
+import { styledComponentToPrimitive } from './transformers';
+import { EmotionCSS } from './transformers/emotion-css';
+import { findValidJsxUsageToTransform, findValidStyledComponentCall, isValidCssPropertiesToTransform } from './utils';
 var boxDocsUrl = 'https://atlassian.design/components/primitives/box';
 var rule = createLintRule({
   meta: {
@@ -53,84 +54,13 @@ var rule = createLintRule({
         });
       },
       // transforms <div css={...}> usages
-      JSXOpeningElement: function JSXOpeningElement(node) {
-        if (!config.patterns.includes('compiled-css-function')) {
-          return false;
-        }
-        if (!isNodeOfType(node, 'JSXOpeningElement')) {
-          return;
-        }
-        if (!isNodeOfType(node.name, 'JSXIdentifier')) {
-          return;
-        }
-        if (!isNodeOfType(node.parent, 'JSXElement')) {
-          return;
-        }
-        var suggestBox = shouldSuggestBox(node.parent, context, config);
-        if (suggestBox) {
-          context.report({
-            node: node,
-            messageId: 'preferPrimitivesBox',
-            data: {
-              element: node.name.name
-            },
-            suggest: [{
-              desc: "Convert to Box",
-              fix: jsxElementToBoxTransformer(node.parent, context)
-            }]
-          });
-        }
+      JSXElement: function JSXElement(node) {
+        EmotionCSS.lint(node, {
+          context: context,
+          config: config
+        });
       }
     };
   }
 });
-var shouldSuggestBox = function shouldSuggestBox(node, context, config
-// scope: Scope.Scope,
-) {
-  if (!node) {
-    return false;
-  }
-
-  // Currently we only support `div`, but possibly more in future
-  if (!isValidTagName(node)) {
-    return false;
-  }
-
-  // Currently we only support elements that contain only a `css` attr, possibly more in future
-  if (!containsOnlySupportedAttrs(node)) {
-    return false;
-  }
-
-  // Get the `css` attr
-  var cssAttr = getJSXAttributeByName(node.openingElement, 'css');
-
-  // Get the prop value, e.g. `myStyles` in `css={myStyles}`
-  var cssVariableName = getAttributeValueIdentifier(cssAttr);
-
-  // `cssVariableName` could be undefined if the maker has
-  // done something like `css={[styles1, styles2]}`, `css={...styles}`, etc
-  if (!cssVariableName) {
-    return false;
-  }
-
-  /**
-   * Make sure the variable is not used in multiple JSX elements:
-   * ```
-   *    <div css={paddingStyles}></div>
-   *    <input css={paddingStyles}></input>
-   * ```
-   */
-  if (getVariableUsagesCount(cssVariableName, context) !== 1) {
-    return false;
-  }
-
-  // Find where `cssVariableName` is defined. We're looking for `const myStyles = css({...})`
-  var cssVariableDefinition = getIdentifierInParentScope(context.getScope(), cssVariableName);
-  var cssVariableValue = getVariableDefinitionValue(cssVariableDefinition);
-  // Check if `cssVariableValue` is a function called `css()`
-  if (!cssVariableValue || !isFunctionNamed(cssVariableValue, 'css')) {
-    return false;
-  }
-  return isValidCssPropertiesToTransform(cssVariableValue.node.init, config);
-};
 export default rule;

package/dist/esm/rules/use-primitives/transformers/emotion-css/index.js

@@ -0,0 +1,158 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+/* eslint-disable @repo/internal/react/require-jsdoc */
+
+import { getIdentifierInParentScope, isNodeOfType } from 'eslint-codemod-utils';
+import * as ast from '../../../../ast-nodes';
+import { getVariableDefinitionValue, getVariableUsagesCount, isValidCssPropertiesToTransform } from '../../utils';
+import { cssToXcssTransformer } from '../css-to-xcss';
+import * as supported from './supported';
+export var EmotionCSS = {
+  lint: function lint(node, _ref) {
+    var context = _ref.context,
+      config = _ref.config;
+    if (!isNodeOfType(node, 'JSXElement')) {
+      return;
+    }
+
+    // Check whether all criteria needed to make a transformation are met
+    if (!EmotionCSS._check(node, {
+      context: context,
+      config: config
+    })) {
+      return;
+    }
+    context.report({
+      node: node.openingElement,
+      messageId: 'preferPrimitivesBox',
+      suggest: [{
+        desc: "Convert to Box",
+        fix: EmotionCSS._fix(node, {
+          context: context
+        })
+      }]
+    });
+  },
+  _check: function _check(node, _ref2) {
+    var _cssVariableValue$nod, _cssVariableValue$nod2;
+    var context = _ref2.context,
+      config = _ref2.config;
+    if (!config.patterns.includes('compiled-css-function')) {
+      return false;
+    }
+    if (!isNodeOfType(node, 'JSXElement')) {
+      return false;
+    }
+    var elementName = ast.JSXElement.getName(node);
+    if (!elementName) {
+      return false;
+    }
+
+    // Currently we only support `div`. This may change in future.
+    if (!supported.elements.includes(elementName)) {
+      return false;
+    }
+
+    // Ignore elements that contain dangerous attributes like `id`.
+    if (!this._containsOnlySupportedAttributes(node)) {
+      return false;
+    }
+
+    // Currently we don't transform anything to `Box` unless it defines styles
+    var cssAttr = ast.JSXElement.getAttributeByName(node, 'css');
+    if (!cssAttr) {
+      return false;
+    }
+
+    // Get `myStyles` in `css={myStyles}` as a string so we can search for the `const myStyles` VariableDefinition
+    var cssAttrValue = ast.JSXAttribute.getValue(cssAttr);
+    if ((cssAttrValue === null || cssAttrValue === void 0 ? void 0 : cssAttrValue.type) !== 'ExpressionStatement') {
+      return false;
+    }
+
+    // TODO: Everything below this line could be refactored to use `ast-nodes`.
+
+    // Bail if the styles are used on multiple JSXElements
+    if (getVariableUsagesCount(cssAttrValue.value, context) !== 1) {
+      return false;
+    }
+
+    // Find where `myStyles` is defined. We're looking for `const myStyles = css({...})`
+    var cssVariableDefinition = getIdentifierInParentScope(context.getScope(), cssAttrValue.value);
+    var cssVariableValue = getVariableDefinitionValue(cssVariableDefinition);
+    // Check if `cssVariableValue` is a function called `css()`
+    if (ast.FunctionCall.getName(cssVariableValue === null || cssVariableValue === void 0 || (_cssVariableValue$nod = cssVariableValue.node) === null || _cssVariableValue$nod === void 0 ? void 0 : _cssVariableValue$nod.init) !== 'css') {
+      return false;
+    }
+    if (!isValidCssPropertiesToTransform(cssVariableValue === null || cssVariableValue === void 0 || (_cssVariableValue$nod2 = cssVariableValue.node) === null || _cssVariableValue$nod2 === void 0 ? void 0 : _cssVariableValue$nod2.init, config)) {
+      return false;
+    }
+    var importDeclaration = ast.Root.findImportsByModule(context.getSourceCode().ast.body, '@atlaskit/primitives');
+
+    // If there is more than one `@atlaskit/primitives` import, then it becomes difficult to determine which import to transform
+    if (importDeclaration.length > 1) {
+      return false;
+    }
+    return true;
+  },
+  _fix: function _fix(node, _ref3) {
+    var _this = this;
+    var context = _ref3.context;
+    return function (fixer) {
+      var importFix = _this._upsertImportDeclaration({
+        module: '@atlaskit/primitives',
+        specifiers: ['Box', 'xcss']
+      }, context, fixer);
+      var cssAttr = ast.JSXElement.getAttributeByName(node, 'css'); // Can strongly assert the type here, because we validated it exists in `check()`.
+      var attributeFix = ast.JSXAttribute.updateName(cssAttr, 'xcss', fixer);
+      var elementNameFixes = ast.JSXElement.updateName(node, 'Box', fixer);
+      var cssToXcssTransform = cssToXcssTransformer(node, context, fixer);
+      return [importFix, attributeFix].concat(_toConsumableArray(elementNameFixes), _toConsumableArray(cssToXcssTransform)).filter(function (fix) {
+        return Boolean(fix);
+      }); // Some of the transformers can return arrays with undefined, so filter them out
+    };
+  },
+  /**
+   * Check that every attribute in the JSXElement is something we support.
+   * We do this via a whitelist in `this.attributes`. The result is we exclude
+   * dangerous attrs like `id` and `style`.
+   */
+  _containsOnlySupportedAttributes: function _containsOnlySupportedAttributes(node) {
+    var attrs = ast.JSXElement.getAttributes(node);
+    return attrs.every(function (attr) {
+      if (!isNodeOfType(attr, 'JSXAttribute')) {
+        return false;
+      }
+      if (!isNodeOfType(attr.name, 'JSXIdentifier')) {
+        return false;
+      }
+      return supported.attributes.includes(attr.name.name);
+    });
+  },
+  /**
+   * Currently this is defined here because it's not very general purpose.
+   * If we were to move this to `ast-nodes`, half the implementation would be in `Root`,
+   * and the other half would be in `Import`.
+   *
+   * TODO: Refactor and move to `ast-nodes`
+   *
+   * Note: It does not handle default imports, namespace imports, or aliased imports.
+   */
+  _upsertImportDeclaration: function _upsertImportDeclaration(_ref4, context, fixer) {
+    var module = _ref4.module,
+      specifiers = _ref4.specifiers;
+    // Find any imports that match the packageName
+    var root = context.getSourceCode().ast.body;
+    var importDeclarations = ast.Root.findImportsByModule(root, module);
+
+    // The import doesn't exist yet, we can just insert a whole new one
+    if (importDeclarations.length === 0) {
+      return ast.Root.insertImport(root, {
+        module: module,
+        specifiers: specifiers
+      }, fixer);
+    }
+
+    // The import exists so, modify the existing one
+    return ast.Import.insertNamedSpecifiers(importDeclarations[0], specifiers, fixer);
+  }
+};

package/dist/esm/rules/use-primitives/transformers/emotion-css/supported.js

@@ -0,0 +1,46 @@
+export var elements = ['div'];
+export var attributes = ['css'
+// 'data-testid'
+];
+
+// TODO: https://product-fabric.atlassian.net/browse/DSP-16054
+var spaceTokenMap = {
+  '0px': 'space.0',
+  '2px': 'space.025',
+  '4px': 'space.050',
+  '6px': 'space.075',
+  '8px': 'space.100',
+  '12px': 'space.150',
+  '16px': 'space.200',
+  '20px': 'space.250',
+  '24px': 'space.300',
+  '32px': 'space.400',
+  '40px': 'space.500',
+  '48px': 'space.600',
+  '64px': 'space.800',
+  '80px': 'space.1000'
+};
+export var styles = {
+  padding: spaceTokenMap,
+  paddingBlock: spaceTokenMap,
+  paddingBlockEnd: spaceTokenMap,
+  paddingBlockStart: spaceTokenMap,
+  paddingBottom: spaceTokenMap,
+  paddingInline: spaceTokenMap,
+  paddingInlineEnd: spaceTokenMap,
+  paddingInlineStart: spaceTokenMap,
+  paddingLeft: spaceTokenMap,
+  paddingRight: spaceTokenMap,
+  paddingTop: spaceTokenMap,
+  margin: spaceTokenMap,
+  marginBlock: spaceTokenMap,
+  marginBlockEnd: spaceTokenMap,
+  marginBlockStart: spaceTokenMap,
+  marginBottom: spaceTokenMap,
+  marginInline: spaceTokenMap,
+  marginInlineEnd: spaceTokenMap,
+  marginInlineStart: spaceTokenMap,
+  marginLeft: spaceTokenMap,
+  marginRight: spaceTokenMap,
+  marginTop: spaceTokenMap
+};

package/dist/esm/rules/use-primitives/utils/is-valid-css-properties-to-transform.js

@@ -5,6 +5,9 @@ import { isNodeOfType } from 'eslint-codemod-utils';
 import { supportedStylesMap } from '../transformers/css-to-xcss';
 import { convertASTObjectExpressionToJSObject } from './convert-ast-object-expression-to-js-object';
 export var isValidCssPropertiesToTransform = function isValidCssPropertiesToTransform(node, config) {
+  if (!node) {
+    return false;
+  }
   var cssObjectExpression = node.arguments[0];
   // Bail on empty object calls
   if (!cssObjectExpression || !isNodeOfType(cssObjectExpression, 'ObjectExpression')) {

package/dist/types/ast-nodes/function-call.d.ts

@@ -0,0 +1,21 @@
+import type { Rule } from 'eslint';
+import { CallExpression, ObjectExpression } from 'eslint-codemod-utils';
+export declare const FunctionCall: {
+    getName(node: CallExpression): string | undefined;
+    updateName(node: CallExpression, newName: string, fixer: Rule.RuleFixer): Rule.Fix;
+    /**
+     * Function arguments can be many things:
+     * `css(myStyles, () => {}, undefined, 'literal', ...rest) // etc`
+     * They all need slightly different treatment.
+     *
+     * Currently 'getArgumentAtPos' only implements strategies for Literals and ObjectExpressions.
+     * If you need to support another type of arg, add it, and update the type.
+     */
+    getArgumentAtPos(node: CallExpression, pos: number): {
+        type: 'Literal';
+        value: string;
+    } | {
+        type: 'ObjectExpression';
+        value: ObjectExpression;
+    } | undefined;
+};

package/dist/types/ast-nodes/import.d.ts

@@ -0,0 +1,16 @@
+import type { Rule } from 'eslint';
+import { type ImportDeclaration } from 'eslint-codemod-utils';
+export declare const Import: {
+    /**
+     * Note: fixes can't overlap, which means this will fail:
+     * ```
+     * const importNode = Root.findImportByModule('@atlaskit/primitives')
+     * Import.insertNamedSpecifier(importNode, 'Box')
+     * Import.insertNamedSpecifier(importNode, 'xcss')
+     * ```
+     *
+     * For this reason `insertNamedSpecifiers` accepts a `specifiers` array, so you can group all inserts together.
+     */
+    insertNamedSpecifiers(node: ImportDeclaration, specifiers: string[], fixer: Rule.RuleFixer): Rule.Fix | undefined;
+    containsNamedSpecifier(node: ImportDeclaration, name: string): boolean;
+};

package/dist/types/ast-nodes/index.d.ts

@@ -0,0 +1,5 @@
+export { FunctionCall } from './function-call';
+export { Import } from './import';
+export { JSXAttribute } from './jsx-attribute';
+export { JSXElement } from './jsx-element';
+export { Root } from './root';

package/dist/types/ast-nodes/jsx-attribute.d.ts

@@ -0,0 +1,26 @@
+import type { Rule } from 'eslint';
+import { JSXAttribute } from 'eslint-codemod-utils';
+declare const HelperJSXAttribute: {
+    getName(node: JSXAttribute): string;
+    updateName(node: JSXAttribute, name: string, fixer: Rule.RuleFixer): Rule.Fix;
+    /**
+     * A JSXAttribute value can be many things:
+     * - css='myStyles'
+     * - css={myStyles}
+     * - css={[styles1, styles2]}
+     * - header={<></>}
+     * - css={styleMap.header}
+     * - css={...styles}
+     *
+     * Currently, `getValue` has only implemented strategies for when the value is a string, or an ExpressionStatement
+     * If you need additional functionality add it, and set the correct `type` on the returned object
+     */
+    getValue(node: JSXAttribute): {
+        type: 'ExpressionStatement';
+        value: string;
+    } | {
+        type: 'Literal';
+        value: string;
+    } | undefined;
+};
+export { HelperJSXAttribute as JSXAttribute };

package/dist/types/ast-nodes/jsx-element.d.ts

@@ -0,0 +1,21 @@
+import type { Rule } from 'eslint';
+import { JSXAttribute, JSXElement, JSXSpreadAttribute } from 'eslint-codemod-utils';
+export declare const JSXElementHelper: {
+    /**
+     * Names of JSXElements can be any of:
+     * `<Component></Component>` - (JSXIdentifier)
+     * `<MyComponents.Component></MyComponents.Component>` - `MyComponents` is a namespace (JSXNamespacedName)
+     * `<MyComponents.Component></MyComponents.Component>` - `MyComponents` is an object (JSXMemberExpression)
+     *
+     * Getting the name of a JSXMemberExpression is difficult, because object can contain objects, which is recursively defined in the AST.
+     * e.g. getting the name of `<MyComponents.PresentationLayer.LeftSideBar.Header />` would require `getName` to recursively resolve all parts of the name.
+     * `getName` does not currently have this functionality. Add it if you need it.
+     */
+    getName(node: JSXElement): string;
+    updateName(node: JSXElement, newName: string, fixer: Rule.RuleFixer): Rule.Fix[];
+    isSelfClosing(node: JSXElement): boolean;
+    getAttributes(node: JSXElement): (JSXAttribute | JSXSpreadAttribute)[];
+    getAttributeByName(node: JSXElement, name: string): JSXAttribute | undefined;
+    containsSpreadAttributes(node: JSXElement): boolean;
+};
+export { JSXElementHelper as JSXElement };

package/dist/types/ast-nodes/root.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="node" />
+import type { Rule } from 'eslint';
+import { Directive, ImportDeclaration, insertImportDeclaration, ModuleDeclaration, Statement } from 'eslint-codemod-utils';
+type ImportData = Parameters<typeof insertImportDeclaration>[1];
+export declare const Root: {
+    /**
+     * Note: This can return multiple ImportDeclarations for cases like:
+     * ```
+     * import { Stack } from '@atlaskit/primitives'
+     * import type { StackProps } from '@atlaskit/primitives'
+     * ```
+     */
+    findImportsByModule(root: (Directive | Statement | ModuleDeclaration)[], name: string): ImportDeclaration[];
+    insertImport(root: (Directive | Statement | ModuleDeclaration)[], data: {
+        module: string;
+        specifiers: ImportData;
+    }, fixer: Rule.RuleFixer): Rule.Fix;
+};
+export {};

package/dist/types/rules/use-primitives/transformers/emotion-css/index.d.ts

@@ -0,0 +1,35 @@
+import type { Rule } from 'eslint';
+import { JSXElement } from 'eslint-codemod-utils';
+import { RuleConfig } from '../../config';
+interface MetaData {
+    context: Rule.RuleContext;
+    config: RuleConfig;
+}
+type FixFunction = (fixer: Rule.RuleFixer) => Rule.Fix[];
+export declare const EmotionCSS: {
+    lint(node: Rule.Node, { context, config }: MetaData): void;
+    _check(node: Rule.Node, { context, config }: MetaData): boolean;
+    _fix(node: JSXElement, { context }: {
+        context: Rule.RuleContext;
+    }): FixFunction;
+    /**
+     * Check that every attribute in the JSXElement is something we support.
+     * We do this via a whitelist in `this.attributes`. The result is we exclude
+     * dangerous attrs like `id` and `style`.
+     */
+    _containsOnlySupportedAttributes(node: JSXElement): boolean;
+    /**
+     * Currently this is defined here because it's not very general purpose.
+     * If we were to move this to `ast-nodes`, half the implementation would be in `Root`,
+     * and the other half would be in `Import`.
+     *
+     * TODO: Refactor and move to `ast-nodes`
+     *
+     * Note: It does not handle default imports, namespace imports, or aliased imports.
+     */
+    _upsertImportDeclaration({ module, specifiers, }: {
+        module: string;
+        specifiers: string[];
+    }, context: Rule.RuleContext, fixer: Rule.RuleFixer): Rule.Fix | undefined;
+};
+export {};

package/dist/types/rules/use-primitives/transformers/emotion-css/supported.d.ts

@@ -0,0 +1,9 @@
+export declare const elements: string[];
+export declare const attributes: string[];
+declare const spaceTokenMap: {
+    [key: string]: string;
+};
+export declare const styles: {
+    [key: string]: typeof spaceTokenMap;
+};
+export {};

package/dist/types-ts4.5/ast-nodes/function-call.d.ts

@@ -0,0 +1,21 @@
+import type { Rule } from 'eslint';
+import { CallExpression, ObjectExpression } from 'eslint-codemod-utils';
+export declare const FunctionCall: {
+    getName(node: CallExpression): string | undefined;
+    updateName(node: CallExpression, newName: string, fixer: Rule.RuleFixer): Rule.Fix;
+    /**
+     * Function arguments can be many things:
+     * `css(myStyles, () => {}, undefined, 'literal', ...rest) // etc`
+     * They all need slightly different treatment.
+     *
+     * Currently 'getArgumentAtPos' only implements strategies for Literals and ObjectExpressions.
+     * If you need to support another type of arg, add it, and update the type.
+     */
+    getArgumentAtPos(node: CallExpression, pos: number): {
+        type: 'Literal';
+        value: string;
+    } | {
+        type: 'ObjectExpression';
+        value: ObjectExpression;
+    } | undefined;
+};

package/dist/types-ts4.5/ast-nodes/import.d.ts

@@ -0,0 +1,16 @@
+import type { Rule } from 'eslint';
+import { type ImportDeclaration } from 'eslint-codemod-utils';
+export declare const Import: {
+    /**
+     * Note: fixes can't overlap, which means this will fail:
+     * ```
+     * const importNode = Root.findImportByModule('@atlaskit/primitives')
+     * Import.insertNamedSpecifier(importNode, 'Box')
+     * Import.insertNamedSpecifier(importNode, 'xcss')
+     * ```
+     *
+     * For this reason `insertNamedSpecifiers` accepts a `specifiers` array, so you can group all inserts together.
+     */
+    insertNamedSpecifiers(node: ImportDeclaration, specifiers: string[], fixer: Rule.RuleFixer): Rule.Fix | undefined;
+    containsNamedSpecifier(node: ImportDeclaration, name: string): boolean;
+};

package/dist/types-ts4.5/ast-nodes/index.d.ts

@@ -0,0 +1,5 @@
+export { FunctionCall } from './function-call';
+export { Import } from './import';
+export { JSXAttribute } from './jsx-attribute';
+export { JSXElement } from './jsx-element';
+export { Root } from './root';

package/dist/types-ts4.5/ast-nodes/jsx-attribute.d.ts

@@ -0,0 +1,26 @@
+import type { Rule } from 'eslint';
+import { JSXAttribute } from 'eslint-codemod-utils';
+declare const HelperJSXAttribute: {
+    getName(node: JSXAttribute): string;
+    updateName(node: JSXAttribute, name: string, fixer: Rule.RuleFixer): Rule.Fix;
+    /**
+     * A JSXAttribute value can be many things:
+     * - css='myStyles'
+     * - css={myStyles}
+     * - css={[styles1, styles2]}
+     * - header={<></>}
+     * - css={styleMap.header}
+     * - css={...styles}
+     *
+     * Currently, `getValue` has only implemented strategies for when the value is a string, or an ExpressionStatement
+     * If you need additional functionality add it, and set the correct `type` on the returned object
+     */
+    getValue(node: JSXAttribute): {
+        type: 'ExpressionStatement';
+        value: string;
+    } | {
+        type: 'Literal';
+        value: string;
+    } | undefined;
+};
+export { HelperJSXAttribute as JSXAttribute };

package/dist/types-ts4.5/ast-nodes/jsx-element.d.ts

@@ -0,0 +1,21 @@
+import type { Rule } from 'eslint';
+import { JSXAttribute, JSXElement, JSXSpreadAttribute } from 'eslint-codemod-utils';
+export declare const JSXElementHelper: {
+    /**
+     * Names of JSXElements can be any of:
+     * `<Component></Component>` - (JSXIdentifier)
+     * `<MyComponents.Component></MyComponents.Component>` - `MyComponents` is a namespace (JSXNamespacedName)
+     * `<MyComponents.Component></MyComponents.Component>` - `MyComponents` is an object (JSXMemberExpression)
+     *
+     * Getting the name of a JSXMemberExpression is difficult, because object can contain objects, which is recursively defined in the AST.
+     * e.g. getting the name of `<MyComponents.PresentationLayer.LeftSideBar.Header />` would require `getName` to recursively resolve all parts of the name.
+     * `getName` does not currently have this functionality. Add it if you need it.
+     */
+    getName(node: JSXElement): string;
+    updateName(node: JSXElement, newName: string, fixer: Rule.RuleFixer): Rule.Fix[];
+    isSelfClosing(node: JSXElement): boolean;
+    getAttributes(node: JSXElement): (JSXAttribute | JSXSpreadAttribute)[];
+    getAttributeByName(node: JSXElement, name: string): JSXAttribute | undefined;
+    containsSpreadAttributes(node: JSXElement): boolean;
+};
+export { JSXElementHelper as JSXElement };