Add modular interactive widgets to the Quickshell bar

Introduces a widgets/ directory of first-party QML modules and a common/
helpers library. Widgets auto-load by name from
default/quickshell/bar/widgets/<name>.qml — no edits to shell.qml needed
for additions beyond the firstPartyWidgets registry.

New widgets (all orientation-aware, top/bottom/left/right):
- media: MPRIS now-playing with scrolling label, cover art popup,
  play/pause/skip controls
- audioPanel: master volume slider, output device picker, per-app mixer
- networkPanel: Wi-Fi scan + connect, current connection details
- bluetoothPanel: paired device list, connect/disconnect, battery
- calendar: month grid popup keyed to today
- notificationCenter: live notification feed, DND toggle, clear all
- brightness: slider popup with scroll-to-adjust
- powerProfile: power-saver/balanced/performance picker (UPower)
- systemStats: inline CPU + RAM sparklines, expanded popup with btop
- weatherFlyout: weather popup with refresh and full report
- workspacesPro: animated focus indicator that slides between workspaces
- powerMenu: lock/suspend/log out/reboot/shutdown popup
- idleInhibitor: coffee-cup toggle wired to omarchy-toggle-idle
- microphone: mic state + mute toggle + scroll volume

Common helpers (default/quickshell/bar/common/):
- WidgetButton: hover/press scale animation, tooltip integration
- PopupCard: orientation-aware anchor + slide-in opacity transition
- Slider: drag/wheel-able linear slider with knob hover bump
- PillButton: rounded action button with icon + label

Bar root gains requestPopout/releasePopout so only one popup is open at
a time across widgets.

Updates bar-defaults.json to ship the new widgets out of the box while
keeping the legacy modules available.

default/quickshell/bar/README.md

@@ -4,36 +4,59 @@ This is the Quickshell implementation of the Omarchy status bar.
 
 - `shell.qml` is Omarchy-owned bar engine code. Users should not edit it directly.
 - `bar-defaults.json` is the Omarchy-owned default layout and module settings.
+- `widgets/` holds first-party widgets — modular, interactive components shipped with Omarchy.
+- `common/` holds shared QML helpers (buttons, sliders, popup cards).
 - User overrides live in `~/.config/omarchy/bar.json` and are merged over defaults at runtime.
 - `omarchy-style-bar-position` updates only the user override file.
-- Wi-Fi/LAN state is polled from the active route and NetworkManager so the QML can mirror Waybar's network icons.
-- Tooltips use a small Quickshell `PopupWindow`, not Qt Quick Controls' clipped default tooltip.
 
 Example user override:
 
 ```json
 {
-  "position": "right",
+  "position": "top",
   "layout": {
-    "left": ["omarchy", "workspaces"],
-    "center": ["clock", "weather", "update"],
-    "right": ["tray", "bluetooth", "network", "audio", "cpu", "battery"]
+    "left": ["omarchy", "workspacesPro"],
+    "center": ["media", "calendar", "weatherFlyout"],
+    "right": ["systemStats", "notificationCenter", "bluetoothPanel", "networkPanel", "audioPanel", "brightness", "powerProfile", "battery", "powerMenu"]
   },
-  "modules": {
-    "clock": {
-      "format": "HH:mm",
-      "formatAlt": "dd MMMM 'W'ww yyyy",
-      "verticalFormat": "HH\n—\nmm"
-    }
-  }
+  "centerAnchor": "calendar"
 }
 ```
 
-`centerAnchor` defaults to `clock`. When the anchor module is present in the `center` list, it is pinned to the exact center of the bar and modules before/after it flank that anchor. If the anchor is not in the center list, the center list is centered as a group.
+`centerAnchor` pins one center module to the exact horizontal/vertical center and flanks others around it.
 
-Available built-in modules: `omarchy`, `workspaces`, `clock`, `weather`, `update`, `voxtype`, `screenRecording`, `idle`, `notifications`, `tray`, `bluetooth`, `network`, `audio`, `cpu`, `battery`.
+## Module catalogue
 
