Node Library

Node palette: fuzzy search, categories, favorites, drag onto the canvas. Pro · Image generation › Node graph

Searchable palette of node types: fuzzy search, socket type filter, favorites, recents and a category tree. Rows drag onto a NodeCanvas or add a node with Enter.

Installation

npx valyro-cli@latest login
npx valyro-cli@latest add node-library

npm install valyro-ui-pro

import 'valyro-ui-pro/styles.css';
import { NodeLibrary } from 'valyro-ui-pro';

Props

Prop	Type	Default
`types` *	`readonly NodeTypeDef[]`		Node type registry.
`onAdd`	`(def: NodeTypeDef) => void`		Click or Enter on a node type, e.g. `(def) => editor.addNode(def.type)`.
`favorites`	`readonly string[]`		Starred node type keys.
`defaultFavorites`	`readonly string[]`	`[]`	Initial `favorites` when uncontrolled.
`onFavoritesChange`	`(types: readonly string[]) => void`		Called with the new `favorites` when it changes.
`recents`	`readonly string[]`		Recently added node type keys, newest first; updated on add and on drop.
`defaultRecents`	`readonly string[]`	`[]`	Initial `recents` when uncontrolled.
`onRecentsChange`	`(types: readonly string[]) => void`		Called with the new `recents` when it changes.
`maxRecents`	`number`	`5`	Most node types kept in `recents`. @default 5
`query`	`string`		Controlled `query`; use with `onQueryChange`.
`defaultQuery`	`string`	`''`	Initial `query` when uncontrolled.
`onQueryChange`	`(query: string) => void`		Called with the new `query` when it changes.
`portType`	`string`		Only node types with a socket of this type; `''` shows all.
`defaultPortType`	`string`	`''`	Initial `portType` when uncontrolled.
`onPortTypeChange`	`(type: string) => void`		Called with the new `portType` when it changes.
`portTypes`	`PortTypeStyles`		Colours of socket types, as on the canvas.
`defaultCollapsed`	`readonly string[]`	`[]`	Category paths collapsed at first.
`draggable`	`boolean`	`true`	Rows can be dragged onto a NodeCanvas. @default true
`labels`	`Partial<NodeLibraryLabels>`		Overrides for the built-in English text; keys left out keep their defaults.

Related components

Node Canvas — Infinite node canvas: typed ports, links, groups, minimap, graph execution
Node Inspector — Selected node properties: title, color, mode, parameters, ports
Execution Queue — Run queue and history: progress, ETA, previews, cancel and retry
Prompt Editor — Prompt and negative prompt: weights, LoRA, autocomplete, token count
Generation Settings — Model, sampler, steps, CFG, size, presets
Aspect Ratio Picker — Aspect ratio and exact size
Seed Input — Seed: random, fixed, increment
LoRA Stack — LoRA stack: strengths, toggles, order, trigger words
Style Presets — Style cards with previews and weights
Reference Image Input — Reference image for img2img and ControlNet
Generation Progress — Steps, ETA, live latent preview, queue
Image Result Grid — Result gallery with actions and a lightbox

Previous: Node Canvas · Next: Node Inspector · All Image generation