create-docusaurus 0.0.0-4377 → 0.0.0-4384

package/templates/facebook/node_modules/stylelint/lib/rules/declaration-block-no-duplicate-properties/README.md

@@ -0,0 +1,143 @@
+# declaration-block-no-duplicate-properties
+
+Disallow duplicate properties within declaration blocks.
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; color: orange; }
+/** ↑            ↑
+ * These duplicated properties */
+```
+
+This rule ignores variables (`$sass`, `@less`, `--custom-property`).
+
+## Options
+
+### `true`
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; color: orange; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; background: orange; color: orange }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; background: orange; }
+```
+
+## Optional secondary options
+
+### `ignore: ["consecutive-duplicates"]`
+
+Ignore consecutive duplicated properties.
+
+They can prove to be useful fallbacks for older browsers.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+p {
+  font-size: 16px;
+  font-weight: 400;
+  font-size: 1rem;
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+p {
+  font-size: 16px;
+  font-size: 1rem;
+  font-weight: 400;
+}
+```
+
+### `ignore: ["consecutive-duplicates-with-different-values"]`
+
+Ignore consecutive duplicated properties with different values.
+
+Including duplicate properties (fallbacks) is useful to deal with older browsers support for CSS properties. E.g. using `px` units when `rem` isn't available.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+/* properties with the same value */
+p {
+  font-size: 16px;
+  font-size: 16px;
+  font-weight: 400;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+/* nonconsecutive duplicates */
+p {
+  font-size: 16px;
+  font-weight: 400;
+  font-size: 1rem;
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+p {
+  font-size: 16px;
+  font-size: 1rem;
+  font-weight: 400;
+}
+```
+
+### `ignoreProperties: ["/regex/", "non-regex"]`
+
+Ignore duplicates of specific properties.
+
+Given:
+
+```
+["color", "/background-/"]
+```
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; background: orange; background: white; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { background: orange; color: pink; background: white; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; color: orange; background-color: orange; background-color: white; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; background-color: orange; color: orange; background-color: white; }
+```

package/templates/facebook/node_modules/stylelint/lib/rules/declaration-block-no-duplicate-properties/index.js

@@ -0,0 +1,121 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const eachDeclarationBlock = require('../../utils/eachDeclarationBlock');
+const isCustomProperty = require('../../utils/isCustomProperty');
+const isStandardSyntaxProperty = require('../../utils/isStandardSyntaxProperty');
+const optionsMatches = require('../../utils/optionsMatches');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+
+const ruleName = 'declaration-block-no-duplicate-properties';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (property) => `Unexpected duplicate "${property}"`,
+});
+
+function rule(on, options) {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual: on },
+			{
+				actual: options,
+				possible: {
+					ignore: ['consecutive-duplicates', 'consecutive-duplicates-with-different-values'],
+					ignoreProperties: [_.isString],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		eachDeclarationBlock(root, (eachDecl) => {
+			const decls = [];
+			const values = [];
+
+			eachDecl((decl) => {
+				const prop = decl.prop;
+				const value = decl.value;
+
+				if (!isStandardSyntaxProperty(prop)) {
+					return;
+				}
+
+				if (isCustomProperty(prop)) {
+					return;
+				}
+
+				// Return early if the property is to be ignored
+				if (optionsMatches(options, 'ignoreProperties', prop)) {
+					return;
+				}
+
+				// Ignore the src property as commonly duplicated in at-fontface
+				if (prop.toLowerCase() === 'src') {
+					return;
+				}
+
+				const indexDuplicate = decls.indexOf(prop.toLowerCase());
+
+				if (indexDuplicate !== -1) {
+					if (optionsMatches(options, 'ignore', 'consecutive-duplicates-with-different-values')) {
+						// if duplicates are not consecutive
+						if (indexDuplicate !== decls.length - 1) {
+							report({
+								message: messages.rejected(prop),
+								node: decl,
+								result,
+								ruleName,
+							});
+
+							return;
+						}
+
+						// if values of consecutive duplicates are equal
+						if (value === values[indexDuplicate]) {
+							report({
+								message: messages.rejected(value),
+								node: decl,
+								result,
+								ruleName,
+							});
+
+							return;
+						}
+
+						return;
+					}
+
+					if (
+						optionsMatches(options, 'ignore', 'consecutive-duplicates') &&
+						indexDuplicate === decls.length - 1
+					) {
+						return;
+					}
+
+					report({
+						message: messages.rejected(prop),
+						node: decl,
+						result,
+						ruleName,
+					});
+				}
+
+				decls.push(prop.toLowerCase());
+				values.push(value.toLowerCase());
+			});
+		});
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/declaration-block-no-redundant-longhand-properties/README.md

@@ -0,0 +1,197 @@
+# declaration-block-no-redundant-longhand-properties
+
+Disallow longhand properties that can be combined into one shorthand property.
+
+<!-- prettier-ignore -->
+```css
+  a {
+    padding-top: 1px;
+    padding-right: 2px;
+    padding-bottom: 3px;
+    padding-left: 4px; }
+/** ↑
+ *  These longhand properties */
+```
+
+The longhand properties in the example above can be more concisely written as:
+
+<!-- prettier-ignore -->
+```css
+a {
+  padding: 1px 2px 3px 4px;
+}
+```
+
+This rule will only complain if you've used the longhand equivalent of _all_ the properties that the shorthand will set.
+
+This rule complains when the following shorthand properties can be used:
+
+- `margin`
+- `padding`
+- `background`
+- `font`
+- `border`
+- `border-top`
+- `border-bottom`
+- `border-left`
+- `border-right`
+- `border-width`
+- `border-style`
+- `border-color`
+- `list-style`
+- `border-radius`
+- `transition`
+- `animation`
+- `border-block-end`
+- `border-block-start`
+- `border-image`
+- `border-inline-end`
+- `border-inline-start`
+- `column-rule`
+- `columns`
+- `flex`
+- `flex-flow`
+- `grid`
+- `grid-area`
+- `grid-column`
+- `grid-gap`
+- `grid-row`
+- `grid-template`
+- `outline`
+- `text-decoration`
+- `text-emphasis`
+- `mask`
+
+**Please note** that properties are considered to be redundant if they may be written shorthand according to the specification, **regardless of the behavior of any individual browser**. For example, due to Internet Explorer's implementation of Flexbox, [it may not be possible to use the shorthand property `flex`](https://github.com/philipwalton/flexbugs#flexbug-8), but the longhand form is still considered a violation.
+
+Flexbox-related properties can be ignored using `ignoreShorthands: ["/flex/"]` (see below).
+
+## Options
+
+### `true`
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  margin-top: 1px;
+  margin-right: 2px;
+  margin-bottom: 3px;
+  margin-left: 4px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  font-style: italic;
+  font-variant: normal;
+  font-weight: bold;
+  font-stretch: normal;
+  font-size: 14px;
+  line-height: 1.2;
+  font-family: serif;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  -webkit-transition-property: top;
+  -webkit-transition-duration: 2s;
+  -webkit-transition-timing-function: ease;
+  -webkit-transition-delay: 0.5s;
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  margin: 1px 2px 3px 4px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  font: italic normal bold normal 14px/1.2 serif;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  -webkit-transition: top 2s ease 0.5s;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  margin-top: 1px;
+  margin-right: 2px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  margin-top: 1px;
+  margin-right: 2px;
+  margin-bottom: 3px;
+}
+```
+
+## Optional secondary options
+
+### `ignoreShorthands: ["/regex/", /regex/, "string"]`
+
+Given:
+
+```
+["padding", "/border/"]
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  padding-top: 20px;
+  padding-right: 10px;
+  padding-bottom: 30px;
+  padding-left: 10px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  border-top-width: 1px;
+  border-bottom-width: 1px;
+  border-left-width: 1px;
+  border-right-width: 1px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  border-top-width: 1px;
+  border-bottom-width: 1px;
+  border-left-width: 1px;
+  border-right-width: 1px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  border-top-color: green;
+  border-top-style: double;
+  border-top-width: 7px;
+}
+```

package/templates/facebook/node_modules/stylelint/lib/rules/declaration-block-no-redundant-longhand-properties/index.js

@@ -0,0 +1,99 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const eachDeclarationBlock = require('../../utils/eachDeclarationBlock');
+const optionsMatches = require('../../utils/optionsMatches');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const shorthandData = require('../../reference/shorthandData');
+const validateOptions = require('../../utils/validateOptions');
+const vendor = require('../../utils/vendor');
+
+const ruleName = 'declaration-block-no-redundant-longhand-properties';
+
+const messages = ruleMessages(ruleName, {
+	expected: (props) => `Expected shorthand property "${props}"`,
+});
+
+function rule(actual, options) {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{ actual },
+			{
+				actual: options,
+				possible: {
+					ignoreShorthands: [_.isString, _.isRegExp],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		const longhandProperties = _.transform(shorthandData, (longhandProps, values, key) => {
+			if (optionsMatches(options, 'ignoreShorthands', key)) {
+				return;
+			}
+
+			values.forEach((value) => {
+				(longhandProps[value] || (longhandProps[value] = [])).push(key);
+			});
+		});
+
+		eachDeclarationBlock(root, (eachDecl) => {
+			const longhandDeclarations = {};
+
+			eachDecl((decl) => {
+				const prop = decl.prop.toLowerCase();
+				const unprefixedProp = vendor.unprefixed(prop);
+				const prefix = vendor.prefix(prop);
+
+				const shorthandProperties = longhandProperties[unprefixedProp];
+
+				if (!shorthandProperties) {
+					return;
+				}
+
+				shorthandProperties.forEach((shorthandProperty) => {
+					const prefixedShorthandProperty = prefix + shorthandProperty;
+
+					if (!longhandDeclarations[prefixedShorthandProperty]) {
+						longhandDeclarations[prefixedShorthandProperty] = [];
+					}
+
+					longhandDeclarations[prefixedShorthandProperty].push(prop);
+
+					const prefixedShorthandData = shorthandData[shorthandProperty].map((item) => {
+						return prefix + item;
+					});
+
+					if (
+						!_.isEqual(
+							prefixedShorthandData.sort(),
+							longhandDeclarations[prefixedShorthandProperty].sort(),
+						)
+					) {
+						return;
+					}
+
+					report({
+						ruleName,
+						result,
+						node: decl,
+						message: messages.expected(prefixedShorthandProperty),
+					});
+				});
+			});
+		});
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/declaration-block-no-shorthand-property-overrides/README.md

@@ -0,0 +1,69 @@
+# declaration-block-no-shorthand-property-overrides
+
+Disallow shorthand properties that override related longhand properties.
+
+<!-- prettier-ignore -->
+```css
+a { background-repeat: repeat; background: green; }
+/**                            ↑
+ * This overrides the longhand property before it */
+```
+
+In almost every case, this is just an authorial oversight. For more about this behavior, see [MDN's documentation of shorthand properties](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties).
+
+## Options
+
+### `true`
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  padding-left: 10px;
+  padding: 20px;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  transition-property: opacity;
+  transition: opacity 1s linear;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  -webkit-transition-property: opacity;
+  -webkit-transition: opacity 1s linear;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a {
+  border-top-width: 1px;
+  top: 0;
+  bottom: 3px;
+  border: 2px solid blue;
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { padding: 10px; padding-left: 20px; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { transition-property: opacity; } a { transition: opacity 1s linear; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { transition-property: opacity; -webkit-transition: opacity 1s linear; }
+```

package/templates/facebook/node_modules/stylelint/lib/rules/declaration-block-no-shorthand-property-overrides/index.js

@@ -0,0 +1,61 @@
+// @ts-nocheck
+
+'use strict';
+
+const eachDeclarationBlock = require('../../utils/eachDeclarationBlock');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const shorthandData = require('../../reference/shorthandData');
+const validateOptions = require('../../utils/validateOptions');
+const vendor = require('../../utils/vendor');
+
+const ruleName = 'declaration-block-no-shorthand-property-overrides';
+
+const messages = ruleMessages(ruleName, {
+	rejected: (shorthand, original) => `Unexpected shorthand "${shorthand}" after "${original}"`,
+});
+
+function rule(actual) {
+	return (root, result) => {
+		const validOptions = validateOptions(result, ruleName, { actual });
+
+		if (!validOptions) {
+			return;
+		}
+
+		eachDeclarationBlock(root, (eachDecl) => {
+			const declarations = {};
+
+			eachDecl((decl) => {
+				const prop = decl.prop;
+				const unprefixedProp = vendor.unprefixed(prop);
+				const prefix = vendor.prefix(prop).toLowerCase();
+
+				const overrideables = shorthandData[unprefixedProp.toLowerCase()];
+
+				if (!overrideables) {
+					declarations[prop.toLowerCase()] = prop;
+
+					return;
+				}
+
+				overrideables.forEach((longhandProp) => {
+					if (!Object.prototype.hasOwnProperty.call(declarations, prefix + longhandProp)) {
+						return;
+					}
+
+					report({
+						ruleName,
+						result,
+						node: decl,
+						message: messages.rejected(prop, declarations[prefix + longhandProp]),
+					});
+				});
+			});
+		});
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;