@atlaskit/codemod-cli 0.28.0 → 0.28.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @atlaskit/codemod-cli
 
+## 0.28.1
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 0.28.0
 
 ### Minor Changes

package/dist/cjs/main.js

@@ -314,7 +314,7 @@ var defaultFlags = {
   ignorePattern: 'node_modules',
   logger: console
 };
-function processLifecycleHook(_x9, _x10, _x11, _x12, _x13) {
+function processLifecycleHook(_x9, _x0, _x1, _x10, _x11) {
   return _processLifecycleHook.apply(this, arguments);
 }
 function _processLifecycleHook() {
@@ -346,7 +346,7 @@ function _processLifecycleHook() {
   }));
   return _processLifecycleHook.apply(this, arguments);
 }
-function main(_x14, _x15) {
+function main(_x12, _x13) {
   return _main.apply(this, arguments);
 }
 function _main() {
@@ -362,7 +362,7 @@ function _main() {
         case 4:
           _yield$parseArgs = _context6.sent;
           packages = _yield$parseArgs.packages;
-          _process$env$_PACKAGE = "0.28.0", _PACKAGE_VERSION_ = _process$env$_PACKAGE === void 0 ? '0.0.0-dev' : _process$env$_PACKAGE;
+          _process$env$_PACKAGE = "0.28.1", _PACKAGE_VERSION_ = _process$env$_PACKAGE === void 0 ? '0.0.0-dev' : _process$env$_PACKAGE;
           logger.log(_chalk.default.bgBlue(_chalk.default.black("\uD83D\uDCDA Atlassian-Frontend codemod library @ ".concat(_PACKAGE_VERSION_, " \uD83D\uDCDA"))));
           if (packages && packages.length > 0) {
             logger.log(_chalk.default.gray("Searching for codemods for newer versions of the following packages: ".concat(packages.map(function (pkg) {

package/dist/cjs/presets/remove-token-fallbacks/remove-token-fallbacks.js

@@ -44,6 +44,14 @@ var execAsync = (0, _util.promisify)(_child_process.exec);
  *   @param {boolean} [options.useLegacyColorTheme] - If true, uses the legacy theme for color token mapping.
  *   @param {string} [options.reportFolder] - Directory path to output transformation reports. Reports will be generated only if this option is provided.
  *   @param {boolean} [options.dry] - If true, performs a dry run without modifying the files.
+ *   @param {string} [options.skipTokens] - A comma-separated list of token prefixes to exempt from automatic fallback removal. By default, 'border' tokens are always included in this list. Whether fallbacks for these tokens are removed when they exactly match depends on the preserveSkippedFallbacks option.
+ *   @param {boolean} [options.preserveSkippedFallbacks] - If true, fallbacks for skipped tokens will never be removed, even if they exactly match the token value. If false (default), fallbacks for skipped tokens will be removed if they exactly match.
+ *   @param {boolean} [options.skipEslint] - If true, skips running ESLint on modified files after transformation.
+ *   @param {boolean} [options.skipPrettier] - If true, skips running Prettier on modified files after transformation.
+ *   @param {number} [options.colorDifferenceThreshold] - The maximum allowed difference for color tokens to be considered acceptable for removal. Default is 15.
+ *   @param {number} [options.spaceDifferenceThreshold] - The maximum allowed percentage difference for space tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.numericDifferenceThreshold] - The maximum allowed percentage difference for numeric tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.borderDifferenceThreshold] - The maximum allowed percentage difference for border tokens to be considered acceptable for removal. Default is 0.
  *
  * @returns {Promise<string>} A promise that resolves to the transformed source code as a string.
  */
@@ -75,6 +83,32 @@ function _transformer() {
           };
           if (options.verbose) {
             console.log(_chalk.default.yellow("Using ".concat(options.useLegacyColorTheme ? 'legacy light' : 'light', " theme.")));
+            if (options.skipTokens) {
+              console.log(_chalk.default.yellow("Auto fallback exemptions active for: ".concat(options.skipTokens)));
+            }
+            if (options.preserveSkippedFallbacks) {
+              console.log(_chalk.default.yellow("Preserving all fallbacks for skipped tokens, even if they match exactly."));
+            }
+            if (options.skipEslint) {
+              console.log(_chalk.default.yellow("Skipping ESLint post-processing."));
+            }
+            if (options.skipPrettier) {
+              console.log(_chalk.default.yellow("Skipping Prettier post-processing."));
+            }
+
+            // Log threshold values if they are set
+            if (options.colorDifferenceThreshold !== undefined) {
+              console.log(_chalk.default.yellow("Color difference threshold set to: ".concat(options.colorDifferenceThreshold)));
+            }
+            if (options.spaceDifferenceThreshold !== undefined) {
+              console.log(_chalk.default.yellow("Space difference threshold set to: ".concat(options.spaceDifferenceThreshold, "%")));
+            }
+            if (options.numericDifferenceThreshold !== undefined) {
+              console.log(_chalk.default.yellow("Numeric difference threshold set to: ".concat(options.numericDifferenceThreshold, "%")));
+            }
+            if (options.borderDifferenceThreshold !== undefined) {
+              console.log(_chalk.default.yellow("Border difference threshold set to: ".concat(options.borderDifferenceThreshold, "%")));
+            }
           }
           tokenMap = (0, _allTokens.getTokenMap)((_options$useLegacyCol = options.useLegacyColorTheme) !== null && _options$useLegacyCol !== void 0 ? _options$useLegacyCol : false);
           _context.next = 12;
@@ -198,7 +232,7 @@ function _afterAll() {
           return (0, _reporter.combineReports)(options.reportFolder);
         case 3:
           if (!(options.reportFolder && !options.dry)) {
-            _context3.next = 27;
+            _context3.next = 35;
             break;
           }
           _context3.prev = 4;
@@ -208,7 +242,7 @@ function _afterAll() {
         case 8:
           fileContent = _context3.sent;
           if (!(fileContent.length > 0)) {
-            _context3.next = 22;
+            _context3.next = 30;
             break;
           }
           filePaths = fileContent.split(/\r?\n/).filter(Boolean); // Get the first file path and strip any quotes
@@ -221,27 +255,49 @@ function _afterAll() {
           _context3.next = 18;
           return gitStage(filePaths, rootDir);
         case 18:
-          _context3.next = 20;
+          if (options.skipEslint) {
+            _context3.next = 23;
+            break;
+          }
+          _context3.next = 21;
           return runEslint(filePaths, rootDir);
-        case 20:
-          _context3.next = 22;
-          return runPrettier(filePaths, rootDir);
-        case 22:
-          _context3.next = 27;
+        case 21:
+          _context3.next = 24;
           break;
+        case 23:
+          if (options.verbose) {
+            console.log(_chalk.default.blue('Skipping ESLint post-processing as requested.'));
+          }
         case 24:
-          _context3.prev = 24;
+          if (options.skipPrettier) {
+            _context3.next = 29;
+            break;
+          }
+          _context3.next = 27;
+          return runPrettier(filePaths, rootDir);
+        case 27:
+          _context3.next = 30;
+          break;
+        case 29:
+          if (options.verbose) {
+            console.log(_chalk.default.blue('Skipping Prettier post-processing as requested.'));
+          }
+        case 30:
+          _context3.next = 35;
+          break;
+        case 32:
+          _context3.prev = 32;
           _context3.t0 = _context3["catch"](4);
           if (_context3.t0 instanceof Error) {
             console.error(_chalk.default.red("Unexpected error: ".concat(_context3.t0.message)));
           } else {
             console.error(_chalk.default.red('An unknown error occurred.'));
           }
-        case 27:
+        case 35:
         case "end":
           return _context3.stop();
       }
-    }, _callee3, null, [[4, 24]]);
+    }, _callee3, null, [[4, 32]]);
   }));
   return _afterAll.apply(this, arguments);
 }
@@ -313,7 +369,7 @@ function _runPrettier() {
   }));
   return _runPrettier.apply(this, arguments);
 }