-## Custom modules
+### First-party interactive widgets (in `widgets/`)
+
+| Name | What it does | Interactions |
+|---|---|---|
+| `media` | MPRIS now-playing — scrolling track + artist, cover-art popup | left = play/pause · middle = next · scroll = prev/next · right = popup |
+| `audioPanel` | Volume icon + popup with master slider, output-device picker, per-app mixer | left = popup · right = mute · middle = audio TUI · scroll = volume |
+| `networkPanel` | Wi-Fi/Ethernet icon + popup with Wi-Fi scan, signal, connect | left = popup · right = nmtui |
+| `bluetoothPanel` | Bluetooth icon + popup with device list, connect/disconnect, battery | left = popup · right = toggle radio · middle = bluetoothctl TUI |
+| `calendar` | Clock + popup with month-grid calendar | left = popup · right = tz selector |
+| `notificationCenter` | Bell with badge + popup with recent notifications, DND toggle | left = popup · right = toggle DND |
+| `brightness` | Brightness slider + scroll | scroll = adjust · left = popup · middle = reset to 80% |
+| `powerProfile` | Current power profile + popup picker | left = popup |
+| `systemStats` | Inline CPU + memory sparklines, popup with detail | left = popup · right = terminal |
+| `weatherFlyout` | Weather icon + popup with forecast | left = popup · right = full notification |
+| `workspacesPro` | Animated focus indicator that slides between workspaces | left = focus · right = move window · scroll = cycle |
+| `powerMenu` | Power icon → popup with lock/suspend/log out/reboot/shutdown | left = popup |
+| `idleInhibitor` | Coffee-cup that toggles `omarchy-toggle-idle` | left = toggle |
+| `microphone` | Mic icon + scroll volume | left = mute toggle · middle = audio TUI · scroll = source volume |
+
+### Built-in legacy modules (in `shell.qml`)
+
+`omarchy`, `workspaces`, `clock`, `weather`, `update`, `voxtype`, `screenRecording`, `idle`, `notifications`, `tray`, `bluetooth`, `network`, `audio`, `cpu`, `battery`.
+
+These remain available — set them in `layout` to use them instead of the richer widget versions.
+
+## Orientation
+
+All widgets work in `top`, `bottom`, `left`, and `right` positions. Popups anchor on the side opposite the bar edge, sliding into the workspace. Vertical bars use 28px width; widgets that show text fall back to compact icon-only forms (e.g. `media` hides its scrolling label).
+
+## Custom user modules
 
 Add a module name to a layout list, then define it under `modules` in `~/.config/omarchy/bar.json`.
 
@@ -42,7 +65,7 @@ For simple text/JSON output, use a command module:
 ```json
 {
   "layout": {
-    "right": ["tray", "vpn", "audio", "cpu"]
+    "right": ["tray", "vpn", "audioPanel", "cpu"]
   },
   "modules": {
     "vpn": {
@@ -67,7 +90,7 @@ For advanced custom UI, use QML:
 ```json
 {
   "layout": {
-    "right": ["gpu", "audio", "cpu"]
+    "right": ["gpu", "audioPanel", "cpu"]
   },
   "modules": {
     "gpu": {
@@ -106,3 +129,19 @@ Item {
   }
 }
 ```
+
+## Bar properties available to widgets
+
+Widgets receive `bar` (the shell root), `moduleName` (string), and `settings` (object) injected at load time. The bar exposes:
+
+- `bar.foreground`, `bar.background`, `bar.urgent` — theme colors (live-updated)
+- `bar.fontFamily` — current monospace family
+- `bar.position` — `"top" | "bottom" | "left" | "right"`
+- `bar.vertical` — boolean shortcut
+- `bar.barSize` — 26 horizontal / 28 vertical
+- `bar.run(command)` — fire-and-forget bash exec
+- `bar.shellQuote(value)` — safe shell-quote a string
+- `bar.showTooltip(target, text)` / `bar.hideTooltip(target)` — shared tooltip popup
+- `bar.requestPopout(owner)` / `bar.releasePopout(owner)` — one-popup-at-a-time coordinator
+
+Drop new widgets into `widgets/<name>.qml`, add the name to the `firstPartyWidgets` registry in `shell.qml`, and reference it by name in any layout list.