.gitignore added
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / stylelint / lib / rules / block-opening-brace-space-before / README.md
diff --git a/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/block-opening-brace-space-before/README.md b/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/block-opening-brace-space-before/README.md
new file mode 100644 (file)
index 0000000..3f4a955
--- /dev/null
@@ -0,0 +1,172 @@
+# block-opening-brace-space-before
+
+Require a single space or disallow whitespace before the opening brace of blocks.
+
+```css
+  a { color: pink; }
+/** ↑
+ * The space before this brace */
+```
+
+## Options
+
+`string`: `"always"|"never"|"always-single-line"|"never-single-line"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There *must always* be a single space before the opening brace.
+
+The following patterns are considered violations:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a
+{ color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a { color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+### `"never"`
+
+There *must never* be whitespace before the opening brace.
+
+The following patterns are considered violations:
+
+```css
+a { color: pink; }
+```
+
+```css
+a
+{ color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a{
+color: pink; }
+```
+
+### `"always-single-line"`
+
+There *must always* be a single space before the opening brace in single-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a{ color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a { color: pink; }
+```
+
+```css
+a{
+color: pink; }
+```
+
+### `"never-single-line"`
+
+There *must never* be whitespace before the opening brace in single-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a { color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+### `"always-multi-line"`
+
+There *must always* be a single space before the opening brace in multi-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a{
+color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+### `"never-multi-line"`
+
+There *must never* be whitespace before the opening brace in multi-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a {
+color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a { color: pink; }
+```
+
+```css
+a{
+color: pink;}
+```
+
+## Optional secondary options
+
+### `ignoreAtRules: ["/regex/", "non-regex"]`
+
+Given:
+
+```js
+["/fo/"]
+```
+
+The following patterns are *not* considered violations:
+
+```css
+@for ...
+{}
+```
+
+```css
+@for ...{}
+```