-function runEslint(_x10, _x11) {
+function runEslint(_x0, _x1) {
   return _runEslint.apply(this, arguments);
 }
 function _runEslint() {
@@ -404,7 +460,7 @@ function _runEslint() {
                                 }
                               }, _callee6, null, [[0, 11]]);
                             }));
-                            return function (_x12) {
+                            return function (_x10) {
                               return _ref2.apply(this, arguments);
                             };
                           }()));

package/dist/cjs/presets/remove-token-fallbacks/utils/normalize-values.js

@@ -8,12 +8,17 @@ exports.normalizeValues = normalizeValues;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _chalk = _interopRequireDefault(require("chalk"));
 var _colorUtils = require("./color-utils");
-// so far allowing to remove only exact matches in values. Can be increased to auto-remove fallbacks with similar values
-var ACCEPTABLE_COLOR_DIFFERENCE = 15;
-var ACCEPTABLE_SPACE_DIFFERENCE = 0;
-var ACCEPTABLE_NUMERIC_DIFFERENCE = 0;
-var ACCEPTABLE_BORDER_DIFFERENCE = 0;
-function normalizeValues(tokenKey, tokenValue, fallbackValue) {
+// Default threshold values
+var DEFAULT_COLOR_DIFFERENCE = 15;
+var DEFAULT_SPACE_DIFFERENCE = 0;
+var DEFAULT_NUMERIC_DIFFERENCE = 0;
+var DEFAULT_BORDER_DIFFERENCE = 0;
+function normalizeValues(tokenKey, tokenValue, fallbackValue, options) {
+  // Use options thresholds or defaults
+  var colorDifference = (options === null || options === void 0 ? void 0 : options.colorDifferenceThreshold) !== undefined ? options.colorDifferenceThreshold : DEFAULT_COLOR_DIFFERENCE;
+  var spaceDifference = (options === null || options === void 0 ? void 0 : options.spaceDifferenceThreshold) !== undefined ? options.spaceDifferenceThreshold : DEFAULT_SPACE_DIFFERENCE;
+  var numericDifference = (options === null || options === void 0 ? void 0 : options.numericDifferenceThreshold) !== undefined ? options.numericDifferenceThreshold : DEFAULT_NUMERIC_DIFFERENCE;
+  var borderDifference = (options === null || options === void 0 ? void 0 : options.borderDifferenceThreshold) !== undefined ? options.borderDifferenceThreshold : DEFAULT_BORDER_DIFFERENCE;
   var tokenLogValue;
   var fallbackLogValue;
   var normalizedTokenValue = tokenValue;
@@ -34,7 +39,7 @@ function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     }
     if (normalizedTokenValue && normalizedFallbackValue) {
       difference = (0, _colorUtils.compareHex)(normalizedTokenValue, normalizedFallbackValue);
-      isAcceptableDifference = difference <= ACCEPTABLE_COLOR_DIFFERENCE;
+      isAcceptableDifference = difference <= colorDifference;
     }
   } else if (lowerCaseTokenKey.startsWith('space') || lowerCaseTokenKey.startsWith('border')) {
     var tokenValueInPx = tokenValue ? convertToPx(tokenValue) : undefined;
@@ -42,7 +47,7 @@ function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     if (tokenValueInPx !== undefined && fallbackValueInPx !== undefined) {
       var maxVal = Math.max(tokenValueInPx, fallbackValueInPx);
       difference = Math.abs(tokenValueInPx - fallbackValueInPx) / maxVal * 100;
-      isAcceptableDifference = difference <= (lowerCaseTokenKey.startsWith('space') ? ACCEPTABLE_SPACE_DIFFERENCE : ACCEPTABLE_BORDER_DIFFERENCE);
+      isAcceptableDifference = difference <= (lowerCaseTokenKey.startsWith('space') ? spaceDifference : borderDifference);
     }
     // Log the normalized values
     normalizedTokenValue = tokenValue;
@@ -56,7 +61,7 @@ function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     if (!isNaN(tokenValueNumber) && !isNaN(fallbackValueNumber)) {
       var _maxVal = Math.max(tokenValueNumber, fallbackValueNumber);
       difference = Math.abs(tokenValueNumber - fallbackValueNumber) / _maxVal * 100;
-      isAcceptableDifference = difference <= ACCEPTABLE_NUMERIC_DIFFERENCE;
+      isAcceptableDifference = difference <= numericDifference;
     }
     // Log the normalized values
     normalizedTokenValue = tokenValue;

package/dist/cjs/presets/remove-token-fallbacks/utils/token-processor.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.TokenProcessor = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
@@ -89,12 +90,43 @@ var TokenProcessor = exports.TokenProcessor = /*#__PURE__*/function () {
     value: function logError(message) {
       this.log(_chalk.default.red(message));
     }
+
+    /**
+     * Checks if a token should be exempted from automatic fallback removal
+     * @param tokenKey The token key to check
+     * @returns An object containing whether the token should be exempted and related information
+     */
+  }, {
+    key: "checkTokenExemption",
+    value: function checkTokenExemption(tokenKey) {
+      // Create exemption list from user-provided skipTokens, and always include 'border'
+      var userExemptions = this.options.skipTokens ? this.options.skipTokens.split(',').map(function (item) {
+        return item.trim();
+      }) : [];
+
+      // Always include 'border' in the exemption list
+      var exemptionList = (0, _toConsumableArray2.default)(userExemptions);
+      if (!exemptionList.includes('border')) {
+        exemptionList.push('border');
+      }
+      var isExemptedToken = exemptionList.some(function (prefix) {
+        return tokenKey.startsWith(prefix);
+      });
+      var exemptedPrefix = isExemptedToken ? exemptionList.find(function (prefix) {
+        return tokenKey.startsWith(prefix);
+      }) || null : null;
+      return {
+        shouldBeExempted: isExemptedToken,
+        exemptedPrefix: exemptedPrefix,
+        exemptionList: exemptionList
+      };
+    }
   }, {
     key: "processSingleToken",
     value: function () {
       var _processSingleToken = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(callPath) {
         var _callPath$node$loc2;
-        var args, line, tokenKey, isSkipped, tokenValue, _ref, rawFallbackValue, fallbackValue, resolvedImportDeclaration, resolvedLocalVarDeclaration, _normalizeValues, difference, isAcceptableDifference, tokenLogValue, fallbackLogValue, normalizedTokenValue, normalizedFallbackValue, areEqual, logData, fallbackRemoved, importDeclaration, localVarDeclaration, isBorderToken, message;
+        var args, line, tokenKey, tokenValue, _yield$this$getFallba, rawFallbackValue, fallbackValue, resolvedImportDeclaration, resolvedLocalVarDeclaration, _normalizeValues, difference, isAcceptableDifference, tokenLogValue, fallbackLogValue, normalizedTokenValue, normalizedFallbackValue, areEqual, logData, fallbackRemoved, importDeclaration, localVarDeclaration, _this$checkTokenExemp, shouldBeExempted, exemptedPrefix, shouldModifyToken, message;
         return _regenerator.default.wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
@@ -124,35 +156,17 @@ var TokenProcessor = exports.TokenProcessor = /*#__PURE__*/function () {
                 resolvedLocalVarDeclaration: undefined
               });
             case 8:
-              isSkipped = false; // tokenKey.startsWith('elevation.shadow') ||
-              // tokenKey.startsWith('font.body') ||
-              // tokenKey.startsWith('font.heading');
-              tokenValue = isSkipped ? '' : this.tokenMap[tokenKey];
+              tokenValue = this.tokenMap[tokenKey];
               this.logVerbose("Token value from tokenMap: ".concat(_chalk.default.magenta(tokenValue), " for key: ").concat(_chalk.default.yellow(tokenKey)));
-              if (!isSkipped) {
-                _context2.next = 15;
-                break;
-              }
-              _context2.t0 = {
-                rawFallbackValue: 'N/A',
-                fallbackValue: undefined,
-                resolvedImportDeclaration: undefined,
-                resolvedLocalVarDeclaration: undefined
-              };
-              _context2.next = 18;
-              break;
-            case 15:
-              _context2.next = 17;
+              _context2.next = 12;
               return this.getFallbackValue(args[1]);
-            case 17:
-              _context2.t0 = _context2.sent;
-            case 18:
-              _ref = _context2.t0;
-              rawFallbackValue = _ref.rawFallbackValue;
-              fallbackValue = _ref.fallbackValue;
-              resolvedImportDeclaration = _ref.resolvedImportDeclaration;
-              resolvedLocalVarDeclaration = _ref.resolvedLocalVarDeclaration;
-              _normalizeValues = (0, _normalizeValues2.normalizeValues)(tokenKey, tokenValue, fallbackValue), difference = _normalizeValues.difference, isAcceptableDifference = _normalizeValues.isAcceptableDifference, tokenLogValue = _normalizeValues.tokenLogValue, fallbackLogValue = _normalizeValues.fallbackLogValue, normalizedTokenValue = _normalizeValues.normalizedTokenValue, normalizedFallbackValue = _normalizeValues.normalizedFallbackValue;
+            case 12:
+              _yield$this$getFallba = _context2.sent;
+              rawFallbackValue = _yield$this$getFallba.rawFallbackValue;
+              fallbackValue = _yield$this$getFallba.fallbackValue;
+              resolvedImportDeclaration = _yield$this$getFallba.resolvedImportDeclaration;
+              resolvedLocalVarDeclaration = _yield$this$getFallba.resolvedLocalVarDeclaration;
+              _normalizeValues = (0, _normalizeValues2.normalizeValues)(tokenKey, tokenValue, fallbackValue, this.options), difference = _normalizeValues.difference, isAcceptableDifference = _normalizeValues.isAcceptableDifference, tokenLogValue = _normalizeValues.tokenLogValue, fallbackLogValue = _normalizeValues.fallbackLogValue, normalizedTokenValue = _normalizeValues.normalizedTokenValue, normalizedFallbackValue = _normalizeValues.normalizedFallbackValue;
               areEqual = normalizedTokenValue === normalizedFallbackValue;
               logData = {
                 teamInfo: this.teamInfo,
@@ -165,8 +179,16 @@ var TokenProcessor = exports.TokenProcessor = /*#__PURE__*/function () {
                 difference: difference
               };
               fallbackRemoved = false;
-              isBorderToken = tokenKey.startsWith('border');
-              if (areEqual || (isAcceptableDifference || this.options.forceUpdate) && !isBorderToken) {
+              // Check if token should be exempted
+              _this$checkTokenExemp = this.checkTokenExemption(tokenKey), shouldBeExempted = _this$checkTokenExemp.shouldBeExempted, exemptedPrefix = _this$checkTokenExemp.exemptedPrefix; // Determine if we should modify this token based on the exemption status and settings
+              shouldModifyToken =
+              // Always modify if not exempted and values match
+              areEqual && !shouldBeExempted ||
+              // Or if values don't exactly match but are acceptable to modify and not exempted
+              (isAcceptableDifference || this.options.forceUpdate) && !shouldBeExempted ||
+              // Or if exempted but values match exactly and we're not preserving skipped fallbacks
+              areEqual && shouldBeExempted && !this.options.preserveSkippedFallbacks;
+              if (shouldModifyToken) {
                 this.log(_chalk.default.green(areEqual ? 'Token value and fallback value are equal, removing fallback' : 'Token value and fallback value are within acceptable difference threshold, removing fallback'));
                 args.pop();
                 this.details.replaced.push(logData);
@@ -174,7 +196,7 @@ var TokenProcessor = exports.TokenProcessor = /*#__PURE__*/function () {
                 importDeclaration = resolvedImportDeclaration;
                 localVarDeclaration = resolvedLocalVarDeclaration;
               } else {
-                message = isBorderToken ? 'Skip modifying border token' : normalizedFallbackValue === undefined ? "Fallback value could not be resolved" : "Values mismatched significantly";
+                message = shouldBeExempted ? this.options.preserveSkippedFallbacks && areEqual ? "Preserving fallback for exempted token '".concat(tokenKey, "' (matches exemption '").concat(exemptedPrefix, "')") : "Skip modifying exempted token '".concat(tokenKey, "' (matches exemption '").concat(exemptedPrefix, "')") : normalizedFallbackValue === undefined ? "Fallback value could not be resolved" : "Values mismatched significantly";
                 this.logError(message);
                 if (this.options.addEslintComments) {
                   (0, _updateComments.addOrUpdateEslintIgnoreComment)(this.j, tokenValue, fallbackValue, callPath);
@@ -188,7 +210,7 @@ var TokenProcessor = exports.TokenProcessor = /*#__PURE__*/function () {
                 resolvedImportDeclaration: importDeclaration,
                 resolvedLocalVarDeclaration: localVarDeclaration
               });
-            case 31:
+            case 26:
             case "end":
               return _context2.stop();
           }
@@ -711,7 +733,7 @@ var TokenProcessor = exports.TokenProcessor = /*#__PURE__*/function () {
           }
         }, _callee8, this);
       }));
-      function resolveValueFromImport(_x9, _x10, _x11, _x12) {
+      function resolveValueFromImport(_x9, _x0, _x1, _x10) {
         return _resolveValueFromImport.apply(this, arguments);
       }
       return resolveValueFromImport;

package/dist/es2019/presets/remove-token-fallbacks/remove-token-fallbacks.js

@@ -28,6 +28,14 @@ const execAsync = promisify(exec);
  *   @param {boolean} [options.useLegacyColorTheme] - If true, uses the legacy theme for color token mapping.
  *   @param {string} [options.reportFolder] - Directory path to output transformation reports. Reports will be generated only if this option is provided.
  *   @param {boolean} [options.dry] - If true, performs a dry run without modifying the files.
+ *   @param {string} [options.skipTokens] - A comma-separated list of token prefixes to exempt from automatic fallback removal. By default, 'border' tokens are always included in this list. Whether fallbacks for these tokens are removed when they exactly match depends on the preserveSkippedFallbacks option.
+ *   @param {boolean} [options.preserveSkippedFallbacks] - If true, fallbacks for skipped tokens will never be removed, even if they exactly match the token value. If false (default), fallbacks for skipped tokens will be removed if they exactly match.
+ *   @param {boolean} [options.skipEslint] - If true, skips running ESLint on modified files after transformation.
+ *   @param {boolean} [options.skipPrettier] - If true, skips running Prettier on modified files after transformation.
+ *   @param {number} [options.colorDifferenceThreshold] - The maximum allowed difference for color tokens to be considered acceptable for removal. Default is 15.
+ *   @param {number} [options.spaceDifferenceThreshold] - The maximum allowed percentage difference for space tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.numericDifferenceThreshold] - The maximum allowed percentage difference for numeric tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.borderDifferenceThreshold] - The maximum allowed percentage difference for border tokens to be considered acceptable for removal. Default is 0.
  *
  * @returns {Promise<string>} A promise that resolves to the transformed source code as a string.
  */
