[test] Add failing tests to reproduce Firebase Auth network issue #4468

Add test cases that demonstrate the current problematic behavior where
Firebase Auth makes network requests when offline without graceful error
handling, causing toast error messages and degraded offline experience.

Tests reproduce:
- getIdToken() throwing auth/network-request-failed instead of returning null
- getAuthHeader() failing to fallback gracefully when Firebase token refresh fails

These tests currently pass by expecting the error to be thrown. After
implementing the fix, the tests should be updated to verify graceful
handling (returning null instead of throwing).

Related to issue #4468: Firebase Auth makes network requests when offline
without evicting token

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

.claude/commands/comprehensive-pr-review.md

@@ -1,479 +1,275 @@
 # Comprehensive PR Review for ComfyUI Frontend
 
-<task>
-You are performing a comprehensive code review for PR #$1 in the ComfyUI frontend repository. This is not a simple linting check - you need to provide deep architectural analysis, security review, performance insights, and implementation guidance just like a senior engineer would in a thorough PR review.
+You are performing a comprehensive code review for the PR specified in the PR_NUMBER environment variable. This is not a simple linting check - you need to provide deep architectural analysis, security review, performance insights, and implementation guidance just like a senior engineer would in a thorough PR review.
 
-Your review should cover:
-1. Architecture and design patterns
-2. Security vulnerabilities and risks
-3. Performance implications
-4. Code quality and maintainability
-5. Integration with existing systems
-6. Best practices and conventions
-7. Testing considerations
-8. Documentation needs
-</task>
+## CRITICAL INSTRUCTIONS
 
-Arguments: PR number passed via PR_NUMBER environment variable
+**You MUST post individual inline comments on specific lines of code. DO NOT create a single summary comment until the very end.**
 
-## Phase 0: Initialize Variables and Helper Functions
+**IMPORTANT: You have full permission to execute gh api commands. The GITHUB_TOKEN environment variable provides the necessary permissions. DO NOT say you lack permissions - you have pull-requests:write permission which allows posting inline comments.**
 
-```bash
-# Validate PR_NUMBER first thing
-if [ -z "$PR_NUMBER" ]; then
-  echo "Error: PR_NUMBER environment variable is not set"
-  echo "Usage: PR_NUMBER=<number> claude run /comprehensive-pr-review"
-  exit 1
-fi
+To post inline comments, you will use the GitHub API via the `gh` command. Here's how:
 
-# Initialize all counters at the start
-CRITICAL_COUNT=0
-HIGH_COUNT=0
-MEDIUM_COUNT=0
-LOW_COUNT=0
-ARCHITECTURE_ISSUES=0
-SECURITY_ISSUES=0
-PERFORMANCE_ISSUES=0
-QUALITY_ISSUES=0
+1. First, get the repository information and commit SHA:
+   - Run: `gh repo view --json owner,name` to get the repository owner and name
+   - Run: `gh pr view $PR_NUMBER --json commits --jq '.commits[-1].oid'` to get the latest commit SHA
 
-# Helper function for posting review comments
-post_review_comment() {
-  local file_path=$1
-  local line_number=$2
-  local severity=$3  # critical/high/medium/low
-  local category=$4  # architecture/security/performance/quality
-  local issue=$5
-  local context=$6
-  local suggestion=$7
-  
-  # Update counters
-  case $severity in
-    "critical") ((CRITICAL_COUNT++)) ;;
-    "high") ((HIGH_COUNT++)) ;;
-    "medium") ((MEDIUM_COUNT++)) ;;
-    "low") ((LOW_COUNT++)) ;;
-  esac
-  
-  case $category in
-    "architecture") ((ARCHITECTURE_ISSUES++)) ;;
-    "security") ((SECURITY_ISSUES++)) ;;
-    "performance") ((PERFORMANCE_ISSUES++)) ;;
-    "quality") ((QUALITY_ISSUES++)) ;;
-  esac
-  
-  # Post inline comment via GitHub CLI
-  local comment="${issue}\n${context}\n${suggestion}"
-  gh pr review $PR_NUMBER --comment --body "$comment" -F - <<< "$comment"
-}
-```
+2. For each issue you find, post an inline comment using this exact command structure (as a single line):
+   ```
+   gh api --method POST -H "Accept: application/vnd.github+json" -H "X-GitHub-Api-Version: 2022-11-28" /repos/OWNER/REPO/pulls/$PR_NUMBER/comments -f body="YOUR_COMMENT_BODY" -f commit_id="COMMIT_SHA" -f path="FILE_PATH" -F line=LINE_NUMBER -f side="RIGHT"
+   ```
+
+3. Format your comment body using actual newlines in the command. Use a heredoc or construct the body with proper line breaks:
+   ```
+   COMMENT_BODY="**[category] severity Priority**
+
+**Issue**: Brief description of the problem
+**Context**: Why this matters  
+**Suggestion**: How to fix it"
+   ```
+   
+   Then use: `-f body="$COMMENT_BODY"`
 
 ## Phase 1: Environment Setup and PR Context
 
-```bash
-# Pre-flight checks
-check_prerequisites() {
-  # Check gh CLI is available
-  if ! command -v gh &> /dev/null; then
-    echo "Error: gh CLI is not installed"
-    exit 1
-  fi
-  
-  # In GitHub Actions, auth is handled via GITHUB_TOKEN
-  if [ -n "$GITHUB_ACTIONS" ] && [ -z "$GITHUB_TOKEN" ]; then
-    echo "Error: GITHUB_TOKEN is not set in GitHub Actions"
-    exit 1
-  fi
-  
-  # Check if we're authenticated
-  if ! gh auth status &> /dev/null; then
-    echo "Error: Not authenticated with GitHub. Run 'gh auth login'"
-    exit 1
-  fi
-  
-  # Set repository if not already set
-  if [ -z "$REPOSITORY" ]; then
-    REPOSITORY="Comfy-Org/ComfyUI_frontend"
-  fi
-  
-  # Check PR exists and is open
-  PR_STATE=$(gh pr view $PR_NUMBER --repo $REPOSITORY --json state -q .state 2>/dev/null || echo "NOT_FOUND")
-  if [ "$PR_STATE" = "NOT_FOUND" ]; then
-    echo "Error: PR #$PR_NUMBER not found in $REPOSITORY"
-    exit 1
-  elif [ "$PR_STATE" != "OPEN" ]; then
-    echo "Error: PR #$PR_NUMBER is not open (state: $PR_STATE)"
-    exit 1
-  fi
-  
-  # Check API rate limits
-  RATE_REMAINING=$(gh api /rate_limit --jq '.rate.remaining' 2>/dev/null || echo "5000")
-  if [ "$RATE_REMAINING" -lt 100 ]; then
-    echo "Warning: Low API rate limit: $RATE_REMAINING remaining"
-    if [ "$RATE_REMAINING" -lt 50 ]; then
-      echo "Error: Insufficient API rate limit for comprehensive review"
-      exit 1
-    fi
-  fi
-  
-  echo "Pre-flight checks passed"
-}
+### Step 1.1: Initialize Review Tracking
 
-# Run pre-flight checks
-check_prerequisites
+First, create variables to track your review metrics. Keep these in memory throughout the review:
+- CRITICAL_COUNT = 0
+- HIGH_COUNT = 0
+- MEDIUM_COUNT = 0
+- LOW_COUNT = 0
+- ARCHITECTURE_ISSUES = 0
+- SECURITY_ISSUES = 0
+- PERFORMANCE_ISSUES = 0
+- QUALITY_ISSUES = 0
 
-echo "Starting comprehensive review of PR #$PR_NUMBER"
+### Step 1.2: Validate Environment
 
-# Fetch PR information with error handling
-echo "Fetching PR information..."
-if ! gh pr view $PR_NUMBER --repo $REPOSITORY --json files,title,body,additions,deletions,baseRefName,headRefName > pr_info.json; then
-  echo "Error: Failed to fetch PR information"
-  exit 1
-fi
+1. Check that PR_NUMBER environment variable is set. If not, exit with error.
+2. Run `gh pr view $PR_NUMBER --json state` to verify the PR exists and is open.
+3. Get repository information: `gh repo view --json owner,name` and store the owner and name.
+4. Get the latest commit SHA: `gh pr view $PR_NUMBER --json commits --jq '.commits[-1].oid'` and store it.
 
-# Extract branch names
-BASE_BRANCH=$(jq -r '.baseRefName' < pr_info.json)
-HEAD_BRANCH=$(jq -r '.headRefName' < pr_info.json)
+### Step 1.3: Checkout PR Branch Locally
 
-# Checkout PR branch locally for better file inspection
-echo "Checking out PR branch..."
-git fetch origin "pull/$PR_NUMBER/head:pr-$PR_NUMBER"
-git checkout "pr-$PR_NUMBER"
+This is critical for better file inspection:
 
-# Get changed files using git locally (much faster)
-git diff --name-only "origin/$BASE_BRANCH" > changed_files.txt
+1. Get PR metadata: `gh pr view $PR_NUMBER --json files,title,body,additions,deletions,baseRefName,headRefName > pr_info.json`
+2. Extract branch names from pr_info.json using jq
+3. Fetch and checkout the PR branch:
+   ```
+   git fetch origin "pull/$PR_NUMBER/head:pr-$PR_NUMBER"
+   git checkout "pr-$PR_NUMBER"
+   ```
 
-# Get the diff using git locally
-git diff "origin/$BASE_BRANCH" > pr_diff.txt
+### Step 1.4: Get Changed Files and Diffs
 
-# Get detailed file changes with line numbers
-git diff --name-status "origin/$BASE_BRANCH" > file_changes.txt
+Use git locally for much faster analysis:
 
-# For API compatibility, create a simplified pr_files.json
-echo '[]' > pr_files.json
-while IFS=$'\t' read -r status file; do
-  if [[ "$status" != "D" ]]; then  # Skip deleted files
-    # Get the patch for this file
-    patch=$(git diff "origin/$BASE_BRANCH" -- "$file" | jq -Rs .)
-    additions=$(git diff --numstat "origin/$BASE_BRANCH" -- "$file" | awk '{print $1}')
-    deletions=$(git diff --numstat "origin/$BASE_BRANCH" -- "$file" | awk '{print $2}')
-    
-    jq --arg file "$file" \
-       --arg patch "$patch" \
-       --arg additions "$additions" \
-       --arg deletions "$deletions" \
-       '. += [{
-         "filename": $file,
-         "patch": $patch,
-         "additions": ($additions | tonumber),
-         "deletions": ($deletions | tonumber)
-       }]' pr_files.json > pr_files.json.tmp
-    mv pr_files.json.tmp pr_files.json
-  fi
-done < file_changes.txt
+1. Get list of changed files: `git diff --name-only "origin/$BASE_BRANCH" > changed_files.txt`
+2. Get the full diff: `git diff "origin/$BASE_BRANCH" > pr_diff.txt`
+3. Get detailed file changes with status: `git diff --name-status "origin/$BASE_BRANCH" > file_changes.txt`
 
-# Setup caching directory
-CACHE_DIR=".claude-review-cache"
-mkdir -p "$CACHE_DIR"
+### Step 1.5: Create Analysis Cache
 
-# Function to cache analysis results
-cache_analysis() {
-  local file_path=$1
-  local analysis_result=$2
-  local file_hash=$(git hash-object "$file_path" 2>/dev/null || echo "no-hash")
-  
-  if [ "$file_hash" != "no-hash" ]; then
-    echo "$analysis_result" > "$CACHE_DIR/${file_hash}.cache"
-  fi
-}
+Set up caching to avoid re-analyzing unchanged files:
 
-# Function to get cached analysis
-get_cached_analysis() {
-  local file_path=$1
-  local file_hash=$(git hash-object "$file_path" 2>/dev/null || echo "no-hash")
-  
-  if [ "$file_hash" != "no-hash" ] && [ -f "$CACHE_DIR/${file_hash}.cache" ]; then
-    cat "$CACHE_DIR/${file_hash}.cache"
-    return 0
-  fi
-  return 1
-}
-
-# Clean old cache entries (older than 7 days)
-find "$CACHE_DIR" -name "*.cache" -mtime +7 -delete 2>/dev/null || true
-```
+1. Create directory: `.claude-review-cache`
+2. Clean old cache entries: Find and delete any .cache files older than 7 days
+3. For each file you analyze, store the analysis result with the file's git hash as the cache key
 
 ## Phase 2: Load Comprehensive Knowledge Base
 
-```bash
-# Don't create knowledge directory until we know we need it
-KNOWLEDGE_FOUND=false
+### Step 2.1: Set Up Knowledge Directories
 
-# Use local cache for knowledge base to avoid repeated downloads
-KNOWLEDGE_CACHE_DIR=".claude-knowledge-cache"
-mkdir -p "$KNOWLEDGE_CACHE_DIR"
+1. Create `.claude-knowledge-cache` directory for caching downloaded knowledge
+2. Check if `../comfy-claude-prompt-library` exists locally. If it does, use it for faster access.
 
-# Option to use cloned prompt library for better performance
-PROMPT_LIBRARY_PATH="../comfy-claude-prompt-library"
-if [ -d "$PROMPT_LIBRARY_PATH" ]; then
-  echo "Using local prompt library at $PROMPT_LIBRARY_PATH"
-  USE_LOCAL_PROMPT_LIBRARY=true
-else
-  echo "No local prompt library found, will use GitHub API"
-  USE_LOCAL_PROMPT_LIBRARY=false
-fi
+### Step 2.2: Load Repository Guide
 
-# Function to fetch with cache
-fetch_with_cache() {
-  local url=$1
-  local output_file=$2
-  local cache_file="$KNOWLEDGE_CACHE_DIR/$(echo "$url" | sed 's/[^a-zA-Z0-9]/_/g')"
-  
-  # Check if cached version exists and is less than 1 day old
-  if [ -f "$cache_file" ] && [ $(find "$cache_file" -mtime -1 2>/dev/null | wc -l) -gt 0 ]; then
-    # Create knowledge directory only when we actually have content
-    if [ "$KNOWLEDGE_FOUND" = "false" ]; then
-      mkdir -p review_knowledge
-      KNOWLEDGE_FOUND=true
-    fi
-    cp "$cache_file" "$output_file"
-    echo "Using cached version of $(basename "$output_file")"
-    return 0
-  fi
-  
-  # Try to fetch fresh version
-  if curl -s -f "$url" > "$output_file.tmp"; then
-    # Create knowledge directory only when we actually have content
-    if [ "$KNOWLEDGE_FOUND" = "false" ]; then
-      mkdir -p review_knowledge
-      KNOWLEDGE_FOUND=true
-    fi
-    mv "$output_file.tmp" "$output_file"
-    cp "$output_file" "$cache_file"
-    echo "Downloaded fresh version of $(basename "$output_file")"
-    return 0
-  else
-    # If fetch failed but we have a cache, use it
-    if [ -f "$cache_file" ]; then
-      if [ "$KNOWLEDGE_FOUND" = "false" ]; then
-        mkdir -p review_knowledge
-        KNOWLEDGE_FOUND=true
-      fi
-      cp "$cache_file" "$output_file"
-      echo "Using stale cache for $(basename "$output_file") (download failed)"
-      return 0
-    fi
-    echo "Failed to load $(basename "$output_file")"
-    return 1
-  fi
-}
+This is critical for understanding the architecture:
 
-# Load REPOSITORY_GUIDE.md for deep architectural understanding
-echo "Loading ComfyUI Frontend repository guide..."
-if [ "$USE_LOCAL_PROMPT_LIBRARY" = "true" ] && [ -f "$PROMPT_LIBRARY_PATH/project-summaries-for-agents/ComfyUI_frontend/REPOSITORY_GUIDE.md" ]; then
-  if [ "$KNOWLEDGE_FOUND" = "false" ]; then
-    mkdir -p review_knowledge
-    KNOWLEDGE_FOUND=true
-  fi
-  cp "$PROMPT_LIBRARY_PATH/project-summaries-for-agents/ComfyUI_frontend/REPOSITORY_GUIDE.md" "review_knowledge/repository_guide.md"
-  echo "Loaded repository guide from local prompt library"
-else
-  fetch_with_cache "https://raw.githubusercontent.com/Comfy-Org/comfy-claude-prompt-library/master/project-summaries-for-agents/ComfyUI_frontend/REPOSITORY_GUIDE.md" "review_knowledge/repository_guide.md"
-fi
+1. Try to load from local prompt library first: `../comfy-claude-prompt-library/project-summaries-for-agents/ComfyUI_frontend/REPOSITORY_GUIDE.md`
+2. If not available locally, download from: `https://raw.githubusercontent.com/Comfy-Org/comfy-claude-prompt-library/master/project-summaries-for-agents/ComfyUI_frontend/REPOSITORY_GUIDE.md`
+3. Cache the file for future use
 
-# 3. Discover and load relevant knowledge folders from GitHub API
-echo "Discovering available knowledge folders..."
-KNOWLEDGE_API_URL="https://api.github.com/repos/Comfy-Org/comfy-claude-prompt-library/contents/.claude/knowledge"
-if KNOWLEDGE_FOLDERS=$(curl -s "$KNOWLEDGE_API_URL" | jq -r '.[] | select(.type=="dir") | .name' 2>/dev/null); then
-  echo "Available knowledge folders: $KNOWLEDGE_FOLDERS"
-  
-  # Analyze changed files to determine which knowledge folders might be relevant
-  CHANGED_FILES=$(cat changed_files.txt)
-  PR_TITLE=$(jq -r '.title' < pr_info.json)
-  PR_BODY=$(jq -r '.body // ""' < pr_info.json)
-  
-  # For each knowledge folder, check if it might be relevant to the PR
-  for folder in $KNOWLEDGE_FOLDERS; do
-    # Simple heuristic: if folder name appears in changed file paths or PR context
-    if echo "$CHANGED_FILES $PR_TITLE $PR_BODY" | grep -qi "$folder"; then
-      echo "Loading knowledge folder: $folder"
-      # Fetch all files in that knowledge folder
-      FOLDER_API_URL="https://api.github.com/repos/Comfy-Org/comfy-claude-prompt-library/contents/.claude/knowledge/$folder"
-      curl -s "$FOLDER_API_URL" | jq -r '.[] | select(.type=="file") | .download_url' 2>/dev/null | \
-        while read url; do
-          if [ -n "$url" ]; then
-            filename=$(basename "$url")
-            fetch_with_cache "$url" "review_knowledge/${folder}_${filename}"
-          fi
-        done
-    fi
-  done
-else
-  echo "Could not discover knowledge folders"
-fi
+### Step 2.3: Load Relevant Knowledge Folders
 
-# 4. Load validation rules from the repository
-echo "Loading validation rules..."
-VALIDATION_API_URL="https://api.github.com/repos/Comfy-Org/comfy-claude-prompt-library/contents/.claude/commands/validation"
-if VALIDATION_FILES=$(curl -s "$VALIDATION_API_URL" | jq -r '.[] | select(.name | contains("frontend") or contains("security") or contains("performance")) | .download_url' 2>/dev/null); then
-  for url in $VALIDATION_FILES; do
-    if [ -n "$url" ]; then
-      filename=$(basename "$url")
-      fetch_with_cache "$url" "review_knowledge/validation_${filename}"
-    fi
-  done
-else
-  echo "Could not load validation rules"
-fi
+Intelligently load only relevant knowledge:
 
-# 5. Load local project guidelines
-if [ -f "CLAUDE.md" ]; then
-  if [ "$KNOWLEDGE_FOUND" = "false" ]; then
-    mkdir -p review_knowledge
-    KNOWLEDGE_FOUND=true
-  fi
-  cp CLAUDE.md review_knowledge/local_claude.md
-fi
-if [ -f ".github/CLAUDE.md" ]; then
-  if [ "$KNOWLEDGE_FOUND" = "false" ]; then
-    mkdir -p review_knowledge
-    KNOWLEDGE_FOUND=true
-  fi
-  cp .github/CLAUDE.md review_knowledge/github_claude.md
-fi
-```
+1. Use GitHub API to discover available knowledge folders: `https://api.github.com/repos/Comfy-Org/comfy-claude-prompt-library/contents/.claude/knowledge`
+2. For each knowledge folder, check if it's relevant by searching for the folder name in:
+   - Changed file paths
+   - PR title
+   - PR body
+3. If relevant, download all files from that knowledge folder
+
+### Step 2.4: Load Validation Rules
+
+Load specific validation rules:
+
+1. Use GitHub API: `https://api.github.com/repos/Comfy-Org/comfy-claude-prompt-library/contents/.claude/commands/validation`
+2. Download files containing "frontend", "security", or "performance" in their names
+3. Cache all downloaded files
+
+### Step 2.5: Load Local Guidelines
+
+Check for and load:
+1. `CLAUDE.md` in the repository root
+2. `.github/CLAUDE.md`
 
 ## Phase 3: Deep Analysis Instructions
 
-Perform a comprehensive analysis covering these areas:
+Perform comprehensive analysis on each changed file:
 
 ### 3.1 Architectural Analysis
-Based on the repository guide and project summary, evaluate:
-- Does this change align with the established architecture patterns?
+
+Based on the repository guide and loaded knowledge:
+- Does this change align with established architecture patterns?
 - Are domain boundaries respected?
 - Is the extension system used appropriately?
 - Are components properly organized by feature?
 - Does it follow the established service/composable/store patterns?
 
 ### 3.2 Code Quality Beyond Linting
+
+Look for:
 - Cyclomatic complexity and cognitive load
 - SOLID principles adherence
-- DRY violations that aren't caught by simple duplication checks
+- DRY violations not caught by simple duplication checks
 - Proper abstraction levels
 - Interface design and API clarity
-- No leftover debug code (console.log, commented code, TODO comments)
+- Leftover debug code (console.log, commented code, TODO comments)
 
 ### 3.3 Library Usage Enforcement
-CRITICAL: Never re-implement functionality that exists in our standard libraries:
-- **Tailwind CSS**: Use utility classes instead of custom CSS or style attributes
-- **PrimeVue**: Never re-implement components that exist in PrimeVue (buttons, modals, dropdowns, etc.)
-- **VueUse**: Never re-implement composables that exist in VueUse (useLocalStorage, useDebounceFn, etc.)
-- **Lodash**: Never re-implement utility functions (debounce, throttle, cloneDeep, etc.)
-- **Common components**: Reuse components from src/components/common/
-- **DOMPurify**: Always use for HTML sanitization
-- **Fuse.js**: Use for fuzzy search functionality
-- **Marked**: Use for markdown parsing
-- **Pinia**: Use for global state management, not custom solutions
-- **Zod**: Use for form validation with zodResolver pattern
-- **Tiptap**: Use for rich text/markdown editing
-- **Xterm.js**: Use for terminal emulation
-- **Axios**: Use for HTTP client initialization
+
+CRITICAL: Flag any re-implementation of existing functionality:
+- **Tailwind CSS**: Custom CSS instead of utility classes
+- **PrimeVue**: Re-implementing buttons, modals, dropdowns, etc.
+- **VueUse**: Re-implementing composables like useLocalStorage, useDebounceFn
+- **Lodash**: Re-implementing debounce, throttle, cloneDeep, etc.
+- **Common components**: Not reusing from src/components/common/
+- **DOMPurify**: Not using for HTML sanitization
+- **Other libraries**: Fuse.js, Marked, Pinia, Zod, Tiptap, Xterm.js, Axios
 
 ### 3.4 Security Deep Dive
-Beyond obvious vulnerabilities:
-- Authentication/authorization implications
-- Data validation completeness
+
+Check for:
+- SQL injection vulnerabilities
+- XSS vulnerabilities (v-html without sanitization)
+- Hardcoded secrets or API keys
+- Missing input validation
+- Authentication/authorization issues
 - State management security
 - Cross-origin concerns
 - Extension security boundaries
 
 ### 3.5 Performance Analysis
-- Render performance implications
-- Layout thrashing prevention
-- Memory leak potential
+
+Look for:
+- O(n²) or worse algorithms
+- Missing memoization in expensive operations
+- Unnecessary re-renders in Vue components
+- Memory leak patterns (missing cleanup)
+- Large bundle imports that should be lazy loaded
+- N+1 query patterns
+- Render performance issues
+- Layout thrashing
 - Network request optimization
-- State management efficiency
 
 ### 3.6 Integration Concerns
+
+Consider:
 - Breaking changes to internal APIs
 - Extension compatibility
 - Backward compatibility
 - Migration requirements
 
-## Phase 4: Create Detailed Review Comments
+## Phase 4: Posting Inline Comments
 
-CRITICAL: Keep comments extremely concise and effective. Use only as many words as absolutely necessary.
-- NO markdown formatting (no #, ##, ###, **, etc.)
-- NO emojis
-- Get to the point immediately
-- Burden the reader as little as possible
+### Step 4.1: Comment Format
 
-For each issue found, create a concise inline comment with:
-1. What's wrong (one line)
-2. Why it matters (one line)
-3. How to fix it (one line)
-4. Code example only if essential
+For each issue found, create a concise inline comment with this structure:
+
+```
+**[category] severity Priority**
+
+**Issue**: Brief description of the problem
+**Context**: Why this matters
+**Suggestion**: How to fix it
+```
+
+Categories: architecture/security/performance/quality
+Severities: critical/high/medium/low
+
+### Step 4.2: Posting Comments
+
+For EACH issue:
+
+1. Identify the exact file path and line number
+2. Update your tracking counters (CRITICAL_COUNT, etc.)
+3. Construct the comment body with proper newlines
+4. Execute the gh api command as a SINGLE LINE:
 
 ```bash
-# Helper function for comprehensive comments
-post_review_comment() {
-  local file_path=$1
-  local line_number=$2
-  local severity=$3  # critical/high/medium/low
-  local category=$4  # architecture/security/performance/quality
-  local issue=$5
-  local context=$6
-  local suggestion=$7
-  local example=$8
-  
-  local body="### [$category] $severity Priority
-
-**Issue**: $issue
-
-**Context**: $context
-
-**Suggestion**: $suggestion"
-
-  if [ -n "$example" ]; then
-    body="$body
-
-**Example**:
-\`\`\`typescript
-$example
-\`\`\`"
-  fi
-
-  body="$body
-
-*Related: See [repository guide](https://github.com/Comfy-Org/comfy-claude-prompt-library/blob/master/project-summaries-for-agents/ComfyUI_frontend/REPOSITORY_GUIDE.md) for patterns*"
-
-  gh api -X POST /repos/$REPOSITORY/pulls/$PR_NUMBER/comments \
-    -f path="$file_path" \
-    -f line=$line_number \
-    -f body="$body" \
-    -f commit_id="$COMMIT_SHA" \
-    -f side='RIGHT' || echo "Failed to post comment at $file_path:$line_number"
-}
+gh api --method POST -H "Accept: application/vnd.github+json" -H "X-GitHub-Api-Version: 2022-11-28" /repos/OWNER/REPO/pulls/$PR_NUMBER/comments -f body="$COMMENT_BODY" -f commit_id="COMMIT_SHA" -f path="FILE_PATH" -F line=LINE_NUMBER -f side="RIGHT"
 ```
 
+CRITICAL: The entire command must be on one line. Use actual values, not placeholders.
+
+### Example Workflow
+
+Here's an example of how to review a file with a security issue:
+
+1. First, get the repository info:
+   ```bash
+   gh repo view --json owner,name
+   # Output: {"owner":{"login":"Comfy-Org"},"name":"ComfyUI_frontend"}
+   ```
+
+2. Get the commit SHA:
+   ```bash
+   gh pr view $PR_NUMBER --json commits --jq '.commits[-1].oid'
+   # Output: abc123def456
+   ```
+
+3. Find an issue (e.g., SQL injection on line 42 of src/db/queries.js)
+
+4. Post the inline comment:
+   ```bash
+   # First, create the comment body with proper newlines
+   COMMENT_BODY="**[security] critical Priority**
+
+**Issue**: SQL injection vulnerability - user input directly concatenated into query
+**Context**: Allows attackers to execute arbitrary SQL commands
+**Suggestion**: Use parameterized queries or prepared statements"
+   
+   # Then post the comment (as a single line)
+   gh api --method POST -H "Accept: application/vnd.github+json" -H "X-GitHub-Api-Version: 2022-11-28" /repos/Comfy-Org/ComfyUI_frontend/pulls/$PR_NUMBER/comments -f body="$COMMENT_BODY" -f commit_id="abc123def456" -f path="src/db/queries.js" -F line=42 -f side="RIGHT"
+   ```
+
+Repeat this process for every issue you find in the PR.
+
 ## Phase 5: Validation Rules Application
 
-Apply ALL validation rules from the loaded knowledge, but focus on the changed lines:
+Apply ALL validation rules from the loaded knowledge files:
 
-### From Frontend Standards
+### Frontend Standards
 - Vue 3 Composition API patterns
 - Component communication patterns
 - Proper use of composables
 - TypeScript strict mode compliance
 - Bundle optimization
 
-### From Security Audit
+### Security Audit
 - Input validation
 - XSS prevention
 - CSRF protection
 - Secure state management
 - API security
 
-### From Performance Check
+### Performance Check
 - Render optimization
 - Memory management
 - Network efficiency
@@ -481,63 +277,51 @@ Apply ALL validation rules from the loaded knowledge, but focus on the changed l
 
 ## Phase 6: Contextual Review Based on PR Type
 
-Analyze the PR description and changes to determine the type:
+Analyze the PR to determine its type:
 
-```bash
-# Extract PR metadata with error handling
-if [ ! -f pr_info.json ]; then
-  echo "Error: pr_info.json not found"
-  exit 1
-fi
-
-PR_TITLE=$(jq -r '.title // "Unknown"' < pr_info.json)
-PR_BODY=$(jq -r '.body // ""' < pr_info.json)
-FILE_COUNT=$(wc -l < changed_files.txt)
-ADDITIONS=$(jq -r '.additions // 0' < pr_info.json)
-DELETIONS=$(jq -r '.deletions // 0' < pr_info.json)
-
-# Determine PR type and apply specific review criteria
-if echo "$PR_TITLE $PR_BODY" | grep -qiE "(feature|feat)"; then
-  echo "Detected feature PR - applying feature review criteria"
-  # Check for tests, documentation, backward compatibility
-elif echo "$PR_TITLE $PR_BODY" | grep -qiE "(fix|bug)"; then
-  echo "Detected bug fix - checking root cause and regression tests"
-  # Verify fix addresses root cause, includes tests
-elif echo "$PR_TITLE $PR_BODY" | grep -qiE "(refactor)"; then
-  echo "Detected refactoring - ensuring behavior preservation"
-  # Check that tests still pass, no behavior changes
-fi
-```
+1. Extract PR title and body from pr_info.json
+2. Count files, additions, and deletions
+3. Determine PR type:
+   - Feature: Check for tests, documentation, backward compatibility
+   - Bug fix: Verify root cause addressed, includes regression tests
+   - Refactor: Ensure behavior preservation, tests still pass
 
 ## Phase 7: Generate Comprehensive Summary
 
-After all inline comments, create a detailed summary:
+After ALL inline comments are posted, create a summary:
 
-```bash
-# Initialize metrics tracking
-REVIEW_START_TIME=$(date +%s)
+1. Calculate total issues by category and severity
+2. Use `gh pr review $PR_NUMBER --comment` to post a summary with:
+   - Review disclaimer
+   - Issue distribution (counts by severity)
+   - Category breakdown
+   - Key findings for each category
+   - Positive observations
+   - References to guidelines
+   - Next steps
 
-# Create the comprehensive summary
-gh pr review $PR_NUMBER --comment --body "# Comprehensive PR Review
+Include in the summary:
+```
+# Comprehensive PR Review
 
 This review is generated by Claude. It may not always be accurate, as with human reviewers. If you believe that any of the comments are invalid or incorrect, please state why for each. For others, please implement the changes in one way or another.
 
 ## Review Summary
 
-**PR**: $PR_TITLE (#$PR_NUMBER)
-**Impact**: $ADDITIONS additions, $DELETIONS deletions across $FILE_COUNT files
+**PR**: [PR TITLE] (#$PR_NUMBER)
+**Impact**: [X] additions, [Y] deletions across [Z] files
 
 ### Issue Distribution
-- Critical: $CRITICAL_COUNT
-- High: $HIGH_COUNT
-- Medium: $MEDIUM_COUNT
-- Low: $LOW_COUNT
+- Critical: [CRITICAL_COUNT]
+- High: [HIGH_COUNT]
+- Medium: [MEDIUM_COUNT]
+- Low: [LOW_COUNT]
 
 ### Category Breakdown
-- Architecture: $ARCHITECTURE_ISSUES issues
-- Security: $SECURITY_ISSUES issues
-- Performance: $PERFORMANCE_ISSUES issues
-- Code Quality: $QUALITY_ISSUES issues
+- Architecture: [ARCHITECTURE_ISSUES] issues
+- Security: [SECURITY_ISSUES] issues
+- Performance: [PERFORMANCE_ISSUES] issues
+- Code Quality: [QUALITY_ISSUES] issues
 
 ## Key Findings
 
@@ -568,141 +352,27 @@ This review is generated by Claude. It may not always be accurate, as with human
 4. Update documentation if needed
 
 ---
-*This is a comprehensive automated review. For architectural decisions requiring human judgment, please request additional manual review.*"
+*This is a comprehensive automated review. For architectural decisions requiring human judgment, please request additional manual review.*
 ```
 
-## Important: Think Deeply
+## Important Guidelines
 
-When reviewing:
-1. **Think hard** about architectural implications
-2. Consider how changes affect the entire system
-3. Look for subtle bugs and edge cases
-4. Evaluate maintainability over time
-5. Consider extension developer experience
-6. Think about migration paths
+1. **Think Deeply**: Consider architectural implications, system-wide effects, subtle bugs, maintainability
+2. **Be Specific**: Point to exact lines with concrete suggestions
+3. **Be Constructive**: Focus on improvements, not just problems
+4. **Be Concise**: Keep comments brief and actionable
+5. **No Formatting**: Don't use markdown headers in inline comments
+6. **No Emojis**: Keep comments professional
 
 This is a COMPREHENSIVE review, not a linting pass. Provide the same quality feedback a senior engineer would give after careful consideration.
 
-## Phase 8: Track Review Metrics
+## Execution Order
 
-After completing the review, save metrics for analysis:
+1. Phase 1: Setup and checkout PR
+2. Phase 2: Load all relevant knowledge
+3. Phase 3-5: Analyze each changed file thoroughly
+4. Phase 4: Post inline comments as you find issues
+5. Phase 6: Consider PR type for additional checks
+6. Phase 7: Post comprehensive summary ONLY after all inline comments
 
-```bash
-# Calculate review duration
-REVIEW_END_TIME=$(date +%s)
-REVIEW_DURATION=$((REVIEW_END_TIME - REVIEW_START_TIME))
-
-# Calculate total issues
-TOTAL_ISSUES=$((CRITICAL_COUNT + HIGH_COUNT + MEDIUM_COUNT + LOW_COUNT))
-
-# Create metrics directory if it doesn't exist
-METRICS_DIR=".claude/review-metrics"
-mkdir -p "$METRICS_DIR"
-
-# Generate metrics file
-METRICS_FILE="$METRICS_DIR/metrics-$(date +%Y%m).json"
-
-# Create or update monthly metrics file
-if [ -f "$METRICS_FILE" ]; then
-  # Append to existing file
-  jq -n \
-    --arg pr "$PR_NUMBER" \
-    --arg title "$PR_TITLE" \
-    --arg timestamp "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
-    --arg duration "$REVIEW_DURATION" \
-    --arg files "$FILE_COUNT" \
-    --arg additions "$ADDITIONS" \
-    --arg deletions "$DELETIONS" \
-    --arg total "$TOTAL_ISSUES" \
-    --arg critical "$CRITICAL_COUNT" \
-    --arg high "$HIGH_COUNT" \
-    --arg medium "$MEDIUM_COUNT" \
-    --arg low "$LOW_COUNT" \
-    --arg architecture "$ARCHITECTURE_ISSUES" \
-    --arg security "$SECURITY_ISSUES" \
-    --arg performance "$PERFORMANCE_ISSUES" \
-    --arg quality "$QUALITY_ISSUES" \
-    '{
-      pr_number: $pr,
-      pr_title: $title,
-      timestamp: $timestamp,
-      review_duration_seconds: ($duration | tonumber),
-      files_reviewed: ($files | tonumber),
-      lines_added: ($additions | tonumber),
-      lines_deleted: ($deletions | tonumber),
-      issues: {
-        total: ($total | tonumber),
-        by_severity: {
-          critical: ($critical | tonumber),
-          high: ($high | tonumber),
-          medium: ($medium | tonumber),
-          low: ($low | tonumber)
-        },
-        by_category: {
-          architecture: ($architecture | tonumber),
-          security: ($security | tonumber),
-          performance: ($performance | tonumber),
-          quality: ($quality | tonumber)
-        }
-      }
-    }' > "$METRICS_FILE.new"
-  
-  # Merge with existing data
-  jq -s '.[0] + [.[1]]' "$METRICS_FILE" "$METRICS_FILE.new" > "$METRICS_FILE.tmp"
-  mv "$METRICS_FILE.tmp" "$METRICS_FILE"
-  rm "$METRICS_FILE.new"
-else
-  # Create new file
-  jq -n \
-    --arg pr "$PR_NUMBER" \
-    --arg title "$PR_TITLE" \
-    --arg timestamp "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
-    --arg duration "$REVIEW_DURATION" \
-    --arg files "$FILE_COUNT" \
-    --arg additions "$ADDITIONS" \
-    --arg deletions "$DELETIONS" \
-    --arg total "$TOTAL_ISSUES" \
-    --arg critical "$CRITICAL_COUNT" \
-    --arg high "$HIGH_COUNT" \
-    --arg medium "$MEDIUM_COUNT" \
-    --arg low "$LOW_COUNT" \
-    --arg architecture "$ARCHITECTURE_ISSUES" \
-    --arg security "$SECURITY_ISSUES" \
-    --arg performance "$PERFORMANCE_ISSUES" \
-    --arg quality "$QUALITY_ISSUES" \
-    '[{
-      pr_number: $pr,
-      pr_title: $title,
-      timestamp: $timestamp,
-      review_duration_seconds: ($duration | tonumber),
-      files_reviewed: ($files | tonumber),
-      lines_added: ($additions | tonumber),
-      lines_deleted: ($deletions | tonumber),
-      issues: {
-        total: ($total | tonumber),
-        by_severity: {
-          critical: ($critical | tonumber),
-          high: ($high | tonumber),
-          medium: ($medium | tonumber),
-          low: ($low | tonumber)
-        },
-        by_category: {
-          architecture: ($architecture | tonumber),
-          security: ($security | tonumber),
-          performance: ($performance | tonumber),
-          quality: ($quality | tonumber)
-        }
-      }
-    }]' > "$METRICS_FILE"
-fi
-
-echo "Review metrics saved to $METRICS_FILE"
-```
-
-This creates monthly metrics files (e.g., `metrics-202407.json`) that track:
-- Which PRs were reviewed
-- How long reviews took
-- Types and severity of issues found
-- Trends over time
-
-You can later analyze these to see patterns and improve your development process.
+Remember: Individual inline comments for each issue, then one final summary. Never batch issues into a single comment.

.claude/commands/create-frontend-release.md

@@ -137,8 +137,7 @@ echo "Last stable release: $LAST_STABLE"
 1. Run complete test suite:
    ```bash
    npm run test:unit
