Interface NodeRouting

NodeRouting — the routing trait's registry. Each trait of a node (shape, routing, label, icon, affordances, …) is its own registry; this one answers "what routing-kind string does this node's data map to?" The result flows into declarative tool-routing tables ({ target: 'rect', actionId: 'move' }).

Other traits (shape painters, future label/icon/propertyRows registries) are their own registries — they are NOT optional fields on NodeRoutingEntry. See: docs/superpowers/specs/2026-05-24-node-traits-reframe-design.md.

Instances are constructed by <SceneCanvas> from its routing prop and used to classify each hit node's data into a kind string when building getNodeAtPoint. Direct use from consumer code is supported but not required for the common SceneCanvas flow.

interface NodeRouting {
    classify(data: unknown): string;
    get(name: string): NodeRoutingEntry | undefined;
    list(): readonly NodeRoutingEntry[];
    register(kind: NodeRoutingEntry): void;
}

Index

Methods

classify get list register

Methods

classify

classify(data: unknown): string
Walk registered kinds in registration order; return the first kind whose matches(data) returns true, or 'unknown' if none match.
Parameters
- data: unknown
Returns string
- Defined in packages/core/src/core/scene/NodeRouting.ts:42

get

get(name: string): NodeRoutingEntry | undefined
Lookup a kind entry by name.
Parameters
- name: string
Returns NodeRoutingEntry | undefined
- Defined in packages/core/src/core/scene/NodeRouting.ts:44

list

list(): readonly NodeRoutingEntry[]
Enumerate registered kinds in registration order.

Returns readonly NodeRoutingEntry[]
- Defined in packages/core/src/core/scene/NodeRouting.ts:46

register

register(kind: NodeRoutingEntry): void
Register a kind. Order matters: first match wins during classify. Throws if a kind with this name is already registered.
Parameters
- kind: NodeRoutingEntry
Returns void
- Defined in packages/core/src/core/scene/NodeRouting.ts:39

Interface NodeRouting

Index

Methods

Methods

classify

Parameters

Returns string

get

Parameters

Returns NodeRoutingEntry | undefined

list

Returns readonly NodeRoutingEntry[]

register

Parameters

Returns void

Settings

On This Page