Node Editor Basics

The rules, lightshow, and sound editors are built on one shared canvas, so the core gestures are identical across all three. Learn them once here; each editor’s own page then covers only what it adds.

The canvas

Every editor is a full-viewport node canvas with a floating toolbar card over one corner. Nodes are boxes joined by wires; each node shows a category glyph, a title, and — colored by kind — its typed input and output ports.

• Pan — drag an empty part of the canvas.
• Zoom — mouse wheel (clamped to a comfortable range).
• Move a node — drag it. Moving a node only rearranges the diagram; it never changes what the node does.

Adding nodes

Editors that let you build a graph offer a palette of the available node kinds, grouped by category, plus a matching legend showing each category’s glyph and color. Click a kind to drop it on the canvas, or right-click empty canvas to add from a context menu. The palette is generated from the engine, so any node kind the engine gains appears automatically.

The palette has a filter box. Type to narrow the visible kinds, then press a digit 1–9 to add the Nth kind still showing — so “type a few letters, press 1” is usually the fastest way to place a node without reaching for the mouse. The digits act on what’s visible, so the same digit means different things before and after you filter.

In the rules editor the palette is an always-open toolbox card in the canvas’s top-left corner; the lightshow and sound editors carry theirs in their own toolbars. Either way it keeps your filter and expander state as you switch views.

Wires are type-checked: a connection only completes between compatible ports, and the drag highlights valid targets. If a wire “won’t take,” the two ports are incompatible — the editor accepts exactly the connections the engine would compile and rejects the rest.

Selecting and inspecting a node

• Click a node to select it. Selection fills the details pane — a docked, collapsible panel beside the canvas that lists the node’s fields as label → value rows (multi-value fields render as chips, and a node’s related record — its rule, channel, or patch — appears as a tinted card). The details pane is read-only: it shows facts; you edit through the forms below. Collapse it with the header toggle; the choice is remembered.
• Hover a node to pop a tooltip with its glyph, title, type, and a one-line summary.

Finding a node

Press / to open a find box and filter as you type, with a live count of how many nodes match. What a match does depends on the editor: the rules editor hides everything that doesn’t match (keeping a matched rule’s linked device and tag visible so the edges still read), while the lightshow and sound editors leave the graph intact and instead select and center the canvas on the first match.

Copying nodes

Ctrl/Cmd+C copies the selected node, Ctrl/Cmd+V pastes it into the scope you’re currently in, and Ctrl/Cmd+D duplicates in one step.

The clipboard is shared across editors and tabs — copy a node in one editor and it’s available to paste in another window, or in a different editor entirely. A paste only lands if the target editor actually has that node kind; if it doesn’t, the paste is refused with a message naming where the node came from, rather than pasting something the engine can’t compile.

The context menu

Right-click opens a menu at the cursor. What’s on it depends on where you click — a node versus empty canvas — and on the editor, but the behavior is shared: rows can be actions, submenus (marked “▸”), or headers, and the menu closes when you click away, scroll, or press Escape.

Editing values

When you run an editing or creation command, the editor opens a form dialog — a centered panel with labeled fields and Cancel / Save buttons. Forms validate on submit: a required field left empty reports “<label> is required” and blocks saving. Enter submits; Escape, the backdrop, or the ✕ cancels with no change. Destructive actions (like deleting) use a confirmation dialog with a red confirm button. Simple params on a node (numbers, sliders, toggles, dropdowns) are often editable inline on the node card; richer values (colors, palettes, asset references, expressions) open an overlay editor.

Navigating nested scopes

Some nodes encapsulate a sub-graph — for example, a synth voice in the sound editor contains its own DSP patch. Where an editor nests scopes, the navigation model is symmetric:

• Drill in — double-click the encapsulating node to descend into its inner scope; the canvas repaints to the child graph.
• Drill out — press Escape, or double-click empty canvas, to pop back up one level.
• A breadcrumb bar shows the path from the root to where you are (for example Sources › bassSynth). Click an earlier crumb to jump straight back to it.

Navigating never changes anything — drilling in and back out is lossless. Today the sound editor is the editor that uses nested scopes (to open a synth patch).

The “?” help hotspots

Some section headers carry a small circular "?" button. Click it to open the relevant documentation page in a new tab — the same pages you’re reading now.

The global status bar

Every harness page — the three node editors, the object editor, and the table view — carries a persistent status bar along the bottom:

• A Diagnostics chip on the left reads the outstanding count (and · Needs placement when devices still need a home). Click it to expand an outstanding-items dock that lists each diagnostic and page worklist; clicking a row jumps to the item that raised it. Each row is labeled on two axes — a severity glyph (▲ error, ⚠ warning, ℹ info) and a small subsystem-type chip (LIGHT, GEOM, RULES, SOUND, ENGINE, PHYSICS, or GENERAL) — so you can tell at a glance which part of the table a diagnostic comes from.
• A ✉ Feedback entry on the right opens a feedback/contact form. (You can also reach it from Settings ▸ Send feedback, and hide the chip from Settings if you prefer the menu.)

Because the bar is app-global, diagnostics stay visible no matter which editor you’re in — or even with every editor closed.

Keyboard & mouse reference

All three node editors share this set; Space to audition is the one addition the sound editor makes, and it re-fires on each press rather than repeating while you hold it.

Keyboard shortcuts never fire while you’re typing in a field, so editing text is safe — including the digits, so a number typed into the palette filter stays a number.