58 lines
1.7 KiB
JavaScript
58 lines
1.7 KiB
JavaScript
'use strict';
|
|
|
|
const { isPlainObject } = require('./utils/validateTypes');
|
|
|
|
// Rule settings can take a number of forms, e.g.
|
|
// a. "rule-name": null
|
|
// b. "rule-name": [null, ...]
|
|
// c. "rule-name": primaryOption
|
|
// d. "rule-name": [primaryOption]
|
|
// e. "rule-name": [primaryOption, secondaryOption]
|
|
// Where primaryOption can be anything: primitive, Object, or Array.
|
|
|
|
/**
|
|
* This function normalizes all the possibilities into the
|
|
* standard form: [primaryOption, secondaryOption]
|
|
* Except in the cases with null, a & b, in which case
|
|
* null is returned
|
|
* @template T
|
|
* @template {Object} O
|
|
* @param {import('stylelint').ConfigRuleSettings<T, O>} rawSettings
|
|
* @param {import('stylelint').Rule<T, O>} [rule]
|
|
* @return {[T] | [T, O] | null}
|
|
*/
|
|
module.exports = function normalizeRuleSettings(rawSettings, rule) {
|
|
if (rawSettings === null || rawSettings === undefined) {
|
|
return null;
|
|
}
|
|
|
|
if (!Array.isArray(rawSettings)) {
|
|
return [rawSettings];
|
|
}
|
|
// Everything below is an array ...
|
|
|
|
const [primary, secondary] = rawSettings;
|
|
|
|
if (rawSettings.length > 0 && (primary === null || primary === undefined)) {
|
|
return null;
|
|
}
|
|
|
|
if (rule && !rule.primaryOptionArray) {
|
|
return rawSettings;
|
|
}
|
|
// Everything below is a rule that CAN have an array for a primary option ...
|
|
// (they might also have something else, e.g. rule-properties-order can
|
|
// have the string "alphabetical")
|
|
|
|
if (rawSettings.length === 1 && Array.isArray(primary)) {
|
|
return rawSettings;
|
|
}
|
|
|
|
if (rawSettings.length === 2 && !isPlainObject(primary) && isPlainObject(secondary)) {
|
|
return rawSettings;
|
|
}
|
|
|
|
// `T` must be an array type, but TSC thinks it's probably invalid to
|
|
// cast `[T]` to `T` so we cast through `any` first.
|
|
return [/** @type {T} */ (/** @type {any} */ (rawSettings))];
|
|
};
|