glorp!

2026-09-17 01:50:47 -04:00 · 2026-09-12 20:52:34 -04:00
parent ba5c1c5d25
commit 8e96c3cdae
40 changed files with 1725 additions and 420 deletions
@@ -0,0 +1,112 @@
+// Controller Prompt Labels
+// Purpose: Converts persisted controller bindings into compact prompts for the connected hardware.
+// Scope: Delegates hardware identification and standard button naming to gamepad-helper while
+// keeping rover action aliases and compact presentation local to the controller input layer.
+import GamepadHelper from '@lizardbyte/gamepad-helper/src/js/gamepad-helper.js';
+
+const gamepadHelper = new GamepadHelper();
+
+const ACTION_ALIASES = {
+  driveForward: { bindingId: 'drive', direction: 'up' },
+  driveBackward: { bindingId: 'drive', direction: 'down' },
+  driveLeft: { bindingId: 'drive', direction: 'left' },
+  driveRight: { bindingId: 'drive', direction: 'right' },
+  cameraUp: { bindingId: 'cameraTilt', direction: 'up' },
+  cameraDown: { bindingId: 'cameraTilt', direction: 'down' },
+  auxMainForward: { bindingId: 'mainBrush', direction: 'forward' },
+  auxMainReverse: { bindingId: 'mainBrush', direction: 'reverse' },
+  auxSideForward: { bindingId: 'sideBrush', direction: 'forward' },
+  auxSideReverse: { bindingId: 'sideBrush', direction: 'reverse' },
+  auxVacuumFast: { bindingId: 'vacuum' },
+  auxVacuumSlow: { bindingId: 'vacuum' },
+  auxAllForward: { bindingId: 'allAux' },
+};
+
+const DIRECTION_GLYPHS = {
+  up: '↑',
+  down: '↓',
+  left: '←',
+  right: '→',
+  forward: '+',
+  reverse: '−',
+};
+
+const COMPACT_BUTTON_NAMES = {
+  DUp: 'D↑',
+  DDown: 'D↓',
+  DLeft: 'D←',
+  DRight: 'D→',
+  TouchPad: 'Touchpad',
+};
+
+function controllerType(controller, promptStyle) {
+  /* Manual prompt selection is a direct library controller type, not a model-name imitation.
+     Automatic mode gives the complete browser ID to gamepad-helper unchanged; in particular,
+     its vendor/product lookup directly recognizes Linux's 054c-0ce6 DualSense identifier. */
+  if (promptStyle && promptStyle !== 'auto') return promptStyle;
+  return gamepadHelper.detectControllerType(controller?.id ?? '');
+}
+
+export function describeController(controller) {
+  const info = gamepadHelper.getGamepadInfo(controller?.id ?? '');
+  return {
+    model: info.type,
+    brand: info.type === gamepadHelper.CONTROLLER_TYPES.PLAYSTATION ? 'Sony' : null,
+    description: info.name,
+  };
+}
+
+function compactButtonName(source, type) {
+  const name = gamepadHelper.getButtonName(type, source.index);
+  return COMPACT_BUTTON_NAMES[name] ?? name;
+}
+
+function compactAxisName(source) {
+  /* Standard browser mappings place sticks in adjacent pairs. Showing the stick instead of its
+     raw component keeps prompts short; the action and optional arrow already convey the axis. */
+  if (source.index === 0 || source.index === 1) return 'LS';
+  if (source.index === 2 || source.index === 3) return 'RS';
+  return `A${source.index}`;
+}
+
+function compactAxisPairName(source) {
+  if (source.x === 0 && source.y === 1) return 'LS';
+  if (source.x === 2 && source.y === 3) return 'RS';
+  return `A${source.x}/${source.y}`;
+}
+
+function compactSourceName(source, type) {
+  if (!source) return '—';
+  if (source.kind === 'chord') {
+    return (source.inputs ?? []).map((input) => compactSourceName(input, type)).join('+');
+  }
+  if (source.kind === 'axisPair') return compactAxisPairName(source);
+  if (source.kind === 'button' || source.kind === 'buttonAxis') {
+    return compactButtonName(source, type);
+  }
+  if (source.kind === 'axis' || source.kind === 'axisButton') {
+    return compactAxisName(source);
+  }
+  return '—';
+}
+
+export function bindingForControllerAction(profile, actionId) {
+  const direct = profile?.bindings?.[actionId];
+  if (direct?.sources?.length) return { binding: direct, direction: null };
+  const alias = ACTION_ALIASES[actionId];
+  if (!alias) return { binding: direct ?? null, direction: null };
+  return {
+    binding: profile?.bindings?.[alias.bindingId] ?? null,
+    direction: alias.direction ?? null,
+  };
+}
+
+export function formatControllerBinding(profile, actionId, controller) {
+  const { binding, direction } = bindingForControllerAction(profile, actionId);
+  const source = binding?.sources?.[0];
+  if (!source) return '—';
+  const type = controllerType(controller, profile?.promptStyle);
+  const label = compactSourceName(source, type);
+  const directionLabel = direction ? DIRECTION_GLYPHS[direction] : null;
+  return directionLabel ? `${label} ${directionLabel}` : label;
+}