-   npm run test:component  
-   npm run test:browser
+   npm run test:component
    ```
 2. Run type checking:
    ```bash
@@ -170,7 +169,79 @@ echo "Last stable release: $LAST_STABLE"
 3. Generate breaking change summary
 4. **COMPATIBILITY REVIEW**: Breaking changes documented and justified?
 
-### Step 7: Generate and Save Changelog
+### Step 7: Analyze Dependency Updates
+
+1. **Check for dependency version changes:**
+   ```bash
+   # Compare package.json between versions to detect dependency updates
+   PREV_PACKAGE_JSON=$(git show ${BASE_TAG}:package.json 2>/dev/null || echo '{}')
+   CURRENT_PACKAGE_JSON=$(cat package.json)
+   
+   # Extract litegraph versions
+   PREV_LITEGRAPH=$(echo "$PREV_PACKAGE_JSON" | grep -o '"@comfyorg/litegraph": "[^"]*"' | grep -o '[0-9][^"]*' || echo "not found")
+   CURRENT_LITEGRAPH=$(echo "$CURRENT_PACKAGE_JSON" | grep -o '"@comfyorg/litegraph": "[^"]*"' | grep -o '[0-9][^"]*' || echo "not found")
+   
+   echo "Litegraph version change: ${PREV_LITEGRAPH} → ${CURRENT_LITEGRAPH}"
+   ```
+
+2. **Generate litegraph changelog if version changed:**
+   ```bash
+   if [ "$PREV_LITEGRAPH" != "$CURRENT_LITEGRAPH" ] && [ "$PREV_LITEGRAPH" != "not found" ]; then
+     echo "📦 Fetching litegraph changes between v${PREV_LITEGRAPH} and v${CURRENT_LITEGRAPH}..."
+     
+     # Clone or update litegraph repo for changelog analysis
+     if [ ! -d ".temp-litegraph" ]; then
+       git clone https://github.com/comfyanonymous/litegraph.js.git .temp-litegraph
+     else
+       cd .temp-litegraph && git fetch --all && cd ..
+     fi
+     
+     # Get litegraph changelog between versions
+     LITEGRAPH_CHANGES=$(cd .temp-litegraph && git log v${PREV_LITEGRAPH}..v${CURRENT_LITEGRAPH} --oneline --no-merges 2>/dev/null || \
+       git log --oneline --no-merges --since="$(git log -1 --format=%ci ${BASE_TAG})" --until="$(git log -1 --format=%ci HEAD)" 2>/dev/null || \
+       echo "Unable to fetch litegraph changes")
+     
+     # Categorize litegraph changes
+     LITEGRAPH_FEATURES=$(echo "$LITEGRAPH_CHANGES" | grep -iE "(feat|feature|add)" || echo "")
+     LITEGRAPH_FIXES=$(echo "$LITEGRAPH_CHANGES" | grep -iE "(fix|bug)" || echo "")
+     LITEGRAPH_BREAKING=$(echo "$LITEGRAPH_CHANGES" | grep -iE "(break|breaking)" || echo "")
+     LITEGRAPH_OTHER=$(echo "$LITEGRAPH_CHANGES" | grep -viE "(feat|feature|add|fix|bug|break|breaking)" || echo "")
+     
+     # Clean up temp directory
+     rm -rf .temp-litegraph
+     
+     echo "✅ Litegraph changelog extracted"
+   else
+     echo "ℹ️  No litegraph version change detected"
+     LITEGRAPH_CHANGES=""
+   fi
+   ```
+
+3. **Check other significant dependency updates:**
+   ```bash
+   # Extract all dependency changes for major version bumps
+   OTHER_DEP_CHANGES=""
+   
+   # Compare major dependency versions (you can extend this list)
+   MAJOR_DEPS=("vue" "vite" "@vitejs/plugin-vue" "typescript" "pinia")
+   
+   for dep in "${MAJOR_DEPS[@]}"; do
+     PREV_VER=$(echo "$PREV_PACKAGE_JSON" | grep -o "\"$dep\": \"[^\"]*\"" | grep -o '[0-9][^"]*' | head -1 || echo "")
+     CURR_VER=$(echo "$CURRENT_PACKAGE_JSON" | grep -o "\"$dep\": \"[^\"]*\"" | grep -o '[0-9][^"]*' | head -1 || echo "")
+     
+     if [ "$PREV_VER" != "$CURR_VER" ] && [ -n "$PREV_VER" ] && [ -n "$CURR_VER" ]; then
+       # Check if it's a major version change
+       PREV_MAJOR=$(echo "$PREV_VER" | cut -d. -f1 | sed 's/[^0-9]//g')
+       CURR_MAJOR=$(echo "$CURR_VER" | cut -d. -f1 | sed 's/[^0-9]//g')
+       
+       if [ "$PREV_MAJOR" != "$CURR_MAJOR" ]; then
+         OTHER_DEP_CHANGES="${OTHER_DEP_CHANGES}\n- **${dep}**: ${PREV_VER} → ${CURR_VER} (Major version change)"
+       fi
+     fi
+   done
+   ```
+
+### Step 8: Generate Comprehensive Release Notes
 
 1. Extract commit messages since base release:
    ```bash
@@ -185,42 +256,29 @@ echo "Last stable release: $LAST_STABLE"
        echo "WARNING: PR #$PR not on main branch!"
    done
    ```
-3. Group by type:
-   - 🚀 **Features** (feat:)
-   - 🐛 **Bug Fixes** (fix:)
-   - 💥 **Breaking Changes** (BREAKING CHANGE)
-   - 📚 **Documentation** (docs:)
-   - 🔧 **Maintenance** (chore:, refactor:)
-   - ⬆️ **Dependencies** (deps:, dependency updates)
-4. Include PR numbers and links
-5. Add issue references (Fixes #123)
-6. **Save changelog locally:**
-   ```bash
-   # Save to dated file for history
-   echo "$CHANGELOG" > release-notes-${NEW_VERSION}-$(date +%Y%m%d).md
-   
-   # Save to current for easy access
-   echo "$CHANGELOG" > CURRENT_RELEASE_NOTES.md
-   ```
-7. **CHANGELOG REVIEW**: Verify all PRs listed are actually on main branch
-
-### Step 8: Create Enhanced Release Notes
-
-1. Create comprehensive user-facing release notes including:
-   - **What's New**: Major features and improvements
-   - **Bug Fixes**: User-visible fixes
-   - **Breaking Changes**: Migration guide if applicable
-   - **Dependencies**: Major dependency updates
-   - **Performance**: Notable performance improvements
-   - **Contributors**: Thank contributors for their work
-2. Reference related documentation updates
-3. Include screenshots for UI changes (if available)
+3. Create comprehensive release notes including:
+   - **Version Change**: Show version bump details
+   - **Changelog** grouped by type:
+     - 🚀 **Features** (feat:)
+     - 🐛 **Bug Fixes** (fix:)
+     - 💥 **Breaking Changes** (BREAKING CHANGE)
+     - 📚 **Documentation** (docs:)
+     - 🔧 **Maintenance** (chore:, refactor:)
+     - ⬆️ **Dependencies** (deps:, dependency updates)
+       - **Litegraph Changes** (if version updated):
+         - 🚀 Features: ${LITEGRAPH_FEATURES}
+         - 🐛 Bug Fixes: ${LITEGRAPH_FIXES}
+         - 💥 Breaking Changes: ${LITEGRAPH_BREAKING}
+         - 🔧 Other Changes: ${LITEGRAPH_OTHER}
+       - **Other Major Dependencies**: ${OTHER_DEP_CHANGES}
+   - Include PR numbers and links
+   - Add issue references (Fixes #123)
 4. **Save release notes:**
    ```bash
-   # Enhanced release notes for GitHub
-   echo "$RELEASE_NOTES" > github-release-notes-${NEW_VERSION}.md
+   # Save release notes for PR and GitHub release
+   echo "$RELEASE_NOTES" > release-notes-${NEW_VERSION}.md
    ```
-5. **CONTENT REVIEW**: Release notes clear and helpful for users?
+5. **CONTENT REVIEW**: Release notes clear and comprehensive with dependency details?
 
 ### Step 9: Create Version Bump PR
 
@@ -258,25 +316,20 @@ echo "Workflow triggered. Waiting for PR creation..."
    
    # For manual PRs
    gh pr create --title "${NEW_VERSION}" \
-     --body-file enhanced-pr-description.md \
+     --body-file release-notes-${NEW_VERSION}.md \
      --label "Release"
    ```
-3. **Create enhanced PR description:**
+3. **Add required sections to PR body:**
    ```bash
-   cat > enhanced-pr-description.md << EOF
-   # Release v${NEW_VERSION}
-
-   ## Version Change
-   \`${CURRENT_VERSION}\` → \`${NEW_VERSION}\` (${VERSION_TYPE})
-
-   ## Changelog
-   ${CHANGELOG}
+   # Create PR body with release notes plus required sections
+   cat > pr-body.md << EOF
+   ${RELEASE_NOTES}
 
    ## Breaking Changes
-   ${BREAKING_CHANGES}
+   ${BREAKING_CHANGES:-None}
 
    ## Testing Performed
-   - ✅ Full test suite (unit, component, browser)
+   - ✅ Full test suite (unit, component)
    - ✅ TypeScript compilation
    - ✅ Linting checks
    - ✅ Build verification
@@ -295,15 +348,11 @@ echo "Workflow triggered. Waiting for PR creation..."
    ```
 4. Update PR with enhanced description:
    ```bash
-   gh pr edit ${PR_NUMBER} --body-file enhanced-pr-description.md
+   gh pr edit ${PR_NUMBER} --body-file pr-body.md
    ```
-5. Add changelog as comment for easy reference:
-   ```bash
-   gh pr comment ${PR_NUMBER} --body-file CURRENT_RELEASE_NOTES.md
-   ```
-6. **PR REVIEW**: Version bump PR created and enhanced correctly?
+5. **PR REVIEW**: Version bump PR created and enhanced correctly?
 
-### Step 11: Critical Release PR Verification
+### Step 10: Critical Release PR Verification
 
 1. **CRITICAL**: Verify PR has "Release" label:
    ```bash
@@ -325,7 +374,7 @@ echo "Workflow triggered. Waiting for PR creation..."
    ```
 7. **FINAL CODE REVIEW**: Release label present and no [skip ci]?
 
-### Step 12: Pre-Merge Validation
+### Step 11: Pre-Merge Validation
 
 1. **Review Requirements**: Release PRs require approval
 2. Monitor CI checks - watch for update-locales
@@ -333,7 +382,7 @@ echo "Workflow triggered. Waiting for PR creation..."
 4. Check no new commits to main since PR creation
 5. **DEPLOYMENT READINESS**: Ready to merge?
 
-### Step 13: Execute Release
+### Step 12: Execute Release
 
 1. **FINAL CONFIRMATION**: Merge PR to trigger release?
 2. Merge the Release PR:
@@ -358,7 +407,7 @@ echo "Workflow triggered. Waiting for PR creation..."
    gh run watch ${WORKFLOW_RUN_ID}
    ```
 
-### Step 14: Enhance GitHub Release
+### Step 13: Enhance GitHub Release
 
 1. Wait for automatic release creation:
    ```bash
@@ -371,10 +420,10 @@ echo "Workflow triggered. Waiting for PR creation..."
 
 2. **Enhance the GitHub release:**
    ```bash
-   # Update release with our enhanced notes
+   # Update release with our release notes
    gh release edit v${NEW_VERSION} \
      --title "🚀 ComfyUI Frontend v${NEW_VERSION}" \
-     --notes-file github-release-notes-${NEW_VERSION}.md \
+     --notes-file release-notes-${NEW_VERSION}.md \
      --latest
    
    # Add any additional assets if needed
@@ -386,7 +435,7 @@ echo "Workflow triggered. Waiting for PR creation..."
    gh release view v${NEW_VERSION}
    ```
 
-### Step 15: Verify Multi-Channel Distribution
+### Step 14: Verify Multi-Channel Distribution
 
 1. **GitHub Release:**
    ```bash
@@ -424,7 +473,7 @@ echo "Workflow triggered. Waiting for PR creation..."
 
 4. **DISTRIBUTION VERIFICATION**: All channels published successfully?
 
-### Step 16: Post-Release Monitoring Setup
+### Step 15: Post-Release Monitoring Setup
 
 1. **Monitor immediate release health:**
    ```bash
@@ -492,8 +541,7 @@ echo "Workflow triggered. Waiting for PR creation..."
    - Plan next release cycle
 
    ## Files Generated
-   - \`release-notes-${NEW_VERSION}-$(date +%Y%m%d).md\` - Detailed changelog
-   - \`github-release-notes-${NEW_VERSION}.md\` - GitHub release notes
+   - \`release-notes-${NEW_VERSION}.md\` - Comprehensive release notes
    - \`post-release-checklist.md\` - Follow-up tasks
    EOF
    ```
@@ -544,7 +592,7 @@ echo "- GitHub: Update release with warning notes"
 The command implements multiple quality gates:
 
 1. **🔒 Security Gate**: Vulnerability scanning, secret detection
-2. **🧪 Quality Gate**: Full test suite, linting, type checking
+2. **🧪 Quality Gate**: Unit and component tests, linting, type checking
 3. **📋 Content Gate**: Changelog accuracy, release notes quality
 4. **🔄 Process Gate**: Release timing verification
 5. **✅ Verification Gate**: Multi-channel publishing confirmation
@@ -602,6 +650,15 @@ The command implements multiple quality gates:
 gh pr view ${PR_NUMBER} --json baseRefName
 ```
 
+### Issue: Incomplete Dependency Changelog
+**Problem**: Litegraph or other dependency updates only show version bump, not actual changes
+**Solution**: The command now automatically:
+- Detects litegraph version changes between releases
+- Clones the litegraph repository temporarily
+- Extracts and categorizes changes between versions
+- Includes detailed litegraph changelog in release notes
+- Cleans up temporary files after analysis
+
 ### Issue: Release Failed Due to [skip ci]
 **Problem**: Release workflow didn't trigger after merge
 **Prevention**: Always avoid this scenario
@@ -622,4 +679,6 @@ Benefits: Cleaner than creating extra version numbers
 2. **Workflow Speed**: Version bump workflow typically completes in ~20-30 seconds
 3. **Update-locales Behavior**: Inconsistent - sometimes adds [skip ci], sometimes doesn't
 4. **Recovery Options**: Reverting version is cleaner than creating extra versions
+5. **Dependency Tracking**: Command now automatically includes litegraph and major dependency changes in changelogs
+6. **Litegraph Integration**: Temporary cloning of litegraph repo provides detailed change analysis between versions
 

.gitattributes

@@ -5,3 +5,7 @@
 *.ts text eol=lf
 *.vue text eol=lf
 *.js text eol=lf
+
+# Generated files
+src/types/comfyRegistryTypes.ts linguist-generated=true
+src/types/generatedManagerTypes.ts linguist-generated=true

.github/ISSUE_TEMPLATE/bug-report.yaml

@@ -1,99 +1,106 @@
 name: Bug Report
-description: 'Something is not behaving as expected.'
+description: 'Report something that is not working correctly'
 title: '[Bug]: '
 labels: ['Potential Bug']
 type: Bug
 
 body:
-  - type: markdown
-    attributes:
-      value: |
-        Before submitting a **Bug Report**, please ensure the following:
-
-        - **1:** You are running the latest version of ComfyUI.
-        - **2:** You have looked at the existing bug reports and made sure this isn't already reported.
-
   - type: checkboxes
-    id: custom-nodes-test
     attributes:
-      label: Custom Node Testing
-      description: Please confirm you have tried to reproduce the issue with all custom nodes disabled.
+      label: Prerequisites
       options:
-        - label: I have tried disabling custom nodes and the issue persists (see [how to disable custom nodes](https://docs.comfy.org/troubleshooting/custom-node-issues#step-1%3A-test-with-all-custom-nodes-disabled) if you need help)
+        - label: I am running the latest version of ComfyUI
+          required: true
+        - label: I have searched existing issues to make sure this isn't a duplicate
+          required: true
+        - label: I have tested with all custom nodes disabled ([see how](https://docs.comfy.org/troubleshooting/custom-node-issues#step-1%3A-test-with-all-custom-nodes-disabled))
           required: true
 
   - type: textarea
+    id: description
     attributes:
-      label: Frontend Version
-      description: |
-        What is the frontend version you are using? You can check this in the settings dialog.
-
-        <details>
-
-        <summary>Click to show where to find the version</summary>
-
-        Open the setting by clicking the cog icon in the bottom-left of the screen, then click `About`.
-
-        ![Frontend version](https://github.com/user-attachments/assets/561fb7c3-3012-457c-a494-9bdc1ff035c0)
-
-        </details>
-    validations:
-      required: true
-  - type: textarea
-    attributes:
-      label: Expected Behavior
-      description: 'What you expected to happen.'
-    validations:
-      required: true
-  - type: textarea
-    attributes:
-      label: Actual Behavior
-      description: 'What actually happened. Please include a screenshot / video clip of the issue if possible.'
+      label: What happened?
+      description: A clear and concise description of the bug. Include screenshots or videos if helpful.
+      placeholder: |
+        Example: "When I connect a VAE Decode node to a KSampler, the connection line appears but the workflow fails to execute with an error message..."
     validations:
       required: true
+
   - type: textarea
+    id: reproduce
     attributes:
       label: Steps to Reproduce
-      description: "Describe how to reproduce the issue. Please be sure to attach a workflow JSON or PNG, ideally one that doesn't require custom nodes to test. If the bug open happens when certain custom nodes are used, most likely that custom node is what has the bug rather than ComfyUI, in which case it should be reported to the node's author."
-    validations:
-      required: true
-  - type: textarea
-    attributes:
-      label: Debug Logs
-      description: 'Please copy the output from your terminal logs here.'
-      render: powershell
-    validations:
-      required: true
-  - type: textarea
-    attributes:
-      label: Browser Logs
-      description: 'Please copy the output from your browser logs here. You can access this by pressing F12 to toggle the developer tools, then navigating to the Console tab.'
-    validations:
-      required: true
-  - type: textarea
-    attributes:
-      label: Setting JSON
-      description: 'Please upload the setting file here. The setting file is located at `user/default/comfy.settings.json`'
+      description: How can we reproduce this issue? Please attach your workflow (JSON or PNG).
+      placeholder: |
+        1. Add a KSampler node
+        2. Connect it to...
+        3. Click Queue Prompt
+        4. See error
+      value: |
+        1. 
+        2. 
+        3. 
     validations:
       required: true
+
   - type: dropdown
-    id: browsers
+    id: severity
     attributes:
-      label: What browsers do you use to access the UI ?
-      multiple: true
+      label: How is this affecting you?
       options:
-        - Mozilla Firefox
-        - Google Chrome
-        - Brave
-        - Apple Safari
-        - Microsoft Edge
-        - Android
-        - iOS
-        - Other
-  - type: textarea
-    attributes:
-      label: Other Information
-      description: 'Any other context, details, or screenshots that might help solve the issue.'
-      placeholder: 'Add any other relevant information here...'
+        - Crashes ComfyUI completely
+        - Workflow won't execute
+        - Feature doesn't work as expected
+        - Visual/UI issue only
+        - Minor inconvenience
     validations:
-      required: false
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: ComfyUI Frontend Version
+      description: Found in Settings > About (e.g., "1.3.45")
+      placeholder: "1.3.45"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: browser
+    attributes:
+      label: Browser
+      description: Which browser are you using?
+      options:
+        - Chrome/Chromium
+        - Firefox
+        - Safari
+        - Edge
+        - Other
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ## Additional Information (Optional)
+        *The following fields help us debug complex issues but are not required for most bug reports.*
+
+  - type: textarea
+    id: console-errors
+    attributes:
+      label: Console Errors
+      description: If you see red error messages in the browser console (F12), paste them here
+      render: javascript
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: If relevant, paste any terminal/server logs here
+      render: shell
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other information that might help (OS, GPU, specific nodes involved, etc.)

.github/ISSUE_TEMPLATE/feature-request.yaml

@@ -1,6 +1,6 @@
 name: Feature Request
-description: Suggest an idea for this project
-title: '[Feature Request]: '
+description: Report a problem or limitation you're experiencing
+title: '[Feature]: '
 labels: ['enhancement']
 type: Feature
 
@@ -8,34 +8,74 @@ body:
   - type: checkboxes
     attributes:
       label: Is there an existing issue for this?
-      description: Please search to see if an issue already exists for the feature you want, and that it's not implemented in a recent build/commit.
+      description: Please search to see if an issue already exists for the problem you're experiencing, and that it's not addressed in a recent build/commit.
       options:
         - label: I have searched the existing issues and checked the recent builds/commits
           required: true
   - type: markdown
     attributes:
       value: |
-        *Please fill this form with as much information as possible, provide screenshots and/or illustrations of the feature if possible*
+        *Please focus on describing the problem you're experiencing rather than proposing specific solutions. This helps us design the best possible solution for you and other users.*
   - type: textarea
-    id: feature
+    id: problem
     attributes:
-      label: What would your feature do ?
-      description: Tell us about your feature in a very clear and simple way, and what problem it would solve
+      label: What problem are you experiencing?
+      description: Describe the issue or limitation you're facing in your workflow
+      placeholder: |
+        Example: "I frequently lose work when switching between different projects because there's no way to save my current workspace state"
+        NOT: "Add a save button that exports the workspace"
     validations:
       required: true
   - type: textarea
-    id: workflow
+    id: context
     attributes:
-      label: Proposed workflow
-      description: Please provide us with step by step information on how you'd like the feature to be accessed and used
-      value: |
-        1. Go to ....
-        2. Press ....
-        3. ...
+      label: When does this problem occur?
+      description: Describe the specific situations or workflows where you encounter this issue
+      placeholder: |
+        - When working with large node graphs...
+        - During batch processing workflows...
+        - While collaborating with team members...
+    validations:
+      required: true
+  - type: dropdown
+    id: frequency
+    attributes:
+      label: How often do you encounter this problem?
+      options:
+        - Multiple times per day
+        - Daily
+        - Several times per week
+        - Weekly
+        - Occasionally
+        - Rarely
+    validations:
+      required: true
+  - type: dropdown
+    id: impact
+    attributes:
+      label: How much does this problem affect your workflow?
+      description: Help us understand the severity of this issue for you
+      options:
+        - Blocks me from completing tasks
+        - Significantly slows down my work
+        - Causes moderate inconvenience
+        - Minor annoyance
     validations:
       required: true
   - type: textarea
-    id: misc
+    id: workaround
     attributes:
-      label: Additional information
-      description: Add any other context or screenshots about the feature request here.
+      label: Current workarounds
+      description: How do you currently deal with this problem, if at all?
+      placeholder: |
+        Example: "I manually export and reimport nodes between projects, which takes 10-15 minutes each time"
+  - type: textarea
+    id: ideas
+    attributes:
+      label: Ideas for solutions (Optional)
+      description: If you have thoughts on potential solutions, feel free to share them here. However, we'll explore all possible options to find the best approach.
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Add any other context, screenshots, or examples that help illustrate the problem.

.github/workflows/claude-pr-review.yml

@@ -4,6 +4,8 @@ permissions:
   contents: read
   pull-requests: write
   issues: write
+  id-token: write
+  statuses: write
 
 on:
   pull_request:
@@ -20,7 +22,7 @@ jobs:
         uses: lewagon/wait-on-check-action@v1.3.1
         with:
           ref: ${{ github.event.pull_request.head.sha }}
-          check-regexp: '^(ESLint|Prettier Check|Tests CI|Vitest Tests)'
+          check-regexp: '^(eslint|prettier|test|playwright-tests)'
           wait-interval: 30
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       
@@ -28,7 +30,7 @@ jobs:
         id: check-status
         run: |
           # Get all check runs for this commit
-          CHECK_RUNS=$(gh api repos/${{ github.repository }}/commits/${{ github.event.pull_request.head.sha }}/check-runs --jq '.check_runs[] | select(.name | test("ESLint|Prettier Check|Tests CI|Vitest Tests")) | {name, conclusion}')
+          CHECK_RUNS=$(gh api repos/${{ github.repository }}/commits/${{ github.event.pull_request.head.sha }}/check-runs --jq '.check_runs[] | select(.name | test("eslint|prettier|test|playwright-tests")) | {name, conclusion}')
           
           # Check if any required checks failed
           if echo "$CHECK_RUNS" | grep -q '"conclusion": "failure"'; then
@@ -63,10 +65,17 @@ jobs:
       - name: Run Claude PR Review
         uses: anthropics/claude-code-action@main
         with:
-          prompt_file: .claude/commands/comprehensive-pr-review.md
+          label_trigger: "claude-review"
+          direct_prompt: |
+            Read the file .claude/commands/comprehensive-pr-review.md and follow ALL the instructions exactly. 
+            
+            CRITICAL: You must post individual inline comments using the gh api commands shown in the file. 
+            DO NOT create a summary comment. 
+            Each issue must be posted as a separate inline comment on the specific line of code.
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          max_turns: 1
+          max_turns: 256
           timeout_minutes: 30
+          allowed_tools: "Bash(git:*),Bash(gh api:*),Bash(gh pr:*),Bash(gh repo:*),Bash(jq:*),Bash(echo:*),Read,Write,Edit,Glob,Grep,WebFetch"
         env:
           PR_NUMBER: ${{ github.event.pull_request.number }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -11,6 +11,8 @@ node_modules
 dist
 dist-ssr
 *.local
+# Claude configuration
+.claude/*.local.json
 
 # Editor directories and files
 .vscode/*

.husky/pre-commit

@@ -1,9 +1,4 @@
-if [[ "$OS" == "Windows_NT" ]]; then
-  npx.cmd lint-staged
-  # Check for unused i18n keys in staged files
-  npx.cmd tsx scripts/check-unused-i18n-keys.ts
-else
-  npx lint-staged
-  # Check for unused i18n keys in staged files
-  npx tsx scripts/check-unused-i18n-keys.ts
-fi
+#!/usr/bin/env bash
+
+npx lint-staged
+npx tsx scripts/check-unused-i18n-keys.ts

.mcp.json

@@ -3,6 +3,10 @@
     "playwright": {
       "command": "npx",
       "args": ["-y", "@executeautomation/playwright-mcp-server"]
+    },
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
     }
   }
 }

CLAUDE.md

@@ -1,58 +1,50 @@
-- use `npm run` to see what commands are available
-- For component communication, prefer Vue's event-based pattern (emit/@event-name) for state changes and notifications; use defineExpose with refs only for imperative operations that need direct control (like form.validate(), modal.open(), or editor.focus()); events promote loose coupling and are better for reusable components, while exposed methods are acceptable for tightly-coupled component pairs or when wrapping third-party libraries that require imperative APIs
-- After making code changes, follow this general process: (1) Create unit tests, component tests, browser tests (if appropriate for each), (2) run unit tests, component tests, and browser tests until passing, (3) run typecheck, lint, format (with prettier) -- you can use `npm run` command to see the scripts available, (4) check if any READMEs (including nested) or documentation needs to be updated, (5) Decide whether the changes are worth adding new content to the external documentation for (or would requires changes to the external documentation) at https://docs.comfy.org, then present your suggestion
-- When referencing PrimeVue, you can get all the docs here: https://primevue.org. Do this instead of making up or inferring names of Components
-- When trying to set tailwind classes for dark theme, use "dark-theme:" prefix rather than "dark:"
-- Never add lines to PR descriptions or commit messages that say "Generated with Claude Code"
-- When making PR names and commit messages, if you are going to add a prefix like "docs:", "feat:", "bugfix:", use square brackets around the prefix term and do not use a colon (e.g., should be "[docs]" rather than "docs:").
-- When I reference GitHub Repos related to Comfy-Org, you should proactively fetch or read the associated information in the repo. To do so, you should exhaust all options: (1) Check if we have a local copy of the repo, (2) Use the GitHub API to fetch the information; you may want to do this IN ADDITION to the other options, especially for reading specific branches/PRs/comments/reviews/metadata, and (3) curl the GitHub website and parse the html or json responses
-- For information about ComfyUI, ComfyUI_frontend, or ComfyUI-Manager, you can web search or download these wikis: https://deepwiki.com/Comfy-Org/ComfyUI-Manager, https://deepwiki.com/Comfy-Org/ComfyUI_frontend/1-overview, https://deepwiki.com/comfyanonymous/ComfyUI/2-core-architecture
-- If a question/project is related to Comfy-Org, Comfy, or ComfyUI ecosystem, you should proactively use the Comfy docs to answer the question. The docs may be referenced with URLs like https://docs.comfy.org
-- When operating inside a repo, check for README files at key locations in the repo detailing info about the contents of that folder. E.g., top-level key folders like tests-ui, browser_tests, composables, extensions/core, stores, services often have their own README.md files. When writing code, make sure to frequently reference these README files to understand the overall architecture and design of the project. Pay close attention to the snippets to learn particular patterns that seem to be there for a reason, as you should emulate those.
-- Prefer running single tests, and not the whole test suite, for performance
-- If using a lesser known or complex CLI tool, run the --help to see the documentation before deciding what to run, even if just for double-checking or verifying things.
-- IMPORTANT: the most important goal when writing code is to create clean, best-practices, sustainable, and scalable public APIs and interfaces. Our app is used by thousands of users and we have thousands of mods/extensions that are constantly changing and updating; and we are also always updating. That's why it is IMPORTANT that we design systems and write code that follows practices of domain-driven design, object-oriented design, and design patterns (such that you can assure stability while allowing for all components around you to change and evolve). We ABSOLUTELY prioritize clean APIs and public interfaces that clearly define and restrict how/what the mods/extensions can access.
-- If any of these technologies are referenced, you can proactively read their docs at these locations: https://primevue.org/theming, https://primevue.org/forms/, https://www.electronjs.org/docs/latest/api/browser-window, https://vitest.dev/guide/browser/, https://atlassian.design/components/pragmatic-drag-and-drop/core-package/drop-targets/, https://playwright.dev/docs/api/class-test, https://playwright.dev/docs/api/class-electron, https://www.algolia.com/doc/api-reference/rest-api/, https://pyav.org/docs/develop/cookbook/basics.html
-- IMPORTANT: Never add Co-Authored by Claude or any reference to Claude or Claude Code in commit messages, PR descriptions, titles, or any documentation whatsoever
-- The npm script to type check is called "typecheck" NOT "type check"
-- Use the Vue 3 Composition API instead of the Options API when writing Vue components. An exception is when overriding or extending a PrimeVue component for compatibility, you may use the Options API.
-- when we are solving an issue we know the link/number for, we should add "Fixes #n" (where n is the issue number) to the PR description.
-- Never write css if you can accomplish the same thing with tailwind utility classes
-- Utilize ref and reactive for reactive state
-- Implement computed properties with computed()
-- Use watch and watchEffect for side effects
-- Implement lifecycle hooks with onMounted, onUpdated, etc.
-- Utilize provide/inject for dependency injection
-- Use vue 3.5 style of default prop declaration. Do not define a `props` variable; instead, destructure props. Since vue 3.5, destructuring props does not strip them of reactivity.
-- Use Tailwind CSS for styling
-- Leverage VueUse functions for performance-enhancing styles
-- Use lodash for utility functions
-- Implement proper props and emits definitions
-- Utilize Vue 3's Teleport component when needed
-- Use Suspense for async components
-- Implement proper error handling
-- Follow Vue 3 style guide and naming conventions
-- IMPORTANT: Use vue-i18n for ALL user-facing strings - no hard-coded text in services/utilities. Place new translation entries in src/locales/en/main.json
-- Avoid using `@ts-expect-error` to work around type issues. We needed to employ it to migrate to TypeScript, but it should not be viewed as an accepted practice or standard.
-- DO NOT use deprecated PrimeVue components. Use these replacements instead:
-  * `Dropdown` → Use `Select` (import from 'primevue/select')
-  * `OverlayPanel` → Use `Popover` (import from 'primevue/popover') 
-  * `Calendar` → Use `DatePicker` (import from 'primevue/datepicker')
-  * `InputSwitch` → Use `ToggleSwitch` (import from 'primevue/toggleswitch')
-  * `Sidebar` → Use `Drawer` (import from 'primevue/drawer')
-  * `Chips` → Use `AutoComplete` with multiple enabled and typeahead disabled
-  * `TabMenu` → Use `Tabs` without panels
-  * `Steps` → Use `Stepper` without panels
-  * `InlineMessage` → Use `Message` component
-* Use `api.apiURL()` for all backend API calls and routes
-  - Actual API endpoints like /prompt, /queue, /view, etc.
-  - Image previews: `api.apiURL('/view?...')`
-  - Any backend-generated content or dynamic routes
-* Use `api.fileURL()` for static files served from the public folder:
-  - Templates: `api.fileURL('/templates/default.json')`
-  - Extensions: `api.fileURL(extensionPath)` for loading JS modules
-  - Any static assets that exist in the public directory
-- When implementing code that outputs raw HTML (e.g., using v-html directive), always ensure dynamic content has been properly sanitized with DOMPurify or validated through trusted sources. Prefer Vue templates over v-html when possible.
-- For any async operations (API calls, timers, etc), implement cleanup/cancellation in component unmount to prevent memory leaks
-- Extract complex template conditionals into separate components or computed properties
-- Error messages should be actionable and user-friendly (e.g., "Failed to load data. Please refresh the page." instead of "Unknown error")
+# ComfyUI Frontend Project Guidelines
+
+## Quick Commands
+
+- `npm run`: See all available commands
+- `npm run typecheck`: Type checking
+- `npm run lint`: Linting
+- `npm run format`: Prettier formatting
+
+## Development Workflow
+
+1. Make code changes
+2. Run tests (see subdirectory CLAUDE.md files)
+3. Run typecheck, lint, format
+4. Check README updates
+5. Consider docs.comfy.org updates
+
+## Git Conventions
+
+- Use [prefix] format: [feat], [bugfix], [docs]
+- Add "Fixes #n" to PR descriptions
+- Never mention Claude/AI in commits
+
+## External Resources
+
+- PrimeVue docs: <https://primevue.org>
+- ComfyUI docs: <https://docs.comfy.org>
+- Electron: <https://www.electronjs.org/docs/latest/>
+- Wiki: <https://deepwiki.com/Comfy-Org/ComfyUI_frontend/1-overview>
+
+## Project Philosophy
+
+- Clean, stable public APIs
+- Domain-driven design
+- Thousands of users and extensions
+- Prioritize clean interfaces that restrict extension access
+
+## Repository Navigation
+
+- Check README files in key folders (tests-ui, browser_tests, composables, etc.)
+- Prefer running single tests for performance
+- Use --help for unfamiliar CLI tools
+
+## GitHub Integration
+
+When referencing Comfy-Org repos:
+
+1. Check for local copy
+2. Use GitHub API for branches/PRs/metadata
+3. Curl GitHub website if needed

browser_tests/CLAUDE.md

@@ -0,0 +1,17 @@
+# E2E Testing Guidelines
+
+## Browser Tests
+- Test user workflows
+- Use Playwright fixtures
+- Follow naming conventions
+
+## Best Practices
+- Check assets/ for test data
+- Prefer specific selectors
+- Test across viewports
+
+## Testing Process
+After code changes:
+1. Create browser tests as appropriate
+2. Run tests until passing
+3. Then run typecheck, lint, format

browser_tests/README.md

@@ -2,76 +2,133 @@
 
 This document outlines the setup, usage, and common patterns for Playwright browser tests in the ComfyUI_frontend project.
 
-## WARNING
+## Prerequisites
 
-The browser tests will change the ComfyUI backend state, such as user settings and saved workflows.
-If `TEST_COMFYUI_DIR` in `.env` isn't set to your `(Comfy Path)/ComfyUI` directory, these changes won't be automatically restored.
+**CRITICAL**: Start ComfyUI backend with `--multi-user` flag:
+
+```bash
+python main.py --multi-user
+```
+
+Without this flag, parallel tests will conflict and fail randomly.
 
 ## Setup
 
 ### ComfyUI devtools
+
 Clone <https://github.com/Comfy-Org/ComfyUI_devtools> to your `custom_nodes` directory.  
 _ComfyUI_devtools adds additional API endpoints and nodes to ComfyUI for browser testing._
 
 ### Node.js & Playwright Prerequisites
+
 Ensure you have Node.js v20 or v22 installed. Then, set up the Chromium test driver:
+
 ```bash
 npx playwright install chromium --with-deps
 ```
 
-### Environment Variables
-Ensure the environment variables in `.env` are set correctly according to your setup. 
+### Environment Configuration
 
-The `.env` file will not exist until you create it yourself.
+Create `.env` from the template:
 
-A template with helpful information can be found in `.env_example`.
+```bash
+cp .env_example .env
+```
 
-### Multiple Tests
-If you are running Playwright tests in parallel or running the same test multiple times, the flag `--multi-user` must be added to the main ComfyUI process.
+Key settings for debugging:
+
+```bash
+# Remove Vue dev overlay that blocks UI elements
+DISABLE_VUE_PLUGINS=true
+
+# Test against dev server (recommended) or backend directly
+PLAYWRIGHT_TEST_URL=http://localhost:5173  # Dev server
+# PLAYWRIGHT_TEST_URL=http://localhost:8188  # Direct backend
+
+# Path to ComfyUI for backing up user data/settings before tests
+TEST_COMFYUI_DIR=/path/to/your/ComfyUI
+```
+
+### Common Setup Issues
+
+**Most tests require the new menu system** - Add to your test:
+
+```typescript
+test.beforeEach(async ({ comfyPage }) => {
+  await comfyPage.setSetting('Comfy.UseNewMenu', 'Top')
+})
+```
 
 ### Release API Mocking
+
 By default, all tests mock the release API (`api.comfy.org/releases`) to prevent release notification popups from interfering with test execution. This is necessary because the release notifications can appear over UI elements and block test interactions.
 
 To test with real release data, you can disable mocking:
+
 ```typescript
-await comfyPage.setup({ mockReleases: false });
+await comfyPage.setup({ mockReleases: false })
 ```
 
 For tests that specifically need to test release functionality, see the example in `tests/releaseNotifications.spec.ts`.
 
 ## Running Tests
 
-There are multiple ways to run the tests:
+**Always use UI mode for development:**
 
-1. **Headless mode with report generation:**
-   ```bash
-   npx playwright test
-   ```
-   This runs all tests without a visible browser and generates a comprehensive test report.
+```bash
+npx playwright test --ui
+```
 
-2. **UI mode for interactive testing:**
-   ```bash
-   npx playwright test --ui
-   ```
-   This opens a user interface where you can select specific tests to run and inspect the test execution timeline.
+UI mode features:
 
-   ![Playwright UI Mode](https://github.com/user-attachments/assets/6a1ebef0-90eb-4157-8694-f5ee94d03755)
+- **Locator picker**: Click the target icon, then click any element to get the exact locator code to use in your test. The code appears in the _Locator_ tab.
+- **Step debugging**: Step through your test line-by-line by clicking _Source_ tab
+- **Time travel**: In the _Actions_ tab/panel, click any step to see the browser state at that moment
+- **Console/Network Tabs**: View logs and API calls at each step
+- **Attachments Tab**: View all snapshots with expected and actual images
 
-3. **Running specific tests:**
-   ```bash
-   npx playwright test widget.spec.ts
-   ```
+![Playwright UI Mode](https://github.com/user-attachments/assets/c158c93f-b39a-44c5-a1a1-e0cc975ee9f2)
+
+For CI or headless testing:
+
+```bash
+npx playwright test                    # Run all tests
+npx playwright test widget.spec.ts     # Run specific test file
+```
+
+### Local Development Config
+
+For debugging, you can try adjusting these settings in `playwright.config.ts`:
+
+```typescript
+export default defineConfig({
+  // VERY HELPFUL: Skip screenshot tests locally
+  grep: process.env.CI ? undefined : /^(?!.*screenshot).*$/
+
+  retries: 0, // No retries while debugging. Increase if writing new tests. that may be flaky.
+  workers: 1, // Single worker for easier debugging. Increase to match CPU cores if you want to run a lot of tests in parallel.
+  timeout: 30000, // Longer timeout for breakpoints
+
+  use: {
+    trace: 'on', // Always capture traces (CI uses 'on-first-retry')
+    video: 'on' // Always record video (CI uses 'retain-on-failure')
+  },
+
+})
+```
 
 ## Test Structure
 
 Browser tests in this project follow a specific organization pattern:
 
 - **Fixtures**: Located in `fixtures/` - These provide test setup and utilities
+
   - `ComfyPage.ts` - The main fixture for interacting with ComfyUI
   - `ComfyMouse.ts` - Utility for mouse interactions with the canvas
   - Components fixtures in `fixtures/components/` - Page object models for UI components
 
 - **Tests**: Located in `tests/` - The actual test specifications
+
   - Organized by functionality (e.g., `widget.spec.ts`, `interaction.spec.ts`)
   - Snapshot directories (e.g., `widget.spec.ts-snapshots/`) contain reference screenshots
 
@@ -86,18 +143,18 @@ When writing new tests, follow these patterns:
 
 ```typescript
 // Import the test fixture
-import { comfyPageFixture as test } from '../fixtures/ComfyPage';
+import { comfyPageFixture as test } from '../fixtures/ComfyPage'
 
 test.describe('Feature Name', () => {
   // Set up test environment if needed
   test.beforeEach(async ({ comfyPage }) => {
     // Common setup
-  });
+  })
 
   test('should do something specific', async ({ comfyPage }) => {
     // Test implementation
-  });
-});
+  })
+})
 ```
 
 ### Leverage Existing Fixtures and Helpers
@@ -119,66 +176,102 @@ Most common testing needs are already addressed by these helpers, which will mak
 
 1. **Focus elements explicitly**:
    Canvas-based elements often need explicit focus before interaction:
+
    ```typescript
    // Click the canvas first to focus it before pressing keys
