@atlaskit/eslint-plugin-design-system 13.41.2 → 13.42.0

package/dist/cjs/rules/no-legacy-icons/index.js

@@ -1,91 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _createRule = require("../utils/create-rule");
-var _errorBoundary = require("../utils/error-boundary");
-var _checks = require("./checks");
-var _helpers = require("./helpers");
-var rule = (0, _createRule.createLintRule)({
-  meta: {
-    name: 'no-legacy-icons',
-    fixable: 'code',
-    hasSuggestions: true,
-    type: 'problem',
-    docs: {
-      description: 'Enforces no legacy icons are used.',
-      recommended: false,
-      severity: 'warn'
-    },
-    schema: [{
-      type: 'object',
-      properties: {
-        shouldErrorForManualMigration: {
-          type: 'boolean'
-        },
-        shouldErrorForAutoMigration: {
-          type: 'boolean'
-        },
-        shouldUseSafeMigrationMode: {
-          type: 'boolean'
-        },
-        quiet: {
-          type: 'boolean'
-        },
-        shouldUseMigrationPath: {
-          type: 'boolean'
-        }
-      },
-      additionalProperties: false
-    }],
-    messages: {
-      noLegacyIconsAutoMigration: "Auto Migration:\nLegacy icon '{{iconName}}' from '{{importSource}}' detected.\nAutomatic migration is possible.\n\n{{guidance}}\nAtlassians: See https://go.atlassian.com/icon-migration-guide for details.'",
-      noLegacyIconsManualMigration: "Manual Migration:\nLegacy icon '{{iconName}}' from '{{importSource}}' detected.\nAutomatic migration not possible.\n\n{{guidance}}\nAtlassians: See https://go.atlassian.com/icon-migration-guide for details.",
-      cantFindSuitableReplacement: "No suitable replacement found for '{{iconName}}' from '{{importSource}}'{{sizeGuidance}}. Please manually migrate this icon.",
-      cantMigrateReExport: "'{{exportName}}' is a re-export of icon from '{{packageName}}' and cannot be automatically migrated. Please remove this re-export, and migrate any usages to the new icon APIs.",
-      cantMigrateColor: "This icon's `primaryColor` prop is set to {{colorValue}}, which isn't a design token supported in the new Icon API. Please switch to an appropriate `color.icon`, `color.link` or `color.text` token, or currentColor in buttons and menus.",
-      cantMigrateSpreadProps: "This usage of Icon uses spread props in a way that can't be automatically migrated. Please explicitly define the following props after spread in order to auto-migrate: '{{missingProps}}' ",
-      cantMigrateSizeUnknown: "This usage of Icon sets the size via a variable or function that can't be automatically migrated. Please migrate manually to the correct `LEGACY_size` and `spacing` props.",
-      cantMigrateFunctionUnknown: "Icon '{{iconName}}', from entrypoint '{{importSource}}', is passed into a function/component and can't be migrated automatically. Please manually migrate this icon.",
-      cantMigrateIdentifierMapOrArray: "This icon is passed to other components via a map or array, and can't be migrated automatically. Please manually migrate wherever this expression is used to the new API, or use the icon components directly.",
-      cantMigrateIdentifier: "This reference to {{iconName}} from {{iconSource}} can't be migrated automatically to the new components and API. Please manually migrate this and any other references."
-    }
-  },
-  create: function create(context) {
-    var _createHelpers = (0, _helpers.createHelpers)(context),
-      getConfigFlag = _createHelpers.getConfigFlag;
-    var failSilently = getConfigFlag('failSilently', false);
-    var _createChecks = (0, _checks.createChecks)(context),
-      checkImportDeclarations = _createChecks.checkImportDeclarations,
-      checkVariableDeclarations = _createChecks.checkVariableDeclarations,
-      checkExportDefaultDeclaration = _createChecks.checkExportDefaultDeclaration,
-      checkExportNamedVariables = _createChecks.checkExportNamedVariables,
-      checkArrayOrMap = _createChecks.checkArrayOrMap,
-      checkIconAsProp = _createChecks.checkIconAsProp,
-      checkJSXElement = _createChecks.checkJSXElement,
-      checkCallExpression = _createChecks.checkCallExpression,
-      throwErrors = _createChecks.throwErrors,
-      checkIconReference = _createChecks.checkIconReference;
-    return (0, _errorBoundary.errorBoundary)({
-      // Track imports of relevant components
-      ImportDeclaration: checkImportDeclarations,
-      // Keep track of the relevant variable declarations and renames
-      VariableDeclaration: checkVariableDeclarations,
-      // Case: default re-exports. Can't be auto-migrated
-      ExportDefaultDeclaration: checkExportDefaultDeclaration,
-      ExportNamedDeclaration: checkExportNamedVariables,
-      // Legacy icons found in arrays/objects
-      'ObjectExpression > Property > Identifier, ArrayExpression > Identifier ': checkArrayOrMap,
-      // Legacy icons passed in via props, as JSX identifier (i.e. icon={AddIcon})
-      'JSXOpeningElement > JSXAttribute > JSXExpressionContainer > Identifier': checkIconAsProp,
-      JSXElement: checkJSXElement,
-      // Icons called as an argument of a function (i.e. icon={DefaultIcon(AddIcon)})
-      CallExpression: checkCallExpression,
-      Identifier: checkIconReference,
-      'Program:exit': throwErrors
-    }, failSilently);
-  }
-});
-var _default = exports.default = rule;

