create-docusaurus 0.0.0-4376 → 0.0.0-4383

package/templates/facebook/node_modules/stylelint/lib/rules/time-min-milliseconds/index.js

@@ -0,0 +1,142 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const declarationValueIndex = require('../../utils/declarationValueIndex');
+const keywordSets = require('../../reference/keywordSets');
+const optionsMatches = require('../../utils/optionsMatches');
+const postcss = require('postcss');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+const valueParser = require('postcss-value-parser');
+const vendor = require('../../utils/vendor');
+
+const ruleName = 'time-min-milliseconds';
+
+const messages = ruleMessages(ruleName, {
+	expected: (time) => `Expected a minimum of ${time} milliseconds`,
+});
+
+const DELAY_PROPERTIES = new Set(['animation-delay', 'transition-delay']);
+
+function rule(minimum, options) {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: minimum,
+				possible: _.isNumber,
+			},
+			{
+				actual: options,
+				possible: {
+					ignore: ['delay'],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		root.walkDecls((decl) => {
+			const propertyName = vendor.unprefixed(decl.prop.toLowerCase());
+
+			if (
+				keywordSets.longhandTimeProperties.has(propertyName) &&
+				!isIgnoredProperty(propertyName) &&
+				!isAcceptableTime(decl.value)
+			) {
+				complain(decl);
+			}
+
+			if (keywordSets.shorthandTimeProperties.has(propertyName)) {
+				const valueListList = postcss.list.comma(decl.value);
+
+				for (const valueListString of valueListList) {
+					const valueList = postcss.list.space(valueListString);
+
+					if (optionsMatches(options, 'ignore', 'delay')) {
+						// Check only duration time values
+						const duration = getDuration(valueList);
+
+						if (duration && !isAcceptableTime(duration)) {
+							complain(decl, decl.value.indexOf(duration));
+						}
+					} else {
+						// Check all time values
+						for (const value of valueList) {
+							if (!isAcceptableTime(value)) {
+								complain(decl, decl.value.indexOf(value));
+							}
+						}
+					}
+				}
+			}
+		});
+
+		/**
+		 * Get the duration within an `animation` or `transition` shorthand property value.
+		 *
+		 * @param {Node[]} valueList
+		 *
+		 * @returns {Node}
+		 */
+		function getDuration(valueList) {
+			for (const value of valueList) {
+				const parsedTime = valueParser.unit(value);
+
+				if (!parsedTime) continue;
+
+				// The first numeric value in an animation shorthand is the duration.
+				return value;
+			}
+		}
+
+		function isIgnoredProperty(propertyName) {
+			if (optionsMatches(options, 'ignore', 'delay') && DELAY_PROPERTIES.has(propertyName)) {
+				return true;
+			}
+
+			return false;
+		}
+
+		function isAcceptableTime(time) {
+			const parsedTime = valueParser.unit(time);
+
+			if (!parsedTime) return true;
+
+			if (parsedTime.number <= 0) {
+				return true;
+			}
+
+			if (parsedTime.unit.toLowerCase() === 'ms' && parsedTime.number < minimum) {
+				return false;
+			}
+
+			if (parsedTime.unit.toLowerCase() === 's' && parsedTime.number * 1000 < minimum) {
+				return false;
+			}
+
+			return true;
+		}
+
+		function complain(decl, offset = 0) {
+			report({
+				result,
+				ruleName,
+				message: messages.expected(minimum),
+				index: declarationValueIndex(decl) + offset,
+				node: decl,
+			});
+		}
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/unicode-bom/README.md

@@ -0,0 +1,41 @@
+# unicode-bom
+
+Require or disallow the Unicode Byte Order Mark.
+
+## Options
+
+`string`: `"always"|"never"`
+
+### `"always"`
+
+The following pattern is considered a violation:
+
+<!-- prettier-ignore -->
+```css
+a {}
+```
+
+The following pattern is _not_ considered a violation:
+
+<!-- prettier-ignore -->
+```css
+U+FEFF
+a {}
+```
+
+### `"never"`
+
+The following pattern is considered a violation:
+
+<!-- prettier-ignore -->
+```css
+U+FEFF
+a {}
+```
+
+The following pattern is _not_ considered a violation:
+
+<!-- prettier-ignore -->
+```css
+a {}
+```

package/templates/facebook/node_modules/stylelint/lib/rules/unicode-bom/index.js

@@ -0,0 +1,59 @@
+// @ts-nocheck
+
+'use strict';
+
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+
+const ruleName = 'unicode-bom';
+
+const messages = ruleMessages(ruleName, {
+	expected: 'Expected Unicode BOM',
+	rejected: 'Unexpected Unicode BOM',
+});
+
+function rule(expectation) {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, {
+			actual: expectation,
+			possible: ['always', 'never'],
+		});
+
+		if (
+			!validOptions ||
+			root.source.inline ||
+			root.source.lang === 'object-literal' ||
+			// Ignore HTML documents
+			root.document !== undefined
+		) {
+			return;
+		}
+
+		const { hasBOM } = root.source.input;
+
+		if (expectation === 'always' && !hasBOM) {
+			report({
+				result,
+				ruleName,
+				message: messages.expected,
+				root,
+				line: 1,
+			});
+		}
+
+		if (expectation === 'never' && hasBOM) {
+			report({
+				result,
+				ruleName,
+				message: messages.rejected,
+				root,
+				line: 1,
+			});
+		}
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/unit-allowed-list/README.md

@@ -0,0 +1,115 @@
+# unit-allowed-list
+
+Specify a list of allowed units.
+
+<!-- prettier-ignore -->
+```css
+a { width: 100px; }
+/**           ↑
+ *  These units */
+```
+
+## Options
+
+`array|string`: `["array", "of", "units"]|"unit"`
+
+Given:
+
+```
+["px", "em", "deg"]
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { width: 100%; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { font-size: 10rem; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { animation: animation-name 5s ease; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { font-size: 1.2em; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { line-height: 1.2; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { height: 100px; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { height: 100PX; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { transform: rotate(30deg); }
+```
+
+## Optional secondary options
+
+### `ignoreProperties: { unit: ["property", "/regex/", /regex/] }`
+
+Ignore units in the values of declarations with the specified properties.
+
+For example, with `["px", "em"]`.
+
+Given:
+
+```
+{
+  "rem": [ "line-height", "/^border/" ],
+  "%": [ "width" ]
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { line-height: 0.1rem; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { border-bottom-width: 6rem; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { width: 100%; }
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { margin: 0 20rem; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { -moz-border-radius-topright: 20rem; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { height: 100%; }
+```

package/templates/facebook/node_modules/stylelint/lib/rules/unit-allowed-list/index.js

@@ -0,0 +1,85 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const atRuleParamIndex = require('../../utils/atRuleParamIndex');
+const declarationValueIndex = require('../../utils/declarationValueIndex');
+const getUnitFromValueNode = require('../../utils/getUnitFromValueNode');
+const optionsMatches = require('../../utils/optionsMatches');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateObjectWithArrayProps = require('../../utils/validateObjectWithArrayProps');
+const validateOptions = require('../../utils/validateOptions');
+const valueParser = require('postcss-value-parser');
+
+const ruleName = 'unit-allowed-list';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (unit) => `Unexpected unit "${unit}"`,
+});
+
+function rule(listInput, options) {
+	const list = [].concat(listInput);
+
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: list,
+				possible: [_.isString],
+			},
+			{
+				optional: true,
+				actual: options,
+				possible: {
+					ignoreProperties: validateObjectWithArrayProps([_.isString, _.isRegExp]),
+				},
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		function check(node, value, getIndex) {
+			// make sure multiplication operations (*) are divided - not handled
+			// by postcss-value-parser
+			value = value.replace(/\*/g, ',');
+			valueParser(value).walk((valueNode) => {
+				// Ignore wrong units within `url` function
+				if (valueNode.type === 'function' && valueNode.value.toLowerCase() === 'url') {
+					return false;
+				}
+
+				const unit = getUnitFromValueNode(valueNode);
+
+				if (!unit || (unit && list.includes(unit.toLowerCase()))) {
+					return;
+				}
+
+				if (options && optionsMatches(options.ignoreProperties, unit.toLowerCase(), node.prop)) {
+					return;
+				}
+
+				report({
+					index: getIndex(node) + valueNode.sourceIndex,
+					message: messages.rejected(unit),
+					node,
+					result,
+					ruleName,
+				});
+			});
+		}
+
+		root.walkAtRules(/^media$/i, (atRule) => check(atRule, atRule.params, atRuleParamIndex));
+		root.walkDecls((decl) => check(decl, decl.value, declarationValueIndex));
+	};
+}
+
+rule.primaryOptionArray = true;
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/unit-blacklist/README.md

