feat(noctalia): Migrate to Noctalia

NOCTALIA_MODE_PLAN.md

@@ -0,0 +1,75 @@
+# Implementation Plan: Noctalia Mode (Submap), Screenshot Annotations & German Layout Fix
+
+## Background & Objective
+Using `MOD5` (`AltGr`) and `Alt` bindings for Noctalia shortcuts directly conflicted with the German keyboard layout (e.g. `EurKEY` / `de`), blocking characters like **`ß`** (`AltGr + S`), **`ä`**, **`ö`**, and **`ü`**.
+
+This plan outlines:
+1. Creating a dedicated **Noctalia Mode (submap)** in Hyprland triggered by `Super + N`.
+2. Freeing `AltGr` / `MOD5` completely for keyboard typing.
+3. Adding screenshot annotation capabilities using `satty`, `grim`, and `slurp`.
+4. Providing on-screen mode feedback when entering submaps.
+
+---
+
+## Key Files & Scope
+- **`modules/home/desktops/hyprland/keybinds.nix`**: Define the `noctalia` submap and mode notifications in Hyprland.
+- **`modules/home/programs/default.nix`**: Add `satty`, `grim`, and `slurp` packages.
+- **`docs/reference/hyprland.md`**: Update Hyprland reference documentation with the new submap and keybinds.
+- **`docs/reference/noctalia.md`**: Update Noctalia reference documentation.
+
+---
+
+## Detailed Implementation
+
+### 1. Dedicated Noctalia Mode Submap (`Super + N`)
+Pressing **`Super + N`** enters the `noctalia` submap with the following single-key actions (each executing its action and resetting the submap):
+
+| Key | Action | Command |
+| :--- | :--- | :--- |
+| **`n`** | Notifications / Control Center | `noctalia msg panel-toggle control-center notifications` |
+| **`m`** | System Monitor | `noctalia msg panel-toggle control-center monitor` |
+| **`c`** | Calendar | `noctalia msg panel-toggle control-center calendar` |
+| **`s`** | Region Screenshot | `noctalia msg screenshot-region` |
+| **`S`** (*Shift+S*) | Fullscreen Screenshot | `noctalia msg screenshot-fullscreen` |
+| **`a`** | Annotated Screenshot | `grim -g "$(slurp)" - \| satty --filename -` |
+| **`Esc`** / **`Enter`** | Exit Mode | `submap, reset` |
+
+### 2. Retained Global Shortcuts (Direct Access)
+- **`Super + E`**: Application launcher (`noctalia msg panel-toggle launcher`)
+- **`Super + P`**: Session / Power menu (`noctalia msg panel-toggle session`)
+- **`Super + .`**: Emoji picker (`noctalia msg panel-toggle launcher "/emo "`)
+
+### 3. Cleanup & Fix German Layout (`AltGr` / `MOD5`)
+- Remove conflicting shortcuts:
+  - `MOD5 + C` (was calendar)
+  - `MOD5 + S` (was system monitor)
+  - `MOD5 + V` and `Alt + V` (was clipboard)
+- Restores full native support for German characters (`ä`, `ö`, `ü`, `ß`).
+
+### 4. Mode Feedback & Which-Key Indications
+Display transient on-screen banners when entering submaps:
+- **`Super + R` (Resize Mode)**:
+  - Banner: `MODE: RESIZE — [H/J/K/L] Resize  [Shift+H/J/K/L] Fine  [Esc/Enter] Exit`
+- **`Super + G` (Window Mode)**:
+  - Banner: `MODE: WINDOWS — [Q/W/E/R] Move to WS  [B] Toggle Firefox  [Esc/Enter] Exit`
+- **`Super + N` (Noctalia Mode)**:
+  - Banner: `MODE: NOCTALIA — [n] Notifications  [m] Monitor  [c] Calendar  [s] Region  [S] Full  [a] Annotate`
+
+### 5. Packages to Add
+Add the following utilities to `modules/home/programs/default.nix`:
+- `satty` (interactive screenshot annotation with arrows, text, boxes, blur, crop)
+- `grim` (Wayland screen grabber)
+- `slurp` (Wayland region selector)
+
+---
+
+## Verification & Testing
+1. **Flake Evaluation**:
+   - `nix eval .#homeConfigurations."rap@zion".activationPackage.drvPath`
+   - `nix eval .#homeConfigurations."nix@firefly".activationPackage.drvPath`
+2. **Lint & Quality**:
+   - `statix check . && deadnix . && nix fmt`
+3. **Behavioral Test**:
+   - Press `Super + N` → verify mode banner displays.
+   - Press `n`, `m`, `c`, `s`, `S`, or `a` → verify corresponding action triggers and submap resets.
+   - Type `AltGr + S` → verify `ß` is typed without triggering any Hyprland shortcuts.

README.md