@@ -46,6 +54,32 @@ export default async function transformer(fileInfo, {
   };
   if (options.verbose) {
     console.log(chalk.yellow(`Using ${options.useLegacyColorTheme ? 'legacy light' : 'light'} theme.`));
+    if (options.skipTokens) {
+      console.log(chalk.yellow(`Auto fallback exemptions active for: ${options.skipTokens}`));
+    }
+    if (options.preserveSkippedFallbacks) {
+      console.log(chalk.yellow(`Preserving all fallbacks for skipped tokens, even if they match exactly.`));
+    }
+    if (options.skipEslint) {
+      console.log(chalk.yellow(`Skipping ESLint post-processing.`));
+    }
+    if (options.skipPrettier) {
+      console.log(chalk.yellow(`Skipping Prettier post-processing.`));
+    }
+
+    // Log threshold values if they are set
+    if (options.colorDifferenceThreshold !== undefined) {
+      console.log(chalk.yellow(`Color difference threshold set to: ${options.colorDifferenceThreshold}`));
+    }
+    if (options.spaceDifferenceThreshold !== undefined) {
+      console.log(chalk.yellow(`Space difference threshold set to: ${options.spaceDifferenceThreshold}%`));
+    }
+    if (options.numericDifferenceThreshold !== undefined) {
+      console.log(chalk.yellow(`Numeric difference threshold set to: ${options.numericDifferenceThreshold}%`));
+    }
+    if (options.borderDifferenceThreshold !== undefined) {
+      console.log(chalk.yellow(`Border difference threshold set to: ${options.borderDifferenceThreshold}%`));
+    }
   }
   const tokenMap = getTokenMap((_options$useLegacyCol = options.useLegacyColorTheme) !== null && _options$useLegacyCol !== void 0 ? _options$useLegacyCol : false);
   const teamInfo = await getTeamInfo(fileInfo.path);
@@ -130,8 +164,16 @@ export async function afterAll(options) {
         const rootDir = await findRoot(path.dirname(firstFilePath));
         console.log('Root directory:', rootDir);
         await gitStage(filePaths, rootDir);
-        await runEslint(filePaths, rootDir);
-        await runPrettier(filePaths, rootDir);
+        if (!options.skipEslint) {
+          await runEslint(filePaths, rootDir);
+        } else if (options.verbose) {
+          console.log(chalk.blue('Skipping ESLint post-processing as requested.'));
+        }
+        if (!options.skipPrettier) {
+          await runPrettier(filePaths, rootDir);
+        } else if (options.verbose) {
+          console.log(chalk.blue('Skipping Prettier post-processing as requested.'));
+        }
       }
     } catch (error) {
       if (error instanceof Error) {

package/dist/es2019/presets/remove-token-fallbacks/utils/normalize-values.js

@@ -1,12 +1,17 @@
 import chalk from 'chalk';
 import { colorToHex, compareHex, isValidColor } from './color-utils';
 
-// so far allowing to remove only exact matches in values. Can be increased to auto-remove fallbacks with similar values
-const ACCEPTABLE_COLOR_DIFFERENCE = 15;
-const ACCEPTABLE_SPACE_DIFFERENCE = 0;
-const ACCEPTABLE_NUMERIC_DIFFERENCE = 0;
-const ACCEPTABLE_BORDER_DIFFERENCE = 0;
-export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
+// Default threshold values
+const DEFAULT_COLOR_DIFFERENCE = 15;
+const DEFAULT_SPACE_DIFFERENCE = 0;
+const DEFAULT_NUMERIC_DIFFERENCE = 0;
+const DEFAULT_BORDER_DIFFERENCE = 0;
+export function normalizeValues(tokenKey, tokenValue, fallbackValue, options) {
+  // Use options thresholds or defaults
+  const colorDifference = (options === null || options === void 0 ? void 0 : options.colorDifferenceThreshold) !== undefined ? options.colorDifferenceThreshold : DEFAULT_COLOR_DIFFERENCE;
+  const spaceDifference = (options === null || options === void 0 ? void 0 : options.spaceDifferenceThreshold) !== undefined ? options.spaceDifferenceThreshold : DEFAULT_SPACE_DIFFERENCE;
+  const numericDifference = (options === null || options === void 0 ? void 0 : options.numericDifferenceThreshold) !== undefined ? options.numericDifferenceThreshold : DEFAULT_NUMERIC_DIFFERENCE;
+  const borderDifference = (options === null || options === void 0 ? void 0 : options.borderDifferenceThreshold) !== undefined ? options.borderDifferenceThreshold : DEFAULT_BORDER_DIFFERENCE;
   let tokenLogValue;
   let fallbackLogValue;
   let normalizedTokenValue = tokenValue;
@@ -27,7 +32,7 @@ export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     }
     if (normalizedTokenValue && normalizedFallbackValue) {
       difference = compareHex(normalizedTokenValue, normalizedFallbackValue);
-      isAcceptableDifference = difference <= ACCEPTABLE_COLOR_DIFFERENCE;
+      isAcceptableDifference = difference <= colorDifference;
     }
   } else if (lowerCaseTokenKey.startsWith('space') || lowerCaseTokenKey.startsWith('border')) {
     const tokenValueInPx = tokenValue ? convertToPx(tokenValue) : undefined;
@@ -35,7 +40,7 @@ export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     if (tokenValueInPx !== undefined && fallbackValueInPx !== undefined) {
       const maxVal = Math.max(tokenValueInPx, fallbackValueInPx);
       difference = Math.abs(tokenValueInPx - fallbackValueInPx) / maxVal * 100;
-      isAcceptableDifference = difference <= (lowerCaseTokenKey.startsWith('space') ? ACCEPTABLE_SPACE_DIFFERENCE : ACCEPTABLE_BORDER_DIFFERENCE);
+      isAcceptableDifference = difference <= (lowerCaseTokenKey.startsWith('space') ? spaceDifference : borderDifference);
     }
     // Log the normalized values
     normalizedTokenValue = tokenValue;
@@ -49,7 +54,7 @@ export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     if (!isNaN(tokenValueNumber) && !isNaN(fallbackValueNumber)) {
       const maxVal = Math.max(tokenValueNumber, fallbackValueNumber);
       difference = Math.abs(tokenValueNumber - fallbackValueNumber) / maxVal * 100;
-      isAcceptableDifference = difference <= ACCEPTABLE_NUMERIC_DIFFERENCE;
+      isAcceptableDifference = difference <= numericDifference;
     }
     // Log the normalized values
     normalizedTokenValue = tokenValue;

package/dist/es2019/presets/remove-token-fallbacks/utils/token-processor.js

@@ -45,6 +45,29 @@ export class TokenProcessor {
   logError(message) {
     this.log(chalk.red(message));
   }
+
+  /**
+   * Checks if a token should be exempted from automatic fallback removal
+   * @param tokenKey The token key to check
+   * @returns An object containing whether the token should be exempted and related information
+   */
+  checkTokenExemption(tokenKey) {
+    // Create exemption list from user-provided skipTokens, and always include 'border'
+    const userExemptions = this.options.skipTokens ? this.options.skipTokens.split(',').map(item => item.trim()) : [];
+
+    // Always include 'border' in the exemption list
+    const exemptionList = [...userExemptions];
+    if (!exemptionList.includes('border')) {
+      exemptionList.push('border');
+    }
+    const isExemptedToken = exemptionList.some(prefix => tokenKey.startsWith(prefix));
+    const exemptedPrefix = isExemptedToken ? exemptionList.find(prefix => tokenKey.startsWith(prefix)) || null : null;
+    return {
+      shouldBeExempted: isExemptedToken,
+      exemptedPrefix,
+      exemptionList
+    };
+  }
   async processSingleToken(callPath) {
     var _callPath$node$loc2;
     const args = callPath.node.arguments;
@@ -67,23 +90,14 @@ export class TokenProcessor {
         resolvedLocalVarDeclaration: undefined
       };
     }
-    const isSkipped = false;
-    // tokenKey.startsWith('elevation.shadow') ||
-    // tokenKey.startsWith('font.body') ||
-    // tokenKey.startsWith('font.heading');
-    const tokenValue = isSkipped ? '' : this.tokenMap[tokenKey];
+    const tokenValue = this.tokenMap[tokenKey];
     this.logVerbose(`Token value from tokenMap: ${chalk.magenta(tokenValue)} for key: ${chalk.yellow(tokenKey)}`);
     const {
       rawFallbackValue,
       fallbackValue,
       resolvedImportDeclaration,
       resolvedLocalVarDeclaration
-    } = isSkipped ? {
-      rawFallbackValue: 'N/A',
-      fallbackValue: undefined,
-      resolvedImportDeclaration: undefined,
-      resolvedLocalVarDeclaration: undefined
-    } : await this.getFallbackValue(args[1]);
+    } = await this.getFallbackValue(args[1]);
     const {
       difference,
       isAcceptableDifference,
@@ -91,7 +105,7 @@ export class TokenProcessor {
       fallbackLogValue,
       normalizedTokenValue,
       normalizedFallbackValue
-    } = normalizeValues(tokenKey, tokenValue, fallbackValue);
+    } = normalizeValues(tokenKey, tokenValue, fallbackValue, this.options);
     const areEqual = normalizedTokenValue === normalizedFallbackValue;
     const logData = {
       teamInfo: this.teamInfo,
@@ -106,8 +120,22 @@ export class TokenProcessor {
     let fallbackRemoved = false;
     let importDeclaration;
     let localVarDeclaration;
-    const isBorderToken = tokenKey.startsWith('border');
-    if (areEqual || (isAcceptableDifference || this.options.forceUpdate) && !isBorderToken) {
+
+    // Check if token should be exempted
+    const {
+      shouldBeExempted,
+      exemptedPrefix
+    } = this.checkTokenExemption(tokenKey);
+
+    // Determine if we should modify this token based on the exemption status and settings
+    const shouldModifyToken =
+    // Always modify if not exempted and values match
+    areEqual && !shouldBeExempted ||
+    // Or if values don't exactly match but are acceptable to modify and not exempted
+    (isAcceptableDifference || this.options.forceUpdate) && !shouldBeExempted ||
+    // Or if exempted but values match exactly and we're not preserving skipped fallbacks
+    areEqual && shouldBeExempted && !this.options.preserveSkippedFallbacks;
+    if (shouldModifyToken) {
       this.log(chalk.green(areEqual ? 'Token value and fallback value are equal, removing fallback' : 'Token value and fallback value are within acceptable difference threshold, removing fallback'));
       args.pop();
       this.details.replaced.push(logData);
@@ -115,7 +143,7 @@ export class TokenProcessor {
       importDeclaration = resolvedImportDeclaration;
       localVarDeclaration = resolvedLocalVarDeclaration;
     } else {
-      const message = isBorderToken ? 'Skip modifying border token' : normalizedFallbackValue === undefined ? `Fallback value could not be resolved` : `Values mismatched significantly`;
+      const message = shouldBeExempted ? this.options.preserveSkippedFallbacks && areEqual ? `Preserving fallback for exempted token '${tokenKey}' (matches exemption '${exemptedPrefix}')` : `Skip modifying exempted token '${tokenKey}' (matches exemption '${exemptedPrefix}')` : normalizedFallbackValue === undefined ? `Fallback value could not be resolved` : `Values mismatched significantly`;
       this.logError(message);
       if (this.options.addEslintComments) {
         addOrUpdateEslintIgnoreComment(this.j, tokenValue, fallbackValue, callPath);

package/dist/esm/main.js

@@ -307,7 +307,7 @@ var defaultFlags = {
   ignorePattern: 'node_modules',
   logger: console
 };
-function processLifecycleHook(_x9, _x10, _x11, _x12, _x13) {
+function processLifecycleHook(_x9, _x0, _x1, _x10, _x11) {
   return _processLifecycleHook.apply(this, arguments);
 }
 function _processLifecycleHook() {
@@ -339,7 +339,7 @@ function _processLifecycleHook() {
   }));
   return _processLifecycleHook.apply(this, arguments);
 }
-export default function main(_x14, _x15) {
+export default function main(_x12, _x13) {
   return _main.apply(this, arguments);
 }
 function _main() {
@@ -355,7 +355,7 @@ function _main() {
         case 4:
           _yield$parseArgs = _context6.sent;
           packages = _yield$parseArgs.packages;
-          _process$env$_PACKAGE = "0.28.0", _PACKAGE_VERSION_ = _process$env$_PACKAGE === void 0 ? '0.0.0-dev' : _process$env$_PACKAGE;
+          _process$env$_PACKAGE = "0.28.1", _PACKAGE_VERSION_ = _process$env$_PACKAGE === void 0 ? '0.0.0-dev' : _process$env$_PACKAGE;
           logger.log(chalk.bgBlue(chalk.black("\uD83D\uDCDA Atlassian-Frontend codemod library @ ".concat(_PACKAGE_VERSION_, " \uD83D\uDCDA"))));
           if (packages && packages.length > 0) {
             logger.log(chalk.gray("Searching for codemods for newer versions of the following packages: ".concat(packages.map(function (pkg) {

package/dist/esm/presets/remove-token-fallbacks/remove-token-fallbacks.js

@@ -35,6 +35,14 @@ var execAsync = promisify(exec);
  *   @param {boolean} [options.useLegacyColorTheme] - If true, uses the legacy theme for color token mapping.
  *   @param {string} [options.reportFolder] - Directory path to output transformation reports. Reports will be generated only if this option is provided.
  *   @param {boolean} [options.dry] - If true, performs a dry run without modifying the files.
+ *   @param {string} [options.skipTokens] - A comma-separated list of token prefixes to exempt from automatic fallback removal. By default, 'border' tokens are always included in this list. Whether fallbacks for these tokens are removed when they exactly match depends on the preserveSkippedFallbacks option.
+ *   @param {boolean} [options.preserveSkippedFallbacks] - If true, fallbacks for skipped tokens will never be removed, even if they exactly match the token value. If false (default), fallbacks for skipped tokens will be removed if they exactly match.
+ *   @param {boolean} [options.skipEslint] - If true, skips running ESLint on modified files after transformation.
+ *   @param {boolean} [options.skipPrettier] - If true, skips running Prettier on modified files after transformation.
+ *   @param {number} [options.colorDifferenceThreshold] - The maximum allowed difference for color tokens to be considered acceptable for removal. Default is 15.
+ *   @param {number} [options.spaceDifferenceThreshold] - The maximum allowed percentage difference for space tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.numericDifferenceThreshold] - The maximum allowed percentage difference for numeric tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.borderDifferenceThreshold] - The maximum allowed percentage difference for border tokens to be considered acceptable for removal. Default is 0.
  *
  * @returns {Promise<string>} A promise that resolves to the transformed source code as a string.
  */
@@ -66,6 +74,32 @@ function _transformer() {
           };
           if (options.verbose) {
             console.log(chalk.yellow("Using ".concat(options.useLegacyColorTheme ? 'legacy light' : 'light', " theme.")));
+            if (options.skipTokens) {
+              console.log(chalk.yellow("Auto fallback exemptions active for: ".concat(options.skipTokens)));
+            }
+            if (options.preserveSkippedFallbacks) {
+              console.log(chalk.yellow("Preserving all fallbacks for skipped tokens, even if they match exactly."));
+            }
+            if (options.skipEslint) {
+              console.log(chalk.yellow("Skipping ESLint post-processing."));
+            }
+            if (options.skipPrettier) {
+              console.log(chalk.yellow("Skipping Prettier post-processing."));
+            }
+
+            // Log threshold values if they are set
+            if (options.colorDifferenceThreshold !== undefined) {
+              console.log(chalk.yellow("Color difference threshold set to: ".concat(options.colorDifferenceThreshold)));
+            }
+            if (options.spaceDifferenceThreshold !== undefined) {
+              console.log(chalk.yellow("Space difference threshold set to: ".concat(options.spaceDifferenceThreshold, "%")));
+            }
+            if (options.numericDifferenceThreshold !== undefined) {
+              console.log(chalk.yellow("Numeric difference threshold set to: ".concat(options.numericDifferenceThreshold, "%")));
+            }
+            if (options.borderDifferenceThreshold !== undefined) {
+              console.log(chalk.yellow("Border difference threshold set to: ".concat(options.borderDifferenceThreshold, "%")));
+            }
           }
           tokenMap = getTokenMap((_options$useLegacyCol = options.useLegacyColorTheme) !== null && _options$useLegacyCol !== void 0 ? _options$useLegacyCol : false);
           _context.next = 12;
@@ -190,7 +224,7 @@ function _afterAll() {
           return combineReports(options.reportFolder);
         case 3:
           if (!(options.reportFolder && !options.dry)) {
-            _context3.next = 27;
+            _context3.next = 35;
             break;
           }
           _context3.prev = 4;
@@ -200,7 +234,7 @@ function _afterAll() {
         case 8:
           fileContent = _context3.sent;
           if (!(fileContent.length > 0)) {
-            _context3.next = 22;
+            _context3.next = 30;
             break;
           }
           filePaths = fileContent.split(/\r?\n/).filter(Boolean); // Get the first file path and strip any quotes
@@ -213,27 +247,49 @@ function _afterAll() {
           _context3.next = 18;
           return gitStage(filePaths, rootDir);
         case 18:
-          _context3.next = 20;
+          if (options.skipEslint) {
+            _context3.next = 23;
+            break;
+          }
+          _context3.next = 21;
           return runEslint(filePaths, rootDir);
-        case 20:
-          _context3.next = 22;
-          return runPrettier(filePaths, rootDir);
-        case 22:
-          _context3.next = 27;
+        case 21:
+          _context3.next = 24;
           break;
+        case 23:
+          if (options.verbose) {
+            console.log(chalk.blue('Skipping ESLint post-processing as requested.'));
+          }
         case 24:
-          _context3.prev = 24;
+          if (options.skipPrettier) {
+            _context3.next = 29;
+            break;
+          }
+          _context3.next = 27;
+          return runPrettier(filePaths, rootDir);
+        case 27:
+          _context3.next = 30;
+          break;
+        case 29:
+          if (options.verbose) {
+            console.log(chalk.blue('Skipping Prettier post-processing as requested.'));
+          }
+        case 30:
+          _context3.next = 35;
+          break;
+        case 32:
+          _context3.prev = 32;
           _context3.t0 = _context3["catch"](4);
           if (_context3.t0 instanceof Error) {
             console.error(chalk.red("Unexpected error: ".concat(_context3.t0.message)));
           } else {
             console.error(chalk.red('An unknown error occurred.'));
           }
-        case 27:
+        case 35:
         case "end":
           return _context3.stop();
       }
-    }, _callee3, null, [[4, 24]]);
+    }, _callee3, null, [[4, 32]]);
   }));
   return _afterAll.apply(this, arguments);
 }
@@ -305,7 +361,7 @@ function _runPrettier() {
   }));
   return _runPrettier.apply(this, arguments);
 }
-function runEslint(_x10, _x11) {
+function runEslint(_x0, _x1) {
   return _runEslint.apply(this, arguments);
 }
 function _runEslint() {
@@ -396,7 +452,7 @@ function _runEslint() {
                                 }
                               }, _callee6, null, [[0, 11]]);
                             }));
-                            return function (_x12) {
+                            return function (_x10) {
                               return _ref2.apply(this, arguments);
                             };
                           }()));

