Classes

Import these from @grafloria/engine.

Classes

ClipboardManager

ClipboardManager handles copy/paste operations for diagram entities

Features:

• Serializes selected entities to clipboard format
• Handles relationship preservation (links between copied nodes)
• Supports cross-diagram paste (ID remapping)
• Maintains clipboard history

ts
Copy
class ClipboardManager

Methods

• copy(data: { nodes: NodeModel[]; links: LinkModel[]; groups: GroupModel[]; sourceDiagramId?: string; }): void — Copy entities to clipboard
• get(): ClipboardData | null — Get clipboard data
• claimPasteSlot(): number — Claim the next paste slot for the CURRENT clipboard payload (1-based).

Repeat-pasting the same copy must cascade — the clipboard's serialized positions are frozen at copy time, so a constant default offset lands every paste on the exact same pixels and "paste" appears to work only once (live report). Each PasteCommand claims its slot once (stable across redo); a new copy() resets the cascade.

• hasData(): boolean — Check if clipboard has data
• clear(): void — Clear clipboard
• getHistory(): ClipboardData[] — Get clipboard history
• isFromDiagram(diagramId: string): boolean — Check if clipboard contains nodes from a specific diagram
• getStats(): { nodeCount: number; linkCount: number; groupCount: number; timestamp: number | null; } — Get clipboard statistics

EventBus

ts
Copy
class EventBus

Methods

• constructor()
• emit(event: string, data?: any): void — Emit an event
• on(pattern: string, handler: Function): () => void — Subscribe to events
• once(pattern: string, handler: Function): void — Subscribe once
• off(pattern: string, handler: Function): void — Unsubscribe from events
• removeAllListeners(pattern?: string): void — Remove all listeners
• onFiltered( event: string, filter: (data: any) => boolean, handler: Function ): () => void — Filtered subscription
• onMapped<T, R>( event: string, mapper: (data: T) => R, handler: (data: R) => void ): () => void — Mapped subscription
• onDebounced( event: string, delay: number, handler: Function ): () => void — Debounced subscription
• onThrottled( event: string, delay: number, handler: Function ): () => void — Throttled subscription
• batch(fn: () => void): void — Batch events
• suspend(): void — Suspend event emission
• resume(): void — Resume event emission
• startRecording(): void — Start recording events
• stopRecording(): EventLogEntry[] — Stop recording
• getEventLog(): ReadonlyArray<EventLogEntry> — Get event log
• clearEventLog(): void — Clear event log
• replay(events: EventLogEntry[]): void — Replay events
• listenerCount(event: string): number — Get listener count
• eventNames(): string[] — Get all event names

GridLayoutAlgorithm

Also has every member of BaseLayoutAlgorithm, listed on its own entry.

ts
Copy
class GridLayoutAlgorithm extends BaseLayoutAlgorithm

Methods

• constructor(config?: LayoutConfiguration)
• getName(): string — Get the name of the layout algorithm
• getType(): 'grid' — Get the type of the layout algorithm
• calculatePlacement(options: PlacementOptions): PlacementResult — Calculate placement for a single new node
• reLayout(diagram: DiagramModel, config?: LayoutConfiguration): Map<string, Point> — Re-layout all nodes in grid pattern
• override configure(config: LayoutConfiguration): void — Configure grid-specific options
• override canApply(diagram: DiagramModel): { valid: boolean; reason?: string } — Grid layout can always be applied

HierarchicalLayoutAlgorithm

Also has every member of BaseLayoutAlgorithm, listed on its own entry.

ts
Copy
class HierarchicalLayoutAlgorithm extends BaseLayoutAlgorithm

Methods

• constructor(config?: LayoutConfiguration)
• getName(): string — Get the name of the layout algorithm
• getType(): 'hierarchical' — Get the type of the layout algorithm
• calculatePlacement(options: PlacementOptions): PlacementResult — Calculate placement for a single new node For hierarchical layout, we'll place it near connected nodes
• reLayout(diagram: DiagramModel, config?: LayoutConfiguration): Map<string, Point> — Re-layout all nodes using Dagre
• override configure(config: LayoutConfiguration): void — Configure hierarchical-specific options
• override canApply(diagram: DiagramModel): { valid: boolean; reason?: string } — Hierarchical layout works best on DAGs but can handle any graph

