[m4milaad]

Device / context

This completes the shell side of two driver hints that MouseUiHints already declares but the app has never rendered:

• statusNote?: string - "Extra sentence appended to the connected status line, for drivers whose connection is deliberately limited (e.g. why settings are unavailable)."
• forceShowBattery?: boolean - "Always show battery column (even wired with null %)."

Field devices that set both exist today: the Endgame Gear OP1 V2 wired fixtures set forceShowBattery with batteryPercent: null (currently ignored), and the new Cosmic Byte Kilonova 3335IC driver in OpenMouse-Project/mouse-protocol#249 reports settingsReady: false with a statusNote explaining the read-only treatment, because its receiver's settings bank is not decoded yet. With the current shell, that device's page renders the hero and nothing else - no explanation for the empty tabs, no battery column - so it reads like the driver is broken rather than deliberate.

What the change does

• The hero's connected status line appends status.ui.statusNote after connection detail (same line the driver contract describes).
• forceShowBattery === true keeps the battery in the hero stats and the current-setup figures when the percent is unknown, shown as – (the established unknown-value marker), instead of absent. BatteryIcon already renders an unknown state for percent: null, so no icon change is needed.
• Adds a ?preview=kilonova fixture mirroring the Kilonova's browser status, so the composition is visible in dev without the hardware.

Scope notes

• No styles, no i18n keys: both rendered strings are driver-authored dynamic data (the pollingNote precedent), and the rendered "–" reuses existing classes.
• Wired devices whose battery percent stays null gain the same forced column; fixtures for those already set the hint.
• npm run build, npm test and npm run size pass; JS bundle within budget.

Related

• Device driver: feat(sinowealth): support the Cosmic Byte Kilonova 3335IC through its receiver mouse-protocol#249 (the page renders controls for the Kilonova only after its bank is decoded; this PR makes the interim state explain itself).

Note

Add driver status note and unknown-battery display for device preview

• Renders the optional status.ui.statusNote in the device hero metadata line in DeviceHero.tsx
• Shows an unknown-battery stat (battery icon with an en dash) when status.ui.forceShowBattery is true but batteryPercent is null, in both DeviceStats.tsx and the setup panel
• Adds a kilonova preview fixture and preview mode for the Cosmic Byte Kilonova 3335IC, showing an unconfigured wireless device with a note about OpenMouse Bridge
• Bumps @openmouse/protocol from 0.45.2 to 0.46.0

^{Macroscope summarized 2947833. (Automatic summaries will resume when PR exits draft mode or review begins).}

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

_{Comment @coderabbitai help to get the list of available commands.}