repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

network: refine spec — preserve shader/compact.signal IPC contract

62b63c6ca5bd5dda35a95439158b7cd73d508d86

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

networkWidgetState() mutates state.shader.values and reads compact.signal/
wifi.enabled. Keep minimal shader{} slot + numeric compact.signal; delete
only the dead descriptor narration fields.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Changed files (1)

quickshell/nuguland/docs/superpowers/specs/2026-06-29-network-popup-redesign-design.md

Modified
123 123 inline? no — fixtures aren't shipped to runtime; `selfTest()` runs the
124 124 pure functions over small inline literals, like audio/brightness).
125 125 - **Delete narration**: `connectivityPanelContract()`, backend metadata
126 - (`usesNativeQuickshellNetworking`, `hostStack`, `nativeApi`, …), the
127 - `network-mini-graph` shader descriptor.
126 + (`backend`, `usesNativeQuickshellNetworking`, `usesHostStack`, `hostStack`,
127 + `nativeApi`, `nativeBackend`, `nativeWifiEnabled`,
128 + `nativeWifiHardwareEnabled`, `nativeCanCheckConnectivity`,
129 + `nativeConnectivity`, `nativeActionRoute`, `helperProcesses`,
130 + `serviceOwnedActions`, `boundedActions`), and the `network-mini-graph`
131 + shader **descriptor** fields (`kind`, `clipped`, `source`, `priorArt`,
132 + `rateSource`, `colors`).
133 +- **MUST survive (IPC contract — verified consumers):**
134 + - `shell.qml:networkWidgetState()` does `state.shader.values = […]` and
135 + `state.shader.history = …`, reads `state.compact.signal / 100` and
136 + `state.wifi.enabled`. So `stateObject` MUST keep:
137 + - `shader` as a real object (minimal `{ "values": [], "history": {} }`)
138 + — assigning to a property of `undefined` throws.
139 + - `compact.signal` as a number 0–100 (map bars→percent: `bars*25`).
140 + - `wifi.enabled` (bool).
141 + - IPC fn signatures unchanged: `stateJson()`, `scan()`, `select(id)`,
142 + `toggleWifi(enabled)`, `forget(id)`, `checkConnectivity()`. `select(id)`
143 + stays the by-id entry (connects known/open). Add a richer
144 + `connect(ssid, passphrase)` for the view's secured-connect flow
145 + (in-process only; not an IPC handler).
129 147 ### Security (HARD — written normal, not caveman)