@overwolf/ow-electron-packages-types 0.0.11 → 0.0.13

package/game-list.ts

@@ -1,52 +1,80 @@
-// game list version: 6
-
-export const enum kLaunchersIds {
-  LOLLauncher = 10902,
-}
-
-export const enum kGameIds {
-  AmericanTruckSimulator = 10874,
-  ApexLegends = 21566,
-  ARKSurvivalAscended = 23476,
-  ARKSurvivalEvolved = 10778,
-  BaldursGateIII = 22088,
-  CallOfDutyModernWarfareIII = 23424,
-  CS2 = 22730,
-  DiabloIV = 22700,
-  Dota2 = 7314,
-  ELDENRING = 21866,
-  Enshrouded = 23946,
-  EscapeFromTarkov = 21634,
-  EuroTruckSim2 = 8584,
-  FinalFantasyXIVOnline = 6350,
-  Fortnite = 21216,
-  GenshinImpact = 21656,
-  GTAV = 1076,
-  HearthstoneHeroesofWarcraft = 9898,
-  HELLDIVERS2 = 24000,
-  LeagueofLegends = 5426,
-  LeagueofLegendsPBE = 22848,
-  LegendsofRuneterra = 21620,
-  LethalCompany = 23522,
-  LostArk = 21864,
-  Minecraft = 8032,
-  MinecraftBedrock = 22176,
-  NewWorld = 21816,
-  Osu = 3683,
-  Overwatch = 10844,
-  Palworld = 23944,
-  PathofExile = 7212,
-  PUBG = 10906,
-  Rainbow6Siege = 10826,
-  Roblox = 4688,
-  RocketLeague = 10798,
-  Rust = 10156,
-  TeamfightTactics = 21570,
-  TheSims4 = 10540,
-  Valheim = 21668,
-  VALORANT = 21640,
-  Warframe = 8954,
-  WoW = 765,
-  WoWClassic = 21630,
-}
-
+// game list version: 10
+
+export const enum kLaunchersIds {
+  LOLLauncher = 10902,
+}
+
+export const enum kGameIds {
+  AmericanTruckSimulator = 10874,
+  ApexLegends = 21566,
+  ARKSurvivalAscended = 23476,
+  ARKSurvivalEvolved = 10778,
+  BaldursGateIII = 22088,
+  BlackMythWukong = 24504,
+  CallofDutyModernWarfareII = 22328,
+  CallOfDutyModernWarfareIII = 23424,
+  CallofDutyVanguard = 21876,
+  ContentWarning = 24110,
+  CS2 = 22730,
+  DarkandDarker = 22584,
+  Deadlock = 24482,
+  Diablo2Resurrected = 21848,
+  DiabloIV = 22700,
+  Dota2 = 7314,
+  ELDENRING = 21866,
+  Enshrouded = 23946,
+  EscapeFromTarkov = 21634,
+  EternalReturnBlackSurvival = 21672,
+  EuroTruckSim2 = 8584,
+  FinalFantasyXIVOnline = 6350,
+  Fortnite = 21216,
+  GenshinImpact = 21656,
+  GTAV = 1076,
+  HadesII = 24218,
+  HaloInfinite = 21854,
+  HearthstoneHeroesofWarcraft = 9898,
+  HELLDIVERS2 = 24000,
+  HeroesoftheStorm = 10624,
+  HonkaiStarRail = 22804,
+  LeagueofLegends = 5426,
+  LeagueofLegendsPBE = 22848,
+  LegendsofRuneterra = 21620,
+  LethalCompany = 23522,
+  LostArk = 21864,
+  MagictheGatheringArena = 21308,
+  ManorLords = 24176,
+  Minecraft = 8032,
+  MinecraftBedrock = 22176,
+  NewWorld = 21816,
+  OnceHuman = 23930,
+  Osu = 3683,
+  Overwatch = 10844,
+  Palworld = 23944,
+  PathofExile = 7212,
+  PUBG = 10906,
+  Rainbow6Siege = 10826,
+  Roblox = 4688,
+  RocketLeague = 10798,
+  Rust = 10156,
+  SonsoftheForest = 22638,
+  SpectreDivide = 24484,
+  SplitgateArenaWarfare = 21404,
+  StarCraftII = 5855,
+  Starfield = 23222,
+  Stormgate = 23818,
+  TeamfightTactics = 21570,
+  TheFinals = 23478,
+  TheFirstDescendant = 24360,
+  TheSims4 = 10540,
+  Valheim = 21668,
+  VALORANT = 21640,
+  Warframe = 8954,
+  Warhammer40000SpaceMarine2 = 24548,
+  WorldOfTanks = 6365,
+  WorldofWarships = 10746,
+  WoW = 765,
+  WoWClassic = 21630,
+  WutheringWaves = 24300,
+  XDefiant = 22994,
+}
+

