From c6db987140384d31daae105266c4cf0921b9372c Mon Sep 17 00:00:00 2001
From: ydw1904 <ydw25@mails.tsinghua.edu.cn>
Date: Sat, 5 Sep 2026 11:14:22 +0800
Subject: [PATCH 1/2] wlmouse: show high-speed, turbo, angle tune, and button
 combinations

The driver now reads four per-profile sensor settings from WLmouse mice, so
the Processing card can offer them. Three are switches beside the ones already
there; angle tune reuses the same -30..+30 select Pulsar Pro has, shown for
any mouse that reports the field and left in the Pro card for Pulsar so it is
not offered twice.

Turbo is greyed out while high-speed mode is off, which is the firmware's own
rule: it will not hold turbo on without it. The shared hyper-mode switch reads
"High-speed mode" for WLMouse, the name their own tool uses, and stays "Hyper
mode" elsewhere.

Artwork resolves by name for WLmouse now. The shared 1K receiver enumerates
under one product id whatever mouse is on it, so keying art by product id
could never work for those; the driver reads the paired model and the name
fallbacks pick up the render.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 src/app/cards/AdvancedCards.tsx | 37 ++++++++++++++++++++++++++++++++-
 src/app/cards/availability.ts   |  3 +++
 src/device/controller.ts        | 24 +++++++++++++++++++++
 src/device/types.ts             |  4 +++-
 src/preview-fixtures.ts         |  4 ++++
 src/ui/device-images.test.ts    |  8 +++++++
 src/ui/device-images.ts         |  5 +++++
 7 files changed, 83 insertions(+), 2 deletions(-)