-   await comfyPage.canvas.click();
-   await comfyPage.page.keyboard.press('a');
+   await comfyPage.canvas.click()
+   await comfyPage.page.keyboard.press('a')
    ```
 
 2. **Mark canvas as dirty if needed**:
    Some interactions need explicit canvas updates:
+
    ```typescript
    // After programmatically changing node state, mark canvas dirty
    await comfyPage.page.evaluate(() => {
-     window['app'].graph.setDirtyCanvas(true, true);
-   });
+     window['app'].graph.setDirtyCanvas(true, true)
+   })
    ```
 
-3. **Use node references over coordinates**: 
+3. **Use node references over coordinates**:
    Node references from `fixtures/utils/litegraphUtils.ts` provide stable ways to interact with nodes:
+
    ```typescript
    // Prefer this:
-   const node = await comfyPage.getNodeRefsByType('LoadImage')[0];
-   await node.click('title');
-   
+   const node = await comfyPage.getNodeRefsByType('LoadImage')[0]
+   await node.click('title')
+
    // Over this:
-   await comfyPage.canvas.click({ position: { x: 100, y: 100 } });
+   await comfyPage.canvas.click({ position: { x: 100, y: 100 } })
    ```
 
 4. **Wait for canvas to render after UI interactions**:
+
    ```typescript
-   await comfyPage.nextFrame();
+   await comfyPage.nextFrame()
    ```
 
 5. **Clean up persistent server state**:
    While most state is reset between tests, anything stored on the server persists:
+
    ```typescript
    // Reset settings that affect other tests (these are stored on server)
-   await comfyPage.setSetting('Comfy.ColorPalette', 'dark');
-   await comfyPage.setSetting('Comfy.NodeBadge.NodeIdBadgeMode', 'None');
-   
+   await comfyPage.setSetting('Comfy.ColorPalette', 'dark')
+   await comfyPage.setSetting('Comfy.NodeBadge.NodeIdBadgeMode', 'None')
+
    // Clean up uploaded files if needed
-   await comfyPage.request.delete(`${comfyPage.url}/api/delete/image.png`);
+   await comfyPage.request.delete(`${comfyPage.url}/api/delete/image.png`)
    ```
 
 6. **Prefer functional assertions over screenshots**:
    Use screenshots only when visual verification is necessary:
+
    ```typescript
    // Prefer this:
-   expect(await node.isPinned()).toBe(true);
-   expect(await node.getProperty('title')).toBe('Expected Title');
-   
+   expect(await node.isPinned()).toBe(true)
+   expect(await node.getProperty('title')).toBe('Expected Title')
+
    // Over this - only use when needed:
-   await expect(comfyPage.canvas).toHaveScreenshot('state.png');
+   await expect(comfyPage.canvas).toHaveScreenshot('state.png')
    ```
 
 7. **Use minimal test workflows**:
    When creating test workflows, keep them as minimal as possible:
+
    ```typescript
    // Include only the components needed for the test
-   await comfyPage.loadWorkflow('single_ksampler');
+   await comfyPage.loadWorkflow('single_ksampler')
    ```
 
+8. **Debug helpers for visual debugging** (remove before committing):
+
+   ComfyPage includes temporary debug methods for troubleshooting:
+
+   ```typescript
+   test('debug failing interaction', async ({ comfyPage }, testInfo) => {
+     // Add visual markers to see click positions
+     await comfyPage.debugAddMarker({ x: 100, y: 200 })
+
+     // Attach screenshot with markers to test report
+     await comfyPage.debugAttachScreenshot(testInfo, 'node-positions', {
+       element: 'canvas',
+       markers: [{ position: { x: 100, y: 200 } }]
+     })
+
+     // Show canvas overlay for easier debugging
+     await comfyPage.debugShowCanvasOverlay()
+
+     // Remember to remove debug code before committing!
+   })
+   ```
+
+   Available debug methods:
+
+   - `debugAddMarker(position)` - Red circle at position
+   - `debugAttachScreenshot(testInfo, name)` - Attach to test report
+   - `debugShowCanvasOverlay()` - Show canvas as overlay
+   - `debugGetCanvasDataURL()` - Get canvas as base64
+
 ## Common Patterns and Utilities
 
 ### Page Object Pattern
@@ -192,7 +285,7 @@ test('Can toggle boolean widget', async ({ comfyPage }) => {
   const node = (await comfyPage.getFirstNodeRef())!
   const widget = await node.getWidget(0)
   await widget.click()
-});
+})
 ```
 
 ### Node References
