@overwolf/ow-electron-packages-types 1.0.0-beta.3 → 1.0.0-beta.5

package/game-list.d.ts

@@ -1,4 +1,4 @@
-// game list version: 39
+// game list version: 40
 
 export const enum kLaunchersIds {
   LOLLauncher = 10902,
@@ -3249,6 +3249,7 @@ export const enum kGameIds {
   WorldofGoo = 4274,
   WorldofGoo2 = 25720,
   WORLDOFHORROR = 23460,
+  WorldOfTanks = 6365,
   WorldofTanksBlitz = 10896,
   WorldofWarships = 10746,
   WorldofZoo = 5504,
@@ -3328,5 +3329,4 @@ export const enum kGameIds {
   Zort = 24928,
   Zortch = 25010,
   Zula = 10768,
-}
-
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@overwolf/ow-electron-packages-types",
-    "version": "1.0.0-beta.3",
+    "version": "1.0.0-beta.5",
     "description": "Type definition file for autocompletion and documentation purposes for ow-electron packages",
     "license": "MIT",
     "types": "types.d.ts",

package/types.d.ts

@@ -1,18 +1,18 @@
-import { overwolf } from '@overwolf/ow-electron';
-import {
-  BrowserWindow,
-  BrowserWindowConstructorOptions,
-  Size,
-  WebContents,
-  Display,
-  Rectangle
-} from 'electron';
-
-import { EventEmitter } from 'events';
-
-// -----------------------------------------------------------------------------
-
-// --- modules\utility.d.ts ---
+import { overwolf } from '@overwolf/ow-electron';
+import {
+  BrowserWindow,
+  BrowserWindowConstructorOptions,
+  Size,
+  WebContents,
+  Display,
+  Rectangle
+} from 'electron';
+
+import { EventEmitter } from 'events';
+
+// -----------------------------------------------------------------------------
+
+// --- modules\utility.d.ts ---
 /**
  * @packageDocumentation
  *
@@ -79,9 +79,9 @@ interface IOverwolfUtilityApi {
    */
   on(eventName: 'game-exit', listener: (gameInfo: GameInfo) => void): this;
 }
-
-
-// --- modules\recorder.d.ts ---
+
+
+// --- modules\recorder.d.ts ---
 /**
  * 
  * The Overwolf Electron recording APIs integrate recording into the Overwolf Electron framework allowing you to record both audio and video.
@@ -1972,6 +1972,135 @@ interface AudioGeneralSettings {
    */
   lowLatencyAudioBuffering?: boolean;
 }
