create-docusaurus 0.0.0-4378 → 0.0.0-4388

package/templates/facebook/node_modules/stylelint/lib/rules/block-closing-brace-empty-line-before/README.md

@@ -0,0 +1,238 @@
+# block-closing-brace-empty-line-before
+
+Require or disallow an empty line before the closing brace of blocks.
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+  /* ← */
+} /* ↑ */
+/**  ↑
+ * This line */
+```
+
+The [`fix` option](../../../docs/user-guide/usage/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`string`: `"always-multi-line"|"never"`
+
+### `always-multi-line`
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+```
+
+### `never`
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+```
+
+## Optional secondary options
+
+### `except: ["after-closing-brace"]`
+
+When a rule is nested, `after-closing-brace` brace will reverse the primary option.
+
+For example, with `"never"` and `except: ["after-closing-brace"]`:
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+  }
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@font-face {
+  font-family: "MyFont";
+  src: url("myfont.woff2") format("woff2");
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+  }
+
+}
+```
+
+For example, with `"always-multi-line"` and `except: ["after-closing-brace"]`:
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+
+  }
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+
+  }
+
+}
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+@media print {
+
+  a {
+    color: aquamarine;
+
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@font-face {
+  font-family: "MyFont";
+  src: url("myfont.woff2") format("woff2");
+
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@supports (animation-name: test) {
+
+  a {
+    color: aquamarine;
+
+  }
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@keyframes test {
+
+  100% {
+    color: aquamarine;
+
+  }
+}
+```

package/templates/facebook/node_modules/stylelint/lib/rules/block-closing-brace-empty-line-before/index.js

@@ -0,0 +1,118 @@
+// @ts-nocheck
+
+'use strict';
+
+const addEmptyLineAfter = require('../../utils/addEmptyLineAfter');
+const blockString = require('../../utils/blockString');
+const hasBlock = require('../../utils/hasBlock');
+const hasEmptyBlock = require('../../utils/hasEmptyBlock');
+const hasEmptyLine = require('../../utils/hasEmptyLine');
+const isSingleLineString = require('../../utils/isSingleLineString');
+const optionsMatches = require('../../utils/optionsMatches');
+const removeEmptyLineAfter = require('../../utils/removeEmptyLinesAfter');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+
+const ruleName = 'block-closing-brace-empty-line-before';
+
+const messages = ruleMessages(ruleName, {
+	expected: 'Expected empty line before closing brace',
+	rejected: 'Unexpected empty line before closing brace',
+});
+
+function rule(expectation, options, context) {
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: expectation,
+				possible: ['always-multi-line', 'never'],
+			},
+			{
+				actual: options,
+				possible: {
+					except: ['after-closing-brace'],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		// Check both kinds of statements: rules and at-rules
+		root.walkRules(check);
+		root.walkAtRules(check);
+
+		function check(statement) {
+			// Return early if blockless or has empty block
+			if (!hasBlock(statement) || hasEmptyBlock(statement)) {
+				return;
+			}
+
+			// Get whitespace after ""}", ignoring extra semicolon
+			const before = (statement.raws.after || '').replace(/;+/, '');
+
+			// Calculate index
+			const statementString = statement.toString();
+			let index = statementString.length - 1;
+
+			if (statementString[index - 1] === '\r') {
+				index -= 1;
+			}
+
+			// Set expectation
+			const expectEmptyLineBefore = (() => {
+				const childNodeTypes = statement.nodes.map((item) => item.type);
+
+				// Reverse the primary options if `after-closing-brace` is set
+				if (
+					optionsMatches(options, 'except', 'after-closing-brace') &&
+					statement.type === 'atrule' &&
+					!childNodeTypes.includes('decl')
+				) {
+					return expectation === 'never';
+				}
+
+				return Boolean(
+					expectation === 'always-multi-line' && !isSingleLineString(blockString(statement)),
+				);
+			})();
+
+			// Check for at least one empty line
+			const hasEmptyLineBefore = hasEmptyLine(before);
+
+			// Return if the expectation is met
+			if (expectEmptyLineBefore === hasEmptyLineBefore) {
+				return;
+			}
+
+			if (context.fix) {
+				if (expectEmptyLineBefore) {
+					addEmptyLineAfter(statement, context.newline);
+				} else {
+					removeEmptyLineAfter(statement, context.newline);
+				}
+
+				return;
+			}
+
+			const message = expectEmptyLineBefore ? messages.expected : messages.rejected;
+
+			report({
+				message,
+				result,
+				ruleName,
+				node: statement,
+				index,
+			});
+		}
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;

package/templates/facebook/node_modules/stylelint/lib/rules/block-closing-brace-newline-after/README.md

@@ -0,0 +1,196 @@
+# block-closing-brace-newline-after
+
+Require a newline or disallow whitespace after the closing brace of blocks.
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+a { color: red; }↑
+/**              ↑
+ * The newline after this brace */
+```
+
+This rule allows an end-of-line comment separated from the closing brace by spaces, as long as the comment contains no newlines. For example,
+
+<!-- prettier-ignore -->
+```css
+a {
+  color: pink;
+} /* end-of-line comment */
+```
+
+This rule allows a trailing semicolon after the closing brace of a block. For example,
+
+<!-- prettier-ignore -->
+```css
+:root {
+  --toolbar-theme: {
+    background-color: hsl(120, 70%, 95%);
+  };
+/* ↑
+ * This semicolon */
+}
+```
+
+The [`fix` option](../../../docs/user-guide/usage/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`string`: `"always"|"always-single-line"|"never-single-line"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There _must always_ be a newline after the closing brace.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+b { color: red; }
+```
+
+### `"always-single-line"`
+
+There _must always_ be a newline after the closing brace in single-line blocks.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; } b { color: red; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }
+b { color: red; }
+```
+
+### `"never-single-line"`
+
+There _must never_ be whitespace after the closing brace in single-line blocks.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; } b { color: red; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+### `"always-multi-line"`
+
+There _must always_ be a newline after the closing brace in multi-line blocks.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}b { color: red; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; }b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}
+b { color: red; }
+```
+
+### `"never-multi-line"`
+
+There _must never_ be whitespace after the closing brace in multi-line blocks.
+
+The following patterns are considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+} b { color: red; }
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+a { color: pink; } b { color: red; }
+```
+
+<!-- prettier-ignore -->
+```css
+a { color: pink;
+}b { color: red; }
+```
+
+## Optional secondary options
+
+### `ignoreAtRules: ["/regex/", "non-regex"]`
+
+Ignore specified at-rules.
+
+For example, with `"always"` or `"always-multi-line"`.
+
+Given:
+
+```
+["if", "else"]
+```
+
+The following patterns are _not_ considered violations:
+
+<!-- prettier-ignore -->
+```css
+@if ($var) {
+  color: pink;
+} @else if ($var2) {
+  color: red;
+} @else {
+  color: blue;
+}
+```
+
+<!-- prettier-ignore -->
+```css
+@if ($var) { color: pink; } @else { color: blue; }
+```

package/templates/facebook/node_modules/stylelint/lib/rules/block-closing-brace-newline-after/index.js

@@ -0,0 +1,137 @@
+// @ts-nocheck
+
+'use strict';
+
+const _ = require('lodash');
+const blockString = require('../../utils/blockString');
+const hasBlock = require('../../utils/hasBlock');
+const optionsMatches = require('../../utils/optionsMatches');
+const rawNodeString = require('../../utils/rawNodeString');
+const report = require('../../utils/report');
+const ruleMessages = require('../../utils/ruleMessages');
+const validateOptions = require('../../utils/validateOptions');
+const whitespaceChecker = require('../../utils/whitespaceChecker');
+
+const ruleName = 'block-closing-brace-newline-after';
+
+const messages = ruleMessages(ruleName, {
+	expectedAfter: () => 'Expected newline after "}"',
+	expectedAfterSingleLine: () => 'Expected newline after "}" of a single-line block',
+	rejectedAfterSingleLine: () => 'Unexpected whitespace after "}" of a single-line block',
+	expectedAfterMultiLine: () => 'Expected newline after "}" of a multi-line block',
+	rejectedAfterMultiLine: () => 'Unexpected whitespace after "}" of a multi-line block',
+});
+
+function rule(expectation, options, context) {
+	const checker = whitespaceChecker('newline', expectation, messages);
+
+	return (root, result) => {
+		const validOptions = validateOptions(
+			result,
+			ruleName,
+			{
+				actual: expectation,
+				possible: [
+					'always',
+					'always-single-line',
+					'never-single-line',
+					'always-multi-line',
+					'never-multi-line',
+				],
+			},
+			{
+				actual: options,
+				possible: {
+					ignoreAtRules: [_.isString],
+				},
+				optional: true,
+			},
+		);
+
+		if (!validOptions) {
+			return;
+		}
+
+		// Check both kinds of statements: rules and at-rules
+		root.walkRules(check);
+		root.walkAtRules(check);
+
+		function check(statement) {
+			if (!hasBlock(statement)) {
+				return;
+			}
+
+			if (optionsMatches(options, 'ignoreAtRules', statement.name)) {
+				return;
+			}
+
+			const nextNode = statement.next();
+
+			if (!nextNode) {
+				return;
+			}
+
+			// Allow an end-of-line comment x spaces after the brace
+			const nextNodeIsSingleLineComment =
+				nextNode.type === 'comment' &&
+				!/[^ ]/.test(nextNode.raws.before || '') &&
+				!nextNode.toString().includes('\n');
+
+			const nodeToCheck = nextNodeIsSingleLineComment ? nextNode.next() : nextNode;
+
+			if (!nodeToCheck) {
+				return;
+			}
+
+			let reportIndex = statement.toString().length;
+			let source = rawNodeString(nodeToCheck);
+
+			// Skip a semicolon at the beginning, if any
+			if (source && source.startsWith(';')) {
+				source = source.slice(1);
+				reportIndex++;
+			}
+
+			// Only check one after, because there might be other
+			// spaces handled by the indentation rule
+			checker.afterOneOnly({
+				source,
+				index: -1,
+				lineCheckStr: blockString(statement),
+				err: (msg) => {
+					if (context.fix) {
+						if (expectation.startsWith('always')) {
+							const index = nodeToCheck.raws.before.search(/\r?\n/);
+
+							if (index >= 0) {
+								nodeToCheck.raws.before = nodeToCheck.raws.before.slice(index);
+							} else {
+								nodeToCheck.raws.before = context.newline + nodeToCheck.raws.before;
+							}
+
+							return;
+						}
+
+						if (expectation.startsWith('never')) {
+							nodeToCheck.raws.before = '';
+
+							return;
+						}
+					}
+
+					report({
+						message: msg,
+						node: statement,
+						index: reportIndex,
+						result,
+						ruleName,
+					});
+				},
+			});
+		}
+	};
+}
+
+rule.ruleName = ruleName;
+rule.messages = messages;
+module.exports = rule;