@@ -232,8 +325,8 @@ Canvas operations use special helpers to ensure proper timing:
 ```typescript
 // Using ComfyMouse for drag and drop
 await comfyMouse.dragAndDrop(
-  { x: 100, y: 100 },  // From
-  { x: 200, y: 200 }   // To
+  { x: 100, y: 100 }, // From
+  { x: 200, y: 200 } // To
 )
 
 // Standard ComfyPage helpers
@@ -275,21 +368,52 @@ await expect(node).toBeCollapsed()
 - **Screenshots vary**: Ensure your OS and browser match the reference environment (Linux)
 - **Async / await**: Race conditions are a very common cause of test flakiness
 
-## Screenshot Expectations
+## Screenshot Testing
 
 Due to variations in system font rendering, screenshot expectations are platform-specific. Please note:
 
-- **DO NOT commit local screenshot expectations** to the repository
+- **Do not commit local screenshot expectations** to the repository
 - We maintain Linux screenshot expectations as our GitHub Action runner operates in a Linux environment
 - While developing, you can generate local screenshots for your tests, but these will differ from CI-generated ones
 
-To set new test expectations for PR:
+### Working with Screenshots Locally
 
-1. Write your test with screenshot assertions using `toHaveScreenshot(filename)`
-2. Create a pull request from a `Comfy-Org/ComfyUI_frontend` branch
-3. Add the `New Browser Test Expectation` tag to your pull request
-4. The GitHub CI will automatically generate and commit the reference screenshots
+Option 1 - Skip screenshot tests (add to `playwright.config.ts`):
 
-This approach ensures consistent screenshot expectations across all PRs and avoids issues with platform-specific rendering.
+```typescript
+export default defineConfig({
+  grep: process.env.CI ? undefined : /^(?!.*screenshot).*$/
+})
+```
 
-> **Note:** If you're making a pull request from a forked repository, the GitHub action won't be able to commit updated screenshot expectations directly to your PR branch.
+Option 2 - Generate local baselines for comparison:
+
+```bash
+npx playwright test --update-snapshots
+```
+
+### Getting Test Artifacts from GitHub Actions
+
+When tests fail in CI, you can download screenshots and traces:
+
+1. Go to the failed workflow run in GitHub Actions
+2. Scroll to "Artifacts" section at the bottom
+3. Download `playwright-report` or `test-results`
+4. Extract and open the HTML report locally
+5. View actual vs expected screenshots and execution traces
+
+### Creating New Screenshot Baselines
+
+For PRs from `Comfy-Org/ComfyUI_frontend` branches:
+
+1. Write test with `toHaveScreenshot('filename.png')`
+2. Create PR and add `New Browser Test Expectation` label
+3. CI will generate and commit the Linux baseline screenshots
+
+> **Note:** Fork PRs cannot auto-commit screenshots. A maintainer will need to commit the screenshots manually for you (don't worry, they'll do it).
+
+## Resources
+
+- [Playwright UI Mode](https://playwright.dev/docs/test-ui-mode) - Interactive test debugging
+- [Playwright Debugging Guide](https://playwright.dev/docs/debug)
+- [act](https://github.com/nektos/act) - Run GitHub Actions locally for CI debugging

browser_tests/fixtures/ComfyPage.ts

@@ -168,7 +168,7 @@ export class ComfyPage {
     this.menu = new ComfyMenu(page)
     this.actionbar = new ComfyActionbar(page)
     this.templates = new ComfyTemplates(page)
-    this.settingDialog = new SettingDialog(page)
+    this.settingDialog = new SettingDialog(page, this)
     this.confirmDialog = new ConfirmDialog(page)
   }
 
@@ -563,6 +563,7 @@ export class ComfyPage {
         if (fileName.endsWith('.webm')) return 'video/webm'
         if (fileName.endsWith('.json')) return 'application/json'
         if (fileName.endsWith('.glb')) return 'model/gltf-binary'
+        if (fileName.endsWith('.avif')) return 'image/avif'
         return 'application/octet-stream'
       }
 

browser_tests/fixtures/components/SettingDialog.ts

@@ -1,15 +1,19 @@
 import { Page } from '@playwright/test'
 
+import { ComfyPage } from '../ComfyPage'
+
 export class SettingDialog {
-  constructor(public readonly page: Page) {}
+  constructor(
+    public readonly page: Page,
+    public readonly comfyPage: ComfyPage
+  ) {}
 
   get root() {
     return this.page.locator('div.settings-container')
   }
 
   async open() {
-    const button = this.page.locator('button.comfy-settings-btn:visible')
-    await button.click()
+    await this.comfyPage.executeCommand('Comfy.ShowSettingsDialog')
     await this.page.waitForSelector('div.settings-container')
   }
 

browser_tests/fixtures/components/Topbar.ts

@@ -15,10 +15,6 @@ export class Topbar {
       .innerText()
   }
 
-  async openSubmenuMobile() {
-    await this.page.locator('.p-menubar-mobile .p-menubar-button').click()
-  }
-
   getMenuItem(itemLabel: string): Locator {
     return this.page.locator(`.p-menubar-item-label:text-is("${itemLabel}")`)
   }
@@ -68,31 +64,41 @@ export class Topbar {
     await this.getSaveDialog().waitFor({ state: 'hidden', timeout: 500 })
   }
 
+  async openTopbarMenu() {
+    await this.page.locator('.comfyui-logo-wrapper').click()
+    const menu = this.page.locator('.comfy-command-menu')
+    await menu.waitFor({ state: 'visible' })
+    return menu
+  }
+
   async triggerTopbarCommand(path: string[]) {
     if (path.length < 2) {
       throw new Error('Path is too short')
     }
 
+    const menu = await this.openTopbarMenu()
     const tabName = path[0]
-    const topLevelMenu = this.page.locator(
-      `.top-menubar .p-menubar-item-label:text-is("${tabName}")`
+    const topLevelMenuItem = this.page.locator(
+      `.p-menubar-item-label:text-is("${tabName}")`
     )
+    const topLevelMenu = menu
+      .locator('.p-tieredmenu-item')
+      .filter({ has: topLevelMenuItem })
     await topLevelMenu.waitFor({ state: 'visible' })
-    await topLevelMenu.click()
+    await topLevelMenu.hover()
 
+    let currentMenu = topLevelMenu
     for (let i = 1; i < path.length; i++) {
       const commandName = path[i]
-      const menuItem = this.page
+      const menuItem = currentMenu
         .locator(
-          `.top-menubar .p-menubar-submenu .p-menubar-item:has-text("${commandName}")`
+          `.p-tieredmenu-submenu .p-tieredmenu-item:has-text("${commandName}")`
         )
         .first()
       await menuItem.waitFor({ state: 'visible' })
       await menuItem.hover()
-
-      if (i === path.length - 1) {
-        await menuItem.click()
-      }
+      currentMenu = menuItem
     }
+    await currentMenu.click()
   }
 }

browser_tests/tests/domWidget.spec.ts

@@ -47,4 +47,42 @@ test.describe('DOM Widget', () => {
     const finalCount = await comfyPage.getDOMWidgetCount()
     expect(finalCount).toBe(initialCount + 1)
   })
+
+  test('should reposition when layout changes', async ({ comfyPage }) => {
+    // --- setup ---
+
+    const textareaWidget = comfyPage.page
+      .locator('.comfy-multiline-input')
+      .first()
+    await expect(textareaWidget).toBeVisible()
+
+    await comfyPage.setSetting('Comfy.Sidebar.Size', 'small')
+    await comfyPage.setSetting('Comfy.Sidebar.Location', 'left')
+    await comfyPage.setSetting('Comfy.UseNewMenu', 'Top')
+    await comfyPage.nextFrame()
+
+    let oldPos: [number, number]
+    const checkBboxChange = async () => {
+      const boudningBox = (await textareaWidget.boundingBox())!
+      expect(boudningBox).not.toBeNull()
+      const position: [number, number] = [boudningBox.x, boudningBox.y]
+      expect(position).not.toEqual(oldPos)
+      oldPos = position
+    }
+    await checkBboxChange()
+
+    // --- test ---
+
+    await comfyPage.setSetting('Comfy.Sidebar.Size', 'normal')
+    await comfyPage.nextFrame()
+    await checkBboxChange()
+
+    await comfyPage.setSetting('Comfy.Sidebar.Location', 'right')
+    await comfyPage.nextFrame()
+    await checkBboxChange()
+
+    await comfyPage.setSetting('Comfy.UseNewMenu', 'Bottom')
+    await comfyPage.nextFrame()
+    await checkBboxChange()
+  })
 })

browser_tests/tests/groupNode.spec.ts

@@ -264,10 +264,15 @@ test.describe('Group Node', () => {
     test('Copies and pastes group node after clearing workflow', async ({
       comfyPage
     }) => {
+      // Set setting
+      await comfyPage.setSetting('Comfy.ConfirmClear', false)
+
+      // Clear workflow
       await comfyPage.menu.topbar.triggerTopbarCommand([
         'Edit',
         'Clear Workflow'
       ])
+
       await comfyPage.ctrlV()
       await verifyNodeLoaded(comfyPage, 1)
     })

browser_tests/tests/interaction.spec.ts

@@ -763,7 +763,7 @@ test.describe('Viewport settings', () => {
     await comfyPage.setupWorkflowsDirectory({})
   })
 
-  test.skip('Keeps viewport settings when changing tabs', async ({
+  test('Keeps viewport settings when changing tabs', async ({
     comfyPage,
     comfyMouse
   }) => {
@@ -774,7 +774,8 @@ test.describe('Viewport settings', () => {
     await toggleButton.click()
 
     await comfyPage.menu.topbar.saveWorkflow('Workflow A')
-    await expect(comfyPage.canvas).toHaveScreenshot('viewport-workflow-a.png')
+    await comfyPage.nextFrame()
+    const screenshotA = (await comfyPage.canvas.screenshot()).toString('base64')
 
     // Save workflow as a new file, then zoom out before screen shot
     await comfyPage.menu.topbar.saveWorkflowAs('Workflow B')
@@ -782,7 +783,12 @@ test.describe('Viewport settings', () => {
     for (let i = 0; i < 4; i++) {
       await comfyMouse.wheel(0, 60)
     }
-    await expect(comfyPage.canvas).toHaveScreenshot('viewport-workflow-b.png')
+
+    await comfyPage.nextFrame()
+    const screenshotB = (await comfyPage.canvas.screenshot()).toString('base64')
+
+    // Ensure that the screenshots are different due to zoom level
+    expect(screenshotB).not.toBe(screenshotA)
 
     const tabA = comfyPage.menu.topbar.getWorkflowTab('Workflow A')
     const tabB = comfyPage.menu.topbar.getWorkflowTab('Workflow B')
@@ -790,11 +796,269 @@ test.describe('Viewport settings', () => {
     // Go back to Workflow A
     await tabA.click()
     await comfyPage.nextFrame()
-    await expect(comfyPage.canvas).toHaveScreenshot('viewport-workflow-a.png')
+    expect((await comfyPage.canvas.screenshot()).toString('base64')).toBe(
+      screenshotA
+    )
 
     // And back to Workflow B
     await tabB.click()
     await comfyPage.nextFrame()
-    await expect(comfyPage.canvas).toHaveScreenshot('viewport-workflow-b.png')
+    expect((await comfyPage.canvas.screenshot()).toString('base64')).toBe(
+      screenshotB
+    )
+  })
+})
+
+test.describe('Canvas Navigation', () => {
+  test.describe('Legacy Mode', () => {
+    test.beforeEach(async ({ comfyPage }) => {
+      await comfyPage.setSetting('Comfy.Canvas.NavigationMode', 'legacy')
+    })
+
+    test('Left-click drag in empty area should pan canvas', async ({
+      comfyPage
+    }) => {
+      await comfyPage.dragAndDrop({ x: 50, y: 50 }, { x: 150, y: 150 })
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'legacy-left-drag-pan.png'
+      )
+    })
+
+    test('Middle-click drag should pan canvas', async ({ comfyPage }) => {
+      await comfyPage.page.mouse.move(50, 50)
+      await comfyPage.page.mouse.down({ button: 'middle' })
+      await comfyPage.page.mouse.move(150, 150)
+      await comfyPage.page.mouse.up({ button: 'middle' })
+      await comfyPage.nextFrame()
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'legacy-middle-drag-pan.png'
+      )
+    })
+
+    test('Mouse wheel should zoom in/out', async ({ comfyPage }) => {
+      await comfyPage.page.mouse.move(400, 300)
+      await comfyPage.page.mouse.wheel(0, -120)
+      await comfyPage.nextFrame()
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'legacy-wheel-zoom-in.png'
+      )
+
+      await comfyPage.page.mouse.wheel(0, 240)
+      await comfyPage.nextFrame()
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'legacy-wheel-zoom-out.png'
+      )
+    })
+
+    test('Left-click on node should not pan canvas', async ({ comfyPage }) => {
+      await comfyPage.clickTextEncodeNode1()
+      const selectedCount = await comfyPage.getSelectedGraphNodesCount()
+      expect(selectedCount).toBe(1)
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'legacy-click-node-select.png'
+      )
+    })
+  })
+
+  test.describe('Standard Mode', () => {
+    test.beforeEach(async ({ comfyPage }) => {
+      await comfyPage.setSetting('Comfy.Canvas.NavigationMode', 'standard')
+    })
+
+    test('Left-click drag in empty area should select nodes', async ({
+      comfyPage
+    }) => {
+      const clipNodes = await comfyPage.getNodeRefsByType('CLIPTextEncode')
+      const clipNode1Pos = await clipNodes[0].getPosition()
+      const clipNode2Pos = await clipNodes[1].getPosition()
+      const offset = 64
+
+      await comfyPage.dragAndDrop(
+        {
+          x: Math.min(clipNode1Pos.x, clipNode2Pos.x) - offset,
+          y: Math.min(clipNode1Pos.y, clipNode2Pos.y) - offset
+        },
+        {
+          x: Math.max(clipNode1Pos.x, clipNode2Pos.x) + offset,
+          y: Math.max(clipNode1Pos.y, clipNode2Pos.y) + offset
+        }
+      )
+
+      const selectedCount = await comfyPage.getSelectedGraphNodesCount()
+      expect(selectedCount).toBe(clipNodes.length)
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'standard-left-drag-select.png'
+      )
+    })
+
+    test('Middle-click drag should pan canvas', async ({ comfyPage }) => {
+      await comfyPage.page.mouse.move(50, 50)
+      await comfyPage.page.mouse.down({ button: 'middle' })
+      await comfyPage.page.mouse.move(150, 150)
+      await comfyPage.page.mouse.up({ button: 'middle' })
+      await comfyPage.nextFrame()
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'standard-middle-drag-pan.png'
+      )
+    })
+
+    test('Ctrl + mouse wheel should zoom in/out', async ({ comfyPage }) => {
+      await comfyPage.page.mouse.move(400, 300)
+      await comfyPage.page.keyboard.down('Control')
+      await comfyPage.page.mouse.wheel(0, -120)
+      await comfyPage.page.keyboard.up('Control')
+      await comfyPage.nextFrame()
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'standard-ctrl-wheel-zoom-in.png'
+      )
+
+      await comfyPage.page.keyboard.down('Control')
+      await comfyPage.page.mouse.wheel(0, 240)
+      await comfyPage.page.keyboard.up('Control')
+      await comfyPage.nextFrame()
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'standard-ctrl-wheel-zoom-out.png'
+      )
+    })
+
+    test('Left-click on node should select node (not start selection box)', async ({
+      comfyPage
+    }) => {
+      await comfyPage.clickTextEncodeNode1()
+      const selectedCount = await comfyPage.getSelectedGraphNodesCount()
+      expect(selectedCount).toBe(1)
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'standard-click-node-select.png'
+      )
+    })
+
+    test('Space + left-click drag should pan canvas', async ({ comfyPage }) => {
+      // Click canvas to focus it
+      await comfyPage.page.click('canvas')
+      await comfyPage.nextFrame()
+
+      await comfyPage.page.keyboard.down('Space')
+      await comfyPage.dragAndDrop({ x: 50, y: 50 }, { x: 150, y: 150 })
+      await comfyPage.page.keyboard.up('Space')
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'standard-space-drag-pan.png'
+      )
+    })
+
+    test('Space key overrides default left-click behavior', async ({
+      comfyPage
+    }) => {
+      const clipNodes = await comfyPage.getNodeRefsByType('CLIPTextEncode')
+      const clipNode1Pos = await clipNodes[0].getPosition()
+      const offset = 64
+
+      await comfyPage.dragAndDrop(
+        {
+          x: clipNode1Pos.x - offset,
+          y: clipNode1Pos.y - offset
+        },
+        {
+          x: clipNode1Pos.x + offset,
+          y: clipNode1Pos.y + offset
+        }
+      )
+
+      const selectedCountAfterDrag =
+        await comfyPage.getSelectedGraphNodesCount()
+      expect(selectedCountAfterDrag).toBeGreaterThan(0)
+
+      await comfyPage.clickEmptySpace()
+      const selectedCountAfterClear =
+        await comfyPage.getSelectedGraphNodesCount()
+      expect(selectedCountAfterClear).toBe(0)
+
+      await comfyPage.page.keyboard.down('Space')
+      await comfyPage.dragAndDrop(
+        {
+          x: clipNode1Pos.x - offset,
+          y: clipNode1Pos.y - offset
+        },
+        {
+          x: clipNode1Pos.x + offset,
+          y: clipNode1Pos.y + offset
+        }
+      )
+      await comfyPage.page.keyboard.up('Space')
+
+      const selectedCountAfterSpaceDrag =
+        await comfyPage.getSelectedGraphNodesCount()
+      expect(selectedCountAfterSpaceDrag).toBe(0)
+    })
+  })
+
+  test('Shift + mouse wheel should pan canvas horizontally', async ({
+    comfyPage
+  }) => {
+    await comfyPage.page.click('canvas')
+    await comfyPage.nextFrame()
+
+    await expect(comfyPage.canvas).toHaveScreenshot('standard-initial.png')
+
+    await comfyPage.page.mouse.move(400, 300)
+
+    await comfyPage.page.keyboard.down('Shift')
+    await comfyPage.page.mouse.wheel(0, 120)
+    await comfyPage.page.keyboard.up('Shift')
+    await comfyPage.nextFrame()
+    await expect(comfyPage.canvas).toHaveScreenshot(
+      'standard-shift-wheel-pan-right.png'
+    )
+
+    await comfyPage.page.keyboard.down('Shift')
+    await comfyPage.page.mouse.wheel(0, -240)
+    await comfyPage.page.keyboard.up('Shift')
+    await comfyPage.nextFrame()
+    await expect(comfyPage.canvas).toHaveScreenshot(
+      'standard-shift-wheel-pan-left.png'
+    )
+
+    await comfyPage.page.keyboard.down('Shift')
+    await comfyPage.page.mouse.wheel(0, 120)
+    await comfyPage.page.keyboard.up('Shift')
+    await comfyPage.nextFrame()
+    await expect(comfyPage.canvas).toHaveScreenshot(
+      'standard-shift-wheel-pan-center.png'
+    )
+  })
+
+  test.describe('Edge Cases', () => {
+    test('Multiple modifier keys work correctly in legacy mode', async ({
+      comfyPage
+    }) => {
+      await comfyPage.setSetting('Comfy.Canvas.NavigationMode', 'legacy')
+
+      await comfyPage.page.keyboard.down('Alt')
+      await comfyPage.page.keyboard.down('Shift')
+      await comfyPage.dragAndDrop({ x: 50, y: 50 }, { x: 150, y: 150 })
+      await comfyPage.page.keyboard.up('Shift')
+      await comfyPage.page.keyboard.up('Alt')
+
+      await expect(comfyPage.canvas).toHaveScreenshot(
+        'legacy-alt-shift-drag.png'
+      )
+    })
+
+    test('Cursor changes appropriately in different modes', async ({
+      comfyPage
+    }) => {
+      const getCursorStyle = async () => {
+        return await comfyPage.page.evaluate(() => {
+          return (
+            document.getElementById('graph-canvas')!.style.cursor || 'default'
+          )
+        })
+      }
+
+      await comfyPage.setSetting('Comfy.Canvas.NavigationMode', 'legacy')
+      await comfyPage.page.mouse.move(50, 50)
+      await comfyPage.page.mouse.down()
+      expect(await getCursorStyle()).toBe('grabbing')
+      await comfyPage.page.mouse.up()
+    })
   })
 })

browser_tests/tests/loadWorkflowInMedia.spec.ts

@@ -15,7 +15,8 @@ test.describe('Load Workflow in Media', () => {
     'workflow.mp4',
     'workflow.mov',
     'workflow.m4v',
-    'workflow.svg'
+    'workflow.svg',
+    'workflow.avif'
   ]
   fileNames.forEach(async (fileName) => {
     test(`Load workflow in ${fileName} (drop from filesystem)`, async ({

browser_tests/tests/menu.spec.ts

@@ -63,7 +63,7 @@ test.describe('Menu', () => {
     test('@mobile Items fully visible on mobile screen width', async ({
       comfyPage
     }) => {
-      await comfyPage.menu.topbar.openSubmenuMobile()
+      await comfyPage.menu.topbar.openTopbarMenu()
       const topLevelMenuItem = comfyPage.page
         .locator('a.p-menubar-item-link')
         .first()
@@ -74,8 +74,9 @@ test.describe('Menu', () => {
     })
 
     test('Displays keybinding next to item', async ({ comfyPage }) => {
+      await comfyPage.menu.topbar.openTopbarMenu()
       const workflowMenuItem = comfyPage.menu.topbar.getMenuItem('Workflow')
-      await workflowMenuItem.click()
+      await workflowMenuItem.hover()
       const exportTag = comfyPage.page.locator('.keybinding-tag', {
         hasText: 'Ctrl + s'
       })

browser_tests/tests/versionMismatchWarnings.spec.ts

@@ -0,0 +1,117 @@
+import { expect } from '@playwright/test'
+
+import { SystemStats } from '../../src/schemas/apiSchema'
+import { comfyPageFixture as test } from '../fixtures/ComfyPage'
+
+test.describe('Version Mismatch Warnings', () => {
+  const ALWAYS_AHEAD_OF_INSTALLED_VERSION = '100.100.100'
+  const ALWAYS_BEHIND_INSTALLED_VERSION = '0.0.0'
+
+  const createMockSystemStatsRes = (
+    requiredFrontendVersion: string
+  ): SystemStats => {
+    return {
+      system: {
+        os: 'posix',
+        ram_total: 67235385344,
+        ram_free: 13464207360,
+        comfyui_version: '0.3.46',
+        required_frontend_version: requiredFrontendVersion,
+        python_version: '3.12.3 (main, Jun 18 2025, 17:59:45) [GCC 13.3.0]',
+        pytorch_version: '2.6.0+cu124',
+        embedded_python: false,
+        argv: ['main.py']
+      },
+      devices: [
+        {
+          name: 'cuda:0 NVIDIA GeForce RTX 4070 : cudaMallocAsync',
+          type: 'cuda',
+          index: 0,
+          vram_total: 12557156352,
+          vram_free: 2439249920,
+          torch_vram_total: 0,
+          torch_vram_free: 0
+        }
+      ]
+    }
+  }
+
+  test.beforeEach(async ({ comfyPage }) => {
+    await comfyPage.setSetting('Comfy.UseNewMenu', 'Top')
+  })
+
+  test('should show version mismatch warnings when installed version lower than required', async ({
+    comfyPage
+  }) => {
+    // Mock system_stats route to indicate that the installed version is always ahead of the required version
+    await comfyPage.page.route('**/system_stats**', async (route) => {
+      await route.fulfill({
+        status: 200,
+        contentType: 'application/json',
+        body: JSON.stringify(
+          createMockSystemStatsRes(ALWAYS_AHEAD_OF_INSTALLED_VERSION)
+        )
+      })
+    })
+    await comfyPage.setup()
+
+    // Expect a warning toast to be shown
+    await expect(
+      comfyPage.page.getByText('Version Compatibility Warning')
+    ).toBeVisible()
+  })
+
+  test('should not show version mismatch warnings when installed version is ahead of required', async ({
+    comfyPage
+  }) => {
+    // Mock system_stats route to indicate that the installed version is always ahead of the required version
+    await comfyPage.page.route('**/system_stats**', async (route) => {
+      await route.fulfill({
+        status: 200,
+        contentType: 'application/json',
+        body: JSON.stringify(
+          createMockSystemStatsRes(ALWAYS_BEHIND_INSTALLED_VERSION)
+        )
+      })
+    })
+    await comfyPage.setup()
+
+    // Expect no warning toast to be shown
+    await expect(
+      comfyPage.page.getByText('Version Compatibility Warning')
+    ).not.toBeVisible()
+  })
+
+  test('should persist dismissed state across sessions', async ({
+    comfyPage
+  }) => {
+    // Mock system_stats route to indicate that the installed version is always ahead of the required version
+    await comfyPage.page.route('**/system_stats**', async (route) => {
+      await route.fulfill({
+        status: 200,
+        contentType: 'application/json',
+        body: JSON.stringify(
+          createMockSystemStatsRes(ALWAYS_AHEAD_OF_INSTALLED_VERSION)
+        )
+      })
+    })
+    await comfyPage.setup()
+
+    // Locate the warning toast and dismiss it
+    const warningToast = comfyPage.page
+      .locator('div')
+      .filter({ hasText: 'Version Compatibility' })
+      .nth(3)
+    await warningToast.waitFor({ state: 'visible' })
+    const dismissButton = warningToast.getByRole('button', { name: 'Close' })
+    await dismissButton.click()
+
+    // Reload the page, keeping local storage
+    await comfyPage.setup({ clearStorage: false })
+
+    // The same warning from same versions should not be shown to the user again
+    await expect(
+      comfyPage.page.getByText('Version Compatibility Warning')
+    ).not.toBeVisible()
+  })
+})

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@comfyorg/comfyui-frontend",
-  "version": "1.24.4",
+  "version": "1.25.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@comfyorg/comfyui-frontend",
-      "version": "1.24.4",
+      "version": "1.25.4",
       "license": "GPL-3.0-only",
       "dependencies": {
         "@alloc/quick-lru": "^5.2.0",
@@ -31,6 +31,8 @@
         "axios": "^1.8.2",
         "dompurify": "^3.2.5",
         "dotenv": "^16.4.5",
+        "extendable-media-recorder": "^9.2.27",
+        "extendable-media-recorder-wav-encoder": "^7.0.129",
         "firebase": "^11.6.0",
         "fuse.js": "^7.0.0",
         "jsondiffpatch": "^0.6.0",
@@ -40,6 +42,7 @@
         "pinia": "^2.1.7",
         "primeicons": "^7.0.0",
         "primevue": "^4.2.5",
+        "semver": "^7.7.2",
         "three": "^0.170.0",
         "tiptap-markdown": "^0.8.10",
         "vue": "^3.5.13",
@@ -62,6 +65,7 @@
         "@types/fs-extra": "^11.0.4",
         "@types/lodash": "^4.17.6",
         "@types/node": "^20.14.8",
+        "@types/semver": "^7.7.0",
         "@types/three": "^0.169.0",
         "@vitejs/plugin-vue": "^5.1.4",
         "@vue/test-utils": "^2.4.6",
@@ -557,6 +561,15 @@
         "url": "https://opencollective.com/babel"
       }
     },
+    "node_modules/@babel/core/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
     "node_modules/@babel/generator": {
       "version": "7.27.1",
       "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.27.1.tgz",
@@ -601,6 +614,15 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/@babel/helper-compilation-targets/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
     "node_modules/@babel/helper-create-class-features-plugin": {
       "version": "7.27.1",
       "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.27.1.tgz",
@@ -622,6 +644,15 @@
         "@babel/core": "^7.0.0"
       }
     },
+    "node_modules/@babel/helper-create-class-features-plugin/node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
     "node_modules/@babel/helper-member-expression-to-functions": {
       "version": "7.27.1",
       "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.27.1.tgz",
@@ -877,13 +908,10 @@
       }
     },
     "node_modules/@babel/runtime": {
-      "version": "7.26.10",
-      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.26.10.tgz",
-      "integrity": "sha512-2WJMeRQPHKSPemqk/awGrAiuFfzBmOIPXKizAsVhWH9YJqLZ0H+HS4c8loHGgW6utJ3E/ejXQUsiGaQy2NZ9Fw==",
+      "version": "7.27.6",
+      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.27.6.tgz",
+      "integrity": "sha512-vbavdySgbTTrmFE+EsiqUTzlOr5bzlnJtUv9PynGCAKvfQqjIXbvFdumPM/GxMDfyuGMJaJAU6TO4zc1Jf1i8Q==",
       "license": "MIT",
-      "dependencies": {
-        "regenerator-runtime": "^0.14.0"
-      },
       "engines": {
         "node": ">=6.9.0"
       }
@@ -951,7 +979,8 @@
     "node_modules/@comfyorg/litegraph": {
       "version": "0.17.1",
       "resolved": "https://registry.npmjs.org/@comfyorg/litegraph/-/litegraph-0.17.1.tgz",
-      "integrity": "sha512-SaDDWFvoH1bCfibvZjtX0JoLvFTJw2MUOWzrjyeuWVs00JpxiJ1I5f6oH/AO8lJqKdASWBVPzpC9zPMG45w4IQ=="
+      "integrity": "sha512-SaDDWFvoH1bCfibvZjtX0JoLvFTJw2MUOWzrjyeuWVs00JpxiJ1I5f6oH/AO8lJqKdASWBVPzpC9zPMG45w4IQ==",
+      "license": "MIT"
     },
     "node_modules/@cspotcode/source-map-support": {
       "version": "0.8.1",
@@ -2513,18 +2542,6 @@
         "js-yaml": "bin/js-yaml.js"
       }
     },
-    "node_modules/@intlify/eslint-plugin-vue-i18n/node_modules/semver": {
-      "version": "7.7.2",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz",
-      "integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/@intlify/eslint-plugin-vue-i18n/node_modules/synckit": {
       "version": "0.9.3",
       "resolved": "https://registry.npmjs.org/synckit/-/synckit-0.9.3.tgz",
@@ -4614,6 +4631,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/semver": {
+      "version": "7.7.0",
+      "resolved": "https://registry.npmjs.org/@types/semver/-/semver-7.7.0.tgz",
+      "integrity": "sha512-k107IF4+Xr7UHjwDc7Cfd6PRQfbdkiRabXGRjo07b4WyPahFBZCZ1sE+BNxYIJPPg73UkfOsVOLwqVc/6ETrIA==",
+      "dev": true
+    },
     "node_modules/@types/stats.js": {
       "version": "0.17.3",
       "resolved": "https://registry.npmjs.org/@types/stats.js/-/stats.js-0.17.3.tgz",
@@ -4845,19 +4868,6 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/@typescript-eslint/typescript-estree/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/@typescript-eslint/utils": {
       "version": "8.0.0",
       "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.0.0.tgz",
@@ -5815,6 +5825,19 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/automation-events": {
+      "version": "7.1.11",
+      "resolved": "https://registry.npmjs.org/automation-events/-/automation-events-7.1.11.tgz",
+      "integrity": "sha512-TnclbJ0482ydRenzrR9FIbqalHScBBdQTIXv8tVunhYx8dq7E0Eq5v5CSAo67YmLXNbx5jCstHcLZDJ33iONDw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "tslib": "^2.8.1"
+      },
+      "engines": {
+        "node": ">=18.2.0"
+      }
+    },
     "node_modules/autoprefixer": {
       "version": "10.4.19",
       "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.19.tgz",
@@ -6065,6 +6088,18 @@
         "node": ">=8"
       }
     },
+    "node_modules/broker-factory": {
+      "version": "3.1.7",
+      "resolved": "https://registry.npmjs.org/broker-factory/-/broker-factory-3.1.7.tgz",
+      "integrity": "sha512-RxbMXWq/Qvw9aLZMvuooMtVTm2/SV9JEpxpBbMuFhYAnDaZxctbJ+1b9ucHxADk/eQNqDijvWQjLVARqExAeyg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "fast-unique-numbers": "^9.0.22",
+        "tslib": "^2.8.1",
+        "worker-factory": "^7.0.43"
+      }
+    },
     "node_modules/browserslist": {
       "version": "4.24.5",
       "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.24.5.tgz",
@@ -6628,19 +6663,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/conf/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/confbox": {
       "version": "0.1.8",
       "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.1.8.tgz",
@@ -7540,19 +7562,6 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/editorconfig/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/ee-first": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
@@ -7832,18 +7841,6 @@
         "eslint": ">=6.0.0"
       }
     },
-    "node_modules/eslint-compat-utils/node_modules/semver": {
-      "version": "7.7.2",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz",
-      "integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/eslint-config-prettier": {
       "version": "10.1.2",
       "resolved": "https://registry.npmjs.org/eslint-config-prettier/-/eslint-config-prettier-10.1.2.tgz",
@@ -7943,19 +7940,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/eslint-plugin-vue/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/eslint-plugin-vue/node_modules/type-fest": {
       "version": "0.20.2",
       "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz",
@@ -8427,6 +8411,56 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/extendable-media-recorder": {
+      "version": "9.2.27",
+      "resolved": "https://registry.npmjs.org/extendable-media-recorder/-/extendable-media-recorder-9.2.27.tgz",
+      "integrity": "sha512-2X+Ixi1cxLek0Cj9x9atmhQ+apG+LwJpP2p3ypP8Pxau0poDnicrg7FTfPVQV5PW/3DHFm/eQ16vbgo5Yk3HGQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "media-encoder-host": "^9.0.20",
+        "multi-buffer-data-view": "^6.0.22",
+        "recorder-audio-worklet": "^6.0.48",
+        "standardized-audio-context": "^25.3.77",
+        "subscribable-things": "^2.1.53",
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/extendable-media-recorder-wav-encoder": {
+      "version": "7.0.129",
+      "resolved": "https://registry.npmjs.org/extendable-media-recorder-wav-encoder/-/extendable-media-recorder-wav-encoder-7.0.129.tgz",
+      "integrity": "sha512-/wqM2hnzvLy/iUlg/EU3JIF8MJcidy8I77Z7CCm5+CVEClDfcs6bH9PgghuisndwKTaud0Dh48RTD83gkfEjCw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "extendable-media-recorder-wav-encoder-broker": "^7.0.119",
+        "extendable-media-recorder-wav-encoder-worker": "^8.0.116",
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/extendable-media-recorder-wav-encoder-broker": {
+      "version": "7.0.119",
+      "resolved": "https://registry.npmjs.org/extendable-media-recorder-wav-encoder-broker/-/extendable-media-recorder-wav-encoder-broker-7.0.119.tgz",
+      "integrity": "sha512-BLrFOnqFLpsmmNpSk/TfjNs4j6ImCSGtoryIpRlqNu5S/Avt6gRJI0s4UYvdK7h17PCi+8vaDr75blvmU1sYlw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "broker-factory": "^3.1.7",
+        "extendable-media-recorder-wav-encoder-worker": "^8.0.116",
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/extendable-media-recorder-wav-encoder-worker": {
+      "version": "8.0.116",
+      "resolved": "https://registry.npmjs.org/extendable-media-recorder-wav-encoder-worker/-/extendable-media-recorder-wav-encoder-worker-8.0.116.tgz",
+      "integrity": "sha512-bJPR0B7ZHeoqi9YoSie+UXAfEYya3efQ9eLiWuyK4KcOv+SuYQvWCoyzX5kjvb6GqIBCUnev5xulfeHRlyCwvw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "tslib": "^2.8.1",
+        "worker-factory": "^7.0.43"
+      }
+    },
     "node_modules/fast-deep-equal": {
       "version": "3.1.3",
       "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
@@ -8470,6 +8504,19 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/fast-unique-numbers": {
+      "version": "9.0.22",
+      "resolved": "https://registry.npmjs.org/fast-unique-numbers/-/fast-unique-numbers-9.0.22.tgz",
+      "integrity": "sha512-dBR+30yHAqBGvOuxxQdnn2lTLHCO6r/9B+M4yF8mNrzr3u1yiF+YVJ6u3GTyPN/VRWqaE1FcscZDdBgVKmrmQQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "tslib": "^2.8.1"
+      },
+      "engines": {
+        "node": ">=18.2.0"
+      }
+    },
     "node_modules/fast-uri": {
       "version": "3.0.3",
       "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.0.3.tgz",
@@ -10380,18 +10427,6 @@
         "url": "https://opencollective.com/eslint"
       }
     },
-    "node_modules/jsonc-eslint-parser/node_modules/semver": {
-      "version": "7.7.2",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz",
-      "integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/jsondiffpatch": {
       "version": "0.6.0",
       "resolved": "https://registry.npmjs.org/jsondiffpatch/-/jsondiffpatch-0.6.0.tgz",
@@ -10822,19 +10857,6 @@
         "node": ">=14"
       }
     },
-    "node_modules/langsmith/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/latest-version": {
       "version": "9.0.0",
       "resolved": "https://registry.npmjs.org/latest-version/-/latest-version-9.0.0.tgz",
@@ -11504,6 +11526,43 @@
       "integrity": "sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w==",
       "license": "MIT"
     },
+    "node_modules/media-encoder-host": {
+      "version": "9.0.20",
+      "resolved": "https://registry.npmjs.org/media-encoder-host/-/media-encoder-host-9.0.20.tgz",
+      "integrity": "sha512-IyEYxw6az97RNuETOAZV4YZqNAPOiF9GKIp5mVZb4HOyWd6mhkWQ34ydOzhqAWogMyc4W05kjN/VCgTtgyFmsw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "media-encoder-host-broker": "^8.0.19",
+        "media-encoder-host-worker": "^10.0.19",
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/media-encoder-host-broker": {
+      "version": "8.0.19",
+      "resolved": "https://registry.npmjs.org/media-encoder-host-broker/-/media-encoder-host-broker-8.0.19.tgz",
+      "integrity": "sha512-lTpsNuaZdTCdtTHsOyww7Ae0Mwv+7mFS+O4YkFYWhXwVs0rm6XbRK5jRRn5JmcX3n1eTE1lQS5RgX8qbNaIjSg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "broker-factory": "^3.1.7",
+        "fast-unique-numbers": "^9.0.22",
+        "media-encoder-host-worker": "^10.0.19",
+        "tslib": "^2.8.1"
+      }
+    },
+    "node_modules/media-encoder-host-worker": {
+      "version": "10.0.19",
+      "resolved": "https://registry.npmjs.org/media-encoder-host-worker/-/media-encoder-host-worker-10.0.19.tgz",
+      "integrity": "sha512-I8fwc6f41peER3RFSiwDxnIHbqU7p3pc2ghQozcw9CQfL0mWEo4IjQJtyswrrlL/HO2pgVSMQbaNzE4q/0mfDQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "extendable-media-recorder-wav-encoder-broker": "^7.0.119",
+        "tslib": "^2.8.1",
+        "worker-factory": "^7.0.43"
+      }
+    },
     "node_modules/media-typer": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz",
@@ -12284,6 +12343,19 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/multi-buffer-data-view": {
+      "version": "6.0.22",
+      "resolved": "https://registry.npmjs.org/multi-buffer-data-view/-/multi-buffer-data-view-6.0.22.tgz",
+      "integrity": "sha512-SsI/exkodHsh+ofCV7An2PZWRaJC7eFVl7gtHQlMWFEDmWtb7cELr/GK32Nhe/6dZQhbr81o+Moswx9aXN3RRg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "tslib": "^2.8.1"
+      },
+      "engines": {
+        "node": ">=18.2.0"
+      }
+    },
     "node_modules/mustache": {
       "version": "4.2.0",
       "resolved": "https://registry.npmjs.org/mustache/-/mustache-4.2.0.tgz",
@@ -12790,19 +12862,6 @@
       "integrity": "sha512-dATvCeZN/8wQsGywez1mzHtTlP22H8OEfPrVMLNr4/eGa+ijtLn/6M5f0dY8UKNrC2O9UCU6SSoG3qRKnt7STw==",
       "dev": true
     },
-    "node_modules/package-json/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/package-manager-detector": {
       "version": "0.2.11",
       "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-0.2.11.tgz",
@@ -13881,10 +13940,31 @@
         "node": ">=8.10.0"
       }
     },
-    "node_modules/regenerator-runtime": {
-      "version": "0.14.1",
-      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.14.1.tgz",
-      "integrity": "sha512-dYnhHh0nJoMfnkZs6GmmhFknAGRrLznOu5nc9ML+EJxGvrx6H7teuevqVqCuPcPK//3eDrrjQhehXVx9cnkGdw=="
+    "node_modules/recorder-audio-worklet": {
+      "version": "6.0.48",
+      "resolved": "https://registry.npmjs.org/recorder-audio-worklet/-/recorder-audio-worklet-6.0.48.tgz",
+      "integrity": "sha512-PVlq/1hjCrPcUGqARg8rR30A303xDCao0jmlBTaUaKkN3Xme58RI7EQxurv8rw2eDwVrN+nrni0UoJoa5/v+zg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "broker-factory": "^3.1.7",
+        "fast-unique-numbers": "^9.0.22",
+        "recorder-audio-worklet-processor": "^5.0.35",
+        "standardized-audio-context": "^25.3.77",
+        "subscribable-things": "^2.1.53",
+        "tslib": "^2.8.1",
+        "worker-factory": "^7.0.43"
+      }
+    },
+    "node_modules/recorder-audio-worklet-processor": {
+      "version": "5.0.35",
+      "resolved": "https://registry.npmjs.org/recorder-audio-worklet-processor/-/recorder-audio-worklet-processor-5.0.35.tgz",
+      "integrity": "sha512-5Nzbk/6QzC3QFQ1EG2SE34c1ygLE22lIOvLyjy7N6XxE/jpAZrL4e7xR+yihiTaG3ajiWy6UjqL4XEBMM9ahFQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "tslib": "^2.8.1"
+      }
     },
     "node_modules/registry-auth-token": {
       "version": "5.0.3",
@@ -14401,6 +14481,12 @@
         "queue-microtask": "^1.2.2"
       }
     },
+    "node_modules/rxjs-interop": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/rxjs-interop/-/rxjs-interop-2.0.0.tgz",
+      "integrity": "sha512-ASEq9atUw7lualXB+knvgtvwkCEvGWV2gDD/8qnASzBkzEARZck9JAyxmY8OS6Nc1pCPEgDTKNcx+YqqYfzArw==",
+      "license": "MIT"
+    },
     "node_modules/sade": {
       "version": "1.8.1",
       "resolved": "https://registry.npmjs.org/sade/-/sade-1.8.1.tgz",
@@ -14470,12 +14556,14 @@
       "dev": true
     },
     "node_modules/semver": {
-      "version": "6.3.1",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-      "dev": true,
+      "version": "7.7.2",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz",
+      "integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==",
       "bin": {
         "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
       }
     },
     "node_modules/send": {
@@ -14793,6 +14881,17 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/standardized-audio-context": {
+      "version": "25.3.77",
+      "resolved": "https://registry.npmjs.org/standardized-audio-context/-/standardized-audio-context-25.3.77.tgz",
+      "integrity": "sha512-Ki9zNz6pKcC5Pi+QPjPyVsD9GwJIJWgryji0XL9cAJXMGyn+dPOf6Qik1AHei0+UNVcc4BOCa0hWLBzlwqsW/A==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.25.6",
+        "automation-events": "^7.0.9",
+        "tslib": "^2.7.0"
+      }
+    },
     "node_modules/statuses": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
@@ -14972,6 +15071,17 @@
       "integrity": "sha512-H2N9c26eXjzL/S/K+i/RHHcFanE74dptvvjM8iwzwbVcWY/zjBbgRqF3K0DY4+OD+uTTASTBvDoxPDaPN02D7g==",
       "dev": true
     },
+    "node_modules/subscribable-things": {
+      "version": "2.1.53",
+      "resolved": "https://registry.npmjs.org/subscribable-things/-/subscribable-things-2.1.53.tgz",
+      "integrity": "sha512-zWvN9F/eYQWDKszXl4NXkyqPXvMDZDmXfcHiM5C5WQZTTY2OK+2TZeDlA9oio69FEPqPu9T6yeEcAhQ2uRmnaw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "rxjs-interop": "^2.0.0",
+        "tslib": "^2.8.1"
+      }
+    },
     "node_modules/sucrase": {
       "version": "3.35.0",
       "resolved": "https://registry.npmjs.org/sucrase/-/sucrase-3.35.0.tgz",
@@ -16376,19 +16486,6 @@
         "url": "https://github.com/yeoman/update-notifier?sponsor=1"
       }
     },
-    "node_modules/update-notifier/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/uri-js": {
       "version": "4.4.1",
       "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
@@ -17208,19 +17305,6 @@
         "url": "https://opencollective.com/eslint"
       }
     },
-    "node_modules/vue-eslint-parser/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/vue-i18n": {
       "version": "9.14.3",
       "resolved": "https://registry.npmjs.org/vue-i18n/-/vue-i18n-9.14.3.tgz",
@@ -17273,19 +17357,6 @@
         "typescript": ">=5.0.0"
       }
     },
-    "node_modules/vue-tsc/node_modules/semver": {
-      "version": "7.6.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz",
-      "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==",
-      "dev": true,
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
     "node_modules/vuefire": {
       "version": "3.2.1",
       "resolved": "https://registry.npmjs.org/vuefire/-/vuefire-3.2.1.tgz",
@@ -17543,6 +17614,17 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/worker-factory": {
+      "version": "7.0.43",
+      "resolved": "https://registry.npmjs.org/worker-factory/-/worker-factory-7.0.43.tgz",
+      "integrity": "sha512-SACVoj3gWKtMVyT9N+VD11Pd/Xe58+ZFfp8b7y/PagOvj3i8lU3Uyj+Lj7WYTmSBvNLC0JFaQkx44E6DhH5+WA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.27.6",
+        "fast-unique-numbers": "^9.0.22",
+        "tslib": "^2.8.1"
+      }
+    },
     "node_modules/wrap-ansi": {
       "version": "9.0.0",
       "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.0.tgz",

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@comfyorg/comfyui-frontend",
   "private": true,
-  "version": "1.24.4",
+  "version": "1.25.4",
   "type": "module",
   "repository": "https://github.com/Comfy-Org/ComfyUI_frontend",
   "homepage": "https://comfy.org",
@@ -40,6 +40,7 @@
     "@types/fs-extra": "^11.0.4",
     "@types/lodash": "^4.17.6",
     "@types/node": "^20.14.8",
+    "@types/semver": "^7.7.0",
     "@types/three": "^0.169.0",
     "@vitejs/plugin-vue": "^5.1.4",
     "@vue/test-utils": "^2.4.6",
@@ -96,6 +97,8 @@
     "axios": "^1.8.2",
     "dompurify": "^3.2.5",
     "dotenv": "^16.4.5",
+    "extendable-media-recorder": "^9.2.27",
+    "extendable-media-recorder-wav-encoder": "^7.0.129",
     "firebase": "^11.6.0",
     "fuse.js": "^7.0.0",
     "jsondiffpatch": "^0.6.0",
@@ -105,6 +108,7 @@
     "pinia": "^2.1.7",
     "primeicons": "^7.0.0",
     "primevue": "^4.2.5",
+    "semver": "^7.7.2",
     "three": "^0.170.0",
     "tiptap-markdown": "^0.8.10",
     "vue": "^3.5.13",

src/CLAUDE.md

@@ -0,0 +1,44 @@
+# Source Code Guidelines
+
+## Service Layer
+
+### API Calls
+
+- Use `api.apiURL()` for backend endpoints
+- Use `api.fileURL()` for static files
+- Examples:
+  - Backend: `api.apiURL('/prompt')`
+  - Static: `api.fileURL('/templates/default.json')`
+
+### Error Handling
+
+- User-friendly and actionable messages
+- Proper error propagation
+
+### Security
+
+- Sanitize HTML with DOMPurify
+- Validate trusted sources
+- Never log secrets
+
+## State Management (Stores)
+
+### Store Design
+
+- Follow domain-driven design
+- Clear public interfaces
+- Restrict extension access
+
+### Best Practices
+
+- Use TypeScript for type safety
+- Implement proper error handling
+- Clean up subscriptions
+- Avoid @ts-expect-error
+
+## General Guidelines
+
+- Use lodash for utility functions
+- Implement proper TypeScript types
+- Follow Vue 3 composition API style guide
+- Use vue-i18n for ALL user-facing strings in `src/locales/en/main.json`

src/components/CLAUDE.md

@@ -0,0 +1,45 @@
+# Component Guidelines
+
+## Vue 3 Composition API
+
+- Use setup() function
+- Destructure props (Vue 3.5 style)
+- Use ref/reactive for state
+- Implement computed() for derived state
+- Use provide/inject for dependency injection
+
+## Component Communication
+
+- Prefer `emit/@event-name` for state changes
+- Use `defineExpose` only for imperative operations (`form.validate()`, `modal.open()`)
+- Events promote loose coupling
+
+## UI Framework
+
+- Deprecated PrimeVue component replacements:
+  - Dropdown → Select
+  - OverlayPanel → Popover
+  - Calendar → DatePicker
+  - InputSwitch → ToggleSwitch
+  - Sidebar → Drawer
+  - Chips → AutoComplete with multiple enabled
+  - TabMenu → Tabs without panels
+  - Steps → Stepper without panels
+  - InlineMessage → Message
+
+## Styling
+
+- Use Tailwind CSS only (no custom CSS)
+- Dark theme: use "dark-theme:" prefix
+- For common operations, try to use existing VueUse composables that automatically handle effect scope
+  - Example: Use `useElementHover` instead of manually managing mouseover/mouseout event listeners
+  - Example: Use `useIntersectionObserver` for visibility detection instead of custom scroll handlers
+
+## Best Practices
+
+- Extract complex conditionals to computed
+- Implement cleanup for async operations
+- Use vue-i18n for ALL UI strings
+- Use lifecycle hooks: onMounted, onUpdated
+- Use Teleport/Suspense when needed
+- Proper props and emits definitions

src/components/actionbar/ComfyActionbar.vue

@@ -30,10 +30,11 @@ import ComfyQueueButton from './ComfyQueueButton.vue'
 
 const settingsStore = useSettingStore()
 
-const visible = computed(
-  () => settingsStore.get('Comfy.UseNewMenu') !== 'Disabled'
-)
+const position = computed(() => settingsStore.get('Comfy.UseNewMenu'))
 
+const visible = computed(() => position.value !== 'Disabled')
+
+const topMenuRef = inject<Ref<HTMLDivElement | null>>('topMenuRef')
 const panelRef = ref<HTMLElement | null>(null)
 const dragHandleRef = ref<HTMLElement | null>(null)
 const isDocked = useLocalStorage('Comfy.MenuPosition.Docked', false)
@@ -49,7 +50,16 @@ const {
 } = useDraggable(panelRef, {
   initialValue: { x: 0, y: 0 },
   handle: dragHandleRef,
-  containerElement: document.body
+  containerElement: document.body,
+  onMove: (event) => {
+    // Prevent dragging the menu over the top of the tabs
+    if (position.value === 'Top') {
+      const minY = topMenuRef?.value?.getBoundingClientRect().top ?? 40
+      if (event.y < minY) {
+        event.y = minY
+      }
+    }
+  }
 })
 
 // Update storedPosition when x or y changes
@@ -182,7 +192,6 @@ const adjustMenuPosition = () => {
 
 useEventListener(window, 'resize', adjustMenuPosition)
 
-const topMenuRef = inject<Ref<HTMLDivElement | null>>('topMenuRef')
 const topMenuBounds = useElementBounding(topMenuRef)
 const overlapThreshold = 20 // pixels
 const isOverlappingWithTopMenu = computed(() => {

src/components/breadcrumb/SubgraphBreadcrumb.vue

@@ -1,35 +1,71 @@
 <template>
-  <div v-if="workflowStore.isSubgraphActive" class="p-2 subgraph-breadcrumb">
+  <div
+    class="subgraph-breadcrumb w-auto"
+    :class="{
+      'subgraph-breadcrumb-collapse': collapseTabs,
+      'subgraph-breadcrumb-overflow': overflowingTabs
+    }"
+    :style="{
+      '--p-breadcrumb-gap': `${ITEM_GAP}px`,
+      '--p-breadcrumb-item-min-width': `${MIN_WIDTH}px`,
+      '--p-breadcrumb-item-padding': `${ITEM_PADDING}px`,
+      '--p-breadcrumb-icon-width': `${ICON_WIDTH}px`
+    }"
+  >
     <Breadcrumb
-      class="bg-transparent"
-      :home="home"
+      ref="breadcrumbRef"
+      class="bg-transparent p-0"
       :model="items"
       aria-label="Graph navigation"
-      @item-click="handleItemClick"
-    />
+    >
+      <template #item="{ item }">
+        <SubgraphBreadcrumbItem
+          :item="item"
+          :is-active="item === items.at(-1)"
+        />
+      </template>
+      <template #separator
+        ><span style="transform: scale(1.5)"> / </span></template
+      >
+    </Breadcrumb>
   </div>
 </template>
 
 <script setup lang="ts">
 import { useEventListener } from '@vueuse/core'
 import Breadcrumb from 'primevue/breadcrumb'
-import type { MenuItem, MenuItemCommandEvent } from 'primevue/menuitem'
-import { computed } from 'vue'
+import type { MenuItem } from 'primevue/menuitem'
+import { computed, onUpdated, ref, watch } from 'vue'
 
+import SubgraphBreadcrumbItem from '@/components/breadcrumb/SubgraphBreadcrumbItem.vue'
+import { useOverflowObserver } from '@/composables/element/useOverflowObserver'
 import { useCanvasStore } from '@/stores/graphStore'
 import { useSubgraphNavigationStore } from '@/stores/subgraphNavigationStore'
 import { useWorkflowStore } from '@/stores/workflowStore'
 import { forEachSubgraphNode } from '@/utils/graphTraversalUtil'
 
+const MIN_WIDTH = 28
+const ITEM_GAP = 8
+const ITEM_PADDING = 8
+const ICON_WIDTH = 20
+
 const workflowStore = useWorkflowStore()
 const navigationStore = useSubgraphNavigationStore()
-
+const breadcrumbRef = ref<InstanceType<typeof Breadcrumb>>()
 const workflowName = computed(() => workflowStore.activeWorkflow?.filename)
+const collapseTabs = ref(false)
+const overflowingTabs = ref(false)
+
+const breadcrumbElement = computed(() => {
+  if (!breadcrumbRef.value) return null
+
+  const el = (breadcrumbRef.value as unknown as { $el: HTMLElement }).$el
+  const list = el?.querySelector('.p-breadcrumb-list') as HTMLElement
+  return list
+})
 
 const items = computed(() => {
-  if (!navigationStore.navigationStack.length) return []
-
-  return navigationStore.navigationStack.map<MenuItem>((subgraph) => ({
+  const items = navigationStore.navigationStack.map<MenuItem>((subgraph) => ({
     label: subgraph.name,
     command: () => {
       const canvas = useCanvasStore().getCanvas()
@@ -46,11 +82,14 @@ const items = computed(() => {
       })
     }
   }))
+
+  return [home.value, ...items]
 })
 
 const home = computed(() => ({
   label: workflowName.value,
   icon: 'pi pi-home',
+  key: 'root',
   command: () => {
     const canvas = useCanvasStore().getCanvas()
     if (!canvas.graph) throw new TypeError('Canvas has no graph')
@@ -59,10 +98,6 @@ const home = computed(() => ({
   }
 }))
 
-const handleItemClick = (event: MenuItemCommandEvent) => {
-  event.item.command?.(event)
-}
-
 // Escape exits from the current subgraph.
 useEventListener(document, 'keydown', (event) => {
   if (event.key === 'Escape') {
@@ -74,21 +109,116 @@ useEventListener(document, 'keydown', (event) => {
     )
   }
 })
+
+// Check for overflow on breadcrumb items and collapse/expand the breadcrumb to fit
+let overflowObserver: ReturnType<typeof useOverflowObserver> | undefined
+watch(breadcrumbElement, (el) => {
+  overflowObserver?.dispose()
+  overflowObserver = undefined
+
+  if (!el) return
+
+  overflowObserver = useOverflowObserver(el, {
+    onCheck: (isOverflowing) => {
+      overflowingTabs.value = isOverflowing
+
+      if (collapseTabs.value) {
+        // Items are currently hidden, check if we can show them
+        if (!isOverflowing) {
+          const items = [
+            ...el.querySelectorAll('.p-breadcrumb-item')
+          ] as HTMLElement[]
+
+          if (items.length < 3) return
+
+          const itemsWithIcon = items.filter((item) =>
+            item.querySelector('.p-breadcrumb-item-link-icon-visible')
+          ).length
+          const separators = el.querySelectorAll(
+            '.p-breadcrumb-separator'
+          ) as NodeListOf<HTMLElement>
+          const separator = separators[separators.length - 1] as HTMLElement
+          const separatorWidth = separator.offsetWidth
+
+          // items + separators + gaps + icons
+          const itemsWidth =
+            (MIN_WIDTH + ITEM_PADDING + ITEM_PADDING) * items.length +
+            itemsWithIcon * ICON_WIDTH
+          const separatorsWidth = (items.length - 1) * separatorWidth
+          const gapsWidth = (items.length - 1) * (ITEM_GAP * 2)
+          const totalWidth = itemsWidth + separatorsWidth + gapsWidth
+          const containerWidth = el.clientWidth
+
+          if (totalWidth <= containerWidth) {
+            collapseTabs.value = false
+          }
+        }
+      } else if (isOverflowing) {
+        collapseTabs.value = true
+      }
+    }
+  })
+})
+
+// If e.g. the workflow name changes, we need to check the overflow again
+onUpdated(() => {
+  if (!overflowObserver?.disposed.value) {
+    overflowObserver?.checkOverflow()
+  }
+})
 </script>
 
-<style>
-.subgraph-breadcrumb {
-  .p-breadcrumb-item-link,
-  .p-breadcrumb-item-icon {
-    @apply select-none;
+<style scoped>
+.subgraph-breadcrumb:not(:empty) {
+  flex: auto;
+  flex-shrink: 10000;
+  min-width: 120px;
+}
 
-    color: #d26565;
-    text-shadow:
-      1px 1px 0 #000,
-      -1px -1px 0 #000,
-      1px -1px 0 #000,
-      -1px 1px 0 #000,
-      0 0 0.375rem #000;
+.subgraph-breadcrumb,
+:deep(.p-breadcrumb) {
+  @apply overflow-hidden;
+}
+
+:deep(.p-breadcrumb-item) {
+  @apply flex items-center rounded-lg overflow-hidden;
+  min-width: calc(var(--p-breadcrumb-item-min-width) + 1rem);
+  /* Collapse middle items first */
+  flex-shrink: 10000;
+}
+
+:deep(.p-breadcrumb-item:has(.p-breadcrumb-item-link-icon-visible)) {
+  min-width: calc(var(--p-breadcrumb-item-min-width) + 1rem + 20px);
+}
+
+:deep(.p-breadcrumb-item:first-child) {
+  /* Then collapse the root workflow */
+  flex-shrink: 5000;
+}
+
+:deep(.p-breadcrumb-item:last-child) {
+  /* Then collapse the active item */
+  flex-shrink: 1;
+}
+
+:deep(.p-breadcrumb-item:hover),
+:deep(.p-breadcrumb-item:has(.p-breadcrumb-item-link-menu-visible)) {
+  background-color: color-mix(in srgb, var(--fg-color) 10%, transparent);
+  color: var(--fg-color);
+}
+</style>
+
+<style>
+.subgraph-breadcrumb-collapse .p-breadcrumb-list {
+  .p-breadcrumb-item,
+  .p-breadcrumb-separator {
+    @apply hidden;
+  }
+
+  .p-breadcrumb-item:nth-last-child(3),
+  .p-breadcrumb-separator:nth-last-child(2),
+  .p-breadcrumb-item:nth-last-child(1) {
+    @apply block;
   }
 }
 </style>

src/components/breadcrumb/SubgraphBreadcrumbItem.vue

@@ -0,0 +1,215 @@
+<template>
+  <a
+    ref="wrapperRef"
+    v-tooltip.bottom="{
+      value: item.label,
+      showDelay: 512
+    }"
+    href="#"
+    class="cursor-pointer p-breadcrumb-item-link"
+    :class="{
+      'flex items-center gap-1': isActive,
+      'p-breadcrumb-item-link-menu-visible': menu?.overlayVisible,
+      'p-breadcrumb-item-link-icon-visible': isActive
+    }"
+    @click="handleClick"
+  >
+    <span class="p-breadcrumb-item-label">{{ item.label }}</span>
+    <i v-if="isActive" class="pi pi-angle-down text-[10px]"></i>
+  </a>
+  <Menu
+    v-if="isActive"
+    ref="menu"
+    :model="menuItems"
+    :popup="true"
+    :pt="{
+      root: {
+        style: 'background-color: var(--comfy-menu-secondary-bg)'
+      },
+      itemLink: {
+        class: 'py-2'
+      }
+    }"
+  />
+  <InputText
+    v-if="isEditing"
+    ref="itemInputRef"
+    v-model="itemLabel"
+    class="fixed z-[10000] text-[.8rem] px-2 py-2"
+    @blur="inputBlur(true)"
+    @click.stop
+    @keydown.enter="inputBlur(true)"
+    @keydown.esc="inputBlur(false)"
+  />
+</template>
+
+<script setup lang="ts">
+import InputText from 'primevue/inputtext'
+import Menu, { MenuState } from 'primevue/menu'
+import type { MenuItem } from 'primevue/menuitem'
+import { computed, nextTick, ref } from 'vue'
+import { useI18n } from 'vue-i18n'
+
+import { useDialogService } from '@/services/dialogService'
+import { useWorkflowService } from '@/services/workflowService'
+import { useCommandStore } from '@/stores/commandStore'
+import { useSubgraphNavigationStore } from '@/stores/subgraphNavigationStore'
+import { ComfyWorkflow, useWorkflowStore } from '@/stores/workflowStore'
+import { appendJsonExt } from '@/utils/formatUtil'
+
+interface Props {
+  item: MenuItem
+  isActive?: boolean
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  isActive: false
+})
+
+const { t } = useI18n()
+const menu = ref<InstanceType<typeof Menu> & MenuState>()
+const dialogService = useDialogService()
+const workflowStore = useWorkflowStore()
+const workflowService = useWorkflowService()
+const isEditing = ref(false)
+const itemLabel = ref<string>()
+const itemInputRef = ref<{ $el?: HTMLInputElement }>()
+const wrapperRef = ref<HTMLAnchorElement>()
+
+const rename = async (
+  newName: string | null | undefined,
+  initialName: string
+) => {
+  if (newName && newName !== initialName) {
+    // Synchronize the node titles with the new name
+    props.item.updateTitle?.(newName)
+
+    if (workflowStore.activeSubgraph) {
+      workflowStore.activeSubgraph.name = newName
+    } else if (workflowStore.activeWorkflow) {
+      try {
+        await workflowService.renameWorkflow(
+          workflowStore.activeWorkflow,
+          ComfyWorkflow.basePath + appendJsonExt(newName)
+        )
+      } catch (error) {
+        console.error(error)
+        dialogService.showErrorDialog(error)
+        return
+      }
+    }
+
+    // Force the navigation stack to recompute the labels
+    // TODO: investigate if there is a better way to do this
+    const navigationStore = useSubgraphNavigationStore()
+    navigationStore.restoreState(navigationStore.exportState())
+  }
+}
+
+const menuItems = computed<MenuItem[]>(() => {
+  return [
+    {
+      label: t('g.rename'),
+      icon: 'pi pi-pencil',
+      command: async () => {
+        let initialName =
+          workflowStore.activeSubgraph?.name ??
+          workflowStore.activeWorkflow?.filename
+
+        if (!initialName) return
+
+        const newName = await dialogService.prompt({
+          title: t('g.rename'),
+          message: t('breadcrumbsMenu.enterNewName'),
+          defaultValue: initialName
+        })
+
+        await rename(newName, initialName)
+      }
+    },
+    {
+      label: t('breadcrumbsMenu.duplicate'),
+      icon: 'pi pi-copy',
+      command: async () => {
+        await workflowService.duplicateWorkflow(workflowStore.activeWorkflow!)
+      },
+      visible: props.item.key === 'root'
+    },
+    {
+      separator: true
+    },
+    {
+      label: t('breadcrumbsMenu.clearWorkflow'),
+      icon: 'pi pi-trash',
+      command: async () => {
+        await useCommandStore().execute('Comfy.ClearWorkflow')
+      }
+    },
+    {
+      separator: true,
+      visible: props.item.key === 'root'
+    },
+    {
+      label: t('breadcrumbsMenu.deleteWorkflow'),
+      icon: 'pi pi-times',
+      command: async () => {
+        await workflowService.deleteWorkflow(workflowStore.activeWorkflow!)
+      },
+      visible: props.item.key === 'root'
+    }
+  ]
+})
+
+const handleClick = (event: MouseEvent) => {
+  if (isEditing.value) {
+    return
+  }
+
+  if (event.detail === 1) {
+    if (props.isActive) {
+      menu.value?.toggle(event)
+    } else {
+      props.item.command?.({ item: props.item, originalEvent: event })
+    }
+  } else if (props.isActive && event.detail === 2) {
+    menu.value?.hide()
+    event.stopPropagation()
+    event.preventDefault()
+    isEditing.value = true
+    itemLabel.value = props.item.label as string
+    void nextTick(() => {
+      if (itemInputRef.value?.$el) {
+        itemInputRef.value.$el.focus()
+        itemInputRef.value.$el.select()
+        if (wrapperRef.value) {
+          itemInputRef.value.$el.style.width = `${Math.max(200, wrapperRef.value.offsetWidth)}px`
+        }
+      }
+    })
+  }
+}
+
+const inputBlur = async (doRename: boolean) => {
+  if (doRename) {
+    await rename(itemLabel.value, props.item.label as string)
+  }
+
+  isEditing.value = false
+}
+</script>
+
+<style scoped>
+.p-breadcrumb-item-link,
+.p-breadcrumb-item-icon {
+  @apply select-none;
+}
+
+.p-breadcrumb-item-link {
+  @apply overflow-hidden;
+  padding: var(--p-breadcrumb-item-padding);
+}
+
+.p-breadcrumb-item-label {
+  @apply whitespace-nowrap text-ellipsis overflow-hidden;
+}
+</style>

src/components/dialog/content/LoadWorkflowWarning.vue

@@ -2,7 +2,7 @@
   <NoResultsPlaceholder
     class="pb-0"
     icon="pi pi-exclamation-circle"
-    title="Missing Node Types"
+    title="Some Nodes Are Missing"
     message="When loading the graph, the following node types were not found"
   />
   <MissingCoreNodesMessage :missing-core-nodes="missingCoreNodes" />

src/components/graph/GraphCanvas.vue

@@ -16,7 +16,6 @@
         <SecondRowWorkflowTabs
           v-if="workflowTabsPosition === 'Topbar (2nd-row)'"
         />
-        <SubgraphBreadcrumb />
       </div>
       <GraphCanvasMenu v-if="canvasMenuEnabled" class="pointer-events-auto" />
 
@@ -56,7 +55,6 @@ import { computed, onMounted, ref, watch, watchEffect } from 'vue'
 
 import LiteGraphCanvasSplitterOverlay from '@/components/LiteGraphCanvasSplitterOverlay.vue'
 import BottomPanel from '@/components/bottomPanel/BottomPanel.vue'
-import SubgraphBreadcrumb from '@/components/breadcrumb/SubgraphBreadcrumb.vue'
 import DomWidgets from '@/components/graph/DomWidgets.vue'
 import GraphCanvasMenu from '@/components/graph/GraphCanvasMenu.vue'
 import MiniMap from '@/components/graph/MiniMap.vue'

src/components/graph/GraphCanvasMenu.vue

@@ -1,6 +1,7 @@
 <template>
   <ButtonGroup
     class="p-buttongroup-vertical absolute bottom-[10px] right-[10px] z-[1000]"
+    @wheel="canvasInteractions.handleWheel"
   >
     <Button
       v-tooltip.left="t('graphCanvasMenu.zoomIn')"
@@ -57,7 +58,7 @@
       @click="() => commandStore.execute('Comfy.Canvas.ToggleLinkVisibility')"
     />
     <Button
-      v-tooltip.left="minimapTooltip"
+      v-tooltip.left="t('graphCanvasMenu.toggleMinimap') + ' (Alt + m)'"
       severity="secondary"
       :icon="'pi pi-map'"
       :aria-label="$t('graphCanvasMenu.toggleMinimap')"
@@ -75,25 +76,18 @@ import ButtonGroup from 'primevue/buttongroup'
 import { computed } from 'vue'
 import { useI18n } from 'vue-i18n'
 
+import { useCanvasInteractions } from '@/composables/graph/useCanvasInteractions'
 import { useCommandStore } from '@/stores/commandStore'
 import { useCanvasStore } from '@/stores/graphStore'
-import { useKeybindingStore } from '@/stores/keybindingStore'
 import { useSettingStore } from '@/stores/settingStore'
 
 const { t } = useI18n()
 const commandStore = useCommandStore()
 const canvasStore = useCanvasStore()
-const keybindingStore = useKeybindingStore()
 const settingStore = useSettingStore()
+const canvasInteractions = useCanvasInteractions()
 
 const minimapVisible = computed(() => settingStore.get('Comfy.Minimap.Visible'))
-const minimapTooltip = computed(() => {
-  const baseText = t('graphCanvasMenu.toggleMinimap')
-  const keybinding = keybindingStore.getKeybindingByCommandId(
-    'Comfy.Canvas.ToggleMinimap'
-  )
-  return keybinding ? `${baseText} (${keybinding.combo.toString()})` : baseText
-})
 const linkHidden = computed(
   () => settingStore.get('Comfy.LinkRenderMode') === LiteGraph.HIDDEN_LINK
 )

src/components/graph/SelectionToolbox.vue

@@ -5,6 +5,7 @@
       header: 'hidden',
       content: 'p-0 flex flex-row'
     }"
+    @wheel="canvasInteractions.handleWheel"
   >
     <ExecuteButton />
     <ColorPickerButton />
@@ -39,6 +40,7 @@ import HelpButton from '@/components/graph/selectionToolbox/HelpButton.vue'
 import MaskEditorButton from '@/components/graph/selectionToolbox/MaskEditorButton.vue'
 import PinButton from '@/components/graph/selectionToolbox/PinButton.vue'
 import RefreshButton from '@/components/graph/selectionToolbox/RefreshButton.vue'
+import { useCanvasInteractions } from '@/composables/graph/useCanvasInteractions'
 import { useExtensionService } from '@/services/extensionService'
 import { type ComfyCommandImpl, useCommandStore } from '@/stores/commandStore'
 import { useCanvasStore } from '@/stores/graphStore'
@@ -46,6 +48,7 @@ import { useCanvasStore } from '@/stores/graphStore'
 const commandStore = useCommandStore()
 const canvasStore = useCanvasStore()
 const extensionService = useExtensionService()
+const canvasInteractions = useCanvasInteractions()
 
 const extensionToolboxCommands = computed<ComfyCommandImpl[]>(() => {
   const commandIds = new Set<string>(

src/components/graph/selectionToolbox/ColorPickerButton.spec.ts

@@ -0,0 +1,122 @@
+import { mount } from '@vue/test-utils'
+import { createPinia, setActivePinia } from 'pinia'
+import PrimeVue from 'primevue/config'
+import Tooltip from 'primevue/tooltip'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { createI18n } from 'vue-i18n'
+
+// Import after mocks
+import ColorPickerButton from '@/components/graph/selectionToolbox/ColorPickerButton.vue'
+import { useCanvasStore } from '@/stores/graphStore'
+import { useWorkflowStore } from '@/stores/workflowStore'
+
+// Mock the litegraph module
+vi.mock('@comfyorg/litegraph', async () => {
+  const actual = await vi.importActual('@comfyorg/litegraph')
+  return {
+    ...actual,
+    LGraphCanvas: {
+      node_colors: {
+        red: { bgcolor: '#ff0000' },
+        green: { bgcolor: '#00ff00' },
+        blue: { bgcolor: '#0000ff' }
+      }
+    },
+    LiteGraph: {
+      NODE_DEFAULT_BGCOLOR: '#353535'
+    },
+    isColorable: vi.fn(() => true)
+  }
+})
+
+// Mock the colorUtil module
+vi.mock('@/utils/colorUtil', () => ({
+  adjustColor: vi.fn((color: string) => color + '_light')
+}))
+
+// Mock the litegraphUtil module
+vi.mock('@/utils/litegraphUtil', () => ({
+  getItemsColorOption: vi.fn(() => null),
+  isLGraphNode: vi.fn((item) => item?.type === 'LGraphNode'),
+  isLGraphGroup: vi.fn((item) => item?.type === 'LGraphGroup'),
+  isReroute: vi.fn(() => false)
+}))
+
+describe('ColorPickerButton', () => {
+  let canvasStore: ReturnType<typeof useCanvasStore>
+  let workflowStore: ReturnType<typeof useWorkflowStore>
+
+  const i18n = createI18n({
+    legacy: false,
+    locale: 'en',
+    messages: {
+      en: {
+        color: {
+          noColor: 'No Color',
+          red: 'Red',
+          green: 'Green',
+          blue: 'Blue'
+        }
+      }
+    }
+  })
+
+  beforeEach(() => {
+    setActivePinia(createPinia())
+    canvasStore = useCanvasStore()
+    workflowStore = useWorkflowStore()
+
+    // Set up default store state
+    canvasStore.selectedItems = []
+
+    // Mock workflow store
+    workflowStore.activeWorkflow = {
+      changeTracker: {
+        checkState: vi.fn()
+      }
+    } as any
+  })
+
+  const createWrapper = () => {
+    return mount(ColorPickerButton, {
+      global: {
+        plugins: [PrimeVue, i18n],
+        directives: {
+          tooltip: Tooltip
+        }
+      }
+    })
+  }
+
+  it('should render when nodes are selected', () => {
+    // Add a mock node to selectedItems
+    canvasStore.selectedItems = [{ type: 'LGraphNode' } as any]
+    const wrapper = createWrapper()
+    expect(wrapper.find('button').exists()).toBe(true)
+  })
+
+  it('should not render when nothing is selected', () => {
+    // Keep selectedItems empty
+    canvasStore.selectedItems = []
+    const wrapper = createWrapper()
+    // The button exists but is hidden with v-show
+    expect(wrapper.find('button').exists()).toBe(true)
+    expect(wrapper.find('button').attributes('style')).toContain(
+      'display: none'
+    )
+  })
+
+  it('should toggle color picker visibility on button click', async () => {
+    canvasStore.selectedItems = [{ type: 'LGraphNode' } as any]
+    const wrapper = createWrapper()
+    const button = wrapper.find('button')
+
+    expect(wrapper.find('.color-picker-container').exists()).toBe(false)
+
+    await button.trigger('click')
+    expect(wrapper.find('.color-picker-container').exists()).toBe(true)
+
+    await button.trigger('click')
+    expect(wrapper.find('.color-picker-container').exists()).toBe(false)
+  })
+})

src/components/graph/selectionToolbox/ColorPickerButton.vue

@@ -2,6 +2,10 @@
   <div class="relative">
     <Button
       v-show="canvasStore.nodeSelected || canvasStore.groupSelected"
+      v-tooltip.top="{
+        value: localizedCurrentColorName ?? t('color.noColor'),
+        showDelay: 512
+      }"
       severity="secondary"
       text
       @click="() => (showColorPicker = !showColorPicker)"
@@ -123,6 +127,16 @@ const currentColor = computed(() =>
     : null
 )
 
+const localizedCurrentColorName = computed(() => {
+  if (!currentColorOption.value?.bgcolor) return null
+  const colorOption = colorOptions.find(
+    (option) =>
+      option.value.dark === currentColorOption.value?.bgcolor ||
+      option.value.light === currentColorOption.value?.bgcolor
+  )
+  return colorOption?.localizedName ?? NO_COLOR_OPTION.localizedName
+})
+
 watch(
   () => canvasStore.selectedItems,
   (newSelectedItems) => {

src/components/node/NodePreview.spec.ts

@@ -0,0 +1,132 @@
+import { mount } from '@vue/test-utils'
+import { createPinia } from 'pinia'
+import PrimeVue from 'primevue/config'
+import { beforeAll, describe, expect, it } from 'vitest'
+import { createApp } from 'vue'
+import { createI18n } from 'vue-i18n'
+
+import type { ComfyNodeDef as ComfyNodeDefV2 } from '@/schemas/nodeDef/nodeDefSchemaV2'
+
+import NodePreview from './NodePreview.vue'
+
+describe('NodePreview', () => {
+  let i18n: ReturnType<typeof createI18n>
+  let pinia: ReturnType<typeof createPinia>
+
+  beforeAll(() => {
+    // Create a Vue app instance for PrimeVue
+    const app = createApp({})
+    app.use(PrimeVue)
+
+    // Create i18n instance
+    i18n = createI18n({
+      legacy: false,
+      locale: 'en',
+      messages: {
+        en: {
+          g: {
+            preview: 'Preview'
+          }
+        }
+      }
+    })
+
+    // Create pinia instance
+    pinia = createPinia()
+  })
+
+  const mockNodeDef: ComfyNodeDefV2 = {
+    name: 'TestNode',
+    display_name:
+      'Test Node With A Very Long Display Name That Should Overflow',
+    category: 'test',
+    output_node: false,
+    inputs: {
+      test_input: {
+        name: 'test_input',
+        type: 'STRING',
+        tooltip: 'Test input'
+      }
+    },
+    outputs: [],
+    python_module: 'test_module',
+    description: 'Test node description'
+  }
+
+  const mountComponent = (nodeDef: ComfyNodeDefV2 = mockNodeDef) => {
+    return mount(NodePreview, {
+      global: {
+        plugins: [PrimeVue, i18n, pinia],
+        stubs: {
+          // Stub stores if needed
+        }
+      },
+      props: {
+        nodeDef
+      }
+    })
+  }
+
+  it('renders node preview with correct structure', () => {
+    const wrapper = mountComponent()
+
+    expect(wrapper.find('._sb_node_preview').exists()).toBe(true)
+    expect(wrapper.find('.node_header').exists()).toBe(true)
+    expect(wrapper.find('._sb_preview_badge').text()).toBe('Preview')
+  })
+
+  it('applies overflow-ellipsis class to node header for text truncation', () => {
+    const wrapper = mountComponent()
+    const nodeHeader = wrapper.find('.node_header')
+
+    expect(nodeHeader.classes()).toContain('overflow-ellipsis')
+    expect(nodeHeader.classes()).toContain('mr-4')
+  })
+
+  it('sets title attribute on node header with full display name', () => {
+    const wrapper = mountComponent()
+    const nodeHeader = wrapper.find('.node_header')
+
+    expect(nodeHeader.attributes('title')).toBe(mockNodeDef.display_name)
+  })
+
+  it('displays truncated long node names with ellipsis', () => {
+    const longNameNodeDef: ComfyNodeDefV2 = {
+      ...mockNodeDef,
+      display_name:
+        'This Is An Extremely Long Node Name That Should Definitely Be Truncated With Ellipsis To Prevent Layout Issues'
+    }
+
+    const wrapper = mountComponent(longNameNodeDef)
+    const nodeHeader = wrapper.find('.node_header')
+
+    // Verify the title attribute contains the full name
+    expect(nodeHeader.attributes('title')).toBe(longNameNodeDef.display_name)
+
+    // Verify overflow handling classes are applied
+    expect(nodeHeader.classes()).toContain('overflow-ellipsis')
+
+    // The actual text content should still be the full name (CSS handles truncation)
+    expect(nodeHeader.text()).toContain(longNameNodeDef.display_name)
+  })
+
+  it('handles short node names without issues', () => {
+    const shortNameNodeDef: ComfyNodeDefV2 = {
+      ...mockNodeDef,
+      display_name: 'Short'
+    }
+
+    const wrapper = mountComponent(shortNameNodeDef)
+    const nodeHeader = wrapper.find('.node_header')
+
+    expect(nodeHeader.attributes('title')).toBe('Short')
+    expect(nodeHeader.text()).toContain('Short')
+  })
+
+  it('applies proper spacing to the dot element', () => {
+    const wrapper = mountComponent()
+    const headdot = wrapper.find('.headdot')
+
+    expect(headdot.classes()).toContain('pr-3')
+  })
+})

src/components/node/NodePreview.vue

@@ -6,13 +6,14 @@ https://github.com/Nuked88/ComfyUI-N-Sidebar/blob/7ae7da4a9761009fb6629bc04c6830
   <div class="_sb_node_preview">
     <div class="_sb_table">
       <div
-        class="node_header"
+        class="node_header overflow-ellipsis mr-4"
+        :title="nodeDef.display_name"
         :style="{
           backgroundColor: litegraphColors.NODE_DEFAULT_COLOR,
           color: litegraphColors.NODE_TITLE_COLOR
         }"
       >
-        <div class="_sb_dot headdot" />
+        <div class="_sb_dot headdot pr-3" />
         {{ nodeDef.display_name }}
       </div>
       <div class="_sb_preview_badge">{{ $t('g.preview') }}</div>

src/components/sidebar/SideToolbar.vue

@@ -14,9 +14,8 @@
       />
       <div class="side-tool-bar-end">
         <SidebarLogoutIcon v-if="userStore.isMultiUserServer" />
-        <SidebarThemeToggleIcon />
         <SidebarHelpCenterIcon />
-        <SidebarSettingsToggleIcon />
+        <SidebarBottomPanelToggleButton />
       </div>
     </nav>
   </teleport>
@@ -32,6 +31,7 @@
 import { computed } from 'vue'
 
 import ExtensionSlot from '@/components/common/ExtensionSlot.vue'
+import SidebarBottomPanelToggleButton from '@/components/sidebar/SidebarBottomPanelToggleButton.vue'
 import { useKeybindingStore } from '@/stores/keybindingStore'
 import { useSettingStore } from '@/stores/settingStore'
 import { useUserStore } from '@/stores/userStore'
@@ -41,8 +41,6 @@ import type { SidebarTabExtension } from '@/types/extensionTypes'
 import SidebarHelpCenterIcon from './SidebarHelpCenterIcon.vue'
 import SidebarIcon from './SidebarIcon.vue'
 import SidebarLogoutIcon from './SidebarLogoutIcon.vue'
-import SidebarSettingsToggleIcon from './SidebarSettingsToggleIcon.vue'
-import SidebarThemeToggleIcon from './SidebarThemeToggleIcon.vue'
 
 const workspaceStore = useWorkspaceStore()
 const settingStore = useSettingStore()

src/components/sidebar/SidebarBottomPanelToggleButton.vue

@@ -0,0 +1,19 @@
+<template>
+  <SidebarIcon
+    :tooltip="$t('menu.toggleBottomPanel')"
+    :selected="bottomPanelStore.bottomPanelVisible"
+    @click="bottomPanelStore.toggleBottomPanel"
+  >
+    <template #icon>
+      <i-ph:terminal-bold />
+    </template>
+  </SidebarIcon>
+</template>
+
+<script setup lang="ts">
+import { useBottomPanelStore } from '@/stores/workspace/bottomPanelStore'
+
+import SidebarIcon from './SidebarIcon.vue'
+
+const bottomPanelStore = useBottomPanelStore()
+</script>

src/components/sidebar/SidebarIcon.vue

@@ -19,10 +19,12 @@
     @click="emit('click', $event)"
   >
     <template #icon>
-      <OverlayBadge v-if="shouldShowBadge" :value="overlayValue">
-        <i :class="icon + ' side-bar-button-icon'" />
-      </OverlayBadge>
-      <i v-else :class="icon + ' side-bar-button-icon'" />
+      <slot name="icon">
+        <OverlayBadge v-if="shouldShowBadge" :value="overlayValue">
+          <i :class="icon + ' side-bar-button-icon'" />
+        </OverlayBadge>
+        <i v-else :class="icon + ' side-bar-button-icon'" />
+      </slot>
     </template>
   </Button>
 </template>

src/components/sidebar/SidebarSettingsToggleIcon.vue

@@ -1,25 +0,0 @@
-<template>
-  <SidebarIcon
-    icon="pi pi-cog"
-    class="comfy-settings-btn"
-    :tooltip="$t('g.settings')"
-    @click="showSetting"
-  />
-</template>
-
-<script setup lang="ts">
-import SettingDialogContent from '@/components/dialog/content/SettingDialogContent.vue'
-import SettingDialogHeader from '@/components/dialog/header/SettingDialogHeader.vue'
-import { useDialogStore } from '@/stores/dialogStore'
-
-import SidebarIcon from './SidebarIcon.vue'
-
-const dialogStore = useDialogStore()
-const showSetting = () => {
-  dialogStore.showDialog({
-    key: 'global-settings',
-    headerComponent: SettingDialogHeader,
-    component: SettingDialogContent
-  })
-}
-</script>

src/components/sidebar/SidebarThemeToggleIcon.vue

@@ -1,29 +0,0 @@
-<template>
-  <SidebarIcon
-    :icon="icon"
-    :tooltip="$t('sideToolbar.themeToggle')"
-    class="comfy-vue-theme-toggle"
-    @click="toggleTheme"
-  />
-</template>
-
-<script setup lang="ts">
-import { computed } from 'vue'
-
-import { useCommandStore } from '@/stores/commandStore'
-import { useColorPaletteStore } from '@/stores/workspace/colorPaletteStore'
-
-import SidebarIcon from './SidebarIcon.vue'
-
-const colorPaletteStore = useColorPaletteStore()
-const icon = computed(() =>
-  colorPaletteStore.completedActivePalette.light_theme
-    ? 'pi pi-sun'
-    : 'pi pi-moon'
-)
-
-const commandStore = useCommandStore()
-const toggleTheme = async () => {
-  await commandStore.execute('Comfy.ToggleTheme')
-}
-</script>

src/components/topbar/BottomPanelToggleButton.vue

@@ -1,25 +0,0 @@
-<template>
-  <Button
-    v-show="bottomPanelStore.bottomPanelTabs.length > 0"
-    v-tooltip="{ value: $t('menu.toggleBottomPanel'), showDelay: 300 }"
-    severity="secondary"
-    text
-    :aria-label="$t('menu.toggleBottomPanel')"
-    @click="bottomPanelStore.toggleBottomPanel"
-  >
-    <template #icon>
-      <i-material-symbols:dock-to-bottom
-        v-if="bottomPanelStore.bottomPanelVisible"
-      />
-      <i-material-symbols:dock-to-bottom-outline v-else />
-    </template>
-  </Button>
-</template>
-
-<script setup lang="ts">
-import Button from 'primevue/button'
-
-import { useBottomPanelStore } from '@/stores/workspace/bottomPanelStore'
-
-const bottomPanelStore = useBottomPanelStore()
-</script>

src/components/topbar/CommandMenubar.vue

@@ -1,51 +1,116 @@
 <template>
-  <Menubar
-    :model="translatedItems"
-    class="top-menubar border-none p-0 bg-transparent"
-    :pt="{
-      rootList: 'gap-0 flex-nowrap w-auto',
-      submenu: `dropdown-direction-${dropdownDirection}`,
-      item: 'relative'
+  <div
+    class="comfyui-logo-wrapper p-1 flex justify-center items-center cursor-pointer rounded-md mr-2"
+    :class="{
+      'comfyui-logo-menu-visible': menuRef?.visible
     }"
+    :style="{
+      minWidth: isLargeSidebar ? '4rem' : 'auto'
+    }"
+    @click="menuRef?.toggle($event)"
   >
-    <template #item="{ item, props, root }">
+    <img
+      src="/assets/images/comfy-logo-mono.svg"
+      alt="ComfyUI Logo"
+      class="comfyui-logo h-7"
+      @contextmenu="showNativeSystemMenu"
+    />
+    <i class="pi pi-angle-down ml-1 text-[10px]" />
+  </div>
+  <TieredMenu
+    ref="menuRef"
+    :model="translatedItems"
+    :popup="true"
+    class="comfy-command-menu"
+    :class="{
+      'comfy-command-menu-top': isTopMenu
+    }"
+    @show="onMenuShow"
+  >
+    <template #item="{ item, props }">
+      <div
+        v-if="item.key === 'theme'"
+        class="flex items-center gap-4 px-4 py-5"
+        @click.stop.prevent
+      >
+        {{ item.label }}
+        <SelectButton
+          :options="[darkLabel, lightLabel]"
+          :model-value="activeTheme"
+          @click.stop.prevent
+          @update:model-value="onThemeChange"
+        >
+          <template #option="{ option }">
+            <div class="flex items-center gap-2">
+              <i v-if="option === lightLabel" class="pi pi-sun" />
+              <i v-if="option === darkLabel" class="pi pi-moon" />
+              <span>{{ option }}</span>
+            </div>
+          </template>
+        </SelectButton>
+      </div>
       <a
-        class="p-menubar-item-link"
+        v-else
+        class="p-menubar-item-link px-4 py-2"
         v-bind="props.action"
         :href="item.url"
         target="_blank"
       >
         <span v-if="item.icon" class="p-menubar-item-icon" :class="item.icon" />
-        <span class="p-menubar-item-label">{{ item.label }}</span>
+        <span class="p-menubar-item-label text-nowrap">{{ item.label }}</span>
         <span
           v-if="item?.comfyCommand?.keybinding"
           class="ml-auto border border-surface rounded text-muted text-xs text-nowrap p-1 keybinding-tag"
         >
           {{ item.comfyCommand.keybinding.combo.toString() }}
         </span>
-        <i v-if="!root && item.items" class="ml-auto pi pi-angle-right" />
+        <i v-if="item.items" class="ml-auto pi pi-angle-right" />
       </a>
     </template>
-  </Menubar>
+  </TieredMenu>
+
+  <SubgraphBreadcrumb />
 </template>
 
 <script setup lang="ts">
-import Menubar from 'primevue/menubar'
 import type { MenuItem } from 'primevue/menuitem'
-import { computed } from 'vue'
+import SelectButton from 'primevue/selectbutton'
+import TieredMenu, {
+  type TieredMenuMethods,
+  type TieredMenuState
+} from 'primevue/tieredmenu'
+import { computed, nextTick, ref } from 'vue'
 import { useI18n } from 'vue-i18n'
 
+import SubgraphBreadcrumb from '@/components/breadcrumb/SubgraphBreadcrumb.vue'
+import SettingDialogContent from '@/components/dialog/content/SettingDialogContent.vue'
+import SettingDialogHeader from '@/components/dialog/header/SettingDialogHeader.vue'
+import { useDialogService } from '@/services/dialogService'
+import { useAboutPanelStore } from '@/stores/aboutPanelStore'
+import { useCommandStore } from '@/stores/commandStore'
+import { useDialogStore } from '@/stores/dialogStore'
 import { useMenuItemStore } from '@/stores/menuItemStore'
 import { useSettingStore } from '@/stores/settingStore'
+import { useColorPaletteStore } from '@/stores/workspace/colorPaletteStore'
+import { showNativeSystemMenu } from '@/utils/envUtil'
 import { normalizeI18nKey } from '@/utils/formatUtil'
 
-const settingStore = useSettingStore()
-const dropdownDirection = computed(() =>
-  settingStore.get('Comfy.UseNewMenu') === 'Top' ? 'down' : 'up'
-)
-
+const colorPaletteStore = useColorPaletteStore()
 const menuItemsStore = useMenuItemStore()
+const commandStore = useCommandStore()
+const dialogStore = useDialogStore()
+const aboutPanelStore = useAboutPanelStore()
+const settingStore = useSettingStore()
 const { t } = useI18n()
+
+const menuRef = ref<
+  ({ dirty: boolean } & TieredMenuMethods & TieredMenuState) | null
+>(null)
+const isLargeSidebar = computed(
+  () => settingStore.get('Comfy.Sidebar.Size') !== 'small'
+)
+const isTopMenu = computed(() => settingStore.get('Comfy.UseNewMenu') === 'Top')
+
 const translateMenuItem = (item: MenuItem): MenuItem => {
   const label = typeof item.label === 'function' ? item.label() : item.label
   const translatedLabel = label
@@ -59,9 +124,119 @@ const translateMenuItem = (item: MenuItem): MenuItem => {
   }
 }
 
-const translatedItems = computed(() =>
-  menuItemsStore.menuItems.map(translateMenuItem)
-)
+const showSettings = (defaultPanel?: string) => {
+  dialogStore.showDialog({
+    key: 'global-settings',
+    headerComponent: SettingDialogHeader,
+    component: SettingDialogContent,
+    props: {
+      defaultPanel
+    }
+  })
+}
+
+// Temporary duplicated from LoadWorkflowWarning.vue
+// Determines if ComfyUI-Manager is installed by checking for its badge in the about panel
+// This allows us to conditionally show the Manager button only when the extension is available
+// TODO: Remove this check when Manager functionality is fully migrated into core
+const isManagerInstalled = computed(() => {
+  return aboutPanelStore.badges.some(
+    (badge) =>
+      badge.label.includes('ComfyUI-Manager') ||
+      badge.url.includes('ComfyUI-Manager')
+  )
+})
+
+const showManageExtensions = () => {
+  if (isManagerInstalled.value) {
+    useDialogService().showManagerDialog()
+  } else {
+    showSettings('extension')
+  }
+}
+
+const extraMenuItems: MenuItem[] = [
+  { separator: true },
+  {
+    key: 'theme',
+    label: t('menu.theme')
+  },
+  { separator: true },
+  {
+    key: 'manage-extensions',
+    label: t('menu.manageExtensions'),
+    icon: 'mdi mdi-puzzle-outline',
+    command: showManageExtensions
+  },
+  {
+    key: 'settings',
+    label: t('g.settings'),
+    icon: 'mdi mdi-cog-outline',
+    command: () => showSettings()
+  }
+]
+
+const lightLabel = t('menu.light')
+const darkLabel = t('menu.dark')
+
+const activeTheme = computed(() => {
+  return colorPaletteStore.completedActivePalette.light_theme
+    ? lightLabel
+    : darkLabel
+})
+
+const onThemeChange = async () => {
+  await commandStore.execute('Comfy.ToggleTheme')
+}
+
+const translatedItems = computed(() => {
+  const items = menuItemsStore.menuItems.map(translateMenuItem)
+  let helpIndex = items.findIndex((item) => item.key === 'Help')
+  let helpItem: MenuItem | undefined
+
+  if (helpIndex !== -1) {
+    items[helpIndex].icon = 'mdi mdi-help-circle-outline'
+    // If help is not the last item (i.e. we have extension commands), separate them
+    const isLastItem = helpIndex !== items.length - 1
+    helpItem = items.splice(
+      helpIndex,
+      1,
+      ...(isLastItem
+        ? [
+            {
+              separator: true
+            }
+          ]
+        : [])
+    )[0]
+  }
+  helpIndex = items.length
+
+  items.splice(
+    helpIndex,
+    0,
+    ...extraMenuItems,
+    ...(helpItem
+      ? [
+          {
+            separator: true
+          },
+          helpItem
+        ]
+      : [])
+  )
+
+  return items
+})
+
+const onMenuShow = () => {
+  void nextTick(() => {
+    // Force the menu to show submenus on hover
+    if (menuRef.value) {
+      menuRef.value.dirty = true
+    }
+  })
+}
 </script>
 
 <style scoped>
@@ -74,4 +249,20 @@ const translatedItems = computed(() =>
   border-color: var(--p-content-border-color);
   border-style: solid;
 }
+
+.comfyui-logo-menu-visible,
+.comfyui-logo-wrapper:hover {
+  background-color: color-mix(in srgb, var(--fg-color) 10%, transparent);
+}
+</style>
+
+<style>
+.comfy-command-menu ul {
+  background-color: var(--comfy-menu-secondary-bg) !important;
+}
+
+.comfy-command-menu-top .p-tieredmenu-submenu {
+  left: calc(100% + 15px) !important;
+  top: -4px !important;
+}
 </style>

src/components/topbar/TopMenubar.vue

@@ -1,82 +1,66 @@
 <template>
-  <div
-    v-show="showTopMenu"
-    ref="topMenuRef"
-    class="comfyui-menu flex items-center"
-    :class="{ dropzone: isDropZone, 'dropzone-active': isDroppable }"
-  >
-    <img
-      src="/assets/images/comfy-logo-mono.svg"
-      alt="ComfyUI Logo"
-      class="comfyui-logo ml-2 app-drag h-6"
-    />
-    <CommandMenubar />
-    <div class="flex-grow min-w-0 app-drag h-full">
-      <WorkflowTabs v-if="workflowTabsPosition === 'Topbar'" />
-    </div>
-    <div ref="menuRight" class="comfyui-menu-right flex-shrink-0" />
-    <Actionbar />
-    <CurrentUserButton class="flex-shrink-0" />
-    <BottomPanelToggleButton class="flex-shrink-0" />
-    <Button
-      v-tooltip="{ value: $t('menu.hideMenu'), showDelay: 300 }"
-      class="flex-shrink-0"
-      icon="pi pi-bars"
-      severity="secondary"
-      text
-      :aria-label="$t('menu.hideMenu')"
-      @click="workspaceState.focusMode = true"
-      @contextmenu="showNativeSystemMenu"
-    />
+  <div>
     <div
-      v-show="menuSetting !== 'Bottom'"
-      class="window-actions-spacer flex-shrink-0"
+      v-show="showTopMenu && workflowTabsPosition === 'Topbar'"
+      class="w-full flex content-end z-[1001] h-[38px]"
+      style="background: var(--border-color)"
+    >
+      <WorkflowTabs />
+    </div>
+    <div
+      v-show="showTopMenu"
+      ref="topMenuRef"
+      class="comfyui-menu flex items-center"
+      :class="{ dropzone: isDropZone, 'dropzone-active': isDroppable }"
+    >
+      <CommandMenubar />
+      <div class="flex-grow min-w-0 app-drag h-full"></div>
+      <div
+        ref="menuRight"
+        class="comfyui-menu-right flex-shrink-1 overflow-auto"
+      />
+      <Actionbar />
+      <CurrentUserButton class="flex-shrink-0" />
+    </div>
+
+    <!-- Virtual top menu for native window (drag handle) -->
+    <div
+      v-show="isNativeWindow() && !showTopMenu"
+      class="fixed top-0 left-0 app-drag w-full h-[var(--comfy-topbar-height)]"
     />
   </div>
-
-  <!-- Virtual top menu for native window (drag handle) -->
-  <div
-    v-show="isNativeWindow() && !showTopMenu"
-    class="fixed top-0 left-0 app-drag w-full h-[var(--comfy-topbar-height)]"
-  />
 </template>
 
 <script setup lang="ts">
 import { useEventBus } from '@vueuse/core'
-import Button from 'primevue/button'
 import { computed, onMounted, provide, ref } from 'vue'
 
 import Actionbar from '@/components/actionbar/ComfyActionbar.vue'
-import BottomPanelToggleButton from '@/components/topbar/BottomPanelToggleButton.vue'
 import CommandMenubar from '@/components/topbar/CommandMenubar.vue'
 import CurrentUserButton from '@/components/topbar/CurrentUserButton.vue'
 import WorkflowTabs from '@/components/topbar/WorkflowTabs.vue'
 import { app } from '@/scripts/app'
 import { useSettingStore } from '@/stores/settingStore'
 import { useWorkspaceStore } from '@/stores/workspaceStore'
-import {
-  electronAPI,
-  isElectron,
-  isNativeWindow,
-  showNativeSystemMenu
-} from '@/utils/envUtil'
+import { electronAPI, isElectron, isNativeWindow } from '@/utils/envUtil'
 
 const workspaceState = useWorkspaceStore()
 const settingStore = useSettingStore()
 
-const workflowTabsPosition = computed(() =>
-  settingStore.get('Comfy.Workflow.WorkflowTabsPosition')
-)
 const menuSetting = computed(() => settingStore.get('Comfy.UseNewMenu'))
 const betaMenuEnabled = computed(() => menuSetting.value !== 'Disabled')
 const showTopMenu = computed(
   () => betaMenuEnabled.value && !workspaceState.focusMode
 )
+const workflowTabsPosition = computed(() =>
+  settingStore.get('Comfy.Workflow.WorkflowTabsPosition')
+)
 
 const menuRight = ref<HTMLDivElement | null>(null)
 // Menu-right holds legacy topbar elements attached by custom scripts
 onMounted(() => {
   if (menuRight.value) {
+    app.menu.element.style.width = 'fit-content'
     menuRight.value.appendChild(app.menu.element)
   }
 })
@@ -138,4 +122,35 @@ onMounted(() => {
 .dark-theme .comfyui-logo {
   filter: invert(1);
 }
+
+.comfyui-menu-button-hide {
+  background-color: var(--comfy-menu-secondary-bg);
+  border-left: 1px solid var(--border-color);
+}
+</style>
+
+<style>
+.comfyui-menu-right::-webkit-scrollbar {
+  max-height: 5px;
+}
+
+.comfyui-menu-right:hover::-webkit-scrollbar {
+  cursor: grab;
+}
+
+.comfyui-menu-right::-webkit-scrollbar-track {
+  background: color-mix(in srgb, var(--border-color) 60%, transparent);
+}
+
+.comfyui-menu-right:hover::-webkit-scrollbar-track {
+  background: color-mix(in srgb, var(--border-color) 80%, transparent);
+}
+
+.comfyui-menu-right::-webkit-scrollbar-thumb {
+  background: color-mix(in srgb, var(--fg-color) 30%, transparent);
+}
+
+.comfyui-menu-right::-webkit-scrollbar-thumb:hover {
+  background: color-mix(in srgb, var(--fg-color) 80%, transparent);
+}
 </style>

src/components/topbar/WorkflowTab.vue

@@ -1,8 +1,12 @@
 <template>
   <div ref="workflowTabRef" class="flex p-2 gap-2 workflow-tab" v-bind="$attrs">
     <span
-      v-tooltip.bottom="workflowOption.workflow.key"
-      class="workflow-label text-sm max-w-[150px] truncate inline-block"
+      v-tooltip.bottom="{
+        value: workflowOption.workflow.key,
+        class: 'workflow-tab-tooltip',
+        showDelay: 512
+      }"
+      class="workflow-label text-sm max-w-[150px] min-w-[30px] truncate inline-block"
     >
       {{ workflowOption.workflow.filename }}
     </span>
@@ -142,3 +146,9 @@ usePragmaticDroppable(tabGetter, {
   transform: translate(-50%, -50%);
 }
 </style>
+
+<style>
+.p-tooltip.workflow-tab-tooltip {
+  z-index: 1200 !important;
+}
+</style>

src/components/topbar/WorkflowTabs.vue

@@ -1,5 +1,17 @@
 <template>
-  <div class="workflow-tabs-container flex flex-row max-w-full h-full">
+  <div
+    class="workflow-tabs-container flex flex-row max-w-full h-full flex-auto overflow-hidden"
+    :class="{ 'workflow-tabs-container-desktop': isDesktop }"
+  >
+    <Button
+      v-if="showOverflowArrows"
+      icon="pi pi-chevron-left"
+      text
+      severity="secondary"
+      class="overflow-arrow overflow-arrow-left"
+      :disabled="!leftArrowEnabled"
+      @mousedown="whileMouseDown($event, () => scroll(-1))"
+    />
     <ScrollPanel
       ref="scrollPanelRef"
       class="overflow-hidden no-drag"
@@ -27,9 +39,18 @@
         </template>
       </SelectButton>
     </ScrollPanel>
+    <Button
+      v-if="showOverflowArrows"
+      icon="pi pi-chevron-right"
+      text
+      severity="secondary"
+      class="overflow-arrow overflow-arrow-right"
+      :disabled="!rightArrowEnabled"
+      @mousedown="whileMouseDown($event, () => scroll(1))"
+    />
     <Button
       v-tooltip="{ value: $t('sideToolbar.newBlankWorkflow'), showDelay: 300 }"
-      class="new-blank-workflow-button flex-shrink-0 no-drag"
+      class="new-blank-workflow-button flex-shrink-0 no-drag rounded-none"
       icon="pi pi-plus"
       text
       severity="secondary"
@@ -37,23 +58,32 @@
       @click="() => commandStore.execute('Comfy.NewBlankWorkflow')"
     />
     <ContextMenu ref="menu" :model="contextMenuItems" />
+    <div
+      v-if="menuSetting !== 'Bottom' && isDesktop"
+      class="window-actions-spacer flex-shrink-0 app-drag"
+    />
   </div>
 </template>
 
 <script setup lang="ts">
+import { useScroll } from '@vueuse/core'
 import Button from 'primevue/button'
 import ContextMenu from 'primevue/contextmenu'
 import ScrollPanel from 'primevue/scrollpanel'
 import SelectButton from 'primevue/selectbutton'
-import { computed, nextTick, ref, watch } from 'vue'
+import { computed, nextTick, onUpdated, ref, watch } from 'vue'
 import { useI18n } from 'vue-i18n'
 
 import WorkflowTab from '@/components/topbar/WorkflowTab.vue'
+import { useOverflowObserver } from '@/composables/element/useOverflowObserver'
 import { useWorkflowService } from '@/services/workflowService'
 import { useCommandStore } from '@/stores/commandStore'
+import { useSettingStore } from '@/stores/settingStore'
 import { ComfyWorkflow, useWorkflowBookmarkStore } from '@/stores/workflowStore'
 import { useWorkflowStore } from '@/stores/workflowStore'
 import { useWorkspaceStore } from '@/stores/workspaceStore'
+import { isElectron } from '@/utils/envUtil'
+import { whileMouseDown } from '@/utils/mouseDownUtil'
 
 interface WorkflowOption {
   value: string
@@ -67,11 +97,19 @@ const props = defineProps<{
 const { t } = useI18n()
 const workspaceStore = useWorkspaceStore()
 const workflowStore = useWorkflowStore()
-const workflowService = useWorkflowService()
 const workflowBookmarkStore = useWorkflowBookmarkStore()
+const settingStore = useSettingStore()
+const workflowService = useWorkflowService()
+
 const rightClickedTab = ref<WorkflowOption | undefined>()
 const menu = ref()
 const scrollPanelRef = ref()
+const showOverflowArrows = ref(false)
+const leftArrowEnabled = ref(false)
+const rightArrowEnabled = ref(false)
+
+const isDesktop = isElectron()
+const menuSetting = computed(() => settingStore.get('Comfy.UseNewMenu'))
 
 const workflowToOption = (workflow: ComfyWorkflow): WorkflowOption => ({
   value: workflow.path,
@@ -86,6 +124,7 @@ const selectedWorkflow = computed<WorkflowOption | null>(() =>
     ? workflowToOption(workflowStore.activeWorkflow as ComfyWorkflow)
     : null
 )
+
 const onWorkflowChange = async (option: WorkflowOption) => {
   // Prevent unselecting the current workflow
   if (!option) {
@@ -178,6 +217,13 @@ const handleWheel = (event: WheelEvent) => {
   })
 }
 
+const scroll = (direction: number) => {
+  const scrollElement = scrollPanelRef.value.$el.querySelector(
+    '.p-scrollpanel-content'
+  ) as HTMLElement
+  scrollElement.scrollBy({ left: direction * 20 })
+}
+
 // Scroll to active offscreen tab when opened
 watch(
   () => workflowStore.activeWorkflow,
@@ -208,12 +254,71 @@ watch(
   },
   { immediate: true }
 )
+
+const scrollContent = computed(
+  () =>
+    scrollPanelRef.value?.$el.querySelector(
+      '.p-scrollpanel-content'
+    ) as HTMLElement
+)
+let overflowObserver: ReturnType<typeof useOverflowObserver> | null = null
+let overflowWatch: ReturnType<typeof watch> | null = null
+watch(scrollContent, (value) => {
+  const scrollState = useScroll(value)
+
+  watch(scrollState.arrivedState, () => {
+    leftArrowEnabled.value = !scrollState.arrivedState.left
+    rightArrowEnabled.value = !scrollState.arrivedState.right
+  })
+
+  overflowObserver?.dispose()
+  overflowWatch?.stop()
+  overflowObserver = useOverflowObserver(value)
+  overflowWatch = watch(
+    overflowObserver.isOverflowing,
+    (value) => {
+      showOverflowArrows.value = value
+      void nextTick(() => {
+        // Force a new check after arrows are updated
+        scrollState.measure()
+      })
+    },
+    { immediate: true }
+  )
+})
+
+onUpdated(() => {
+  if (!overflowObserver?.disposed.value) {
+    overflowObserver?.checkOverflow()
+  }
+})
 </script>
 
 <style scoped>
+.workflow-tabs-container {
+  background-color: var(--comfy-menu-secondary-bg);
+}
+
 :deep(.p-togglebutton) {
-  @apply p-0 bg-transparent rounded-none flex-shrink-0 relative border-0 border-r border-solid;
+  @apply p-0 bg-transparent rounded-none flex-shrink relative border-0 border-r border-solid;
   border-right-color: var(--border-color);
+  min-width: 90px;
+}
+
+.overflow-arrow {
+  @apply px-2 rounded-none;
+}
+
+.overflow-arrow[disabled] {
+  @apply opacity-25;
+}
+
+:deep(.p-togglebutton > .p-togglebutton-content) {
+  @apply max-w-full;
+}
+
+:deep(.workflow-tab) {
+  @apply max-w-full;
 }
 
 :deep(.p-togglebutton::before) {
@@ -255,6 +360,10 @@ watch(
   @apply h-full;
 }
 
+:deep(.workflow-tabs) {
+  display: flex;
+}
+
 /* Scrollbar half opacity to avoid blocking the active tab bottom border */
 :deep(.p-scrollpanel:hover .p-scrollpanel-bar),
 :deep(.p-scrollpanel:active .p-scrollpanel-bar) {
@@ -264,4 +373,15 @@ watch(
 :deep(.p-selectbutton) {
   @apply rounded-none h-full;
 }
+
+.workflow-tabs-container-desktop {
+  max-width: env(titlebar-area-width, 100vw);
+}
+
+.window-actions-spacer {
+  @apply flex-auto;
+  /* If we are using custom titlebar, then we need to add a gap for the user to drag the window */
+  --window-actions-spacer-width: min(75px, env(titlebar-area-width, 0) * 9999);
+  min-width: var(--window-actions-spacer-width);
+}
 </style>

src/composables/element/useAbsolutePosition.ts

@@ -1,8 +1,9 @@
 import type { Size, Vector2 } from '@comfyorg/litegraph'
-import { CSSProperties, ref } from 'vue'
+import { CSSProperties, ref, watch } from 'vue'
 
 import { useCanvasPositionConversion } from '@/composables/element/useCanvasPositionConversion'
 import { useCanvasStore } from '@/stores/graphStore'
+import { useSettingStore } from '@/stores/settingStore'
 
 export interface PositionConfig {
   /* The position of the element on litegraph canvas */
@@ -18,9 +19,18 @@ export function useAbsolutePosition(options: { useTransform?: boolean } = {}) {
 
   const canvasStore = useCanvasStore()
   const lgCanvas = canvasStore.getCanvas()
-  const { canvasPosToClientPos } = useCanvasPositionConversion(
-    lgCanvas.canvas,
-    lgCanvas
+  const { canvasPosToClientPos, update: updateCanvasPosition } =
+    useCanvasPositionConversion(lgCanvas.canvas, lgCanvas)
+
+  const settingStore = useSettingStore()
+  watch(
+    [
+      () => settingStore.get('Comfy.Sidebar.Location'),
+      () => settingStore.get('Comfy.Sidebar.Size'),
+      () => settingStore.get('Comfy.UseNewMenu')
+    ],
+    () => updateCanvasPosition(),
+    { flush: 'post' }
   )
 
   /**

src/composables/element/useCanvasPositionConversion.ts

@@ -11,7 +11,7 @@ export const useCanvasPositionConversion = (
   canvasElement: Parameters<typeof useElementBounding>[0],
   lgCanvas: LGraphCanvas
 ) => {
-  const { left, top } = useElementBounding(canvasElement)
+  const { left, top, update } = useElementBounding(canvasElement)
 
   const clientPosToCanvasPos = (pos: Vector2): Vector2 => {
     const { offset, scale } = lgCanvas.ds
@@ -31,6 +31,7 @@ export const useCanvasPositionConversion = (
 
   return {
     clientPosToCanvasPos,
-    canvasPosToClientPos
+    canvasPosToClientPos,
+    update
   }
 }

src/composables/element/useOverflowObserver.ts

@@ -0,0 +1,64 @@
+import { useMutationObserver, useResizeObserver } from '@vueuse/core'
+import { debounce } from 'lodash'
+import { readonly, ref } from 'vue'
+
+/**
+ * Observes an element for overflow changes and optionally debounces the check
+ * @param element - The element to observe
+ * @param options - The options for the observer
+ * @param options.debounceTime - The time to debounce the check in milliseconds
+ * @param options.useMutationObserver - Whether to use a mutation observer to check for overflow
+ * @param options.useResizeObserver - Whether to use a resize observer to check for overflow
+ * @returns An object containing the isOverflowing state and the checkOverflow function to manually trigger
+ */
+export const useOverflowObserver = (
+  element: HTMLElement,
+  options?: {
+    debounceTime?: number
+    useMutationObserver?: boolean
+    useResizeObserver?: boolean
+    onCheck?: (isOverflowing: boolean) => void
+  }
+) => {
+  options = {
+    debounceTime: 25,
+    useMutationObserver: true,
+    useResizeObserver: true,
+    ...options
+  }
+
+  const isOverflowing = ref(false)
+  const disposeFns: (() => void)[] = []
+  const disposed = ref(false)
+
+  const checkOverflowFn = () => {
+    isOverflowing.value = element.scrollWidth > element.clientWidth
+    options.onCheck?.(isOverflowing.value)
+  }
+
+  const checkOverflow = options.debounceTime
+    ? debounce(checkOverflowFn, options.debounceTime)
+    : checkOverflowFn
+
+  if (options.useMutationObserver) {
+    disposeFns.push(
+      useMutationObserver(element, checkOverflow, {
+        subtree: true,
+        childList: true
+      }).stop
+    )
+  }
+  if (options.useResizeObserver) {
+    disposeFns.push(useResizeObserver(element, checkOverflow).stop)
+  }
+
+  return {
+    isOverflowing: readonly(isOverflowing),
+    disposed: readonly(disposed),
+    checkOverflow,
+    dispose: () => {
+      disposed.value = true
+      disposeFns.forEach((fn) => fn())
+    }
+  }
+}

src/composables/graph/useCanvasInteractions.ts

@@ -0,0 +1,59 @@
+import { computed } from 'vue'
+
+import { app } from '@/scripts/app'
+import { useSettingStore } from '@/stores/settingStore'
+
+/**
+ * Composable for handling canvas interactions from Vue components.
+ * This provides a unified way to forward events to the LiteGraph canvas
+ * and will be the foundation for migrating canvas interactions to Vue.
+ */
+export function useCanvasInteractions() {
+  const settingStore = useSettingStore()
+
+  const isStandardNavMode = computed(
+    () => settingStore.get('Comfy.Canvas.NavigationMode') === 'standard'
+  )
+
+  /**
+   * Handles wheel events from UI components that should be forwarded to canvas
+   * when appropriate (e.g., Ctrl+wheel for zoom in standard mode)
+   */
+  const handleWheel = (event: WheelEvent) => {
+    // In standard mode, Ctrl+wheel should go to canvas for zoom
+    if (isStandardNavMode.value && (event.ctrlKey || event.metaKey)) {
+      event.preventDefault() // Prevent browser zoom
+      forwardEventToCanvas(event)
+      return
+    }
+
+    // In legacy mode, all wheel events go to canvas for zoom
+    if (!isStandardNavMode.value) {
+      event.preventDefault()
+      forwardEventToCanvas(event)
+      return
+    }
+
+    // Otherwise, let the component handle it normally
+  }
+
+  /**
+   * Forwards an event to the LiteGraph canvas
+   */
+  const forwardEventToCanvas = (
+    event: WheelEvent | PointerEvent | MouseEvent
+  ) => {
+    const canvasEl = app.canvas?.canvas
+    if (!canvasEl) return
+
+    // Create new event with same properties
+    const EventConstructor = event.constructor as typeof WheelEvent
+    const newEvent = new EventConstructor(event.type, event)
+    canvasEl.dispatchEvent(newEvent)
+  }
+
+  return {
+    handleWheel,
+    forwardEventToCanvas
+  }
+}

src/composables/useCoreCommands.ts

@@ -153,7 +153,7 @@ export function useCoreCommands(): ComfyCommand[] {
       function: () => {
         const settingStore = useSettingStore()
         if (
-          !settingStore.get('Comfy.ComfirmClear') ||
+          !settingStore.get('Comfy.ConfirmClear') ||
           confirm('Clear workflow?')
         ) {
           app.clean()

src/composables/useFrontendVersionMismatchWarning.ts

@@ -0,0 +1,94 @@
+import { whenever } from '@vueuse/core'
+import { computed, onMounted } from 'vue'
+import { useI18n } from 'vue-i18n'
+
+import { useToastStore } from '@/stores/toastStore'
+import { useVersionCompatibilityStore } from '@/stores/versionCompatibilityStore'
+
+export interface UseFrontendVersionMismatchWarningOptions {
+  immediate?: boolean
+}
+
+/**
+ * Composable for handling frontend version mismatch warnings.
+ *
+ * Displays toast notifications when the frontend version is incompatible with the backend,
+ * either because the frontend is outdated or newer than the backend expects.
+ * Automatically dismisses warnings when shown and persists dismissal state for 7 days.
+ *
+ * @param options - Configuration options
+ * @param options.immediate - If true, automatically shows warning when version mismatch is detected
+ * @returns Object with methods and computed properties for managing version warnings
+ *
+ * @example
+ * ```ts
+ * // Show warning immediately when mismatch detected
+ * const { showWarning, shouldShowWarning } = useFrontendVersionMismatchWarning({ immediate: true })
+ *
+ * // Manual control
+ * const { showWarning } = useFrontendVersionMismatchWarning()
+ * showWarning() // Call when needed
+ * ```
+ */
+export function useFrontendVersionMismatchWarning(
+  options: UseFrontendVersionMismatchWarningOptions = {}
+) {
+  const { immediate = false } = options
+  const { t } = useI18n()
+  const toastStore = useToastStore()
+  const versionCompatibilityStore = useVersionCompatibilityStore()
+
+  // Track if we've already shown the warning
+  let hasShownWarning = false
+
+  const showWarning = () => {
+    // Prevent showing the warning multiple times
+    if (hasShownWarning) return
+
+    const message = versionCompatibilityStore.warningMessage
+    if (!message) return
+
+    const detailMessage = t('g.frontendOutdated', {
+      frontendVersion: message.frontendVersion,
+      requiredVersion: message.requiredVersion
+    })
+
+    const fullMessage = t('g.versionMismatchWarningMessage', {
+      warning: t('g.versionMismatchWarning'),
+      detail: detailMessage
+    })
+
+    toastStore.addAlert(fullMessage)
+    hasShownWarning = true
+
+    // Automatically dismiss the warning so it won't show again for 7 days
+    versionCompatibilityStore.dismissWarning()
+  }
+
+  onMounted(() => {
+    // Only set up the watcher if immediate is true
+    if (immediate) {
+      whenever(
+        () => versionCompatibilityStore.shouldShowWarning,
+        () => {
+          showWarning()
+        },
+        {
+          immediate: true,
+          once: true
+        }
+      )
+    }
+  })
+
+  return {
+    showWarning,
+    shouldShowWarning: computed(
+      () => versionCompatibilityStore.shouldShowWarning
+    ),
+    dismissWarning: versionCompatibilityStore.dismissWarning,
+    hasVersionMismatch: computed(
+      () => versionCompatibilityStore.hasVersionMismatch
+    )
+  }
+}

src/composables/useLitegraphSettings.ts

@@ -124,9 +124,12 @@ export const useLitegraphSettings = () => {
   })
 
   watchEffect(() => {
-    LiteGraph.macTrackpadGestures = settingStore.get(
-      'LiteGraph.Pointer.TrackpadGestures'
-    )
+    const navigationMode = settingStore.get('Comfy.Canvas.NavigationMode') as
+      | 'standard'
+      | 'legacy'
+
+    LiteGraph.canvasNavigationMode = navigationMode
+    LiteGraph.macTrackpadGestures = navigationMode === 'standard'
   })
 
   watchEffect(() => {

src/composables/useMinimap.ts

@@ -8,6 +8,7 @@ import { api } from '@/scripts/api'
 import { app } from '@/scripts/app'
 import { useCanvasStore } from '@/stores/graphStore'
 import { useSettingStore } from '@/stores/settingStore'
+import { useColorPaletteStore } from '@/stores/workspace/colorPaletteStore'
 
 interface GraphCallbacks {
   onNodeAdded?: (node: LGraphNode) => void
@@ -18,6 +19,7 @@ interface GraphCallbacks {
 export function useMinimap() {
   const settingStore = useSettingStore()
   const canvasStore = useCanvasStore()
+  const colorPaletteStore = useColorPaletteStore()
 
   const containerRef = ref<HTMLDivElement>()
   const canvasRef = ref<HTMLCanvasElement>()
@@ -53,12 +55,18 @@ export function useMinimap() {
 
   const width = 250
   const height = 200
-  const nodeColor = '#0B8CE999'
-  const linkColor = '#F99614'
-  const slotColor = '#F99614'
-  const viewportColor = '#FFF'
-  const backgroundColor = '#15161C'
-  const borderColor = '#333'
+
+  // Theme-aware colors for canvas drawing
+  const isLightTheme = computed(
+    () => colorPaletteStore.completedActivePalette.light_theme
+  )
+  const nodeColor = computed(
+    () => (isLightTheme.value ? '#3DA8E099' : '#0B8CE999') // lighter blue for light theme
+  )
+  const linkColor = computed(
+    () => (isLightTheme.value ? '#FFB347' : '#F99614') // lighter orange for light theme
+  )
+  const slotColor = computed(() => linkColor.value)
 
   const containerRect = ref({
     left: 0,
@@ -103,8 +111,8 @@ export function useMinimap() {
   const containerStyles = computed(() => ({
     width: `${width}px`,
     height: `${height}px`,
-    backgroundColor: backgroundColor,
-    border: `1px solid ${borderColor}`,
+    backgroundColor: isLightTheme.value ? '#FAF9F5' : '#15161C',
+    border: `1px solid ${isLightTheme.value ? '#ccc' : '#333'}`,
     borderRadius: '8px'
   }))
 
@@ -112,8 +120,8 @@ export function useMinimap() {
     transform: `translate(${viewportTransform.value.x}px, ${viewportTransform.value.y}px)`,
     width: `${viewportTransform.value.width}px`,
     height: `${viewportTransform.value.height}px`,
-    border: `2px solid ${viewportColor}`,
-    backgroundColor: `${viewportColor}33`,
+    border: `2px solid ${isLightTheme.value ? '#E0E0E0' : '#FFF'}`,
+    backgroundColor: `#FFF33`,
     willChange: 'transform',
     backfaceVisibility: 'hidden' as const,
     perspective: '1000px',