package/dist/cjs/rules/no-legacy-icons/upcoming-icons.js

@@ -1,7 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.upcomingIcons = void 0;
-var upcomingIcons = exports.upcomingIcons = [];

package/dist/es2019/rules/no-legacy-icons/checks.js

@@ -1,520 +0,0 @@
-import { isNodeOfType } from 'eslint-codemod-utils';
-import { addToListOfRanges, canAutoMigrateNewIconBasedOnSize, canMigrateColor, createAutoMigrationError, createCantFindSuitableReplacementError, createCantMigrateColorError, createCantMigrateFunctionUnknownError, createCantMigrateIdentifierError, createCantMigrateIdentifierMapOrArrayError, createCantMigrateReExportError, createCantMigrateSizeUnknown, createCantMigrateSpreadPropsError, createGuidance, createHelpers, getMigrationMapObject, getUpcomingIcons, isInsideIconOnlyLegacyButton, isInsideLegacyButton, isInsideNewButton, isSize, locToString, throwAutoErrors, throwManualErrors } from './helpers';
-export const createChecks = context => {
-  // Create global variables to be shared by the checks
-  const {
-    getPrimaryColor,
-    getConfigFlag
-  } = createHelpers(context);
-  const legacyIconImports = {};
-  const migrationIconImports = {};
-  const newButtonImports = new Set();
-  const legacyButtonImports = new Set();
-  const errorsManual = {};
-  const errorsAuto = {};
-  const iconSizesInfo = {}; //Import source key, locations as value
-
-  let guidance = {};
-
-  // Extract parameters
-  const shouldErrorForManualMigration = getConfigFlag('shouldErrorForManualMigration', true);
-  const shouldErrorForAutoMigration = getConfigFlag('shouldErrorForAutoMigration', true);
-  const isQuietMode = getConfigFlag('quiet', false);
-  const shouldUseMigrationPath = getConfigFlag('shouldUseMigrationPath', true);
-  const shouldUseSafeMigrationMode = getConfigFlag('shouldUseSafeMigrationMode', false);
-
-  // Sorted list of ranges
-  let errorRanges = [];
-
-  /**
-   * Adds the legacy Icon and new button imports to the correct global arrays to be used by the other checks
-   * @param node The import node found by ESLint
-   */
-  const checkImportDeclarations = node => {
-    const moduleSource = node.source.value;
-
-    // Find the imports for legacy icons
-    if (moduleSource && typeof moduleSource === 'string' && ['@atlaskit/icon/glyph/'].find(val => moduleSource.startsWith(val)) && node.specifiers.length > 0) {
-      for (const spec of node.specifiers) {
-        if (spec.local.name) {
-          legacyIconImports[spec.local.name] = {
-            packageName: moduleSource,
-            exported: false,
-            importNode: node,
-            importSpecifier: spec.local.name
-          };
-        }
-      }
-    }
-
-    // Find the imports for icons that import from migration path
-    if (moduleSource && typeof moduleSource === 'string' && (moduleSource.startsWith('@atlaskit/icon/core/migration/') || moduleSource.startsWith('@atlaskit/icon/utility/migration/')) && node.specifiers.length) {
-      node.specifiers.forEach(spec => {
-        if (spec.local.name) {
-          migrationIconImports[spec.local.name] = {
-            packageName: moduleSource,
-            exported: false,
-            importNode: node,
-            importSpecifier: spec.local.name
-          };
-        }
-      });
-    }
-
-    // Find the imports for new button and IconButton
-    if (typeof moduleSource === 'string' && moduleSource.startsWith('@atlaskit/button/new') && node.specifiers.length) {
-      for (const spec of node.specifiers) {
-        if (spec.type === 'ImportDefaultSpecifier') {
-          newButtonImports.add(spec.local.name);
-        } else if (spec.type === 'ImportSpecifier' && 'name' in spec.imported && spec.imported.name === 'IconButton') {
-          newButtonImports.add(spec.local.name);
-        }
-      }
-    }
-
-    // Find the imports for legacy default button
-    if (typeof moduleSource === 'string' && (moduleSource === '@atlaskit/button' || moduleSource === '@atlaskit/button/standard-button' || moduleSource === '@atlaskit/button/loading-button' || moduleSource === '@atlaskit/button/custom-theme-button') && node.specifiers.length) {
-      for (const spec of node.specifiers) {
-        if (spec.type === 'ImportDefaultSpecifier') {
-          legacyButtonImports.add(spec.local.name);
-        }
-      }
-    }
-  };
-
-  /**
-   * Adds the legacy Icon and new button variable reassignments to the correct global arrays to be used by the other checks
-   * @param node The variable reassignment node found by ESLint
-   */
-  const checkVariableDeclarations = node => {
-    if (isNodeOfType(node, 'VariableDeclaration')) {
-      const isExported = node.parent && isNodeOfType(node.parent, 'ExportNamedDeclaration');
-      for (const decl of node.declarations) {
-        if (isNodeOfType(decl, 'VariableDeclarator') && Object.keys(decl).includes('init') && Object.keys(decl).includes('id') && decl.init && decl.id && 'name' in decl.id && decl.id.name && isNodeOfType(decl.init, 'Identifier')) {
-          if (Object.keys(legacyIconImports).includes(decl.init.name)) {
-            legacyIconImports[decl.id.name] = {
-              packageName: legacyIconImports[decl.init.name].packageName,
-              exported: legacyIconImports[decl.init.name].exported || isExported,
-              importNode: legacyIconImports[decl.init.name].importNode,
-              importSpecifier: legacyIconImports[decl.init.name].importSpecifier
-            };
-          } else if (newButtonImports.has(decl.init.name)) {
-            newButtonImports.add(decl.id.name);
-          }
-        }
-      }
-    }
-  };
-
-  /**
-   * Checks if the default export is a re-export of a legacy icon and stores the errors in the global array
-   * @param node The default export node found by ESLint
-   */
-  const checkExportDefaultDeclaration = node => {
-    let exportName = '';
-    let packageName = '';
-    if (Object.keys(node).includes('declaration') && node.declaration && isNodeOfType(node.declaration, 'Identifier') && Object.keys(legacyIconImports).includes(node.declaration.name)) {
-      packageName = legacyIconImports[node.declaration.name].packageName;
-      exportName = 'Default export';
-    } else if (Object.keys(node).includes('declaration') && node.declaration && isNodeOfType(node.declaration, 'AssignmentExpression') && isNodeOfType(node.declaration.left, 'Identifier') && isNodeOfType(node.declaration.right, 'Identifier') && Object.keys(legacyIconImports).includes(node.declaration.right.name)) {
-      packageName = legacyIconImports[node.declaration.right.name].packageName;
-      exportName = node.declaration.left.name;
-    } else {
-      return;
-    }
-    createCantMigrateReExportError(node, packageName, exportName, errorsManual);
-    addToListOfRanges(node, errorRanges);
-    guidance[locToString(node)] = createGuidance({
-      iconPackage: packageName,
-      shouldUseMigrationPath
-    });
-  };
-
-  /**
-   * Checks if the named exports are re-exports of a legacy icon and stores the errors in the global array
-   * @param node The named export node found by ESLint
-   */
-  const checkExportNamedVariables = node => {
-    // Case: export {default as AddIcon} from '@atlaskit/icon/glyph/add';
-    if (node.source && isNodeOfType(node.source, 'Literal') && Object.keys(node.source).includes('value')) {
-      const moduleSource = node.source.value;
-      if (typeof moduleSource === 'string' && ['@atlaskit/icon/glyph/'].find(val => moduleSource.startsWith(val)) && node.specifiers.length) {
-        for (const spec of node.specifiers) {
-          if ('name' in spec.exported) {
-            createCantMigrateReExportError(spec, moduleSource, spec.exported.name, errorsManual);
-            addToListOfRanges(spec, errorRanges);
-            guidance[locToString(spec)] = createGuidance({
-              iconPackage: moduleSource,
-              shouldUseMigrationPath
-            });
-          }
-        }
-      }
-    } else if (node.declaration && isNodeOfType(node.declaration, 'VariableDeclaration')) {
-      // Case: export const Icon = AddIcon;
-      for (const decl of node.declaration.declarations) {
-        if (isNodeOfType(decl, 'VariableDeclarator') && Object.keys(decl).includes('init') && decl.init && isNodeOfType(decl.init, 'Identifier') && Object.keys(legacyIconImports).includes(decl.init.name)) {
-          createCantMigrateReExportError(node, legacyIconImports[decl.init.name].packageName, decl.init.name, errorsManual);
-          addToListOfRanges(node, errorRanges);
-          guidance[locToString(node)] = createGuidance({
-            iconPackage: legacyIconImports[decl.init.name].packageName,
-            shouldUseMigrationPath
-          });
-        }
-      }
-    } else if (!node.source && node.specifiers && node.specifiers.length > 0) {
-      /**
-       * case where multiple consts are re-exported:
-       * const AddIcon = LegacyIcon;
-       * const crossIcon = LegacyIcon2;
-       * export { AddIcon, CrossIcon as default }
-       */
-      for (const spec of node.specifiers) {
-        if ('name' in spec.local && 'name' in spec.exported && Object.keys(legacyIconImports).includes(spec.local.name)) {
-          //update legacy imports to be exported
-          legacyIconImports[spec.local.name] = {
-            packageName: legacyIconImports[spec.local.name].packageName,
-            exported: true,
-            importNode: legacyIconImports[spec.local.name].importNode,
-            importSpecifier: legacyIconImports[spec.local.name].importSpecifier
-          };
-          createCantMigrateReExportError(spec, legacyIconImports[spec.local.name].packageName, spec.exported.name, errorsManual);
-          addToListOfRanges(spec, errorRanges);
-          guidance[locToString(spec)] = createGuidance({
-            iconPackage: legacyIconImports[spec.local.name].packageName,
-            shouldUseMigrationPath
-          });
-        }
-      }
-    }
-  };
-
-  /**
-   * Checks if a legacy icon is referenced in an array or map and stores the errors in the global array
-   * @param node The array/map node found by ESLint
-   */
-  const checkArrayOrMap = node => {
-    if (!isNodeOfType(node, 'Identifier')) {
-      return;
-    }
-    if (node.name && Object.keys(legacyIconImports).includes(node.name) && legacyIconImports[node.name].packageName) {
-      createCantMigrateIdentifierMapOrArrayError(node, legacyIconImports[node.name].packageName, node.name, errorsManual);
-      addToListOfRanges(node, errorRanges);
-      guidance[locToString(node)] = createGuidance({
-        iconPackage: legacyIconImports[node.name].packageName,
-        shouldUseMigrationPath
-      });
-    }
-  };
-
-  /**
-   * Checks if a legacy icon is referenced as a prop to a component and stores the errors in the global array
-   * @param node The property node found by ESLint
-   */
-  const checkIconAsProp = node => {
-    if (!isNodeOfType(node, 'Identifier')) {
-      return;
-    }
-    if (!node.parent || !node.parent.parent || !node.parent.parent.parent) {
-      return;
-    }
-    if (!isNodeOfType(node.parent, 'JSXExpressionContainer') || !isNodeOfType(node.parent.parent, 'JSXAttribute') || !isNodeOfType(node.parent.parent.parent, 'JSXOpeningElement')) {
-      return;
-    }
-    if (Object.keys(legacyIconImports).includes(node.name) && isNodeOfType(node.parent.parent.name, 'JSXIdentifier') && node.parent.parent.name.name !== 'LEGACY_fallbackIcon') {
-      var _migrationMapObject$s;
-      const migrationMapObject = getMigrationMapObject(legacyIconImports[node.name].packageName);
-      const upcomingIcon = getUpcomingIcons(legacyIconImports[node.name].packageName);
-      const newIcon = migrationMapObject === null || migrationMapObject === void 0 ? void 0 : migrationMapObject.newIcon;
-      const isNewIconMigratable = canAutoMigrateNewIconBasedOnSize(upcomingIcon ? upcomingIcon.sizeGuidance.medium : migrationMapObject === null || migrationMapObject === void 0 ? void 0 : (_migrationMapObject$s = migrationMapObject.sizeGuidance) === null || _migrationMapObject$s === void 0 ? void 0 : _migrationMapObject$s.medium);
-      const isInNewButton = isNodeOfType(node.parent.parent.parent.name, 'JSXIdentifier') && newButtonImports.has(node.parent.parent.parent.name.name);
-      if (newIcon && isInNewButton && isNewIconMigratable || upcomingIcon && isInNewButton && isNewIconMigratable) {
-        createAutoMigrationError({
-          node,
-          importSource: legacyIconImports[node.name].packageName,
-          iconName: node.name,
-          errors: errorsAuto
-        });
-        addToListOfRanges(node, errorRanges);
-        guidance[locToString(node)] = createGuidance({
-          iconPackage: legacyIconImports[node.name].packageName,
-          insideNewButton: true,
-          size: 'medium',
-          shouldUseMigrationPath
-        });
-      } else if (!newIcon && !upcomingIcon || !isNewIconMigratable) {
-        createCantFindSuitableReplacementError(node, legacyIconImports[node.name].packageName, node.name, errorsManual);
-        addToListOfRanges(node, errorRanges);
-        guidance[locToString(node)] = createGuidance({
-          iconPackage: legacyIconImports[node.name].packageName,
-          insideNewButton: isInNewButton,
-          shouldUseMigrationPath
-        });
-      } else if (!isInNewButton) {
-        createCantMigrateFunctionUnknownError(node, legacyIconImports[node.name].packageName, node.name, errorsManual);
-        addToListOfRanges(node, errorRanges);
-        guidance[locToString(node)] = createGuidance({
-          iconPackage: legacyIconImports[node.name].packageName,
-          insideNewButton: false,
-          shouldUseMigrationPath
-        });
-      }
-    }
-  };
-  const checkIconReference = node => {
-    //if this is an import statement then exit early
-    if (node.parent && (isNodeOfType(node.parent, 'ImportSpecifier') || isNodeOfType(node.parent, 'ImportDefaultSpecifier'))) {
-      return;
-    }
-
-    // Flag icons imported from migration path
-    if (!shouldUseMigrationPath && Object.keys(migrationIconImports).includes(node.name)) {
-      createAutoMigrationError({
-        node,
-        importSource: migrationIconImports[node.name].packageName,
-        iconName: node.name,
-        errors: errorsAuto
-      });
-    }
-
-    //check the reference to see if it's a legacy icon, if not exit early
-    if (!Object.keys(legacyIconImports).includes(node.name)) {
-      return;
-    }
-
-    //if in Fallback prop, do not error
-    if (node.parent && node.parent.parent && isNodeOfType(node.parent.parent, 'JSXAttribute') && isNodeOfType(node.parent.parent.name, 'JSXIdentifier') && node.parent.parent.name.name === 'LEGACY_fallbackIcon') {
-      return;
-    }
-    // manually error
-    createCantMigrateIdentifierError(node, legacyIconImports[node.name].packageName, node.name, errorsManual);
-  };
-
-  /**
-   * Checks if a legacy icon is being rendered and stores the errors in the global array
-   * @param node The JSX node found by ESLint
-   */
-  const checkJSXElement = node => {
-    var _node$parent, _node$parent$parent, _node$parent$parent$p;
-    if (!('openingElement' in node) || !isNodeOfType(node.openingElement.name, 'JSXIdentifier')) {
-      return;
-    }
-
-    // Determine if element is rendered inside LEGACY_fallbackIcon prop - if so, don't perform any checks
-    if (node.parent && isNodeOfType(node.parent, 'ArrowFunctionExpression') && (_node$parent = node.parent) !== null && _node$parent !== void 0 && (_node$parent$parent = _node$parent.parent) !== null && _node$parent$parent !== void 0 && _node$parent$parent.parent && isNodeOfType(node.parent.parent.parent, 'JSXAttribute') && ((_node$parent$parent$p = node.parent.parent.parent.name) === null || _node$parent$parent$p === void 0 ? void 0 : _node$parent$parent$p.name) === 'LEGACY_fallbackIcon') {
-      return;
-    }
-    const name = node.openingElement.name.name;
-
-    // Flag icons imported from migration path
-    if (!shouldUseMigrationPath && Object.keys(migrationIconImports).includes(name)) {
-      createAutoMigrationError({
-        node,
-        importSource: migrationIconImports[name].packageName,
-        iconName: name,
-        errors: errorsAuto,
-        spacing: undefined,
-        insideNewButton: true
-      });
-    }
-
-    // Legacy icons rendered as JSX elements
-    if (Object.keys(legacyIconImports).includes(name)) {
-      var _size, _size2, _sizeProp$value2;
-      // Determine if inside a new button - if so:
-      // - Assume spread props are safe - still error if props explicitly set to unmigratable values
-      const insideNewButton = isInsideNewButton(node, newButtonImports);
-
-      // Determine if inside a legacy default button - if so:
-      // the auto fixer will add spacing prop to the medium size icon
-      const insideLegacyButton = isInsideLegacyButton(node, legacyButtonImports);
-      const insideIconOnlyLegacyButton = isInsideIconOnlyLegacyButton(node, legacyButtonImports);
-
-      // Find size prop on node
-      let size = 'medium';
-      let primaryColor = null;
-      let hasPrimaryColorProp = false;
-      let hasSecondaryColorProp = false;
-      let afterSpreadSet = new Set();
-      let requiredAttributesAfterSpread = new Set(['size', 'primaryColor', 'secondaryColor']);
-      let hasSpread = false;
-      for (const attr of node.openingElement.attributes) {
-        // Detect spread props
-        if (isNodeOfType(attr, 'JSXSpreadAttribute')) {
-          // In case there are more spread props
-          afterSpreadSet.clear();
-          hasSpread = true;
-          continue;
-        }
-        if (!isNodeOfType(attr, 'JSXAttribute') || !isNodeOfType(attr.name, 'JSXIdentifier') || !attr.value) {
-          continue;
-        }
-
-        // Register props that aren't being spread
-        afterSpreadSet.add(attr.name.name);
-
-        // Extract values of props
-        switch (attr.name.name) {
-          case 'size':
-            if (isNodeOfType(attr.value, 'Literal') && isSize(attr.value.value)) {
-              size = attr.value.value;
-            } else if (isNodeOfType(attr.value, 'JSXExpressionContainer') && isNodeOfType(attr.value.expression, 'Literal') && isSize(attr.value.expression.value)) {
-              size = attr.value.expression.value;
-            } else {
-              size = null;
-            }
-            break;
-          case 'primaryColor':
-            primaryColor = getPrimaryColor(attr);
-            hasPrimaryColorProp = true;
-            break;
-          case 'secondaryColor':
-            hasSecondaryColorProp = true;
-            break;
-        }
-      }
-      let hasManualMigration = false;
-
-      // Flag manual migration if primary color cannot be migrated
-      if (primaryColor && !canMigrateColor(primaryColor) || hasPrimaryColorProp && !primaryColor) {
-        createCantMigrateColorError(node, primaryColor ? `the value of '${primaryColor}'` : 'a statically unknown value', errorsManual, legacyIconImports[name].packageName, name);
-        hasManualMigration = true;
-      }
-
-      // If size can't be determined (i.e. size is a variable or function call, etc)
-      // then we need to error; icon can't be auto-migrated safely
-      if (size === null) {
-        createCantMigrateSizeUnknown(node, errorsManual, legacyIconImports[name].packageName, name);
-        hasManualMigration = true;
-      }
-
-      // Do a set comparison - is requiredAttributesAfterSpread a subset of afterSpreadSet?
-      if (hasSpread === true && !Array.from(requiredAttributesAfterSpread).every(val => afterSpreadSet.has(val)) && !insideNewButton) {
-        const missingProps = Array.from(requiredAttributesAfterSpread).filter(val => !afterSpreadSet.has(val));
-        createCantMigrateSpreadPropsError(node, missingProps, errorsManual, legacyIconImports[name].packageName, name);
-        hasManualMigration = true;
-      }
-
-      // Check if it is an exported component?
-      if (legacyIconImports[name].exported) {
-        createCantMigrateReExportError(node, legacyIconImports[name].packageName, name, errorsManual);
-        hasManualMigration = true;
-      }
-      const migrationMapObject = getMigrationMapObject(legacyIconImports[name].packageName);
-      const upcomingIcon = getUpcomingIcons(legacyIconImports[name].packageName);
-      const newIcon = migrationMapObject === null || migrationMapObject === void 0 ? void 0 : migrationMapObject.newIcon;
-      const isNewIconMigratable = canAutoMigrateNewIconBasedOnSize(upcomingIcon ? upcomingIcon.sizeGuidance[(_size = size) !== null && _size !== void 0 ? _size : 'medium'] : migrationMapObject === null || migrationMapObject === void 0 ? void 0 : migrationMapObject.sizeGuidance[(_size2 = size) !== null && _size2 !== void 0 ? _size2 : 'medium']);
-
-      // Add spacing if:
-      // 1. size is medium for core/utility icons or not set (default is medium for core and small for utility icons)
-      // 2. not inside a new or legacy button (except for icon-only legacy buttons)
-      const sizeProp = node.openingElement.attributes.find(attribute => attribute.type === 'JSXAttribute' && (attribute.name.name === 'size' || attribute.name.name === 'LEGACY_size'));
-      let spacing;
-      if (!insideNewButton && !(insideLegacyButton && !insideIconOnlyLegacyButton)) {
-        var _sizeProp$value;
-        if (sizeProp && sizeProp.type === 'JSXAttribute' && ((_sizeProp$value = sizeProp.value) === null || _sizeProp$value === void 0 ? void 0 : _sizeProp$value.type) === 'Literal') {
-          if (sizeProp.value.value === 'medium') {
-            spacing = 'spacious';
-          }
-        } else if (!sizeProp) {
-          spacing = 'spacious';
-        }
-      }
-      if (!iconSizesInfo[legacyIconImports[name].packageName]) {
-        iconSizesInfo[legacyIconImports[name].packageName] = {
-          small: [],
-          usageCount: 0
-        };
-      }
-
-      // Do not automatically migration if size is small as we cannot determine if a core icon or a scaled down utility icon should be used
-      if (sizeProp && sizeProp.type === 'JSXAttribute' && ((_sizeProp$value2 = sizeProp.value) === null || _sizeProp$value2 === void 0 ? void 0 : _sizeProp$value2.type) === 'Literal' && sizeProp.value.value === 'small') {
-        iconSizesInfo[legacyIconImports[name].packageName].small.push(locToString(node));
-      }
-      iconSizesInfo[legacyIconImports[name].packageName].usageCount++;
-      const shouldForceSmallIcon = newIcon === null || newIcon === void 0 ? void 0 : newIcon.shouldForceSmallIcon;
-      if (shouldUseSafeMigrationMode && !hasManualMigration && (newIcon !== null && newIcon !== void 0 && newIcon.isMigrationUnsafe || size !== 'medium' || hasSecondaryColorProp)) {
-        createCantFindSuitableReplacementError(node, legacyIconImports[name].packageName, name, errorsManual, upcomingIcon ? true : migrationMapObject ? true : false);
-      } else if (!hasManualMigration && (newIcon || upcomingIcon) && isNewIconMigratable) {
-        createAutoMigrationError({
-          node,
-          importSource: legacyIconImports[name].packageName,
-          iconName: name,
-          errors: errorsAuto,
-          spacing,
-          insideNewButton,
-          shouldForceSmallIcon
-        });
-      } else if ((!newIcon && !upcomingIcon || !isNewIconMigratable) && size) {
-        createCantFindSuitableReplacementError(node, legacyIconImports[name].packageName, name, errorsManual, upcomingIcon ? true : migrationMapObject ? true : false);
-      }
-      addToListOfRanges(node, errorRanges);
-      guidance[locToString(node)] = createGuidance({
-        iconPackage: legacyIconImports[name].packageName,
-        insideNewButton,
-        size: size && isSize(size) ? size : undefined,
-        shouldUseMigrationPath,
-        shouldForceSmallIcon
-      });
-    }
-  };
-
-  /**
-   * Checks if a legacy icon is being passed into a function call and stores the errors in the global array
-   * @param node The function call node found by ESLint
-   */
-  const checkCallExpression = node => {
-    if (Object.keys(node).includes('arguments') && node.arguments.length) {
-      for (const arg of node.arguments) {
-        if (isNodeOfType(arg, 'Identifier') && Object.keys(legacyIconImports).includes(arg.name) && legacyIconImports[arg.name].packageName) {
-          createCantMigrateFunctionUnknownError(node, legacyIconImports[arg.name].packageName, arg.name, errorsManual);
-          addToListOfRanges(node, errorRanges);
-          guidance[locToString(node)] = createGuidance({
-            iconPackage: legacyIconImports[arg.name].packageName,
-            shouldUseMigrationPath
-          });
-        }
-      }
-    }
-  };
-
-  /**
-   * Throws the relevant errors in the correct order based on configs.
-   */
-  const throwErrors = () => {
-    // Throw manual errors
-    if (shouldErrorForManualMigration) {
-      throwManualErrors({
-        errorsManual,
-        errorRanges,
-        guidance,
-        context,
-        isQuietMode
-      });
-    }
-    if (shouldErrorForAutoMigration) {
-      throwAutoErrors({
-        errorsManual,
-        errorsAuto,
-        iconSizesInfo,
-        legacyIconImports,
-        guidance,
-        migrationIconImports,
-        shouldUseMigrationPath,
-        context
-      });
-    }
-  };
-  return {
-    checkImportDeclarations,
-    checkVariableDeclarations,
-    checkExportDefaultDeclaration,
-    checkExportNamedVariables,
-    checkArrayOrMap,
-    checkIconAsProp,
-    checkJSXElement,
-    checkCallExpression,
-    throwErrors,
-    checkIconReference
-  };
-};