@comfyorg/comfyui-frontend-types 1.38.0 → 1.38.2

package/index.d.ts

@@ -2833,9 +2833,12 @@ export declare class ComfyApp {
     }
 
     declare interface INodePropertyInfo {
-        name: string;
+        name?: string;
         type?: string;
-        default_value: NodeProperty | undefined;
+        default_value?: NodeProperty;
+        widget?: string;
+        label?: string;
+        values?: TWidgetValue[];
     }
 
     declare interface INodeSlot extends HasBoundingRect {
@@ -3895,9 +3898,9 @@ export declare class ComfyApp {
         _highlight_pos?: Point;
         _highlight_input?: INodeInputSlot;
         /** @deprecated Panels */
-        node_panel?: any;
+        node_panel?: Panel;
         /** @deprecated Panels */
-        options_panel?: any;
+        options_panel?: Panel;
         _bg_img?: HTMLImageElement;
         _pattern?: CanvasPattern;
         _pattern_img?: HTMLImageElement;
@@ -4326,7 +4329,7 @@ export declare class ComfyApp {
         showSearchBox(event: MouseEvent | null, searchOptions?: IShowSearchOptions): HTMLDivElement;
         showEditPropertyValue(node: LGraphNode, property: string, options: IDialogOptions): IDialog | undefined;
         createDialog(html: string, options: IDialogOptions): IDialog;
-        createPanel(title: string, options: ICreatePanelOptions): any;
+        createPanel(title: string, options: ICreatePanelOptions): Panel;
         closePanels(): void;
         showShowNodePanel(node: LGraphNode): void;
         checkPanels(): void;
@@ -4790,8 +4793,8 @@ export declare class ComfyApp {
          * If an invalid index or non-number (false, null, NaN etc) is returned, the connection will be cancelled.
          */
         onBeforeConnectInput?(this: LGraphNode, target_slot: number, requested_slot?: number | string): number | false | null;
-        onShowCustomPanelInfo?(this: LGraphNode, panel: any): void;
-        onAddPropertyToPanel?(this: LGraphNode, pName: string, panel: any): boolean;
+        onShowCustomPanelInfo?(this: LGraphNode, panel: Panel): void;
+        onAddPropertyToPanel?(this: LGraphNode, pName: string, panel: Panel): boolean;
         onWidgetChanged?(this: LGraphNode, name: string, value: unknown, old_value: unknown, w: IBaseWidget): void;
         onDeselected?(this: LGraphNode): void;
         onKeyUp?(this: LGraphNode, e: KeyboardEvent): void;
@@ -4818,7 +4821,7 @@ export declare class ComfyApp {
         onInputDblClick?(this: LGraphNode, index: number, e: CanvasPointerEvent): void;
         onOutputClick?(this: LGraphNode, index: number, e: CanvasPointerEvent): void;
         onOutputDblClick?(this: LGraphNode, index: number, e: CanvasPointerEvent): void;
-        onGetPropertyInfo?(this: LGraphNode, property: string): any;
+        onGetPropertyInfo?(this: LGraphNode, property: string): INodePropertyInfo;
         onNodeOutputAdd?(this: LGraphNode, value: unknown): void;
         onNodeInputAdd?(this: LGraphNode, value: unknown): void;
         onMenuNodeInputs?(this: LGraphNode, entries: (IContextMenuValue<INodeSlotContextItem> | null)[]): (IContextMenuValue<INodeSlotContextItem> | null)[];
@@ -6582,6 +6585,61 @@ export declare class ComfyApp {
      */
     declare function overlapBounding(a: ReadOnlyRect, b: ReadOnlyRect): boolean;
 
+    /**
+     * A dialog panel created by LGraphCanvas.createPanel().
+     * Extends HTMLDivElement with additional properties and methods for panel management.
+     */
+    declare interface Panel extends HTMLDivElement {
+        header: HTMLElement;
+        title_element: HTMLSpanElement;
+        content: HTMLDivElement;
+        alt_content: HTMLDivElement;
+        footer: HTMLDivElement;
+        node?: LGraphNode;
+        onOpen?: () => void;
+        onClose?: () => void;
+        close(): void;
+        toggleAltContent(force?: boolean): void;
+        toggleFooterVisibility(force?: boolean): void;
+        clear(): void;
+        addHTML(code: string, classname?: string, on_footer?: boolean): HTMLDivElement;
+        addButton(name: string, callback: () => void, options?: unknown): PanelButton;
+        addSeparator(): void;
+        addWidget(type: string, name: string, value: TWidgetValue, options?: PanelWidgetOptions, callback?: PanelWidgetCallback): PanelWidget;
+        inner_showCodePad?(property: string): void;
+    }
+
+    /**
+     * A button element with optional options property.
+     */
+    declare interface PanelButton extends HTMLButtonElement {
+        options?: unknown;
+    }
+
+    /**
+     * A widget element with options and value properties.
+     */
+    declare interface PanelWidget extends HTMLDivElement {
+        options?: PanelWidgetOptions;
+        value?: TWidgetValue;
+    }
+
+    /**
+     * Callback for panel widget value changes.
+     */
+    declare type PanelWidgetCallback = (name: string | undefined, value: TWidgetValue, options: PanelWidgetOptions) => void;
+
+    /**
+     * Options for panel widgets.
+     */
+    declare interface PanelWidgetOptions {
+        label?: string;
+        type?: string;
+        widget?: string;
+        values?: Array<string | IContextMenuValue<unknown, unknown, unknown> | null>;
+        callback?: PanelWidgetCallback;
+    }
+
     declare type ParamsArray<T extends Record<any, any>, K extends MethodNames<T>> = Parameters<T[K]>[1] extends undefined ? Parameters<T[K]> | Parameters<T[K]>[0] : Parameters<T[K]>;
 
     /** An object containing a set of child objects */
@@ -10427,8 +10485,8 @@ export declare class ComfyApp {
     }, "strip", z.ZodTypeAny, {
         name: string;
         description: string;
-        display_name: string;
         category: string;
+        display_name: string;
         output_node: boolean;
         python_module: string;
         input?: {
@@ -10875,20 +10933,20 @@ export declare class ComfyApp {
             }, z.ZodTypeAny, "passthrough"> | undefined]> | undefined;
         } | undefined;
         output?: (string | (string | number)[])[] | undefined;
+        deprecated?: boolean | undefined;
+        help?: string | undefined;
+        experimental?: boolean | undefined;
         output_is_list?: boolean[] | undefined;
         output_name?: string[] | undefined;
         output_tooltips?: string[] | undefined;
         output_matchtypes?: (string | undefined)[] | undefined;
-        help?: string | undefined;
-        deprecated?: boolean | undefined;
-        experimental?: boolean | undefined;
         api_node?: boolean | undefined;
         input_order?: Record<string, string[]> | undefined;
     }, {
         name: string;
         description: string;
-        display_name: string;
         category: string;
+        display_name: string;
         output_node: boolean;
         python_module: string;
         input?: {
@@ -11335,13 +11393,13 @@ export declare class ComfyApp {
             }, z.ZodTypeAny, "passthrough"> | undefined]> | undefined;
         } | undefined;
         output?: (string | (string | number)[])[] | undefined;
+        deprecated?: boolean | undefined;
+        help?: string | undefined;
+        experimental?: boolean | undefined;
         output_is_list?: boolean[] | undefined;
         output_name?: string[] | undefined;
         output_tooltips?: string[] | undefined;
         output_matchtypes?: (string | undefined)[] | undefined;
-        help?: string | undefined;
-        deprecated?: boolean | undefined;
-        experimental?: boolean | undefined;
         api_node?: boolean | undefined;
         input_order?: Record<string, string[]> | undefined;
     }>;
@@ -12016,14 +12074,14 @@ export declare class ComfyApp {
         }, "strip", z.ZodTypeAny, {
             key: string;
             shift?: boolean | undefined;
-            meta?: boolean | undefined;
             alt?: boolean | undefined;
+            meta?: boolean | undefined;
             ctrl?: boolean | undefined;
         }, {
             key: string;
             shift?: boolean | undefined;
-            meta?: boolean | undefined;
             alt?: boolean | undefined;
+            meta?: boolean | undefined;
             ctrl?: boolean | undefined;
         }>;
         targetElementId: z.ZodOptional<z.ZodString>;
@@ -12031,8 +12089,8 @@ export declare class ComfyApp {
         combo: {
             key: string;
             shift?: boolean | undefined;
-            meta?: boolean | undefined;
             alt?: boolean | undefined;
+            meta?: boolean | undefined;
             ctrl?: boolean | undefined;
         };
         commandId: string;
@@ -12041,8 +12099,8 @@ export declare class ComfyApp {
         combo: {
             key: string;
             shift?: boolean | undefined;
-            meta?: boolean | undefined;
             alt?: boolean | undefined;
+            meta?: boolean | undefined;
             ctrl?: boolean | undefined;
         };
         commandId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfyorg/comfyui-frontend-types",
-  "version": "1.38.0",
+  "version": "1.38.2",
   "types": "./index.d.ts",
   "files": [
     "index.d.ts"