create-docusaurus 0.0.0-4378 → 0.0.0-4379

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-allowed-list/index.js

@@ -0,0 +1,74 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const isStandardSyntaxRule = require('../../utils/isStandardSyntaxRule');
+const matchesStringOrRegExp = require('../../utils/matchesStringOrRegExp');
+const parseSelector = require('../../utils/parseSelector');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+const vendor = require('../../utils/vendor');
+
+const ruleName = 'selector-pseudo-element-allowed-list';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (selector) => `Unexpected pseudo-element "${selector}"`,
+});
+
+function rule(list) {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: list,
+			possible: [_.isString, _.isRegExp],
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkRules((ruleNode) => {
+			if (!isStandardSyntaxRule(ruleNode)) {
+				return;
+			}
+
+			const selector = ruleNode.selector;
+
+			if (!selector.includes('::')) {
+				return;
+			}
+
+			parseSelector(selector, result, ruleNode, (selectorTree) => {
+				selectorTree.walkPseudos((pseudoNode) => {
+					const value = pseudoNode.value;
+
+					// Ignore pseudo-classes
+					if (value[1] !== ':') {
+						return;
+					}
+
+					const name = value.slice(2);
+
+					if (matchesStringOrRegExp(vendor.unprefixed(name), list)) {
+						return;
+					}
+
+					report({
+						index: pseudoNode.sourceIndex,
+						message: messages.rejected(name),
+						node: ruleNode,
+						result,
+						ruleName,
+					});
+				});
+			});
+		});
+	};
+}
+
+rule.primaryOptionArray = true;
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-blacklist/README.md

@@ -0,0 +1,56 @@
+# selector-pseudo-element-blacklist
+
+**_Deprecated: Instead use the [`selector-pseudo-element-disallowed-list`](../selector-pseudo-element-disallowed-list/README.md) rule._**
+
+Specify a list of disallowed pseudo-element selectors.
+
+<!-- prettier-ignore -->
+```css
+  a::before {}
+/**  ↑
+ * This pseudo-element selector */
+```
+
+This rule ignores:
+
+- CSS2 pseudo-elements i.e. those prefixed with a single colon
+- selectors that use variable interpolation e.g. `::#{$variable} {}`
+
+## Options
+
+`array|string|regex`: `["array", "of", "unprefixed", "pseudo-elements" or "regex"]|"pseudo-element"|/regex/`
+
+Given:
+
+```
+["before", "/^my-/i"]
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a::before {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::my-pseudo-element {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::MY-OTHER-pseudo-element {}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a::after {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::not-my-pseudo-element {}
+```

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-blacklist/index.js

@@ -0,0 +1,84 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const isStandardSyntaxRule = require('../../utils/isStandardSyntaxRule');
+const matchesStringOrRegExp = require('../../utils/matchesStringOrRegExp');
+const parseSelector = require('../../utils/parseSelector');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+const vendor = require('../../utils/vendor');
+
+const ruleName = 'selector-pseudo-element-blacklist';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (selector) => `Unexpected pseudo-element "${selector}"`,
+});
+
+function rule(list) {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: list,
+			possible: [_.isString, _.isRegExp],
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		result.warn(
+			`'${ruleName}' has been deprecated. Instead use 'selector-pseudo-element-disallowed-list'.`,
+			{
+				stylelintType: 'deprecation',
+				stylelintReference: `https://github.com/stylelint/stylelint/blob/13.7.0/lib/rules/${ruleName}/README.md`,
+			},
+		);
+
+		root.walkRules((ruleNode) => {
+			if (!isStandardSyntaxRule(ruleNode)) {
+				return;
+			}
+
+			const selector = ruleNode.selector;
+
+			if (!selector.includes('::')) {
+				return;
+			}
+
+			parseSelector(selector, result, ruleNode, (selectorTree) => {
+				selectorTree.walkPseudos((pseudoNode) => {
+					const value = pseudoNode.value;
+
+					// Ignore pseudo-classes
+					if (value[1] !== ':') {
+						return;
+					}
+
+					const name = value.slice(2);
+
+					if (!matchesStringOrRegExp(vendor.unprefixed(name), list)) {
+						return;
+					}
+
+					report({
+						index: pseudoNode.sourceIndex,
+						message: messages.rejected(name),
+						node: ruleNode,
+						result,
+						ruleName,
+					});
+				});
+			});
+		});
+	};
+}
+
+rule.primaryOptionArray = true;
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+rule.meta = { deprecated: true };
+
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-case/README.md

