@diffenderfer-games/hub 2.0.0-next.0 → 2.0.0-next.2

package/src/input/input-registry.ts

@@ -1,164 +1,171 @@
-/**
- * The declared inputs, groups and axes, and their readings: each input's raw
- * value this frame and last frame, from which edges, axes and vectors follow.
- */
-import type { DeviceState } from './device-state';
-import { clampUnit, readRawValue } from './source-values';
-import type { AxisDef, InputConfig, InputDef, InputReading, InputSource, Vector } from './types';
-
-/** One input's live state. */
-interface LiveInput {
-  definition: InputDef;
-  readonly group: string;
-  raw: number;
-  previous: number;
-}
-
-/** Inputs cross this to count as pressed. */
-const PRESS_THRESHOLD = 0.5;
-
-/** One side of an axis definition as -1..1. */
-function readAxisSide(side: AxisDef['x'], valueOf: (name: string) => number): number {
-  if (side === undefined) {
-    return 0;
-  }
-  if (typeof side === 'string') {
-    return valueOf(side);
-  }
-  return clampUnit(valueOf(side[1])) - clampUnit(valueOf(side[0]));
-}
-
-/** The declared inputs and their readings. */
-export class InputRegistry {
-  private readonly inputs = new Map<string, LiveInput>();
-  private readonly enabledGroups = new Map<string, boolean>();
-  private readonly axes = new Map<string, AxisDef>();
-
-  /** Replace the declared inputs. Groups keep an enabled state set before; new ones start as declared. */
-  declare(config: InputConfig, bindingOf: (name: string, declared: InputDef) => InputDef): void {
-    this.inputs.clear();
-    this.axes.clear();
-    for (const [group, groupDefinition] of Object.entries(config.groups)) {
-      if (!this.enabledGroups.has(group)) {
-        this.enabledGroups.set(group, groupDefinition.enabled ?? false);
-      }
-      for (const [name, definition] of Object.entries(groupDefinition.inputs)) {
-        this.inputs.set(name, { definition: bindingOf(name, definition), group, raw: 0, previous: 0 });
-      }
-      for (const [name, axis] of Object.entries(groupDefinition.axes ?? {})) {
-        this.axes.set(name, axis);
-      }
-    }
-  }
-
-  /** The group an input belongs to. */
-  groupOf(name: string): string | undefined {
-    return this.inputs.get(name)?.group;
-  }
-
-  /** Replace one input's sources (after a rebind). */
-  redefine(name: string, definition: InputDef): void {
-    const input = this.inputs.get(name);
-    if (input !== undefined) {
-      input.definition = definition;
-    }
-  }
-
-  /** Turn a group on or off. On: held sources don't fire a phantom `down`. Off: its inputs read 0. */
-  setGroupEnabled(group: string, isEnabled: boolean, devices: DeviceState, source: InputSource): void {
-    this.enabledGroups.set(group, isEnabled);
-    for (const input of this.inputs.values()) {
-      if (input.group !== group) {
-        continue;
-      }
-      input.raw = isEnabled ? readRawValue(devices, input.definition, source) : 0;
-      if (isEnabled) {
-        input.previous = input.raw;
-      }
-    }
-  }
-
-  /** Whether a group is on. */
-  isEnabled(group: string): boolean {
-    return this.enabledGroups.get(group) === true;
-  }
-
-  /** The groups that are on. */
-  enabledGroupNames(): Set<string> {
-    return new Set([...this.enabledGroups].filter(([, isOn]) => isOn).map(([group]) => group));
-  }
-
-  /** Take this frame's readings (inputs of disabled groups read 0). */
-  sample(devices: DeviceState, source: InputSource): void {
-    for (const input of this.inputs.values()) {
-      input.previous = input.raw;
-      input.raw = this.isEnabled(input.group) ? readRawValue(devices, input.definition, source) : 0;
-    }
-  }
-
-  /** Every input reads 0 this frame (the hub menu is open). */
-  silence(): void {
-    for (const input of this.inputs.values()) {
-      input.previous = input.raw;
-      input.raw = 0;
-    }
-  }
-
-  /** An input's value, 0..1. */
-  value(name: string): number {
-    return this.inputs.get(name)?.raw ?? 0;
-  }
-
-  /** Whether an input crossed the press threshold upward this frame. */
-  wentDown(name: string): boolean {
-    const input = this.inputs.get(name);
-    return input !== undefined && input.previous < PRESS_THRESHOLD && input.raw >= PRESS_THRESHOLD;
-  }
-
-  /** Whether an input crossed the press threshold downward this frame. */
-  wentUp(name: string): boolean {
-    const input = this.inputs.get(name);
-    return input !== undefined && input.previous >= PRESS_THRESHOLD && input.raw < PRESS_THRESHOLD;
-  }
-
-  /** Whether an input is held. */
-  isPressed(name: string): boolean {
-    return this.value(name) >= PRESS_THRESHOLD;
-  }
-
-  /** An input's full reading. */
-  reading(name: string): InputReading {
-    const raw = this.value(name);
-    return { value: raw, raw, isDown: this.wentDown(name), isUp: this.wentUp(name) };
-  }
-
-  /** A named axis (or an ad-hoc negative/positive pair) as -1..1. */
-  axis(name: string, positive?: string): number {
-    if (positive !== undefined) {
-      return clampUnit(this.value(positive)) - clampUnit(this.value(name));
-    }
-    const axis = this.axes.get(name);
-    return axis === undefined ? this.value(name) : readAxisSide(axis.x, (input) => this.value(input));
-  }
-
-  /** A named axis pair as a vector clamped to the unit circle. */
-  vector(name: string): Vector {
-    const axis = this.axes.get(name);
-    if (axis === undefined) {
-      return { x: 0, y: 0, mag: 0 };
-    }
-    let horizontal = readAxisSide(axis.x, (input) => this.value(input));
-    let vertical = readAxisSide(axis.y, (input) => this.value(input));
-    const magnitude = Math.hypot(horizontal, vertical);
-    if (magnitude > 1) {
-      horizontal /= magnitude;
-      vertical /= magnitude;
-    }
-    return { x: horizontal, y: vertical, mag: Math.min(magnitude, 1) };
-  }
-
-  /** An input's current sources (for the binding label). */
-  definitionOf(name: string): InputDef | undefined {
-    return this.inputs.get(name)?.definition;
-  }
-}
+/**
+ * The declared inputs, groups and axes, and their readings: each input's raw
+ * value this frame and last frame, from which edges, axes and vectors follow.
+ */
+import type { DeviceState } from './device-state';
+import { clampUnit, readRawValue } from './source-values';
+import type { AxisDef, InputConfig, InputDef, InputReading, InputSource, Vector } from './types';
+
+/** One input's live state. */
+interface LiveInput {
+  definition: InputDef;
+  readonly group: string;
+  raw: number;
+  previous: number;
+}
+
+/** Inputs cross this to count as pressed. */
+const PRESS_THRESHOLD = 0.5;
+
+/** One side of an axis definition as -1..1. */
+function readAxisSide(side: AxisDef['x'], valueOf: (name: string) => number): number {
+  if (side === undefined) {
+    return 0;
+  }
+  if (typeof side === 'string') {
+    return valueOf(side);
+  }
+  return clampUnit(valueOf(side[1])) - clampUnit(valueOf(side[0]));
+}
+
+/** The declared inputs and their readings. */
+export class InputRegistry {
+  private readonly inputs = new Map<string, LiveInput>();
+  private readonly enabledGroups = new Map<string, boolean>();
+  private readonly axes = new Map<string, AxisDef>();
+
+  /** Replace the declared inputs. Groups keep an enabled state set before; new ones start as declared. */
+  declare(config: InputConfig, bindingOf: (name: string, declared: InputDef) => InputDef): void {
+    this.inputs.clear();
+    this.axes.clear();
+    for (const [group, groupDefinition] of Object.entries(config.groups)) {
+      if (!this.enabledGroups.has(group)) {
+        this.enabledGroups.set(group, groupDefinition.enabled ?? false);
+      }
+      for (const [name, definition] of Object.entries(groupDefinition.inputs)) {
+        this.inputs.set(name, { definition: bindingOf(name, definition), group, raw: 0, previous: 0 });
+      }
+      for (const [name, axis] of Object.entries(groupDefinition.axes ?? {})) {
+        this.axes.set(name, axis);
+      }
+    }
+  }
+
+  /** The group an input belongs to. */
+  groupOf(name: string): string | undefined {
+    return this.inputs.get(name)?.group;
+  }
+
+  /** Replace one input's sources (after a rebind). */
+  redefine(name: string, definition: InputDef): void {
+    const input = this.inputs.get(name);
+    if (input !== undefined) {
+      input.definition = definition;
+    }
+  }
+
+  /** Turn a group on or off. On: held sources don't fire a phantom `down`. Off: its inputs read 0. */
+  setGroupEnabled(group: string, isEnabled: boolean, devices: DeviceState, source: InputSource): void {
+    this.enabledGroups.set(group, isEnabled);
+    for (const input of this.inputs.values()) {
+      if (input.group !== group) {
+        continue;
+      }
+      input.raw = isEnabled ? readRawValue(devices, input.definition, source) : 0;
+      if (isEnabled) {
+        input.previous = input.raw;
+      }
+    }
+  }
+
+  /** Whether a group is on. */
+  isEnabled(group: string): boolean {
+    return this.enabledGroups.get(group) === true;
+  }
+
+  /** The groups that are on. */
+  enabledGroupNames(): Set<string> {
+    return new Set([...this.enabledGroups].filter(([, isOn]) => isOn).map(([group]) => group));
+  }
+
+  /** Take this frame's readings (inputs of disabled groups read 0). */
+  sample(devices: DeviceState, source: InputSource): void {
+    for (const input of this.inputs.values()) {
+      input.previous = input.raw;
+      input.raw = this.isEnabled(input.group) ? readRawValue(devices, input.definition, source) : 0;
+    }
+  }
+
+  /** Every input reads 0 this frame (the hub menu is open). */
+  silence(): void {
+    for (const input of this.inputs.values()) {
+      input.previous = input.raw;
+      input.raw = 0;
+    }
+  }
+
+  /** An input's value, 0..1. */
+  value(name: string): number {
+    return this.inputs.get(name)?.raw ?? 0;
+  }
+
+  /** Whether an input crossed the press threshold upward this frame. */
+  wentDown(name: string): boolean {
+    const input = this.inputs.get(name);
+    return input !== undefined && input.previous < PRESS_THRESHOLD && input.raw >= PRESS_THRESHOLD;
+  }
+
+  /** Whether an input crossed the press threshold downward this frame. */
+  wentUp(name: string): boolean {
+    const input = this.inputs.get(name);
+    return input !== undefined && input.previous >= PRESS_THRESHOLD && input.raw < PRESS_THRESHOLD;
+  }
+
+  /** Whether an input is held. */
+  isPressed(name: string): boolean {
+    return this.value(name) >= PRESS_THRESHOLD;
+  }
+
+  /** An input's full reading. */
+  reading(name: string): InputReading {
+    const raw = this.value(name);
+    return { value: raw, raw, isDown: this.wentDown(name), isUp: this.wentUp(name) };
+  }
+
+  /**
+   * A named axis (or an ad-hoc negative/positive pair) as -1..1: its `x`, or
+   * its `y` when it declares only `y` (a vertical one-axis control, like a
+   * paddle).
+   */
+  axis(name: string, positive?: string): number {
+    if (positive !== undefined) {
+      return clampUnit(this.value(positive)) - clampUnit(this.value(name));
+    }
+    const axis = this.axes.get(name);
+    if (axis === undefined) {
+      return this.value(name);
+    }
+    return readAxisSide(axis.x ?? axis.y, (input) => this.value(input));
+  }
+
+  /** A named axis pair as a vector clamped to the unit circle. */
+  vector(name: string): Vector {
+    const axis = this.axes.get(name);
+    if (axis === undefined) {
+      return { x: 0, y: 0, mag: 0 };
+    }
+    let horizontal = readAxisSide(axis.x, (input) => this.value(input));
+    let vertical = readAxisSide(axis.y, (input) => this.value(input));
+    const magnitude = Math.hypot(horizontal, vertical);
+    if (magnitude > 1) {
+      horizontal /= magnitude;
+      vertical /= magnitude;
+    }
+    return { x: horizontal, y: vertical, mag: Math.min(magnitude, 1) };
+  }
+
+  /** An input's current sources (for the binding label). */
+  definitionOf(name: string): InputDef | undefined {
+    return this.inputs.get(name)?.definition;
+  }
+}