lhns--steam-frame-nix/modules/launcher-menu/launch/patch.js

// launch: what happens when a program of the VR dashboard's "+" menu
// (#VRDashboard_LaunchNonSteamApp) is activated.
//
// This file is a function expression, called by the file lib/default.nix
// (mkPatch) generates: (<this file>)(find, sigs, opts), with find the finder
// library (lib/finders.js) and opts the options from launcher-menu.nix, e.g.
// { closeOnLaunch: true, debounceSeconds: 10 }.
//
// Stock, an item's onActivate only calls
// SteamClient.Apps.LaunchNonSteamApp(strCmdline) (plus the nav sound); the
// "+" popup stays open until the new window takes over, so users click again
// and start the program twice. That call is the only use of
// LaunchNonSteamApp in Steam's UI and is looked up at call time, so this
// patch wraps it in SharedJSContext (the dashboard bar's realm):
// - debounceSeconds > 0: a launch of the same command line within that many
//   seconds of the last accepted one is ignored (console.info, and reported
//   in the steam-ui-patches journal on the next re-injection);
// - closeOnLaunch: after a launch (ignored or not), the "+" popup is closed
//   through the bar button's own popup handle (closePopup(), what stock does
//   after adding a desktop window). The handle is found through React props,
//   not minified names: in any popup document (the dashboard bar's), a
//   .VRDashboardBarSmallButton element whose fiber ancestors include the bar
//   button (prop refBarPopopHandle) and, above it, the "+" component (prop
//   allowLaunchProgram). scripts/check-signatures.mjs checks these names
//   ("launcher-menu-launch" in lib/signatures.json).
// Works for every activation path (pointer, controller, the pinned Desktop
// copy, which clicks the stock item). The original is kept as __sfuiOrig
// (unpatch.js restores it). Idempotent; bump VERSION when changing the
// wrapper.
((find, sigs, opts) => {
  const VERSION = 2;
  const NAME = 'launcher-menu-launch';
  const CLOSE = opts.closeOnLaunch === true;
  const DEBOUNCE_MS = Math.max(0, Number(opts.debounceSeconds) || 0) * 1000;
  const Apps = window.SteamClient?.Apps;
  const cur = Apps?.LaunchNonSteamApp;
  if (typeof cur !== 'function') return 'SteamClient.Apps.LaunchNonSteamApp missing';
  const st = cur.__sfuiPatch === NAME ? cur.__sfuiState : null;
  if (st && cur.__sfuiVersion === VERSION && st.close === CLOSE && st.debounceMs === DEBOUNCE_MS) {
    // Report ignored launches since the last evaluation (the injector logs
    // results that differ from the previous one).
    const msgs = st.log.splice(0);
    return msgs.length ? msgs.join('; ') : 'unchanged';
  }
  const orig = cur.__sfuiPatch === NAME ? cur.__sfuiOrig : cur;

  // Popup handles of the "+" bar button(s) (normally one).
  const hasProp = (f, k) => f.memoizedProps && typeof f.memoizedProps === 'object' && k in f.memoizedProps;
  const plusHandles = () => {
    const hs = [];
    for (const p of window.g_PopupManager?.GetPopups() ?? []) {
      let d;
      try { d = p.window?.document; } catch { continue; }
      for (const el of d?.querySelectorAll('.VRDashboardBarSmallButton') ?? []) {
        const button = find.findFiberUp(el, (f) => hasProp(f, 'refBarPopopHandle'), 20);
        if (!button || !find.findFiberUp(button, (f) => hasProp(f, 'allowLaunchProgram'), 20)) continue;
        const h = button.memoizedProps.refBarPopopHandle?.current ?? null;
        if (h && !hs.includes(h)) hs.push(h);
      }
    }
    return hs;
  };
  const closeMenu = () => {
    for (const h of plusHandles()) if (h.BPopupOpen?.()) h.closePopup();
  };

  const state = { close: CLOSE, debounceMs: DEBOUNCE_MS, last: new Map(), log: [], plusHandles, closeMenu };
  const f = function LaunchNonSteamApp(cmdline, ...rest) {
    let result;
    const now = Date.now();
    const key = String(cmdline);
    const prev = state.last.get(key);
    if (DEBOUNCE_MS > 0 && prev !== undefined && now - prev < DEBOUNCE_MS) {
      const msg = `ignored repeated launch of ${JSON.stringify(key)} (${((now - prev) / 1000).toFixed(1)} s after the last one, at ${new Date(now).toLocaleTimeString()})`;
      console.info(`sfui ${NAME}: ${msg}`);
      state.log.push(msg);
      if (state.log.length > 20) state.log.shift();
    } else {
      state.last.set(key, now);
      for (const [k, t] of state.last) if (now - t >= DEBOUNCE_MS && k !== key) state.last.delete(k);
      result = orig.call(this, cmdline, ...rest);
    }
    if (CLOSE) { try { closeMenu(); } catch (e) { console.error(`sfui ${NAME}:`, e); } }
    return result;
  };
  f.__sfuiPatch = NAME; f.__sfuiVersion = VERSION; f.__sfuiOrig = orig; f.__sfuiState = state;
  Apps.LaunchNonSteamApp = f;
  const what = [CLOSE && 'close on launch', DEBOUNCE_MS > 0 && `debounce ${DEBOUNCE_MS / 1000} s`].filter(Boolean);
  return `patched (${what.join(', ') || 'no-op'})`;
})