HtmlTemplateRenderer

HTML Template Renderer Framework-agnostic HTML template rendering with EventBus integration

Features:

• LemonadeJS template rendering
• Data binding from NodeModel.data
• Event handlers connected to EventBus
• Component mode support (pass-through for framework-specific rendering)
• Proper resource cleanup to prevent memory leaks

ts
Copy
class HtmlTemplateRenderer

Methods

• constructor(private eventBus: EventBus)
• render(config: HtmlConfig, node: NodeModel): RenderResult — Render HTML configuration to result
• disposeNode(nodeUuid: string): void — Dispose resources for a specific node
• dispose(): void — Cleanup all renderer resources

LemonadeJSRenderer

LemonadeJS Enhanced Renderer Full LemonadeJS runtime with two-way binding

Features:

• Real LemonadeJS template rendering
• Two-way data binding (
  )
• Reactive updates (automatic re-rendering on data changes)
• Event handlers (
  ,
  , etc.)
• EventBus integration (all events flow through engine)
• Component mode support

ts
Copy
class LemonadeJSRenderer

Methods

• constructor(private eventBus: EventBus)
• render(config: HtmlConfig, node: NodeModel): LemonadeRenderResult — Render HTML configuration to LemonadeJS element
• disposeNode(nodeUuid: string): void — Dispose resources for a specific node
• dispose(): void — Cleanup all renderer resources

MobilePerformanceService

ts
Copy
class MobilePerformanceService

Methods

• static isMobileDevice(): boolean (static) — Detect if running on mobile device
• static isLowPowerDevice(): boolean (static) — Detect if low-power device
• initialize(customConfig?: Partial<MobilePerformanceConfig>) — Initialize with auto-detection
• throttle<T extends (...args: any[]) => any>( key: string, fn: T, wait: number = this.config.touchMoveThrottle ): (...args: Parameters<T>) => void — Throttle function execution
• getRenderQuality(): 'high' | 'medium' | 'low' — Get recommended render quality based on device
• shouldSkipRender(nodeCount: number): boolean — Should skip rendering based on performance config
• getConfig(): MobilePerformanceConfig — Get configuration
• updateConfig(config: Partial<MobilePerformanceConfig>) — Update configuration

PerformanceMonitor

ts
Copy
class PerformanceMonitor

Methods

• constructor(config: PerformanceConfig = {})
• measure<T>(name: string, fn: () => T | Promise<T>): T | Promise<T> — Measure operation performance
• setWarnThreshold(threshold: number): void — Set warning threshold
• getReport(): PerformanceReport — Get performance report
• clear(): void — Clear all metrics

PluginManager

ts
Copy
class PluginManager

Methods

• constructor( engine: any, eventBus: any, config: PluginManagerConfig = {} )
• register(plugin: Plugin, config: Record<string, any> = {}): void — Register a plugin (without installing)
• async install(pluginName: string): Promise<void> — Install a plugin
• async uninstall(pluginName: string): Promise<void> — Uninstall a plugin
• async activate(pluginName: string): Promise<void> — Activate a plugin
• async deactivate(pluginName: string): Promise<void> — Deactivate a plugin
• get(pluginName: string): Plugin | undefined — Get plugin by name
• has(pluginName: string): boolean — Check if plugin is registered
• isInstalled(pluginName: string): boolean — Check if plugin is installed
• isActive(pluginName: string): boolean — Check if plugin is active
• getState(pluginName: string): PluginState | undefined — Get plugin state
• list(): PluginMetadata[] — List all registered plugins
• listInstalled(): PluginMetadata[] — List installed plugins
• listActive(): PluginMetadata[] — List active plugins
• async unregister(pluginName: string): Promise<void> — Unregister a plugin (removes from registry)
• async installAll(): Promise<void> — Install all registered plugins
• async uninstallAll(): Promise<void> — Uninstall all plugins
• async clear(): Promise<void> — Clear all plugins (uninstall and unregister)