@comfyorg/comfyui-frontend-types 1.45.10 → 1.45.20

package/index.d.ts

@@ -1,4 +1,5 @@
 import { ComfyApiWorkflow } from '../platform/workflow/validation/schemas/workflowSchema';
+import { ComfyDesktop2Bridge } from '@comfyorg/comfyui-desktop-bridge-types';
 import { ComfyNodeDef } from '@comfyorg/object-info-parser';
 import { ComfyWorkflowJSON } from '../platform/workflow/validation/schemas/workflowSchema';
 import { ComfyWorkflowJSON as ComfyWorkflowJSON_2 } from '../../validation/schemas/workflowSchema';
@@ -373,6 +374,27 @@ declare class BooleanWidget extends BaseWidget<IBooleanWidget> implements IBoole
 
 export declare type BottomPanelExtension = VueBottomPanelExtension | CustomBottomPanelExtension;
 
+declare interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    metadata: BoundingBoxMetadata;
+}
+
+declare class BoundingBoxesWidget extends BaseWidget<IBoundingBoxesWidget> implements IBoundingBoxesWidget {
+    type: "boundingboxes";
+    drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+    onClick(_options: WidgetEventOptions): void;
+}
+
+declare interface BoundingBoxMetadata {
+    type: RegionType;
+    text: string;
+    desc: string;
+    palette: string[];
+}
+
 /**
  * Widget for defining bounding box regions.
  * This widget only has a Vue implementation.
@@ -798,6 +820,12 @@ declare interface ColorStop {
     readonly color: readonly [r: number, g: number, b: number];
 }
 
+declare class ColorsWidget extends BaseWidget<IColorsWidget> implements IColorsWidget {
+    type: "colors";
+    drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+    onClick(_options: WidgetEventOptions): void;
+}
+
 /**
  * Widget for displaying a color picker using native HTML color input
  */
@@ -1550,6 +1578,8 @@ export declare class ComfyApp {
         element: T;
     }
 
+    export { ComfyDesktop2Bridge }
+
     declare class ComfyDialog<T extends HTMLElement = HTMLElement> extends EventTarget {
         element: T;
         textElement: HTMLElement;
@@ -3396,6 +3426,11 @@ export declare class ComfyApp {
         left: LGraphNode;
     }
 
+    declare interface IBoundingBoxesWidget extends IBaseWidget<BoundingBox[], 'boundingboxes'> {
+        type: 'boundingboxes';
+        value: BoundingBox[];
+    }
+
     /** Bounding box widget for defining regions with numeric inputs */
     declare interface IBoundingBoxWidget extends IBaseWidget<Bounds, 'boundingbox'> {
         type: 'boundingbox';
@@ -3434,6 +3469,11 @@ export declare class ComfyApp {
         getColorOption(): ColorOption | null;
     }
 
+    declare interface IColorsWidget extends IBaseWidget<string[], 'colors'> {
+        type: 'colors';
+        value: string[];
+    }
+
     /** Color picker widget for selecting colors */
     declare interface IColorWidget extends IBaseWidget<string, 'color'> {
         type: 'color';
@@ -4035,7 +4075,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 | IPainterWidget | IRangeWidget;
+    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 | IRangeWidget | IBoundingBoxesWidget | IColorsWidget;
 
     declare interface IWidgetAssetOptions extends IWidgetOptions {
         openModal: (widget: IBaseWidget) => void;
@@ -4091,6 +4131,14 @@ export declare class ComfyApp {
         socketless?: boolean;
         /** If `true`, the widget will not be rendered by the Vue renderer. */
         canvasOnly?: boolean;
+        /**
+         * If `true`, the widget still renders on the node but is omitted from the
+         * right side panel. Unlike {@link IWidgetOptions.canvasOnly}, the node body
+         * keeps rendering it via the Vue renderer. Used for widgets that hold
+         * non-syncable state (e.g. a Three.js viewport) where a second instance in
+         * the panel would diverge from the one on the node.
+         */
+        hideInPanel?: boolean;
         /** Used as a temporary override for determining the asset type in vue mode*/
         nodeType?: string;
         /**
@@ -8312,6 +8360,8 @@ export declare class ComfyApp {
         /* Excluded from this release type: _drawDebug */
     }
 
+    declare type RegionType = 'obj' | 'text';
+
     declare type RendererType = 'LG' | 'Vue' | 'Vue-corrected';
 
     declare interface RenderLink {
@@ -8333,6 +8383,7 @@ export declare class ComfyApp {
         readonly fromSlotIndex: SlotIndex;
         /** The reroute that the link is being connected from. */
         readonly fromReroute?: Reroute;
+        readonly isIoNodeLink?: boolean;
         /**
          * Capability checks used for hit-testing and validation during drag.
          * Implementations should return `false` when a connection is not possible
@@ -9455,6 +9506,7 @@ export declare class ComfyApp {
         readonly fromPos: Point;
         fromDirection: LinkDirection;
         readonly existingLink?: LLink;
+        readonly isIoNodeLink = true;
         constructor(network: LinkNetwork, node: SubgraphInputNode, fromSlot: SubgraphInput, fromReroute?: Reroute | undefined, dragDirection?: LinkDirection, existingLink?: LLink);
         canConnectToInput(inputNode: NodeLike, input: INodeInputSlot): boolean;
         canConnectToOutput(): false;
@@ -9508,6 +9560,7 @@ export declare class ComfyApp {
         readonly fromPos: Point;
         readonly fromSlotIndex: SlotIndex;
         fromDirection: LinkDirection;
+        readonly isIoNodeLink = true;
         constructor(network: LinkNetwork, node: SubgraphOutputNode, fromSlot: SubgraphOutput, fromReroute?: Reroute | undefined, dragDirection?: LinkDirection);
         canConnectToInput(): false;
         canConnectToOutput(outputNode: NodeLike, output: INodeOutputSlot | SubgraphIO): boolean;
@@ -46658,6 +46711,8 @@ export declare class ComfyApp {
         curve: CurveWidget;
         painter: PainterWidget;
         range: RangeWidget;
+        boundingboxes: BoundingBoxesWidget;
+        colors: ColorsWidget;
         [key: string]: BaseWidget;
     };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfyorg/comfyui-frontend-types",
-  "version": "1.45.10",
+  "version": "1.45.20",
   "types": "./index.d.ts",
   "files": [
     "index.d.ts"
@@ -12,7 +12,9 @@
   "homepage": "https://comfy.org",
   "description": "TypeScript definitions for @comfyorg/comfyui-frontend",
   "license": "GPL-3.0-only",
-  "dependencies": {},
+  "dependencies": {
+    "@comfyorg/comfyui-desktop-bridge-types": "0.1.2"
+  },
   "peerDependencies": {
     "vue": "^3.5.13",
     "zod": "^3.23.8"