@atlaskit/stylelint-design-system
Version:
Stylelint plugin for use with the Atlassian Design System.
100 lines (96 loc) • 4.07 kB
JavaScript
;
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.ruleName = exports.messages = exports.default = void 0;
var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
var _postcssValueParser = _interopRequireDefault(require("postcss-value-parser"));
var _stylelint = _interopRequireDefault(require("stylelint"));
var _renameMapping = _interopRequireDefault(require("@atlaskit/tokens/rename-mapping"));
var _getCssCustomProperty = require("@atlaskit/tokens/utils/get-css-custom-property");
var _isFunction = require("../../utils/is-function");
var _isWord = require("../../utils/is-word");
var ruleName = exports.ruleName = 'design-system/no-deprecated-design-token-usage';
var messages = exports.messages = _stylelint.default.utils.ruleMessages(ruleName, {
invalidToken: function invalidToken(name, replacement) {
return "The token '".concat(name, "' has been deprecated. Please use ").concat(replacement, " instead.");
},
deprecatedToken: function deprecatedToken(name) {
return "The token '".concat(name, "' is deprecated, Please refer to the changelog for guidance on how to migrate. https://atlassian.design/components/tokens/changelog");
}
});
var isDeprecatedToken = function isDeprecatedToken(node) {
return (0, _isWord.isWord)(node) && node.value.startsWith('--ds-') && _renameMapping.default.filter(function (_ref) {
var state = _ref.state;
return state === 'deprecated';
}).some(function (token) {
return (0, _getCssCustomProperty.getCSSCustomProperty)(token.path) === node.value;
});
};
// eslint-disable-next-line @typescript-eslint/no-unused-vars
var ruleBase = function ruleBase(isEnabled) {
var flags = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
var context = arguments.length > 2 ? arguments[2] : undefined;
return function (root, result) {
var validOptions = _stylelint.default.utils.validateOptions(result, ruleName, {
actual: isEnabled,
possible: [true, false]
});
if (!validOptions || !isEnabled) {
return;
}
root.walkDecls(function (decl) {
var parsedValue = (0, _postcssValueParser.default)(decl.value);
parsedValue.walk(function (node) {
if (!(0, _isFunction.isFunction)(node) || node.value !== 'var') {
return;
}
var _node$nodes = (0, _slicedToArray2.default)(node.nodes, 1),
head = _node$nodes[0];
if (!head) {
return;
}
if (isDeprecatedToken(head)) {
var tokenMeta = _renameMapping.default.find(function (_ref2) {
var path = _ref2.path;
return (0, _getCssCustomProperty.getCSSCustomProperty)(path) === head.value;
});
if (!tokenMeta) {
return;
}
if (tokenMeta.replacement) {
var replacement = (0, _getCssCustomProperty.getCSSCustomProperty)(tokenMeta.replacement);
if (context.fix) {
decl.value = decl.value.replace(head.value, replacement);
return;
} else {
return _stylelint.default.utils.report({
message: messages.invalidToken(head.value, replacement),
node: decl,
word: node.value,
result: result,
ruleName: ruleName
});
}
}
// No replacement specified
return _stylelint.default.utils.report({
message: messages.deprecatedToken(head.value),
node: decl,
word: node.value,
result: result,
ruleName: ruleName
});
}
});
});
};
};
var rule = Object.assign(ruleBase, {
ruleName: ruleName,
messages: messages
});
var plugin = _stylelint.default.createPlugin(ruleName, rule);
// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
var _default = exports.default = plugin;