Add ignoreFunctions option to function-no-unknown

lib/rules/function-no-unknown/README.md

@@ -35,3 +35,46 @@ a { transform: scale(1); }
 ```css
 a { transform: --custom-function(1); }
 ```
+
+## Optional secondary options
+
+### `ignoreFunctions: ["/regex/", /regex/, "non-regex"]`
+
+Ignore the specified functions.
+
+For example, with `true`.
+
+Given:
+
+```json
+["theme", "/^foo-/"]
+```
+
+The following patterns are considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { transform: unknown(1); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { transform: THEME(1); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { transform: foo(1); }
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+a { transform: theme(1); }
+```
+
+<!-- prettier-ignore -->
+```css
+a { transform: foo-func(1); }
+```

lib/rules/function-no-unknown/__tests__/index.js

@@ -56,3 +56,42 @@ testRule({
 		},
 	],
 });
+
+testRule({
+	ruleName,
+	config: [true, { ignoreFunctions: ['theme', '/^foo-/', /^bar$/i] }],
+	skipBasicChecks: true,
+
+	accept: [
+		{
+			code: 'a { transform: translate(1px); }',
+		},
+		{
+			code: 'a { transform: theme(1px); }',
+		},
+		{
+			code: 'a { transform: foo-func(1px); }',
+		},
+		{
+			code: 'a { transform: bar(1px); }',
+		},
+		{
+			code: 'a { transform: BAR(1px); }',
+		},
+	],
+
+	reject: [
+		{
+			code: 'a { transform: unknown(1px); }',
+			message: messages.rejected('unknown'),
+			line: 1,
+			column: 16,
+		},
+		{
+			code: 'a { transform: theme-custom(1px); }',
+			message: messages.rejected('theme-custom'),
+			line: 1,
+			column: 16,
+		},
+	],
+});

lib/rules/function-no-unknown/index.js

@@ -6,11 +6,13 @@ const valueParser = require('postcss-value-parser');
 const functionsListPath = require('css-functions-list');
 
 const declarationValueIndex = require('../../utils/declarationValueIndex');
+const matchesStringOrRegExp = require('../../utils/matchesStringOrRegExp');
 const report = require('../../utils/report');
 const ruleMessages = require('../../utils/ruleMessages');
 const validateOptions = require('../../utils/validateOptions');
 const isStandardSyntaxFunction = require('../../utils/isStandardSyntaxFunction');
 const isCustomFunction = require('../../utils/isCustomFunction');
+const { isRegExp, isString } = require('../../utils/validateTypes');
 
 const ruleName = 'function-no-unknown';
 
@@ -23,14 +25,34 @@ const meta = {
 };
 
 /** @type {import('stylelint').Rule} */
-const rule = (primary) => {
+const rule = (primary, secondaryOptions) => {
 	return (root, result) => {
-		const validOptions = validateOptions(result, ruleName, { actual: primary });
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: primary },
+			{
+				actual: secondaryOptions,
+				possible: {
+					ignoreFunctions: [isString, isRegExp],
+				},
+				optional: true,
+			},
+		);
 
 		if (!validOptions) {
 			return;
 		}
 
+		/** @type {Array<string | RegExp>} */
+		const ignoreFunctions = (secondaryOptions && secondaryOptions.ignoreFunctions) || [];
+
+		/** @type {(funcName: string) => boolean} */
+		const isFunctionIgnored =
+			ignoreFunctions.length === 0
+				? () => false
+				: (funcName) => Boolean(matchesStringOrRegExp(funcName, ignoreFunctions));
+
 		const path = new URL(functionsListPath.toString(), 'file://');
 		const functionsList = JSON.parse(fs.readFileSync(path, 'utf8'));
 
@@ -50,6 +72,10 @@ const rule = (primary) => {
 					return;
 				}
 
+				if (isFunctionIgnored(node.value)) {
+					return;
+				}
+
 				if (functionsList.includes(node.value.toLowerCase())) {
 					return;
 				}