@decky/ui 4.9.0 → 4.9.1

package/dist/components/Dropdown.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode, FC } from 'react';
 import { ItemProps } from './Item';
+import type { ContextMenuPositionOptions } from './Menu';
 export interface SingleDropdownOption {
     data: any;
     label: ReactNode;
@@ -11,10 +12,6 @@ export interface MultiDropdownOption {
     data?: never;
 }
 export type DropdownOption = SingleDropdownOption | MultiDropdownOption;
-export interface DropdownMenuPositionOptions {
-    [_: string]: unknown;
-    bMatchWidth?: boolean;
-}
 export interface DropdownProps {
     rgOptions: DropdownOption[];
     selectedOption: any;
@@ -22,7 +19,7 @@ export interface DropdownProps {
     onMenuWillOpen?(showMenu: () => void): void;
     onMenuOpened?(): void;
     onChange?(data: SingleDropdownOption): void;
-    contextMenuPositionOptions?: DropdownMenuPositionOptions;
+    contextMenuPositionOptions?: ContextMenuPositionOptions;
     menuLabel?: string;
     strDefaultLabel?: string;
     renderButtonValue?(element: ReactNode): ReactNode;

package/dist/components/Menu.d.ts

@@ -1,6 +1,45 @@
 import { FC, ReactNode } from 'react';
 import { FooterLegendProps } from './FooterLegend';
-export declare const showContextMenu: (children: ReactNode, parent?: EventTarget) => void;
+interface PopupCreationOptions {
+    bCreateHidden?: boolean;
+    bModal?: boolean;
+    title?: string;
+}
+interface MonitorOptions {
+    targetMonitor: {
+        flMonitorScale: number;
+        nScreenLeft: number;
+        nScreenTop: number;
+        nScreenWidth: number;
+        nScreenHeight: number;
+    };
+    flGamepadScale: number;
+}
+export interface ContextMenuPositionOptions extends PopupCreationOptions, Partial<MonitorOptions> {
+    bAlwaysOnTop?: boolean;
+    bDisableMouseOverlay?: boolean;
+    bDisablePopTop?: boolean;
+    bFitToWindow?: boolean;
+    bForcePopup?: boolean;
+    bGrowToElementWidth?: boolean;
+    bMatchHeight?: boolean;
+    bMatchWidth?: boolean;
+    bNoFocusWhenShown?: boolean;
+    bRetainOnHide?: boolean;
+    bScreenCoordinates?: boolean;
+    bOverlapHorizontal?: boolean;
+    bOverlapVertical?: boolean;
+    bPreferPopLeft?: boolean;
+    bPreferPopTop?: boolean;
+    bShiftToFitWindow?: boolean;
+    bStandalone?: boolean;
+    strClassName?: string;
+}
+interface ContextMenuInstance {
+    Hide(): void;
+    Show(): void;
+}
+export declare const showContextMenu: (children: ReactNode, parent?: EventTarget, options?: ContextMenuPositionOptions) => ContextMenuInstance;
 export interface MenuProps extends FooterLegendProps {
     label: string;
     onCancel?(): void;
@@ -28,3 +67,4 @@ export interface MenuItemProps extends FooterLegendProps {
 }
 export declare const MenuItem: FC<MenuItemProps>;
 export declare const MenuSeparator: FC;
+export {};

package/dist/components/Menu.js

@@ -1,6 +1,7 @@
 import { findModuleByExport, findModuleExport } from '../webpack';
-export const showContextMenu = findModuleExport((e) => typeof e === 'function' && e.toString().includes('GetContextMenuManagerFromWindow(')
-    && e.toString().includes('.CreateContextMenuInstance('));
+export const showContextMenu = findModuleExport((e) => typeof e === 'function' &&
+    e.toString().includes('GetContextMenuManagerFromWindow(') &&
+    e.toString().includes('.CreateContextMenuInstance('));
 export const Menu = findModuleExport((e) => e?.prototype?.HideIfSubmenu && e?.prototype?.HideMenu);
 const MenuGoupModule = findModuleByExport(e => e?.prototype?.Focus && e?.prototype?.OnOKButton && e?.prototype?.render?.toString().includes?.(`"emphasis"==this.props.tone`));
 export const MenuGroup = MenuGoupModule && Object.values(MenuGoupModule).find((e) => typeof e == "function" && e?.toString?.()?.includes("bInGamepadUI:"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decky/ui",
-  "version": "4.9.0",
+  "version": "4.9.1",
   "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/Dropdown.ts

@@ -3,6 +3,7 @@ import { ReactNode, FC } from 'react';
 import { CommonUIModule } from '../webpack';
 import { ItemProps } from './Item';
 import { createPropListRegex } from '../utils';
+import type { ContextMenuPositionOptions } from './Menu';
 
 export interface SingleDropdownOption {
   data: any;
@@ -20,11 +21,6 @@ export interface MultiDropdownOption {
 
 export type DropdownOption = SingleDropdownOption | MultiDropdownOption;
 
-export interface DropdownMenuPositionOptions {
-  [_: string]: unknown
-  bMatchWidth?: boolean
-}
-
 export interface DropdownProps {
   rgOptions: DropdownOption[];
   selectedOption: any;
@@ -32,7 +28,7 @@ export interface DropdownProps {
   onMenuWillOpen?(showMenu: () => void): void;
   onMenuOpened?(): void;
   onChange?(data: SingleDropdownOption): void;
-  contextMenuPositionOptions?: DropdownMenuPositionOptions;
+  contextMenuPositionOptions?: ContextMenuPositionOptions;
   menuLabel?: string;
   strDefaultLabel?: string;
   renderButtonValue?(element: ReactNode): ReactNode;

package/src/components/Menu.ts

@@ -3,9 +3,128 @@ import { FC, ReactNode } from 'react';
 import { Export, findModuleByExport, findModuleExport } from '../webpack';
 import { FooterLegendProps } from './FooterLegend';
 
-export const showContextMenu: (children: ReactNode, parent?: EventTarget) => void = findModuleExport(
-  (e: Export) => typeof e === 'function' && e.toString().includes('GetContextMenuManagerFromWindow(')
-  && e.toString().includes('.CreateContextMenuInstance('),
+interface PopupCreationOptions {
+  /**
+   * Initially hidden, make it appear with {@link ContextMenuInstance.Show}.
+   */
+  bCreateHidden?: boolean;
+
+  bModal?: boolean;
+
+  /**
+   * Document title.
+   */
+  title?: string;
+}
+
+// Separate interface, since one of webpack module exports uses this exact object,
+// so maybe it could be reused elsewhere.
+interface MonitorOptions {
+  targetMonitor: {
+    flMonitorScale: number;
+    nScreenLeft: number;
+    nScreenTop: number;
+    nScreenWidth: number;
+    nScreenHeight: number;
+  };
+  flGamepadScale: number;
+}
+
+export interface ContextMenuPositionOptions extends PopupCreationOptions, Partial<MonitorOptions> {
+  /**
+   * When {@link bForcePopup} is true, makes the window appear above everything else.
+   */
+  bAlwaysOnTop?: boolean;
+
+  /**
+   * Disables the mouse overlay, granting the ability to click anywhere while
+   * the menu's active.
+   */
+  bDisableMouseOverlay?: boolean;
+
+  /**
+   * Disables the {@link bPreferPopTop} behavior.
+   */
+  bDisablePopTop?: boolean;
+
+  bFitToWindow?: boolean;
+
+  /**
+   * Forces the menu to open in a separate window instead of inside the parent.
+   */
+  bForcePopup?: boolean;
+
+  /**
+   * Like {@link bMatchWidth}, but don't shrink below the menu's minimum width.
+   */
+  bGrowToElementWidth?: boolean;
+
+  /**
+   * Match the parent's exact height.
+   */
+  bMatchHeight?: boolean;
+
+  /**
+   * Match the parent's exact width.
+   */
+  bMatchWidth?: boolean;
+
+  bNoFocusWhenShown?: boolean;
+
+  /**
+   * Makes the menu **invisible**, instead of getting removed from the DOM.
+   */
+  bRetainOnHide?: boolean;
+
+  bScreenCoordinates?: boolean;
+
+  /**
+   * Set to `true` to not account for the parent's width.
+   */
+  bOverlapHorizontal?: boolean;
+
+  /**
+   * Set to `true` to not account for the parent's height.
+   */
+  bOverlapVertical?: boolean;
+
+  /**
+   * Set to `true` to make the entire menu try to appear on the left side from
+   * the parent.
+   */
+  bPreferPopLeft?: boolean;
+
+  /**
+   * Set to `true` to make the entire menu try to appear above the parent.
+   */
+  bPreferPopTop?: boolean;
+
+  bShiftToFitWindow?: boolean;
+
+  // different window creation flags (StandaloneContextMenu vs PopupContextMenu)
+  bStandalone?: boolean;
+
+  /**
+   * Class name **replacement** for the container element, i.e. it replaces the
+   * default class.
+   */
+  strClassName?: string;
+}
+
+interface ContextMenuInstance {
+  Hide(): void;
+  Show(): void;
+}
+
+export const showContextMenu: (
+  children: ReactNode,
+  parent?: EventTarget,
+  options?: ContextMenuPositionOptions,
+) => ContextMenuInstance = findModuleExport(
+  (e: Export) =>
+    typeof e === 'function' &&
+    e.toString().includes('GetContextMenuManagerFromWindow(') &&
+    e.toString().includes('.CreateContextMenuInstance('),
 );
 
 export interface MenuProps extends FooterLegendProps {