@openmouse/protocol 0.1.0

package/dist/mchose/index.js

@@ -0,0 +1,429 @@
+/**
+ * Pure MCHOSE codecs, unit-tested without WebHID.
+ *
+ * Reverse-engineered from MCHOSE's own M HUB web driver and verified against an
+ * A7 V2 Ultra+ on its 2.4 GHz receiver; see docs/mchose-protocol.md for the
+ * capture notes and the dead ends.
+ *
+ * Transport: feature reports on the `0xff01` vendor collection. Report `0x11`
+ * carries the short (20-byte) command set, report `0x12` the long (64-byte)
+ * one. The distinguishing quirk is that **the whole command body is sent
+ * bit-inverted, and replies come back inverted too**:
+ *
+ *   sendFeatureReport(0x11, [~cmd, ~arg0, …])
+ *   receiveFeatureReport(0x11) -> [reportId, ~cmd, ~payload0, …]
+ *
+ * Only the bytes the vendor actually spells out are inverted; the rest of the
+ * report is zero-padded, which is why replies carry unrelated trailing bytes —
+ * the firmware leaves stale scratch data past the meaningful fields.
+ */
+export const MCHOSE_VENDOR_ID = 0x3837;
+/** Vendor configuration collection. */
+export const MCHOSE_CONFIG_USAGE_PAGE = 0xff01;
+export const MCHOSE_CONFIG_USAGE = 0x0001;
+/** Short command channel: command + 19 argument bytes. */
+export const MCHOSE_SHORT_REPORT_ID = 0x11;
+export const MCHOSE_SHORT_TOKENS = 20;
+/** Long command channel: command + 63 argument bytes. */
+export const MCHOSE_LONG_REPORT_ID = 0x12;
+export const MCHOSE_LONG_TOKENS = 64;
+export const MCHOSE_REPORT_LENGTH = 64;
+export const MCHOSE_COMMAND = {
+    /** Receiver identity: bond flag, ids, link state. */
+    identity: 0x03,
+    /** Firmware version, as a length-prefixed ASCII string. */
+    version: 0x04,
+    /** Mouse identity plus battery level and charge state. */
+    battery: 0x06,
+    /** Whole configuration blob: DPI stages, per-link indices, debounce, sleep. */
+    config: 0x67,
+    /** Writes the same blob back, one command byte in front of the same layout. */
+    writeConfig: 0x57,
+    /** Switches the active onboard profile; takes a single 0-based index. */
+    setProfile: 0x58,
+    /** Reassigns one button: `[buttonIndex, reserved, type, value u24 BE]`. */
+    setButton: 0x52,
+    /** Reads one button's name, which is where a macro's name lives. */
+    readButtonName: 0x63,
+    /** Reads one profile's name: `[index]`, replying index + ASCII. */
+    readProfileName: 0x68,
+    /** Sets the auto-sleep timer: `[enabled, minutes]`. */
+    setSleep: 0x0a,
+    /**
+     * Performance block: `[lod, ripple, line, motionSync, _, _, mode,
+     * rotateOpen, rotateVal]`.
+     */
+    setPerformance: 0x42,
+};
+/**
+ * The config blob's `sensor` byte (offset 17) is a bitfield holding lift-off
+ * distance *and* the three processing toggles. Every one of these is written
+ * through the performance command rather than the config write, and read back
+ * out of this byte. Mapped bit by bit on hardware:
+ *
+ *   0x80 -> 0x90  motion sync on        (bit 4)
+ *   0x90 -> 0x94  ripple control on     (bit 2)
+ *   0x94 -> 0x9c  linear correction on  (bit 3)
+ *
+ * Bits 6-7 are the performance mode — see `MCHOSE_SENSOR_MODE_MASK` below. An
+ * earlier reading of this byte took bit 7 alone to be a boolean "game mode",
+ * which is wrong: M HUB offers three modes, and bit 6 is the other half.
+ *
+ * Lift-off therefore occupies only **bits 0-1**; treating it as three bits
+ * would read ripple as part of the level. Bit 5 is still unexplained, so
+ * writers must preserve the rest of the byte rather than assign it.
+ */
+export const MCHOSE_LOD_MASK = 0x03;
+export const MCHOSE_SENSOR_RIPPLE = 0x04;
+export const MCHOSE_SENSOR_LINEAR = 0x08;
+export const MCHOSE_SENSOR_MOTION_SYNC = 0x10;
+/**
+ * Bits 6-7 hold the **performance mode**, which M HUB presents as a three-way
+ * choice rather than a switch. Mapped on hardware by writing each value:
+ *
+ *   field 7 = 1 -> bits 00 -> Performance
+ *   field 7 = 2 -> bits 10 -> eSports
+ *   field 7 = 3 -> bits 11 -> Ultra
+ *
+ * Note the gap: the stored bit pattern is the mode number except for
+ * Performance, which stores 0 rather than 1.
+ */
+export const MCHOSE_SENSOR_MODE_MASK = 0xc0;
+export const MCHOSE_MODES = ["Performance", "eSports", "Ultra"];
+/** Decode bits 6-7 into a 1-based mode number. */
+export function mchoseDecodeMode(sensor) {
+    const stored = (sensor & MCHOSE_SENSOR_MODE_MASK) >> 6;
+    return stored === 0 ? 1 : stored;
+}
+export function mchoseModeName(sensor) {
+    return MCHOSE_MODES[mchoseDecodeMode(sensor) - 1] ?? MCHOSE_MODES[0];
+}
+export function mchoseModeNumber(name) {
+    const index = MCHOSE_MODES.indexOf(name);
+    return index < 0 ? null : index + 1;
+}
+/**
+ * Angle tuning, in the config blob at offset 49. M HUB offers -30 to +30
+ * degrees; the byte is stored as-is, so negatives are two's complement. The
+ * firmware does not validate the value — it stored 0xf1 and 0x8f unchanged —
+ * so the range has to be enforced here.
+ *
+ * M HUB flags this control with "update the mouse firmware", so older firmware
+ * may ignore it.
+ */
+export const MCHOSE_ANGLE_TUNING_OFFSET = 49;
+export const MCHOSE_ANGLE_TUNING_MIN = -30;
+export const MCHOSE_ANGLE_TUNING_MAX = 30;
+export function mchoseDecodeAngleTuning(raw) {
+    const byte = raw & 0xff;
+    return byte > 0x7f ? byte - 0x100 : byte;
+}
+export function mchoseEncodeAngleTuning(degrees) {
+    return degrees < 0 ? (degrees + 0x100) & 0xff : degrees & 0xff;
+}
+export function mchoseDecodeLiftOffIndex(sensor) {
+    return sensor & MCHOSE_LOD_MASK;
+}
+export function mchoseDecodeProcessing(sensor) {
+    return {
+        angleSnapping: (sensor & MCHOSE_SENSOR_LINEAR) !== 0,
+        rippleControl: (sensor & MCHOSE_SENSOR_RIPPLE) !== 0,
+        motionSync: (sensor & MCHOSE_SENSOR_MOTION_SYNC) !== 0,
+    };
+}
+/**
+ * Ripple, linear correction and motion sync use 1 = on and 2 = off, with 0
+ * meaning "leave this one alone".
+ */
+const toggle = (value) => value === undefined ? 0 : value ? 1 : 2;
+/**
+ * Build the performance write.
+ *
+ * Lift-off must be supplied every time, because index 0 is a real level and so
+ * cannot double as "unchanged" the way the toggles' 0 does. Pass only the
+ * toggles being changed and the rest are left as they are.
+ */
+export function mchoseEncodePerformance(liftOffIndex, changes = {}) {
+    if (!Number.isInteger(liftOffIndex) || liftOffIndex < 0 || liftOffIndex > MCHOSE_LOD_MASK) {
+        throw new Error(`Lift-off index must be 0-${MCHOSE_LOD_MASK}.`);
+    }
+    const tuning = changes.angleTuning;
+    if (tuning !== undefined
+        && (!Number.isInteger(tuning) || tuning < MCHOSE_ANGLE_TUNING_MIN || tuning > MCHOSE_ANGLE_TUNING_MAX)) {
+        throw new Error(`Angle tuning must be ${MCHOSE_ANGLE_TUNING_MIN} to ${MCHOSE_ANGLE_TUNING_MAX} degrees.`);
+    }
+    const mode = changes.mode;
+    if (mode !== undefined && (!Number.isInteger(mode) || mode < 1 || mode > MCHOSE_MODES.length)) {
+        throw new Error(`Mode must be 1-${MCHOSE_MODES.length}.`);
+    }
+    // [command, lod, ripple, line, motionSync, _, _, mode, rotateOpen, rotateVal]
+    return [
+        MCHOSE_COMMAND.setPerformance,
+        liftOffIndex,
+        toggle(changes.rippleControl),
+        toggle(changes.angleSnapping),
+        toggle(changes.motionSync),
+        0,
+        0,
+        mode ?? 0,
+        tuning === undefined ? 0 : 1,
+        tuning === undefined ? 0 : mchoseEncodeAngleTuning(tuning),
+    ];
+}
+/** Lift-off on its own, leaving every processing toggle untouched. */
+export function mchoseEncodeLiftOff(index) {
+    return mchoseEncodePerformance(index);
+}
+export function mchoseLiftOffLabels(steps) {
+    if (steps >= 3)
+        return ["Low", "Medium", "High"];
+    if (steps === 2)
+        return ["Low", "High"];
+    return ["Low"];
+}
+/**
+ * Auto-sleep is stored in whole minutes at offset 19 of the config blob, and
+ * written with its own command rather than through the config write. Confirmed
+ * on hardware: sending `0x0a 01 09` moved that byte from 0 to 9.
+ *
+ * The device is slower to apply this than a config write — it needs roughly a
+ * second before the new value reads back.
+ */
+export const MCHOSE_SLEEP_MAX_MINUTES = 0xff;
+/** Sleep timeouts offered in the UI, in seconds; 0 disables the timer. */
+export const MCHOSE_SLEEP_OPTIONS = [0, 60, 120, 180, 300, 600, 1800];
+/** Longest debounce the firmware accepts, in milliseconds. */
+export const MCHOSE_DEBOUNCE_MAX_MS = 20;
+export function mchoseEncodeSleep(minutes) {
+    if (!Number.isInteger(minutes) || minutes < 0 || minutes > MCHOSE_SLEEP_MAX_MINUTES) {
+        throw new Error(`Sleep must be 0-${MCHOSE_SLEEP_MAX_MINUTES} minutes.`);
+    }
+    // The vendor pairs a "sleep enabled" flag with the value; 0 minutes is off.
+    return [MCHOSE_COMMAND.setSleep, minutes > 0 ? 1 : 0, minutes];
+}
+/**
+ * Onboard profiles, 0-based on the wire. The mouse holds three, each with its
+ * own DPI stage table and its own per-link rate/stage pair — confirmed by
+ * switching an A7 V2 Ultra+ through all three and reading each back.
+ *
+ * `0x67` has no profile argument: it always answers for whichever profile is
+ * active, so reading another one means switching to it first.
+ */
+export const MCHOSE_PROFILE_COUNT = 3;
+/** Build the `0x58` payload. `index` is 0-based, as the firmware expects. */
+export function mchoseEncodeSetProfile(index) {
+    if (!Number.isInteger(index) || index < 0 || index >= MCHOSE_PROFILE_COUNT) {
+        throw new Error(`MCHOSE profile index must be 0-${MCHOSE_PROFILE_COUNT - 1}.`);
+    }
+    return [MCHOSE_COMMAND.setProfile, index];
+}
+/**
+ * Build a feature-report body. `tokens` is the command byte followed by its
+ * arguments, exactly as the vendor spells them; everything given is inverted
+ * and the remainder of the report stays zero.
+ */
+export function mchoseEncodeCommand(tokens, tokenCount) {
+    const body = new Uint8Array(MCHOSE_REPORT_LENGTH);
+    const spelled = Math.min(tokenCount, MCHOSE_REPORT_LENGTH);
+    for (let index = 0; index < spelled; index += 1) {
+        body[index] = ((tokens[index] ?? 0) ^ 0xff) & 0xff;
+    }
+    return body;
+}
+/**
+ * Decode a feature-report read. `raw` is the buffer as returned by
+ * `receiveFeatureReport`, whose first byte is the report id.
+ */
+export function mchoseDecodeReply(raw) {
+    if (raw.length < 3)
+        return null;
+    const payload = new Uint8Array(raw.length - 2);
+    for (let index = 0; index < payload.length; index += 1) {
+        payload[index] = ((raw[index + 2] ?? 0) ^ 0xff) & 0xff;
+    }
+    return { command: (~(raw[1] ?? 0)) & 0xff, payload };
+}
+const u16 = (data, offset) => (data[offset] ?? 0) | ((data[offset + 1] ?? 0) << 8);
+export function mchoseDecodeIdentity(payload) {
+    if (payload.length < 7)
+        return null;
+    return {
+        bonded: (payload[0] ?? 0) !== 0,
+        vendorId: u16(payload, 1),
+        productId: u16(payload, 3),
+        connected: (payload[5] ?? 0) !== 0,
+        gameMode: payload[6] ?? 0,
+    };
+}
+// ── 0x11 0x04 firmware version ─────────────────────────────────────────────
+/** Length-prefixed ASCII, e.g. `08 "5.46.2.4"`. */
+export function mchoseDecodeVersion(payload) {
+    const length = payload[0] ?? 0;
+    if (!length || payload.length < 1 + length)
+        return null;
+    return String.fromCharCode(...payload.subarray(1, 1 + length));
+}
+export function mchoseDecodeBattery(payload) {
+    if (payload.length < 11)
+        return null;
+    // Bit fields are packed most-significant first: 3 bits mode, 1 bit status.
+    const flags = payload[8] ?? 0;
+    return {
+        vendorId: u16(payload, 0),
+        productId: u16(payload, 2),
+        firmwareVersion: u16(payload, 4) | (u16(payload, 6) << 16),
+        connectMode: (flags >> 5) & 0x07,
+        connected: ((flags >> 4) & 0x01) !== 0,
+        batteryPercent: payload[9] ?? 0,
+        charging: (payload[10] ?? 0) !== 0,
+    };
+}
+// ── 0x12 0x67 configuration ────────────────────────────────────────────────
+export const MCHOSE_DPI_STAGES = 6;
+/**
+ * Note the reserved byte at offset 3: the DPI stages start at offset 4, not
+ * immediately after the two index bytes.
+ *
+ * MCHOSE ships two schemas for this payload and they contradict each other.
+ * The layout below is the one the hardware actually uses, confirmed on an
+ * A7 V2 Ultra+ by reading it at two known settings:
+ *
+ *   125 Hz / 1600 DPI -> byte2 0x00   (rate index 0, stage 0)
+ *   1000 Hz / 1600 DPI -> byte2 0x20  (rate index 2, stage 0)
+ *
+ * So the **wired** byte comes first, the **rate** is the high nibble, and the
+ * rate is a plain index into the model's rate list with no skipped value. That
+ * matches the vendor's write schema; its read schema has both the byte order
+ * and the nibble order backwards. Do not "correct" this to match the latter.
+ */
+export function mchoseDecodeConfig(payload) {
+    if (payload.length < 4 + MCHOSE_DPI_STAGES * 2)
+        return null;
+    const wired = payload[1] ?? 0;
+    const wireless = payload[2] ?? 0;
+    const dpiStages = [];
+    for (let stage = 0; stage < MCHOSE_DPI_STAGES; stage += 1) {
+        dpiStages.push(u16(payload, 4 + stage * 2));
+    }
+    return {
+        profileIndex: payload[0] ?? 0,
+        wirelessDpiIndex: wireless & 0x0f,
+        wirelessRateIndex: (wireless >> 4) & 0x0f,
+        wiredDpiIndex: wired & 0x0f,
+        wiredRateIndex: (wired >> 4) & 0x0f,
+        dpiStages,
+        stageCount: payload[16] ?? 0,
+        sensor: payload[17] ?? 0,
+        liftOffIndex: mchoseDecodeLiftOffIndex(payload[17] ?? 0),
+        processing: mchoseDecodeProcessing(payload[17] ?? 0),
+        keyDebounce: payload[18] ?? 0,
+        sleep: payload[19] ?? 0,
+        angleTuning: mchoseDecodeAngleTuning(payload[MCHOSE_ANGLE_TUNING_OFFSET] ?? 0),
+        mode: mchoseModeName(payload[17] ?? 0),
+    };
+}
+/** Pack a link's rate/stage pair back into its byte: rate high, stage low. */
+export function mchosePackLinkByte(rateIndex, dpiIndex) {
+    return (((rateIndex & 0x0f) << 4) | (dpiIndex & 0x0f)) & 0xff;
+}
+/**
+ * Build the `0x57` write payload from a payload previously read with `0x67`.
+ *
+ * The write layout is exactly the read layout with a command byte in front, so
+ * a change is applied by echoing every other byte back untouched — which is
+ * what keeps button mappings, macros and DPI values from being wiped by a
+ * partial write.
+ */
+export function mchoseEncodeConfigWrite(readPayload, changes = {}) {
+    const current = mchoseDecodeConfig(readPayload);
+    if (!current)
+        throw new Error("mchoseEncodeConfigWrite needs a decodable 0x67 payload");
+    const out = [MCHOSE_COMMAND.writeConfig, ...readPayload];
+    // +1 throughout: the command byte shifts every field by one.
+    out[1 + 1] = mchosePackLinkByte(changes.wiredRateIndex ?? current.wiredRateIndex, changes.wiredDpiIndex ?? current.wiredDpiIndex);
+    out[1 + 2] = mchosePackLinkByte(changes.wirelessRateIndex ?? current.wirelessRateIndex, changes.wirelessDpiIndex ?? current.wirelessDpiIndex);
+    if (changes.dpiStages) {
+        for (let stage = 0; stage < MCHOSE_DPI_STAGES; stage += 1) {
+            const value = changes.dpiStages[stage] ?? current.dpiStages[stage] ?? 0;
+            out[1 + 4 + stage * 2] = value & 0xff;
+            out[1 + 4 + stage * 2 + 1] = (value >> 8) & 0xff;
+        }
+    }
+    if (changes.keyDebounce !== undefined)
+        out[1 + 18] = changes.keyDebounce & 0xff;
+    if (changes.stageCount !== undefined)
+        out[1 + 16] = changes.stageCount & 0xff;
+    return out;
+}
+// ── model catalog ──────────────────────────────────────────────────────────
+/**
+ * PIDs shared by the whole A7 V2 family, so they identify a link rather than a
+ * model. The receiver is the endpoint the host talks to; the mouse reports its
+ * own model-specific id inside the battery reply.
+ */
+export const MCHOSE_LINK_PRODUCT_IDS = {
+    receiver: 0x100b,
+    bluetooth: 0x100a,
+    receiver8k: 0x1020,
+};
+/** The A7 V2 family, from the M HUB bundle's own model table. */
+export const MCHOSE_PRODUCTS = [
+    { name: "A7 V2 Pro", productId: 0x4018, dpiMax: 26000, liftOffDistances: [1, 2], maxPollingRate: 8000 },
+    { name: "A7 V2 Pro+", productId: 0x4023, dpiMax: 26000, liftOffDistances: [1, 2], maxPollingRate: 8000 },
+    { name: "A7 V2 Ultra", productId: 0x4019, dpiMax: 42000, liftOffDistances: [0.7, 1, 2], maxPollingRate: 8000 },
+    { name: "A7 V2 Ultra+", productId: 0x4021, dpiMax: 42000, liftOffDistances: [0.7, 1, 2], maxPollingRate: 8000 },
+];
+/** Rate lists the firmware exposes, keyed by the model's maximum rate. */
+export const MCHOSE_POLLING_RATES = {
+    1000: [125, 500, 1000],
+    4000: [125, 500, 1000, 2000, 4000],
+    8000: [125, 500, 1000, 2000, 4000, 8000],
+};
+/**
+ * Identify the model. The id inside the battery reply is decisive; the host-
+ * facing PID is shared across the family, so the product string is the only
+ * fallback, and an unrecognised one yields null rather than a wrong DPI ceiling.
+ */
+export function mchoseFindProduct(mouseProductId, productName) {
+    const byId = MCHOSE_PRODUCTS.find((product) => product.productId === mouseProductId);
+    if (byId)
+        return byId;
+    const name = productName?.trim().toUpperCase() ?? "";
+    if (!name)
+        return null;
+    // Longest name first so "A7 V2 Ultra+" is not swallowed by "A7 V2 Ultra".
+    return [...MCHOSE_PRODUCTS]
+        .sort((a, b) => b.name.length - a.name.length)
+        .find((product) => name.includes(product.name.toUpperCase())) ?? null;
+}
+/** Polling rates available on the link this host-facing product id represents. */
+export function mchosePollingRates(product, hostProductId) {
+    const max = hostProductId === MCHOSE_LINK_PRODUCT_IDS.bluetooth ? 1000 : product.maxPollingRate;
+    return MCHOSE_POLLING_RATES[max] ?? MCHOSE_POLLING_RATES[1000];
+}
+export * from "./buttons.js";
+export * from "./dock.js";
+export * from "./a5-gen1.js";
+// The A7 V3 generation's protocol, which shares only a vendor id with the above.
+export * from "./v3.js";
+/**
+ * Profile names, read one at a time with `0x12 0x68 <index>`. The reply is the
+ * profile index followed by a NUL-terminated ASCII name — the test hardware
+ * answered "Config 1", "Config 2", "Config 3".
+ */
+export function mchoseEncodeReadProfileName(index) {
+    if (!Number.isInteger(index) || index < 0 || index >= MCHOSE_PROFILE_COUNT) {
+        throw new Error(`MCHOSE profile index must be 0-${MCHOSE_PROFILE_COUNT - 1}.`);
+    }
+    return [MCHOSE_COMMAND.readProfileName, index];
+}
+export function mchoseDecodeProfileName(payload) {
+    if (payload.length < 2)
+        return null;
+    let end = 1;
+    while (end < payload.length && payload[end] !== 0)
+        end += 1;
+    const name = String.fromCharCode(...payload.subarray(1, end)).trim();
+    return name.length ? name : null;
+}
+//# sourceMappingURL=index.js.map