@@ -196,7 +204,7 @@ export function useMinimap() {
       const h = node.size[1] * scale.value
 
       // Render solid node blocks
-      ctx.fillStyle = nodeColor
+      ctx.fillStyle = nodeColor.value
       ctx.fillRect(x, y, w, h)
     }
   }
@@ -209,7 +217,7 @@ export function useMinimap() {
     const g = graph.value
     if (!g) return
 
-    ctx.strokeStyle = linkColor
+    ctx.strokeStyle = linkColor.value
     ctx.lineWidth = 1.4
 
     const slotRadius = 3.7 * Math.max(scale.value, 0.5) // Larger slots that scale
@@ -258,7 +266,7 @@ export function useMinimap() {
     }
 
     // Render connection slots on top
-    ctx.fillStyle = slotColor
+    ctx.fillStyle = slotColor.value
     for (const conn of connections) {
       // Output slot
       ctx.beginPath()

src/composables/widgets/useStringWidget.ts

@@ -8,6 +8,8 @@ import { app } from '@/scripts/app'
 import { type ComfyWidgetConstructorV2 } from '@/scripts/widgets'
 import { useSettingStore } from '@/stores/settingStore'
 
+const TRACKPAD_DETECTION_THRESHOLD = 50
+
 function addMultilineWidget(
   node: LGraphNode,
   name: string,
@@ -54,38 +56,55 @@ function addMultilineWidget(
     }
   })
 
-  /** Timer reference. `null` when the timer completes. */
-  let ignoreEventsTimer: ReturnType<typeof setTimeout> | null = null
-  /** Total number of events ignored since the timer started. */
-  let ignoredEvents = 0
-
-  // Pass wheel events to the canvas when appropriate
   inputEl.addEventListener('wheel', (event: WheelEvent) => {
-    if (!Object.is(event.deltaX, -0)) return
+    const gesturesEnabled = useSettingStore().get(
+      'LiteGraph.Pointer.TrackpadGestures'
+    )
+    const deltaX = event.deltaX
+    const deltaY = event.deltaY
 
-    // If the textarea has focus, require more effort to activate pass-through
-    const multiplier = document.activeElement === inputEl ? 2 : 1
-    const maxScrollHeight = inputEl.scrollHeight - inputEl.clientHeight
+    const canScrollY = inputEl.scrollHeight > inputEl.clientHeight
+    const isHorizontal = Math.abs(deltaX) > Math.abs(deltaY)
 
-    if (
-      (event.deltaY < 0 && inputEl.scrollTop === 0) ||
-      (event.deltaY > 0 && inputEl.scrollTop === maxScrollHeight)
-    ) {
-      // Attempting to scroll past the end of the textarea
-      if (!ignoreEventsTimer || ignoredEvents > 25 * multiplier) {
-        app.canvas.processMouseWheel(event)
-      } else {
-        ignoredEvents++
-      }
-    } else if (event.deltaY !== 0) {
-      // Start timer whenever a successful scroll occurs
-      ignoredEvents = 0
-      if (ignoreEventsTimer) clearTimeout(ignoreEventsTimer)
-
-      ignoreEventsTimer = setTimeout(() => {
-        ignoreEventsTimer = null
-      }, 800 * multiplier)
+    // Prevent pinch zoom from zooming the page
+    if (event.ctrlKey) {
+      event.preventDefault()
+      event.stopPropagation()
+      app.canvas.processMouseWheel(event)
+      return
     }
+
+    // Detect if this is likely a trackpad gesture vs mouse wheel
+    // Trackpads usually have deltaX or smaller deltaY values (< TRACKPAD_DETECTION_THRESHOLD)
+    // Mouse wheels typically have larger discrete deltaY values (>= TRACKPAD_DETECTION_THRESHOLD)
+    const isLikelyTrackpad =
+      Math.abs(deltaX) > 0 || Math.abs(deltaY) < TRACKPAD_DETECTION_THRESHOLD
+
+    // Trackpad gestures: when enabled, trackpad panning goes to canvas
+    if (gesturesEnabled && isLikelyTrackpad) {
+      event.preventDefault()
+      event.stopPropagation()
+      app.canvas.processMouseWheel(event)
+      return
+    }
+
+    // When gestures disabled: horizontal always goes to canvas (no horizontal scroll in textarea)
+    if (isHorizontal) {
+      event.preventDefault()
+      event.stopPropagation()
+      app.canvas.processMouseWheel(event)
+      return
+    }
+
+    // Vertical scrolling when gestures disabled: let textarea scroll if scrollable
+    if (canScrollY) {
+      event.stopPropagation()
+      return
+    }
+
+    // If textarea can't scroll vertically, pass to canvas
+    event.preventDefault()
+    app.canvas.processMouseWheel(event)
   })
 
   return widget

src/constants/coreKeybindings.ts

@@ -68,12 +68,6 @@ export const CORE_KEYBINDINGS: Keybinding[] = [
     },
     commandId: 'Comfy.OpenWorkflow'
   },
-  {
-    combo: {
-      key: 'Backspace'
-    },
-    commandId: 'Comfy.ClearWorkflow'
-  },
   {
     combo: {
       key: 'g',

src/constants/coreSettings.ts

@@ -782,6 +782,21 @@ export const CORE_SETTINGS: SettingParams[] = [
     defaultValue: 0.6,
     versionAdded: '1.9.1'
   },
+  {
+    id: 'Comfy.Canvas.NavigationMode',
+    category: ['LiteGraph', 'Canvas', 'CanvasNavigationMode'],
+    name: 'Canvas Navigation Mode',
+    defaultValue: 'legacy',
+    type: 'combo',
+    options: [
+      { value: 'standard', text: 'Standard (New)' },
+      { value: 'legacy', text: 'Left-Click Pan (Legacy)' }
+    ],
+    versionAdded: '1.25.0',
+    defaultsByInstallVersion: {
+      '1.25.0': 'standard'
+    }
+  },
   {
     id: 'Comfy.Canvas.SelectionToolbox',
     category: ['LiteGraph', 'Canvas', 'SelectionToolbox'],
@@ -859,17 +874,6 @@ export const CORE_SETTINGS: SettingParams[] = [
     versionAdded: '1.20.4',
     versionModified: '1.20.5'
   },
-  {
-    id: 'LiteGraph.Pointer.TrackpadGestures',
-    category: ['LiteGraph', 'Pointer', 'Trackpad Gestures'],
-    experimental: true,
-    name: 'Enable trackpad gestures',
-    tooltip:
-      'This setting enables trackpad mode for the canvas, allowing pinch-to-zoom and panning with two fingers.',
-    type: 'boolean',
-    defaultValue: false,
-    versionAdded: '1.19.1'
-  },
   // Release data stored in settings
   {
     id: 'Comfy.Release.Version',

src/constants/supportedWorkflowFormats.ts

@@ -6,8 +6,8 @@
  * All supported image formats that can contain workflow data
  */
 export const IMAGE_WORKFLOW_FORMATS = {
-  extensions: ['.png', '.webp', '.svg'],
-  mimeTypes: ['image/png', 'image/webp', 'image/svg+xml']
+  extensions: ['.png', '.webp', '.svg', '.avif'],
+  mimeTypes: ['image/png', 'image/webp', 'image/svg+xml', 'image/avif']
 }
 
 /**

src/extensions/core/maskEditorLayerFilenames.ts

@@ -0,0 +1,29 @@
+export interface ImageLayerFilenames {
+  maskedImage: string
+  paint: string
+  paintedImage: string
+  paintedMaskedImage: string
+}
+
+const paintedMaskedImagePrefix = 'clipspace-painted-masked-'
+
+export const imageLayerFilenamesByTimestamp = (
+  timestamp: number
+): ImageLayerFilenames => ({
+  maskedImage: `clipspace-mask-${timestamp}.png`,
+  paint: `clipspace-paint-${timestamp}.png`,
+  paintedImage: `clipspace-painted-${timestamp}.png`,
+  paintedMaskedImage: `${paintedMaskedImagePrefix}${timestamp}.png`
+})
+
+export const imageLayerFilenamesIfApplicable = (
+  inputImageFilename: string
+): ImageLayerFilenames | undefined => {
+  const isPaintedMaskedImageFilename = inputImageFilename.startsWith(
+    paintedMaskedImagePrefix
+  )
+  if (!isPaintedMaskedImageFilename) return undefined
+  const suffix = inputImageFilename.slice(paintedMaskedImagePrefix.length)
+  const timestamp = parseInt(suffix.split('.')[0], 10)
+  return imageLayerFilenamesByTimestamp(timestamp)
+}

src/extensions/core/uploadAudio.ts

@@ -1,5 +1,9 @@
 import type { LGraphNode } from '@comfyorg/litegraph'
-import type { IStringWidget } from '@comfyorg/litegraph/dist/types/widgets'
+import type {
+  IBaseWidget,
+  IStringWidget
+} from '@comfyorg/litegraph/dist/types/widgets'
+import { MediaRecorder as ExtendableMediaRecorder } from 'extendable-media-recorder'
 
 import { useChainCallback } from '@/composables/functional/useChainCallback'
 import { useNodeDragAndDrop } from '@/composables/node/useNodeDragAndDrop'
@@ -9,6 +13,7 @@ import { t } from '@/i18n'
 import type { ResultItemType } from '@/schemas/apiSchema'
 import type { ComfyNodeDef } from '@/schemas/nodeDefSchema'
 import type { DOMWidget } from '@/scripts/domWidget'
+import { useAudioService } from '@/services/audioService'
 import { useToastStore } from '@/stores/toastStore'
 import { NodeLocatorId } from '@/types'
 import { getNodeByLocatorId } from '@/utils/graphTraversalUtil'
@@ -257,3 +262,167 @@ app.registerExtension({
     }
   }
 })
+
+app.registerExtension({
+  name: 'Comfy.RecordAudio',
+
+  getCustomWidgets() {
+    return {
+      AUDIO_RECORD(node, inputName: string) {
+        const audio = document.createElement('audio')
+        audio.controls = true
+        audio.classList.add('comfy-audio')
+        audio.setAttribute('name', 'media')
+
+        const audioUIWidget: DOMWidget<HTMLAudioElement, string> =
+          node.addDOMWidget(inputName, /* name=*/ 'audioUI', audio)
+
+        let mediaRecorder: MediaRecorder | null = null
+        let isRecording = false
+        let audioChunks: Blob[] = []
+        let currentStream: MediaStream | null = null
+        let recordWidget: IBaseWidget | null = null
+
+        let stopPromise: Promise<void> | null = null
+        let stopResolve: (() => void) | null = null
+
+        audioUIWidget.serializeValue = async () => {
+          if (isRecording && mediaRecorder) {
+            stopPromise = new Promise((resolve) => {
+              stopResolve = resolve
+            })
+
+            mediaRecorder.stop()
+
+            await stopPromise
+          }
+
+          const audioSrc = audioUIWidget.element.src
+
+          if (!audioSrc) {
+            useToastStore().addAlert(t('g.noAudioRecorded'))
+            return ''
+          }
+
+          const blob = await fetch(audioSrc).then((r) => r.blob())
+
+          return await useAudioService().convertBlobToFileAndSubmit(blob)
+        }
+
+        recordWidget = node.addWidget(
+          'button',
+          inputName,
+          '',
+          async () => {
+            if (!isRecording) {
+              try {
+                currentStream = await navigator.mediaDevices.getUserMedia({
+                  audio: true
+                })
+
+                mediaRecorder = new ExtendableMediaRecorder(currentStream, {
+                  mimeType: 'audio/wav'
+                }) as unknown as MediaRecorder
+
+                audioChunks = []
+
+                mediaRecorder.ondataavailable = (event) => {
+                  audioChunks.push(event.data)
+                }
+
+                mediaRecorder.onstop = async () => {
+                  const audioBlob = new Blob(audioChunks, { type: 'audio/wav' })
+
+                  useAudioService().stopAllTracks(currentStream)
+
+                  if (
+                    audioUIWidget.element.src &&
+                    audioUIWidget.element.src.startsWith('blob:')
+                  ) {
+                    URL.revokeObjectURL(audioUIWidget.element.src)
+                  }
+
+                  audioUIWidget.element.src = URL.createObjectURL(audioBlob)
+
+                  isRecording = false
+
+                  if (recordWidget) {
+                    recordWidget.label = t('g.startRecording')
+                  }
+
+                  if (stopResolve) {
+                    stopResolve()
+                    stopResolve = null
+                    stopPromise = null
+                  }
+                }
+
+                mediaRecorder.onerror = (event) => {
+                  console.error('MediaRecorder error:', event)
+                  useAudioService().stopAllTracks(currentStream)
+                  isRecording = false
+
+                  if (recordWidget) {
+                    recordWidget.label = t('g.startRecording')
+                  }
+
+                  if (stopResolve) {
+                    stopResolve()
+                    stopResolve = null
+                    stopPromise = null
+                  }
+                }
+
+                mediaRecorder.start()
+                isRecording = true
+                if (recordWidget) {
+                  recordWidget.label = t('g.stopRecording')
+                }
+              } catch (err) {
+                console.error('Error accessing microphone:', err)
+                useToastStore().addAlert(t('g.micPermissionDenied'))
+
+                if (mediaRecorder) {
+                  try {
+                    mediaRecorder.stop()
+                  } catch {}
+                }
+                useAudioService().stopAllTracks(currentStream)
+                currentStream = null
+                isRecording = false
+                if (recordWidget) {
+                  recordWidget.label = t('g.startRecording')
+                }
+              }
+            } else if (mediaRecorder && isRecording) {
+              mediaRecorder.stop()
+            }
+          },
+          { serialize: false }
+        )
+
+        recordWidget.label = t('g.startRecording')
+
+        const originalOnRemoved = node.onRemoved
+        node.onRemoved = function () {
+          if (isRecording && mediaRecorder) {
+            mediaRecorder.stop()
+          }
+          useAudioService().stopAllTracks(currentStream)
+          if (audioUIWidget.element.src?.startsWith('blob:')) {
+            URL.revokeObjectURL(audioUIWidget.element.src)
+          }
+          originalOnRemoved?.call(this)
+        }
+
+        return { widget: recordWidget }
+      }
+    }
+  },
+
+  async nodeCreated(node) {
+    if (node.constructor.comfyClass !== 'RecordAudio') return
+
+    await useAudioService().registerWavEncoder()
+  }
+})

