feat: add mango modules: workspace,language,keymode,window,layout

man/waybar-mango-window.5.scd

@@ -0,0 +1,70 @@
+waybar-mango-window(5)
+
+# NAME
+
+waybar - mango window module
+
+# DESCRIPTION
+
+The *window* module displays the title and app ID of the currently focused window in the Mango compositor.
+
+# CONFIGURATION
+
+Addressed by *mango/window*
+
+*format*: ++
+	typeof: string ++
+	default: {title} ++
+	The format string. See *FORMAT REPLACEMENTS*.
+
+*rewrite*: ++
+	typeof: object ++
+	Rules to rewrite the window title. Each key is a regular expression and its value is the replacement string. Captures can be used with *$1*, *$2*, etc.
+
+*icon*: ++
+	typeof: bool ++
+	default: false ++
+	Whether to show the application icon.
+
+*icon-size*: ++
+	typeof: integer ++
+	default: 24 ++
+	Size of the application icon in pixels.
+
+*expand*: ++
+	typeof: bool ++
+	default: false ++
+	Enables the module to consume all leftover space.
+
+# FORMAT REPLACEMENTS
+
+*{title}*: The current window title.
+
+*{app_id}*: The app ID of the focused window.
+
+# REWRITE RULES
+
+If the title matches a regular expression from the *rewrite* object, it is replaced by the corresponding value. Regular expression syntax follows ECMAScript rules. Unmatched titles are left unchanged.
+
+# EXAMPLES
+
+```
+"mango/window": {
+	"format": "{title}",
+	"rewrite": {
+		"(.*) - Mozilla Firefox": "🌎 $1",
+		"(.*) - zsh": "> [$1]"
+	},
+	"icon": true,
+	"icon-size": 20
+}
+```
+
+# STYLE
+
+- *#window*
+- *#window.empty* – applied when no window is focused (module hidden by default)
+- *#window.solo* – applied when only one window is present on the active workspace
+- *#window.<app-id>* – applied when a single window with the given app ID is on the workspace
+
+The classes *.empty*, *.solo*, and the app‑ID class are set on the module’s event box.