@comfyorg/comfyui-frontend-types 1.41.5 → 1.41.7

package/index.d.ts

@@ -2,6 +2,7 @@ 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 { CurvePoint } from '../../../../components/curve/types';
 import { DOMWidget } from '../scripts/domWidget';
 import { DOMWidgetOptions } from '../scripts/domWidget';
 import { IFuseOptions } from 'fuse.js';
@@ -77,6 +78,8 @@ declare type ApiToEventType<T = ApiCalls> = {
     [K in keyof T]: K extends 'status' ? StatusWsMessageStatus : K extends 'executing' ? NodeId_2 : T[K];
 };
 
+declare type AppMode = 'graph' | 'app' | 'builder:select' | 'builder:arrange';
+
 /** Wraps all properties in {@link CustomEvent}. */
 declare type AsCustomEvents<T> = {
     readonly [K in keyof T]: CustomEvent<T[K]>;
@@ -2302,6 +2305,23 @@ export declare class ComfyApp {
          * Warnings deferred from load time, shown when the workflow is first focused.
          */
         pendingWarnings: PendingWarnings | null;
+        /**
+         * Initial app mode derived from the serialized workflow (extra.linearMode).
+         * - `undefined`: not yet resolved (first load hasn't happened)
+         * - `null`: resolved, but no mode was set (never builder-saved)
+         * - `AppMode`: resolved to a specific mode
+         */
+        initialMode: AppMode | null | undefined;
+        /**
+         * Current app mode set by the user during the session.
+         * Takes precedence over initialMode when present.
+         */
+        activeMode: AppMode | null;
+        /**
+         * In-progress builder selections not yet persisted via save.
+         * Preserved across tab switches, discarded on exitBuilder.
+         */
+        dirtyLinearData: LinearData | null;
         /**
          * @param options The path, modified, and size of the workflow.
          * Note: path is the full path, including the 'workflows/' prefix.
@@ -2496,8 +2516,6 @@ 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;
@@ -2702,6 +2720,8 @@ export declare class ComfyApp {
         showText?: boolean;
         /** When true, suppresses the promoted outline color (e.g. for projected copies on SubgraphNode). */
         suppressPromotedOutline?: boolean;
+        /** Transient image source for preview widgets rendered on behalf of another node (e.g. subgraph promotion). */
+        previewImages?: HTMLImageElement[];
     }
 
     declare interface DrawWidgetsOptions {
@@ -3126,7 +3146,6 @@ export declare class ComfyApp {
         /** Widget type (see {@link TWidgetType}) */
         type: TType;
         value?: TValue;
-        vueTrack?: () => void;
         /**
          * Whether the widget value is persisted in the workflow JSON
          * (`widgets_values`). Checked by {@link LGraphNode.serialize} and
@@ -3684,6 +3703,11 @@ export declare class ComfyApp {
         safeOffsetY: number;
     }
 
+    declare interface IPainterWidget extends IBaseWidget<string, 'painter'> {
+        type: 'painter';
+        value: string;
+    }
+
     /** Options for {@link LGraphCanvas.pasteFromClipboard}. */
     declare interface IPasteFromClipboardOptions {
         /** If `true`, always attempt to connect inputs of pasted nodes - including to nodes that were not pasted. */
@@ -3873,7 +3897,7 @@ 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 | IGradientSliderWidget | IButtonWidget | IKnobWidget | IFileUploadWidget | IColorWidget | IMarkdownWidget | IImageWidget | ITreeSelectWidget | IMultiSelectWidget | IChartWidget | IGalleriaWidget | IImageCompareWidget | ISelectButtonWidget | ITextareaWidget | IAssetWidget | IImageCropWidget | IBoundingBoxWidget | ICurveWidget;
+    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 | IPainterWidget;
 
     declare interface IWidgetAssetOptions extends IWidgetOptions {
         openModal: (widget: IBaseWidget) => void;
@@ -6506,6 +6530,11 @@ export declare class ComfyApp {
         type: A;
     }>;
 
+    declare interface LinearData {
+        inputs: [NodeId, string][];
+        outputs: NodeId[];
+    }
+
     /**
      * Component of {@link LGraphCanvas} that handles connecting and moving links.
      * @see {@link LLink}
@@ -7396,6 +7425,8 @@ export declare class ComfyApp {
 
     declare type MissingNodeType = string | {
         type: string;
+        nodeId?: string | number;
+        cnrId?: string;
         hint?: string;
         action?: {
             text: string;
@@ -7657,6 +7688,16 @@ export declare class ComfyApp {
      */
     declare function overlapBounding(a: ReadOnlyRect, b: ReadOnlyRect): boolean;
 
+    /**
+     * Widget for the Painter node canvas drawing tool.
+     * This is a widget that only has a Vue widgets implementation.
+     */
+    declare class PainterWidget extends BaseWidget<IPainterWidget> implements IPainterWidget {
+        type: "painter";
+        drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+        onClick(_options: WidgetEventOptions): void;
+    }
+
     /**
      * A dialog panel created by LGraphCanvas.createPanel().
      * Extends HTMLDivElement with additional properties and methods for panel management.
@@ -9357,6 +9398,7 @@ export declare class ComfyApp {
         imagecrop: ImageCropWidget;
         boundingbox: BoundingBoxWidget;
         curve: CurveWidget;
+        painter: PainterWidget;
         [key: string]: BaseWidget;
     };
 
@@ -12381,6 +12423,7 @@ export declare class ComfyApp {
             }, z.ZodTypeAny, "passthrough"> | undefined]> | undefined;
         } | undefined;
         output?: (string | (string | number)[])[] | undefined;
+        essentials_category?: string | undefined;
         deprecated?: boolean | undefined;
         help?: string | undefined;
         experimental?: boolean | undefined;
@@ -12405,7 +12448,6 @@ export declare class ComfyApp {
             };
             expr: string;
         } | undefined;
-        essentials_category?: string | undefined;
         isGlobal?: boolean | undefined;
     }, {
         name: string;
@@ -12886,6 +12928,7 @@ export declare class ComfyApp {
             }, z.ZodTypeAny, "passthrough"> | undefined]> | undefined;
         } | undefined;
         output?: (string | (string | number)[])[] | undefined;
+        essentials_category?: string | undefined;
         deprecated?: boolean | undefined;
         help?: string | undefined;
         experimental?: boolean | undefined;
@@ -12910,7 +12953,6 @@ export declare class ComfyApp {
                 input_groups?: string[] | undefined;
             } | undefined;
         } | undefined;
-        essentials_category?: string | undefined;
         isGlobal?: boolean | undefined;
     }>;
 

package/package.json

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