0.4.3: Experimental child widgets inside boxes

Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "hybrid-bar"
 authors = [ "varsity <[email protected]>" ]
-version = "0.4.2"
+version = "0.4.3"
 edition = "2021"
 description = "A simple status bar made for wlroots compositors."
 license = "MIT"

EXPERIMENTAL.md

@@ -0,0 +1,18 @@
+# Experimental Features
+> **Warning**: Experimental features are under development. They may break, change or be removed entirely.
+
+1. Widgets inside boxes
+   - Introduced in version `0.4.3`
+   - New key inside the `box` widget: `widgets`
+```json
+{
+   "left-box_my_box": {
+      "width": 20,
+      "widgets": {
+         "label_experimental": {
+            "text": "Experimental"
+         }
+      }
+   }
+}
+```

FAQ.md

@@ -61,3 +61,7 @@
 - Can I change the namespace for blurring Hybrid Bar on Hyprland?
   - **Available since 0.3.9**
   - Yes you can thanks to this PR: https://github.com/vars1ty/HybridBar/pull/27, option: `hybrid` -> `namespace` (`String`)
+
+- How do I activate experimental features?
+  > **Warning** Experimental features may change, be removed entirely or break at any time.
+  - Set `hybrid` -> `experimental` (`bool`) to `true`, then restart Hybrid.

WIDGETS.md

@@ -1,5 +1,10 @@
 # Widgets
-**NOTE**: In order to use a widget, you'll have to specify how it should be aligned. For example: `left-button`, `centered-button` and `right-button`.
+> **Note**
+> If you add widgets that aren't attached to a `box` widget, you have to specify how the widget should be placed.
+>
+> For example: `left-label_UNIQUE_NAME`
+>
+> For child widgets inside of boxes, you can simply define the widget as `label_UNIQUE_NAME`.
 
 Available widgets:
 
@@ -31,6 +36,7 @@ Keys Supported:
 
 Keys Supported:
 - width: i32
+- widgets: JSON - **EXPERIMENTAL**
 ***
 `cava`:
 

src/macros.rs

@@ -48,3 +48,11 @@ macro_rules! conf_bool {
         }
     };
 }
+
+#[macro_export]
+/// Are experimental features enabled?
+macro_rules! experimental {
+    () => {
+        conf_bool!($crate::constants::HYBRID_ROOT_JSON, "experimental", false)
+    };
+}