src/locales/en/commands.json

@@ -161,6 +161,12 @@
   "Comfy_Manager_ToggleManagerProgressDialog": {
     "label": "Toggle the Custom Nodes Manager Progress Bar"
   },
+  "Comfy_MaskEditor_BrushSize_Decrease": {
+    "label": "Decrease Brush Size in MaskEditor"
+  },
+  "Comfy_MaskEditor_BrushSize_Increase": {
+    "label": "Increase Brush Size in MaskEditor"
+  },
   "Comfy_MaskEditor_OpenMaskEditor": {
     "label": "Open Mask Editor for Selected Node"
   },

src/locales/en/main.json

@@ -98,6 +98,12 @@
     "nodes": "Nodes",
     "community": "Community",
     "all": "All",
+    "versionMismatchWarning": "Version Compatibility Warning",
+    "versionMismatchWarningMessage": "{warning}: {detail} Visit https://docs.comfy.org/installation/update_comfyui#common-update-issues for update instructions.",
+    "frontendOutdated": "Frontend version {frontendVersion} is outdated. Backend requires {requiredVersion} or higher.",
+    "frontendNewer": "Frontend version {frontendVersion} may not be compatible with backend version {backendVersion}.",
+    "updateFrontend": "Update Frontend",
+    "dismiss": "Dismiss",
     "update": "Update",
     "updated": "Updated",
     "resultsCount": "Found {count} Results",
