@decky/ui 4.15.0 → 4.16.0

package/dist/modules/Router.js

@@ -1,23 +1,5 @@
-import Logger from '../logger';
-import { findModuleExport } from '../webpack';
-export var SideMenu;
-(function (SideMenu) {
-    SideMenu[SideMenu["None"] = 0] = "None";
-    SideMenu[SideMenu["Main"] = 1] = "Main";
-    SideMenu[SideMenu["QuickAccess"] = 2] = "QuickAccess";
-})(SideMenu || (SideMenu = {}));
-export var QuickAccessTab;
-(function (QuickAccessTab) {
-    QuickAccessTab[QuickAccessTab["Notifications"] = 0] = "Notifications";
-    QuickAccessTab[QuickAccessTab["RemotePlayTogetherControls"] = 1] = "RemotePlayTogetherControls";
-    QuickAccessTab[QuickAccessTab["VoiceChat"] = 2] = "VoiceChat";
-    QuickAccessTab[QuickAccessTab["Friends"] = 3] = "Friends";
-    QuickAccessTab[QuickAccessTab["Settings"] = 4] = "Settings";
-    QuickAccessTab[QuickAccessTab["Perf"] = 5] = "Perf";
-    QuickAccessTab[QuickAccessTab["Help"] = 6] = "Help";
-    QuickAccessTab[QuickAccessTab["Music"] = 7] = "Music";
-    QuickAccessTab[QuickAccessTab["Decky"] = 999] = "Decky";
-})(QuickAccessTab || (QuickAccessTab = {}));
+import Logger from "../logger";
+import { findModuleExport } from "../webpack";
 export const Router = findModuleExport((e) => e.Navigate && e.NavigationManager);
 export let Navigation = {};
 const logger = new Logger("Navigation");

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/class-mapper.ts","../src/index.ts","../src/logger.ts","../src/webpack.ts","../src/components/Button.ts","../src/components/ButtonItem.ts","../src/components/Carousel.ts","../src/components/ControlsList.ts","../src/components/Dialog.ts","../src/components/DialogCheckbox.ts","../src/components/Dropdown.tsx","../src/components/ErrorBoundary.ts","../src/components/Field.ts","../src/components/FocusRing.ts","../src/components/Focusable.ts","../src/components/FooterLegend.ts","../src/components/Item.ts","../src/components/Marquee.ts","../src/components/Menu.ts","../src/components/Modal.ts","../src/components/Panel.ts","../src/components/ProgressBar.ts","../src/components/Scroll.ts","../src/components/SidebarNavigation.ts","../src/components/SliderField.ts","../src/components/Spinner.ts","../src/components/SteamSpinner.ts","../src/components/Tabs.ts","../src/components/TextField.ts","../src/components/Toggle.ts","../src/components/ToggleField.ts","../src/components/index.ts","../src/custom-components/ColorPickerModal.tsx","../src/custom-components/ReorderableList.tsx","../src/custom-components/SuspensefulImage.tsx","../src/custom-components/index.ts","../src/custom-hooks/index.ts","../src/custom-hooks/useQuickAccessVisible.ts","../src/deck-hooks/index.ts","../src/deck-hooks/useParams.ts","../src/globals/SteamClient.ts","../src/globals/index.ts","../src/globals/stores.ts","../src/globals/steam-client/App.ts","../src/globals/steam-client/Auth.ts","../src/globals/steam-client/Broadcast.ts","../src/globals/steam-client/Browser.ts","../src/globals/steam-client/ClientNotifications.ts","../src/globals/steam-client/Cloud.ts","../src/globals/steam-client/CommunityItems.ts","../src/globals/steam-client/Console.ts","../src/globals/steam-client/Customization.ts","../src/globals/steam-client/Downloads.ts","../src/globals/steam-client/FamilySharing.ts","../src/globals/steam-client/FriendSettings.ts","../src/globals/steam-client/Friends.ts","../src/globals/steam-client/GameNotes.ts","../src/globals/steam-client/GameRecording.ts","../src/globals/steam-client/GameSessions.ts","../src/globals/steam-client/Input.ts","../src/globals/steam-client/InstallFolder.ts","../src/globals/steam-client/Installs.ts","../src/globals/steam-client/Messaging.ts","../src/globals/steam-client/Music.ts","../src/globals/steam-client/Notifications.ts","../src/globals/steam-client/OpenVR.ts","../src/globals/steam-client/Overlay.ts","../src/globals/steam-client/Parental.ts","../src/globals/steam-client/RemotePlay.ts","../src/globals/steam-client/Screenshots.ts","../src/globals/steam-client/ServerBrowser.ts","../src/globals/steam-client/Settings.ts","../src/globals/steam-client/SharedConnection.ts","../src/globals/steam-client/Stats.ts","../src/globals/steam-client/SteamChina.ts","../src/globals/steam-client/Storage.ts","../src/globals/steam-client/Streaming.ts","../src/globals/steam-client/UI.ts","../src/globals/steam-client/URL.ts","../src/globals/steam-client/Updates.ts","../src/globals/steam-client/User.ts","../src/globals/steam-client/WebChat.ts","../src/globals/steam-client/WebUITransport.ts","../src/globals/steam-client/Window.ts","../src/globals/steam-client/index.ts","../src/globals/steam-client/shared.ts","../src/globals/steam-client/browser-view/BrowserViewPopup.ts","../src/globals/steam-client/browser-view/index.ts","../src/globals/steam-client/system/Audio.ts","../src/globals/steam-client/system/AudioDevice.ts","../src/globals/steam-client/system/Bluetooth.ts","../src/globals/steam-client/system/Devkit.ts","../src/globals/steam-client/system/Display.ts","../src/globals/steam-client/system/DisplayManager.ts","../src/globals/steam-client/system/Dock.ts","../src/globals/steam-client/system/Perf.ts","../src/globals/steam-client/system/Report.ts","../src/globals/steam-client/system/UI.ts","../src/globals/steam-client/system/index.ts","../src/globals/steam-client/system/network/Device.ts","../src/globals/steam-client/system/network/index.ts","../src/modules/Router.ts","../src/modules/index.ts","../src/utils/index.ts","../src/utils/patcher.ts","../src/utils/static-classes.ts","../src/utils/react/fc.ts","../src/utils/react/react.ts","../src/utils/react/treepatcher.ts"],"version":"5.9.2"}
+{"root":["../src/class-mapper.ts","../src/index.ts","../src/logger.ts","../src/webpack.ts","../src/components/Button.ts","../src/components/ButtonItem.ts","../src/components/Carousel.ts","../src/components/ControlsList.ts","../src/components/Dialog.ts","../src/components/DialogCheckbox.ts","../src/components/Dropdown.tsx","../src/components/ErrorBoundary.ts","../src/components/Field.ts","../src/components/FocusRing.ts","../src/components/Focusable.ts","../src/components/FooterLegend.ts","../src/components/Item.ts","../src/components/Marquee.ts","../src/components/Menu.ts","../src/components/Modal.ts","../src/components/Panel.ts","../src/components/ProgressBar.ts","../src/components/Scroll.ts","../src/components/SidebarNavigation.ts","../src/components/SliderField.ts","../src/components/Spinner.ts","../src/components/SteamSpinner.ts","../src/components/Tabs.ts","../src/components/TextField.ts","../src/components/Toggle.ts","../src/components/ToggleField.ts","../src/components/index.ts","../src/custom-components/ColorPickerModal.tsx","../src/custom-components/ReorderableList.tsx","../src/custom-components/SuspensefulImage.tsx","../src/custom-components/index.ts","../src/custom-hooks/index.ts","../src/custom-hooks/useQuickAccessVisible.ts","../src/deck-hooks/index.ts","../src/deck-hooks/useParams.ts","../src/globals/index.ts","../src/globals/shared/cm.ts","../src/globals/shared/enums.ts","../src/globals/shared/history.ts","../src/globals/shared/index.ts","../src/globals/shared/interfaces.ts","../src/globals/shared/navigation.ts","../src/globals/shared/steamid.ts","../src/globals/shared/storage.ts","../src/globals/steam-client/App.ts","../src/globals/steam-client/Auth.ts","../src/globals/steam-client/Broadcast.ts","../src/globals/steam-client/Browser.ts","../src/globals/steam-client/ClientNotifications.ts","../src/globals/steam-client/Cloud.ts","../src/globals/steam-client/CommunityItems.ts","../src/globals/steam-client/Console.ts","../src/globals/steam-client/Customization.ts","../src/globals/steam-client/Downloads.ts","../src/globals/steam-client/FamilySharing.ts","../src/globals/steam-client/FriendSettings.ts","../src/globals/steam-client/Friends.ts","../src/globals/steam-client/GameNotes.ts","../src/globals/steam-client/GameRecording.ts","../src/globals/steam-client/GameSessions.ts","../src/globals/steam-client/Input.ts","../src/globals/steam-client/InstallFolder.ts","../src/globals/steam-client/Installs.ts","../src/globals/steam-client/Messaging.ts","../src/globals/steam-client/Music.ts","../src/globals/steam-client/Notifications.ts","../src/globals/steam-client/OpenVR.ts","../src/globals/steam-client/Overlay.ts","../src/globals/steam-client/Parental.ts","../src/globals/steam-client/RemotePlay.ts","../src/globals/steam-client/Screenshots.ts","../src/globals/steam-client/ServerBrowser.ts","../src/globals/steam-client/Settings.ts","../src/globals/steam-client/SharedConnection.ts","../src/globals/steam-client/Stats.ts","../src/globals/steam-client/SteamChina.ts","../src/globals/steam-client/Storage.ts","../src/globals/steam-client/Streaming.ts","../src/globals/steam-client/UI.ts","../src/globals/steam-client/URL.ts","../src/globals/steam-client/Updates.ts","../src/globals/steam-client/User.ts","../src/globals/steam-client/WebChat.ts","../src/globals/steam-client/WebUITransport.ts","../src/globals/steam-client/Window.ts","../src/globals/steam-client/index.ts","../src/globals/steam-client/shared.ts","../src/globals/steam-client/browser-view/BrowserViewPopup.ts","../src/globals/steam-client/browser-view/index.ts","../src/globals/steam-client/system/Audio.ts","../src/globals/steam-client/system/AudioDevice.ts","../src/globals/steam-client/system/Bluetooth.ts","../src/globals/steam-client/system/Devkit.ts","../src/globals/steam-client/system/Display.ts","../src/globals/steam-client/system/DisplayManager.ts","../src/globals/steam-client/system/Dock.ts","../src/globals/steam-client/system/Perf.ts","../src/globals/steam-client/system/Report.ts","../src/globals/steam-client/system/UI.ts","../src/globals/steam-client/system/index.ts","../src/globals/steam-client/system/network/Device.ts","../src/globals/steam-client/system/network/index.ts","../src/globals/stores/app.ts","../src/globals/stores/appdetailsstore.ts","../src/globals/stores/appinfostore.ts","../src/globals/stores/appstore.ts","../src/globals/stores/badgestore.ts","../src/globals/stores/collectionstore.ts","../src/globals/stores/consolestore.ts","../src/globals/stores/focusnavcontroller.ts","../src/globals/stores/gamerecordingstore.ts","../src/globals/stores/index.ts","../src/globals/stores/libraryuistore.ts","../src/globals/stores/localizationmanager.ts","../src/globals/stores/mainwindowbrowsermanager.ts","../src/globals/stores/notificationstore.ts","../src/globals/stores/popupmanager.ts","../src/globals/stores/securitystore.ts","../src/globals/stores/settingsstore.ts","../src/globals/stores/storeitemcache.ts","../src/globals/stores/urlstore.ts","../src/globals/stores/friendstore/clanstore.ts","../src/globals/stores/friendstore/friendchat.ts","../src/globals/stores/friendstore/friendgroupstore.ts","../src/globals/stores/friendstore/friendingamenotificationstore.ts","../src/globals/stores/friendstore/friendslistfavoritesstore.ts","../src/globals/stores/friendstore/friendsuifriendstore.ts","../src/globals/stores/friendstore/index.ts","../src/globals/stores/friendstore/shared.ts","../src/globals/stores/steamuistore/gamepadbrowserview.ts","../src/globals/stores/steamuistore/gamepaduiaudio.ts","../src/globals/stores/steamuistore/index.ts","../src/globals/stores/steamuistore/menu.ts","../src/globals/stores/steamuistore/window.ts","../src/modules/Router.ts","../src/modules/index.ts","../src/utils/index.ts","../src/utils/patcher.ts","../src/utils/static-classes.ts","../src/utils/react/fc.ts","../src/utils/react/react.ts","../src/utils/react/treepatcher.ts"],"version":"5.9.2"}

