merge: resolve conflict with master (add longcat_image to CLIPLoader types)

Merge origin/master into feat/model-placeholder.
Resolved conflict in nodes.py CLIPLoader.INPUT_TYPES:
- Kept placeholder support from feature branch
- Added 'longcat_image' type from master

Amp-Thread-ID: https://ampcode.com/threads/T-019ca3d1-90de-7013-b649-9e09659d9934

folder_paths.py

@@ -472,6 +472,26 @@ def get_save_image_path(filename_prefix: str, output_dir: str, image_width=0, im
         counter = 1
     return full_output_folder, filename, counter, subfolder, filename_prefix
 
+def get_model_placeholder(folder_name: str) -> str:
+    """Generate placeholder text for empty model dropdowns.
+
+    Args:
+        folder_name: The name of the model folder (e.g., "checkpoints", "loras").
+
+    Returns:
+        A user-friendly placeholder string indicating where models should be placed.
+    """
+    folder_name = map_legacy(folder_name)
+    try:
+        paths = get_folder_paths(folder_name)
+    except KeyError:
+        paths = []
+
+    if paths:
+        return f"No models found — add to: {paths[0]}"
+    return f"No models found for '{folder_name}'..."
+
+
 def get_input_subfolders() -> list[str]:
     """Returns a list of all subfolder paths in the input directory, recursively.
 

nodes.py

@@ -589,7 +589,10 @@ class CheckpointLoaderSimple:
     def INPUT_TYPES(s):
         return {
             "required": {
-                "ckpt_name": (folder_paths.get_filename_list("checkpoints"), {"tooltip": "The name of the checkpoint (model) to load."}),
+                "ckpt_name": (folder_paths.get_filename_list("checkpoints"), {
+                    "tooltip": "The name of the checkpoint (model) to load.",
+                    "placeholder": folder_paths.get_model_placeholder("checkpoints")
+                }),
             }
         }
     RETURN_TYPES = ("MODEL", "CLIP", "VAE")
@@ -639,7 +642,9 @@ class DiffusersLoader:
 class unCLIPCheckpointLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "ckpt_name": (folder_paths.get_filename_list("checkpoints"), ),
+        return {"required": { "ckpt_name": (folder_paths.get_filename_list("checkpoints"), {
+                                "placeholder": folder_paths.get_model_placeholder("checkpoints")
+                             }),
                              }}
     RETURN_TYPES = ("MODEL", "CLIP", "VAE", "CLIP_VISION")
     FUNCTION = "load_checkpoint"
@@ -679,7 +684,10 @@ class LoraLoader:
             "required": {
                 "model": ("MODEL", {"tooltip": "The diffusion model the LoRA will be applied to."}),
                 "clip": ("CLIP", {"tooltip": "The CLIP model the LoRA will be applied to."}),
-                "lora_name": (folder_paths.get_filename_list("loras"), {"tooltip": "The name of the LoRA."}),
+                "lora_name": (folder_paths.get_filename_list("loras"), {
+                    "tooltip": "The name of the LoRA.",
+                    "placeholder": folder_paths.get_model_placeholder("loras")
+                }),
                 "strength_model": ("FLOAT", {"default": 1.0, "min": -100.0, "max": 100.0, "step": 0.01, "tooltip": "How strongly to modify the diffusion model. This value can be negative."}),
                 "strength_clip": ("FLOAT", {"default": 1.0, "min": -100.0, "max": 100.0, "step": 0.01, "tooltip": "How strongly to modify the CLIP model. This value can be negative."}),
             }
@@ -716,7 +724,9 @@ class LoraLoaderModelOnly(LoraLoader):
     @classmethod
     def INPUT_TYPES(s):
         return {"required": { "model": ("MODEL",),
-                              "lora_name": (folder_paths.get_filename_list("loras"), ),
+                              "lora_name": (folder_paths.get_filename_list("loras"), {
+                                  "placeholder": folder_paths.get_model_placeholder("loras")
+                              }),
                               "strength_model": ("FLOAT", {"default": 1.0, "min": -100.0, "max": 100.0, "step": 0.01}),
                               }}
     RETURN_TYPES = ("MODEL",)
@@ -806,7 +816,9 @@ class VAELoader:
 
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "vae_name": (s.vae_list(s), )}}
+        return {"required": { "vae_name": (s.vae_list(s), {
+            "placeholder": folder_paths.get_model_placeholder("vae")
+        })}}
     RETURN_TYPES = ("VAE",)
     FUNCTION = "load_vae"
 
@@ -833,7 +845,9 @@ class VAELoader:
 class ControlNetLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "control_net_name": (folder_paths.get_filename_list("controlnet"), )}}
+        return {"required": { "control_net_name": (folder_paths.get_filename_list("controlnet"), {
+            "placeholder": folder_paths.get_model_placeholder("controlnet")
+        })}}
 
     RETURN_TYPES = ("CONTROL_NET",)
     FUNCTION = "load_controlnet"
@@ -852,7 +866,9 @@ class DiffControlNetLoader:
     @classmethod
     def INPUT_TYPES(s):
         return {"required": { "model": ("MODEL",),
-                              "control_net_name": (folder_paths.get_filename_list("controlnet"), )}}
+                              "control_net_name": (folder_paths.get_filename_list("controlnet"), {
+                                  "placeholder": folder_paths.get_model_placeholder("controlnet")
+                              })}}
 
     RETURN_TYPES = ("CONTROL_NET",)
     FUNCTION = "load_controlnet"
@@ -950,7 +966,9 @@ class ControlNetApplyAdvanced:
 class UNETLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "unet_name": (folder_paths.get_filename_list("diffusion_models"), ),
+        return {"required": { "unet_name": (folder_paths.get_filename_list("diffusion_models"), {
+                                  "placeholder": folder_paths.get_model_placeholder("diffusion_models")
+                              }),
                               "weight_dtype": (["default", "fp8_e4m3fn", "fp8_e4m3fn_fast", "fp8_e5m2"],)
                              }}
     RETURN_TYPES = ("MODEL",)
@@ -975,7 +993,9 @@ class UNETLoader:
 class CLIPLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "clip_name": (folder_paths.get_filename_list("text_encoders"), ),
+        return {"required": { "clip_name": (folder_paths.get_filename_list("text_encoders"), {
+                                  "placeholder": folder_paths.get_model_placeholder("text_encoders")
+                              }),
                               "type": (["stable_diffusion", "stable_cascade", "sd3", "stable_audio", "mochi", "ltxv", "pixart", "cosmos", "lumina2", "wan", "hidream", "chroma", "ace", "omnigen2", "qwen_image", "hunyuan_image", "flux2", "ovis", "longcat_image"], ),
                               },
                 "optional": {
@@ -1002,8 +1022,12 @@ class CLIPLoader:
 class DualCLIPLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "clip_name1": (folder_paths.get_filename_list("text_encoders"), ),
-                              "clip_name2": (folder_paths.get_filename_list("text_encoders"), ),
+        return {"required": { "clip_name1": (folder_paths.get_filename_list("text_encoders"), {
+                                  "placeholder": folder_paths.get_model_placeholder("text_encoders")
+                              }),
+                              "clip_name2": (folder_paths.get_filename_list("text_encoders"), {
+                                  "placeholder": folder_paths.get_model_placeholder("text_encoders")
+                              }),
                               "type": (["sdxl", "sd3", "flux", "hunyuan_video", "hidream", "hunyuan_image", "hunyuan_video_15", "kandinsky5", "kandinsky5_image", "ltxv", "newbie", "ace"], ),
                               },
                 "optional": {
@@ -1032,7 +1056,9 @@ class DualCLIPLoader:
 class CLIPVisionLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "clip_name": (folder_paths.get_filename_list("clip_vision"), ),
+        return {"required": { "clip_name": (folder_paths.get_filename_list("clip_vision"), {
+                                  "placeholder": folder_paths.get_model_placeholder("clip_vision")
+                             }),
                              }}
     RETURN_TYPES = ("CLIP_VISION",)
     FUNCTION = "load_clip"
@@ -1068,7 +1094,9 @@ class CLIPVisionEncode:
 class StyleModelLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "style_model_name": (folder_paths.get_filename_list("style_models"), )}}
+        return {"required": { "style_model_name": (folder_paths.get_filename_list("style_models"), {
+            "placeholder": folder_paths.get_model_placeholder("style_models")
+        })}}
 
     RETURN_TYPES = ("STYLE_MODEL",)
     FUNCTION = "load_style_model"
@@ -1167,7 +1195,9 @@ class unCLIPConditioning:
 class GLIGENLoader:
     @classmethod
     def INPUT_TYPES(s):
-        return {"required": { "gligen_name": (folder_paths.get_filename_list("gligen"), )}}
+        return {"required": { "gligen_name": (folder_paths.get_filename_list("gligen"), {
+            "placeholder": folder_paths.get_model_placeholder("gligen")
+        })}}
 
     RETURN_TYPES = ("GLIGEN",)
     FUNCTION = "load_gligen"