@@ -0,0 +1,161 @@
+# unit-blacklist
+
+**_Deprecated: Instead use the [`unit-disallowed-list`](../unit-disallowed-list/README.md) rule._**
+
+Specify a list of disallowed units.
+
+<!-- prettier-ignore -->
+```css
+a { width: 100px; }
+/**           ↑
+ *  These units */
+```
+
+## Options
+
+`array|string`: `["array", "of", "units"]|"unit"`
+
+Given:
+
+```
+["px", "em", "deg"]
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { width: 100px; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { font-size: 10em; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { transform: rotate(30deg); }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { font-size: 1.2rem; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { line-height: 1.2; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { height: 100vmin; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { animation: animation-name 5s ease; }
+```
+
+## Optional secondary options
+
+### `ignoreProperties: { unit: ["property", "/regex/", /regex/] }`
+
+Ignore units in the values of declarations with the specified properties.
+
+For example, with `["px", "vmin"]`.
+
+Given:
+
+```
+{
+  "px": [ "font-size", "/^border/" ],
+  "vmin": [ "width" ]
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { font-size: 13px; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { border-bottom-width: 6px; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { width: 100vmin; }
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { line-height: 12px; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { -moz-border-radius-topright: 40px; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { height: 100vmin; }
+```
+
+### `ignoreMediaFeatureNames: { unit: ["property", "/regex/", /regex/] }`
+
+Ignore units for specific feature names.
+
+For example, with `["px", "dpi"]`.
+
+Given:
+
+```
+{
+  "px": [ "min-width", "/height$/" ],
+  "dpi": [ "resolution" ]
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+@media (min-width: 960px) {}
+```
+
+<!-- prettier-ignore -->
+```css
+@media (max-height: 280px) {}
+```
+
+<!-- prettier-ignore -->
+```css
+@media not (resolution: 300dpi) {}
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+@media screen and (max-device-width: 500px) {}
+```
+
+<!-- prettier-ignore -->
+```css
+@media all and (min-width: 500px) and (max-width: 200px) {}
+```
+
+<!-- prettier-ignore -->
+```css
+@media print and (max-resolution: 100dpi) {}
+```