From 779c12bc6ad4140456548099d25f341fed4a1269 Mon Sep 17 00:00:00 2001
From: LGUG2Z <LGUG2Z@fastmail.com>
Date: Tue, 19 Nov 2024 19:52:33 -0800
Subject: [PATCH] docs(schema): update all json schemas

---
 schema.bar.json | 210 +++++++++++++++++++++++++++++++++++++++++++++++-
 schema.json     |   2 +-
 2 files changed, 210 insertions(+), 2 deletions(-)

diff --git a/schema.bar.json b/schema.bar.json
index 8dd5b4281..8cc6c01f7 100644
--- a/schema.bar.json
+++ b/schema.bar.json
@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "KomobarConfig",
-  "description": "The `komorebi.bar.json` configuration file reference for `v0.1.30`",
+  "description": "The `komorebi.bar.json` configuration file reference for `v0.1.31`",
   "type": "object",
   "required": [
     "left_widgets",
@@ -47,6 +47,203 @@
         }
       }
     },
+    "grouping": {
+      "description": "Visual grouping for widgets",
+      "oneOf": [
+        {
+          "description": "No grouping is applied",
+          "type": "object",
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "None"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Widgets are grouped as a whole",
+          "type": "object",
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "Bar"
+              ]
+            },
+            "rounding": {
+              "description": "Rounding values for the 4 corners. Can be a single or 4 values.",
+              "anyOf": [
+                {
+                  "description": "All 4 corners are the same",
+                  "type": "number",
+                  "format": "float"
+                },
+                {
+                  "description": "All 4 corners are custom. Order: NW, NE, SW, SE",
+                  "type": "array",
+                  "items": {
+                    "type": "number",
+                    "format": "float"
+                  },
+                  "maxItems": 4,
+                  "minItems": 4
+                }
+              ]
+            },
+            "style": {
+              "description": "Styles for the grouping",
+              "oneOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "Default"
+                  ]
+                },
+                {
+                  "description": "A black shadow is added under the default group",
+                  "type": "string",
+                  "enum": [
+                    "DefaultWithShadow"
+                  ]
+                }
+              ]
+            },
+            "transparency_alpha": {
+              "description": "Alpha value for the color transparency [[0-255]] (default: 200)",
+              "type": "integer",
+              "format": "uint8",
+              "minimum": 0.0
+            }
+          }
+        },
+        {
+          "description": "Widgets are grouped by alignment",
+          "type": "object",
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "Alignment"
+              ]
+            },
+            "rounding": {
+              "description": "Rounding values for the 4 corners. Can be a single or 4 values.",
+              "anyOf": [
+                {
+                  "description": "All 4 corners are the same",
+                  "type": "number",
+                  "format": "float"
+                },
+                {
+                  "description": "All 4 corners are custom. Order: NW, NE, SW, SE",
+                  "type": "array",
+                  "items": {
+                    "type": "number",
+                    "format": "float"
+                  },
+                  "maxItems": 4,
+                  "minItems": 4
+                }
+              ]
+            },
+            "style": {
+              "description": "Styles for the grouping",
+              "oneOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "Default"
+                  ]
+                },
+                {
+                  "description": "A black shadow is added under the default group",
+                  "type": "string",
+                  "enum": [
+                    "DefaultWithShadow"
+                  ]
+                }
+              ]
+            },
+            "transparency_alpha": {
+              "description": "Alpha value for the color transparency [[0-255]] (default: 200)",
+              "type": "integer",
+              "format": "uint8",
+              "minimum": 0.0
+            }
+          }
+        },
+        {
+          "description": "Widgets are grouped individually",
+          "type": "object",
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "Widget"
+              ]
+            },
+            "rounding": {
+              "description": "Rounding values for the 4 corners. Can be a single or 4 values.",
+              "anyOf": [
+                {
+                  "description": "All 4 corners are the same",
+                  "type": "number",
+                  "format": "float"
+                },
+                {
+                  "description": "All 4 corners are custom. Order: NW, NE, SW, SE",
+                  "type": "array",
+                  "items": {
+                    "type": "number",
+                    "format": "float"
+                  },
+                  "maxItems": 4,
+                  "minItems": 4
+                }
+              ]
+            },
+            "style": {
+              "description": "Styles for the grouping",
+              "oneOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "Default"
+                  ]
+                },
+                {
+                  "description": "A black shadow is added under the default group",
+                  "type": "string",
+                  "enum": [
+                    "DefaultWithShadow"
+                  ]
+                }
+              ]
+            },
+            "transparency_alpha": {
+              "description": "Alpha value for the color transparency [[0-255]] (default: 200)",
+              "type": "integer",
+              "format": "uint8",
+              "minimum": 0.0
+            }
+          }
+        }
+      ]
+    },
     "left_widgets": {
       "description": "Left side widgets (ordered left-to-right)",
       "type": "array",
@@ -1758,6 +1955,17 @@
           }
         }
       ]
+    },
+    "transparency_alpha": {
+      "description": "Alpha value for the color transparency [[0-255]] (default: 200)",
+      "type": "integer",
+      "format": "uint8",
+      "minimum": 0.0
+    },
+    "widget_spacing": {
+      "description": "Spacing between widgets (default: 10.0)",
+      "type": "number",
+      "format": "float"
     }
   }
 }
diff --git a/schema.json b/schema.json
index f5ce51f38..d20abb4b3 100644
--- a/schema.json
+++ b/schema.json
@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "StaticConfig",
-  "description": "The `komorebi.json` static configuration file reference for `v0.1.30`",
+  "description": "The `komorebi.json` static configuration file reference for `v0.1.31`",
   "type": "object",
   "properties": {
     "animation": {