scss-prettier 4.0.22 → 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

@@ -3,14 +3,14 @@
 
 **Professional CSS/SCSS/LESS formatter with property sorting, inline & expanded modes, and smart cascade protection.**
 
-The only formatter that combines **property sorting + inline formatting** in a single tool. No more juggling Prettier + Stylelint + postcss-sorting.
+The only formatter that combines **property sorting + inline formatting** in a single tool — no extra plugins or config needed.
 
 ---
 
 ## Why SCSS Prettier?
 
-| Feature | Prettier | Stylelint+Order | CSScomb | **SCSS Prettier** |
-|---------|:--------:|:---------------:|:-------:|:-----------------:|
+| Feature | Tool A | Tool B | Tool C | **SCSS Prettier** |
+|---------|:------:|:------:|:------:|:-----------------:|
 | Property Sorting | No | Plugin | Dead | **Built-in** |
 | Inline Mode | No | No | Yes | **Yes (default)** |
 | Expanded Mode | Yes | N/A | Yes | **Yes** |
@@ -20,6 +20,12 @@ The only formatter that combines **property sorting + inline formatting** in a s
 | Cascade Protection | No | No | No | **Yes** |
 | Active Maintenance | Yes | Yes | No | **Yes** |
 
+### Inline Formatting
+<img src="https://github.com/user-attachments/assets/e1f20be8-6a23-46fb-990f-a84277d9876f" width="600" />
+
+### Property Sorting
+<img src="https://github.com/user-attachments/assets/21fa9fc8-7158-4512-a09f-f741a64480f6" width="600" />
+
 ---
 
 ## Quick Start
@@ -31,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**
 
 ---
 
@@ -65,20 +73,20 @@ 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;
 }
 ```
 
 ### Expanded
-Each property on its own line — like Prettier.
+Each property on its own line — traditional style.
 
 ```scss
 .card {
   display: flex;
   padding: 20px;
   margin: 10px;
-  background: white;
   color: #333;
+  background: white;
 }
 ```
 
@@ -86,7 +94,7 @@ Each property on its own line — like Prettier.
 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"`
@@ -128,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
 
 ---
 
@@ -181,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 */