AModule: retain existing default behavior when unconfigured

man/waybar-styles.5.scd.in

@@ -42,22 +42,24 @@ You can apply special styling to any module for when the cursor hovers it.
 ## Setting cursor style
 
 Most, if not all, module types support setting the `cursor` option. This is
-configured in your `config.jsonc`. If set to `true`, when hovering the module a
+configured in your `config.jsonc`. If set to `false`, when hovering the module a
 "pointer"(as commonly known from web CSS styling `cursor: pointer`) style cursor
-will be shown.
+will not be shown. Default behavior is to indicate an interaction event is
+available.
+
 There are more cursor types to choose from by setting the `cursor` option to
 a number, see Gdk3 official docs for all possible cursor types:
 https://docs.gtk.org/gdk3/enum.CursorType.html.
 However, note that not all cursor options listed may be available on
 your system. If you attempt to use a cursor which is not available, the
 application will crash.
 
-Example of enabling pointer(`Gdk::Hand2`) cursor type on a custom module:
+Example of disabling pointer(`Gdk::Hand2`) cursor type on a custom module:
 
 ```
 "custom/my-custom-module": {
     ...
-    "cursor": true,
+    "cursor": false,
 }
 ```
 

src/AModule.cpp

@@ -69,6 +69,7 @@ AModule::AModule(const Json::Value& config, const std::string& name, const std::
     event_box_.signal_scroll_event().connect(sigc::mem_fun(*this, &AModule::handleScroll));
   }
 
+  // Respect user configuration of cursor
   if (config_.isMember("cursor")) {
     if (config_["cursor"].isBool() && config_["cursor"].asBool()) {
       setCursor(Gdk::HAND2);
@@ -125,13 +126,25 @@ bool AModule::handleMouseEnter(GdkEventCrossing* const& e) {
   if (auto* module = event_box_.get_child(); module != nullptr) {
     module->set_state_flags(Gtk::StateFlags::STATE_FLAG_PRELIGHT);
   }
+
+  // Default behavior indicating event availability
+  if (hasUserEvents_ && !config_.isMember("cursor")) {
+    setCursor(Gdk::HAND2);
+  }
+
   return false;
 }
 
 bool AModule::handleMouseLeave(GdkEventCrossing* const& e) {
   if (auto* module = event_box_.get_child(); module != nullptr) {
     module->unset_state_flags(Gtk::StateFlags::STATE_FLAG_PRELIGHT);
   }
+
+  // Default behavior indicating event availability
+  if (hasUserEvents_ && !config_.isMember("cursor")) {
+    setCursor(Gdk::ARROW);
+  }
+
   return false;
 }