First version

CTOAsYouGo/node_modules/postcss-nested/README.md

@@ -2,9 +2,9 @@
 
 <img align="right" width="135" height="95"
      title="Philosopher’s stone, logo of PostCSS"
-     src="https://postcss.org/logo-leftp.svg">
+     src="http://postcss.github.io/postcss/logo-leftp.svg">
 
-[PostCSS] plugin to unwrap nested rules closer to Sass syntax.
+[PostCSS] plugin to unwrap nested rules like how Sass does it.
 
 ```css
 .phone {
@@ -27,6 +27,7 @@
 
   @at-root html {
       --font: 16px
+    }
   }
 }
 ```
@@ -60,27 +61,111 @@ html {
 Related plugins:
 
 * Use [`postcss-current-selector`] **after** this plugin if you want
-  to use current selector in properties or variables values.
+to use current selector in properties or variables values.
 * Use [`postcss-nested-ancestors`] **before** this plugin if you want
-  to reference any ancestor element directly in your selectors with `^&`.
+to reference any ancestor element directly in your selectors with `^&`.
 
 Alternatives:
 
-* See also [`postcss-nesting`], which implements [CSSWG draft].
+* See also [`postcss-nesting`], which implements [CSSWG draft]
+  (requires the `&` and introduces `@nest`).
 * [`postcss-nested-props`] for nested properties like `font-size`.
 
 <a href="https://evilmartians.com/?utm_source=postcss-nested">
-  <img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg"
-       alt="Sponsored by Evil Martians" width="236" height="54">
+<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54">
 </a>
 
 [`postcss-current-selector`]: https://github.com/komlev/postcss-current-selector
 [`postcss-nested-ancestors`]: https://github.com/toomuchdesign/postcss-nested-ancestors
 [`postcss-nested-props`]:     https://github.com/jedmao/postcss-nested-props
-[`postcss-nesting`]:          https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-nesting
+[`postcss-nesting`]:          https://github.com/jonathantneal/postcss-nesting
 [CSSWG draft]:              https://drafts.csswg.org/css-nesting-1/
 [PostCSS]:                  https://github.com/postcss/postcss
 
+## Usage
 
-## Docs
-Read full docs **[here](https://github.com/postcss/postcss-nested#readme)**.
+```js
+postcss([ require('postcss-nested') ])
+```
+
+See [PostCSS] docs for examples for your environment.
+
+## Options
+
+### `bubble`
+
+By default, plugin will bubble only `@media` and `@supports` at-rules.
+You can add your custom at-rules to this list by `bubble` option:
+
+```js
+postcss([ require('postcss-nested')({ bubble: ['phone'] }) ])
+```
+
+```css
+/* input */
+a {
+  color: white;
+  @phone {
+    color: black;
+  }
+}
+/* output */
+a {
+  color: white;
+}
+@phone {
+  a {
+    color: black;
+  }
+}
+```
+
+### `unwrap`
+
+By default, plugin will unwrap only `@font-face`, `@keyframes` and `@document`
+at-rules. You can add your custom at-rules to this list by `unwrap` option:
+
+```js
+postcss([ require('postcss-nested')({ unwrap: ['phone'] }) ])
+```
+
+```css
+/* input */
+a {
+  color: white;
+  @phone {
+    color: black;
+  }
+}
+/* output */
+a {
+  color: white;
+}
+@phone {
+  color: black;
+}
+```
+
+### `preserveEmpty`
+
+By default, plugin will strip out any empty selector generated by intermediate
+nesting levels. You can set `preserveEmpty` to `true` to preserve them.
+
+```css
+.a {
+    .b {
+        color: black;
+    }
+}
+```
+
+Will be compiled to:
+
+```css
+.a { }
+.a .b {
+    color: black;
+}
+```
+
+This is especially useful if you want to export the empty classes with `postcss-modules`.