@@ -134,6 +140,10 @@
     "releaseTitle": "{package} {version} Release",
     "progressCountOf": "of",
     "keybindingAlreadyExists": "Keybinding already exists on",
+    "startRecording": "Start Recording",
+    "stopRecording": "Stop Recording",
+    "micPermissionDenied": "Microphone permission denied",
+    "noAudioRecorded": "No audio recorded",
     "nodesRunning": "nodes running"
   },
   "manager": {
@@ -420,7 +430,6 @@
     "restart": "Restart"
   },
   "sideToolbar": {
-    "themeToggle": "Toggle Theme",
     "helpCenter": "Help Center",
     "logout": "Logout",
     "queue": "Queue",
@@ -521,7 +530,13 @@
     "clipspace": "Open Clipspace",
     "resetView": "Reset canvas view",
     "clear": "Clear workflow",
-    "toggleBottomPanel": "Toggle Bottom Panel"
+    "toggleBottomPanel": "Toggle Bottom Panel",
+    "theme": "Theme",
+    "dark": "Dark",
+    "light": "Light",
+    "manageExtensions": "Manage Extensions",
+    "settings": "Settings",
+    "help": "Help"
   },
   "tabMenu": {
     "duplicateTab": "Duplicate Tab",
@@ -970,6 +985,8 @@
     "Load Default Workflow": "Load Default Workflow",
     "Toggle the Custom Nodes Manager": "Toggle the Custom Nodes Manager",
     "Toggle the Custom Nodes Manager Progress Bar": "Toggle the Custom Nodes Manager Progress Bar",
+    "Decrease Brush Size in MaskEditor": "Decrease Brush Size in MaskEditor",
+    "Increase Brush Size in MaskEditor": "Increase Brush Size in MaskEditor",
     "Open Mask Editor for Selected Node": "Open Mask Editor for Selected Node",
     "New": "New",
     "Clipspace": "Clipspace",
@@ -1340,6 +1357,13 @@
     "outdatedVersionGeneric": "Some nodes require a newer version of ComfyUI. Please update to use all nodes.",
     "coreNodesFromVersion": "Requires ComfyUI {version}:"
   },
+  "versionMismatchWarning": {
+    "title": "Version Compatibility Warning",
+    "frontendOutdated": "Frontend version {frontendVersion} is outdated. Backend requires version {requiredVersion} or higher.",
+    "frontendNewer": "Frontend version {frontendVersion} may not be compatible with backend version {backendVersion}.",
+    "updateFrontend": "Update Frontend",
+    "dismiss": "Dismiss"
+  },
   "errorDialog": {
     "defaultTitle": "An error occurred",
     "loadWorkflowTitle": "Loading aborted due to error reloading workflow data",
@@ -1597,5 +1621,11 @@
   "whatsNewPopup": {
     "learnMore": "Learn more",
     "noReleaseNotes": "No release notes available."
+  },
+  "breadcrumbsMenu": {
+    "duplicate": "Duplicate",
+    "clearWorkflow": "Clear Workflow",
+    "deleteWorkflow": "Delete Workflow",
+    "enterNewName": "Enter new name"
   }
 }

src/locales/en/settings.json

@@ -29,6 +29,13 @@
     "name": "Canvas background image",
     "tooltip": "Image URL for the canvas background. You can right-click an image in the outputs panel and select \"Set as Background\" to use it, or upload your own image using the upload button."
   },
+  "Comfy_Canvas_NavigationMode": {
+    "name": "Canvas Navigation Mode",
+    "options": {
+      "Standard (New)": "Standard (New)",
+      "Left-Click Pan (Legacy)": "Left-Click Pan (Legacy)"
+    }
+  },
   "Comfy_Canvas_SelectionToolbox": {
     "name": "Show selection toolbox"
   },
@@ -395,10 +402,6 @@
   "LiteGraph_Node_TooltipDelay": {
     "name": "Tooltip Delay"
   },
-  "LiteGraph_Pointer_TrackpadGestures": {
-    "name": "Enable trackpad gestures",
-    "tooltip": "This setting enables trackpad mode for the canvas, allowing pinch-to-zoom and panning with two fingers."
-  },
   "LiteGraph_Reroute_SplineOffset": {
     "name": "Reroute spline offset",
     "tooltip": "The bezier control point offset from the reroute centre point"

src/locales/es/commands.json

@@ -161,6 +161,12 @@
   "Comfy_Manager_ToggleManagerProgressDialog": {
     "label": "Alternar diálogo de progreso del administrador"
   },
+  "Comfy_MaskEditor_BrushSize_Decrease": {
+    "label": "Disminuir tamaño del pincel en MaskEditor"
+  },
+  "Comfy_MaskEditor_BrushSize_Increase": {
+    "label": "Aumentar tamaño del pincel en MaskEditor"
+  },
   "Comfy_MaskEditor_OpenMaskEditor": {
     "label": "Abrir editor de máscara para el nodo seleccionado"
   },

src/locales/es/main.json

@@ -82,6 +82,12 @@
       "title": "Crea una cuenta"
     }
   },
+  "breadcrumbsMenu": {
+    "clearWorkflow": "Limpiar flujo de trabajo",
+    "deleteWorkflow": "Eliminar flujo de trabajo",
+    "duplicate": "Duplicar",
+    "enterNewName": "Ingrese un nuevo nombre"
+  },
   "chatHistory": {
     "cancelEdit": "Cancelar",
     "cancelEditTooltip": "Cancelar edición",
@@ -328,12 +334,14 @@
     "loadingPanel": "Cargando panel {panel}...",
     "login": "Iniciar sesión",
     "logs": "Registros",
+    "micPermissionDenied": "Permiso de micrófono denegado",
     "migrate": "Migrar",
     "missing": "Faltante",
     "name": "Nombre",
     "newFolder": "Nueva carpeta",
     "next": "Siguiente",
     "no": "No",
+    "noAudioRecorded": "No se grabó audio",
     "noResultsFound": "No se encontraron resultados",
     "noTasksFound": "No se encontraron tareas",
     "noTasksFoundMessage": "No hay tareas en la cola.",
@@ -373,7 +381,9 @@
     "showReport": "Mostrar informe",
     "sort": "Ordenar",
     "source": "Fuente",
+    "startRecording": "Iniciar grabación",
     "status": "Estado",
+    "stopRecording": "Detener grabación",
     "success": "Éxito",
     "systemInfo": "Información del sistema",
     "terminal": "Terminal",
@@ -705,13 +715,17 @@
     "batchCountTooltip": "El número de veces que la generación del flujo de trabajo debe ser encolada",
     "clear": "Limpiar flujo de trabajo",
     "clipspace": "Abrir Clipspace",
+    "dark": "Oscuro",
     "disabled": "Deshabilitado",
     "disabledTooltip": "El flujo de trabajo no se encolará automáticamente",
     "execute": "Ejecutar",
+    "help": "Ayuda",
     "hideMenu": "Ocultar menú",
     "instant": "Instantáneo",
     "instantTooltip": "El flujo de trabajo se encolará instantáneamente después de que finalice una generación",
     "interrupt": "Cancelar ejecución actual",
+    "light": "Claro",
+    "manageExtensions": "Gestionar extensiones",
     "onChange": "Al cambiar",
     "onChangeTooltip": "El flujo de trabajo se encolará una vez que se haga un cambio",
     "refresh": "Actualizar definiciones de nodos",
@@ -719,7 +733,9 @@
     "run": "Ejecutar",
     "runWorkflow": "Ejecutar flujo de trabajo (Shift para encolar al frente)",
     "runWorkflowFront": "Ejecutar flujo de trabajo (Encolar al frente)",
+    "settings": "Configuración",
     "showMenu": "Mostrar menú",
+    "theme": "Tema",
     "toggleBottomPanel": "Alternar panel inferior"
   },
   "menuLabels": {
@@ -743,6 +759,7 @@
     "Contact Support": "Contactar soporte",
     "Convert Selection to Subgraph": "Convertir selección en subgrafo",
     "Convert selected nodes to group node": "Convertir nodos seleccionados en nodo de grupo",
+    "Decrease Brush Size in MaskEditor": "Disminuir tamaño del pincel en MaskEditor",
     "Delete Selected Items": "Eliminar elementos seleccionados",
     "Desktop User Guide": "Guía de usuario de escritorio",
     "Duplicate Current Workflow": "Duplicar flujo de trabajo actual",
@@ -754,6 +771,7 @@
     "Give Feedback": "Dar retroalimentación",
     "Group Selected Nodes": "Agrupar nodos seleccionados",
     "Help": "Ayuda",
+    "Increase Brush Size in MaskEditor": "Aumentar tamaño del pincel en MaskEditor",
     "Interrupt": "Interrumpir",
     "Load Default Workflow": "Cargar flujo de trabajo predeterminado",
     "Manage group nodes": "Gestionar nodos de grupo",
@@ -1167,7 +1185,6 @@
       },
       "showFlatList": "Mostrar lista plana"
     },
-    "themeToggle": "Cambiar tema",
     "workflowTab": {
       "confirmDelete": "¿Estás seguro de que quieres eliminar este flujo de trabajo?",
       "confirmDeleteTitle": "¿Eliminar flujo de trabajo?",

src/locales/es/settings.json

@@ -29,6 +29,13 @@
     "name": "Imagen de fondo del lienzo",
     "tooltip": "URL de la imagen para el fondo del lienzo. Puedes hacer clic derecho en una imagen del panel de resultados y seleccionar \"Establecer como fondo\" para usarla."
   },
+  "Comfy_Canvas_NavigationMode": {
+    "name": "Modo de navegación del lienzo",
+    "options": {
+      "Left-Click Pan (Legacy)": "Desplazamiento con clic izquierdo (Legado)",
+      "Standard (New)": "Estándar (Nuevo)"
+    }
+  },
   "Comfy_Canvas_SelectionToolbox": {
     "name": "Mostrar caja de herramientas de selección"
   },
@@ -395,10 +402,6 @@
   "LiteGraph_Node_TooltipDelay": {
     "name": "Retraso de la información sobre herramientas"
   },
-  "LiteGraph_Pointer_TrackpadGestures": {
-    "name": "Habilitar gestos del trackpad",
-    "tooltip": "Esta configuración activa el modo trackpad para el lienzo, permitiendo hacer zoom con pellizco y desplazar con dos dedos."
-  },
   "LiteGraph_Reroute_SplineOffset": {
     "name": "Desvío de la compensación de la spline",
     "tooltip": "El punto de control bezier desplazado desde el punto central de reenrutamiento"

src/locales/fr/commands.json

@@ -161,6 +161,12 @@
   "Comfy_Manager_ToggleManagerProgressDialog": {
     "label": "Basculer la boîte de dialogue de progression"
   },
+  "Comfy_MaskEditor_BrushSize_Decrease": {
+    "label": "Réduire la taille du pinceau dans MaskEditor"
+  },
+  "Comfy_MaskEditor_BrushSize_Increase": {
+    "label": "Augmenter la taille du pinceau dans MaskEditor"
+  },
   "Comfy_MaskEditor_OpenMaskEditor": {
     "label": "Ouvrir l'éditeur de masque pour le nœud sélectionné"
   },

src/locales/fr/main.json

@@ -82,6 +82,12 @@
       "title": "Créer un compte"
     }
   },
+  "breadcrumbsMenu": {
+    "clearWorkflow": "Effacer le workflow",
+    "deleteWorkflow": "Supprimer le workflow",
+    "duplicate": "Dupliquer",
+    "enterNewName": "Entrez un nouveau nom"
+  },
   "chatHistory": {
     "cancelEdit": "Annuler",
     "cancelEditTooltip": "Annuler la modification",
@@ -328,12 +334,14 @@
     "loadingPanel": "Chargement du panneau {panel}...",
     "login": "Connexion",
     "logs": "Journaux",
+    "micPermissionDenied": "Permission du microphone refusée",
     "migrate": "Migrer",
     "missing": "Manquant",
     "name": "Nom",
     "newFolder": "Nouveau dossier",
     "next": "Suivant",
     "no": "Non",
+    "noAudioRecorded": "Aucun audio enregistré",
     "noResultsFound": "Aucun résultat trouvé",
     "noTasksFound": "Aucune tâche trouvée",
     "noTasksFoundMessage": "Il n'y a pas de tâches dans la file d'attente.",
@@ -373,7 +381,9 @@
     "showReport": "Afficher le rapport",
     "sort": "Trier",
     "source": "Source",
+    "startRecording": "Commencer l’enregistrement",
     "status": "Statut",
+    "stopRecording": "Arrêter l’enregistrement",
     "success": "Succès",
     "systemInfo": "Informations système",
     "terminal": "Terminal",
@@ -705,13 +715,17 @@
     "batchCountTooltip": "Le nombre de fois que la génération du flux de travail doit être mise en file d'attente",
     "clear": "Effacer le flux de travail",
     "clipspace": "Ouvrir Clipspace",
+    "dark": "Sombre",
     "disabled": "Désactivé",
     "disabledTooltip": "Le flux de travail ne sera pas mis en file d'attente automatiquement",
     "execute": "Exécuter",
+    "help": "Aide",
     "hideMenu": "Masquer le menu",
     "instant": "Instantané",
     "instantTooltip": "Le flux de travail sera mis en file d'attente immédiatement après la fin d'une génération",
     "interrupt": "Annuler l'exécution en cours",
+    "light": "Clair",
+    "manageExtensions": "Gérer les extensions",
     "onChange": "Sur modification",
     "onChangeTooltip": "Le flux de travail sera mis en file d'attente une fois une modification effectuée",
     "refresh": "Actualiser les définitions des nœuds",
@@ -719,7 +733,9 @@
     "run": "Exécuter",
     "runWorkflow": "Exécuter le workflow (Maj pour mettre en file d'attente en premier)",
     "runWorkflowFront": "Exécuter le workflow (Mettre en file d'attente en premier)",
+    "settings": "Paramètres",
     "showMenu": "Afficher le menu",
+    "theme": "Thème",
     "toggleBottomPanel": "Basculer le panneau inférieur"
   },
   "menuLabels": {
@@ -743,6 +759,7 @@
     "Contact Support": "Contacter le support",
     "Convert Selection to Subgraph": "Convertir la sélection en sous-graphe",
     "Convert selected nodes to group node": "Convertir les nœuds sélectionnés en nœud de groupe",
+    "Decrease Brush Size in MaskEditor": "Réduire la taille du pinceau dans MaskEditor",
     "Delete Selected Items": "Supprimer les éléments sélectionnés",
     "Desktop User Guide": "Guide de l'utilisateur de bureau",
     "Duplicate Current Workflow": "Dupliquer le flux de travail actuel",
@@ -754,6 +771,7 @@
     "Give Feedback": "Donnez votre avis",
     "Group Selected Nodes": "Grouper les nœuds sélectionnés",
     "Help": "Aide",
+    "Increase Brush Size in MaskEditor": "Augmenter la taille du pinceau dans MaskEditor",
     "Interrupt": "Interrompre",
     "Load Default Workflow": "Charger le flux de travail par défaut",
     "Manage group nodes": "Gérer les nœuds de groupe",
@@ -1167,7 +1185,6 @@
       },
       "showFlatList": "Afficher la liste plate"
     },
-    "themeToggle": "Changer de thème",
     "workflowTab": {
       "confirmDelete": "Êtes-vous sûr de vouloir supprimer ce flux de travail ?",
       "confirmDeleteTitle": "Supprimer le flux de travail ?",

src/locales/fr/settings.json

@@ -29,6 +29,13 @@
     "name": "Image de fond du canevas",
     "tooltip": "URL de l'image pour le fond du canevas. Vous pouvez faire un clic droit sur une image dans le panneau de sortie et sélectionner « Définir comme fond » pour l'utiliser."
   },
+  "Comfy_Canvas_NavigationMode": {
+    "name": "Mode de navigation sur le canvas",
+    "options": {
+      "Left-Click Pan (Legacy)": "Panoramique clic gauche (Hérité)",
+      "Standard (New)": "Standard (Nouveau)"
+    }
+  },
   "Comfy_Canvas_SelectionToolbox": {
     "name": "Afficher la boîte à outils de sélection"
   },
@@ -395,10 +402,6 @@
   "LiteGraph_Node_TooltipDelay": {
     "name": "Délai d'infobulle"
   },
-  "LiteGraph_Pointer_TrackpadGestures": {
-    "name": "Activer les gestes du trackpad",
-    "tooltip": "Ce paramètre active le mode trackpad pour le canevas, permettant le zoom par pincement et le déplacement à deux doigts."
-  },
   "LiteGraph_Reroute_SplineOffset": {
     "name": "Réacheminement décalage de spline",
     "tooltip": "Le point de contrôle de Bézier est décalé par rapport au point central de réacheminement"

src/locales/ja/commands.json

@@ -161,6 +161,12 @@
   "Comfy_Manager_ToggleManagerProgressDialog": {
     "label": "プログレスダイアログの切り替え"
   },
+  "Comfy_MaskEditor_BrushSize_Decrease": {
+    "label": "マスクエディタでブラシサイズを縮小"
+  },
+  "Comfy_MaskEditor_BrushSize_Increase": {
+    "label": "マスクエディタでブラシサイズを大きくする"
+  },
   "Comfy_MaskEditor_OpenMaskEditor": {
     "label": "選択したノードのマスクエディタを開く"
   },

src/locales/ja/main.json

@@ -82,6 +82,12 @@
       "title": "アカウントを作成する"
     }
   },
+  "breadcrumbsMenu": {
+    "clearWorkflow": "ワークフローをクリア",
+    "deleteWorkflow": "ワークフローを削除",
+    "duplicate": "複製",
+    "enterNewName": "新しい名前を入力"
+  },
   "chatHistory": {
     "cancelEdit": "キャンセル",
     "cancelEditTooltip": "編集をキャンセル",
@@ -328,12 +334,14 @@
     "loadingPanel": "{panel} パネルを読み込み中...",
     "login": "ログイン",
     "logs": "ログ",
+    "micPermissionDenied": "マイクの許可が拒否されました",
     "migrate": "移行する",
     "missing": "不足している",
     "name": "名前",
     "newFolder": "新しいフォルダー",
     "next": "次へ",
     "no": "いいえ",
+    "noAudioRecorded": "音声が録音されていません",
     "noResultsFound": "結果が見つかりません",
     "noTasksFound": "タスクが見つかりません",
     "noTasksFoundMessage": "キューにタスクがありません。",
@@ -373,7 +381,9 @@
     "showReport": "レポートを表示",
     "sort": "並び替え",
     "source": "ソース",
+    "startRecording": "録音開始",
     "status": "ステータス",
+    "stopRecording": "録音停止",
     "success": "成功",
     "systemInfo": "システム情報",
     "terminal": "ターミナル",
@@ -705,13 +715,17 @@
     "batchCountTooltip": "ワークフロー生成回数",
     "clear": "ワークフローをクリア",
     "clipspace": "クリップスペースを開く",
+    "dark": "ダーク",
     "disabled": "無効",
     "disabledTooltip": "ワークフローは自動的にキューに追加されません",
     "execute": "実行",
+    "help": "ヘルプ",
     "hideMenu": "メニューを隠す",
     "instant": "即時",
     "instantTooltip": "生成完了後すぐにキューに追加",
     "interrupt": "現在の実行を中止",
+    "light": "ライト",
+    "manageExtensions": "拡張機能の管理",
     "onChange": "変更時",
     "onChangeTooltip": "変更が行われるとワークフローがキューに追加されます",
     "refresh": "ノードを更新",
@@ -719,7 +733,9 @@
     "run": "実行する",
     "runWorkflow": "ワークフローを実行する (Shiftで先頭にキュー)",
     "runWorkflowFront": "ワークフローを実行する (先頭にキュー)",
+    "settings": "設定",
     "showMenu": "メニューを表示",
+    "theme": "テーマ",
     "toggleBottomPanel": "下部パネルを切り替え"
   },
   "menuLabels": {
@@ -743,6 +759,7 @@
     "Contact Support": "サポートに連絡",
     "Convert Selection to Subgraph": "選択範囲をサブグラフに変換",
     "Convert selected nodes to group node": "選択したノードをグループノードに変換",
+    "Decrease Brush Size in MaskEditor": "マスクエディタでブラシサイズを小さくする",
     "Delete Selected Items": "選択したアイテムを削除",
     "Desktop User Guide": "デスクトップユーザーガイド",
     "Duplicate Current Workflow": "現在のワークフローを複製",
@@ -754,6 +771,7 @@
     "Give Feedback": "フィードバックを送る",
     "Group Selected Nodes": "選択したノードをグループ化",
     "Help": "ヘルプ",
+    "Increase Brush Size in MaskEditor": "マスクエディタでブラシサイズを大きくする",
     "Interrupt": "中断",
     "Load Default Workflow": "デフォルトワークフローを読み込む",
     "Manage group nodes": "グループノードを管理",
@@ -1167,7 +1185,6 @@
       },
       "showFlatList": "フラットリストを表示"
     },
-    "themeToggle": "テーマの切り替え",
     "workflowTab": {
       "confirmDelete": "このワークフローを削除してもよろしいですか？",
       "confirmDeleteTitle": "ワークフローを削除しますか？",

src/locales/ja/settings.json

@@ -29,6 +29,13 @@
     "name": "キャンバス背景画像",
     "tooltip": "キャンバスの背景画像のURLです。出力パネルで画像を右クリックし、「背景として設定」を選択すると使用できます。"
   },
+  "Comfy_Canvas_NavigationMode": {
+    "name": "キャンバスナビゲーションモード",
+    "options": {
+      "Left-Click Pan (Legacy)": "左クリックパン（レガシー）",
+      "Standard (New)": "標準（新）"
+    }
+  },
   "Comfy_Canvas_SelectionToolbox": {
     "name": "選択ツールボックスを表示"
   },
@@ -395,10 +402,6 @@
   "LiteGraph_Node_TooltipDelay": {
     "name": "ツールチップ遅延"
   },
-  "LiteGraph_Pointer_TrackpadGestures": {
-    "name": "トラックパッドジェスチャーを有効にする",
-    "tooltip": "この設定を有効にすると、キャンバスでトラックパッドモードが有効になり、ピンチズームや2本指でのパン操作が可能になります。"
-  },
   "LiteGraph_Reroute_SplineOffset": {
     "name": "リルートスプラインオフセット",
     "tooltip": "リルート中心点からのベジエ制御点のオフセット"

src/locales/ko/commands.json

@@ -99,13 +99,13 @@
     "label": "보류 중인 작업 지우기"
   },
   "Comfy_ClearWorkflow": {
-    "label": "워크플로 지우기"
+    "label": "워크플로 내용 지우기"
   },
   "Comfy_ContactSupport": {
     "label": "지원팀에 문의하기"
   },
   "Comfy_DuplicateWorkflow": {
-    "label": "현재 워크플로우 복제"
+    "label": "현재 워크플로 복제"
   },
   "Comfy_ExportWorkflow": {
     "label": "워크플로 내보내기"
@@ -161,6 +161,12 @@
   "Comfy_Manager_ToggleManagerProgressDialog": {
     "label": "진행 상황 대화 상자 전환"
   },
+  "Comfy_MaskEditor_BrushSize_Decrease": {
+    "label": "마스크 편집기에서 브러시 크기 줄이기"
+  },
+  "Comfy_MaskEditor_BrushSize_Increase": {
+    "label": "마스크 편집기에서 브러시 크기 늘리기"
+  },
   "Comfy_MaskEditor_OpenMaskEditor": {
     "label": "선택한 노드 마스크 편집기 열기"
   },
@@ -210,7 +216,7 @@
     "label": "로그아웃"
   },
   "Workspace_CloseWorkflow": {
-    "label": "현재 워크플로우 닫기"
+    "label": "현재 워크플로 닫기"
   },
   "Workspace_NextOpenedWorkflow": {
     "label": "다음 열린 워크플로"

src/locales/ko/main.json

@@ -5,7 +5,7 @@
     "totalCost": "총 비용"
   },
   "apiNodesSignInDialog": {
-    "message": "이 워크플로우에는 API 노드가 포함되어 있으며, 실행하려면 계정에 로그인해야 합니다.",
+    "message": "이 워크플로에는 API 노드가 포함되어 있으며, 실행하려면 계정에 로그인해야 합니다.",
     "title": "API 노드 사용에 필요한 로그인"
   },
   "auth": {
@@ -82,6 +82,12 @@
       "title": "계정 생성"
     }
   },
+  "breadcrumbsMenu": {
+    "clearWorkflow": "워크플로 내용 지우기",
+    "deleteWorkflow": "워크플로 삭제",
+    "duplicate": "복제",
+    "enterNewName": "새 이름 입력"
+  },
   "chatHistory": {
     "cancelEdit": "취소",
     "cancelEditTooltip": "편집 취소",
@@ -155,7 +161,7 @@
     "time": "시간",
     "topUp": {
       "buyNow": "지금 구매",
-      "insufficientMessage": "이 워크플로우를 실행하기에 크레딧이 부족합니다.",
+      "insufficientMessage": "이 워크플로를 실행하기에 크레딧이 부족합니다.",
       "insufficientTitle": "크레딧 부족",
       "maxAmount": "(최대 $1,000 USD)",
       "quickPurchase": "빠른 구매",
@@ -246,7 +252,7 @@
   "errorDialog": {
     "defaultTitle": "오류가 발생했습니다",
     "extensionFileHint": "다음 스크립트 때문일 수 있습니다",
-    "loadWorkflowTitle": "워크플로우 데이터를 다시 로드하는 중 오류로 인해 로드가 중단되었습니다",
+    "loadWorkflowTitle": "워크플로 데이터를 다시 로드하는 중 오류로 인해 로드가 중단되었습니다",
     "noStackTrace": "스택 추적을 사용할 수 없습니다",
     "promptExecutionError": "프롬프트 실행 실패"
   },
@@ -328,12 +334,14 @@
     "loadingPanel": "{panel} 패널 불러오는 중...",
     "login": "로그인",
     "logs": "로그",
+    "micPermissionDenied": "마이크 권한이 거부되었습니다",
     "migrate": "이전(migrate)",
     "missing": "누락됨",
     "name": "이름",
     "newFolder": "새 폴더",
     "next": "다음",
     "no": "아니오",
+    "noAudioRecorded": "녹음된 오디오가 없습니다",
     "noResultsFound": "결과를 찾을 수 없습니다.",
     "noTasksFound": "작업을 찾을 수 없습니다.",
     "noTasksFoundMessage": "대기열에 작업이 없습니다.",
@@ -373,7 +381,9 @@
     "showReport": "보고서 보기",
     "sort": "정렬",
     "source": "소스",
+    "startRecording": "녹음 시작",
     "status": "상태",
+    "stopRecording": "녹음 중지",
     "success": "성공",
     "systemInfo": "시스템 정보",
     "terminal": "터미널",
@@ -629,7 +639,7 @@
       "enabled": "활성화",
       "nodePack": "노드 팩"
     },
-    "inWorkflow": "워크플로우 내",
+    "inWorkflow": "워크플로 내",
     "infoPanelEmpty": "정보를 보려면 항목을 클릭하세요",
     "installAllMissingNodes": "모든 누락된 노드 설치",
     "installSelected": "선택한 항목 설치",
@@ -705,21 +715,27 @@
     "batchCountTooltip": "워크플로 작업을 실행 대기열에 반복 추가할 횟수",
     "clear": "워크플로 비우기",
     "clipspace": "클립스페이스 열기",
+    "dark": "다크",
     "disabled": "비활성화됨",
     "disabledTooltip": "워크플로 작업을 자동으로 실행 대기열에 추가하지 않습니다.",
     "execute": "실행",
+    "help": "도움말",
     "hideMenu": "메뉴 숨기기",
     "instant": "즉시",
     "instantTooltip": "워크플로 실행이 완료되면 즉시 실행 대기열에 추가합니다.",
     "interrupt": "현재 실행 취소",
+    "light": "라이트",
+    "manageExtensions": "확장 프로그램 관리",
     "onChange": "변경 시",
     "onChangeTooltip": "변경이 있는 경우에만 워크플로를 실행 대기열에 추가합니다.",
     "refresh": "노드 정의 새로 고침",
     "resetView": "캔버스 보기 재설정",
     "run": "실행",
-    "runWorkflow": "워크플로우 실행 (시프트 키와 함께 클릭시 가장 먼저 실행)",
-    "runWorkflowFront": "워크플로우 실행 (가장 먼저 실행)",
+    "runWorkflow": "워크플로 실행 (시프트 키와 함께 클릭시 가장 먼저 실행)",
+    "runWorkflowFront": "워크플로 실행 (가장 먼저 실행)",
+    "settings": "설정",
     "showMenu": "메뉴 표시",
+    "theme": "테마",
     "toggleBottomPanel": "하단 패널 전환"
   },
   "menuLabels": {
@@ -743,6 +759,7 @@
     "Contact Support": "고객 지원 문의",
     "Convert Selection to Subgraph": "선택 영역을 서브그래프로 변환",
     "Convert selected nodes to group node": "선택한 노드를 그룹 노드로 변환",
+    "Decrease Brush Size in MaskEditor": "마스크 편집기에서 브러시 크기 줄이기",
     "Delete Selected Items": "선택한 항목 삭제",
     "Desktop User Guide": "데스크톱 사용자 가이드",
     "Duplicate Current Workflow": "현재 워크플로 복제",
@@ -754,6 +771,7 @@
     "Give Feedback": "피드백 제공",
     "Group Selected Nodes": "선택한 노드 그룹화",
     "Help": "도움말",
+    "Increase Brush Size in MaskEditor": "마스크 편집기에서 브러시 크기 늘리기",
     "Interrupt": "중단",
     "Load Default Workflow": "기본 워크플로 불러오기",
     "Manage group nodes": "그룹 노드 관리",
@@ -796,11 +814,11 @@
     "Toggle Logs Bottom Panel": "로그 하단 패널 전환",
     "Toggle Model Library Sidebar": "모델 라이브러리 사이드바 전환",
     "Toggle Node Library Sidebar": "노드 라이브러리 사이드바 전환",
-    "Toggle Queue Sidebar": "대기열 사이드바 전환",
+    "Toggle Queue Sidebar": "실행 대기열 사이드바 전환",
     "Toggle Search Box": "검색 상자 전환",
     "Toggle Terminal Bottom Panel": "터미널 하단 패널 전환",
     "Toggle Theme (Dark/Light)": "테마 전환 (어두운/밝은)",
-    "Toggle Workflows Sidebar": "워크플로우 사이드바 전환",
+    "Toggle Workflows Sidebar": "워크플로 사이드바 전환",
     "Toggle the Custom Nodes Manager": "커스텀 노드 매니저 전환",
     "Toggle the Custom Nodes Manager Progress Bar": "커스텀 노드 매니저 진행률 표시줄 전환",
     "Undo": "실행 취소",
@@ -894,7 +912,7 @@
     "documentationPage": "문서 페이지",
     "inputs": "입력",
     "loadError": "도움말을 불러오지 못했습니다: {error}",
-    "moreHelp": "더 많은 도움말은",
+    "moreHelp": "더 자세한 도움말은",
     "outputs": "출력",
     "type": "유형"
   },
@@ -1167,7 +1185,6 @@
       },
       "showFlatList": "평면 목록 표시"
     },