package/gep-supported-games.ts

@@ -1,8 +1,8 @@
-export const enum kGepSupportedGameIds {
-  TeamfightTactics = 21570,
-  RocketLeague = 10798,
-  LeagueofLegends = 5426,
-  LeagueofLegendsPBE = 22848,
-  WoW = 765,
-  FinalFantasyXIVOnline = 6350,
-}
+export const enum kGepSupportedGameIds {
+  TeamfightTactics = 21570,
+  RocketLeague = 10798,
+  LeagueofLegends = 5426,
+  LeagueofLegendsPBE = 22848,
+  WoW = 765,
+  FinalFantasyXIVOnline = 6350,
+}

package/overlay.d.ts

@@ -1,332 +1,325 @@
-import {
-  BrowserWindow,
-  BrowserWindowConstructorOptions,
-  Size,
-  WebContents,
-} from 'electron';
-import { EventEmitter } from 'events';
-
-export declare type GameProcessInfo = {
-  pid?: number;
-
-  fullPath: string;
-
-  commandLine?: string;
-
-  is32Bit?: boolean;
-
-  isElevated?: boolean;
-};
-
-export declare type GameInfo = {
-  id: number;
-
-  classId: number;
-
-  name: string;
-
-  supported: boolean;
-
-  processInfo?: GameProcessInfo;
-
-  flags?: any;
-
-  type: 'Game' | 'Launcher';
-};
-
-export interface GamesFilter {
-  all?: boolean;
-
-  includeUnsupported?: boolean;
-
-  gamesIds: number[];
-}
-
-/**
- * Input pass through
- */
-export const enum PassthroughType {
-  /**
-   *  Window will handle input and block from game (Default)
-   */
-  NoPassThrough = 0,
-  /**
-   *  window will not handle any input
-   */
-  PassThrough,
-}
-
-/**
- * Overlay rendering Z-Order
- */
-export const enum ZOrderType {
-  Default,
-  TopMost,
-  BottomMost,
-}
-
-/** Overlay ow-electron options */
-export interface OverlayOptions {
-  passthrough?: PassthroughType;
-
-  zOrder?: ZOrderType;
-}
-
-export interface OverlayWindowOptions
-  extends BrowserWindowConstructorOptions,
-    OverlayOptions {
-  /**
-   * unique name (id)
-   */
-  name: string;
-
-  /** not supported yet */
-  enableHWAcceleration?: boolean;
-}
-
-export interface IOverlayHotkey {
-  name: string;
-  keyCode: number;
-  modifiers?: {
-    alt?: boolean;
-    ctrl?: boolean;
-    shift?: boolean;
-    custom?: number; // custom modifier (i.e key code)
-    meta?: boolean;
-  };
-  passthrough?: boolean;
-}
-
-export interface GameLaunchEvent {
-  inject: () => void;
-}
-
-/**
- * TBD
- */
-export interface OverlayBrowserWindow {
-  window: BrowserWindow;
-
-  readonly overlayOptions: OverlayOptions;
-
-  readonly name: string;
-
-  readonly id: number;
-}
-
-export interface InjectionError {
-  error: string;
-}
-
-export interface GameWindowInfo {
-  size: Size;
-  nativeHandle: number;
-  focused: boolean;
-  graphics: 'd3d9' | 'd3d12' | 'd3d11' | string | undefined;
-}
-
-export interface GameInputInterception {
-  /**
-   * Can the Overlay window process input
-   * Related to `mixed mode when available` and/or `exclusive only` games
-   */
-  readonly canInterceptInput?: boolean;
-  /**
-   * Overlay has full input control, blocking input from the game
-   */
-  readonly exclusiveMode?: boolean;
-}
-
-export interface ActiveGameInfo {
-  readonly gameInfo: GameInfo;
-  readonly gameWindowInfo: GameWindowInfo;
-  readonly gameInputInfo: GameInputInterception;
-}
-
-export declare type GameWindowUpdateReason = undefined | 'resized' | 'focus';
-export declare type HotkeyState = 'pressed' | 'released';
-
-export declare type HotkeyCallback = (
-  hotKey: IOverlayHotkey,
-  state: HotkeyState
-) => void;
-
-export interface ExclusiveInputOptions {
-  /**
-   * Exclusive mode FadeIn / FadeOut duration in miliseconds.
-   *
-   * Use `0` to disable.
-   * @default 100
-   */
-  fadeAnimateInterval?: number;
-
-  /**
-   * Exclusive mode overlay background color.
-   * Use `rgba(0,0,0,0)` to disable background color
-   *
-   * Note: Using an invalid color format (e.g: not `rgba(...)`) will throw an Error.
-   * @default 'rgba(12, 12, 12, , 0.5)'
-   */
-  backgroundColor?: string;
-}
-
-export interface IOverlayHotkeys {
-  /**
-   * Register new hotkey.
-   * Throw error when hotkey already exits, or callback is missing
-   */
-  register(hotKey: IOverlayHotkey, callback: HotkeyCallback): void;
-
-  /**
-   * Update existing hotkey.
-   * Return false if hotkey doesn't exits
-   */
-  update(hotKey: IOverlayHotkey): boolean;
-
-  /**
-   * Clear all hotkeys
-   */
-  unregisterAll(): void;
-
-  /**
-   * Remove hotkey by name.
-   * Return false if doesn't exits.
-   */
-  unregister(name: string): boolean;
-
-  /**
-   * Get all active hotkeys.
-   */
-  all(): IOverlayHotkey[];
-}
-
-export interface IOverwolfOverlayApi extends EventEmitter {
-  /**
-   *  Create new Overlay window
-   */
-  createWindow(options: OverlayWindowOptions): Promise<OverlayBrowserWindow>;
-
-  /**
-   * Game launch registration
-   */
-  registerGames(filter: GamesFilter);
-
-  /**
-   *  injected Game inforamation
-   */
-  getActiveGameInfo(): ActiveGameInfo | undefined;
-
-  /**
-   * Get all open overlay windows
-   */
-  getAllWindows(): OverlayBrowserWindow[];
-
-  /**
-   * The overlay window that owns the given `webContents` or `null` if the contents are not
-   * owned by a window.
-   */
-  fromWebContents(webContents: WebContents): OverlayBrowserWindow | null;
-
-  /**
-   * The overlay window that owns the given `BrowserWindow` or `null` if the browerWindow are not
-   * owned by a window.
-   */
-  fromBrowserWindow(browserWindow: BrowserWindow): OverlayBrowserWindow | null;
-
-  /**
-   * Overlay hotkeys api
-   */
-  hotkeys: IOverlayHotkeys;
-
-  /**
-   * Enters Overlay "Exclusive Mode" - meaning, the game no longer receives user
-   * input (all input will go to the overlay windows).
-   * 
-   * The `game-input-exclusive-mode-changed` event fires if exclusive mode was entered.
-   *
-   * NOTE: This is only supported when getActiveGameInfo returns
-   * `"canInterceptInput" == false`. Calling this function when unsupported will
-   * be ignored and will not throw an exception.
-   */
-  enterExclusiveMode(options?: ExclusiveInputOptions): void;
-
-  /**
-   * Exits Overlay Exclusive Mode, returning input control to the game.
-   *
-   * The `game-input-exclusive-mode-changed` event fires when exiting exclusive mode.
-   */
-  exitExclusiveMode(): void;
-
-  /**
-   *TODO(bFox) :replace ...args
-   */
-  on(eventName: 'error', listener: (...args: any[]) => void): this;
-
-  /**
-   * Fired when registered game is detected
-   * call `event.inject()` to enable overlay for the game.
-   */
-  on(
-    eventName: 'game-launched',
-    listener: (event: GameLaunchEvent, gameInfo: GameInfo) => void
-  ): this;
-
-  /**
-   * Fired on registered game process terminated.
-   */
-  on(
-    eventName: 'game-exit',
-    listener: (gameInfo: GameInfo, wasInjected: boolean) => void
-  ): this;
-
-  /**
-   * Fired when overlay is ready for game.
-   *
-   */
-  on(eventName: 'game-injected', listener: (gameInfo: GameInfo) => void): this;
-
-  /**
-   * TODO(bFox) :replace ...args
-   */
-  on(
-    eventName: 'game-injection-error',
-    listener: (gameInfo: GameInfo, error: string, ...args: any[]) => void
-  ): this;
-
-  /** */
-  on(
-    eventName: 'game-focus-changed',
-    listener: (
-      window: GameWindowInfo,
-      gameInfo: GameInfo,
-      focus: boolean
-    ) => void
-  ): this;
-
-  /** */
-  on(
-    eventName: 'game-window-changed',
-    listener: (
-      window: GameWindowInfo,
-      gameInfo: GameInfo,
-      reason?: GameWindowUpdateReason
-    ) => void
-  ): this;
-
-  /**
-   * Fires when the game input interception state changes
-   */
-  on(
-    eventName: 'game-input-interception-changed',
-    listener: (info: GameInputInterception) => void
-  ): this;
-
-  /**
-   * Fires when Overlay input Exclusive Mode changes.
-   * Only relevant to `mixed mode when available` and/or `exclusive only` games
-   */
-  on(
-    eventName: 'game-input-exclusive-mode-changed',
-    listener: (info: GameInputInterception) => void
-  ): this;
-}
+import {
+  BrowserWindow,
+  BrowserWindowConstructorOptions,
+  Size,
+  WebContents,
+} from 'electron';
+import { EventEmitter } from 'events';
+
+export declare type GameProcessInfo = {
+  pid?: number;
+
+  fullPath: string;
+
+  commandLine?: string;
+
+  is32Bit?: boolean;
+
+  isElevated?: boolean;
+};
+
+export declare type GameInfo = {
+  id: number;
+
+  classId: number;
+
+  name: string;
+
+  supported: boolean;
+
+  processInfo?: GameProcessInfo;
+
+  flags?: any;
+
+  type: 'Game' | 'Launcher';
+};
+
+export interface GamesFilter {
+  all?: boolean;
+
+  includeUnsupported?: boolean;
+
+  gamesIds: number[];
+}
+
+/**
+ * Input pass through
+ * 'noPassThrough':  Window will handle input and block from game (Default)
+ * 'passThrough':  window will not handle any input
+ * 'passThroughAndNotify': Window will handle input and also pass it to the game.
+ */
+export type PassthroughType = "noPassThrough" | "passThrough" | "passThroughAndNotify";
+
+/**
+ * Overlay rendering Z-Order
+ */
+export type ZOrderType = "default" | "topMost" | "bottomMost";
+
+/** Overlay ow-electron options */
+export interface OverlayOptions {
+  passthrough?: PassthroughType | number;
+
+  zOrder?: ZOrderType | number; // backwards compatible
+}
+
+export interface OverlayWindowOptions
+  extends BrowserWindowConstructorOptions,
+    OverlayOptions {
+  /**
+   * unique name (id)
+   */
+  name: string;
+
+  /** not supported yet */
+  enableHWAcceleration?: boolean;
+
+  /** */
+  enableIsolation?:boolean;
+}
+
+export interface IOverlayHotkey {
+  name: string;
+  keyCode: number;
+  modifiers?: {
+    alt?: boolean;
+    ctrl?: boolean;
+    shift?: boolean;
+    custom?: number; // custom modifier (i.e key code)
+    meta?: boolean;
+  };
+  passthrough?: boolean;
+}
+
+export interface GameLaunchEvent {
+  inject: () => void;
+}
+
+/**
+ * TBD
+ */
+export interface OverlayBrowserWindow {
+  window: BrowserWindow;
+
+  readonly overlayOptions: OverlayOptions;
+
+  readonly name: string;
+
+  readonly id: number;
+}
+
+export interface InjectionError {
+  error: string;
+}
+
+export interface GameWindowInfo {
+  size: Size;
+  nativeHandle: number;
+  focused: boolean;
+  graphics: 'd3d9' | 'd3d12' | 'd3d11' | string | undefined;
+}
+
+export interface GameInputInterception {
+  /**
+   * Can the Overlay window process input
+   * Related to `mixed mode when available` and/or `exclusive only` games
+   */
+  readonly canInterceptInput?: boolean;
+  /**
+   * Overlay has full input control, blocking input from the game
+   */
+  readonly exclusiveMode?: boolean;
+}
+
+export interface ActiveGameInfo {
+  readonly gameInfo: GameInfo;
+  readonly gameWindowInfo: GameWindowInfo;
+  readonly gameInputInfo: GameInputInterception;
+}
+
+export declare type GameWindowUpdateReason = undefined | 'resized' | 'focus';
+export declare type HotkeyState = 'pressed' | 'released';
+
+export declare type HotkeyCallback = (
+  hotKey: IOverlayHotkey,
+  state: HotkeyState
+) => void;
+
+export interface ExclusiveInputOptions {
+  /**
+   * Exclusive mode FadeIn / FadeOut duration in miliseconds.
+   *
+   * Use `0` to disable.
+   * @default 100
+   */
+  fadeAnimateInterval?: number;
+
+  /**
+   * Exclusive mode overlay background color.
+   * Use `rgba(0,0,0,0)` to disable background color
+   *
+   * Note: Using an invalid color format (e.g: not `rgba(...)`) will throw an Error.
+   * @default 'rgba(12, 12, 12, , 0.5)'
+   */
+  backgroundColor?: string;
+}
+
+export interface IOverlayHotkeys {
+  /**
+   * Register new hotkey.
+   * Throw error when hotkey already exits, or callback is missing
+   */
+  register(hotKey: IOverlayHotkey, callback: HotkeyCallback): void;
+
+  /**
+   * Update existing hotkey.
+   * Return false if hotkey doesn't exits
+   */
+  update(hotKey: IOverlayHotkey): boolean;
+
+  /**
+   * Clear all hotkeys
+   */
+  unregisterAll(): void;
+
+  /**
+   * Remove hotkey by name.
+   * Return false if doesn't exits.
+   */
+  unregister(name: string): boolean;
+
+  /**
+   * Get all active hotkeys.
+   */
+  all(): IOverlayHotkey[];
+}
+
+export interface IOverwolfOverlayApi extends EventEmitter {
+  /**
+   *  Create new Overlay window
+   */
+  createWindow(options: OverlayWindowOptions): Promise<OverlayBrowserWindow>;
+
+  /**
+   * Game launch registration
+   */
+  registerGames(filter: GamesFilter);
+
+  /**
+   *  injected Game inforamation
+   */
+  getActiveGameInfo(): ActiveGameInfo | undefined;
+
+  /**
+   * Get all open overlay windows
+   */
+  getAllWindows(): OverlayBrowserWindow[];
+
+  /**
+   * The overlay window that owns the given `webContents` or `null` if the contents are not
+   * owned by a window.
+   */
+  fromWebContents(webContents: WebContents): OverlayBrowserWindow | null;
+
+  /**
+   * The overlay window that owns the given `BrowserWindow` or `null` if the browerWindow are not
+   * owned by a window.
+   */
+  fromBrowserWindow(browserWindow: BrowserWindow): OverlayBrowserWindow | null;
+
+  /**
+   * Overlay hotkeys api
+   */
+  hotkeys: IOverlayHotkeys;
+
+  /**
+   * Enters Overlay "Exclusive Mode" - meaning, the game no longer receives user
+   * input (all input will go to the overlay windows).
+   * 
+   * The `game-input-exclusive-mode-changed` event fires if exclusive mode was entered.
+   *
+   * NOTE: This is only supported when getActiveGameInfo returns
+   * `"canInterceptInput" == false`. Calling this function when unsupported will
+   * be ignored and will not throw an exception.
+   */
+  enterExclusiveMode(options?: ExclusiveInputOptions): void;
+
+  /**
+   * Exits Overlay Exclusive Mode, returning input control to the game.
+   *
+   * The `game-input-exclusive-mode-changed` event fires when exiting exclusive mode.
+   */
+  exitExclusiveMode(): void;
+
+  /**
+   *TODO(bFox) :replace ...args
+   */
+  on(eventName: 'error', listener: (...args: any[]) => void): this;
+
+  /**
+   * Fired when registered game is detected
+   * call `event.inject()` to enable overlay for the game.
+   */
+  on(
+    eventName: 'game-launched',
+    listener: (event: GameLaunchEvent, gameInfo: GameInfo) => void
+  ): this;
+
+  /**
+   * Fired on registered game process terminated.
+   */
+  on(
+    eventName: 'game-exit',
+    listener: (gameInfo: GameInfo, wasInjected: boolean) => void
+  ): this;
+
+  /**
+   * Fired when overlay is ready for game.
+   *
+   */
+  on(eventName: 'game-injected', listener: (gameInfo: GameInfo) => void): this;
+
+  /**
+   * TODO(bFox) :replace ...args
+   */
+  on(
+    eventName: 'game-injection-error',
+    listener: (gameInfo: GameInfo, error: string, ...args: any[]) => void
+  ): this;
+
+  /** */
+  on(
+    eventName: 'game-focus-changed',
+    listener: (
+      window: GameWindowInfo,
+      gameInfo: GameInfo,
+      focus: boolean
+    ) => void
+  ): this;
+
+  /** */
+  on(
+    eventName: 'game-window-changed',
+    listener: (
+      window: GameWindowInfo,
+      gameInfo: GameInfo,
+      reason?: GameWindowUpdateReason
+    ) => void
+  ): this;
+
+  /**
+   * Fires when the game input interception state changes
+   */
+  on(
+    eventName: 'game-input-interception-changed',
+    listener: (info: GameInputInterception) => void
+  ): this;
+
+  /**
+   * Fires when Overlay input Exclusive Mode changes.
+   * Only relevant to `mixed mode when available` and/or `exclusive only` games
+   */
+  on(
+    eventName: 'game-input-exclusive-mode-changed',
+    listener: (info: GameInputInterception) => void
+  ): this;
+}

package/package.json

@@ -1,23 +1,23 @@
-{
-    "name": "@overwolf/ow-electron-packages-types",
-    "version": "0.0.11",
-    "description": "Type definition file for autocompletion and documentation purposes for ow-electron packages",
-    "license": "MIT",
-    "types": "overlay.d.ts",
-    "keywords": [
-        "types",
-        "npm",
-        "package",
-        "overwolf",
-        "ow-electron",
-        "overlay",
-        "game-list"
-    ],
-    "devDependencies": {
-        "@overwolf/ow-electron": "^22.3.3"
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/overwolf/ow-electron-packages-types"
-    }
-}
+{
+    "name": "@overwolf/ow-electron-packages-types",
+    "version": "0.0.13",
+    "description": "Type definition file for autocompletion and documentation purposes for ow-electron packages",
+    "license": "MIT",
+    "types": "overlay.d.ts",
+    "keywords": [
+        "types",
+        "npm",
+        "package",
+        "overwolf",
+        "ow-electron",
+        "overlay",
+        "game-list"
+    ],
+    "devDependencies": {
+        "@overwolf/ow-electron": "latest"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/overwolf/ow-electron-packages-types"
+    }
+}