package/dist/esm/presets/remove-token-fallbacks/utils/normalize-values.js

@@ -2,12 +2,17 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import chalk from 'chalk';
 import { colorToHex, compareHex, isValidColor } from './color-utils';
 
-// so far allowing to remove only exact matches in values. Can be increased to auto-remove fallbacks with similar values
-var ACCEPTABLE_COLOR_DIFFERENCE = 15;
-var ACCEPTABLE_SPACE_DIFFERENCE = 0;
-var ACCEPTABLE_NUMERIC_DIFFERENCE = 0;
-var ACCEPTABLE_BORDER_DIFFERENCE = 0;
-export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
+// Default threshold values
+var DEFAULT_COLOR_DIFFERENCE = 15;
+var DEFAULT_SPACE_DIFFERENCE = 0;
+var DEFAULT_NUMERIC_DIFFERENCE = 0;
+var DEFAULT_BORDER_DIFFERENCE = 0;
+export function normalizeValues(tokenKey, tokenValue, fallbackValue, options) {
+  // Use options thresholds or defaults
+  var colorDifference = (options === null || options === void 0 ? void 0 : options.colorDifferenceThreshold) !== undefined ? options.colorDifferenceThreshold : DEFAULT_COLOR_DIFFERENCE;
+  var spaceDifference = (options === null || options === void 0 ? void 0 : options.spaceDifferenceThreshold) !== undefined ? options.spaceDifferenceThreshold : DEFAULT_SPACE_DIFFERENCE;
+  var numericDifference = (options === null || options === void 0 ? void 0 : options.numericDifferenceThreshold) !== undefined ? options.numericDifferenceThreshold : DEFAULT_NUMERIC_DIFFERENCE;
+  var borderDifference = (options === null || options === void 0 ? void 0 : options.borderDifferenceThreshold) !== undefined ? options.borderDifferenceThreshold : DEFAULT_BORDER_DIFFERENCE;
   var tokenLogValue;
   var fallbackLogValue;
   var normalizedTokenValue = tokenValue;
@@ -28,7 +33,7 @@ export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     }
     if (normalizedTokenValue && normalizedFallbackValue) {
       difference = compareHex(normalizedTokenValue, normalizedFallbackValue);
-      isAcceptableDifference = difference <= ACCEPTABLE_COLOR_DIFFERENCE;
+      isAcceptableDifference = difference <= colorDifference;
     }
   } else if (lowerCaseTokenKey.startsWith('space') || lowerCaseTokenKey.startsWith('border')) {
     var tokenValueInPx = tokenValue ? convertToPx(tokenValue) : undefined;
@@ -36,7 +41,7 @@ export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     if (tokenValueInPx !== undefined && fallbackValueInPx !== undefined) {
       var maxVal = Math.max(tokenValueInPx, fallbackValueInPx);
       difference = Math.abs(tokenValueInPx - fallbackValueInPx) / maxVal * 100;
-      isAcceptableDifference = difference <= (lowerCaseTokenKey.startsWith('space') ? ACCEPTABLE_SPACE_DIFFERENCE : ACCEPTABLE_BORDER_DIFFERENCE);
+      isAcceptableDifference = difference <= (lowerCaseTokenKey.startsWith('space') ? spaceDifference : borderDifference);
     }
     // Log the normalized values
     normalizedTokenValue = tokenValue;
@@ -50,7 +55,7 @@ export function normalizeValues(tokenKey, tokenValue, fallbackValue) {
     if (!isNaN(tokenValueNumber) && !isNaN(fallbackValueNumber)) {
       var _maxVal = Math.max(tokenValueNumber, fallbackValueNumber);
       difference = Math.abs(tokenValueNumber - fallbackValueNumber) / _maxVal * 100;
-      isAcceptableDifference = difference <= ACCEPTABLE_NUMERIC_DIFFERENCE;
+      isAcceptableDifference = difference <= numericDifference;
     }
     // Log the normalized values
     normalizedTokenValue = tokenValue;

package/dist/esm/presets/remove-token-fallbacks/utils/token-processor.js

@@ -1,3 +1,4 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
@@ -82,12 +83,43 @@ export var TokenProcessor = /*#__PURE__*/function () {
     value: function logError(message) {
       this.log(chalk.red(message));
     }
+
+    /**
+     * Checks if a token should be exempted from automatic fallback removal
+     * @param tokenKey The token key to check
+     * @returns An object containing whether the token should be exempted and related information
+     */
+  }, {
+    key: "checkTokenExemption",
+    value: function checkTokenExemption(tokenKey) {
+      // Create exemption list from user-provided skipTokens, and always include 'border'
+      var userExemptions = this.options.skipTokens ? this.options.skipTokens.split(',').map(function (item) {
+        return item.trim();
+      }) : [];
+
+      // Always include 'border' in the exemption list
+      var exemptionList = _toConsumableArray(userExemptions);
+      if (!exemptionList.includes('border')) {
+        exemptionList.push('border');
+      }
+      var isExemptedToken = exemptionList.some(function (prefix) {
+        return tokenKey.startsWith(prefix);
+      });
+      var exemptedPrefix = isExemptedToken ? exemptionList.find(function (prefix) {
+        return tokenKey.startsWith(prefix);
+      }) || null : null;
+      return {
+        shouldBeExempted: isExemptedToken,
+        exemptedPrefix: exemptedPrefix,
+        exemptionList: exemptionList
+      };
+    }
   }, {
     key: "processSingleToken",
     value: function () {
       var _processSingleToken = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(callPath) {
         var _callPath$node$loc2;
-        var args, line, tokenKey, isSkipped, tokenValue, _ref, rawFallbackValue, fallbackValue, resolvedImportDeclaration, resolvedLocalVarDeclaration, _normalizeValues, difference, isAcceptableDifference, tokenLogValue, fallbackLogValue, normalizedTokenValue, normalizedFallbackValue, areEqual, logData, fallbackRemoved, importDeclaration, localVarDeclaration, isBorderToken, message;
+        var args, line, tokenKey, tokenValue, _yield$this$getFallba, rawFallbackValue, fallbackValue, resolvedImportDeclaration, resolvedLocalVarDeclaration, _normalizeValues, difference, isAcceptableDifference, tokenLogValue, fallbackLogValue, normalizedTokenValue, normalizedFallbackValue, areEqual, logData, fallbackRemoved, importDeclaration, localVarDeclaration, _this$checkTokenExemp, shouldBeExempted, exemptedPrefix, shouldModifyToken, message;
         return _regeneratorRuntime.wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
@@ -117,35 +149,17 @@ export var TokenProcessor = /*#__PURE__*/function () {
                 resolvedLocalVarDeclaration: undefined
               });
             case 8:
-              isSkipped = false; // tokenKey.startsWith('elevation.shadow') ||
-              // tokenKey.startsWith('font.body') ||
-              // tokenKey.startsWith('font.heading');
-              tokenValue = isSkipped ? '' : this.tokenMap[tokenKey];
+              tokenValue = this.tokenMap[tokenKey];
               this.logVerbose("Token value from tokenMap: ".concat(chalk.magenta(tokenValue), " for key: ").concat(chalk.yellow(tokenKey)));
-              if (!isSkipped) {
-                _context2.next = 15;
-                break;
-              }
-              _context2.t0 = {
-                rawFallbackValue: 'N/A',
-                fallbackValue: undefined,
-                resolvedImportDeclaration: undefined,
-                resolvedLocalVarDeclaration: undefined
-              };
-              _context2.next = 18;
-              break;
-            case 15:
-              _context2.next = 17;
+              _context2.next = 12;
               return this.getFallbackValue(args[1]);
-            case 17:
-              _context2.t0 = _context2.sent;
-            case 18:
-              _ref = _context2.t0;
-              rawFallbackValue = _ref.rawFallbackValue;
-              fallbackValue = _ref.fallbackValue;
-              resolvedImportDeclaration = _ref.resolvedImportDeclaration;
-              resolvedLocalVarDeclaration = _ref.resolvedLocalVarDeclaration;
-              _normalizeValues = normalizeValues(tokenKey, tokenValue, fallbackValue), difference = _normalizeValues.difference, isAcceptableDifference = _normalizeValues.isAcceptableDifference, tokenLogValue = _normalizeValues.tokenLogValue, fallbackLogValue = _normalizeValues.fallbackLogValue, normalizedTokenValue = _normalizeValues.normalizedTokenValue, normalizedFallbackValue = _normalizeValues.normalizedFallbackValue;
+            case 12:
+              _yield$this$getFallba = _context2.sent;
+              rawFallbackValue = _yield$this$getFallba.rawFallbackValue;
+              fallbackValue = _yield$this$getFallba.fallbackValue;
+              resolvedImportDeclaration = _yield$this$getFallba.resolvedImportDeclaration;
+              resolvedLocalVarDeclaration = _yield$this$getFallba.resolvedLocalVarDeclaration;
+              _normalizeValues = normalizeValues(tokenKey, tokenValue, fallbackValue, this.options), difference = _normalizeValues.difference, isAcceptableDifference = _normalizeValues.isAcceptableDifference, tokenLogValue = _normalizeValues.tokenLogValue, fallbackLogValue = _normalizeValues.fallbackLogValue, normalizedTokenValue = _normalizeValues.normalizedTokenValue, normalizedFallbackValue = _normalizeValues.normalizedFallbackValue;
               areEqual = normalizedTokenValue === normalizedFallbackValue;
               logData = {
                 teamInfo: this.teamInfo,
@@ -158,8 +172,16 @@ export var TokenProcessor = /*#__PURE__*/function () {
                 difference: difference
               };
               fallbackRemoved = false;
-              isBorderToken = tokenKey.startsWith('border');
-              if (areEqual || (isAcceptableDifference || this.options.forceUpdate) && !isBorderToken) {
+              // Check if token should be exempted
+              _this$checkTokenExemp = this.checkTokenExemption(tokenKey), shouldBeExempted = _this$checkTokenExemp.shouldBeExempted, exemptedPrefix = _this$checkTokenExemp.exemptedPrefix; // Determine if we should modify this token based on the exemption status and settings
+              shouldModifyToken =
+              // Always modify if not exempted and values match
+              areEqual && !shouldBeExempted ||
+              // Or if values don't exactly match but are acceptable to modify and not exempted
+              (isAcceptableDifference || this.options.forceUpdate) && !shouldBeExempted ||
+              // Or if exempted but values match exactly and we're not preserving skipped fallbacks
+              areEqual && shouldBeExempted && !this.options.preserveSkippedFallbacks;
+              if (shouldModifyToken) {
                 this.log(chalk.green(areEqual ? 'Token value and fallback value are equal, removing fallback' : 'Token value and fallback value are within acceptable difference threshold, removing fallback'));
                 args.pop();
                 this.details.replaced.push(logData);
@@ -167,7 +189,7 @@ export var TokenProcessor = /*#__PURE__*/function () {
                 importDeclaration = resolvedImportDeclaration;
                 localVarDeclaration = resolvedLocalVarDeclaration;
               } else {
-                message = isBorderToken ? 'Skip modifying border token' : normalizedFallbackValue === undefined ? "Fallback value could not be resolved" : "Values mismatched significantly";
+                message = shouldBeExempted ? this.options.preserveSkippedFallbacks && areEqual ? "Preserving fallback for exempted token '".concat(tokenKey, "' (matches exemption '").concat(exemptedPrefix, "')") : "Skip modifying exempted token '".concat(tokenKey, "' (matches exemption '").concat(exemptedPrefix, "')") : normalizedFallbackValue === undefined ? "Fallback value could not be resolved" : "Values mismatched significantly";
                 this.logError(message);
                 if (this.options.addEslintComments) {
                   addOrUpdateEslintIgnoreComment(this.j, tokenValue, fallbackValue, callPath);
@@ -181,7 +203,7 @@ export var TokenProcessor = /*#__PURE__*/function () {
                 resolvedImportDeclaration: importDeclaration,
                 resolvedLocalVarDeclaration: localVarDeclaration
               });
-            case 31:
+            case 26:
             case "end":
               return _context2.stop();
           }
@@ -704,7 +726,7 @@ export var TokenProcessor = /*#__PURE__*/function () {
           }
         }, _callee8, this);
       }));
-      function resolveValueFromImport(_x9, _x10, _x11, _x12) {
+      function resolveValueFromImport(_x9, _x0, _x1, _x10) {
         return _resolveValueFromImport.apply(this, arguments);
       }
       return resolveValueFromImport;

package/dist/types/presets/remove-token-fallbacks/remove-token-fallbacks.d.ts

@@ -13,6 +13,14 @@ import { RemoveTokenFallbackOptions } from './types';
  *   @param {boolean} [options.useLegacyColorTheme] - If true, uses the legacy theme for color token mapping.
  *   @param {string} [options.reportFolder] - Directory path to output transformation reports. Reports will be generated only if this option is provided.
  *   @param {boolean} [options.dry] - If true, performs a dry run without modifying the files.
+ *   @param {string} [options.skipTokens] - A comma-separated list of token prefixes to exempt from automatic fallback removal. By default, 'border' tokens are always included in this list. Whether fallbacks for these tokens are removed when they exactly match depends on the preserveSkippedFallbacks option.
+ *   @param {boolean} [options.preserveSkippedFallbacks] - If true, fallbacks for skipped tokens will never be removed, even if they exactly match the token value. If false (default), fallbacks for skipped tokens will be removed if they exactly match.
+ *   @param {boolean} [options.skipEslint] - If true, skips running ESLint on modified files after transformation.
+ *   @param {boolean} [options.skipPrettier] - If true, skips running Prettier on modified files after transformation.
+ *   @param {number} [options.colorDifferenceThreshold] - The maximum allowed difference for color tokens to be considered acceptable for removal. Default is 15.
+ *   @param {number} [options.spaceDifferenceThreshold] - The maximum allowed percentage difference for space tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.numericDifferenceThreshold] - The maximum allowed percentage difference for numeric tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.borderDifferenceThreshold] - The maximum allowed percentage difference for border tokens to be considered acceptable for removal. Default is 0.
  *
  * @returns {Promise<string>} A promise that resolves to the transformed source code as a string.
  */

package/dist/types/presets/remove-token-fallbacks/types.d.ts

@@ -22,6 +22,14 @@ export type RemoveTokenFallbackOptions = Options & {
     reportFolder?: string;
     addEslintComments?: boolean;
     forceUpdate?: boolean;
+    skipTokens?: string;
+    preserveSkippedFallbacks?: boolean;
+    skipEslint?: boolean;
+    skipPrettier?: boolean;
+    colorDifferenceThreshold?: number;
+    spaceDifferenceThreshold?: number;
+    numericDifferenceThreshold?: number;
+    borderDifferenceThreshold?: number;
 };
 export type WithResolvedDeclarations = {
     resolvedImportDeclaration?: ASTPath<ImportDeclaration>;

package/dist/types/presets/remove-token-fallbacks/utils/normalize-values.d.ts

@@ -1,4 +1,5 @@
-export declare function normalizeValues(tokenKey: string, tokenValue: string | undefined, fallbackValue: string | undefined): {
+import { RemoveTokenFallbackOptions } from '../types';
+export declare function normalizeValues(tokenKey: string, tokenValue: string | undefined, fallbackValue: string | undefined, options?: RemoveTokenFallbackOptions): {
     difference?: number;
     isAcceptableDifference?: boolean;
     tokenLogValue: string;

package/dist/types/presets/remove-token-fallbacks/utils/token-processor.d.ts

@@ -16,6 +16,12 @@ export declare class TokenProcessor {
     private logVerbose;
     private log;
     private logError;
+    /**
+     * Checks if a token should be exempted from automatic fallback removal
+     * @param tokenKey The token key to check
+     * @returns An object containing whether the token should be exempted and related information
+     */
+    private checkTokenExemption;
     private processSingleToken;
     private getTokenKey;
     private getFallbackValue;

package/dist/types-ts4.5/presets/remove-token-fallbacks/remove-token-fallbacks.d.ts

@@ -13,6 +13,14 @@ import { RemoveTokenFallbackOptions } from './types';
  *   @param {boolean} [options.useLegacyColorTheme] - If true, uses the legacy theme for color token mapping.
  *   @param {string} [options.reportFolder] - Directory path to output transformation reports. Reports will be generated only if this option is provided.
  *   @param {boolean} [options.dry] - If true, performs a dry run without modifying the files.
+ *   @param {string} [options.skipTokens] - A comma-separated list of token prefixes to exempt from automatic fallback removal. By default, 'border' tokens are always included in this list. Whether fallbacks for these tokens are removed when they exactly match depends on the preserveSkippedFallbacks option.
+ *   @param {boolean} [options.preserveSkippedFallbacks] - If true, fallbacks for skipped tokens will never be removed, even if they exactly match the token value. If false (default), fallbacks for skipped tokens will be removed if they exactly match.
+ *   @param {boolean} [options.skipEslint] - If true, skips running ESLint on modified files after transformation.
+ *   @param {boolean} [options.skipPrettier] - If true, skips running Prettier on modified files after transformation.
+ *   @param {number} [options.colorDifferenceThreshold] - The maximum allowed difference for color tokens to be considered acceptable for removal. Default is 15.
+ *   @param {number} [options.spaceDifferenceThreshold] - The maximum allowed percentage difference for space tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.numericDifferenceThreshold] - The maximum allowed percentage difference for numeric tokens to be considered acceptable for removal. Default is 0.
+ *   @param {number} [options.borderDifferenceThreshold] - The maximum allowed percentage difference for border tokens to be considered acceptable for removal. Default is 0.
  *
  * @returns {Promise<string>} A promise that resolves to the transformed source code as a string.
  */

package/dist/types-ts4.5/presets/remove-token-fallbacks/types.d.ts

@@ -22,6 +22,14 @@ export type RemoveTokenFallbackOptions = Options & {
     reportFolder?: string;
     addEslintComments?: boolean;
     forceUpdate?: boolean;
+    skipTokens?: string;
+    preserveSkippedFallbacks?: boolean;
+    skipEslint?: boolean;
+    skipPrettier?: boolean;
+    colorDifferenceThreshold?: number;
+    spaceDifferenceThreshold?: number;
+    numericDifferenceThreshold?: number;
+    borderDifferenceThreshold?: number;
 };
 export type WithResolvedDeclarations = {
     resolvedImportDeclaration?: ASTPath<ImportDeclaration>;

package/dist/types-ts4.5/presets/remove-token-fallbacks/utils/normalize-values.d.ts

@@ -1,4 +1,5 @@
-export declare function normalizeValues(tokenKey: string, tokenValue: string | undefined, fallbackValue: string | undefined): {
+import { RemoveTokenFallbackOptions } from '../types';
+export declare function normalizeValues(tokenKey: string, tokenValue: string | undefined, fallbackValue: string | undefined, options?: RemoveTokenFallbackOptions): {
     difference?: number;
     isAcceptableDifference?: boolean;
     tokenLogValue: string;

package/dist/types-ts4.5/presets/remove-token-fallbacks/utils/token-processor.d.ts

@@ -16,6 +16,12 @@ export declare class TokenProcessor {
     private logVerbose;
     private log;
     private logError;
+    /**
+     * Checks if a token should be exempted from automatic fallback removal
+     * @param tokenKey The token key to check
+     * @returns An object containing whether the token should be exempted and related information
+     */
+    private checkTokenExemption;
     private processSingleToken;
     private getTokenKey;
     private getFallbackValue;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/codemod-cli",
-	"version": "0.28.0",
+	"version": "0.28.1",
 	"description": "A cli for distributing codemods for atlassian-frontend components and services",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -39,7 +39,7 @@
 	"bin": "./bin/codemod-cli.js",
 	"dependencies": {
 		"@atlaskit/codemod-utils": "^4.2.0",
-		"@atlaskit/tokens": "^4.6.0",
+		"@atlaskit/tokens": "^5.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@codeshift/utils": "^0.2.4",
 		"@hypermod/utils": "^0.4.2",
@@ -58,7 +58,7 @@
 		"uuid": "^3.1.0"
 	},
 	"devDependencies": {
-		"@af/formatting": "^0.0.4",
+		"@af/formatting": "workspace:^",
 		"@types/color-diff": "^1.2.1",
 		"prettier": "^3.2.5",
 		"ts-node": "^10.9.1",