@comfyorg/comfyui-frontend-types 1.38.4 → 1.38.6

package/index.d.ts

@@ -297,6 +297,13 @@ declare abstract class BaseWidget<TWidget extends IBaseWidget = IBaseWidget> imp
      * @remarks Leaves {@link ctx} dirty.
      */
     protected drawWidgetShape(ctx: CanvasRenderingContext2D, { width, showText }: 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;
     /**
      * A shared routine for drawing a label and value as text, truncated
      * if they exceed the available width.
@@ -341,6 +348,23 @@ declare class BooleanWidget extends BaseWidget<IBooleanWidget> implements IBoole
 
 export declare type BottomPanelExtension = VueBottomPanelExtension | CustomBottomPanelExtension;
 
+/**
+ * Widget for defining bounding box regions.
+ * This widget only has a Vue implementation.
+ */
+declare class BoundingBoxWidget extends BaseWidget<IBoundingBoxWidget> implements IBoundingBoxWidget {
+    type: "boundingbox";
+    drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+    onClick(_options: WidgetEventOptions): void;
+}
+
+declare interface Bounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+
 declare class ButtonWidget extends BaseWidget<IButtonWidget> implements IButtonWidget {
     type: "button";
     clicked: boolean;
@@ -2539,6 +2563,12 @@ export declare class ComfyApp {
         left: LGraphNode;
     }
 
+    /** Bounding box widget for defining regions with numeric inputs */
+    declare interface IBoundingBoxWidget extends IBaseWidget<Bounds, 'boundingbox'> {
+        type: 'boundingbox';
+        value: Bounds;
+    }
+
     declare interface IButtonWidget extends IBaseWidget<string | undefined, 'button'> {
         type: 'button';
         value: string | undefined;
@@ -2742,6 +2772,12 @@ export declare class ComfyApp {
         value: string[];
     }
 
+    /** Image crop widget for cropping image */
+    declare interface IImageCropWidget extends IBaseWidget<Bounds, 'imagecrop'> {
+        type: 'imagecrop';
+        value: Bounds;
+    }
+
     /** Image display widget */
     declare interface IImageWidget extends IBaseWidget<string, 'image'> {
         type: 'image';
@@ -2769,6 +2805,16 @@ export declare class ComfyApp {
         onClick(_options: WidgetEventOptions): void;
     }
 
+    /**
+     * Widget for displaying an image crop preview.
+     * This widget only has a Vue implementation.
+     */
+    declare class ImageCropWidget extends BaseWidget<IImageCropWidget> implements IImageCropWidget {
+        type: "imagecrop";
+        drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+        onClick(_options: WidgetEventOptions): void;
+    }
+
     /** Markdown widget for displaying formatted text */
     declare interface IMarkdownWidget extends IBaseWidget<string, 'markdown'> {
         type: 'markdown';
@@ -3120,7 +3166,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 | IButtonWidget | IKnobWidget | IFileUploadWidget | IColorWidget | IMarkdownWidget | IImageWidget | ITreeSelectWidget | IMultiSelectWidget | IChartWidget | IGalleriaWidget | IImageCompareWidget | ISelectButtonWidget | ITextareaWidget | IAssetWidget;
+    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 interface IWidgetAssetOptions extends IWidgetOptions {
         openModal: (widget: IBaseWidget) => void;
@@ -7879,8 +7925,8 @@ export declare class ComfyApp {
     export declare type TerminalSize = z.infer<typeof zTerminalSize>;
 
     /**
-     * Widget for multi-line text input
-     * This is a widget that only has a Vue widgets implementation
+     * Widget for multi-line text input.
+     * This widget only has a Vue implementation.
      */
     declare class TextareaWidget extends BaseWidget<ITextareaWidget> implements ITextareaWidget {
         type: "textarea";
@@ -8079,8 +8125,8 @@ export declare class ComfyApp {
     }
 
     /**
-     * Widget for hierarchical tree selection
-     * This is a widget that only has a Vue widgets implementation
+     * Widget for hierarchical tree selection.
+     * This widget only has a Vue implementation.
      */
     declare class TreeSelectWidget extends BaseWidget<ITreeSelectWidget> implements ITreeSelectWidget {
         type: "treeselect";
@@ -8227,6 +8273,8 @@ export declare class ComfyApp {
         selectbutton: SelectButtonWidget;
         textarea: TextareaWidget;
         asset: AssetWidget;
+        imagecrop: ImageCropWidget;
+        boundingbox: BoundingBoxWidget;
         [key: string]: BaseWidget;
     };
 

package/package.json

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