first commit

node_modules/stylelint/lib/utils/configurationComment.mjs

@@ -0,0 +1,65 @@
+import { assertString } from './validateTypes.mjs';
+
+export const DISABLE_COMMAND = '-disable';
+export const DISABLE_LINE_COMMAND = '-disable-line';
+export const DISABLE_NEXT_LINE_COMMAND = '-disable-next-line';
+export const ENABLE_COMMAND = '-enable';
+
+const ALL_COMMANDS = new Set([
+	DISABLE_COMMAND,
+	DISABLE_LINE_COMMAND,
+	DISABLE_NEXT_LINE_COMMAND,
+	ENABLE_COMMAND,
+]);
+
+export const DEFAULT_CONFIGURATION_COMMENT = 'stylelint';
+
+/** @typedef {import('postcss').Comment} Comment */
+
+/**
+ * Extract a command from a given comment.
+ *
+ * @param {string} commentText
+ * @param {string} [configurationComment]
+ * @returns {string}
+ */
+export function extractConfigurationComment(
+	commentText,
+	configurationComment = DEFAULT_CONFIGURATION_COMMENT,
+) {
+	const [command] = commentText.split(/\s/, 1);
+
+	assertString(command);
+
+	return command.replace(configurationComment, '');
+}
+
+/**
+ * Tests if the given comment is a Stylelint command.
+ *
+ * @param {string} commentText
+ * @param {string} [configurationComment]
+ * @returns {boolean}
+ */
+export function isConfigurationComment(
+	commentText,
+	configurationComment = DEFAULT_CONFIGURATION_COMMENT,
+) {
+	const command = extractConfigurationComment(commentText, configurationComment);
+
+	return command !== undefined && ALL_COMMANDS.has(command);
+}
+
+/**
+ * Get full stylelint command
+ *
+ * @param {string} command
+ * @param {string} [configurationComment]
+ * @returns {string}
+ */
+export function getConfigurationComment(
+	command,
+	configurationComment = DEFAULT_CONFIGURATION_COMMENT,
+) {
+	return `${configurationComment}${command}`;
+}