package/dist/mchose/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mchose/index.ts"],"names":[],"mappings":"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"}

package/dist/mchose/v3-buttons.d.ts

@@ -0,0 +1,64 @@
+/**
+ * What an A7 V3 button can be set to, read out of M HUB's own tables.
+ *
+ * The vendor stores each action as a hex string whose first byte is the type
+ * and whose remaining bytes are the value — `"0x13042b"` is Alt+Tab, type
+ * `0x13`, modifier `0x04`, usage `0x2b`. The rows below are those strings split
+ * in two, in the same orientation {@link mchoseV3DecodeButtons} produces, so a
+ * decoded assignment can be compared against this table directly.
+ *
+ * **Type and value only mean anything together.** `0x0002` is "right click"
+ * under type `0x00`, "DPI −" under type `0x01` and a media key under `0x14`.
+ *
+ * Note the type numbers are **not** the A7 V2's: this generation uses `0x00`
+ * for mouse buttons, `0x11`/`0x13` for the keyboard, `0x14` for media, `0x16`
+ * for system shortcuts, `0x33` for profiles and `0xfe` for a disabled button.
+ * The V2's 1/2/3/5/8/9/10 mean nothing here.
+ */
+export interface MchoseV3ButtonAction {
+    label: string;
+    type: number;
+    /** Value bytes after the type, most significant first. */
+    value: readonly number[];
+    /** Display grouping, matching the A7 V2 driver's. */
+    group: string;
+}
+/**
+ * A button the firmware reports as carrying no assignment at all. M HUB never
+ * writes this — it writes {@link MCHOSE_V3_BUTTON_ACTIONS}'s "Disabled",
+ * which is type `0xfe` — but a stock mouse can report it, so it has to be
+ * nameable. A real A7 V3 Ultra+ shipped with its DPI button on `0xff`.
+ */
+export declare const MCHOSE_V3_BUTTON_UNSET = 255;
+/**
+ * Every action M HUB offers, plus the letters, function keys and navigation
+ * keys the vendor's table leaves to its on-screen keyboard. Those are derived,
+ * not invented: the vendor's own shortcuts spell out the same standard HID
+ * usages under the same type (Ctrl+A is `0x04`, Ctrl+C `0x06`, Alt+F4 `0x3d`,
+ * Esc `0x29`), so the usage page is confirmed rather than assumed.
+ */
+export declare const MCHOSE_V3_BUTTON_ACTIONS: readonly MchoseV3ButtonAction[];
+/**
+ * Resolve an action for a specific button.
+ *
+ * "Default" is the one entry whose value depends on which button it is for:
+ * the firmware stores each button's own factory mask rather than a shared
+ * "restore" sentinel.
+ */
+export declare function mchoseV3ButtonAction(button: string, label: string): {
+    type: number;
+    value: number[];
+} | null;
+/**
+ * Name a stored assignment. Type and value are matched together, because the
+ * same value means different things under different types. A button sitting on
+ * its own factory mask is reported as "Default" rather than as the click it
+ * happens to encode, since that is what the user changed it from.
+ */
+export declare function mchoseV3ButtonActionName(button: string, action: {
+    type: number;
+    value: readonly number[];
+}): string;
+/** Labels for the picker, in display order. */
+export declare function mchoseV3ButtonActionLabels(): string[];
+//# sourceMappingURL=v3-buttons.d.ts.map

package/dist/mchose/v3-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-buttons.d.ts","sourceRoot":"","sources":["../../src/mchose/v3-buttons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,MAAO,CAAC;AAgB3C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,oBAAoB,EAgLnE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAS1C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACjD,MAAM,CAeR;AAMD,+CAA+C;AAC/C,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD"}