@atlaskit/eslint-plugin-design-system 10.8.0 → 10.8.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @atlaskit/eslint-plugin-design-system
 
+## 10.8.2
+
+### Patch Changes
+
+- [#115815](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/115815)
+  [`0368d6009fc75`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0368d6009fc75) -
+  Adds better suggestions to the no-legacy-icons lint rule to detect manual and automatic migration
+  opportunities.
+
+## 10.8.1
+
+### Patch Changes
+
+- [#113465](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/113465)
+  [`1b198cf33c32e`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/1b198cf33c32e) -
+  Create `use-latest-xcss-syntax-typography` rule. Bans the use of 'fontSize', 'lineHeight',
+  'fontWeight' on xcss.
+- Updated dependencies
+
 ## 10.8.0
 
 ### Minor Changes

package/README.md

@@ -81,6 +81,7 @@ module.exports = {
 | <a href="./src/rules/use-heading-level-in-spotlight-card/README.md">use-heading-level-in-spotlight-card</a>                 | Inform developers of eventual requirement of `headingLevel` prop in `SpotlightCard` component. The heading level should be the appropriate level according to the surrounding context.                                                                                                                              | Yes         | Yes     |             |
 | <a href="./src/rules/use-href-in-link-item/README.md">use-href-in-link-item</a>                                             | Inform developers of eventual requirement of `href` prop in `LinkItem` component. Elements with a `link` role require an `href` attribute for users to properly navigate, particularly those using assistive technologies. If no valid `href` is required for your use case, consider using a `ButtonItem` instead. | Yes         | Yes     | Yes         |
 | <a href="./src/rules/use-latest-xcss-syntax/README.md">use-latest-xcss-syntax</a>                                           | Enforces usage of space design tokens rather than hard-coded values in xcss.                                                                                                                                                                                                                                        | Yes         | Yes     |             |
+| <a href="./src/rules/use-latest-xcss-syntax-typography/README.md">use-latest-xcss-syntax-typography</a>                     | Prohibits use of unsafe styling properties in xcss. Please use Text/Heading primitives instead.                                                                                                                                                                                                                     | Yes         | Yes     |             |
 | <a href="./src/rules/use-menu-section-title/README.md">use-menu-section-title</a>                                           | Encourages makers to provide accessible title for Atlassian Design System Menu Section component.                                                                                                                                                                                                                   | Yes         |         | Yes         |
 | <a href="./src/rules/use-popup-label/README.md">use-popup-label</a>                                                         | Encourages to provide accessible name for Atlassian Design System Popup component.                                                                                                                                                                                                                                  | Yes         |         | Yes         |
 | <a href="./src/rules/use-primitives/README.md">use-primitives</a>                                                           | Encourage the usage of primitives components.                                                                                                                                                                                                                                                                       |             | Yes     | Yes         |

package/constellation/index/usage.mdx

@@ -44,6 +44,7 @@ This plugin contains rules that should be used when working with the
 | <a href="/components/eslint-plugin-design-system/use-heading-level-in-spotlight-card/usage">use-heading-level-in-spotlight-card</a>                 | Inform developers of eventual requirement of `headingLevel` prop in `SpotlightCard` component. The heading level should be the appropriate level according to the surrounding context.                                                                                                                              | Yes         | Yes     |             |
 | <a href="/components/eslint-plugin-design-system/use-href-in-link-item/usage">use-href-in-link-item</a>                                             | Inform developers of eventual requirement of `href` prop in `LinkItem` component. Elements with a `link` role require an `href` attribute for users to properly navigate, particularly those using assistive technologies. If no valid `href` is required for your use case, consider using a `ButtonItem` instead. | Yes         | Yes     | Yes         |
 | <a href="/components/eslint-plugin-design-system/use-latest-xcss-syntax/usage">use-latest-xcss-syntax</a>                                           | Enforces usage of space design tokens rather than hard-coded values in xcss.                                                                                                                                                                                                                                        | Yes         | Yes     |             |
+| <a href="/components/eslint-plugin-design-system/use-latest-xcss-syntax-typography/usage">use-latest-xcss-syntax-typography</a>                     | Prohibits use of unsafe styling properties in xcss. Please use Text/Heading primitives instead.                                                                                                                                                                                                                     | Yes         | Yes     |             |
 | <a href="/components/eslint-plugin-design-system/use-menu-section-title/usage">use-menu-section-title</a>                                           | Encourages makers to provide accessible title for Atlassian Design System Menu Section component.                                                                                                                                                                                                                   | Yes         |         | Yes         |
 | <a href="/components/eslint-plugin-design-system/use-popup-label/usage">use-popup-label</a>                                                         | Encourages to provide accessible name for Atlassian Design System Popup component.                                                                                                                                                                                                                                  | Yes         |         | Yes         |
 | <a href="/components/eslint-plugin-design-system/use-primitives/usage">use-primitives</a>                                                           | Encourage the usage of primitives components.                                                                                                                                                                                                                                                                       |             | Yes     | Yes         |

package/constellation/use-latest-xcss-syntax-typography/usage.mdx

@@ -0,0 +1,34 @@
+# use-latest-xcss-syntax-typography
+
+## Description
+
+Soon, applying `fontSize`, `lineHeight`, `fontWeight` with `xcss` will be deprecated. Please refrain
+from adding new usages, as you will need to remove them soon anyway. As an alternative, you can use
+the `Text` and `Heading` primitives.
+
+## Examples
+
+### Incorrect
+
+```jsx
+const myStyles = xcss({
+	fontSize: '14px',
+	^^^^^^^^^^^^^^^^
+	lineHeight: '20px',
+	^^^^^^^^^^^^^^^^^^
+	fontWeight: 500,
+	^^^^^^^^^^^^^^^
+});
+
+<Box as="p" xcss={myStyles}>
+	...
+</Box>;
+```
+
+### Correct
+
+```jsx
+import { Text } from '@atlaskit/primitives';
+
+<Text weight="medium">...</Text>;
+```

package/dist/cjs/ast-nodes/object-entry.js

@@ -66,7 +66,8 @@ var ObjectEntry = exports.ObjectEntry = {
       return undefined;
     }
     if ((0, _eslintCodemodUtils.isNodeOfType)(node.key, 'Literal')) {
-      return node.key.raw;
+      var _node$key$value;
+      return (_node$key$value = node.key.value) === null || _node$key$value === void 0 ? void 0 : _node$key$value.toString();
     }
     if ((0, _eslintCodemodUtils.isNodeOfType)(node.key, 'Identifier')) {
       return node.key.name;

package/dist/cjs/presets/all.codegen.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 /**
  * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
- * @codegen <<SignedSource::837556032f39113ae86785a120bb9ccb>>
+ * @codegen <<SignedSource::9bb5329713677543f16019954484ae2f>>
  * @codegenCommand yarn workspace @atlaskit/eslint-plugin-design-system codegen
  */
 var _default = exports.default = {
@@ -44,6 +44,7 @@ var _default = exports.default = {
     '@atlaskit/design-system/use-heading-level-in-spotlight-card': 'warn',
     '@atlaskit/design-system/use-href-in-link-item': 'warn',
     '@atlaskit/design-system/use-latest-xcss-syntax': 'error',
+    '@atlaskit/design-system/use-latest-xcss-syntax-typography': 'warn',
     '@atlaskit/design-system/use-menu-section-title': 'warn',
     '@atlaskit/design-system/use-popup-label': 'warn',
     '@atlaskit/design-system/use-primitives': 'warn',

package/dist/cjs/presets/recommended.codegen.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 /**
  * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
- * @codegen <<SignedSource::b7ed527a03208f0bc68f9d34e4ef2260>>
+ * @codegen <<SignedSource::76bee1648b1b78d3ad253f0704a9cac7>>
  * @codegenCommand yarn workspace @atlaskit/eslint-plugin-design-system codegen
  */
 var _default = exports.default = {
@@ -34,6 +34,7 @@ var _default = exports.default = {
     '@atlaskit/design-system/use-heading-level-in-spotlight-card': 'warn',
     '@atlaskit/design-system/use-href-in-link-item': 'warn',
     '@atlaskit/design-system/use-latest-xcss-syntax': 'error',
+    '@atlaskit/design-system/use-latest-xcss-syntax-typography': 'warn',
     '@atlaskit/design-system/use-menu-section-title': 'warn',
     '@atlaskit/design-system/use-popup-label': 'warn',
     '@atlaskit/design-system/use-visually-hidden': 'error'

package/dist/cjs/rules/ensure-design-token-usage/index.js

@@ -9,10 +9,10 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/sli
 var _eslintCodemodUtils = require("eslint-codemod-utils");
 var _isSupportedImport = require("@atlaskit/eslint-utils/is-supported-import");
 var _createRule = require("../utils/create-rule");
+var _errorBoundary = require("../utils/error-boundary");
 var _isColor = require("../utils/is-color");
 var _isNode = require("../utils/is-node");
 var _color = require("./color");
-var _errorBoundary = require("./error-boundary");
 var _ruleMeta = _interopRequireDefault(require("./rule-meta"));
 var _spacing = require("./spacing");
 var _utils = require("./utils");

package/dist/cjs/rules/index.codegen.js

@@ -37,6 +37,7 @@ var _useHeading = _interopRequireDefault(require("./use-heading"));
 var _useHeadingLevelInSpotlightCard = _interopRequireDefault(require("./use-heading-level-in-spotlight-card"));
 var _useHrefInLinkItem = _interopRequireDefault(require("./use-href-in-link-item"));
 var _useLatestXcssSyntax = _interopRequireDefault(require("./use-latest-xcss-syntax"));
+var _useLatestXcssSyntaxTypography = _interopRequireDefault(require("./use-latest-xcss-syntax-typography"));
 var _useMenuSectionTitle = _interopRequireDefault(require("./use-menu-section-title"));
 var _usePopupLabel = _interopRequireDefault(require("./use-popup-label"));
 var _usePrimitives = _interopRequireDefault(require("./use-primitives"));
@@ -46,7 +47,7 @@ var _useTokensTypography = _interopRequireDefault(require("./use-tokens-typograp
 var _useVisuallyHidden = _interopRequireDefault(require("./use-visually-hidden"));
 /**
  * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
- * @codegen <<SignedSource::287628b11d396c2bcbcf6f4a175a3d3a>>
+ * @codegen <<SignedSource::b359d356c482db0087ddfce5bd105403>>
  * @codegenCommand yarn workspace @atlaskit/eslint-plugin-design-system codegen
  */
 var _default = exports.default = {
@@ -82,6 +83,7 @@ var _default = exports.default = {
   'use-heading-level-in-spotlight-card': _useHeadingLevelInSpotlightCard.default,
   'use-href-in-link-item': _useHrefInLinkItem.default,
   'use-latest-xcss-syntax': _useLatestXcssSyntax.default,
+  'use-latest-xcss-syntax-typography': _useLatestXcssSyntaxTypography.default,
   'use-menu-section-title': _useMenuSectionTitle.default,
   'use-popup-label': _usePopupLabel.default,
   'use-primitives': _usePrimitives.default,

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

@@ -0,0 +1,484 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createChecks = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _eslintCodemodUtils = require("eslint-codemod-utils");
+var _helpers = require("./helpers");
+var _migrationMapTemp = require("./migration-map-temp");
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+var createChecks = exports.createChecks = function createChecks(context) {
+  //create global variables to be shared by the checks
+  var _createHelpers = (0, _helpers.createHelpers)(context),
+    getPrimaryColor = _createHelpers.getPrimaryColor,
+    getConfigFlag = _createHelpers.getConfigFlag;
+  var legacyIconImports = {};
+  var newButtonImports = new Set();
+  var errorsManual = {};
+  var errorsAuto = {};
+  var guidance = {};
+
+  // Extract parameters
+  var shouldErrorForManualMigration = getConfigFlag('shouldErrorForManualMigration', true);
+  var shouldErrorForAutoMigration = getConfigFlag('shouldErrorForAutoMigration', true);
+  var isQuietMode = getConfigFlag('quiet', false);
+
+  /**
+   * 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
+   */
+  var checkImportDeclarations = function checkImportDeclarations(node) {
+    var moduleSource = node.source.value;
+
+    // Find the imports for legacy icons
+    if (moduleSource && typeof moduleSource === 'string' && ['@atlaskit/icon/glyph/', '@atlaskit/icon-object/glyph/'].find(function (val) {
+      return moduleSource.startsWith(val);
+    }) && node.specifiers.length > 0) {
+      var _iterator = _createForOfIteratorHelper(node.specifiers),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var spec = _step.value;
+          if (spec.local.name) {
+            legacyIconImports[spec.local.name] = {
+              packageName: moduleSource,
+              exported: false
+            };
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+
+    // Find the imports for new button and IconButton
+    if (typeof moduleSource === 'string' && moduleSource.startsWith('@atlaskit/button/new') && node.specifiers.length) {
+      var _iterator2 = _createForOfIteratorHelper(node.specifiers),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var _spec = _step2.value;
+          if (_spec.type === 'ImportDefaultSpecifier') {
+            newButtonImports.add(_spec.local.name);
+          } else if (_spec.type === 'ImportSpecifier' && _spec.imported.name === 'IconButton') {
+            newButtonImports.add(_spec.local.name);
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+  };
+
+  /**
+   * 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
+   */
+  var checkVariableDeclarations = function checkVariableDeclarations(node) {
+    if ((0, _eslintCodemodUtils.isNodeOfType)(node, 'VariableDeclaration')) {
+      var isExported = node.parent && (0, _eslintCodemodUtils.isNodeOfType)(node.parent, 'ExportNamedDeclaration');
+      var _iterator3 = _createForOfIteratorHelper(node.declarations),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var decl = _step3.value;
+          if ((0, _eslintCodemodUtils.isNodeOfType)(decl, 'VariableDeclarator') && 'init' in decl && 'id' in decl && decl.init && decl.id && 'name' in decl.id && decl.id.name && (0, _eslintCodemodUtils.isNodeOfType)(decl.init, 'Identifier')) {
+            if (decl.init.name in legacyIconImports) {
+              legacyIconImports[decl.id.name] = {
+                packageName: legacyIconImports[decl.init.name].packageName,
+                exported: legacyIconImports[decl.init.name].exported || isExported
+              };
+            } else if (newButtonImports.has(decl.init.name)) {
+              newButtonImports.add(decl.id.name);
+            }
+          }
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+  };
+
+  /**
+   * 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
+   */
+  var checkExportDefaultDeclaration = function checkExportDefaultDeclaration(node) {
+    var exportName = '';
+    var packageName = '';
+    if ('declaration' in node && node.declaration && (0, _eslintCodemodUtils.isNodeOfType)(node.declaration, 'Identifier') && node.declaration.name in legacyIconImports) {
+      packageName = legacyIconImports[node.declaration.name].packageName;
+      exportName = 'Default export';
+    } else if ('declaration' in node && node.declaration && (0, _eslintCodemodUtils.isNodeOfType)(node.declaration, 'AssignmentExpression') && (0, _eslintCodemodUtils.isNodeOfType)(node.declaration.left, 'Identifier') && (0, _eslintCodemodUtils.isNodeOfType)(node.declaration.right, 'Identifier') && node.declaration.right.name in legacyIconImports) {
+      packageName = legacyIconImports[node.declaration.right.name].packageName;
+      exportName = node.declaration.left.name;
+    } else {
+      return;
+    }
+    (0, _helpers.createCantMigrateReExportError)(node, packageName, exportName, errorsManual);
+    guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(packageName);
+  };
+
+  /**
+   * 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
+   */
+  var checkExportNamedVariables = function checkExportNamedVariables(node) {
+    // export {default as AddIcon} from '@atlaskit/icon/glyph/add';
+    if (node.source && (0, _eslintCodemodUtils.isNodeOfType)(node.source, 'Literal') && 'value' in node.source) {
+      var moduleSource = node.source.value;
+      if (typeof moduleSource === 'string' && ['@atlaskit/icon/glyph/', '@atlaskit/icon-object/glyph/'].find(function (val) {
+        return moduleSource.startsWith(val);
+      }) && node.specifiers.length) {
+        (0, _helpers.createCantMigrateReExportError)(node, moduleSource, node.specifiers[0].exported.name, errorsManual);
+        guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(moduleSource);
+      }
+    } else if (node.declaration && (0, _eslintCodemodUtils.isNodeOfType)(node.declaration, 'VariableDeclaration')) {
+      // export const Icon = AddIcon;
+      var _iterator4 = _createForOfIteratorHelper(node.declaration.declarations),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var decl = _step4.value;
+          if ((0, _eslintCodemodUtils.isNodeOfType)(decl, 'VariableDeclarator') && 'init' in decl && decl.init && (0, _eslintCodemodUtils.isNodeOfType)(decl.init, 'Identifier') && decl.init.name in legacyIconImports) {
+            (0, _helpers.createCantMigrateReExportError)(node, legacyIconImports[decl.init.name].packageName, decl.init.name, errorsManual);
+            guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)((0, _helpers.createGuidance)(legacyIconImports[decl.init.name].packageName));
+          }
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+    } 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 }
+       */
+      var _iterator5 = _createForOfIteratorHelper(node.specifiers),
+        _step5;
+      try {
+        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+          var spec = _step5.value;
+          if (spec.local.name in legacyIconImports) {
+            //update legacy imports to be exported
+            legacyIconImports[spec.local.name] = {
+              packageName: legacyIconImports[spec.local.name].packageName,
+              exported: true
+            };
+            (0, _helpers.createCantMigrateReExportError)(spec, legacyIconImports[spec.local.name].packageName, spec.exported.name, errorsManual);
+            guidance[(0, _helpers.locToString)(spec)] = (0, _helpers.createGuidance)(legacyIconImports[spec.local.name].packageName);
+          }
+        }
+      } catch (err) {
+        _iterator5.e(err);
+      } finally {
+        _iterator5.f();
+      }
+    }
+  };
+
+  /**
+   * 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
+   */
+  var checkArrayOrMap = function checkArrayOrMap(node) {
+    if (!(0, _eslintCodemodUtils.isNodeOfType)(node, 'Identifier')) {
+      return;
+    }
+    if (node.name && node.name in legacyIconImports && legacyIconImports[node.name].packageName) {
+      (0, _helpers.createCantMigrateIdentifierError)(node, legacyIconImports[node.name].packageName, node.name, errorsManual);
+      guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(legacyIconImports[node.name].packageName);
+    }
+  };
+
+  /**
+   * 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
+   */
+  var checkIconAsProp = function checkIconAsProp(node) {
+    if (!(0, _eslintCodemodUtils.isNodeOfType)(node, 'Identifier')) {
+      return;
+    }
+    if (!node.parent || !node.parent.parent || !node.parent.parent.parent) {
+      return;
+    }
+    if (!(0, _eslintCodemodUtils.isNodeOfType)(node.parent, 'JSXExpressionContainer') || !(0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent, 'JSXAttribute') || !(0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent.parent, 'JSXOpeningElement')) {
+      return;
+    }
+    if (node.name in legacyIconImports && (0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent.name, 'JSXIdentifier') && node.parent.parent.name.name !== 'LEGACY_fallbackIcon') {
+      var _migrationMapObject$s;
+      var migrationMapObject = (0, _helpers.getMigrationMapObject)(legacyIconImports[node.name].packageName);
+      var newIcon = migrationMapObject === null || migrationMapObject === void 0 ? void 0 : migrationMapObject.newIcon;
+      var isNewIconMigratable = (0, _helpers.canAutoMigrateNewIconBasedOnSize)(migrationMapObject === null || migrationMapObject === void 0 || (_migrationMapObject$s = migrationMapObject.sizeGuidance) === null || _migrationMapObject$s === void 0 ? void 0 : _migrationMapObject$s.medium);
+      var isInNewButton = (0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent.parent.name, 'JSXIdentifier') && newButtonImports.has(node.parent.parent.parent.name.name);
+      var UNSAFE_size = null;
+      var UNSAFE_propName = null;
+      if (isInNewButton) {
+        var result = (0, _helpers.findUNSAFEProp)(node.parent.parent, node.parent.parent.parent);
+        UNSAFE_size = result.UNSAFE_size;
+        UNSAFE_propName = result.UNSAFE_propName;
+      }
+      if (newIcon && isInNewButton && isNewIconMigratable && UNSAFE_size !== 'large' && UNSAFE_size !== 'xlarge') {
+        var iconKey = (0, _helpers.getIconKey)(legacyIconImports[node.name].packageName);
+        (0, _helpers.createAutoMigrationError)(node, legacyIconImports[node.name].packageName, node.name, newIcon, iconKey, errorsAuto);
+        guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(legacyIconImports[node.name].packageName, 'medium');
+      } else if ((!newIcon || !isNewIconMigratable) && !UNSAFE_size) {
+        (0, _helpers.createCantFindSuitableReplacementError)(node, legacyIconImports[node.name].packageName, node.name, errorsManual);
+        guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(legacyIconImports[node.name].packageName);
+      } else if ((UNSAFE_size === 'large' || UNSAFE_size === 'xlarge') && UNSAFE_propName) {
+        (0, _helpers.createCantMigrateUnsafeProp)(node, UNSAFE_propName, UNSAFE_size, legacyIconImports[node.name].packageName, node.name, errorsManual);
+        guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(legacyIconImports[node.name].packageName, UNSAFE_size);
+      } else if (!isInNewButton) {
+        (0, _helpers.createCantMigrateFunctionUnknownError)(node, legacyIconImports[node.name].packageName, node.name, errorsManual);
+        guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(legacyIconImports[node.name].packageName);
+      }
+    }
+  };
+
+  /**
+   * Checks if a legacy icon is being rendered and stores the errors in the global array
+   * @param node The JSX node found by ESLint
+   */
+  var checkJSXElement = function checkJSXElement(node) {
+    var _node$parent, _node$parent$parent$p;
+    if (!('openingElement' in node) || !(0, _eslintCodemodUtils.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 && (0, _eslintCodemodUtils.isNodeOfType)(node.parent, 'ArrowFunctionExpression') && (_node$parent = node.parent) !== null && _node$parent !== void 0 && (_node$parent = _node$parent.parent) !== null && _node$parent !== void 0 && _node$parent.parent && (0, _eslintCodemodUtils.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;
+    }
+    var name = node.openingElement.name.name;
+    // Legacy icons rendered as JSX elements
+    if (name in legacyIconImports) {
+      var _node$parent2, _node$parent3, _size;
+      // Determine if inside a new button - if so:
+      // - Assume spread props are safe - still error if props explicitly set to unmigratable values
+      // - eventually: look for UNSAFE_iconBefore_size props on the parent button - if it's large/xlarge, fail
+      var insideNewButton = false;
+      var UNSAFE_propName = null;
+      var UNSAFE_size = null;
+      if (node.parent && (0, _eslintCodemodUtils.isNodeOfType)(node.parent, 'ArrowFunctionExpression') && (_node$parent2 = node.parent) !== null && _node$parent2 !== void 0 && (_node$parent2 = _node$parent2.parent) !== null && _node$parent2 !== void 0 && _node$parent2.parent && (0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent.parent, 'JSXAttribute') && (0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent.parent.name, 'JSXIdentifier') && (_node$parent3 = node.parent) !== null && _node$parent3 !== void 0 && (_node$parent3 = _node$parent3.parent) !== null && _node$parent3 !== void 0 && (_node$parent3 = _node$parent3.parent) !== null && _node$parent3 !== void 0 && _node$parent3.parent && (0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent.parent.parent, 'JSXOpeningElement') && (0, _eslintCodemodUtils.isNodeOfType)(node.parent.parent.parent.parent.name, 'JSXIdentifier') && newButtonImports.has(node.parent.parent.parent.parent.name.name)) {
+        insideNewButton = true;
+        var result = (0, _helpers.findUNSAFEProp)(node.parent.parent.parent, node.parent.parent.parent.parent);
+        UNSAFE_size = result.UNSAFE_size;
+        UNSAFE_propName = result.UNSAFE_propName;
+      }
+
+      // Find size prop on node
+      var size = 'medium';
+      var primaryColor = null;
+      var afterSpreadSet = new Set();
+      var requiredAttributesAfterSpread = new Set(['size', 'primaryColor', 'secondaryColor']);
+      var hasSpread = false;
+      var hasPrimaryColorProp = false;
+      var _iterator6 = _createForOfIteratorHelper(node.openingElement.attributes),
+        _step6;
+      try {
+        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+          var attr = _step6.value;
+          // Detect spread props
+          if ((0, _eslintCodemodUtils.isNodeOfType)(attr, 'JSXSpreadAttribute')) {
+            // In case there are more spread props
+            afterSpreadSet.clear();
+            hasSpread = true;
+            continue;
+          }
+          if (!(0, _eslintCodemodUtils.isNodeOfType)(attr, 'JSXAttribute') || !(0, _eslintCodemodUtils.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 ((0, _eslintCodemodUtils.isNodeOfType)(attr.value, 'Literal') && (0, _migrationMapTemp.isSize)(attr.value.value)) {
+                size = attr.value.value;
+              } else if ((0, _eslintCodemodUtils.isNodeOfType)(attr.value, 'JSXExpressionContainer') && (0, _eslintCodemodUtils.isNodeOfType)(attr.value.expression, 'Literal') && (0, _migrationMapTemp.isSize)(attr.value.expression.value)) {
+                size = attr.value.expression.value;
+              } else {
+                size = null;
+              }
+              break;
+            case 'primaryColor':
+              primaryColor = getPrimaryColor(attr);
+              hasPrimaryColorProp = true;
+              break;
+          }
+        }
+      } catch (err) {
+        _iterator6.e(err);
+      } finally {
+        _iterator6.f();
+      }
+      var hasManualMigration = false;
+      if (primaryColor && !(0, _helpers.canMigrateColor)(primaryColor) || hasPrimaryColorProp && !primaryColor) {
+        (0, _helpers.createCantMigrateColorError)(node, primaryColor ? "the value of '".concat(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) {
+        (0, _helpers.createCantMigrateSizeUnknown)(node, errorsManual, legacyIconImports[name].packageName, name);
+        hasManualMigration = true;
+      }
+      guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(legacyIconImports[name].packageName, size ? size : undefined);
+      // Check for unsafe size
+      if ((UNSAFE_size === 'large' || UNSAFE_size === 'xlarge') && (UNSAFE_propName === 'UNSAFE_iconAfter_size' || UNSAFE_propName === 'UNSAFE_iconBefore_size' || UNSAFE_propName === 'UNSAFE_size')) {
+        (0, _helpers.createCantMigrateUnsafeProp)(node, UNSAFE_propName, UNSAFE_size, legacyIconImports[name].packageName, name, errorsManual);
+        hasManualMigration = true;
+      }
+      // Do a set comparison - is requiredAttributesAfterSpread a subset of afterSpreadSet?
+      if (hasSpread === true && !Array.from(requiredAttributesAfterSpread).every(function (val) {
+        return afterSpreadSet.has(val);
+      }) && !insideNewButton) {
+        var missingProps = Array.from(requiredAttributesAfterSpread).filter(function (val) {
+          return !afterSpreadSet.has(val);
+        });
+        (0, _helpers.createCantMigrateSpreadPropsError)(node, missingProps, errorsManual, legacyIconImports[name].packageName, name);
+        hasManualMigration = true;
+      }
+      // Check if it is an exported component?
+      if (legacyIconImports[name].exported) {
+        (0, _helpers.createCantMigrateReExportError)(node, legacyIconImports[name].packageName, name, errorsManual);
+        hasManualMigration = true;
+      }
+      var migrationMapObject = (0, _helpers.getMigrationMapObject)(legacyIconImports[name].packageName);
+      var iconKey = (0, _helpers.getIconKey)(legacyIconImports[name].packageName);
+      var newIcon = migrationMapObject === null || migrationMapObject === void 0 ? void 0 : migrationMapObject.newIcon;
+      var isNewIconMigratable = (0, _helpers.canAutoMigrateNewIconBasedOnSize)(migrationMapObject === null || migrationMapObject === void 0 ? void 0 : migrationMapObject.sizeGuidance[(_size = size) !== null && _size !== void 0 ? _size : 'medium']);
+      if (!hasManualMigration && newIcon && isNewIconMigratable) {
+        (0, _helpers.createAutoMigrationError)(node, legacyIconImports[name].packageName, name, newIcon, iconKey, errorsAuto);
+      } else if ((!newIcon || !isNewIconMigratable) && size) {
+        (0, _helpers.createCantFindSuitableReplacementError)(node, legacyIconImports[name].packageName, name, errorsManual);
+      }
+    }
+  };
+
+  /**
+   * 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
+   */
+  var checkCallExpression = function checkCallExpression(node) {
+    if ('arguments' in node && node.arguments.length) {
+      var _iterator7 = _createForOfIteratorHelper(node.arguments),
+        _step7;
+      try {
+        for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
+          var arg = _step7.value;
+          if ((0, _eslintCodemodUtils.isNodeOfType)(arg, 'Identifier') && arg.name in legacyIconImports && legacyIconImports[arg.name].packageName) {
+            (0, _helpers.createCantMigrateFunctionUnknownError)(node, legacyIconImports[arg.name].packageName, arg.name, errorsManual);
+            guidance[(0, _helpers.locToString)(node)] = (0, _helpers.createGuidance)(legacyIconImports[arg.name].packageName);
+          }
+        }
+      } catch (err) {
+        _iterator7.e(err);
+      } finally {
+        _iterator7.f();
+      }
+    }
+  };
+
+  /**
+   * Throws the relevant errors in the correct order based on configs.
+   */
+  var throwErrors = function throwErrors() {
+    if (shouldErrorForManualMigration) {
+      for (var _i = 0, _Object$entries = Object.entries(errorsManual); _i < _Object$entries.length; _i++) {
+        var _Object$entries$_i = (0, _slicedToArray2.default)(_Object$entries[_i], 2),
+          _key = _Object$entries$_i[0],
+          errorList = _Object$entries$_i[1];
+        var node = 'node' in errorList.errors[0] ? errorList.errors[0].node : null;
+        if (node) {
+          context.report({
+            node: node,
+            messageId: 'noLegacyIconsManualMigration',
+            data: {
+              iconName: errorList.iconName,
+              importSource: errorList.importSource,
+              quietModeGuidance: isQuietMode ? 'For more information see the below errors:' : ''
+            }
+          });
+          if (!isQuietMode) {
+            var _iterator8 = _createForOfIteratorHelper(errorList.errors),
+              _step8;
+            try {
+              for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+                var error = _step8.value;
+                context.report(error);
+              }
+            } catch (err) {
+              _iterator8.e(err);
+            } finally {
+              _iterator8.f();
+            }
+            if (_key in guidance) {
+              context.report({
+                node: node,
+                messageId: 'guidance',
+                data: {
+                  guidance: guidance[_key]
+                }
+              });
+            }
+          }
+        }
+      }
+    }
+    if (shouldErrorForAutoMigration) {
+      for (var _i2 = 0, _Object$entries2 = Object.entries(errorsAuto); _i2 < _Object$entries2.length; _i2++) {
+        var _Object$entries2$_i = (0, _slicedToArray2.default)(_Object$entries2[_i2], 2),
+          _key2 = _Object$entries2$_i[0],
+          _error = _Object$entries2$_i[1];
+        // If there's a manual error that exists for this same component,
+        // don't throw the auto error
+        if (_key2 in errorsManual) {
+          delete errorsAuto[_key2];
+          continue;
+        }
+        var _node = 'node' in _error ? _error.node : null;
+        if (_node) {
+          context.report(_error);
+          if (_key2 in guidance && !isQuietMode) {
+            context.report({
+              node: _node,
+              messageId: 'guidance',
+              data: {
+                guidance: guidance[_key2]
+              }
+            });
+          }
+        }
+      }
+    }
+  };
+  return {
+    checkImportDeclarations: checkImportDeclarations,
+    checkVariableDeclarations: checkVariableDeclarations,
+    checkExportDefaultDeclaration: checkExportDefaultDeclaration,
+    checkExportNamedVariables: checkExportNamedVariables,
+    checkArrayOrMap: checkArrayOrMap,
+    checkIconAsProp: checkIconAsProp,
+    checkJSXElement: checkJSXElement,
+    checkCallExpression: checkCallExpression,
+    throwErrors: throwErrors
+  };
+};