+/**
+ * Defines the alignment options specifying a position by using [Vertical][Horizontal]
+ * (e.g., 'TopLeft', 'Center', 'BottomRight'). Typically used for positioning
+ * UI elements, popovers, or text blocks.
+ */
+export declare type AlignmentOptions =
+  | 'TopLeft'
+  | 'TopCenter'
+  | 'TopRight'
+  | 'CenterLeft'
+  | 'Center'
+  | 'CenterRight'
+  | 'BottomLeft'  
+  | 'BottomCenter'
+  | 'BottomRight';
+
+/**
+ * Defines the type of bounding or scaling applied to an element's dimensions
+ * within a container.
+ *
+ * Typically used to control how content (like an image or video)
+ * is resized to fit or fill a specific area.
+ */
+export declare type BoundsType =
+  | 'None'
+  | 'Stretch'
+  | 'ScaleInner'
+  | 'ScaleOuter'
+  | 'ScaleToWidth'
+  | 'ScaleToHeight'
+  | 'MaxOnly';
+
+/**
+ * Options for transforming and positioning a source element (e.g. an image or video) within an output container or scene.
+ * 
+ * Typically used to control how content is translated, scaled, rotated, aligned,
+ * and cropped within a visual presentation area.
+ */
+export interface SourceTransformOptions {
+  /**
+   * Position X in pixels. Default is 0.
+   */
+  positionX?: number;
+
+  /**
+   * Position Y in pixels. Default is 0.
+   */
+  positionY?: number;
+
+  /**
+   * Rotation in degrees (-360.0 to 360.0). Default is 0.
+   */
+  rotation?: number;
+
+  /**
+   * Size Width in pixels.
+   */
+  sizeWidth?: number;
+
+  /**
+   * Size Height in pixels.
+   */
+  sizeHeight?: number;
+
+  /**
+   * Alignment of the source within the output.
+   * The alignment is relative to the top-left corner of the output.
+   *
+   * Default is TopLeft.
+   */
+  alignment?: AlignmentOptions;
+
+  /**
+   * Defines a bounding box for the source within the output.
+   *
+   * Changing the bounds type or alignment only has an effect
+   * if a bounds width or height is specified.
+   *
+   * Type of bounds to apply.
+   * Default is None.
+   */
+  boundsType?: BoundsType;
+
+  /**
+   * Alignment of the source within the bounding box.
+   * 
+   * Relevant only when bounds width or height are defined.
+   * Default is Center.
+   */
+  boundsAlignment?: AlignmentOptions;
+
+  /**
+   * Bounding box width in pixels.
+   */
+  boundsWidth?: number;
+
+  /**
+   * Bounding box height in pixels.
+   */
+  boundsHeight?: number;
+
+  /**
+   * Crop to bounds. Default is False.
+   */
+  cropToBounds?: boolean;
+
+  /**
+   * Crop options in pixels. Default is no crop.
+   */
+  cropLeft?: number;
+  cropRight?: number;
+  cropTop?: number;
+  cropBottom?: number;
+}
+
+/**
+ * Defines a complete transformation operation to be applied to a specific source element.
+ *
+ * Typically used on a target source by its name with the full set of
+ * transformation and positioning properties it should adopt.
+ */
+export interface SourceTransform {
+  /**
+   * Source name to update.
+   */
+  readonly sourceName: string;
+
+  readonly transform: SourceTransformOptions;
+}
 
 /**
  * Configuration settings for how a capture source is rendered in the output video.
@@ -1980,15 +2109,25 @@ interface AudioGeneralSettings {
  * content relative to the output resolution.
  */
 interface CaptureSourceSettings {
+  /**
+   * Unique Source name (for easier identification).
+   */
+  name?: string;
+
   /**
    * Whether the capture source should be centered and stretched to fit the output video size.
    *
    * When set to `true`, the source will automatically scale and center itself to match
    * the output resolution, even if it requires stretching.
    *
-   * @default true
+   * @default true (if transform is not provided).
    */
   stretchToOutputSize?: boolean;
+
+  /**
+   * Transform options for the source.
+   */
+  transform?: SourceTransformOptions;
 }
 
 /**
@@ -2106,8 +2245,16 @@ interface WindowCaptureSourceSettings extends CaptureSourceSettings {
    * The name of the executable associated with the window to capture.
    *
    * This is typically the process name (e.g., `"notepad.exe"` or `"chrome.exe"`).
+   *
+   * Mandatory field when using Window Capture source.
+   * Optional when using Browser Window source.
    */
-  executable: string;
+  executable?: string;
+
+  /**
+   * The window title, if multiple windows of the same executable exist.
+   */
+  windowTitle?: string;
 
   /**
    * The capture method used to record the window.
@@ -2165,6 +2312,13 @@ interface CaptureSource {
    * capture method, and more, depending on the selected source type.
    */
   readonly properties: any;
+
+  /**
+   * Optional name for the capture source.
+   *
+   * Can be used later for setting transform properties.
+   */
+  readonly name?: string;
 }
 
 /**
@@ -2855,6 +3009,26 @@ interface CaptureSettingsBuilder extends CaptureSettings {
    */
   addGameSource(settings: GameCaptureSourceSettings): CaptureSettingsBuilder;
 
+  /**
+   * Add Window video capture source
+   * settings. Executable is mandatory.
+   * @param settings
+   */
+  addWindowSource(
+    settings: WindowCaptureSourceSettings
+  ): CaptureSettingsBuilder;
+
+  /**
+   * Add Electron window capture source
+   * settings. Executable is optional.
+   * @param browserWindow
+   * @param settings
+   */
+  addBrowserWindowSource(
+    browserWindow: BrowserWindow,
+    setting: WindowCaptureSourceSettings
+  ): CaptureSettingsBuilder;
+
   /**
    * Adds an audio device for capturing input or output audio.
    *
@@ -3014,24 +3188,6 @@ interface RecordingAppOptions {
    * Can be used to troubleshoot issues during recording.
    */
   enableDebugLogs?: boolean;