diff --git a/src/app/cards/AdvancedCards.tsx b/src/app/cards/AdvancedCards.tsx
index 13862fda..ce08e395 100644
--- a/src/app/cards/AdvancedCards.tsx
+++ b/src/app/cards/AdvancedCards.tsx
@@ -20,6 +20,7 @@ import {
 import { teevolutionSensorModeUi } from "@openmouse/protocol/teevolution";
 import * as control from "../../device/controller";
 import { PULSAR_SLEEP_OPTIONS } from "../../device/controller";
+import { isPulsarProProtocol } from "../../device/traits";
 import { selectableValues, sleepLabel, sleepParts, sleepTotalSeconds, KEYCHRON_SLEEP_MAX_HOURS, KEYCHRON_SLEEP_MAX_SECONDS, KEYCHRON_SLEEP_MIN_SECONDS } from "../../device/options";
 import type { ControlSnapshot } from "../../device/types";
 import { Collapsible, Segmented, SwitchRow } from "../ui";
@@ -264,6 +265,11 @@ export function ProcessingCard({ snapshot }: { snapshot: ControlSnapshot }): Rea
     ? "Competitive mode"
     : status.brand === "Teevolution" ? "Highest performance" : "Performance mode";
 
+  // WLMouse calls the same sensor setting High-speed mode in its own tool.
+  const hyperLabel = status.brand === "WLMouse" ? "High-speed mode" : "Hyper mode";
+  // Pulsar Pro shows the angle with the rest of its Pro-only settings.
+  const angleTuning = isPulsarProProtocol(status) ? null : status.angleTuning;
+
   return (
     <article id="processing-settings" className="setting-card">
       <div className="setting-heading compact"><div><p>SENSOR</p><h2>Processing</h2></div></div>
@@ -322,11 +328,40 @@ export function ProcessingCard({ snapshot }: { snapshot: ControlSnapshot }): Rea
       />
       <SwitchRow
         id="hyper-mode-toggle"
-        label="Hyper mode"
+        label={hyperLabel}
         value={status.hyperMode}
         hidden={status.hyperMode == null}
         onChange={(next) => control.applyPulsarToggle("hyperMode", next)}
       />
+      <SwitchRow
+        id="turbo-mode-toggle"
+        label="Turbo mode"
+        value={status.turboMode}
+        hidden={status.turboMode == null}
+        disabled={status.hyperMode === false}
+        onChange={(next) => control.applyPulsarToggle("turboMode", next)}
+      />
+      <SwitchRow
+        id="button-combination-toggle"
+        label="Button combinations"
+        value={status.buttonCombination}
+        hidden={status.buttonCombination == null}
+        onChange={(next) => control.applyPulsarToggle("buttonCombination", next)}
+      />
+      {angleTuning != null ? (
+        <label className="field-label spaced">
+          Angle tune
+          <select
+            id="angle-tune-select"
+            value={angleTuning}
+            onChange={(event) => control.applyAngleTuning(Number(event.currentTarget.value))}
+          >
+            {Array.from({ length: 61 }, (_, index) => index - 30).map((angle) => (
+              <option key={angle} value={angle}>{angle}°</option>
+            ))}
+          </select>
+        </label>
+      ) : null}
 
       {traits.teevolution && teevolutionProfile ? (
         <label id="teevolution-performance-duration-row" className="field-label spaced">
diff --git a/src/app/cards/availability.ts b/src/app/cards/availability.ts
index 1ad7d989..98188ac8 100644
--- a/src/app/cards/availability.ts
+++ b/src/app/cards/availability.ts
@@ -82,6 +82,9 @@ export function cardAvailability(snapshot: ControlSnapshot): CardAvailability {
     || (status.rippleControl != null && ui?.hideRippleControl !== true)
     || (status.performanceMode != null && !traits.eggFamily && !traits.finalmouse)
     || status.hyperMode != null
+    || status.turboMode != null
+    || status.buttonCombination != null
+    || status.angleTuning != null
     || status.sensorMode != null || status.performanceDuration != null
   );
 
diff --git a/src/device/controller.ts b/src/device/controller.ts
index 62ec1854..7869ceaf 100644
--- a/src/device/controller.ts
+++ b/src/device/controller.ts
@@ -2965,6 +2965,8 @@ function settingLabel(setting: PulsarToggleSetting): string {
     rippleControl: "ripple control",
     performanceMode: teevolutionClient() ? "highest performance" : "performance mode",
     hyperMode: "Hyper mode",
+    turboMode: "turbo mode",
+    buttonCombination: "button combinations",
   } as const)[setting];
 }
 
@@ -2974,6 +2976,8 @@ const PULSAR_TOGGLE_METHOD: Record<PulsarToggleSetting, string> = {
   rippleControl: "setRippleControl",
   performanceMode: "setPerformanceMode",
   hyperMode: "setHyperMode",
+  turboMode: "setTurboMode",
+  buttonCombination: "setButtonCombination",
 };
 
 export function applyPulsarToggle(setting: PulsarToggleSetting, enabled: boolean): void {
@@ -2992,6 +2996,26 @@ export function applyPulsarToggle(setting: PulsarToggleSetting, enabled: boolean
   });
 }
 
+/**
+ * Sensor angle in degrees. Pulsar Pro reaches the same setting through
+ * `applyProSetting`, which also carries settings only that protocol has.
+ */
+export function applyAngleTuning(degrees: number): void {
+  if (!hasActiveClient()) return;
+  stageChange({
+    key: "angle-tuning",
+    label: `Angle tune ${degrees}°`,
+    command: `Set the sensor angle to ${degrees}°`,
+    progress: `Setting the sensor angle to ${degrees}°…`,
+    preview: (status) => {
+      status.angleTuning = degrees;
+    },
+    apply: async () => {
+      await requireClientMethod("setAngleTuning", "angle tuning").setAngleTuning(degrees);
+    },
+  });
+}
+
 export function applyPulsarValue(setting: "debounce" | "sleep", value: number): void {
   if (!(pulsarClient() ?? dmClient() ?? orbitalClient() ?? razerClient()
     ?? viperClient() ?? teevolutionClient() ?? vgnClient() ?? keychronNapeClient() ?? wallhackMouseClient())) return;
diff --git a/src/device/types.ts b/src/device/types.ts
index 78547497..5189ac0d 100644
--- a/src/device/types.ts
+++ b/src/device/types.ts
@@ -23,7 +23,9 @@ export type PulsarToggleSetting =
   | "angleSnapping"
   | "rippleControl"
   | "performanceMode"
-  | "hyperMode";
+  | "hyperMode"
+  | "turboMode"
+  | "buttonCombination";
 
 export interface TeevolutionProfile {
   sleepOptions: readonly number[];
diff --git a/src/preview-fixtures.ts b/src/preview-fixtures.ts
index c7cf1b13..9bc2b894 100644
--- a/src/preview-fixtures.ts
+++ b/src/preview-fixtures.ts
@@ -148,6 +148,10 @@ const WLMOUSE: MouseStatus = {
   liftOffDistance: "Low",
   connectionType: "Wireless",
   motionSync: true,
+  hyperMode: true,
+  turboMode: false,
+  buttonCombination: true,
+  angleTuning: -8,
   debounceMs: 2,
   sleepTimeout: 60,
   firmware: ["0.9.2"],
diff --git a/src/ui/device-images.test.ts b/src/ui/device-images.test.ts
index 4ce8535f..a26739b0 100644
--- a/src/ui/device-images.test.ts
+++ b/src/ui/device-images.test.ts
@@ -200,3 +200,11 @@ test("test-needed and unsupported models are not given new artwork", () => {
   assert.equal(deviceImage(null, "VGN Dragonfly R1 Pro"), CDN + "unknown-device.png");
   assert.equal(deviceImage(null, "Razer Viper 8KHz"), CDN + "unknown-device.png");
 });
+
+test("a mouse behind a shared WLMouse receiver resolves by name", () => {
+  // 0xa882 is the 1K receiver's own id; the model comes from the driver's name.
+  const receiver = { vendorId: 0x36a7, productId: 0xa882 } as HIDDevice;
+  assert.equal(deviceImage(receiver, "WLmouse Beast Max"), CDN + "wlmouse-beast-max.png");
+  assert.equal(deviceImage(receiver, "WLmouse Beast G"), CDN + "wlmouse-beast-g.png");
+  assert.equal(deviceImage(receiver, "WLmouse Beast Mini"), CDN + "unknown-device.png");
+});
diff --git a/src/ui/device-images.ts b/src/ui/device-images.ts
index fba11c1f..e5bd76b2 100644
--- a/src/ui/device-images.ts
+++ b/src/ui/device-images.ts
@@ -177,6 +177,11 @@ function resolveDeviceImageFilename(device: HIDDevice | null | undefined, displa
   if (/\bviper\s*v4\b/i.test(displayName)) return "razer-viper-v4-pro.png";
   if (/\bxm2\s*8k\b/i.test(displayName)) return "endgame-gear-xm2-8k.png";
   if (/\bxm2w\b/i.test(displayName)) return "endgame-gear-xm2w.png";
+  // WLMouse receivers are shared across models — the 1K dongle enumerates under
+  // one product id whatever it is paired with — so the model only arrives in the
+  // name the driver reads back from the mouse.
+  if (/\bbeast\s*max\b/i.test(displayName)) return "wlmouse-beast-max.png";
+  if (/\bbeast\s*g\b/i.test(displayName)) return "wlmouse-beast-g.png";
   if (/\bbeast\s*x\s*pro\b/i.test(displayName)) return "unknown-device.png";
   if (/\bbeast\s*mini\b/i.test(displayName)) return "unknown-device.png";
   if (/\bbeast\s*x\b/i.test(displayName)) return "unknown-device.png";

From f05af1c243fd8f933cefb63d807f00da54a7e575 Mon Sep 17 00:00:00 2001
From: ydw1904 <david@schindler.tv>
Date: Sat, 5 Sep 2026 10:42:37 +0800
Subject: [PATCH 2/2] preview: give the WLMouse fixture its DPI stage table
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The driver now reports `dpiStages` and the `dpiStageEditor` hint, so the
preview should show the stage list too — otherwise the one fixture for
this family renders a card the real mouse no longer matches.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 src/preview-fixtures.ts | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/preview-fixtures.ts b/src/preview-fixtures.ts
index 9bc2b894..802571cd 100644
--- a/src/preview-fixtures.ts
+++ b/src/preview-fixtures.ts
@@ -136,11 +136,18 @@ const EGG_XM2WE: MouseStatus = {
 const WLMOUSE: MouseStatus = {
   brand: "WLMouse",
   name: "BEAST X",
-  ui: { family: "wlmouse", hideUnsupportedPollingRates: true, forceShowBattery: true },
+  ui: {
+    family: "wlmouse",
+    hideUnsupportedPollingRates: true,
+    forceShowBattery: true,
+    dpiStageEditor: { maxStages: 6, countEditable: true, minDpi: 50, maxDpi: 30000, stepDpi: 50 },
+  },
   batteryPercent: 91,
   batteryState: "Charging",
   dpi: 800,
   dpiY: 800,
+  dpiStages: [400, 800, 1600, 3200],
+  activeDpiStage: 1,
   supportsSeparateDpiAxes: true,
   pollingRateHz: 8000,
   supportedPollingRates: [125, 250, 500, 1000, 2000, 4000, 8000],