ComfyUI-LinkSpotlight v1.2.1

Identical in content to v1.2.0 — republished as 1.2.1 for the Comfy
registry, which could not reuse the deleted 1.2.0 version number.

The spotlight grows up: buttons everywhere, a real graph traversal, and new
ways to trigger it — including one that needs no shortcut at all.

✨ New

Toggle it from anywhere

• Topbar button — a 👁 Spotlight button next to the settings group.
  It doubles as a permanent indicator: gold with a filled eye while the
  spotlight is active.
• Selection toolbox — the toggle appears in the floating bar above
  selected nodes, exactly when it is usable.
• Node right-click menu — 🔦 Spotlight links on any node (selects it
  if nothing was), plus a Link Spotlight off escape hatch in the canvas
  menu while active.
• On-canvas pill (optional) — shows the current depth/direction while
  the spotlight is on, so hidden links are never a mystery.

Smarter focus traversal

• Depth — 1, 2, 3 hops from the selection, or ∞ for the full trace
  (every ancestor/descendant).
• Direction — both ways, upstream (where the data comes from) or
  downstream (where it goes). Combine with ∞ to trace a full lineage.
• Reroutes are free — Reroute nodes are traversed as pass-throughs and
  never consume a hop.
• Groups — selecting a group spotlights every node inside it.

New spotlight behaviors

• Hidden-links override — with the canvas hide links button on,
  selecting node(s) reveals their links automatically, no shortcut needed;
  clear the selection and everything hides again (opt-out setting).
• Hover mode (opt-in) — with nothing selected, the spotlight follows
  the node under the cursor. Works in Vue nodes mode ("Nodes 2.0") too.
• Focus emphasis — optionally draw the spotlighted links thicker
  and/or with a golden glow.

Deeper dimming

• Node dimming now also covers widgets and bypassed/muted/ghost
  nodes, and groups holding nothing in focus dim with the rest.

🐛 Fixes

• Fixed an alpha-collision bug where dimming was silently skipped for
  bypassed/muted/ghost nodes at certain opacity settings (e.g. 0.2).
• Hover tracking and the activity indicator no longer depend on the front
  canvas render pipeline — they now work in every render mode, including
  the Vue nodes beta.

🔧 Internals

• Code split into side-effect-free ES modules (state / focus /
  render / topbar + entry).
• 5 new settings under Settings → LinkSpotlight; all existing setting
  ids and defaults are preserved — no migration needed.

❤️ Credits

The hidden-links override and the extended node/group dimming were
contributed by Kieran Marien
(buzzworks-be fork),
ported onto the new module layout and hardened. Thanks!

ComfyUI-LinkSpotlight v1.2.0

The spotlight grows up: buttons everywhere, a real graph traversal, and new
ways to trigger it — including one that needs no shortcut at all.

✨ New

Toggle it from anywhere

• Topbar button — a 👁 Spotlight button next to the settings group.
  It doubles as a permanent indicator: gold with a filled eye while the
  spotlight is active.
• Selection toolbox — the toggle appears in the floating bar above
  selected nodes, exactly when it is usable.
• Node right-click menu — 🔦 Spotlight links on any node (selects it
  if nothing was), plus a Link Spotlight off escape hatch in the canvas
  menu while active.
• On-canvas pill (optional) — shows the current depth/direction while
  the spotlight is on, so hidden links are never a mystery.

Smarter focus traversal

• Depth — 1, 2, 3 hops from the selection, or ∞ for the full trace
  (every ancestor/descendant).
• Direction — both ways, upstream (where the data comes from) or
  downstream (where it goes). Combine with ∞ to trace a full lineage.
• Reroutes are free — Reroute nodes are traversed as pass-throughs and
  never consume a hop.
• Groups — selecting a group spotlights every node inside it.

New spotlight behaviors

• Hidden-links override — with the canvas hide links button on,
  selecting node(s) reveals their links automatically, no shortcut needed;
  clear the selection and everything hides again (opt-out setting).
• Hover mode (opt-in) — with nothing selected, the spotlight follows
  the node under the cursor. Works in Vue nodes mode ("Nodes 2.0") too.
• Focus emphasis — optionally draw the spotlighted links thicker
  and/or with a golden glow.

Deeper dimming

• Node dimming now also covers widgets and bypassed/muted/ghost
  nodes, and groups holding nothing in focus dim with the rest.

🐛 Fixes

• Fixed an alpha-collision bug where dimming was silently skipped for
  bypassed/muted/ghost nodes at certain opacity settings (e.g. 0.2).
• Hover tracking and the activity indicator no longer depend on the front
  canvas render pipeline — they now work in every render mode, including
  the Vue nodes beta.

🔧 Internals

• Code split into side-effect-free ES modules (state / focus /
  render / topbar + entry).
• 5 new settings under Settings → LinkSpotlight; all existing setting
  ids and defaults are preserved — no migration needed.

❤️ Credits

The hidden-links override and the extended node/group dimming were
contributed by Kieran Marien
(buzzworks-be fork),
ported onto the new module layout and hardened. Thanks!

v1.0.1

ComfyUI-LinkSpotlight v1.0.1 — branding & CI maintenance

No functional changes to the extension itself — if v1.0.0 works for you,
there is nothing to hurry for.

**What's new**

- Project artwork: hero image added to the README and used as the icon on
  the Comfy Registry listing
- Assets reorganized under assets/ (images/, videos/)

**Under the hood**

- CI: registry publishing now runs on current GitHub Actions
  (actions/checkout v7, setup-python v6) instead of a composite action
  pinning deprecated Node 20 runtimes
- CI: GitHub Releases are now created automatically from annotated v* tags

**Install / update**

- ComfyUI-Manager: search for "LinkSpotlight"
- Manual: git pull inside custom_nodes/ComfyUI-LinkSpotlight

v1.0.0

ComfyUI-LinkSpotlight v1.0.0 — initial release

Alt+H spotlight for ComfyUI: hide or dim every link that doesn't touch the selected node(s), decluttering spaghetti workflows with one remappable shortcut.

**Highlights**

- Alt+H toggle — remappable in Settings → Keybinding, also available from the command palette
- Follows the selection live; multi-select shows the union of links
- Hide (default) or dim out-of-focus links with a configurable opacity
- Depth control: selected node's links only, or its direct neighbors' links too
- Optional dimming of unrelated nodes
- Auto-off when the selection is cleared (configurable)
- Zero overhead when inactive, zero dependencies, frontend-only (no Python nodes)
- Self-disables cleanly (console error) if a frontend update changes the canvas internals — never breaks the canvas

**Compatibility**

Developed and tested against comfyui-frontend-package 1.45.x (ComfyUI v0.28).

**Install**

- ComfyUI-Manager: search for "LinkSpotlight"
- Manual: clone https://github.com/Ding-sl/ComfyUI-LinkSpotlight into ComfyUI/custom_nodes