-
-  /**
-   * Additional command-line arguments to pass when launching the recorder.
-   * This can be used to customize the underlying OBS runtime behavior.
-   */
-  customCommandLineArgs?: string[];
-
-  /**
-   * Specifies a custom folder path to override the default OBS binaries used by the recorder.
-   * Useful for testing with a modified or custom OBS build.
-   */
-  overrideOBSFolder?: string;
-
-  /**
-   * Interval in milliseconds for emitting 'stats' events.
-   * Default is 2000 (2 seconds). Set to `0` to disable stats reporting.
-   */
-  statsInterval?: number;
 }
 
 
@@ -3609,22 +3765,22 @@ interface IOverwolfRecordingApi {
   options: RecordingAppOptions;
 
   /**
-   * Overlay package version
+   * Overlay package version.
    */
   readonly version: string;
 
   /**
-   * Path to ffmpeg executable
+   * Path to ffmpeg file.
    */
   readonly ffmpegPath: string;
 
   /**
-   * Path to bin folder
+   * Path to OBS binaries folder.
    */
   readonly binFolderPath: string;
 
   /**
-   * Is recording or replays active
+   * Checks if either recording or replays are currently active.
    */
   isActive(): Promise<boolean>;
 
@@ -3734,7 +3890,6 @@ interface IOverwolfRecordingApi {
    * Registers games to monitor and track for launch/exit detection.
    *
    * @param filter Filtering rules for which games to track.
-   * 
    */
   registerGames(filter: GamesFilter): void;
 
@@ -3745,9 +3900,17 @@ interface IOverwolfRecordingApi {
    * @see {@link AudioDeviceSettingsUpdateInfo}
    * @since 0.32.0
    */
-  updateAudioDevice(
-    device: AudioDeviceSettingsUpdateInfo
-  ): Promise<void>;
+  updateAudioDevice(device: AudioDeviceSettingsUpdateInfo): Promise<void>;
+
+  /**
+   * Set a source to transform.
+   * 
+   * Defines how the source will be rendered (for example, position, scale, crop, etc.).
+   * Throws an error if the source is not found or if the transform is invalid.
+   * 
+   * @param sourceTransform
+   */
+  setSourceTransform(sourceTransform: SourceTransform): Promise<void>;
 
   /** @event Fired when a registered game is launched. */
   on(eventName: 'game-launched', listener: (gameInfo: GameInfo) => void): this;
@@ -3779,9 +3942,9 @@ interface IOverwolfRecordingApi {
    */
   on(eventName: 'stats', listener: (args: RecorderStats) => void): this;
 }
-
-
-// --- modules\packages.d.ts ---
+
+
+// --- modules\packages.d.ts ---
 // -----------------------------------------------------------------------------
 //
 /**
@@ -3836,9 +3999,9 @@ interface OWPackages extends overwolf.packages.OverwolfPackageManager {
    */
   crn: IOverwolfCRNApi;
 }
-
-
-// --- modules\overlay.d.ts ---
+
+
+// --- modules\overlay.d.ts ---
 /**
  * APIs for controlling and creating overlays in games. Overlay is the ability to show windows on top of the current game window.
  * 
@@ -4842,9 +5005,9 @@ interface IOverwolfOverlayApi extends EventEmitter {
     listener: (info: GameInputInterception) => void
   ): this;
 }
-
-
-// --- modules\crn.d.ts ---
+
+
+// --- modules\crn.d.ts ---
 /**
  * The *Content Recommendation Notification* (CRN) APIs give you tools to help manage the content notification settings in your app. 
  * 
@@ -4981,4 +5144,4 @@ export interface IOverwolfCRNApi {
     eventName: 'notification-action',
     listener: (event: CRNActionType) => void
   ): this;
-}
+}