Namespace Hyprland events under bread.hyprland.*, keep legacy names via [compat]

normalize_hyprland() dual-emits each of its 10 flat event names
(bread.workspace.changed, bread.monitor.connected, bread.window.opened,
etc.) alongside a bread.hyprland.<rest> equivalent, so portable automation
can subscribe to bread.hyprland.* and be guaranteed compositor-specific
coverage without also matching genuinely cross-backend events like
bread.power.*. The bread.hyprland.event fallback was already namespaced
and is unaffected.

Gated behind [compat] legacy_hyprland_event_names (default true during
the deprecation window) so the old names keep firing until modules
migrate; set to false to emit only the namespaced names.
EventNormalizer::with_legacy_hyprland_event_names(bool) is a builder on
top of the existing ::new(dedup_window_ms), threaded through from config
in main.rs.

Bumps API_VERSION to 1.5.0 (additive), updates Documentation.md's
Hyprland event reference with Deprecated/Since markers and the new
[compat] option, refreshes the README config example and the
dock-workflow/git-branch-widget examples to the namespaced names, and
adds DEPRECATIONS.md tracking the deferred full removal once the window
closes.

examples/modules/git-branch-widget.lua

@@ -146,8 +146,8 @@ function M.on_load()
     -- catch a branch switch inside the same still-focused tab (e.g. `git
     -- checkout` run without ever changing window focus), which produces no
     -- focus event at all.
-    bread.on("bread.window.focused", update)
-    bread.on("bread.window.focus.changed", update)
+    bread.on("bread.hyprland.window.focused", update)
+    bread.on("bread.hyprland.window.focus.changed", update)
     bread.every(2000, update)
 end