docs: file interface design references

Record the reconciled weather work and future component direction.\nFile the clock and retro-interface reference materials for later design work.

1 files changed, 69 insertions, 0 deletions

diff --git a/todo.org b/todo.org
index 1ac2e76..b4b1509 100644
--- a/todo.org
+++ b/todo.org
@@ -74,6 +74,8 @@ Date and time are separate fixed-position controls. The time display cycles its
 own formats, including UTC; the date/calendar control cycles date-only formats
 and never displays a second time. Implement the dedicated format rings,
 tooltip behavior, and tests together in the dotfiles Waybar configuration.
+Reference material for the compact clock/chronograph treatment is filed in
+[[file:working/clock-display-references/][working/clock-display-references/]].
 
 *** 2026-07-19 Sun @ 04:36:26 -0500 Folded clock-panel interaction direction
 The clock-panel handoff settled the prior open question: UTC belongs only to
@@ -85,6 +87,54 @@ Reduce notification-sound playback loudness by 40% (0.6 gain, approximately
 -4.4 dB). Change the =NOTIFY_VOLUME= playback control rather than re-encoding
 the normalized sound files; verify each notification type still plays clearly.
 
+** TODO [#B] Assess a Hyprland left-drag window gesture :feature:hyprland:
+Evaluate whether a global left-click drag can move ordinary windows without
+breaking application selection, text interaction, or Wayland security
+expectations. Document the safe modifier/gesture alternatives before changing
+any binding.
+
+** TODO [#C] Add a time selector to the timer panel :feature:timer:
+Offer a period-appropriate selector for timer duration, likely drawing on the
+tape-counter idiom, while preserving the existing direct-entry path.
+
+** TODO [#C] Show the active wired interface in the Waybar network module :feature:waybar:network:
+When Ethernet is active, replace the offline-WiFi presentation with the wired
+interface glyph and interface name.
+
+** TODO [#C] Order network-panel connections by availability :feature:network:
+Present saved and currently available networks in this order: available saved
+profiles, available unsaved networks, then saved profiles that are unavailable.
+
+** TODO [#C] Let the clock panel dismiss itself on click :feature:clock:waybar:
+Make a left click inside the open clock panel toggle it closed; the Waybar time
+module remains the explicit way to reopen it.
+
+** TODO [#C] Indicate hotspot or metered WiFi in amber :feature:network:waybar:
+Detect hotspot/metered connectivity and render the WiFi icon plus SSID amber,
+while ordinary WiFi stays white.
+
+** TODO [#C] Make the WiFi toggle connect the best available profile :feature:network:
+When enabling WiFi, automatically connect to the highest-priority available
+saved network instead of requiring a panel selection first.
+
+** TODO [#B] Reconcile panel keybindings around Super+N :feature:hyprland:
+Swap the notification and networking bindings so primary panels are one
+Super-plus-letter chord away, audit the other exceptions, and bring the
+proposed family to Craig for a final mapping decision.
+
+** TODO [#B] Add storage-capacity signals to the maintenance module :feature:maint:
+Investigate capacity and growth diagnostics for full disks, identify the
+appropriate remedies, and incorporate a clear storage signal into the
+maintenance console.
+
+** TODO [#B] Add per-channel controls to the audio panel :feature:audio:
+Expose channel-level input and output volume controls without losing the
+existing device-level workflow.
+
+** TODO [#C] Add a whole-display dim mode :feature:hyprland:
+Extend auto-dim with an explicit “dim everything” setting for bright
+non-dark-mode contexts, with a security/usability review of its scope.
+
 ** DOING [#B] Widget gallery upgrades :feature:design:
 :PROPERTIES:
 :LAST_REVIEWED: 2026-07-13
@@ -254,6 +304,25 @@ The cross's cell assignments were read off card names and spec sheets, not audit
 The panel widget gallery ([[file:docs/prototypes/panel-widget-gallery.html][docs/prototypes/panel-widget-gallery.html]]) grows into a retro-instrument component catalogue: reference photos of period hardware → gallery cards (the visual + behavioral spec) → reusable components for three targets (emacs svg.el, web/React, waybar). Tokens single-sourced in [[file:docs/prototypes/tokens.json][tokens.json]] (gen_tokens.py emits web/waybar/elisp); svg.el proof widget shipped (gallery-widget.el, needle gauge). Reference photos live in [[file:working/retro-stereo-widgets/][working/retro-stereo-widgets/]]. Collection converged at R56, then reopened at R57 as the taxonomy found empty cells (110 cards, all behaviorally verified; probes in [[file:tests/gallery-probes/][tests/gallery-probes/]]).
 
 Build runs per the [[file:docs/specs/2026-07-12-component-generation-spec.org][component-generation spec]] (DOING; reviewed + decomposed 2026-07-12): web extraction first (ungated, lossless), then demand-gated Emacs/waybar ports. Banked variant/composition ledger lives in the 2026-07-11/12 session archive.
+*** TODO [#B] Rebuild the magic-eye tube component :feature:design:
+Reinstate the magic-eye tuning/level indicator (EM34/EM84/6E5 family), but
+replace the earlier weak UI rather than reviving it unchanged. The component
+must read as a real glass tube: P1-green phosphor bloom, a smooth shadow-angle
+response, and a clearly different tuning-minimum / record-level interaction.
+Build it to the current extraction-readiness bar with probes and a visual
+comparison before proposing ports. Reference: [[https://en.wikipedia.org/wiki/File:Em11-ani.gif][EM11 animation]].
+*** TODO [#B] Add a wind-direction rose component :feature:weather:design:
+Bank the weather companion from the Home handoff: a 16-point meteorological
+wind rose that reads source direction and optional speed, distinct from the
+aviation heading selector. Revisit when the weather surface needs more than
+the compact vane/speed slot; no implementation before that demand exists.
+*** 2026-07-19 Sun @ 15:40:01 -0500 Filed component and hardware references
+Inbox zero filed the clock/chronograph concepts in
+[[file:working/clock-display-references/][working/clock-display-references/]]
+and the knob, split-flap, and display references in the existing
+[[file:working/retro-stereo-widgets/references/][widget references]]. The Home
+component handoff was reconciled: Craig reinstated the magic eye subject to a
+better tube UI; the wind rose is banked for a future richer weather surface.
 *** DOING [#B] Weather kit integration :feature:weather:dotfiles:
 [[file:working/weather-kit-integration/][Working package]] received from Home on 2026-07-18. Land the shared, dependency-free =weather= CLI in dotfiles first, with cache/location/rendering tests; then wire a compact Dupre Waybar surface and port the supplied chip renderer to svg.el when its placement and interaction contract are settled. The chip itself remains current-conditions-only. Its hover exposes the next six hours; clicking it toggles a separate five-day forecast panel with each day's high/low and sunny/rainy condition. No coordinates ship in the repository: machines configure =$WEATHER_LAT=/$WEATHER_LON= or =~/.config/weather/config.json= (with =--geo= for travellers).