package/dist/utils/index.d.ts

@@ -4,7 +4,6 @@ export * from './react/react';
 export * from './react/fc';
 export * from './react/treepatcher';
 declare global {
-    var FocusNavController: any;
     var GamepadNavTree: any;
 }
 export declare function joinClassNames(...classes: string[]): string;

package/dist/utils/react/treepatcher.js

@@ -11,21 +11,21 @@ function patchComponent(node, handler, steps, step, caches, logger, prop = 'type
     loggingEnabled && logger.group('Patching node:', node);
     switch (typeof node?.[prop]) {
         case 'function':
-            const patch = afterPatch(node, prop, steps[step + 1] ? createStepHandler(handler, steps, step + 1, caches, logger) : handler);
-            loggingEnabled && logger.debug('Patched a function component', patch);
-            break;
-        case 'object':
             if (node[prop]?.prototype?.render) {
                 wrapReactClass(node);
                 const patch = afterPatch(node[prop].prototype, 'render', steps[step + 1] ? createStepHandler(handler, steps, step + 1, caches, logger) : handler);
                 loggingEnabled && logger.debug('Patched class component', patch);
             }
             else {
-                loggingEnabled && logger.debug('Patching forwardref/memo');
-                wrapReactType(node, prop);
-                patchComponent(node[prop], handler, steps, step, caches, logger, node[prop]?.render ? 'render' : 'type');
+                const patch = afterPatch(node, prop, steps[step + 1] ? createStepHandler(handler, steps, step + 1, caches, logger) : handler);
+                loggingEnabled && logger.debug('Patched a function component', patch);
             }
             break;
+        case 'object':
+            loggingEnabled && logger.debug('Patching forwardref/memo');
+            wrapReactType(node, prop);
+            patchComponent(node[prop], handler, steps, step, caches, logger, node[prop]?.render ? 'render' : 'type');
+            break;
         default:
             logger.error('Unhandled component type', node);
             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decky/ui",
-  "version": "4.15.0",
+  "version": "4.16.0",
   "description": "A library for interacting with the Steam frontend in Decky plugins and elsewhere.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/components/Dialog.ts

@@ -69,7 +69,7 @@ const MappedDialogDivs = new Map(
     try {
       const renderedDiv = m.render({});
       // Take only the first class name segment as it identifies the element we want
-      return [renderedDiv.props.className.split(' ')[0], m];
+      return [renderedDiv?.props?.className?.split(' ')[0], m];
     } catch (e) {
       console.error("[DFL:Dialog]: failed to render common dialog component", e);
       return [null, null];

package/src/components/Dropdown.tsx

@@ -3,7 +3,7 @@ import { ReactNode, FC } from 'react';
 import { CommonUIModule } from '../webpack';
 import { ItemProps } from './Item';
 import { createPropListRegex } from '../utils';
-import type { ContextMenuPositionOptions } from './Menu';
+import type { ContextMenuCreationOptions } from './Menu';
 
 export interface SingleDropdownOption {
   data: any;
@@ -28,7 +28,7 @@ export interface DropdownProps {
   onMenuWillOpen?(showMenu: () => void): void;
   onMenuOpened?(): void;
   onChange?(data: SingleDropdownOption): void;
-  contextMenuPositionOptions?: ContextMenuPositionOptions;
+  contextMenuPositionOptions?: ContextMenuCreationOptions;
   menuLabel?: string;
   strDefaultLabel?: string;
   renderButtonValue?(element: ReactNode): ReactNode;

package/src/components/FooterLegend.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 
+// TODO(globals): should this really stay here ?
 export enum GamepadButton {
   INVALID,
   OK,
@@ -31,6 +32,13 @@ export enum GamepadButton {
   STEAM_GUIDE,
   STEAM_QUICK_MENU,
 }
+// TODO(globals): should this really stay here ?
+export enum EFocusSource {
+  GAMEPAD,
+  KEYBOARD,
+  APPLICATION,
+  BROWSER
+}
 export enum NavEntryPositionPreferences {
   /**
    * Always give focus to the first child element.
@@ -70,9 +78,9 @@ export enum NavEntryPositionPreferences {
   PREFERRED_CHILD,
 }
 export interface GamepadEventDetail {
-  button: number;
+  button: GamepadButton;
   is_repeat?: boolean;
-  source: number;
+  source: EFocusSource;
 }
 export declare type ActionDescriptionMap = {
   [key in GamepadButton]?: ReactNode;

package/src/components/Menu.ts

@@ -1,21 +1,7 @@
-import { FC, ReactNode } from 'react';
-
-import { Export, findModuleByExport, findModuleDetailsByExport, findModuleExport } from '../webpack';
-import { FooterLegendProps } from './FooterLegend';
-
-interface PopupCreationOptions {
-  /**
-   * Initially hidden, make it appear with {@link ContextMenuInstance.Show}.
-   */
-  bCreateHidden?: boolean;
-
-  bModal?: boolean;
-
-  /**
-   * Document title.
-   */
-  title?: string;
-}
+import type { FC, ReactNode } from 'react';
+import type { PopupCreationOptions } from '../globals/stores/popupmanager';
+import { type Export, findModuleByExport, findModuleDetailsByExport, findModuleExport } from '../webpack';
+import type { FooterLegendProps } from './FooterLegend';
 
 // Separate interface, since one of webpack module exports uses this exact object,
 // so maybe it could be reused elsewhere.
@@ -30,7 +16,7 @@ interface MonitorOptions {
   flGamepadScale: number;
 }
 
-export interface ContextMenuPositionOptions extends PopupCreationOptions, Partial<MonitorOptions> {
+export interface ContextMenuCreationOptions extends PopupCreationOptions, Partial<MonitorOptions> {
   /**
    * When {@link bForcePopup} is true, makes the window appear above everything else.
    */
@@ -69,6 +55,9 @@ export interface ContextMenuPositionOptions extends PopupCreationOptions, Partia
    */
   bMatchWidth?: boolean;
 
+  /**
+   * Set to `true` to not focus the menu when shown.
+   */
   bNoFocusWhenShown?: boolean;
 
   /**
@@ -101,7 +90,8 @@ export interface ContextMenuPositionOptions extends PopupCreationOptions, Partia
 
   bShiftToFitWindow?: boolean;
 
-  // different window creation flags (StandaloneContextMenu vs PopupContextMenu)
+  // different window creation flags (StandaloneContextMenu vs PopupContextMenu,
+  // so OverrideRedirect vs PopUpMenuHint in EPopupCreationFlags)
   bStandalone?: boolean;
 
   /**
@@ -119,7 +109,7 @@ interface ContextMenuInstance {
 export const showContextMenu: (
   children: ReactNode,
   parent?: EventTarget,
-  options?: ContextMenuPositionOptions,
+  options?: ContextMenuCreationOptions,
 ) => ContextMenuInstance = findModuleExport(
   (e: Export) =>
     typeof e === 'function' &&

package/src/components/Modal.ts

@@ -1,19 +1,51 @@
-import { FC, ReactNode } from 'react';
-
+import type { FC, ReactNode } from 'react';
+import type { BrowserContext } from '../globals/shared';
 import { findSP } from '../utils';
-import { Export, findModule, findModuleDetailsByExport, findModuleExport } from '../webpack';
+import { type Export, findModule, findModuleDetailsByExport, findModuleExport } from '../webpack';
 
-// All of the popout options + strTitle are related. Proper usage is not yet known...
 export interface ShowModalProps {
-  browserContext?: unknown;
+  browserContext?: BrowserContext;
+
+  /**
+   * @todo Opposite of {@link bNeverPopOut}.
+   */
   bForcePopOut?: boolean;
+
+  /**
+   * @todo seems unused ?
+   */
   bHideActionIcons?: boolean;
+
+  /**
+   * Desktop behavior - dim (not hide) the main window when showing this modal.
+   */
   bHideMainWindowForPopouts?: boolean;
+
+  /**
+   * @todo Opposite of {@link bForcePopOut}.
+   */
   bNeverPopOut?: boolean;
-  fnOnClose?: () => void; // Seems to be the same as "closeModal" callback, but only when the modal is a popout. Will no longer work after "Update" invocation!
+
+  /**
+   * Seems to be the same as "closeModal" callback, but only when the modal is a
+   * popout.
+   * @note Will no longer work after "Update" invocation!
+   */
+  fnOnClose?: () => void;
+
   popupHeight?: number;
   popupWidth?: number;
-  promiseRenderComplete?: Promise<void>; // Invoked once the render is complete. Currently, it seems to be used as image loading success/error callback...
+
+  /**
+   * Invoked once the render is complete. Currently, it seems to be used as
+   * image loading success/error callback...
+   */
+  promiseRenderComplete?: Promise<void>;
+
+  /**
+   * Document title. For modal title use the component's title, i.e. for
+   * {@link ConfirmModal} pass `strTitle`.
+   */
   strTitle?: string;
 }
 
@@ -37,7 +69,7 @@ const showModalRaw: (
   parent?: EventTarget,
   title?: string,
   props?: ShowModalProps,
-  unknown1?: unknown,
+  browserContext?: BrowserContext,
   hideActions?: { bHideActions?: boolean },
   modalManager?: unknown,
 ) => ShowModalResult = findModuleExport(

package/src/globals/index.ts

@@ -1,2 +1,45 @@
-export * from './SteamClient';
-export * from './stores';
+import type { SteamClient } from './steam-client';
+import type {
+  CApp,
+  CAppDetailsStore,
+  CAppStore,
+  CBadgeStore,
+  CCollectionStore,
+  CConsoleStore,
+  CFocusNavController,
+  CFriendStore,
+  CGameRecordingStore,
+  CLibraryUIStore,
+  CLocalizationManager,
+  CMainWindowBrowserManager,
+  CNotificationStore,
+  CPopupManager,
+  CSecurityStore,
+  CSettingsStore,
+  CSteamUIStore,
+  CURLStore,
+} from './stores';
+
+declare global {
+  interface Window {
+    App: CApp;
+    appStore: CAppStore;
+    appDetailsStore: CAppDetailsStore;
+    badgeStore: CBadgeStore;
+    collectionStore: CCollectionStore;
+    ConsoleStore: CConsoleStore;
+    FocusNavController: CFocusNavController;
+    friendStore: CFriendStore;
+    g_GRS: CGameRecordingStore;
+    g_PopupManager: CPopupManager;
+    LocalizationManager: CLocalizationManager;
+    MainWindowBrowserManager: CMainWindowBrowserManager;
+    NotificationStore: CNotificationStore;
+    securitystore: CSecurityStore;
+    settingsStore: CSettingsStore;
+    SteamClient: SteamClient;
+    SteamUIStore: CSteamUIStore;
+    uiStore: CLibraryUIStore;
+    urlStore: CURLStore;
+  }
+}

package/src/globals/shared/cm.ts

@@ -0,0 +1,158 @@
+import type { JsPbMessageClass, OperationResponse } from '../steam-client/shared';
+import type { CBaseProtoBufMsg, CCallbackList, Unsubscribable } from './interfaces';
+import type { CSteamID } from './steamid';
+
+type Callback_t = (msg: CBaseProtoBufMsg) => void;
+
+/**
+ * @see https://github.com/SteamDatabase/SteamTracking/blob/master/Protobufs/enums_clientserver.proto#L4
+ */
+export type EMsg_t = number;
+
+interface ReportErrorOptions {
+  cCallsitesToIgnore: number;
+  bIncludeMessageInIdentifier: boolean;
+  error: Error;
+  strComponentStack: string;
+}
+
+interface ReportErrorResult {
+  identifier: string;
+  identifierHash: string;
+  message: string[];
+}
+
+interface ErrorReportingStore {
+  m_bEnabled: boolean;
+  m_bInitialized: boolean;
+  m_bReportingPaused: boolean;
+  m_fnGetReportingInterval: () => number;
+  m_rgErrorQueue: Error[];
+  m_sendTimer: number | null;
+  m_strProduct: string;
+  m_strVersion: string;
+  m_transport: ServiceTransport;
+
+  BIsBlacklisted(error: Error): boolean;
+  QueueSend(error: Error): void;
+  ReportError(error: Error, options?: Partial<ReportErrorOptions>): Promise<ReportErrorResult | null>;
+  SendErrorReport(error: Error): void;
+  SendErrorReports(errors: Error[]): void;
+}
+
+export interface ServiceTransport {
+  MakeReady(): Promise<OperationResponse>;
+  SendMsg(target_job_name: string, msg: CBaseProtoBufMsg, protoMsg: any): CBaseProtoBufMsg;
+  SendNotification(target_job_name: string, msg: CBaseProtoBufMsg): boolean;
+}
+
+interface ServiceHandler<T extends Callback_t> {
+  /**
+   * Invokes the callback.
+   */
+  invoke: T;
+
+  msgClass: JsPbMessageClass;
+}
+
+interface ServiceMethod {
+  /**
+   * e.g. `"PlayerClient.NotifyCommunityPreferencesChanged#1"`.
+   */
+  name: string;
+
+  /**
+   * Protobuf message class.
+   */
+  request: any;
+}
+
+interface ServiceRegistrar<T extends Callback_t> {
+  /**
+   * Invokes the callback.
+   */
+  invoke: T;
+
+  /**
+   * Unregisters the callback.
+   */
+  unregister(): void;
+}
+
+interface MessageHandlers {
+  m_mapCallbacks: Map<EMsg_t, ServiceHandler<any>[]>;
+  m_mapServiceMethodHandlers: Map<string, ServiceHandler<any>[]>;
+  m_rgRegisteredEMsgs: EMsg_t[];
+  m_rgRegisteredServiceMethodHandlers: string[];
+
+  AddCallback<T extends Callback_t>(msg: EMsg_t, msgClass: any | undefined, callback: T): ServiceRegistrar<T>;
+  AddServiceMethodHandler<T extends Callback_t>(method: ServiceMethod, callback: T): ServiceRegistrar<T>;
+  AddServiceNotificationHandler<T extends Callback_t>(msg: EMsg_t, callback: T): ServiceRegistrar<T>;
+  DispatchMsgToHandlers(msg: CBaseProtoBufMsg, callback: (msg: CBaseProtoBufMsg) => void): boolean;
+  InstallErrorReportingStore(store: ErrorReportingStore): void;
+  RegisterBaseEMessageHandler<T extends Callback_t>(msg: EMsg_t, callback: T): ServiceRegistrar<T>;
+  RegisterEMessageAction<T extends Callback_t>(
+    msg: EMsg_t,
+    msgClass: any | undefined,
+    callback: T,
+  ): ServiceRegistrar<T>;
+  RegisterEMessageHandler<T extends Callback_t>(
+    msg: EMsg_t,
+    msgClass: any | undefined,
+    callback: T,
+  ): ServiceRegistrar<T>;
+  RegisterServiceMethodHandler<T extends Callback_t>(msg: EMsg_t, callback: T): ServiceRegistrar<T>;
+  RegisterServiceMethodHandlerAction<T extends Callback_t>(msg: EMsg_t, callback: T): ServiceRegistrar<T>;
+  RegisterServiceNotificationHandler<T extends Callback_t>(msg: EMsg_t, callback: T): ServiceRegistrar<T>;
+  RegisterServiceNotificationHandlerAction<T extends Callback_t>(msg: EMsg_t, callback: T): ServiceRegistrar<T>;
+}
+
+interface CMInterfaceCallbacks {
+  m_ClientConnectionCallbacks: CCallbackList;
+  m_bRunOnce: boolean;
+  m_mapServerTypeCallbacks: Map<number, CCallbackList>;
+
+  AddCallback(callback: () => void, t?: number): Unsubscribable;
+  RunAllCallbacks(e: number[], ...args: any[]): void;
+  RunCallbacks(e: number | undefined, ...args: any[]): void;
+}
+
+// CMInterfaceSharedClientConnection
+export interface CMInterface {
+  ClientServersAvailableHandler: ServiceRegistrar<any>;
+  m_ServiceTransport: ServiceTransport;
+  m_bCompletedInitialConnect: boolean;
+  m_bConnected: boolean;
+  m_bConnectionFailed: boolean;
+  m_bForceDisconnect: boolean;
+  m_bLoggedOn: boolean;
+  m_bPerformedInitialClockAdjustment: boolean;
+  m_bShouldChangePersonaStatusOnDisconnect: boolean;
+  m_callbacksOnConnect: CMInterfaceCallbacks;
+  m_callbacksOnConnectOneTime: CMInterfaceCallbacks;
+  m_callbacksOnDisconnect: CMInterfaceCallbacks;
+  m_hEMsgRegistrationObserver: () => void;
+  m_hSharedConnection: number;
+  m_messageHandlers: MessageHandlers;
+  m_nPerfClockServerMSOffset: number;
+  m_nWallClockDriftMS: number;
+  // actually valve, not a callback
+  m_onConnect: Promise<void> | undefined;
+  m_rtReconnectThrottleExpiration: number;
+  m_rtReconnectThrottleStart: number;
+  m_setConnectedServers: Set<number>;
+  m_setEMsgHandlers: Set<EMsg_t>;
+  m_setServiceMethodHandlers: Set<string>;
+  m_steamid: CSteamID;
+  m_strIPCountry: string;
+  m_strPersonaName: string;
+  m_unAccountFlags: number;
+
+  ClearHeartbeatInterval(): void;
+  Connect(): Promise<void>;
+  Disconnect(): void;
+  ResetHeartbeatInterval(): void;
+  SendHeartbeat(): void;
+  SendInternal(msg: CBaseProtoBufMsg): boolean;
+  SendMsgAndAwaitResponse(param0: CBaseProtoBufMsg, param1: EMsg_t): CBaseProtoBufMsg;
+}

package/src/globals/shared/enums.ts

@@ -0,0 +1,97 @@
+export enum EBrowserType {
+  /**
+   * No window is created (like SharedJSContext).
+   */
+  OffScreen,
+  OpenVROverlay,
+  OpenVROverlay_Dashboard,
+  /**
+   * A normal window.
+   */
+  DirectHWND,
+  /**
+   * A borderless window.
+   */
+  DirectHWND_Borderless,
+  /**
+   * An initially hidden window.
+   * May be shown with {@link SteamClient.Window.ShowWindow}.
+   */
+  DirectHWND_Hidden,
+  ChildHWNDNative,
+  Offscreen_SteamUI = 12,
+  OpenVROverlay_Subview,
+}
+
+export enum EPopupCreationFlags {
+  None,
+  Minimized = 1 << 0,
+  Hidden = 1 << 1,
+  TooltipHint = 1 << 2,
+  NoTaskbarIcon = 1 << 3,
+  Resizable = 1 << 4,
+  ScalePosition = 1 << 5,
+  ScaleSize = 1 << 6,
+  Maximized = 1 << 7,
+  Composited = 1 << 8,
+  NotFocusable = 1 << 9,
+  FullScreen = 1 << 10,
+  Fullscreen_Exclusive = 1 << 11,
+  ApplyBrowserScaleToDimensions = 1 << 12,
+  AlwaysOnTop = 1 << 13,
+  NoWindowShadow = 1 << 14,
+  NoMinimize = 1 << 15,
+  PopUpMenuHint = 1 << 16,
+  IgnoreSavedSize = 1 << 17,
+  NoRoundedCorners = 1 << 18,
+  ForceRoundedCorners = 1 << 19,
+  OverrideRedirect = 1 << 20,
+  IgnoreSteamDisplayScale = 1 << 21,
+  TransparentParentWindow = 1 << 22,
+  DisableDPIScale = 1 << 23,
+  ForceBrowserVisible = 1 << 24,
+}
+
+export enum ESteamRealm {
+  Unknown,
+  Global,
+  China,
+}
+
+export enum ESteamUISound {
+  LaunchGame,
+  FriendMessage,
+  ChatMention,
+  ChatMessage,
+  ToastMessage,
+  ToastAchievement,
+  ToastMisc,
+  ToastMiscShort,
+  FriendOnline,
+  FriendInGame,
+  VolSound,
+  ShowModal,
+  HideModal,
+  IntoGameDetail,
+  OutOfGameDetail,
+  PagedNavigation,
+  ToggleOn,
+  ToggleOff,
+  SliderUp,
+  SliderDown,
+  ChangeTabs,
+  DefaultOk,
+  OpenSideMenu,
+  CloseSideMenu,
+  BasicNav,
+  FailedNav,
+  Typing,
+  TimerExpired,
+  Screenshot,
+}
+
+export enum EUIMode {
+  Unknown = -1,
+  GamePad = 4,
+  Desktop = 7,
+}

package/src/globals/shared/history.ts

@@ -0,0 +1,15 @@
+// Minimal types from https://www.npmjs.com/package/history/v/5.0.0
+
+export declare enum Action {
+  Pop = 'POP',
+  Push = 'PUSH',
+  Replace = 'REPLACE',
+}
+
+export interface Location<S extends object> {
+  key: string;
+  pathname: string;
+  search: string;
+  state: S;
+  hash: string;
+}

package/src/globals/shared/index.ts

@@ -0,0 +1,5 @@
+export * from './cm';
+export * from './enums';
+export * from './interfaces';
+export * from './navigation';
+export * from './steamid';