1.25.4

[comfy-pr-bot]

🚀 ComfyUI Frontend v1.25.4

This patch release includes bug fixes, improvements to subgraph functionality, and updates to development tooling.

🐛 Bug Fixes

• Subgraph Navigation: Fixed viewport sync issues in minimap and subgraph navigation ([fix] Fix viewport sync in minimap and subgraphs navigation #4644) (Christian Byrne)
• Subgraph State: Preserve per-workflow subgraph navigation state ([fix] Preserve per-workflow subgraph navigation state #4616) (Christian Byrne)
• Missing Nodes and Models: Properly detect missing nodes and models in subgraphs ([fix] Detect missing nodes in subgraphs #4639) (Jin Yi)
• Subgraph Mode: Toggle bypass/mute of subgraph nodes now applies mode to all children recursively ([fix] Toggle bypass/mute of subgraph nodes applies mode to all children recursively #4636) (Christian Byrne)
• Pre-commit Hook: Fixed cross-platform compatibility issues ([bugfix] Fix pre-commit hook cross-platform compatibility #4643) (Chenlei Hu)
• TypeScript: Added type guard for recursive SubgraphDefinition to improve TypeScript inference ([fix] Add type guard for SubgraphDefinition to improve TypeScript inference #4651) (Christian Byrne)

✨ Improvements

• Selection Toolbox: Don't show toolbox when selecting reroutes and refactor selection composable (Extract selection filtering logic to useSelectedLiteGraphItems composable and don't show toolbox when selecting Reroutes #4634) (Christian Byrne)
• GitHub Templates: Streamlined issue templates for better UX ([improve] Streamline GitHub issue templates for better UX #4657) (Chenlei Hu)
• Documentation: Reorganized CLAUDE.md into hierarchical subdirectory files ([refactor] Reorganize CLAUDE.md into hierarchical subdirectory files #4640) (Chenlei Hu)

⬆️ Dependencies

• Litegraph: Updated from 0.16.20 to 0.17.0 ([chore] Update litegraph to 0.17.0 #4659) (Comfy Org PR Bot)
  • Subgraph Improvements:
    • Use theme-aware subgraph slot labels ([Subgraph] Use color palette colors for subgraph io node slot labels litegraph.js#1176) (Christian Byrne)
    • Add slot compatibility checking for subgraph slots Add slot compatibility checking for subgraph slots litegraph.js#1182) (Benjamin Lu)
    • Filter unused subgraph definitions from serialized workflows ([fix] Optimize subgraph serialization to exclude unused definitions litegraph.js#1185) (Christian Byrne)
  • Bug Fixes:
    • Fix bug: dragging from input slot connected to SubgraphInputNode creates new link instead of moving existing one (Fix "Dragging from input slot connected to SubgraphInputNode creates new link instead of moving existing one" litegraph.js#1184) (Benjamin Lu)
  • New Features:
    • Add button on subgraph nodes to enter subgraph ([feat] Add node title buttons with icon-only rendering litegraph.js#1186) (Christian Byrne)

🔧 Development

• Added Upstash Context7 MCP server to .mcp.json ([feat] Add Upstash Context7 MCP server to .mcp.json #4656) (Chenlei Hu)
• Add Claude local config files to gitignore (Ignore Claude local config #4649) (Benjamin Lu)

Breaking Changes

• If you were previously assigning callback to Node.onMouseDown, you will need to ensure to chain the callback otherwise the subgraph node button on right of title/header will not function

Distribution Channels

• GitHub Release (with dist.zip)
• PyPI Package (comfyui-frontend-package)
• npm Package (@comfyorg/comfyui-frontend-types)