@@ -0,0 +1,128 @@
+# selector-pseudo-element-case
+
+Specify lowercase or uppercase for pseudo-element selectors.
+
+<!-- prettier-ignore -->
+```css
+  a::before {}
+/**  ↑
+ * This pseudo-element selector */
+```
+
+The [`fix` option](../../../docs/user-guide/usage/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`string`: `"lower"|"upper"`
+
+### `"lower"`
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a:Before {}
+```
+
+<!-- prettier-ignore -->
+```css
+a:bEfOrE {}
+```
+
+<!-- prettier-ignore -->
+```css
+a:BEFORE {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::Before {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::bEfOrE {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::BEFORE {}
+```
+
+<!-- prettier-ignore -->
+```css
+input::-MOZ-PLACEHOLDER {}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a:before {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::before {}
+```
+
+<!-- prettier-ignore -->
+```css
+input::-moz-placeholder {}
+```
+
+### `"upper"`
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a:Before {}
+```
+
+<!-- prettier-ignore -->
+```css
+a:bEfOrE {}
+```
+
+<!-- prettier-ignore -->
+```css
+a:BEFORE {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::Before {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::bEfOrE {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::before {}
+```
+
+<!-- prettier-ignore -->
+```css
+input::-moz-placeholder {}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a:BEFORE {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::BEFORE {}
+```
+
+<!-- prettier-ignore -->
+```css
+input::-MOZ-PLACEHOLDER {}
+```

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-case/index.js

@@ -0,0 +1,84 @@
+// @ts-nocheck
+
+'use strict';
+
+const isStandardSyntaxRule = require('../../utils/isStandardSyntaxRule');
+const isStandardSyntaxSelector = require('../../utils/isStandardSyntaxSelector');
+const keywordSets = require('../../reference/keywordSets');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const transformSelector = require('../../utils/transformSelector');
+const validateOptions = require('../../utils/validateOptions');
+
+const ruleName = 'selector-pseudo-element-case';
+
+const messages = ruleMessages(ruleName, {
+	expected: (actual, expected) => `Expected "${actual}" to be "${expected}"`,
+});
+
+function rule(expectation, options, context) {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: expectation,
+			possible: ['lower', 'upper'],
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkRules((ruleNode) => {
+			if (!isStandardSyntaxRule(ruleNode)) {
+				return;
+			}
+
+			const selector = ruleNode.selector;
+
+			if (!selector.includes(':')) {
+				return;
+			}
+
+			transformSelector(result, ruleNode, (selectorTree) => {
+				selectorTree.walkPseudos((pseudoNode) => {
+					const pseudoElement = pseudoNode.value;
+
+					if (!isStandardSyntaxSelector(pseudoElement)) {
+						return;
+					}
+
+					if (
+						!pseudoElement.includes('::') &&
+						!keywordSets.levelOneAndTwoPseudoElements.has(pseudoElement.toLowerCase().slice(1))
+					) {
+						return;
+					}
+
+					const expectedPseudoElement =
+						expectation === 'lower' ? pseudoElement.toLowerCase() : pseudoElement.toUpperCase();
+
+					if (pseudoElement === expectedPseudoElement) {
+						return;
+					}
+
+					if (context.fix) {
+						pseudoNode.value = expectedPseudoElement;
+
+						return;
+					}
+
+					report({
+						message: messages.expected(pseudoElement, expectedPseudoElement),
+						node: ruleNode,
+						index: pseudoNode.sourceIndex,
+						ruleName,
+						result,
+					});
+				});
+			});
+		});
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-colon-notation/README.md

@@ -0,0 +1,136 @@
+# selector-pseudo-element-colon-notation
+
+Specify single or double colon notation for applicable pseudo-elements.
+
+<!-- prettier-ignore -->
+```css
+    a::before {}
+/**  ↑
+ * This notation */
+```
+
+The `::` notation was chosen for _pseudo-elements_ to establish a discrimination between _pseudo-classes_ (which subclass existing elements) and _pseudo-elements_ (which are elements not represented in the document tree).
+
+However, for compatibility with existing style sheets, user agents also accept the previous one-colon notation for _pseudo-elements_ introduced in CSS levels 1 and 2 (namely, `:first-line`, `:first-letter`, `:before` and `:after`).
+
+The [`fix` option](../../../docs/user-guide/usage/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`string`: `"single"|"double"`
+
+### `"single"`
+
+Applicable pseudo-elements _must always_ use the single colon notation.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a::before { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a::after { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a::first-letter { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a::first-line { color: pink; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a:before { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a:after { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a:first-letter { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a:first-line { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+input::placeholder { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+li::marker { font-variant-numeric: tabular-nums; }
+```
+
+### `"double"`
+
+Applicable pseudo-elements _must always_ use the double colon notation.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a:before { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a:after { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a:first-letter { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a:first-line { color: pink; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a::before { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a::after { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a::first-letter { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a::first-line { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+input::placeholder { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+li::marker { font-variant-numeric: tabular-nums; }
+```

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-colon-notation/index.js

@@ -0,0 +1,94 @@
+// @ts-nocheck
+
+'use strict';
+
+const isStandardSyntaxRule = require('../../utils/isStandardSyntaxRule');
+const keywordSets = require('../../reference/keywordSets');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const styleSearch = require('style-search');
+const validateOptions = require('../../utils/validateOptions');
+
+const ruleName = 'selector-pseudo-element-colon-notation';
+
+const messages = ruleMessages(ruleName, {
+	expected: (q) => `Expected ${q} colon pseudo-element notation`,
+});
+
+function rule(expectation, options, context) {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: expectation,
+			possible: ['single', 'double'],
+		});
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkRules((ruleNode) => {
+			if (!isStandardSyntaxRule(ruleNode)) {
+				return;
+			}
+
+			const selector = ruleNode.selector;
+
+			// get out early if no pseudo elements or classes
+			if (!selector.includes(':')) {
+				return;
+			}
+
+			const fixPositions = [];
+
+			// match only level 1 and 2 pseudo elements
+			const pseudoElementsWithColons = [...keywordSets.levelOneAndTwoPseudoElements].map(
+				(x) => `:${x}`,
+			);
+
+			styleSearch({ source: selector.toLowerCase(), target: pseudoElementsWithColons }, (match) => {
+				const prevCharIsColon = selector[match.startIndex - 1] === ':';
+
+				if (expectation === 'single' && !prevCharIsColon) {
+					return;
+				}
+
+				if (expectation === 'double' && prevCharIsColon) {
+					return;
+				}
+
+				if (context.fix) {
+					fixPositions.unshift({ ruleNode, startIndex: match.startIndex });
+
+					return;
+				}
+
+				report({
+					message: messages.expected(expectation),
+					node: ruleNode,
+					index: match.startIndex,
+					result,
+					ruleName,
+				});
+			});
+
+			if (fixPositions.length) {
+				// If expecting : then we found :: so remove one of the colons
+				// If expecting :: then we found : so add one extra colon
+				const expectedSingle = expectation === 'single';
+				const offset = expectedSingle ? 1 : 0;
+				const extraColon = expectedSingle ? '' : ':';
+
+				fixPositions.forEach((fixPosition) => {
+					ruleNode.selector =
+						ruleNode.selector.substring(0, fixPosition.startIndex - offset) +
+						extraColon +
+						ruleNode.selector.substring(fixPosition.startIndex);
+				});
+			}
+		});
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/selector-pseudo-element-disallowed-list/README.md

@@ -0,0 +1,54 @@
+# selector-pseudo-element-disallowed-list
+
+Specify a list of disallowed pseudo-element selectors.
+
+<!-- prettier-ignore -->
+```css
+  a::before {}
+/**  ↑
+ * This pseudo-element selector */
+```
+
+This rule ignores:
+
+- CSS2 pseudo-elements i.e. those prefixed with a single colon
+- selectors that use variable interpolation e.g. `::#{$variable} {}`
+
+## Options
+
+`array|string|regex`: `["array", "of", "unprefixed", "pseudo-elements" or "regex"]|"pseudo-element"|/regex/`
+
+Given:
+
+```
+["before", "/^my-/i"]
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a::before {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::my-pseudo-element {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::MY-OTHER-pseudo-element {}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a::after {}
+```
+
+<!-- prettier-ignore -->
+```css
+a::not-my-pseudo-element {}
+```