NodeUI

LogNode ​

A real-time event log node that subscribes to the global event bus and displays every event as it fires. LogNode is the primary debugging tool in NodeUI.

Key Features ​

  • Wildcard event subscription -- captures every event published on the global event bus
  • Real-time display -- events appear instantly with auto-scroll to the latest entry
  • Structured output -- each log entry shows the event name in brackets followed by a JSON-serialized payload
  • Circular reference handling -- safely serializes objects with circular structures
  • Clipboard monitoring -- listens to clipboard:changed events for copy/paste debugging
  • Editable log -- double-click the log container to select and copy text
  • Terminal icon in the title bar to distinguish from other node types

Configuration Options ​

OptionTypeDefaultDescription
widthnumber400Width in pixels
heightnumber300Height in pixels
titlestring'Event Log'Display title in the title bar
colorstring'default'Color theme variant

Usage ​

Viewing Events ​

Add a LogNode to the canvas. It immediately begins capturing events. Each entry appears as:

[event:name] { "key": "value" }

The log auto-scrolls to keep the most recent events visible.

Selecting and Copying Log Text ​

Double-click the log container to enter editable mode. You can then select text and copy it. Press Escape or click outside to exit editable mode.

Event Types You Will See ​

LogNode captures all events on the bus, including but not limited to:

  • node:update -- when any node property changes
  • node:visual-update -- when a node's visual state changes (resize, color)
  • graph:save / graph:load-content -- graph serialization events
  • setting:update -- when a setting value changes
  • clipboard:changed -- when the clipboard contents change
  • log:info -- informational messages (displayed without JSON payload)

Cleanup ​

LogNode properly unsubscribes from the event bus when destroyed, preventing memory leaks.

TIP

Add a LogNode early in your workflow to understand how events flow through the system. It is invaluable for debugging edge connections, node updates, and custom interactions.