scss-prettier 4.0.23 → 4.0.24

package/LICENSE.txt

@@ -1,27 +1,27 @@
-Proprietary License
-
-Copyright (c) Daekyung Yoo. All rights reserved.
-
-This software and associated documentation files (the "Software") are the
-exclusive property of Daekyung Yoo.
-
-1. GRANT OF USE: You are granted a non-exclusive, non-transferable license
-   to use the Software solely through official distribution channels
-   (Visual Studio Code Marketplace, npm registry, and the author's servers)
-   for your personal or internal business purposes.
-
-2. RESTRICTIONS: You may NOT, without prior written permission from the
-   copyright holder:
-   - Copy, modify, merge, or create derivative works of the Software
-   - Distribute, sublicense, sell, or transfer the Software
-   - Reverse engineer, decompile, or disassemble the Software
-   - Remove or alter any proprietary notices or labels
-
-3. TERMINATION: This license is effective until terminated. It will
-   terminate automatically if you fail to comply with any term of this
-   license.
-
-4. DISCLAIMER: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
-   KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE
-   LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM THE USE
-   OF THE SOFTWARE.
+Proprietary License
+
+Copyright (c) Daekyung Yoo. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+exclusive property of Daekyung Yoo.
+
+1. GRANT OF USE: You are granted a non-exclusive, non-transferable license
+   to use the Software solely through official distribution channels
+   (Visual Studio Code Marketplace, npm registry, and the author's servers)
+   for your personal or internal business purposes.
+
+2. RESTRICTIONS: You may NOT, without prior written permission from the
+   copyright holder:
+   - Copy, modify, merge, or create derivative works of the Software
+   - Distribute, sublicense, sell, or transfer the Software
+   - Reverse engineer, decompile, or disassemble the Software
+   - Remove or alter any proprietary notices or labels
+
+3. TERMINATION: This license is effective until terminated. It will
+   terminate automatically if you fail to comply with any term of this
+   license.
+
+4. DISCLAIMER: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE
+   LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM THE USE
+   OF THE SOFTWARE.

package/README.md

@@ -37,10 +37,12 @@ The only formatter that combines **property sorting + inline formatting** in a s
 .box { color: red; padding: 10px; background: blue; display: flex; margin: 5px; }
 
 /* After - Ctrl+S */
-.box { display: flex; padding: 10px; margin: 5px; background: blue; color: red; }
+.box {
+  display: flex; padding: 10px; margin: 5px; color: red; background: blue;
+}
 ```
 
-Properties are automatically sorted: **position → display → width → padding → margin → background → color**
+Properties are automatically sorted: **position → display → width → padding → margin → color → background**
 
 ---
 
@@ -71,7 +73,7 @@ Properties on one line — compact and scroll-efficient.
 
 ```scss
 .card {
-  display: flex; padding: 20px; margin: 10px; background: white; color: #333;
+  display: flex; padding: 20px; margin: 10px; color: #333; background: white;
 }
 ```
 
@@ -83,8 +85,8 @@ Each property on its own line — traditional style.
   display: flex;
   padding: 20px;
   margin: 10px;
-  background: white;
   color: #333;
+  background: white;
 }
 ```
 
@@ -92,7 +94,7 @@ Each property on its own line — traditional style.
 Everything compressed.
 
 ```scss
-.card{display:flex;padding:20px;margin:10px;background:white;color:#333;}
+.card{display:flex;padding:20px;margin:10px;color:#333;background:white;}
 ```
 
 Set globally: `"scssPrettier.formatMode": "expanded"`
@@ -134,18 +136,30 @@ Override per-rule with `///expand` or `///minify` directives.
 | `scssPrettier.shorthandCascade` | `true` | Protect shorthand/longhand order |
 | `scssPrettier.removeEmptyRules` | `false` | Remove empty rule blocks |
 | `scssPrettier.duplicateProperties` | `"ignore"` | `ignore` / `warn` / `remove` |
+| `scssPrettier.printWidth` | `0` | Max line length in inline mode (`0` = unlimited) |
+| `scssPrettier.quoteStyle` | `"preserve"` | `preserve` / `single` / `double` |
+| `scssPrettier.sortEnabled` | `true` | Sort properties (`false` keeps the written order) |
 | `scssPrettier.exclude` | `[]` | File patterns to skip |
 | `scssPrettier.debugJson` | `false` | Export AST to JSON |
 
 ### Workspace Config (`.scssPrettier.json`)
 
+Put a config file in your project so the editor, the CLI and the LSP server all format the same way.
+It accepts the same keys as the VS Code settings (without the `scssPrettier.` prefix):
+
 ```json
 {
-  "propsPriority": ["position", "display", "width", "height", "padding", "margin"]
+  "formatMode": "expanded",
+  "indentSize": 2,
+  "quoteStyle": "single",
+  "propsPriority": ["position", "display", "width", "height", "padding", "margin"],
+  "exclude": ["**/vendor/**"]
 }
 ```
 
-Priority: `.scssPrettier.json` > VS Code settings > Default preset
+The nearest `.scssPrettier.json` above the file being formatted is used.
+
+Priority: CLI flags > `.scssPrettier.json` > VS Code settings > Defaults
 
 ---
 
@@ -187,6 +201,8 @@ Custom properties (`--*`) maintain their authored order in any selector.
 .box { margin: 10px; margin-left: 0; }
 ```
 
+Declarations that only partly overlap (`border-left` and `border-color`, `padding-block` and `padding-top`, …) keep the order you wrote them in, because swapping them would change the result.
+
 ### Vendor Prefix Grouping
 ```scss
 /* Grouped together */