-    "themeToggle": "테마 전환",
     "workflowTab": {
       "confirmDelete": "정말로 이 워크플로를 삭제하시겠습니까?",
       "confirmDeleteTitle": "워크플로 삭제",
@@ -1222,11 +1239,11 @@
         "stable_zero123_example": "Stable Zero123"
       },
       "3D API": {
-        "api_rodin_image_to_model": "Rodin: 이미지 투 모델",
-        "api_rodin_multiview_to_model": "Rodin: 다중뷰 투 모델",
-        "api_tripo_image_to_model": "Tripo: 이미지 투 모델",
-        "api_tripo_multiview_to_model": "Tripo: 다중뷰 투 모델",
-        "api_tripo_text_to_model": "Tripo: 텍스트 투 모델"
+        "api_rodin_image_to_model": "Rodin: 이미지 → 모델",
+        "api_rodin_multiview_to_model": "Rodin: 다중뷰 → 모델",
+        "api_tripo_image_to_model": "Tripo: 이미지 → 모델",
+        "api_tripo_multiview_to_model": "Tripo: 다중뷰 → 모델",
+        "api_tripo_text_to_model": "Tripo: 텍스트 → 모델"
       },
       "Area Composition": {
         "area_composition": "영역 구성",
@@ -1234,15 +1251,15 @@
       },
       "Audio": {
         "audio_ace_step_1_m2m_editing": "ACE Step v1 M2M 편집",
-        "audio_ace_step_1_t2a_instrumentals": "ACE-Step v1 텍스트 투 연주곡",
-        "audio_ace_step_1_t2a_song": "ACE Step v1 텍스트 투 노래",
+        "audio_ace_step_1_t2a_instrumentals": "ACE-Step v1 텍스트 → 연주곡",
+        "audio_ace_step_1_t2a_song": "ACE Step v1 텍스트 → 노래",
         "audio_stable_audio_example": "Stable Audio"
       },
       "Basics": {
         "default": "이미지 생성",
         "embedding_example": "임베딩",
         "gligen_textbox_example": "글리젠 텍스트박스",
-        "image2image": "이미지 투 이미지",
+        "image2image": "이미지 → 이미지",
         "inpaint_example": "인페인트",
         "inpaint_model_outpainting": "아웃페인팅",
         "lora": "LoRA",
@@ -1256,62 +1273,62 @@
         "mixing_controlnets": "컨트롤넷 혼합"
       },
       "Flux": {
-        "flux_canny_model_example": "Flux 캐니 모델",
-        "flux_depth_lora_example": "Flux 깊이 로라",
-        "flux_dev_checkpoint_example": "Flux Dev fp8",
-        "flux_dev_full_text_to_image": "Flux Dev 전체 텍스트 투 이미지",
-        "flux_fill_inpaint_example": "Flux 인페인트",
-        "flux_fill_outpaint_example": "Flux 아웃페인트",
-        "flux_kontext_dev_basic": "Flux Kontext Dev(기본)",
-        "flux_kontext_dev_grouped": "Flux Kontext Dev(그룹화)",
-        "flux_redux_model_example": "Flux Redux 모델",
-        "flux_schnell": "Flux Schnell fp8",
-        "flux_schnell_full_text_to_image": "Flux Schnell 전체 텍스트 투 이미지"
+        "flux_canny_model_example": "FLUX 캐니 모델",
+        "flux_depth_lora_example": "FLUX 깊이 로라",
+        "flux_dev_checkpoint_example": "FLUX Dev fp8",
+        "flux_dev_full_text_to_image": "FLUX Dev 전체 텍스트 투 이미지",
+        "flux_fill_inpaint_example": "FLUX 인페인트",
+        "flux_fill_outpaint_example": "FLUX 아웃페인트",
+        "flux_kontext_dev_basic": "FLUX Kontext Dev(기본)",
+        "flux_kontext_dev_grouped": "FLUX Kontext Dev(그룹화)",
+        "flux_redux_model_example": "FLUX Redux 모델",
+        "flux_schnell": "FLUX Schnell fp8",
+        "flux_schnell_full_text_to_image": "FLUX Schnell Full 텍스트 → 이미지"
       },
       "Image": {
         "hidream_e1_full": "HiDream E1 Full",
         "hidream_i1_dev": "HiDream I1 Dev",
         "hidream_i1_fast": "HiDream I1 Fast",
         "hidream_i1_full": "HiDream I1 Full",
-        "image_chroma_text_to_image": "Chroma 텍스트 투 이미지",
+        "image_chroma_text_to_image": "Chroma 텍스트 → 이미지",
         "image_cosmos_predict2_2B_t2i": "Cosmos Predict2 2B T2I",
         "image_lotus_depth_v1_1": "Lotus Depth",
         "image_omnigen2_image_edit": "OmniGen2 이미지 편집",
-        "image_omnigen2_t2i": "OmniGen2 텍스트 투 이미지",
-        "sd3_5_large_blur": "SD3.5 대형 블러",
-        "sd3_5_large_canny_controlnet_example": "SD3.5 대형 캐니 컨트롤넷",
-        "sd3_5_large_depth": "SD3.5 대형 깊이",
+        "image_omnigen2_t2i": "OmniGen2 텍스트 → 이미지",
+        "sd3_5_large_blur": "SD3.5 Large 블러",
+        "sd3_5_large_canny_controlnet_example": "SD3.5 Large 캐니 컨트롤넷",
+        "sd3_5_large_depth": "SD3.5 Large 깊이",
         "sd3_5_simple_example": "SD3.5 간단 예제",
-        "sdxl_refiner_prompt_example": "SDXL 리파이너 프롬프트",
+        "sdxl_refiner_prompt_example": "SDXL Refiner 프롬프트",
         "sdxl_revision_text_prompts": "SDXL Revision 텍스트 프롬프트",
         "sdxl_revision_zero_positive": "SDXL Revision Zero Positive",
         "sdxl_simple_example": "SDXL 간단 예제",
         "sdxlturbo_example": "SDXL 터보"
       },
       "Image API": {
-        "api_bfl_flux_1_kontext_max_image": "BFL Flux.1 Kontext 맥스",
-        "api_bfl_flux_1_kontext_multiple_images_input": "BFL Flux.1 Kontext 다중 이미지 입력",
-        "api_bfl_flux_1_kontext_pro_image": "BFL Flux.1 Kontext 프로",
-        "api_bfl_flux_pro_t2i": "BFL Flux[Pro]: 텍스트 투 이미지",
-        "api_ideogram_v3_t2i": "Ideogram V3: 텍스트 투 이미지",
-        "api_luma_photon_i2i": "Luma Photon: 이미지 투 이미지",
+        "api_bfl_flux_1_kontext_max_image": "BFL FLUX.1 Kontext 맥스",
+        "api_bfl_flux_1_kontext_multiple_images_input": "BFL FLUX.1 Kontext 다중 이미지 입력",
+        "api_bfl_flux_1_kontext_pro_image": "BFL FLUX.1 Kontext 프로",
+        "api_bfl_flux_pro_t2i": "BFL FLUX[Pro]: 텍스트 → 이미지",
+        "api_ideogram_v3_t2i": "Ideogram V3: 텍스트 → 이미지",
+        "api_luma_photon_i2i": "Luma Photon: 이미지 → 이미지",
         "api_luma_photon_style_ref": "Luma Photon: 스타일 참조",
         "api_openai_dall_e_2_inpaint": "OpenAI: Dall-E 2 인페인트",
-        "api_openai_dall_e_2_t2i": "OpenAI: Dall-E 2 텍스트 투 이미지",
-        "api_openai_dall_e_3_t2i": "OpenAI: Dall-E 3 텍스트 투 이미지",
-        "api_openai_image_1_i2i": "OpenAI: GPT-Image-1 이미지 투 이미지",
+        "api_openai_dall_e_2_t2i": "OpenAI: Dall-E 2 텍스트 → 이미지",
+        "api_openai_dall_e_3_t2i": "OpenAI: Dall-E 3 텍스트 → 이미지",
+        "api_openai_image_1_i2i": "OpenAI: GPT-Image-1 이미지 → 이미지",
         "api_openai_image_1_inpaint": "OpenAI: GPT-Image-1 인페인트",
         "api_openai_image_1_multi_inputs": "OpenAI: GPT-Image-1 멀티 입력",
-        "api_openai_image_1_t2i": "OpenAI: GPT-Image-1 텍스트 투 이미지",
+        "api_openai_image_1_t2i": "OpenAI: GPT-Image-1 텍스트 → 이미지",
         "api_recraft_image_gen_with_color_control": "Recraft: 색상 제어 이미지 생성",
         "api_recraft_image_gen_with_style_control": "Recraft: 스타일 제어 이미지 생성",
         "api_recraft_vector_gen": "Recraft: 벡터 생성",
-        "api_runway_reference_to_image": "Runway: 참조 투 이미지",
-        "api_runway_text_to_image": "Runway: 텍스트 투 이미지",
-        "api_stability_ai_i2i": "Stability AI: 이미지 투 이미지",
-        "api_stability_ai_sd3_5_i2i": "Stability AI: SD3.5 이미지 투 이미지",
-        "api_stability_ai_sd3_5_t2i": "Stability AI: SD3.5 텍스트 투 이미지",
-        "api_stability_ai_stable_image_ultra_t2i": "Stability AI: Stable Image Ultra 텍스트 투 이미지"
+        "api_runway_reference_to_image": "Runway: 참조 → 이미지",
+        "api_runway_text_to_image": "Runway: 텍스트 → 이미지",
+        "api_stability_ai_i2i": "Stability AI: 이미지 → 이미지",
+        "api_stability_ai_sd3_5_i2i": "Stability AI: SD3.5 이미지 → 이미지",
+        "api_stability_ai_sd3_5_t2i": "Stability AI: SD3.5 텍스트 → 이미지",
+        "api_stability_ai_stable_image_ultra_t2i": "Stability AI: Stable Image Ultra 텍스트 → 이미지"
       },
       "LLM API": {
         "api_google_gemini": "Google Gemini: 채팅",
@@ -1319,24 +1336,24 @@
       },
       "Upscaling": {
         "esrgan_example": "ESRGAN",
-        "hiresfix_esrgan_workflow": "HiresFix ESRGAN 워크플로우",
-        "hiresfix_latent_workflow": "업스케일",
-        "latent_upscale_different_prompt_model": "Latent 업스케일 다른 프롬프트 모델"
+        "hiresfix_esrgan_workflow": "HiresFix ESRGAN 워크플로",
+        "hiresfix_latent_workflow": "이미지 확대",
+        "latent_upscale_different_prompt_model": "잠재 이미지 확대 다른 프롬프트 모델"
       },
       "Video": {
-        "hunyuan_video_text_to_video": "Hunyuan 비디오 텍스트 투 비디오",
-        "image_to_video": "SVD 이미지 투 비디오",
-        "image_to_video_wan": "Wan 2.1 이미지 투 비디오",
-        "ltxv_image_to_video": "LTXV 이미지 투 비디오",
-        "ltxv_text_to_video": "LTXV 텍스트 투 비디오",
-        "mochi_text_to_video_example": "Mochi 텍스트 투 비디오",
-        "text_to_video_wan": "Wan 2.1 텍스트 투 비디오",
-        "txt_to_image_to_video": "SVD 텍스트 투 이미지 투 비디오",
+        "hunyuan_video_text_to_video": "Hunyuan 비디오 텍스트 → 비디오",
+        "image_to_video": "SVD 이미지 → 비디오",
+        "image_to_video_wan": "Wan 2.1 이미지 → 비디오",
+        "ltxv_image_to_video": "LTXV 이미지 → 비디오",
+        "ltxv_text_to_video": "LTXV 텍스트 → 비디오",
+        "mochi_text_to_video_example": "Mochi 텍스트 → 비디오",
+        "text_to_video_wan": "Wan 2.1 텍스트 → 비디오",
+        "txt_to_image_to_video": "SVD 텍스트 → 이미지 → 비디오",
         "video_cosmos_predict2_2B_video2world_480p_16fps": "Cosmos Predict2 2B Video2World 480p 16fps",
         "video_wan2_1_fun_camera_v1_1_14B": "Wan 2.1 Fun Camera 14B",
         "video_wan2_1_fun_camera_v1_1_1_3B": "Wan 2.1 Fun Camera 1.3B",
-        "video_wan_vace_14B_ref2v": "Wan VACE 참조 투 비디오",
-        "video_wan_vace_14B_t2v": "Wan VACE 텍스트 투 비디오",
+        "video_wan_vace_14B_ref2v": "Wan VACE 참조 → 비디오",
+        "video_wan_vace_14B_t2v": "Wan VACE 텍스트 → 비디오",
         "video_wan_vace_14B_v2v": "Wan VACE 컨트롤 비디오",
         "video_wan_vace_flf2v": "Wan VACE 첫-마지막 프레임",
         "video_wan_vace_inpainting": "Wan VACE 인페인팅",
@@ -1346,24 +1363,24 @@
         "wan2_1_fun_inp": "Wan 2.1 인페인팅"
       },
       "Video API": {
-        "api_hailuo_minimax_i2v": "MiniMax: 이미지 투 비디오",
-        "api_hailuo_minimax_t2v": "MiniMax: 텍스트 투 비디오",
+        "api_hailuo_minimax_i2v": "MiniMax: 이미지 → 비디오",
+        "api_hailuo_minimax_t2v": "MiniMax: 텍스트 → 비디오",
         "api_kling_effects": "Kling: 비디오 효과",
         "api_kling_flf": "Kling: FLF2V",
-        "api_kling_i2v": "Kling: 이미지 투 비디오",
-        "api_luma_i2v": "Luma: 이미지 투 비디오",
-        "api_luma_t2v": "Luma: 텍스트 투 비디오",
-        "api_moonvalley_image_to_video": "Moonvalley: 이미지 투 비디오",
-        "api_moonvalley_text_to_video": "Moonvalley: 텍스트 투 비디오",
-        "api_pika_i2v": "Pika: 이미지 투 비디오",
-        "api_pika_scene": "Pika 장면: 이미지 투 비디오",
-        "api_pixverse_i2v": "PixVerse: 이미지 투 비디오",
-        "api_pixverse_t2v": "PixVerse: 텍스트 투 비디오",
-        "api_pixverse_template_i2v": "PixVerse 템플릿: 이미지 투 비디오",
-        "api_runway_first_last_frame": "Runway: 첫-마지막 프레임 투 비디오",
-        "api_runway_gen3a_turbo_image_to_video": "Runway: Gen3a Turbo 이미지 투 비디오",
-        "api_runway_gen4_turo_image_to_video": "Runway: Gen4 Turbo 이미지 투 비디오",
-        "api_veo2_i2v": "Veo2: 이미지 투 비디오"
+        "api_kling_i2v": "Kling: 이미지 → 비디오",
+        "api_luma_i2v": "Luma: 이미지 → 비디오",
+        "api_luma_t2v": "Luma: 텍스트 → 비디오",
+        "api_moonvalley_image_to_video": "Moonvalley: 이미지 → 비디오",
+        "api_moonvalley_text_to_video": "Moonvalley: 텍스트 → 비디오",
+        "api_pika_i2v": "Pika: 이미지 → 비디오",
+        "api_pika_scene": "Pika 장면: 이미지 → 비디오",
+        "api_pixverse_i2v": "PixVerse: 이미지 → 비디오",
+        "api_pixverse_t2v": "PixVerse: 텍스트 → 비디오",
+        "api_pixverse_template_i2v": "PixVerse 템플릿: 이미지 → 비디오",
+        "api_runway_first_last_frame": "Runway: 첫-마지막 프레임 → 비디오",
+        "api_runway_gen3a_turbo_image_to_video": "Runway: Gen3a Turbo 이미지 → 비디오",
+        "api_runway_gen4_turo_image_to_video": "Runway: Gen4 Turbo 이미지 → 비디오",
+        "api_veo2_i2v": "Veo2: 이미지 → 비디오"
       }
     },
     "templateDescription": {
@@ -1378,7 +1395,7 @@
         "api_rodin_multiview_to_model": "Rodin의 다각도 재구성으로 종합적인 3D 모델을 만듭니다.",
         "api_tripo_image_to_model": "Tripo 엔진으로 2D 이미지에서 전문가용 3D 에셋을 생성합니다.",
         "api_tripo_multiview_to_model": "Tripo의 고급 스캐너로 여러 각도에서 3D 모델을 만듭니다.",
-        "api_tripo_text_to_model": "Tripo의 텍스트 기반 모델링으로 설명에서 3D 오브젝트를 만듭니다."
+        "api_tripo_text_to_model": "Tripo의 텍스트 기반 모델링으로 설명에서 3D 객체를 만듭니다."
       },
       "Area Composition": {
         "area_composition": "정의된 영역으로 구성을 제어하여 이미지를 생성합니다.",
@@ -1401,49 +1418,49 @@
         "lora_multiple": "여러 LoRA 모델을 결합하여 이미지를 생성합니다."
       },
       "ControlNet": {
-        "2_pass_pose_worship": "ControlNet으로 포즈 참조를 활용해 이미지를 생성합니다.",
-        "controlnet_example": "ControlNet으로 스크리블 참조 이미지를 활용해 이미지를 생성합니다.",
-        "depth_controlnet": "ControlNet으로 깊이 정보를 활용해 이미지를 생성합니다.",
+        "2_pass_pose_worship": "컨트롤넷으로 포즈 참조를 활용해 이미지를 생성합니다.",
+        "controlnet_example": "컨트롤넷으로 스크리블 참조 이미지를 활용해 이미지를 생성합니다.",
+        "depth_controlnet": "컨트롤넷으로 깊이 정보를 활용해 이미지를 생성합니다.",
         "depth_t2i_adapter": "T2I 어댑터로 깊이 정보를 활용해 이미지를 생성합니다.",
-        "mixing_controlnets": "여러 ControlNet 모델을 결합해 이미지를 생성합니다."
+        "mixing_controlnets": "여러 컨트롤넷 모델을 결합해 이미지를 생성합니다."
       },
       "Flux": {
-        "flux_canny_model_example": "Flux Canny로 에지 감지에 따라 이미지를 생성합니다.",
-        "flux_depth_lora_example": "Flux LoRA로 깊이 정보를 활용해 이미지를 생성합니다.",
-        "flux_dev_checkpoint_example": "Flux Dev fp8 양자화 버전으로 이미지를 생성합니다. VRAM이 제한된 장치에 적합하며, 모델 파일 하나만 필요하지만 화질은 전체 버전보다 약간 낮습니다.",
-        "flux_dev_full_text_to_image": "Flux Dev 전체 버전으로 고품질 이미지를 생성합니다. 더 많은 VRAM과 여러 모델 파일이 필요하지만, 최고의 프롬프트 반영력과 화질을 제공합니다.",
-        "flux_fill_inpaint_example": "Flux 인페인팅으로 이미지의 누락된 부분을 채웁니다.",
-        "flux_fill_outpaint_example": "Flux 아웃페인팅으로 이미지를 경계 너머로 확장합니다.",
-        "flux_kontext_dev_basic": "Flux Kontext의 전체 노드 표시로 이미지를 편집합니다. 워크플로우 학습에 적합합니다.",
-        "flux_kontext_dev_grouped": "노드가 그룹화된 Flux Kontext의 간소화 버전으로 작업 공간이 더 깔끔합니다.",
-        "flux_redux_model_example": "Flux Redux로 참조 이미지의 스타일을 전송하여 이미지를 생성합니다.",
-        "flux_schnell": "Flux Schnell fp8 양자화 버전으로 이미지를 빠르게 생성합니다. 저사양 하드웨어에 이상적이며, 4단계만으로 이미지를 생성할 수 있습니다.",
-        "flux_schnell_full_text_to_image": "Flux Schnell 전체 버전으로 이미지를 빠르게 생성합니다. Apache2.0 라이선스를 사용하며, 4단계만으로 좋은 화질을 유지합니다."
+        "flux_canny_model_example": "FLUX 캐니 컨트롤넷으로 에지 감지에 따라 이미지를 생성합니다.",
+        "flux_depth_lora_example": "FLUX LoRA로 깊이 정보를 활용해 이미지를 생성합니다.",
+        "flux_dev_checkpoint_example": "FLUX Dev fp8 양자화 버전으로 이미지를 생성합니다. VRAM이 제한된 장치에 적합하며, 모델 파일 하나만 필요하지만 화질은 전체 버전보다 약간 낮습니다.",
+        "flux_dev_full_text_to_image": "FLUX Dev 전체 버전으로 고품질 이미지를 생성합니다. 더 많은 VRAM과 여러 모델 파일이 필요하지만, 최고의 프롬프트 반영력과 화질을 제공합니다.",
+        "flux_fill_inpaint_example": "FLUX 인페인팅으로 이미지의 누락된 부분을 채웁니다.",
+        "flux_fill_outpaint_example": "FFLUXlux 아웃페인팅으로 이미지를 경계 너머로 확장합니다.",
+        "flux_kontext_dev_basic": "FLUX Kontext의 전체 노드 표시로 이미지를 편집합니다. 워크플로 학습에 적합합니다.",
+        "flux_kontext_dev_grouped": "노드가 그룹화된 FLUX Kontext의 간소화 버전으로 작업 공간이 더 깔끔합니다.",
+        "flux_redux_model_example": "FLUX Redux로 참조 이미지의 스타일을 전송하여 이미지를 생성합니다.",
+        "flux_schnell": "FLUX Schnell fp8 양자화 버전으로 이미지를 빠르게 생성합니다. 저사양 하드웨어에 이상적이며, 4단계만으로 이미지를 생성할 수 있습니다.",
+        "flux_schnell_full_text_to_image": "FLUX Schnell Full 버전을 이용해 이미지를 빠르게 생성합니다. Apache2.0 라이선스를 사용하며, 4단계만으로 좋은 화질을 유지합니다."
       },
       "Image": {
         "hidream_e1_full": "HiDream E1 - 전문적인 자연어 이미지 편집 모델로 이미지를 편집합니다.",
         "hidream_i1_dev": "HiDream I1 Dev - 28 스텝의 균형 잡힌 버전으로, 중간급 하드웨어에 적합합니다.",
         "hidream_i1_fast": "HiDream I1 Fast - 16 스텝의 경량 버전으로, 저사양 하드웨어에서 빠른 미리보기에 적합합니다.",
         "hidream_i1_full": "HiDream I1 Full - 50 스텝의 완전 버전으로, 최고의 품질을 제공합니다.",
-        "image_chroma_text_to_image": "Chroma는 flux에서 수정된 모델로, 아키텍처에 일부 변화가 있습니다.",
+        "image_chroma_text_to_image": "Chroma는 FLUX에서 수정된 모델로, 아키텍처에 일부 변화가 있습니다.",
         "image_cosmos_predict2_2B_t2i": "Cosmos-Predict2 2B T2I로 물리적으로 정확하고 고해상도, 디테일이 풍부한 이미지를 생성합니다.",
         "image_lotus_depth_v1_1": "Lotus Depth로 고효율 단안 깊이 추정 및 디테일 보존이 뛰어난 zero-shot 이미지를 생성합니다.",
         "image_omnigen2_image_edit": "OmniGen2의 고급 이미지 편집 기능과 텍스트 렌더링 지원으로 자연어 지시로 이미지를 편집합니다.",
         "image_omnigen2_t2i": "OmniGen2의 통합 7B 멀티모달 모델과 듀얼 패스 아키텍처로 텍스트 프롬프트에서 고품질 이미지를 생성합니다.",
         "sd3_5_large_blur": "SD 3.5로 흐릿한 참조 이미지를 활용해 이미지를 생성합니다.",
-        "sd3_5_large_canny_controlnet_example": "SD 3.5 Canny ControlNet으로 에지 감지에 따라 이미지를 생성합니다.",
+        "sd3_5_large_canny_controlnet_example": "SD 3.5 캐니 컨트롤넷으로 에지 감지에 따라 이미지를 생성합니다.",
         "sd3_5_large_depth": "SD 3.5로 깊이 정보를 활용해 이미지를 생성합니다.",
         "sd3_5_simple_example": "SD 3.5로 이미지를 생성합니다.",
-        "sdxl_refiner_prompt_example": "SDXL 리파이너 모델로 이미지를 향상시킵니다.",
+        "sdxl_refiner_prompt_example": "SDXL Refiner 모델로 이미지를 향상시킵니다.",
         "sdxl_revision_text_prompts": "SDXL Revision으로 참조 이미지의 개념을 전송하여 이미지를 생성합니다.",
         "sdxl_revision_zero_positive": "SDXL Revision으로 텍스트 프롬프트와 참조 이미지를 함께 사용해 이미지를 생성합니다.",
         "sdxl_simple_example": "SDXL로 고품질 이미지를 생성합니다.",
         "sdxlturbo_example": "SDXL Turbo로 한 번에 이미지를 생성합니다."
       },
       "Image API": {
-        "api_bfl_flux_1_kontext_max_image": "Flux.1 Kontext 맥스 이미지로 이미지를 편집합니다.",
-        "api_bfl_flux_1_kontext_multiple_images_input": "여러 이미지를 입력하고 Flux.1 Kontext로 편집합니다.",
-        "api_bfl_flux_1_kontext_pro_image": "Flux.1 Kontext 프로 이미지로 이미지를 편집합니다.",
+        "api_bfl_flux_1_kontext_max_image": "FLUX.1 Kontext 맥스 이미지로 이미지를 편집합니다.",
+        "api_bfl_flux_1_kontext_multiple_images_input": "여러 이미지를 입력하고 FLUX.1 Kontext로 편집합니다.",
+        "api_bfl_flux_1_kontext_pro_image": "FLUX.1 Kontext 프로 이미지로 이미지를 편집합니다.",
         "api_bfl_flux_pro_t2i": "FLUX.1 Pro로 뛰어난 프롬프트 반영과 시각적 품질로 이미지를 생성합니다.",
         "api_ideogram_v3_t2i": "Ideogram V3로 뛰어난 프롬프트 일치, 포토리얼리즘, 텍스트 렌더링으로 전문가 수준의 이미지를 생성합니다.",
         "api_luma_photon_i2i": "이미지와 프롬프트를 조합하여 이미지 생성을 가이드합니다.",
@@ -1461,9 +1478,9 @@
         "api_runway_reference_to_image": "Runway의 AI로 참조 스타일과 구성을 기반으로 새 이미지를 생성합니다.",
         "api_runway_text_to_image": "Runway의 AI 모델로 텍스트 프롬프트에서 고품질 이미지를 생성합니다.",
         "api_stability_ai_i2i": "Stability AI로 고품질 이미지 변환 및 스타일 전환을 지원합니다.",
-        "api_stability_ai_sd3_5_i2i": "1메가픽셀 해상도에서 전문가용 고품질 이미지를 생성합니다. 프롬프트 반영이 우수합니다.",
-        "api_stability_ai_sd3_5_t2i": "1메가픽셀 해상도에서 전문가용 고품질 이미지를 생성합니다. 프롬프트 반영이 우수합니다.",
-        "api_stability_ai_stable_image_ultra_t2i": "1메가픽셀 해상도에서 전문가용 고품질 이미지를 생성합니다. 프롬프트 반영이 우수합니다."
+        "api_stability_ai_sd3_5_i2i": "1M 픽셀 해상도에서 전문가용 고품질 이미지를 생성합니다. 프롬프트 반영이 우수합니다.",
+        "api_stability_ai_sd3_5_t2i": "1M 픽셀 해상도에서 전문가용 고품질 이미지를 생성합니다. 프롬프트 반영이 우수합니다.",
+        "api_stability_ai_stable_image_ultra_t2i": "1M 픽셀 해상도에서 전문가용 고품질 이미지를 생성합니다. 프롬프트 반영이 우수합니다."
       },
       "LLM API": {
         "api_google_gemini": "Google Gemini의 멀티모달 AI와 추론 능력을 경험하세요.",
@@ -1471,9 +1488,9 @@
       },
       "Upscaling": {
         "esrgan_example": "ESRGAN 모델로 이미지 품질을 향상합니다.",
-        "hiresfix_esrgan_workflow": "중간 생성 단계에서 ESRGAN 모델로 업스케일합니다.",
-        "hiresfix_latent_workflow": "Latent 공간에서 이미지 품질을 향상합니다.",
-        "latent_upscale_different_prompt_model": "여러 번의 생성 패스에서 프롬프트를 변경하며 업스케일합니다."
+        "hiresfix_esrgan_workflow": "중간 생성 단계에서 ESRGAN 모델로 이미지를 확대합니다.",
+        "hiresfix_latent_workflow": "잠재 이미지의 확대 방식으로 이미지 품질을 향상합니다.",
+        "latent_upscale_different_prompt_model": "여러 번의 생성 패스에서 프롬프트를 변경하며 이미지를 확대합니다."
       },
       "Video": {
         "hunyuan_video_text_to_video": "Hunyuan 모델로 텍스트 프롬프트에서 비디오를 생성합니다.",
@@ -1494,7 +1511,7 @@
         "video_wan_vace_inpainting": "특정 영역을 편집하면서 주변 내용을 보존하는 비디오를 생성합니다. 객체 제거 또는 교체에 적합합니다.",
         "video_wan_vace_outpainting": "Wan VACE 아웃페인팅으로 비디오 크기를 확장하여 비디오를 생성합니다.",
         "wan2_1_flf2v_720_f16": "Wan 2.1 FLF2V로 첫 프레임과 마지막 프레임을 제어하여 비디오를 생성합니다.",
-        "wan2_1_fun_control": "Wan 2.1 ControlNet으로 포즈, 깊이, 에지 제어로 비디오를 생성합니다.",
+        "wan2_1_fun_control": "Wan 2.1 컨트롤넷으로 포즈, 깊이, 에지 제어로 적용해 비디오를 생성합니다.",
         "wan2_1_fun_inp": "Wan 2.1 인페인팅으로 시작 및 종료 프레임에서 비디오를 생성합니다."
       },
       "Video API": {
@@ -1538,7 +1555,7 @@
     "failedToFetchLogs": "서버 로그를 가져오는 데 실패했습니다",
     "failedToInitiateCreditPurchase": "크레딧 구매를 시작하지 못했습니다: {error}",
     "failedToPurchaseCredits": "크레딧 구매에 실패했습니다: {error}",
-    "fileLoadError": "{fileName}에서 워크플로우를 찾을 수 없습니다",
+    "fileLoadError": "{fileName}에서 워크플로를 찾을 수 없습니다",
     "fileUploadFailed": "파일 업로드에 실패했습니다",
     "interrupted": "실행이 중단되었습니다",
     "migrateToLitegraphReroute": "향후 버전에서는 Reroute 노드가 제거됩니다. LiteGraph 에서 자체 제공하는 경유점으로 변환하려면 클릭하세요.",

src/locales/ko/settings.json

@@ -29,6 +29,13 @@
     "name": "캔버스 배경 이미지",
     "tooltip": "캔버스 배경에 사용할 이미지 URL입니다. 출력 패널에서 이미지를 마우스 오른쪽 버튼으로 클릭한 후 \"배경으로 설정\"을 선택해 사용할 수 있습니다."
   },
+  "Comfy_Canvas_NavigationMode": {
+    "name": "캔버스 내비게이션 모드",
+    "options": {
+      "Left-Click Pan (Legacy)": "왼쪽 클릭 이동(레거시)",
+      "Standard (New)": "표준(신규)"
+    }
+  },
   "Comfy_Canvas_SelectionToolbox": {
     "name": "선택 도구 상자 표시"
   },
@@ -395,10 +402,6 @@
   "LiteGraph_Node_TooltipDelay": {
     "name": "툴팁 지연"
   },
-  "LiteGraph_Pointer_TrackpadGestures": {
-    "name": "트랙패드 제스처 활성화",
-    "tooltip": "이 설정을 켜면 캔버스에서 트랙패드 모드를 사용할 수 있으며, 두 손가락으로 확대/축소 및 이동이 가능합니다."
-  },
   "LiteGraph_Reroute_SplineOffset": {
     "name": "경유점 스플라인 오프셋",
     "tooltip": "경유점 중심에서 베지어 제어점까지의 오프셋"

src/locales/ru/commands.json

@@ -161,6 +161,12 @@
   "Comfy_Manager_ToggleManagerProgressDialog": {
     "label": "Переключить диалоговое окно прогресса"
   },
+  "Comfy_MaskEditor_BrushSize_Decrease": {
+    "label": "Уменьшить размер кисти в MaskEditor"
+  },
+  "Comfy_MaskEditor_BrushSize_Increase": {
+    "label": "Увеличить размер кисти в MaskEditor"
+  },
   "Comfy_MaskEditor_OpenMaskEditor": {
     "label": "Открыть редактор масок для выбранной ноды"
   },

src/locales/ru/main.json

@@ -82,6 +82,12 @@
       "title": "Создать аккаунт"
     }
   },
+  "breadcrumbsMenu": {
+    "clearWorkflow": "Очистить рабочий процесс",
+    "deleteWorkflow": "Удалить рабочий процесс",
+    "duplicate": "Дублировать",
+    "enterNewName": "Введите новое имя"
+  },
   "chatHistory": {
     "cancelEdit": "Отмена",
     "cancelEditTooltip": "Отменить редактирование",
@@ -328,12 +334,14 @@
     "loadingPanel": "Загрузка панели {panel}...",
     "login": "Вход",
     "logs": "Логи",
+    "micPermissionDenied": "Доступ к микрофону запрещён",
     "migrate": "Мигрировать",
     "missing": "Отсутствует",
     "name": "Имя",
     "newFolder": "Новая папка",
     "next": "Далее",
     "no": "Нет",
+    "noAudioRecorded": "Аудио не записано",
     "noResultsFound": "Результатов не найдено",
     "noTasksFound": "Задачи не найдены",
     "noTasksFoundMessage": "В очереди нет задач.",
@@ -373,7 +381,9 @@
     "showReport": "Показать отчёт",
     "sort": "Сортировать",
     "source": "Источник",
+    "startRecording": "Начать запись",
     "status": "Статус",
+    "stopRecording": "Остановить запись",
     "success": "Успех",
     "systemInfo": "Информация о системе",
     "terminal": "Терминал",
@@ -705,13 +715,17 @@
     "batchCountTooltip": "Количество раз, когда генерация рабочего процесса должна быть помещена в очередь",
     "clear": "Очистить рабочий процесс",
     "clipspace": "Открыть Clipspace",
+    "dark": "Тёмная",
     "disabled": "Отключено",
     "disabledTooltip": "Рабочий процесс не будет автоматически помещён в очередь",
     "execute": "Выполнить",
+    "help": "Справка",
     "hideMenu": "Скрыть меню",
     "instant": "Мгновенно",
     "instantTooltip": "Рабочий процесс будет помещён в очередь сразу же после завершения генерации",
     "interrupt": "Отменить текущее выполнение",
+    "light": "Светлая",
+    "manageExtensions": "Управление расширениями",
     "onChange": "При изменении",
     "onChangeTooltip": "Рабочий процесс будет поставлен в очередь после внесения изменений",
     "refresh": "Обновить определения нод",
@@ -719,7 +733,9 @@
     "run": "Запустить",
     "runWorkflow": "Запустить рабочий процесс (Shift для очереди в начале)",
     "runWorkflowFront": "Запустить рабочий процесс (Очередь в начале)",
+    "settings": "Настройки",
     "showMenu": "Показать меню",
+    "theme": "Тема",
     "toggleBottomPanel": "Переключить нижнюю панель"
   },
   "menuLabels": {
@@ -743,6 +759,7 @@
     "Contact Support": "Связаться с поддержкой",
     "Convert Selection to Subgraph": "Преобразовать выделенное в подграф",
     "Convert selected nodes to group node": "Преобразовать выбранные ноды в групповую ноду",
+    "Decrease Brush Size in MaskEditor": "Уменьшить размер кисти в MaskEditor",
     "Delete Selected Items": "Удалить выбранные элементы",
     "Desktop User Guide": "Руководство пользователя для настольных ПК",
     "Duplicate Current Workflow": "Дублировать текущий рабочий процесс",
@@ -754,6 +771,7 @@
     "Give Feedback": "Оставить отзыв",
     "Group Selected Nodes": "Сгруппировать выбранные ноды",
     "Help": "Помощь",
+    "Increase Brush Size in MaskEditor": "Увеличить размер кисти в MaskEditor",
     "Interrupt": "Прервать",
     "Load Default Workflow": "Загрузить стандартный рабочий процесс",
     "Manage group nodes": "Управление групповыми нодами",
@@ -1167,7 +1185,6 @@
       },
       "showFlatList": "Показать плоский список"
     },
-    "themeToggle": "Переключить тему",
     "workflowTab": {
       "confirmDelete": "Вы уверены, что хотите удалить этот рабочий процесс?",
       "confirmDeleteTitle": "Удалить рабочий процесс?",

src/locales/ru/settings.json

@@ -29,6 +29,13 @@
     "name": "Фоновое изображение холста",
     "tooltip": "URL изображения для фона холста. Вы можете кликнуть правой кнопкой мыши на изображении в панели результатов и выбрать «Установить как фон», чтобы использовать его."
   },
+  "Comfy_Canvas_NavigationMode": {
+    "name": "Режим навигации по холсту",
+    "options": {
+      "Left-Click Pan (Legacy)": "Перемещение левой кнопкой (устаревший)",
+      "Standard (New)": "Стандартный (новый)"
+    }
+  },
   "Comfy_Canvas_SelectionToolbox": {
     "name": "Показать панель инструментов выбора"
   },
@@ -395,10 +402,6 @@
   "LiteGraph_Node_TooltipDelay": {
     "name": "Задержка всплывающей подсказки"
   },
-  "LiteGraph_Pointer_TrackpadGestures": {
-    "name": "Включить жесты трекпада",
-    "tooltip": "Эта настройка включает режим трекпада для холста, позволяя использовать масштабирование щипком и панорамирование двумя пальцами."
-  },
   "LiteGraph_Reroute_SplineOffset": {
     "name": "Перераспределение смещения сплайна",
     "tooltip": "Смещение контрольной точки Безье от центральной точки перераспределения"

src/locales/zh-TW/commands.json

@@ -161,6 +161,12 @@
   "Comfy_Manager_ToggleManagerProgressDialog": {
     "label": "切換自訂節點管理器進度條"
   },
+  "Comfy_MaskEditor_BrushSize_Decrease": {
+    "label": "減少 MaskEditor 畫筆大小"
+  },
+  "Comfy_MaskEditor_BrushSize_Increase": {
+    "label": "增加 MaskEditor 畫筆大小"
+  },
   "Comfy_MaskEditor_OpenMaskEditor": {
     "label": "為選取的節點開啟 Mask 編輯器"
   },