@@ -80,6 +80,7 @@ sudo nixos-install --flake .#zion
 
 - [Gaming and Battle.net](./docs/guides/gaming.md)
 - [Hyprland - Keymap](./docs/reference/hyprland.md#keymap)
+- [Noctalia shell](./docs/reference/noctalia.md)
 - [NVIM - Keymap](https://github.com/RAPSNX/neonix/tree/main/docs/keymap.md)
 
 ## Licenses

docs/hosts/firefly.md

@@ -68,7 +68,6 @@ Comma-separated list of URLs:
 *://*.google.com/*, *://chat.ske.eu01.stackit.cloud/*
 ```
 
-
 ### GTK Theme
 
 `nwg-look` is used to configure theme in multiple locations.

docs/reference/hyprland.md

@@ -13,10 +13,12 @@ General docs for hyprland.
 |---|---|
 | `Super+Enter` | Terminal |
 | `Super+E` | Launcher |
-| `Super+P` | Wlogout |
+| `Super+P` | Noctalia session panel |
 | `Super+Q` | Kill active |
-| `Super+N` | Notification Center |
-| `Super+.` | Emoji picker |
+| `Alt+Shift` | Switch keyboard layout |
+| `Alt+Tab` | Window switcher |
+| `Super+N` | Enter Noctalia mode |
+| `Super+.` | Noctalia emoji search |
 
 ## Window
 
@@ -61,7 +63,21 @@ General docs for hyprland.
 |---|---|
 | `Super+Z` | Mumble mute |
 | `Super+Shift+Z` | Mumble deaf |
-| `Super+.` | Emoji picker |
+| `Super+.` | Noctalia emoji search |
+
+## Noctalia Mode
+
+Enter: `Super+N`
+
+| Key | Action |
+|---|---|
+| `N` | Notifications / Control Center |
+| `M` | System monitor |
+| `C` | Calendar |
+| `S` | Screenshot region (Noctalia) |
+| `Shift+S` | Screenshot fullscreen (Noctalia) |
+| `A` | Annotated screenshot (Satty) |
+| `Enter` / `Esc` | Exit |
 
 ## Resize Mode
 
@@ -75,7 +91,7 @@ Enter: `Super+R`
 
 ## Window Mode
 
-Enter: `Super+W`
+Enter: `Super+G`
 
 | Key | Action |
 |---|---|

docs/reference/noctalia.md

@@ -0,0 +1,51 @@
+# Noctalia
+
+Noctalia is the desktop shell for the Hyprland profiles. Hyprland remains the compositor and window-management layer; Noctalia provides the panel, application and emoji launcher, notifications, session actions, wallpapers, clipboard history, tray, OSD, and control centre. Screen locking is handled externally via `swaylock`.
+
+The dock is deliberately disabled.
+
+## Configuration model
+
+`modules/home/desktops/noctalia/default.nix` is the declarative baseline. Noctalia's Settings UI may store user-level overrides in its state directory; these survive rebuilds. The shipped baseline is reapplied only when the Home Manager configuration changes.
+
+Zion also enables Noctalia Greeter through Greetd. Firefly uses the shell role only because it is configured as a Home Manager-only profile.
+
+## Migrated components
+
+| Previous component | Noctalia replacement |
+|---|---|
+| Waybar | Top bar: launcher, workspaces, clock, tray, system monitors and quick controls |
+| Fuzzel and Rofi Emoji | Launcher with application, calculator, emoji, wallpaper and window providers |
+| SwayNC | Notification daemon and notification history |
+| Wlogout | Session panel with lock (delegated to `swaylock`), hibernate, logout, suspend, shutdown and reboot actions |
+| Hyprpaper | Native wallpaper service |
+| Hyprlock | Screen locking via out-of-nix `swaylock` |
+| NetworkManager and Blueman tray applets | Noctalia control-centre widgets and tray |
+| Pavucontrol | Noctalia audio controls |
+| Grimblast package | Noctalia screenshot service |
+
+Noctalia additionally enables clipboard history, screen time, per-output wallpapers, a system monitor, calendar, scheduled night light, brightness OSD, and a Windows-reboot session action on Zion.
+
+## Wallpaper migration
+
+A one-time user service transfers the legacy Hyprpaper assignments after Noctalia starts. It records completion in `$XDG_STATE_HOME/noctalia/.wallpapers-migrated-v1`, so subsequent rebuilds preserve changes made through Noctalia.
+
+| Previous output selector | Wallpaper |
+|---|---|
+| `eDP-1` | `anime-city.jpg` |
+| `DP-1` | `gohan-supersaiyan.png` |
+| Dell `AW2725Q G2QC174` | `luffy-gear-5.jpg` |
+| Samsung `LC27G7xT H4ZNC00167` | `one-piece-logo.jpg` |
+| fallback | `minimal-space.jpg` |
+
+Remove that marker only when the declarative migration should be run again.
+
+## Shell shortcuts
+
+| Key | Action |
+|---|---|
+| `Super+E` | Toggle launcher |
+| `Super+P` | Toggle session panel |
+| `Super+N` | Enter Noctalia mode (`n` notifications, `m` monitor, `c` calendar, `s` region capture, `S` full capture, `a` annotate with satty) |
+| `Super+.` | Open emoji search |
+| `Alt+Tab` | Open window switcher |