@comfyorg/comfyui-frontend-types 1.39.16 → 1.41.4

package/index.d.ts

@@ -2,9 +2,13 @@ import { ComfyApiWorkflow } from '../platform/workflow/validation/schemas/workfl
 import { ComfyWorkflowJSON } from '../platform/workflow/validation/schemas/workflowSchema';
 import { ComfyWorkflowJSON as ComfyWorkflowJSON_2 } from '../../validation/schemas/workflowSchema';
 import { Component } from 'vue';
+import { DOMWidget } from '../scripts/domWidget';
+import { DOMWidgetOptions } from '../scripts/domWidget';
 import { IFuseOptions } from 'fuse.js';
+import { ModelFile as ModelFile_2 } from '../../validation/schemas/workflowSchema';
 import { NodeId as NodeId_2 } from '../platform/workflow/validation/schemas/workflowSchema';
 import { objectOutputType } from 'zod';
+import { Ref } from 'vue';
 import { ShallowRef } from 'vue';
 import { useDialogService } from '../services/dialogService';
 import { z } from 'zod';
@@ -23,6 +27,7 @@ declare interface AboutPageBadge {
     label: string;
     url: string;
     icon: string;
+    severity?: 'danger' | 'warn';
 }
 
 declare interface ActionBarButton {
@@ -79,12 +84,14 @@ declare type AsCustomEvents<T> = {
 
 declare type AssetDownloadWsMessage = z.infer<typeof zAssetDownloadWsMessage>;
 
+declare type AssetExportWsMessage = z.infer<typeof zAssetExportWsMessage>;
+
 declare class AssetWidget extends BaseWidget<IAssetWidget> implements IAssetWidget {
     constructor(widget: IAssetWidget, node: LGraphNode);
     set value(value: IAssetWidget['value']);
     get value(): IAssetWidget['value'];
     get _displayValue(): string;
-    drawWidget(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+    drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
     onClick(): void;
 }
 
@@ -107,19 +114,20 @@ declare interface BackendApiCalls {
     logs: LogsWsMessage;
     /** Binary preview/progress data */
     b_preview: Blob;
-    /** Binary preview with metadata (node_id, prompt_id) */
+    /** Binary preview with metadata (node_id, job_id) */
     b_preview_with_metadata: {
         blob: Blob;
         nodeId: string;
         parentNodeId: string;
         displayNodeId: string;
         realNodeId: string;
-        promptId: string;
+        jobId: string;
     };
     progress_text: ProgressTextWsMessage;
     progress_state: ProgressStateWsMessage;
     feature_flags: FeatureFlagsWsMessage;
     asset_download: AssetDownloadWsMessage;
+    asset_export: AssetExportWsMessage;
 }
 
 declare enum BadgePosition {
@@ -134,21 +142,6 @@ declare interface BaseBottomPanelExtension {
     targetPanel?: 'terminal' | 'shortcuts';
 }
 
-declare interface BaseDOMWidget<V extends object | string = object | string> extends IBaseWidget<V, string, DOMWidgetOptions<V>> {
-    type: string;
-    options: DOMWidgetOptions<V>;
-    value: V;
-    callback?: (value: V) => void;
-    /** The unique ID of the widget. */
-    readonly id: string;
-    /** The node that the widget belongs to. */
-    readonly node: LGraphNode;
-    /** Whether the widget is visible. */
-    isVisible(): boolean;
-    /** The margin of the widget. */
-    margin: number;
-}
-
 declare interface BaseExportedGraph {
     /** Unique graph ID.  Automatically generated if not provided. */
     id: UUID;
@@ -227,7 +220,7 @@ declare abstract class BaseSteppedWidget<TWidget extends IBaseWidget = IBaseWidg
     drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
 }
 
-declare abstract class BaseWidget<TWidget extends IBaseWidget = IBaseWidget> implements IBaseWidget {
+declare abstract class BaseWidget<TWidget extends IBaseWidget = IBaseWidget> implements IBaseWidget, NodeBindable {
     /** From node edge to widget edge */
     static margin: number;
     /** From widget edge to tip of arrow button */
@@ -252,29 +245,36 @@ declare abstract class BaseWidget<TWidget extends IBaseWidget = IBaseWidget> imp
     linkedWidgets?: IBaseWidget[];
     name: string;
     options: TWidget['options'];
-    label?: string;
     type: TWidget['type'];
     y: number;
     last_y?: number;
     width?: number;
-    disabled?: boolean;
     computedDisabled?: boolean;
+    tooltip?: string;
+    private _state;
+    get label(): string | undefined;
+    set label(value: string | undefined);
     hidden?: boolean;
     advanced?: boolean;
-    promoted?: boolean;
-    tooltip?: string;
+    get disabled(): boolean | undefined;
+    set disabled(value: boolean | undefined);
     element?: HTMLElement;
     callback?(value: TWidget['value'], canvas?: LGraphCanvas, node?: LGraphNode, pos?: Point, e?: CanvasPointerEvent): void;
     mouse?(event: CanvasPointerEvent, pointerOffset: Point, node: LGraphNode): boolean;
     computeSize?(width?: number): Size;
     onPointerDown?(pointer: CanvasPointer, node: LGraphNode, canvas: LGraphCanvas): boolean;
-    private _value?;
     get value(): TWidget['value'];
     set value(value: TWidget['value']);
+    /**
+     * Associates this widget with a node ID and registers it in the WidgetValueStore.
+     * Once set, value reads/writes will be delegated to the store.
+     */
+    setNodeId(nodeId: NodeId): void;
     constructor(widget: TWidget & {
         node: LGraphNode;
     });
     constructor(widget: TWidget, node: LGraphNode);
+    getOutlineColor(suppressPromotedOutline?: boolean): string;
     get outline_color(): string;
     get background_color(): string;
     get height(): number;
@@ -299,14 +299,14 @@ declare abstract class BaseWidget<TWidget extends IBaseWidget = IBaseWidget> imp
      * @param options The options for drawing the widget
      * @remarks Leaves {@link ctx} dirty.
      */
-    protected drawWidgetShape(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+    protected drawWidgetShape(ctx: CanvasRenderingContext2D, { width, showText, suppressPromotedOutline }: DrawWidgetOptions): void;
     /**
      * Draws a placeholder for widgets that only have a Vue implementation.
      * @param ctx The canvas context
      * @param options The options for drawing the widget
      * @param label The label to display (e.g., "ImageCrop", "BoundingBox")
      */
-    protected drawVueOnlyWarning(ctx: CanvasRenderingContext2D, { width }: DrawWidgetOptions, label: string): void;
+    protected drawVueOnlyWarning(ctx: CanvasRenderingContext2D, { width, suppressPromotedOutline }: DrawWidgetOptions, label: string): void;
     /**
      * A shared routine for drawing a label and value as text, truncated
      * if they exceed the available width.
@@ -343,7 +343,7 @@ declare type BasicReadonlyNetwork = Pick<ReadonlyLinkNetwork, 'getNodeById' | 'l
 
 declare class BooleanWidget extends BaseWidget<IBooleanWidget> implements IBooleanWidget {
     type: "toggle";
-    drawWidget(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+    drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
     drawLabel(ctx: CanvasRenderingContext2D, x: number): void;
     drawValue(ctx: CanvasRenderingContext2D, x: number): void;
     onClick(options: WidgetEventOptions): void;
@@ -377,7 +377,7 @@ declare class ButtonWidget extends BaseWidget<IButtonWidget> implements IButtonW
      * @param ctx The canvas context
      * @param options The options for drawing the widget
      */
-    drawWidget(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+    drawWidget(ctx: CanvasRenderingContext2D, { width, showText, suppressPromotedOutline }: DrawWidgetOptions): void;
     drawLabel(ctx: CanvasRenderingContext2D, x: number): void;
     onClick({ e, node, canvas }: WidgetEventOptions): void;
 }
@@ -743,6 +743,11 @@ declare interface ColorOption {
     groupcolor: string;
 }
 
+declare interface ColorStop {
+    readonly offset: number;
+    readonly color: readonly [r: number, g: number, b: number];
+}
+
 /**
  * Widget for displaying a color picker using native HTML color input
  */
@@ -812,7 +817,7 @@ export declare class ComfyApi extends EventTarget {
     /**
      * Feature flags received from the backend server.
      */
-    serverFeatureFlags: Record<string, unknown>;
+    serverFeatureFlags: Ref<Record<string, unknown>, Record<string, unknown>>;
     /**
      * The auth token for the comfy org account if the user is logged in.
      * This is only used for {@link queuePrompt} now. It is not directly
@@ -847,6 +852,8 @@ export declare class ComfyApi extends EventTarget {
      */
     private waitForAuthInitialization;
     fetchApi(route: string, options?: RequestInit): Promise<Response>;
+    addCustomEventListener(type: string, callback: ((event: CustomEvent<unknown>) => void) | null, options?: AddEventListenerOptions | boolean): void;
+    removeCustomEventListener(type: string, callback: ((event: CustomEvent<unknown>) => void) | null, options?: EventListenerOptions | boolean): void;
     /**
      * Dispatches a custom event.
      * Provides type safety for the contravariance issue with EventTarget (last checked TS 5.6).
@@ -950,7 +957,7 @@ export declare class ComfyApi extends EventTarget {
     }): Promise<JobListItem[]>;
     /**
      * Gets detailed job info including outputs and workflow
-     * @param jobId The job/prompt ID
+     * @param jobId The job ID
      * @returns Full job details or undefined if not found
      */
     getJobDetail(jobId: string): Promise<JobDetail | undefined>;
@@ -977,11 +984,11 @@ export declare class ComfyApi extends EventTarget {
      */
     clearItems(type: string): Promise<void>;
     /**
-     * Interrupts the execution of the running prompt. If runningPromptId is provided,
+     * Interrupts the execution of the running job. If runningJobId is provided,
      * it is included in the payload as a helpful hint to the backend.
-     * @param {string | null} [runningPromptId] Optional Running Prompt ID to interrupt
+     * @param {string | null} [runningJobId] Optional Running Job ID to interrupt
      */
-    interrupt(runningPromptId: string | null): Promise<void>;
+    interrupt(runningJobId: string | null): Promise<void>;
     /**
      * Gets user configuration data and where data should be stored
      */
@@ -1083,6 +1090,7 @@ export declare class ComfyApp {
      * List of entries to queue
      */
     private queueItems;
+    private nextQueueRequestId;
     /**
      * If the queue is currently being processed
      */
@@ -1123,12 +1131,12 @@ export declare class ComfyApp {
      private positionConversion?;
      /**
       * The node errors from the previous execution.
-      * @deprecated Use useExecutionStore().lastNodeErrors instead
+      * @deprecated Use app.extensionManager.lastNodeErrors instead
       */
      get lastNodeErrors(): Record<NodeId_2, NodeError> | null;
      /**
       * The error from the previous execution.
-      * @deprecated Use useExecutionStore().lastExecutionError instead
+      * @deprecated Use app.extensionManager.lastExecutionError instead
       */
      get lastExecutionError(): ExecutionErrorWsMessage | null;
      /**
@@ -1313,12 +1321,12 @@ export declare class ComfyApp {
          }[];
      }): void;
      private showMissingNodesError;
-     private showMissingModelsError;
      loadGraphData(graphData?: ComfyWorkflowJSON, clean?: boolean, restore_view?: boolean, workflow?: string | null | ComfyWorkflow, options?: {
          showMissingNodesDialog?: boolean;
          showMissingModelsDialog?: boolean;
          checkForRerouteMigration?: boolean;
          openSource?: WorkflowOpenSource;
+         deferWarnings?: boolean;
      }): Promise<void>;
      graphToPrompt(graph?: LGraph): Promise<{
          workflow: ComfyWorkflowJSON;
@@ -1330,7 +1338,22 @@ export declare class ComfyApp {
       * Loads workflow data from the specified file
       * @param {File} file
       */
-     handleFile(file: File, openSource?: WorkflowOpenSource): Promise<void>;
+     handleFile(file: File, openSource?: WorkflowOpenSource, options?: {
+         deferWarnings?: boolean;
+     }): Promise<void>;
+     /**
+      * Loads multiple files, connects to a batch node, and selects them
+      * @param {FileList} fileList
+      */
+     handleFileList(fileList: File[]): Promise<void>;
+     handleAudioFileList(fileList: File[]): Promise<void>;
+     /**
+      * Positions batched nodes in drag and drop
+      * @param nodes
+      * @param batchNode
+      */
+     positionNodes(nodes: LGraphNode[]): void;
+     positionBatchNodes(nodes: LGraphNode[], batchNode: LGraphNode): void;
      isApiJson(data: unknown): data is ComfyApiWorkflow;
      loadApiJson(apiData: ComfyApiWorkflow, fileName: string): void;
      /**
@@ -1584,7 +1607,7 @@ export declare class ComfyApp {
          * This is an experimental API and may be changed or removed in the future.
          */
         onAuthUserLogout?(): Promise<void> | void;
-        [key: string]: any;
+        [key: string]: unknown;
     }
 
     declare class ComfyList {
@@ -2042,6 +2065,7 @@ export declare class ComfyApp {
             'Comfy.Group.DoubleClickTitleToEdit'?: boolean | undefined;
             'Comfy.GroupSelectedNodes.Padding'?: number | undefined;
             'Comfy.Locale'?: string | undefined;
+            'Comfy.NodeLibrary.NewDesign'?: boolean | undefined;
             'Comfy.NodeLibrary.Bookmarks'?: string[] | undefined;
             'Comfy.NodeLibrary.Bookmarks.V2'?: string[] | undefined;
             'Comfy.NodeLibrary.BookmarksCustomization'?: Record<string, {
@@ -2053,7 +2077,7 @@ export declare class ComfyApp {
             'Comfy.ModelLibrary.AutoLoadAll'?: boolean | undefined;
             'Comfy.ModelLibrary.NameFormat'?: "title" | "filename" | undefined;
             'Comfy.NodeSearchBoxImpl.NodePreview'?: boolean | undefined;
-            'Comfy.NodeSearchBoxImpl'?: "default" | "simple" | undefined;
+            'Comfy.NodeSearchBoxImpl'?: "default" | "v1 (legacy)" | "litegraph (legacy)" | undefined;
             'Comfy.NodeSearchBoxImpl.ShowCategory'?: boolean | undefined;
             'Comfy.NodeSearchBoxImpl.ShowIdName'?: boolean | undefined;
             'Comfy.NodeSearchBoxImpl.ShowNodeFrequency'?: boolean | undefined;
@@ -2181,6 +2205,7 @@ export declare class ComfyApp {
             'LiteGraph.Pointer.TrackpadGestures'?: boolean | undefined;
             'Comfy.VersionCompatibility.DisableWarnings'?: boolean | undefined;
             'Comfy.RightSidePanel.IsOpen'?: boolean | undefined;
+            'Comfy.RightSidePanel.ShowErrorsTab'?: boolean | undefined;
             'Comfy.Node.AlwaysShowAdvancedWidgets'?: boolean | undefined;
             'Comfy.Canvas.BackgroundImage'?: string | undefined;
             'test.setting'?: any;
@@ -2190,11 +2215,11 @@ export declare class ComfyApp {
         /**
          * @deprecated Use `settingStore.settingsById` instead.
          */
-        get settingsLookup(): Record<string, SettingParams<any>>;
+        get settingsLookup(): Record<string, SettingParams<unknown>>;
         /**
          * @deprecated Use `settingStore.settingsById` instead.
          */
-        get settingsParamLookup(): Record<string, SettingParams<any>>;
+        get settingsParamLookup(): Record<string, SettingParams<unknown>>;
         /**
          * @deprecated Use `settingStore.get` instead.
          */
@@ -2272,6 +2297,10 @@ export declare class ComfyApp {
          * Whether the workflow has been modified comparing to the initial state.
          */
         _isModified: boolean;
+        /**
+         * Warnings deferred from load time, shown when the workflow is first focused.
+         */
+        pendingWarnings: PendingWarnings | null;
         /**
          * @param options The path, modified, and size of the workflow.
          * Note: path is the full path, including the 'workflows/' prefix.
@@ -2466,6 +2495,14 @@ export declare class ComfyApp {
         getCloserPoint(pos: Point, max_dist: number): number;
     }
 
+    declare type CurvePoint = [x: number, y: number];
+
+    declare class CurveWidget extends BaseWidget<ICurveWidget> implements ICurveWidget {
+        type: "curve";
+        drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+        onClick(_options: WidgetEventOptions): void;
+    }
+
     declare type CustomBottomPanelExtension = BaseBottomPanelExtension & CustomExtension;
 
     /**
@@ -2560,43 +2597,9 @@ export declare class ComfyApp {
      */
     declare function distance(a: Readonly<Point>, b: Readonly<Point>): number;
 
-    /**
-     * A DOM widget that wraps a custom HTML element as a litegraph widget.
-     */
-    export declare interface DOMWidget<T extends HTMLElement, V extends object | string> extends BaseDOMWidget<V> {
-        element: T;
-        /**
-         * @deprecated Legacy property used by some extensions for customtext
-         * (textarea) widgets. Use {@link element} instead as it provides the same
-         * functionality and works for all DOMWidget types.
-         */
-        inputEl?: T;
-    }
+    export { DOMWidget }
 
-    export declare interface DOMWidgetOptions<V extends object | string> extends IWidgetOptions {
-        /**
-         * Whether to render a placeholder rectangle when zoomed out.
-         */
-        hideOnZoom?: boolean;
-        selectOn?: string[];
-        onHide?: (widget: BaseDOMWidget<V>) => void;
-        getValue?: () => V;
-        setValue?: (value: V) => void;
-        getMinHeight?: () => number;
-        getMaxHeight?: () => number;
-        getHeight?: () => string | number;
-        onDraw?: (widget: BaseDOMWidget<V>) => void;
-        margin?: number;
-        /**
-         * @deprecated Use `afterResize` instead. This callback is a legacy API
-         * that fires before resize happens, but it is no longer supported. Now it
-         * fires after resize happens.
-         * The resize logic has been upstreamed to litegraph in
-         * https://github.com/Comfy-Org/ComfyUI_frontend/pull/2557
-         */
-        beforeResize?: (this: BaseDOMWidget<V>, node: LGraphNode) => void;
-        afterResize?: (this: BaseDOMWidget<V>, node: LGraphNode) => void;
-    }
+    export { DOMWidgetOptions }
 
     declare class DragAndScale {
         /**
@@ -2696,6 +2699,8 @@ export declare class ComfyApp {
         width: number;
         /** Synonym for "low quality". */
         showText?: boolean;
+        /** When true, suppresses the promoted outline color (e.g. for projected copies on SubgraphNode). */
+        suppressPromotedOutline?: boolean;
     }
 
     declare interface DrawWidgetsOptions {
@@ -2846,6 +2851,10 @@ export declare class ComfyApp {
     declare interface ExportedSubgraph extends SerialisableGraph {
         /** The display name of the subgraph. */
         name: string;
+        /** Optional category for organizing subgraph blueprints in the node library. */
+        category?: string;
+        /** Optional description shown as tooltip when hovering over the subgraph node. */
+        description?: string;
         inputNode: ExportedSubgraphIONode;
         outputNode: ExportedSubgraphIONode;
         /** Ordered list of inputs to the subgraph itself. Similar to a reroute, with the input side in the graph, and the output side in the subgraph. */
@@ -2892,6 +2901,8 @@ export declare class ComfyApp {
             get: <T = unknown>(id: string) => T | undefined;
             set: <T = unknown>(id: string, value: T) => void;
         };
+        lastNodeErrors: Record<NodeId_2, NodeError> | null;
+        lastExecutionError: ExecutionErrorWsMessage | null;
     }
 
     export declare type ExtensionsResponse = z.infer<typeof zExtensionsResponse>;
@@ -2982,9 +2993,15 @@ export declare class ComfyApp {
     /** Dictionary of Frontend-generated API calls */
     declare interface FrontendApiCalls {
         graphChanged: ComfyWorkflowJSON;
+        promptQueueing: {
+            requestId: number;
+            batchCount: number;
+            number?: number;
+        };
         promptQueued: {
             number: number;
             batchCount: number;
+            requestId?: number;
         };
         graphCleared: never;
         reconnecting: never;
@@ -3007,10 +3024,20 @@ export declare class ComfyApp {
             node_pack: string;
             category?: string;
             search_aliases?: string[];
+            requiresCustomNodes?: string[];
+            includeOnDistributions?: TemplateIncludeOnDistributionEnum[];
         };
         data: string | Promise<string>;
+        essentials_category?: string;
     };
 
+    declare class GradientSliderWidget extends BaseWidget<IGradientSliderWidget> implements IGradientSliderWidget {
+        type: "gradientslider";
+        drawWidget(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+        onClick(options: WidgetEventOptions): void;
+        onDrag(options: WidgetEventOptions): false | undefined;
+    }
+
     /** Options for {@link LGraph.add} method. */
     declare interface GraphAddOptions {
         /** If true, skip recomputing execution order after adding the node. */
@@ -3089,7 +3116,7 @@ export declare class ComfyApp {
      * @template TOptions The options for this widget.
      * @see IWidget
      */
-    declare interface IBaseWidget<TValue = boolean | number | string | object | undefined, TType extends string = string, TOptions extends IWidgetOptions<unknown> = IWidgetOptions<unknown>> {
+    declare interface IBaseWidget<TValue = boolean | number | string | object | undefined, TType extends string = string, TOptions extends IWidgetOptions = IWidgetOptions> {
         [symbol: symbol]: boolean;
         linkedWidgets?: IBaseWidget[];
         name: string;
@@ -3100,8 +3127,15 @@ export declare class ComfyApp {
         value?: TValue;
         vueTrack?: () => void;
         /**
-         * Whether the widget value should be serialized on node serialization.
+         * Whether the widget value is persisted in the workflow JSON
+         * (`widgets_values`). Checked by {@link LGraphNode.serialize} and
+         * {@link LGraphNode.configure}.
+         *
+         * This is distinct from {@link IWidgetOptions.serialize}, which controls
+         * whether the value is included in the API prompt sent for execution.
+         *
          * @default true
+         * @see IWidgetOptions.serialize — API prompt inclusion
          */
         serialize?: boolean;
         /**
@@ -3136,13 +3170,6 @@ export declare class ComfyApp {
         computedDisabled?: boolean;
         hidden?: boolean;
         advanced?: boolean;
-        /**
-         * This property is automatically computed on graph change
-         * and should not be changed.
-         * Promoted widgets have a colored border
-         * @see /core/graph/subgraph/proxyWidget.registerProxyWidgets
-         */
-        promoted?: boolean;
         tooltip?: string;
         callback?(value: unknown, canvas?: LGraphCanvas, node?: LGraphNode, pos?: Point, e?: CanvasPointerEvent): void;
         /**
@@ -3340,6 +3367,11 @@ export declare class ComfyApp {
         height?: number | string;
     }
 
+    declare interface ICurveWidget extends IBaseWidget<CurvePoint[], 'curve'> {
+        type: 'curve';
+        value: CurvePoint[];
+    }
+
     /**
      * Has strongly-typed overrides of {@link EventTarget.addEventListener} and {@link EventTarget.removeEventListener}.
      */
@@ -3415,6 +3447,11 @@ export declare class ComfyApp {
         value: string[];
     }
 
+    declare interface IGradientSliderWidget extends IBaseWidget<number, 'gradientslider', IWidgetGradientSliderOptions> {
+        type: 'gradientslider';
+        value: number;
+    }
+
     declare interface IGraphGroupFlags extends Record<string, unknown> {
         pinned?: true;
     }
@@ -3835,12 +3872,19 @@ export declare class ComfyApp {
      * Recommend declaration merging any properties that use IWidget (e.g. {@link LGraphNode.widgets}) with a new type alias.
      * @see ICustomWidget
      */
-    declare type IWidget = IBooleanWidget | INumericWidget | IStringWidget | IComboWidget | IStringComboWidget | ICustomWidget | ISliderWidget | IButtonWidget | IKnobWidget | IFileUploadWidget | IColorWidget | IMarkdownWidget | IImageWidget | ITreeSelectWidget | IMultiSelectWidget | IChartWidget | IGalleriaWidget | IImageCompareWidget | ISelectButtonWidget | ITextareaWidget | IAssetWidget | IImageCropWidget | IBoundingBoxWidget;
+    declare type IWidget = IBooleanWidget | INumericWidget | IStringWidget | IComboWidget | IStringComboWidget | ICustomWidget | ISliderWidget | IGradientSliderWidget | IButtonWidget | IKnobWidget | IFileUploadWidget | IColorWidget | IMarkdownWidget | IImageWidget | ITreeSelectWidget | IMultiSelectWidget | IChartWidget | IGalleriaWidget | IImageCompareWidget | ISelectButtonWidget | ITextareaWidget | IAssetWidget | IImageCropWidget | IBoundingBoxWidget | ICurveWidget;
 
     declare interface IWidgetAssetOptions extends IWidgetOptions {
         openModal: (widget: IBaseWidget) => void;
     }
 
+    declare interface IWidgetGradientSliderOptions extends IWidgetOptions<number[]> {
+        min: number;
+        max: number;
+        step2: number;
+        gradient_stops?: ColorStop[];
+    }
+
     declare interface IWidgetKnobOptions extends IWidgetOptions<number[]> {
         min: number;
         max: number;
@@ -3861,7 +3905,7 @@ export declare class ComfyApp {
         type?: string;
     }
 
-    declare interface IWidgetOptions<TValues = unknown[]> {
+    declare interface IWidgetOptions<TValues = unknown> {
         on?: string;
         off?: string;
         max?: number;
@@ -3886,6 +3930,18 @@ export declare class ComfyApp {
         canvasOnly?: boolean;
         /** Used as a temporary override for determining the asset type in vue mode*/
         nodeType?: string;
+        /**
+         * Whether the widget value should be included in the API prompt sent to
+         * the backend for execution. Checked by {@link executionUtil} when
+         * building the prompt payload.
+         *
+         * This is distinct from {@link IBaseWidget.serialize}, which controls
+         * whether the value is persisted in the workflow JSON file.
+         *
+         * @default true
+         * @see IBaseWidget.serialize — workflow persistence
+         */
+        serialize?: boolean;
         values?: TValues;
         /** Optional function to format values for display (e.g., hash → human-readable name) */
         getOptionLabel?: (value?: string | null) => string;
@@ -3934,7 +3990,7 @@ export declare class ComfyApp {
             maxWidth?: number;
         };
         get height(): number;
-        drawWidget(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+        drawWidget(ctx: CanvasRenderingContext2D, { width, showText, suppressPromotedOutline }: DrawWidgetOptions): void;
         onClick(): void;
         current_drag_offset: number;
         onDrag(options: WidgetEventOptions): void;
@@ -3973,7 +4029,6 @@ export declare class ComfyApp {
         static serialisedSchemaVersion: 1;
         static STATUS_STOPPED: number;
         static STATUS_RUNNING: number;
-        static deduplicateSubgraphIds: boolean;
         /** List of LGraph properties that are manually handled by {@link LGraph.configure}. */
         static readonly ConfigureProperties: Set<string>;
         id: UUID;
@@ -4158,7 +4213,7 @@ export declare class ComfyApp {
          * @param skipComputeOrder If true, skip recomputing execution order
          * @deprecated Use options object instead
          */
-        add(node: LGraphNode | LGraphGroup, skipComputeOrder?: boolean): LGraphNode | null | undefined;
+        add(node: LGraphNode | LGraphGroup | null, skipComputeOrder?: boolean): LGraphNode | null | undefined;
         /**
          * Removes a node from the graph
          * @param node the instance of the node
@@ -5197,7 +5252,7 @@ export declare class ComfyApp {
         showShowNodePanel(node: LGraphNode): void;
         checkPanels(): void;
         getCanvasMenuOptions(): (IContextMenuValue | null)[];
-        getNodeMenuOptions(node: LGraphNode): (IContextMenuValue<INodeSlotContextItem, unknown, unknown> | IContextMenuValue<string, unknown, unknown> | IContextMenuValue<string | null, unknown, unknown> | IContextMenuValue<"round" | "default" | "box" | "card", unknown, unknown> | IContextMenuValue<unknown, LGraphNode, unknown> | null)[];
+        getNodeMenuOptions(node: LGraphNode): (IContextMenuValue<INodeSlotContextItem, unknown, unknown> | IContextMenuValue<string, unknown, unknown> | IContextMenuValue<string | null, unknown, unknown> | IContextMenuValue<unknown, LGraphNode, unknown> | IContextMenuValue<"round" | "default" | "box" | "card", unknown, unknown> | null)[];
         /** @deprecated */
         getGroupMenuOptions(group: LGraphGroup): (IContextMenuValue<string, unknown, unknown> | IContextMenuValue<string | null, unknown, unknown> | null)[];
         processContextMenu(node: LGraphNode | undefined, event: CanvasPointerEvent): void;
@@ -5219,10 +5274,6 @@ export declare class ComfyApp {
          * Apply batched node position updates
          */
         private applyNodePositionUpdates;
-        /**
-         * Initialize layout mutations with Canvas source
-         */
-        private initLayoutMutations;
         /**
          * Collect all nodes that are children of groups in the selection
          */
@@ -5649,6 +5700,10 @@ export declare class ComfyApp {
         get pos(): Point;
         /** Node position does not necessarily correlate to the top-left corner. */
         set pos(value: Point);
+        /**
+         * Set the node position to an absolute location.
+         */
+        setPos(x: number, y: number): void;
         get size(): Size;
         set size(value: Size);
         /**
@@ -6309,6 +6364,15 @@ export declare class ComfyApp {
          * Returns `true` if the widget is visible, otherwise `false`.
          */
         isWidgetVisible(widget: IBaseWidget): boolean;
+        /**
+         * Returns all widgets that should participate in layout calculations.
+         * Filters out hidden widgets only (not collapsed/advanced).
+         */
+        getLayoutWidgets(): IBaseWidget[];
+        /**
+         * Returns `true` if the node has any advanced widgets.
+         */
+        hasAdvancedWidgets(): boolean;
         updateComputedDisabled(): void;
         drawWidgets(ctx: CanvasRenderingContext2D, { lowQuality, editorAlpha }: DrawWidgetsOptions): void;
         /**
@@ -6474,7 +6538,9 @@ export declare class ComfyApp {
         get isConnecting(): boolean;
         get draggingExistingLinks(): boolean;
         /** Drag an existing link to a different input. */
-        moveInputLink(network: LinkNetwork, input: INodeInputSlot): void;
+        moveInputLink(network: LinkNetwork, input: INodeInputSlot, opts?: {
+            startPoint?: Point;
+        }): void;
         /** Drag all links from an output to a new output. */
         moveOutputLink(network: LinkNetwork, output: INodeOutputSlot): void;
         /**
@@ -7352,7 +7418,9 @@ export declare class ComfyApp {
         readonly fromPos: Point;
         readonly fromDirection: LinkDirection;
         readonly fromSlotIndex: number;
-        constructor(network: LinkNetwork, link: LLink, fromReroute?: Reroute, dragDirection?: LinkDirection);
+        disconnectOnDrop: boolean;
+        readonly disconnectOrigin: Point;
+        constructor(network: LinkNetwork, link: LLink, fromReroute?: Reroute, dragDirection?: LinkDirection, startPoint?: Point);
         canConnectToInput(inputNode: NodeLike, input: INodeInputSlot | SubgraphIO): boolean;
         canConnectToOutput(): false;
         canConnectToReroute(reroute: Reroute): boolean;
@@ -7367,6 +7435,7 @@ export declare class ComfyApp {
         }, events: CustomEventTarget<LinkConnectorEventMap>, originalReroutes: Reroute[]): void;
         connectToRerouteOutput(): never;
         disconnect(): boolean;
+        drawConnectionCircle(ctx: CanvasRenderingContext2D, to: Readonly<Point>): void;
     }
 
     /**
@@ -7466,6 +7535,10 @@ export declare class ComfyApp {
         };
     }
 
+    declare interface NodeBindable {
+        setNodeId(nodeId: NodeId): void;
+    }
+
     export declare type NodeError = z.infer<typeof zNodeError>;
 
     /**
@@ -7638,7 +7711,7 @@ export declare class ComfyApp {
         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]>;
+    declare type ParamsArray<T, K extends MethodNames<T>> = Parameters<Extract<T[K], (...args: never[]) => unknown>>[1] extends undefined ? Parameters<Extract<T[K], (...args: never[]) => unknown>> | Parameters<Extract<T[K], (...args: never[]) => unknown>>[0] : Parameters<Extract<T[K], (...args: never[]) => unknown>>;
 
     /** An object containing a set of child objects */
     declare interface Parent<TChild> {
@@ -7663,6 +7736,14 @@ export declare class ComfyApp {
         localNodeId: NodeId_2;
     } | null;
 
+    declare interface PendingWarnings {
+        missingNodeTypes?: MissingNodeType[];
+        missingModels?: {
+            missingModels: ModelFile_2[];
+            paths: Record<string, string[]>;
+        };
+    }
+
     /**
      * General-purpose, TypeScript utility types.
      */
@@ -8322,11 +8403,11 @@ export declare class ComfyApp {
         value?: string | number;
     }
 
-    declare interface SettingParams<TValue = any> extends FormItem {
+    declare interface SettingParams<TValue = unknown> extends FormItem {
         id: keyof Settings;
         defaultValue: TValue | (() => TValue);
         defaultsByInstallVersion?: Record<`${number}.${number}.${number}`, TValue>;
-        onChange?: (newValue: TValue, oldValue?: TValue) => void;
+        onChange?(newValue: TValue, oldValue?: TValue): void;
         category?: string[];
         experimental?: boolean;
         deprecated?: boolean;
@@ -8355,7 +8436,7 @@ export declare class ComfyApp {
          * @param ctx The canvas context
          * @param options The options for drawing the widget
          */
-        drawWidget(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+        drawWidget(ctx: CanvasRenderingContext2D, { width, showText, suppressPromotedOutline }: DrawWidgetOptions): void;
         /**
          * Handles click events for the slider widget
          */
@@ -8419,6 +8500,8 @@ export declare class ComfyApp {
         static MAX_NESTED_SUBGRAPHS: number;
         /** The display name of the subgraph. */
         name: string;
+        /** Optional description shown as tooltip when hovering over the subgraph node. */
+        description?: string;
         readonly inputNode: SubgraphInputNode;
         readonly outputNode: SubgraphOutputNode;
         /** Ordered list of inputs to the subgraph itself. Similar to a reroute, with the input side in the graph, and the output side in the subgraph. */
@@ -8557,6 +8640,7 @@ export declare class ComfyApp {
         'input-connected': {
             input: INodeInputSlot;
             widget: IBaseWidget;
+            node: LGraphNode;
         };
         'input-disconnected': {
             input: SubgraphInput;
@@ -8703,7 +8787,10 @@ export declare class ComfyApp {
         get rootGraph(): LGraph;
         get displayType(): string;
         isSubgraphNode(): this is SubgraphNode;
+        private _promotedViewManager;
         widgets: IBaseWidget[];
+        private _getPromotedViews;
+        private _resolveLegacyEntry;
         /** Manages lifecycle of all subgraph event listeners */
         private _eventAbortController;
         constructor(
@@ -8740,6 +8827,9 @@ export declare class ComfyApp {
          */
         resolveSubgraphOutputLink(slot: number): ResolvedConnection | undefined;
         /* Excluded from this release type: getInnerNodes */
+        /** Clear the DOM position override for a promoted view's interior widget. */
+        private _clearDomOverrideForView;
+        removeWidget(widget: IBaseWidget): void;
         removeWidgetByName(name: string): void;
         ensureWidgetRemoved(widget: IBaseWidget): void;
         onRemoved(): void;
@@ -8930,7 +9020,7 @@ export declare class ComfyApp {
          * @param ctx The canvas context
          * @param options The options for drawing the widget
          */
-        drawWidget(ctx: CanvasRenderingContext2D, { width, showText }: DrawWidgetOptions): void;
+        drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
         onClick({ e, node, canvas }: WidgetEventOptions): void;
     }
 
@@ -9245,6 +9335,7 @@ export declare class ComfyApp {
         button: ButtonWidget;
         toggle: BooleanWidget;
         slider: SliderWidget;
+        gradientslider: GradientSliderWidget;
         knob: KnobWidget;
         combo: ComboWidget;
         number: NumberWidget;
@@ -9264,6 +9355,7 @@ export declare class ComfyApp {
         asset: AssetWidget;
         imagecrop: ImageCropWidget;
         boundingbox: BoundingBoxWidget;
+        curve: CurveWidget;
         [key: string]: BaseWidget;
     };
 
@@ -9311,22 +9403,57 @@ export declare class ComfyApp {
         status: "running" | "completed" | "failed" | "created";
         progress: number;
         task_id: string;
+        bytes_downloaded: number;
         asset_name: string;
         bytes_total: number;
-        bytes_downloaded: number;
         error?: string | undefined;
         asset_id?: string | undefined;
     }, {
         status: "running" | "completed" | "failed" | "created";
         progress: number;
         task_id: string;
+        bytes_downloaded: number;
         asset_name: string;
         bytes_total: number;
-        bytes_downloaded: number;
         error?: string | undefined;
         asset_id?: string | undefined;
     }>;
 
+    declare const zAssetExportWsMessage: z.ZodObject<{
+        task_id: z.ZodString;
+        export_name: z.ZodOptional<z.ZodString>;
+        assets_total: z.ZodNumber;
+        assets_attempted: z.ZodNumber;
+        assets_failed: z.ZodNumber;
+        bytes_total: z.ZodNumber;
+        bytes_processed: z.ZodNumber;
+        progress: z.ZodNumber;
+        status: z.ZodEnum<["created", "running", "completed", "failed"]>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "running" | "completed" | "failed" | "created";
+        progress: number;
+        task_id: string;
+        bytes_total: number;
+        assets_total: number;
+        assets_attempted: number;
+        assets_failed: number;
+        bytes_processed: number;
+        error?: string | undefined;
+        export_name?: string | undefined;
+    }, {
+        status: "running" | "completed" | "failed" | "created";
+        progress: number;
+        task_id: string;
+        bytes_total: number;
+        assets_total: number;
+        assets_attempted: number;
+        assets_failed: number;
+        bytes_processed: number;
+        error?: string | undefined;
+        export_name?: string | undefined;
+    }>;
+
     declare const zComfyNodeDef: z.ZodObject<{
         input: z.ZodOptional<z.ZodObject<{
             required: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodTuple<[z.ZodLiteral<"INT">, z.ZodOptional<z.ZodObject<z.objectUtil.extendShape<z.objectUtil.extendShape<{
@@ -9348,7 +9475,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -9374,7 +9501,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -9400,7 +9527,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -9426,9 +9553,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, "passthrough", z.ZodTypeAny, z.objectOutputType<z.objectUtil.extendShape<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -9448,9 +9585,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough">, z.objectInputType<z.objectUtil.extendShape<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -9470,9 +9617,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough">>>], null>, z.ZodTuple<[z.ZodLiteral<"BOOLEAN">, z.ZodOptional<z.ZodObject<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -10018,7 +10175,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -10044,7 +10201,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -10070,7 +10227,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -10096,9 +10253,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, "passthrough", z.ZodTypeAny, z.objectOutputType<z.objectUtil.extendShape<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -10118,9 +10285,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough">, z.objectInputType<z.objectUtil.extendShape<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -10140,9 +10317,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough">>>], null>, z.ZodTuple<[z.ZodLiteral<"BOOLEAN">, z.ZodOptional<z.ZodObject<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -10691,7 +10878,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -10717,9 +10904,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectOutputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -10915,7 +11112,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -10941,9 +11138,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectOutputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -11141,7 +11348,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -11167,9 +11374,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectInputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -11365,7 +11582,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -11391,9 +11608,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectInputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -11581,6 +11808,7 @@ export declare class ComfyApp {
         description: z.ZodString;
         help: z.ZodOptional<z.ZodString>;
         category: z.ZodString;
+        main_category: z.ZodOptional<z.ZodString>;
         output_node: z.ZodBoolean;
         python_module: z.ZodString;
         deprecated: z.ZodOptional<z.ZodBoolean>;
@@ -11669,10 +11897,14 @@ export declare class ComfyApp {
                 input_groups?: string[] | undefined;
             } | undefined;
         }>>;
+        /** Category for the Essentials tab. If set, the node appears in Essentials. */
+        essentials_category: z.ZodOptional<z.ZodString>;
+        /** Whether the blueprint is a global/installed blueprint (not user-created). */
+        isGlobal: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        category: string;
         description: string;
+        category: string;
         display_name: string;
         output_node: boolean;
         python_module: string;
@@ -11697,7 +11929,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -11723,9 +11955,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectOutputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -11921,7 +12163,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -11947,9 +12189,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectOutputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -12131,12 +12383,13 @@ export declare class ComfyApp {
         deprecated?: boolean | undefined;
         help?: string | undefined;
         experimental?: boolean | undefined;
+        dev_only?: boolean | undefined;
+        api_node?: boolean | undefined;
         output_is_list?: boolean[] | undefined;
         output_name?: string[] | undefined;
         output_tooltips?: string[] | undefined;
         output_matchtypes?: (string | undefined)[] | undefined;
-        dev_only?: boolean | undefined;
-        api_node?: boolean | undefined;
+        main_category?: string | undefined;
         input_order?: Record<string, string[]> | undefined;
         search_aliases?: string[] | undefined;
         price_badge?: {
@@ -12151,10 +12404,12 @@ export declare class ComfyApp {
             };
             expr: string;
         } | undefined;
+        essentials_category?: string | undefined;
+        isGlobal?: boolean | undefined;
     }, {
         name: string;
-        category: string;
         description: string;
+        category: string;
         display_name: string;
         output_node: boolean;
         python_module: string;
@@ -12179,7 +12434,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -12205,9 +12460,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectInputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -12403,7 +12668,7 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 /**
                  * If true, a linked widget will be added to the node to select the mode
@@ -12429,9 +12694,19 @@ export declare class ComfyApp {
                 step: z.ZodOptional<z.ZodNumber>;
                 /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
                 default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+                display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
             }>, {
                 round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+                gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    offset: z.ZodNumber;
+                    color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                }, "strip", z.ZodTypeAny, {
+                    color: [number, number, number];
+                    offset: number;
+                }, {
+                    color: [number, number, number];
+                    offset: number;
+                }>, "many">>;
             }>, z.ZodTypeAny, "passthrough"> | undefined] | ["BOOLEAN", z.objectInputType<z.objectUtil.extendShape<{
                 default: z.ZodOptional<z.ZodAny>;
                 defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -12613,12 +12888,13 @@ export declare class ComfyApp {
         deprecated?: boolean | undefined;
         help?: string | undefined;
         experimental?: boolean | undefined;
+        dev_only?: boolean | undefined;
+        api_node?: boolean | undefined;
         output_is_list?: boolean[] | undefined;
         output_name?: string[] | undefined;
         output_tooltips?: string[] | undefined;
         output_matchtypes?: (string | undefined)[] | undefined;
-        dev_only?: boolean | undefined;
-        api_node?: boolean | undefined;
+        main_category?: string | undefined;
         input_order?: Record<string, string[]> | undefined;
         search_aliases?: string[] | undefined;
         price_badge?: {
@@ -12633,6 +12909,8 @@ export declare class ComfyApp {
                 input_groups?: string[] | undefined;
             } | undefined;
         } | undefined;
+        essentials_category?: string | undefined;
+        isGlobal?: boolean | undefined;
     }>;
 
     declare const zCustomNodesI18n: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -12895,8 +13173,8 @@ export declare class ComfyApp {
         current_outputs: z.ZodAny;
     }>, "strip", z.ZodTypeAny, {
         prompt_id: string;
-        node_id: string | number;
         timestamp: number;
+        node_id: string | number;
         node_type: string;
         executed: (string | number)[];
         exception_message: string;
@@ -12906,8 +13184,8 @@ export declare class ComfyApp {
         current_outputs?: any;
     }, {
         prompt_id: string;
-        node_id: string | number;
         timestamp: number;
+        node_id: string | number;
         node_type: string;
         executed: (string | number)[];
         exception_message: string;
@@ -12926,14 +13204,14 @@ export declare class ComfyApp {
         executed: z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">;
     }>, "strip", z.ZodTypeAny, {
         prompt_id: string;
-        node_id: string | number;
         timestamp: number;
+        node_id: string | number;
         node_type: string;
         executed: (string | number)[];
     }, {
         prompt_id: string;
-        node_id: string | number;
         timestamp: number;
+        node_id: string | number;
         node_type: string;
         executed: (string | number)[];
     }>;
@@ -12983,7 +13261,7 @@ export declare class ComfyApp {
         step: z.ZodOptional<z.ZodNumber>;
         /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
         default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
     }>, {
         /**
          * If true, a linked widget will be added to the node to select the mode
@@ -13009,7 +13287,7 @@ export declare class ComfyApp {
         step: z.ZodOptional<z.ZodNumber>;
         /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
         default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
     }>, {
         /**
          * If true, a linked widget will be added to the node to select the mode
@@ -13035,7 +13313,7 @@ export declare class ComfyApp {
         step: z.ZodOptional<z.ZodNumber>;
         /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
         default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
     }>, {
         /**
          * If true, a linked widget will be added to the node to select the mode
@@ -13061,9 +13339,19 @@ export declare class ComfyApp {
         step: z.ZodOptional<z.ZodNumber>;
         /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
         default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
     }>, {
         round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+        gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, "strip", z.ZodTypeAny, {
+            color: [number, number, number];
+            offset: number;
+        }, {
+            color: [number, number, number];
+            offset: number;
+        }>, "many">>;
     }>, "passthrough", z.ZodTypeAny, z.objectOutputType<z.objectUtil.extendShape<z.objectUtil.extendShape<{
         default: z.ZodOptional<z.ZodAny>;
         defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -13083,9 +13371,19 @@ export declare class ComfyApp {
         step: z.ZodOptional<z.ZodNumber>;
         /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
         default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
     }>, {
         round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+        gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, "strip", z.ZodTypeAny, {
+            color: [number, number, number];
+            offset: number;
+        }, {
+            color: [number, number, number];
+            offset: number;
+        }>, "many">>;
     }>, z.ZodTypeAny, "passthrough">, z.objectInputType<z.objectUtil.extendShape<z.objectUtil.extendShape<{
         default: z.ZodOptional<z.ZodAny>;
         defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -13105,9 +13403,19 @@ export declare class ComfyApp {
         step: z.ZodOptional<z.ZodNumber>;
         /** Note: Many node authors are using INT/FLOAT to pass list of INT/FLOAT. */
         default: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodArray<z.ZodNumber, "many">]>>;
-        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob"]>>;
+        display: z.ZodOptional<z.ZodEnum<["slider", "number", "knob", "gradientslider"]>>;
     }>, {
         round: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<false>]>>;
+        gradient_stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, "strip", z.ZodTypeAny, {
+            color: [number, number, number];
+            offset: number;
+        }, {
+            color: [number, number, number];
+            offset: number;
+        }>, "many">>;
     }>, z.ZodTypeAny, "passthrough">>>], null>, z.ZodTuple<[z.ZodLiteral<"BOOLEAN">, z.ZodOptional<z.ZodObject<z.objectUtil.extendShape<{
         default: z.ZodOptional<z.ZodAny>;
         defaultInput: z.ZodOptional<z.ZodBoolean>;
@@ -14617,10 +14925,10 @@ export declare class ComfyApp {
                 input_name: z.ZodOptional<z.ZodString>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
         };
+        prompt_id?: string | undefined;
         exec_info?: {
             queue_remaining?: number | undefined;
         } | undefined;
-        prompt_id?: string | undefined;
         node_errors?: Record<string | number, {
             class_type: string;
             errors: {
@@ -14642,10 +14950,10 @@ export declare class ComfyApp {
                 input_name: z.ZodOptional<z.ZodString>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
         };
+        prompt_id?: string | undefined;
         exec_info?: {
             queue_remaining?: number | undefined;
         } | undefined;
-        prompt_id?: string | undefined;
         node_errors?: Record<string | number, {
             class_type: string;
             errors: {
@@ -16023,6 +16331,7 @@ export declare class ComfyApp {
         'Comfy.Group.DoubleClickTitleToEdit': z.ZodBoolean;
         'Comfy.GroupSelectedNodes.Padding': z.ZodNumber;
         'Comfy.Locale': z.ZodString;
+        'Comfy.NodeLibrary.NewDesign': z.ZodBoolean;
         'Comfy.NodeLibrary.Bookmarks': z.ZodArray<z.ZodString, "many">;
         'Comfy.NodeLibrary.Bookmarks.V2': z.ZodArray<z.ZodString, "many">;
         'Comfy.NodeLibrary.BookmarksCustomization': z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -16040,7 +16349,7 @@ export declare class ComfyApp {
         'Comfy.ModelLibrary.AutoLoadAll': z.ZodBoolean;
         'Comfy.ModelLibrary.NameFormat': z.ZodEnum<["filename", "title"]>;
         'Comfy.NodeSearchBoxImpl.NodePreview': z.ZodBoolean;
-        'Comfy.NodeSearchBoxImpl': z.ZodEnum<["default", "simple"]>;
+        'Comfy.NodeSearchBoxImpl': z.ZodEnum<["default", "v1 (legacy)", "litegraph (legacy)"]>;
         'Comfy.NodeSearchBoxImpl.ShowCategory': z.ZodBoolean;
         'Comfy.NodeSearchBoxImpl.ShowIdName': z.ZodBoolean;
         'Comfy.NodeSearchBoxImpl.ShowNodeFrequency': z.ZodBoolean;
@@ -16239,6 +16548,7 @@ export declare class ComfyApp {
         'LiteGraph.Pointer.TrackpadGestures': z.ZodBoolean;
         'Comfy.VersionCompatibility.DisableWarnings': z.ZodBoolean;
         'Comfy.RightSidePanel.IsOpen': z.ZodBoolean;
+        'Comfy.RightSidePanel.ShowErrorsTab': z.ZodBoolean;
         'Comfy.Node.AlwaysShowAdvancedWidgets': z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
         'Comfy.ColorPalette': string;
@@ -16643,6 +16953,7 @@ export declare class ComfyApp {
         'Comfy.Group.DoubleClickTitleToEdit': boolean;
         'Comfy.GroupSelectedNodes.Padding': number;
         'Comfy.Locale': string;
+        'Comfy.NodeLibrary.NewDesign': boolean;
         'Comfy.NodeLibrary.Bookmarks': string[];
         'Comfy.NodeLibrary.Bookmarks.V2': string[];
         'Comfy.NodeLibrary.BookmarksCustomization': Record<string, {
@@ -16654,7 +16965,7 @@ export declare class ComfyApp {
         'Comfy.ModelLibrary.AutoLoadAll': boolean;
         'Comfy.ModelLibrary.NameFormat': "title" | "filename";
         'Comfy.NodeSearchBoxImpl.NodePreview': boolean;
-        'Comfy.NodeSearchBoxImpl': "default" | "simple";
+        'Comfy.NodeSearchBoxImpl': "default" | "v1 (legacy)" | "litegraph (legacy)";
         'Comfy.NodeSearchBoxImpl.ShowCategory': boolean;
         'Comfy.NodeSearchBoxImpl.ShowIdName': boolean;
         'Comfy.NodeSearchBoxImpl.ShowNodeFrequency': boolean;
@@ -16782,6 +17093,7 @@ export declare class ComfyApp {
         'LiteGraph.Pointer.TrackpadGestures': boolean;
         'Comfy.VersionCompatibility.DisableWarnings': boolean;
         'Comfy.RightSidePanel.IsOpen': boolean;
+        'Comfy.RightSidePanel.ShowErrorsTab': boolean;
         'Comfy.Node.AlwaysShowAdvancedWidgets': boolean;
         'Comfy.Canvas.BackgroundImage'?: string | undefined;
         'test.setting'?: any;
@@ -17190,6 +17502,7 @@ export declare class ComfyApp {
         'Comfy.Group.DoubleClickTitleToEdit': boolean;
         'Comfy.GroupSelectedNodes.Padding': number;
         'Comfy.Locale': string;
+        'Comfy.NodeLibrary.NewDesign': boolean;
         'Comfy.NodeLibrary.Bookmarks': string[];
         'Comfy.NodeLibrary.Bookmarks.V2': string[];
         'Comfy.NodeLibrary.BookmarksCustomization': Record<string, {
@@ -17201,7 +17514,7 @@ export declare class ComfyApp {
         'Comfy.ModelLibrary.AutoLoadAll': boolean;
         'Comfy.ModelLibrary.NameFormat': "title" | "filename";
         'Comfy.NodeSearchBoxImpl.NodePreview': boolean;
-        'Comfy.NodeSearchBoxImpl': "default" | "simple";
+        'Comfy.NodeSearchBoxImpl': "default" | "v1 (legacy)" | "litegraph (legacy)";
         'Comfy.NodeSearchBoxImpl.ShowCategory': boolean;
         'Comfy.NodeSearchBoxImpl.ShowIdName': boolean;
         'Comfy.NodeSearchBoxImpl.ShowNodeFrequency': boolean;
@@ -17329,6 +17642,7 @@ export declare class ComfyApp {
         'LiteGraph.Pointer.TrackpadGestures': boolean;
         'Comfy.VersionCompatibility.DisableWarnings': boolean;
         'Comfy.RightSidePanel.IsOpen': boolean;
+        'Comfy.RightSidePanel.ShowErrorsTab': boolean;
         'Comfy.Node.AlwaysShowAdvancedWidgets': boolean;
         'Comfy.Canvas.BackgroundImage'?: string | undefined;
         'test.setting'?: any;
@@ -17403,6 +17717,8 @@ export declare class ComfyApp {
             cloud_version: z.ZodOptional<z.ZodString>;
             comfyui_frontend_version: z.ZodOptional<z.ZodString>;
             workflow_templates_version: z.ZodOptional<z.ZodString>;
+            installed_templates_version: z.ZodOptional<z.ZodString>;
+            required_templates_version: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             comfyui_version: string;
             os: string;
@@ -17416,6 +17732,8 @@ export declare class ComfyApp {
             cloud_version?: string | undefined;
             comfyui_frontend_version?: string | undefined;
             workflow_templates_version?: string | undefined;
+            installed_templates_version?: string | undefined;
+            required_templates_version?: string | undefined;
         }, {
             comfyui_version: string;
             os: string;
@@ -17429,6 +17747,8 @@ export declare class ComfyApp {
             cloud_version?: string | undefined;
             comfyui_frontend_version?: string | undefined;
             workflow_templates_version?: string | undefined;
+            installed_templates_version?: string | undefined;
+            required_templates_version?: string | undefined;
         }>;
         devices: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -17478,6 +17798,8 @@ export declare class ComfyApp {
             cloud_version?: string | undefined;
             comfyui_frontend_version?: string | undefined;
             workflow_templates_version?: string | undefined;
+            installed_templates_version?: string | undefined;
+            required_templates_version?: string | undefined;
         };
     }, {
         devices: {
@@ -17502,6 +17824,8 @@ export declare class ComfyApp {
             cloud_version?: string | undefined;
             comfyui_frontend_version?: string | undefined;
             workflow_templates_version?: string | undefined;
+            installed_templates_version?: string | undefined;
+            required_templates_version?: string | undefined;
         };
     }>;