@lumeo-ui/mcp-server 5.10.5 → 5.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "$schema": "https://lumeo.nativ.sh/components-api-schema.json",
3
- "version": "5.10.5",
4
- "generated": "2026-09-23T18:24:53.4789995Z",
3
+ "version": "5.11.0",
4
+ "generated": "2026-09-24T15:21:55.6856657Z",
5
5
  "stats": {
6
- "componentCount": 168,
7
- "totalParameters": 4895,
8
- "totalEnums": 104,
9
- "totalRecords": 65,
6
+ "componentCount": 169,
7
+ "totalParameters": 5015,
8
+ "totalEnums": 113,
9
+ "totalRecords": 66,
10
10
  "serviceCount": 33,
11
11
  "thinFallbacks": []
12
12
  },
@@ -323,6 +323,30 @@
323
323
  }
324
324
  ]
325
325
  },
326
+ {
327
+ "title": "AI Agent Tree",
328
+ "route": "/blocks/flow-agent-tree",
329
+ "description": "An orchestrator/sub-agent tree on FlowCanvas: named branch labels, inline “+ add tool” buttons on leaf nodes, dashed edges out to the model and its attachments, and a Tidy button that recomputes the whole layout.",
330
+ "examples": []
331
+ },
332
+ {
333
+ "title": "Automation Workflow",
334
+ "route": "/blocks/flow-automation",
335
+ "description": "An order-fulfillment automation builder on FlowCanvas: step cards with an owner, a duration and a run-status badge, a Yes/No condition branch, a toolbar and right-click menu on every node, and an inspector that edits the selected step.",
336
+ "examples": []
337
+ },
338
+ {
339
+ "title": "Growth Impact Map",
340
+ "route": "/blocks/flow-impact-map",
341
+ "description": "Initiatives feeding metrics feeding a north star on FlowCanvas: edge labels carry each correlation score, nodes are colored by initiative category on both the cards and the minimap, and the inspector shows the selected initiative's metric impact.",
342
+ "examples": []
343
+ },
344
+ {
345
+ "title": "Data Pipeline",
346
+ "route": "/blocks/flow-pipeline",
347
+ "description": "A dependency-ordered data pipeline on FlowCanvas: approval gates that cannot be deleted, a Replay-from-here action that animates the run forward stage by stage, and cycle prevention on every new connection.",
348
+ "examples": []
349
+ },
326
350
  {
327
351
  "title": "Multi-Step Form Wizard",
328
352
  "route": "/blocks/form-wizard",
@@ -1212,6 +1236,24 @@
1212
1236
  "signature": "AutoFitColumn(string handleId)",
1213
1237
  "summary": null
1214
1238
  },
1239
+ {
1240
+ "name": "MeasureColumnContentWidth",
1241
+ "returnType": "ValueTask<double>",
1242
+ "signature": "MeasureColumnContentWidth(string gridId, string columnId)",
1243
+ "summary": null
1244
+ },
1245
+ {
1246
+ "name": "RegisterOverlayScrollbar",
1247
+ "returnType": "ValueTask",
1248
+ "signature": "RegisterOverlayScrollbar(string viewportId)",
1249
+ "summary": null
1250
+ },
1251
+ {
1252
+ "name": "UnregisterOverlayScrollbar",
1253
+ "returnType": "ValueTask",
1254
+ "signature": "UnregisterOverlayScrollbar(string viewportId)",
1255
+ "summary": null
1256
+ },
1215
1257
  {
1216
1258
  "name": "RegisterFilterDrag",
1217
1259
  "returnType": "ValueTask",
@@ -1806,6 +1848,48 @@
1806
1848
  "signature": "GanttV3ScrollToOffsetAsync(Microsoft.AspNetCore.Components.ElementReference el, double targetX, double offsetPx)",
1807
1849
  "summary": null
1808
1850
  },
1851
+ {
1852
+ "name": "FlowRegisterCanvasAsync",
1853
+ "returnType": "Task",
1854
+ "signature": "FlowRegisterCanvasAsync<[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods)] T>(Microsoft.AspNetCore.Components.ElementReference paneEl, DotNetObjectReference<T> dotNetRef, object options)",
1855
+ "summary": null
1856
+ },
1857
+ {
1858
+ "name": "FlowUnregisterCanvasAsync",
1859
+ "returnType": "Task",
1860
+ "signature": "FlowUnregisterCanvasAsync(Microsoft.AspNetCore.Components.ElementReference paneEl)",
1861
+ "summary": null
1862
+ },
1863
+ {
1864
+ "name": "FlowUpdateOptionsAsync",
1865
+ "returnType": "Task",
1866
+ "signature": "FlowUpdateOptionsAsync(Microsoft.AspNetCore.Components.ElementReference paneEl, object options)",
1867
+ "summary": null
1868
+ },
1869
+ {
1870
+ "name": "FlowFitViewAsync",
1871
+ "returnType": "Task",
1872
+ "signature": "FlowFitViewAsync(Microsoft.AspNetCore.Components.ElementReference paneEl, double padding, double minZoom, double maxZoom)",
1873
+ "summary": null
1874
+ },
1875
+ {
1876
+ "name": "FlowGetViewportAsync",
1877
+ "returnType": "Task<double[]?>",
1878
+ "signature": "FlowGetViewportAsync(Microsoft.AspNetCore.Components.ElementReference paneEl)",
1879
+ "summary": null
1880
+ },
1881
+ {
1882
+ "name": "FlowIsFocusedElementEditableAsync",
1883
+ "returnType": "Task<bool>",
1884
+ "signature": "FlowIsFocusedElementEditableAsync(Microsoft.AspNetCore.Components.ElementReference paneEl)",
1885
+ "summary": null
1886
+ },
1887
+ {
1888
+ "name": "FlowExportPngAsync",
1889
+ "returnType": "Task<string?>",
1890
+ "signature": "FlowExportPngAsync(Microsoft.AspNetCore.Components.ElementReference paneEl, double scale)",
1891
+ "summary": null
1892
+ },
1809
1893
  {
1810
1894
  "name": "SchedulerViewsGetLocalDateAsync",
1811
1895
  "returnType": "Task<string?>",
@@ -2750,6 +2834,24 @@
2750
2834
  "signature": "AutoFitColumn(string handleId)",
2751
2835
  "summary": "Fits a resizable column to its content, exactly as a double-click on its resize handle does (the width commits through the registered handler). Returns false when no resize handle is registered for handleId. Additive DIM."
2752
2836
  },
2837
+ {
2838
+ "name": "MeasureColumnContentWidth",
2839
+ "returnType": "ValueTask<double>",
2840
+ "signature": "MeasureColumnContentWidth(string gridId, string columnId)",
2841
+ "summary": "Measures a DataGrid column's natural content width (header + the currently rendered body cells — under virtualization, just the rendered window) by column id, looked up directly in the DOM rather than through a resize-handle registration. Backs DataGrid.AutoSizeColumnAsync/AutoSizeAllColumnsAsync (issue #519). Returns 0 when the column can't be measured (unknown id, grid not mounted, off-browser test host). Additive DIM."
2842
+ },
2843
+ {
2844
+ "name": "RegisterOverlayScrollbar",
2845
+ "returnType": "ValueTask",
2846
+ "signature": "RegisterOverlayScrollbar(string viewportId)",
2847
+ "summary": "Hides the native scrollbar on viewportId (DataGrid's own scroll container) and draws JS-driven overlay thumbs (both axes, position:fixed, synced to scroll/resize, draggable) on top — reserving no layout space. See DataGrid.OverlayScrollbar (issue #517). Additive DIM."
2848
+ },
2849
+ {
2850
+ "name": "UnregisterOverlayScrollbar",
2851
+ "returnType": "ValueTask",
2852
+ "signature": "UnregisterOverlayScrollbar(string viewportId)",
2853
+ "summary": "Tears down the overlay scrollbar registered by RegisterOverlayScrollbar. Additive DIM."
2854
+ },
2753
2855
  {
2754
2856
  "name": "RegisterFilterDrag",
2755
2857
  "returnType": "ValueTask",
@@ -3296,6 +3398,48 @@
3296
3398
  "signature": "GanttV3ScrollToOffsetAsync(Microsoft.AspNetCore.Components.ElementReference el, double targetX, double offsetPx)",
3297
3399
  "summary": "Companion to GanttV3ScrollToXAsync — places targetX (the same timeline-origin-relative pixel space) at offsetPx pixels from el's own viewport left edge, instead of GanttV3ScrollToXAsync's hardcoded viewport-CENTER placement. The one caller is wheel-zoom's own pointer-anchored recenter (GanttTimeline.ScrollTargetOffsetOverride) — every other recenter in GanttV3 genuinely wants the target centered, so this is a NEW, separate write path rather than a GanttV3ScrollToXAsync overload, keeping that method's own existing behavior/E2E assertions untouched. Default no-op DIM so existing implementers/test doubles keep compiling."
3298
3400
  },
3401
+ {
3402
+ "name": "FlowRegisterCanvasAsync",
3403
+ "returnType": "Task",
3404
+ "signature": "FlowRegisterCanvasAsync<[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods)] T>(Microsoft.AspNetCore.Components.ElementReference paneEl, DotNetObjectReference<T> dotNetRef, object options)",
3405
+ "summary": "Registers the FlowCanvas engine (flow.js flow.registerCanvas) on paneEl — the canvas' [data-slot=\"flow-pane\"] element. One delegated pointer/wheel/keyboard listener set covers every node underneath, a ResizeObserver measures nodes, and a MutationObserver applies the data-flow-viewport stamp .NET renders for every .NET-originated viewport change. Calling this again for an already-registered paneEl swaps the stored dotNetRef/options in place (idempotent, no second listener set). Generic in the .NET reference type so this core interface stays decoupled from the satellite component. Default no-op DIM so existing implementers/test doubles keep compiling."
3406
+ },
3407
+ {
3408
+ "name": "FlowUnregisterCanvasAsync",
3409
+ "returnType": "Task",
3410
+ "signature": "FlowUnregisterCanvasAsync(Microsoft.AspNetCore.Components.ElementReference paneEl)",
3411
+ "summary": "Tears down the engine registered by FlowRegisterCanvasAsync{T} — removes every listener and observer and cancels (never commits) a gesture in flight. Default no-op."
3412
+ },
3413
+ {
3414
+ "name": "FlowUpdateOptionsAsync",
3415
+ "returnType": "Task",
3416
+ "signature": "FlowUpdateOptionsAsync(Microsoft.AspNetCore.Components.ElementReference paneEl, object options)",
3417
+ "summary": "Pushes a new options bag (zoom limits, snapping, drag/pan/zoom switches) to a registered canvas. A gesture already in flight keeps the snapshot it started with. Default no-op."
3418
+ },
3419
+ {
3420
+ "name": "FlowFitViewAsync",
3421
+ "returnType": "Task",
3422
+ "signature": "FlowFitViewAsync(Microsoft.AspNetCore.Components.ElementReference paneEl, double padding, double minZoom, double maxZoom)",
3423
+ "summary": "Fits every rendered node into the pane, measuring the nodes from the DOM (flow.js flow.fitView) — used when .NET does not know every node's size yet. The engine applies the viewport itself and reports it back like any other viewport change. Default no-op."
3424
+ },
3425
+ {
3426
+ "name": "FlowGetViewportAsync",
3427
+ "returnType": "Task<double[]?>",
3428
+ "signature": "FlowGetViewportAsync(Microsoft.AspNetCore.Components.ElementReference paneEl)",
3429
+ "summary": "The engine's live viewport as [x, y, zoom], or null when the engine is unavailable. Default null."
3430
+ },
3431
+ {
3432
+ "name": "FlowIsFocusedElementEditableAsync",
3433
+ "returnType": "Task<bool>",
3434
+ "signature": "FlowIsFocusedElementEditableAsync(Microsoft.AspNetCore.Components.ElementReference paneEl)",
3435
+ "summary": "Whether document.activeElement, scoped to this pane, is an editable field (input, textarea, select, contenteditable) or inside a data-flow-nodrag region — what FlowCanvas's own keydown handlers (undo/redo, delete, arrow-nudge) check before acting, since KeyboardEventArgs carries no target of its own. Default false (assume not editable, so the shortcuts keep working without a registered engine)."
3436
+ },
3437
+ {
3438
+ "name": "FlowExportPngAsync",
3439
+ "returnType": "Task<string?>",
3440
+ "signature": "FlowExportPngAsync(Microsoft.AspNetCore.Components.ElementReference paneEl, double scale)",
3441
+ "summary": "Phase 4 best-effort raster export: rasterizes every [data-flow-node] element under paneEl (computed styles inlined, drawn through an SVG &lt;foreignObject&gt; onto a &lt;canvas&gt;) at scale× and returns a data:image/png URL, or null on any failure (no registered canvas, no nodes, a tainted canvas from a cross-origin image/font in a node template) — never throws. Default null."
3442
+ },
3299
3443
  {
3300
3444
  "name": "SchedulerViewsGetLocalDateAsync",
3301
3445
  "returnType": "Task<string?>",
@@ -23607,6 +23751,15 @@
23607
23751
  "captureUnmatched": false,
23608
23752
  "isEditorRequired": false
23609
23753
  },
23754
+ {
23755
+ "name": "MaxHeight",
23756
+ "type": "string?",
23757
+ "default": null,
23758
+ "description": "Overrides the panel's built-in scroll cap on its inner item viewport (a CSS length, e.g. \"20rem\" or \"400px\"). By default the viewport caps itself to the available viewport space below the open point — --lumeo-dropdown-available-height, set live by the positioning JS — and scrolls past that.",
23759
+ "isCascading": false,
23760
+ "captureUnmatched": false,
23761
+ "isEditorRequired": false
23762
+ },
23610
23763
  {
23611
23764
  "name": "Class",
23612
23765
  "type": "string?",
@@ -24518,6 +24671,15 @@
24518
24671
  "captureUnmatched": false,
24519
24672
  "isEditorRequired": false
24520
24673
  },
24674
+ {
24675
+ "name": "OverlayScrollbar",
24676
+ "type": "bool",
24677
+ "default": "false",
24678
+ "description": "Hides the native scrollbar on the grid's own scroll container and draws thin, JS-driven overlay scrollbars on top (both axes) instead — reserving no layout space, matching Lumeo's theme, appearing on hover/scroll, with draggable thumbs. Native scrolling (wheel, trackpad, touch, and keyboard via a focused cell) is unaffected; only the visual bar changes. RTL-safe. prefers-reduced-motion disables the show/hide fade. Default false (unchanged native scrollbar) — field report DocFlow D4 / issue #517. Does not interact with virtualization, the sticky header, pinned columns, the resize guideline or column reorder: the thumbs are drawn entirely outside the grid's own DOM, synced to its scroll container's live rect (like the header popovers' PositionFixed).",
24679
+ "isCascading": false,
24680
+ "captureUnmatched": false,
24681
+ "isEditorRequired": false
24682
+ },
24521
24683
  {
24522
24684
  "name": "Compact",
24523
24685
  "type": "bool",
@@ -24680,6 +24842,15 @@
24680
24842
  "captureUnmatched": false,
24681
24843
  "isEditorRequired": false
24682
24844
  },
24845
+ {
24846
+ "name": "ColumnSizing",
24847
+ "type": "DataGridColumnSizing",
24848
+ "default": "DataGridColumnSizing.Auto",
24849
+ "description": "How the grid lays out column widths. Default Auto (the historic table-layout: fixed behaviour). Set FitWithMinimum so columns — in particular a FillWidth column — fill the available width when there's room and never shrink below their own MinWidth; once the visible columns' combined floor exceeds the container, the grid scrolls horizontally instead of squeezing a column to nothing (DocFlow field report §1.12).",
24850
+ "isCascading": false,
24851
+ "captureUnmatched": false,
24852
+ "isEditorRequired": false
24853
+ },
24683
24854
  {
24684
24855
  "name": "ColumnMenu",
24685
24856
  "type": "bool",
@@ -25380,6 +25551,14 @@
25380
25551
  ],
25381
25552
  "description": null
25382
25553
  },
25554
+ {
25555
+ "name": "DataGridColumnSizing",
25556
+ "values": [
25557
+ "Auto",
25558
+ "FitWithMinimum"
25559
+ ],
25560
+ "description": "How the grid lays out column widths. See DataGrid.ColumnSizing."
25561
+ },
25383
25562
  {
25384
25563
  "name": "DataGridEditMode",
25385
25564
  "values": [
@@ -26227,6 +26406,15 @@
26227
26406
  "captureUnmatched": false,
26228
26407
  "isEditorRequired": false
26229
26408
  },
26409
+ {
26410
+ "name": "OnAutoSizeAllColumns",
26411
+ "type": "EventCallback",
26412
+ "default": null,
26413
+ "description": "Fires when the \"Autosize all columns\" entry is picked. The entry is only rendered when this has a delegate, so a caller that doesn't wire it up (or an older consumer using this component directly) sees no visual change.",
26414
+ "isCascading": false,
26415
+ "captureUnmatched": false,
26416
+ "isEditorRequired": false
26417
+ },
26230
26418
  {
26231
26419
  "name": "Class",
26232
26420
  "type": "string?",
@@ -26261,6 +26449,11 @@
26261
26449
  "name": "OnColumnPin",
26262
26450
  "type": "EventCallback<ColumnPinEventArgs>",
26263
26451
  "description": "Fires when a column's pin state is changed via its pin menu (Left/Right/Unpin), carrying the column id and the new PinDirection."
26452
+ },
26453
+ {
26454
+ "name": "OnAutoSizeAllColumns",
26455
+ "type": "EventCallback",
26456
+ "description": "Fires when the \"Autosize all columns\" entry is picked. The entry is only rendered when this has a delegate, so a caller that doesn't wire it up (or an older consumer using this component directly) sees no visual change."
26264
26457
  }
26265
26458
  ],
26266
26459
  "enums": [],
@@ -31588,6 +31781,15 @@
31588
31781
  "captureUnmatched": false,
31589
31782
  "isEditorRequired": false
31590
31783
  },
31784
+ {
31785
+ "name": "MaxHeight",
31786
+ "type": "string?",
31787
+ "default": null,
31788
+ "description": "Overrides the panel's built-in scroll cap on its inner item viewport (a CSS length, e.g. \"20rem\" or \"400px\"). By default the viewport caps itself to the available viewport space in the placement direction — --lumeo-dropdown-available-height, set live by the positioning JS (Radix's --radix-dropdown-menu-content-available-height parity) — and scrolls past that. Setting this replaces that live value with a fixed cap; the panel still scrolls once content exceeds it.",
31789
+ "isCascading": false,
31790
+ "captureUnmatched": false,
31791
+ "isEditorRequired": false
31792
+ },
31591
31793
  {
31592
31794
  "name": "Class",
31593
31795
  "type": "string?",
@@ -36306,33 +36508,115 @@
36306
36508
  "parseFailed": false,
36307
36509
  "parseError": null
36308
36510
  },
36309
- "Form": {
36310
- "name": "Form",
36311
- "category": "Forms",
36312
- "subcategory": "Form Composition",
36313
- "description": "EditForm wrapper with styled validation, field groups, and submit state.",
36314
- "nugetPackage": "Lumeo",
36511
+ "FlowCanvas": {
36512
+ "name": "FlowCanvas",
36513
+ "category": "Data Display",
36514
+ "subcategory": null,
36515
+ "description": "Node/flow editor canvas — templated nodes, SVG edges, pan, pointer-anchored wheel zoom, node drag with snapping, background grid and zoom controls.",
36516
+ "nugetPackage": "Lumeo.Flow",
36315
36517
  "files": [
36316
- "UI/Form/DataAnnotationsFormValidator.cs",
36317
- "UI/Form/Form.razor",
36318
- "UI/Form/Form.razor.cs",
36319
- "UI/Form/FormContext.cs",
36320
- "UI/Form/FormDescription.razor",
36321
- "UI/Form/FormField.razor",
36322
- "UI/Form/FormItem.razor",
36323
- "UI/Form/FormLabel.razor",
36324
- "UI/Form/FormMessage.razor",
36325
- "UI/Form/IFormValidator.cs"
36518
+ "UI/FlowCanvas/FlowBackground.razor",
36519
+ "UI/FlowCanvas/FlowCanvas.razor",
36520
+ "UI/FlowCanvas/FlowControls.razor",
36521
+ "UI/FlowCanvas/FlowEdgeLayer.razor",
36522
+ "UI/FlowCanvas/FlowGeometry.cs",
36523
+ "UI/FlowCanvas/FlowGroupNode.razor",
36524
+ "UI/FlowCanvas/FlowHandle.razor",
36525
+ "UI/FlowCanvas/FlowHierarchy.cs",
36526
+ "UI/FlowCanvas/FlowHistory.cs",
36527
+ "UI/FlowCanvas/FlowLayout.cs",
36528
+ "UI/FlowCanvas/FlowMiniMap.razor",
36529
+ "UI/FlowCanvas/FlowNodeHost.razor",
36530
+ "UI/FlowCanvas/FlowNodeResizer.razor",
36531
+ "UI/FlowCanvas/FlowNodeToolbar.razor",
36532
+ "UI/FlowCanvas/FlowPanel.razor",
36533
+ "UI/FlowCanvas/FlowState.cs",
36534
+ "UI/FlowCanvas/FlowTypes.cs",
36535
+ "UI/FlowCanvas/FlowVirtualization.cs"
36326
36536
  ],
36327
36537
  "namespace": "Lumeo",
36328
36538
  "inheritsFrom": null,
36329
- "implements": [],
36539
+ "implements": [
36540
+ "IAsyncDisposable"
36541
+ ],
36330
36542
  "parameters": [
36331
36543
  {
36332
- "name": "Model",
36333
- "type": "TModel?",
36544
+ "name": "Nodes",
36545
+ "type": "IReadOnlyList<FlowNode>?",
36334
36546
  "default": null,
36335
- "description": "The form's data model. A JSON snapshot is captured on init (and re-captured whenever a new instance is bound) so ResetValues can restore it later.",
36547
+ "description": "The nodes to render. Two-way bindable (@bind-Nodes): every committed drag or keyboard move emits a new list through NodesChanged. Without a binding the canvas keeps its own copy until you pass a different list.",
36548
+ "isCascading": false,
36549
+ "captureUnmatched": false,
36550
+ "isEditorRequired": false
36551
+ },
36552
+ {
36553
+ "name": "NodesChanged",
36554
+ "type": "EventCallback<IReadOnlyList<FlowNode>>",
36555
+ "default": null,
36556
+ "description": "Raised with the new node list after a committed drag or keyboard move.",
36557
+ "isCascading": false,
36558
+ "captureUnmatched": false,
36559
+ "isEditorRequired": false
36560
+ },
36561
+ {
36562
+ "name": "Edges",
36563
+ "type": "IReadOnlyList<FlowEdge>?",
36564
+ "default": null,
36565
+ "description": "The edges to draw between nodes. Edges whose source or target node is missing are skipped. Two-way bindable (@@bind-Edges): a committed connect or delete emits a new list through EdgesChanged. Without a binding the canvas keeps its own copy until you pass a different list — the same echo/replace rule Nodes follows.",
36566
+ "isCascading": false,
36567
+ "captureUnmatched": false,
36568
+ "isEditorRequired": false
36569
+ },
36570
+ {
36571
+ "name": "EdgesChanged",
36572
+ "type": "EventCallback<IReadOnlyList<FlowEdge>>",
36573
+ "default": null,
36574
+ "description": "Raised with the new edge list after a committed connect (when OnConnect has no handler) or a delete that removed edges.",
36575
+ "isCascading": false,
36576
+ "captureUnmatched": false,
36577
+ "isEditorRequired": false
36578
+ },
36579
+ {
36580
+ "name": "Viewport",
36581
+ "type": "FlowViewport",
36582
+ "default": "new(0, 0, 1)",
36583
+ "description": "The pan/zoom state. Two-way bindable (@bind-Viewport). Setting a new value moves the canvas; the canvas reports user pans and zooms back through ViewportChanged. A zoom of 0 or less means \"not set\" (the canvas starts at 0,0 and 100%).",
36584
+ "isCascading": false,
36585
+ "captureUnmatched": false,
36586
+ "isEditorRequired": false
36587
+ },
36588
+ {
36589
+ "name": "ViewportChanged",
36590
+ "type": "EventCallback<FlowViewport>",
36591
+ "default": null,
36592
+ "description": "Raised when the viewport changes — at most once per animation frame while a pan or wheel zoom is running, once more when it ends, and after every imperative change (FitViewAsync, ZoomInAsync, ...).",
36593
+ "isCascading": false,
36594
+ "captureUnmatched": false,
36595
+ "isEditorRequired": false
36596
+ },
36597
+ {
36598
+ "name": "NodeTemplate",
36599
+ "type": "RenderFragment<FlowNodeContext>?",
36600
+ "default": null,
36601
+ "description": "Renders each node's content. The canvas wraps it in a positioned, focusable host. Without a template a node renders a small card with its Data (or Id).",
36602
+ "isCascading": false,
36603
+ "captureUnmatched": false,
36604
+ "isEditorRequired": false
36605
+ },
36606
+ {
36607
+ "name": "EdgeLabelTemplate",
36608
+ "type": "RenderFragment<FlowEdgeContext>?",
36609
+ "default": null,
36610
+ "description": "Renders an edge's label. Without a template, Label (when set) renders as a small themed pill. Positioned at the path midpoint and moved live by the engine while a connected node is dragged.",
36611
+ "isCascading": false,
36612
+ "captureUnmatched": false,
36613
+ "isEditorRequired": false
36614
+ },
36615
+ {
36616
+ "name": "NodeAriaLabel",
36617
+ "type": "Func<FlowNode, string>?",
36618
+ "default": null,
36619
+ "description": "Names a node for assistive technology (its host's aria-label and the \"Connect from/to\" handle labels). Without it every node is named by its Id.",
36336
36620
  "isCascading": false,
36337
36621
  "captureUnmatched": false,
36338
36622
  "isEditorRequired": false
@@ -36341,52 +36625,367 @@
36341
36625
  "name": "ChildContent",
36342
36626
  "type": "RenderFragment?",
36343
36627
  "default": null,
36344
- "description": "The form's fields — typically a sequence of FormFields wrapping bound inputs.",
36628
+ "description": "Overlays rendered inside the pane: FlowBackground, FlowControls, FlowMiniMap, FlowPanel, your own panels.",
36345
36629
  "isCascading": false,
36346
36630
  "captureUnmatched": false,
36347
36631
  "isEditorRequired": false
36348
36632
  },
36349
36633
  {
36350
- "name": "OnValidSubmit",
36351
- "type": "EventCallback<TModel>",
36634
+ "name": "Height",
36635
+ "type": "string",
36636
+ "default": "\"500px\"",
36637
+ "description": "CSS height of the canvas.",
36638
+ "isCascading": false,
36639
+ "captureUnmatched": false,
36640
+ "isEditorRequired": false
36641
+ },
36642
+ {
36643
+ "name": "MinZoom",
36644
+ "type": "double",
36645
+ "default": "0.25",
36646
+ "description": "Smallest zoom a gesture or method may reach.",
36647
+ "isCascading": false,
36648
+ "captureUnmatched": false,
36649
+ "isEditorRequired": false
36650
+ },
36651
+ {
36652
+ "name": "MaxZoom",
36653
+ "type": "double",
36654
+ "default": "2",
36655
+ "description": "Largest zoom a gesture or method may reach.",
36656
+ "isCascading": false,
36657
+ "captureUnmatched": false,
36658
+ "isEditorRequired": false
36659
+ },
36660
+ {
36661
+ "name": "FitViewOnInit",
36662
+ "type": "bool",
36663
+ "default": "true",
36664
+ "description": "Fits every node into view once the canvas has mounted and measured its nodes (the nodes stay invisible until then, so the un-fitted frame never shows).",
36665
+ "isCascading": false,
36666
+ "captureUnmatched": false,
36667
+ "isEditorRequired": false
36668
+ },
36669
+ {
36670
+ "name": "FitViewPadding",
36671
+ "type": "double",
36672
+ "default": "0.1",
36673
+ "description": "Breathing room for fit-view, as a fraction of the nodes' bounds (0.1 = 10%).",
36674
+ "isCascading": false,
36675
+ "captureUnmatched": false,
36676
+ "isEditorRequired": false
36677
+ },
36678
+ {
36679
+ "name": "SnapToGrid",
36680
+ "type": "bool",
36681
+ "default": "false",
36682
+ "description": "Snaps dragged and keyboard-moved nodes to SnapGrid. Two-way bindable (@bind-SnapToGrid) so FlowControls' ShowSnapToggle button can flip it; without a binding it still works, the canvas just keeps its own toggled copy after the first render (the same rule Nodes/Edges follow).",
36683
+ "isCascading": false,
36684
+ "captureUnmatched": false,
36685
+ "isEditorRequired": false
36686
+ },
36687
+ {
36688
+ "name": "SnapToGridChanged",
36689
+ "type": "EventCallback<bool>",
36352
36690
  "default": null,
36353
- "description": "Invoked with Model on submit when validation passes (no Validator, or it reports no errors).",
36691
+ "description": "Raised when SnapToGrid changes — a caller toggle, or FlowControls' snap button.",
36354
36692
  "isCascading": false,
36355
36693
  "captureUnmatched": false,
36356
36694
  "isEditorRequired": false
36357
36695
  },
36358
36696
  {
36359
- "name": "OnInvalidSubmit",
36360
- "type": "EventCallback<TModel>",
36697
+ "name": "SnapGrid",
36698
+ "type": "(double X, double Y)",
36699
+ "default": "(16, 16)",
36700
+ "description": "The snap grid in flow units (X, Y).",
36701
+ "isCascading": false,
36702
+ "captureUnmatched": false,
36703
+ "isEditorRequired": false
36704
+ },
36705
+ {
36706
+ "name": "NodesDraggable",
36707
+ "type": "bool",
36708
+ "default": "true",
36709
+ "description": "Nodes can be moved by dragging or with the arrow keys.",
36710
+ "isCascading": false,
36711
+ "captureUnmatched": false,
36712
+ "isEditorRequired": false
36713
+ },
36714
+ {
36715
+ "name": "PanOnDrag",
36716
+ "type": "bool",
36717
+ "default": "true",
36718
+ "description": "Dragging the empty background pans the canvas. Holding Space pans from anywhere either way.",
36719
+ "isCascading": false,
36720
+ "captureUnmatched": false,
36721
+ "isEditorRequired": false
36722
+ },
36723
+ {
36724
+ "name": "ZoomOnScroll",
36725
+ "type": "bool",
36726
+ "default": "true",
36727
+ "description": "The mouse wheel zooms, anchored on the pointer (a plain wheel — no modifier — like React Flow; the page does not scroll while the pointer is over the canvas).",
36728
+ "isCascading": false,
36729
+ "captureUnmatched": false,
36730
+ "isEditorRequired": false
36731
+ },
36732
+ {
36733
+ "name": "NodesConnectable",
36734
+ "type": "bool",
36735
+ "default": "true",
36736
+ "description": "Dragging from a source FlowHandle to a target handle proposes a connection (pointer or keyboard — Enter on a source handle, then Enter on a target). ANDed with Connectable on both ends, Readonly and the controls' lock toggle.",
36737
+ "isCascading": false,
36738
+ "captureUnmatched": false,
36739
+ "isEditorRequired": false
36740
+ },
36741
+ {
36742
+ "name": "ElementsSelectable",
36743
+ "type": "bool",
36744
+ "default": "true",
36745
+ "description": "Nodes and edges can be selected: click, shift/ctrl-click to toggle, shift-drag for a marquee (SelectionOnShiftDrag). ANDed with Selectable per node.",
36746
+ "isCascading": false,
36747
+ "captureUnmatched": false,
36748
+ "isEditorRequired": false
36749
+ },
36750
+ {
36751
+ "name": "SelectionOnShiftDrag",
36752
+ "type": "bool",
36753
+ "default": "true",
36754
+ "description": "Shift-dragging the empty background draws a marquee that selects every intersected, selectable node. Requires ElementsSelectable.",
36755
+ "isCascading": false,
36756
+ "captureUnmatched": false,
36757
+ "isEditorRequired": false
36758
+ },
36759
+ {
36760
+ "name": "DeleteKey",
36761
+ "type": "IReadOnlyList<string>",
36762
+ "default": "new[] { \"Delete\", \"Backspace\" }",
36763
+ "description": "Key names (KeyboardEventArgs.Key) that delete the current selection while focus is anywhere inside the canvas.",
36764
+ "isCascading": false,
36765
+ "captureUnmatched": false,
36766
+ "isEditorRequired": false
36767
+ },
36768
+ {
36769
+ "name": "Readonly",
36770
+ "type": "bool",
36771
+ "default": "false",
36772
+ "description": "Turns every editing gesture off (node drag, keyboard move, connect and delete). Pan, zoom, selection and click events keep working.",
36773
+ "isCascading": false,
36774
+ "captureUnmatched": false,
36775
+ "isEditorRequired": false
36776
+ },
36777
+ {
36778
+ "name": "History",
36779
+ "type": "FlowHistory?",
36361
36780
  "default": null,
36362
- "description": "Invoked with Model on submit when Validator reports validation errors.",
36781
+ "description": "When set, the canvas records a snapshot after every committed change (drag stop, keyboard move, connect, delete, an externally-applied Nodes/Edges replace such as an auto-layout result) and handles Ctrl+Z (undo), Ctrl+Shift+Z and Ctrl+Y (redo) while the canvas has focus. Selection changes alone do not push a snapshot. Share one FlowHistory with your own undo/redo UI if you have one — UndoAsync/RedoAsync are also public for that.",
36363
36782
  "isCascading": false,
36364
36783
  "captureUnmatched": false,
36365
36784
  "isEditorRequired": false
36366
36785
  },
36367
36786
  {
36368
- "name": "Validator",
36369
- "type": "IFormValidator?",
36787
+ "name": "EdgesReconnectable",
36788
+ "type": "bool",
36789
+ "default": "true",
36790
+ "description": "Lets an existing selected edge's end be re-dragged onto a different handle (a small grab handle at each end of a selected edge). See OnReconnect.",
36791
+ "isCascading": false,
36792
+ "captureUnmatched": false,
36793
+ "isEditorRequired": false
36794
+ },
36795
+ {
36796
+ "name": "ConnectionMode",
36797
+ "type": "FlowConnectionMode",
36798
+ "default": "FlowConnectionMode.Strict",
36799
+ "description": "What a connect gesture accepts. Strict (default) only lets a drag start on a Source handle and land on a Target handle, like every earlier phase. Loose lets a drag start on ANY handle and land on any OTHER handle (source-to-source, target-to-target included) — the drag's start becomes Source, its end Target, regardless of either handle's declared FlowHandleType. IsValidConnection still runs on top of either mode.",
36800
+ "isCascading": false,
36801
+ "captureUnmatched": false,
36802
+ "isEditorRequired": false
36803
+ },
36804
+ {
36805
+ "name": "HelperLines",
36806
+ "type": "bool",
36807
+ "default": "false",
36808
+ "description": "While a single node is dragged (and SnapToGrid is off), snaps it to the nearest other node's left/centre/right and top/middle/bottom within HelperLineThreshold and draws the matching guide(s) in the edge SVG layer. Off by default. A multi-node drag (several selected nodes moved together) does not compute helper lines.",
36809
+ "isCascading": false,
36810
+ "captureUnmatched": false,
36811
+ "isEditorRequired": false
36812
+ },
36813
+ {
36814
+ "name": "HelperLineThreshold",
36815
+ "type": "double",
36816
+ "default": "5",
36817
+ "description": "How close (in flow units) a dragged node's edge must be to another node's for a helper line to appear.",
36818
+ "isCascading": false,
36819
+ "captureUnmatched": false,
36820
+ "isEditorRequired": false
36821
+ },
36822
+ {
36823
+ "name": "NewNodeId",
36824
+ "type": "Func<FlowNode, string>?",
36370
36825
  "default": null,
36371
- "description": "Optional synchronous validator run on submit and via ValidateField; its errors are merged into the cascaded FormContext alongside any async field-level errors.",
36826
+ "description": "Names newly created nodes for Ctrl+V (paste) and Ctrl+D (duplicate). Defaults to a short GUID-derived id (\"flow-node-\" + Guid.NewGuid()). Called once per copied node.",
36372
36827
  "isCascading": false,
36373
36828
  "captureUnmatched": false,
36374
36829
  "isEditorRequired": false
36375
36830
  },
36376
36831
  {
36377
- "name": "Class",
36378
- "type": "string?",
36832
+ "name": "ValidateOnHover",
36833
+ "type": "bool",
36834
+ "default": "false",
36835
+ "description": "A hovered connection target is validated against IsValidConnection DURING the drag (one interop round trip per hovered handle change) instead of only on drop, and marked data-flow-handle-invalid when it would be rejected. Off by default — the structural heuristic (data-flow-handle-valid) is free; this costs a round trip per hover.",
36836
+ "isCascading": false,
36837
+ "captureUnmatched": false,
36838
+ "isEditorRequired": false
36839
+ },
36840
+ {
36841
+ "name": "EdgeLabelEditable",
36842
+ "type": "bool",
36843
+ "default": "false",
36844
+ "description": "Double-clicking an edge's label opens an inline text box (Enter commits, Escape cancels). Off by default.",
36845
+ "isCascading": false,
36846
+ "captureUnmatched": false,
36847
+ "isEditorRequired": false
36848
+ },
36849
+ {
36850
+ "name": "OnlyRenderVisibleNodes",
36851
+ "type": "bool",
36852
+ "default": "false",
36853
+ "description": "Virtualization for large graphs: only nodes whose rect intersects the visible viewport plus one viewport of margin in every direction are mounted (plus their parent groups, and any node being dragged), and only edges touching a mounted node are drawn. The window follows pans and zooms with hysteresis — it is rebuilt only once the viewport has drifted half a viewport away (or zoomed in past half its size) — at most every 80 ms while a gesture runs, plus once when it ends. Selection, delete, clipboard, keyboard moves, FitViewAsync, FlowMiniMap and export keep working on EVERY node (they read the model, not the DOM); sizes measured while a node was mounted are remembered after it unmounts. Helper lines, marquee and connect targets only see mounted nodes (everything within one viewport of the visible area). Off by default.",
36854
+ "isCascading": false,
36855
+ "captureUnmatched": false,
36856
+ "isEditorRequired": false
36857
+ },
36858
+ {
36859
+ "name": "OnNodeClick",
36860
+ "type": "EventCallback<FlowNode>",
36379
36861
  "default": null,
36380
- "description": "Additional CSS classes merged onto the <form> element.",
36862
+ "description": "A node was clicked (not raised for the click that ends a drag).",
36381
36863
  "isCascading": false,
36382
36864
  "captureUnmatched": false,
36383
36865
  "isEditorRequired": false
36384
36866
  },
36385
36867
  {
36386
- "name": "ModelTypeInfo",
36387
- "type": "JsonTypeInfo<TModel>?",
36868
+ "name": "OnNodeDoubleClick",
36869
+ "type": "EventCallback<FlowNode>",
36388
36870
  "default": null,
36389
- "description": "Optional source-generated JsonTypeInfo{T} for TModel, used for the init/ResetValues snapshot round-trip instead of reflection-based serialization. Without this, the snapshot uses JsonSerializer.Serialize/Deserialize<TModel> via reflection: TModel itself carries [DynamicallyAccessedMembers(All)] so ITS members survive trimming, but that annotation does NOT cascade into the types of TModel's own reference-type properties (e.g. a nested Address POCO) — their members can still be trimmed away, silently dropping nested values on ResetValues. Pass your own JsonSerializerContext-generated MyModelContext.Default.TModel here to cover the whole object graph and be fully trim-safe (#364 review).",
36871
+ "description": "A node was double-clicked.",
36872
+ "isCascading": false,
36873
+ "captureUnmatched": false,
36874
+ "isEditorRequired": false
36875
+ },
36876
+ {
36877
+ "name": "OnNodeContextMenu",
36878
+ "type": "EventCallback<FlowNodeContextMenuEventArgs>",
36879
+ "default": null,
36880
+ "description": "A node was right-clicked. The browser menu is suppressed while this has a handler.",
36881
+ "isCascading": false,
36882
+ "captureUnmatched": false,
36883
+ "isEditorRequired": false
36884
+ },
36885
+ {
36886
+ "name": "OnPaneClick",
36887
+ "type": "EventCallback<FlowPoint>",
36888
+ "default": null,
36889
+ "description": "The empty background was clicked (not dragged); the point is in flow coordinates.",
36890
+ "isCascading": false,
36891
+ "captureUnmatched": false,
36892
+ "isEditorRequired": false
36893
+ },
36894
+ {
36895
+ "name": "OnNodeDragStop",
36896
+ "type": "EventCallback<IReadOnlyList<FlowNodeChange>>",
36897
+ "default": null,
36898
+ "description": "A drag (or arrow-key move) was committed; one entry per moved node. Raised after NodesChanged.",
36899
+ "isCascading": false,
36900
+ "captureUnmatched": false,
36901
+ "isEditorRequired": false
36902
+ },
36903
+ {
36904
+ "name": "OnEdgeClick",
36905
+ "type": "EventCallback<FlowEdge>",
36906
+ "default": null,
36907
+ "description": "An edge was clicked (not raised for the click that ends a drag or that opens a connection).",
36908
+ "isCascading": false,
36909
+ "captureUnmatched": false,
36910
+ "isEditorRequired": false
36911
+ },
36912
+ {
36913
+ "name": "OnConnect",
36914
+ "type": "EventCallback<FlowConnection>",
36915
+ "default": null,
36916
+ "description": "A connection was dropped on a compatible target handle and passed IsValidConnection. Without a handler the canvas appends a new FlowEdge itself and raises EdgesChanged.",
36917
+ "isCascading": false,
36918
+ "captureUnmatched": false,
36919
+ "isEditorRequired": false
36920
+ },
36921
+ {
36922
+ "name": "IsValidConnection",
36923
+ "type": "Func<FlowConnection, bool>?",
36924
+ "default": null,
36925
+ "description": "Called for every proposed connection (pointer drop or keyboard commit) before it is accepted. Returning false rejects it — no edge is added and OnConnect is not raised.",
36926
+ "isCascading": false,
36927
+ "captureUnmatched": false,
36928
+ "isEditorRequired": false
36929
+ },
36930
+ {
36931
+ "name": "OnReconnect",
36932
+ "type": "EventCallback<FlowReconnectEventArgs>",
36933
+ "default": null,
36934
+ "description": "An existing selected edge's end was dragged onto a different (or the same) compatible handle and passed IsValidConnection. Without a handler the canvas replaces the edge's moved end itself and raises EdgesChanged. Requires EdgesReconnectable.",
36935
+ "isCascading": false,
36936
+ "captureUnmatched": false,
36937
+ "isEditorRequired": false
36938
+ },
36939
+ {
36940
+ "name": "OnSelectionChanged",
36941
+ "type": "EventCallback<FlowSelection>",
36942
+ "default": null,
36943
+ "description": "Raised after the selection changes — a click, shift/ctrl-click, marquee, edge click, SelectAsync, ClearSelectionAsync or a pane click/Escape that clears it.",
36944
+ "isCascading": false,
36945
+ "captureUnmatched": false,
36946
+ "isEditorRequired": false
36947
+ },
36948
+ {
36949
+ "name": "OnDelete",
36950
+ "type": "EventCallback<FlowSelection>",
36951
+ "default": null,
36952
+ "description": "DeleteKey was pressed with a non-empty, deletable selection. Without a handler the canvas removes the selected nodes (and every edge touching one of them) and the directly selected edges itself, raising NodesChanged/EdgesChanged.",
36953
+ "isCascading": false,
36954
+ "captureUnmatched": false,
36955
+ "isEditorRequired": false
36956
+ },
36957
+ {
36958
+ "name": "OnNodeResizeStop",
36959
+ "type": "EventCallback<IReadOnlyList<FlowNodeResizeChange>>",
36960
+ "default": null,
36961
+ "description": "A node was resized by a FlowNodeResizer grip or Shift+arrow keys; one entry per resized node. Raised after NodesChanged.",
36962
+ "isCascading": false,
36963
+ "captureUnmatched": false,
36964
+ "isEditorRequired": false
36965
+ },
36966
+ {
36967
+ "name": "OnPaste",
36968
+ "type": "EventCallback<FlowPasteEventArgs>",
36969
+ "default": null,
36970
+ "description": "Ctrl+V pasted (or Ctrl+D duplicated) a selection. Raised after NodesChanged/EdgesChanged, with the NEW nodes/edges selected.",
36971
+ "isCascading": false,
36972
+ "captureUnmatched": false,
36973
+ "isEditorRequired": false
36974
+ },
36975
+ {
36976
+ "name": "OnEdgeLabelChanged",
36977
+ "type": "EventCallback<FlowEdge>",
36978
+ "default": null,
36979
+ "description": "An edge's inline-edited label was committed (EdgeLabelEditable, Enter). Unlike OnConnect/OnDelete/OnReconnect this is a plain notification, not a veto point — there is nothing to validate — so the canvas ALWAYS updates Label itself and raises EdgesChanged first, then this.",
36980
+ "isCascading": false,
36981
+ "captureUnmatched": false,
36982
+ "isEditorRequired": false
36983
+ },
36984
+ {
36985
+ "name": "Class",
36986
+ "type": "string?",
36987
+ "default": null,
36988
+ "description": "Additional CSS classes merged onto the root element.",
36390
36989
  "isCascading": false,
36391
36990
  "captureUnmatched": false,
36392
36991
  "isEditorRequired": false
@@ -36395,54 +36994,1078 @@
36395
36994
  "name": "AdditionalAttributes",
36396
36995
  "type": "Dictionary<string, object>?",
36397
36996
  "default": null,
36398
- "description": "Unmatched attributes splatted onto the <form> element.",
36997
+ "description": "Captures unmatched attributes and applies them to the root element.",
36399
36998
  "isCascading": false,
36400
36999
  "captureUnmatched": true,
36401
37000
  "isEditorRequired": false
37001
+ },
37002
+ {
37003
+ "name": "Direction",
37004
+ "type": "LayoutDirection?",
37005
+ "default": null,
37006
+ "description": null,
37007
+ "isCascading": true,
37008
+ "captureUnmatched": false,
37009
+ "isEditorRequired": false
36402
37010
  }
36403
37011
  ],
36404
37012
  "events": [
36405
37013
  {
36406
- "name": "OnValidSubmit",
36407
- "type": "EventCallback<TModel>",
36408
- "description": "Invoked with Model on submit when validation passes (no Validator, or it reports no errors)."
37014
+ "name": "NodesChanged",
37015
+ "type": "EventCallback<IReadOnlyList<FlowNode>>",
37016
+ "description": "Raised with the new node list after a committed drag or keyboard move."
36409
37017
  },
36410
37018
  {
36411
- "name": "OnInvalidSubmit",
36412
- "type": "EventCallback<TModel>",
36413
- "description": "Invoked with Model on submit when Validator reports validation errors."
36414
- }
36415
- ],
36416
- "enums": [],
36417
- "records": [],
36418
- "gotchas": [],
36419
- "cssVars": [
36420
- "--color-destructive",
36421
- "--color-muted",
36422
- "--color-muted-foreground"
36423
- ],
36424
- "examples": [
37019
+ "name": "EdgesChanged",
37020
+ "type": "EventCallback<IReadOnlyList<FlowEdge>>",
37021
+ "description": "Raised with the new edge list after a committed connect (when OnConnect has no handler) or a delete that removed edges."
37022
+ },
36425
37023
  {
36426
- "title": "Input with Validation",
36427
- "code": "<FormField Name=\"email\" Label=\"Email\" Required=\"true\" Error=\"@_emailError\" HelpText=\"We will never share your email.\">\n <Input Type=\"email\" Placeholder=\"you@example.com\" @bind-Value=\"_emailValue\" />\n</FormField>\n<Button OnClick=\"ValidateEmail\">Validate</Button>\n\n@code {\n private string? _emailValue;\n private string? _emailError;\n\n private void ValidateEmail()\n {\n if (string.IsNullOrWhiteSpace(_emailValue) || !_emailValue.Contains('@'))\n _emailError = \"Please enter a valid email address.\";\n else\n _emailError = null;\n }\n}"
37024
+ "name": "ViewportChanged",
37025
+ "type": "EventCallback<FlowViewport>",
37026
+ "description": "Raised when the viewport changes — at most once per animation frame while a pan or wheel zoom is running, once more when it ends, and after every imperative change (FitViewAsync, ZoomInAsync, ...)."
36428
37027
  },
36429
37028
  {
36430
- "title": "Select with Validation",
36431
- "code": "<FormField Name=\"role\" Label=\"Role\" Required=\"true\" Error=\"@_roleError\">\n <Select @bind-Value=\"_roleValue\">\n <SelectTrigger>\n <Text As=\"span\" Class=\"@(_roleValue == null ? \\\"text-muted-foreground\\\" : \"\")\">\n @(_roleValue ?? \"Select a role\")\n </Text>\n </SelectTrigger>\n <SelectContent>\n <SelectItem Value=\"admin\">Admin</SelectItem>\n <SelectItem Value=\"editor\">Editor</SelectItem>\n <SelectItem Value=\"viewer\">Viewer</SelectItem>\n </SelectContent>\n </Select>\n</FormField>\n<Button OnClick=\"ValidateRole\">Validate</Button>\n\n@code {\n private string? _roleValue;\n private string? _roleError;\n\n private void ValidateRole()\n {\n if (string.IsNullOrEmpty(_roleValue))\n _roleError = \"Please select a role.\";\n else\n _roleError = null;\n }\n}"
37029
+ "name": "SnapToGridChanged",
37030
+ "type": "EventCallback<bool>",
37031
+ "description": "Raised when SnapToGrid changes — a caller toggle, or FlowControls' snap button."
36432
37032
  },
36433
37033
  {
36434
- "title": "Checkbox and Switch with Validation",
36435
- "code": "<FormField Name=\"terms\" Error=\"@_termsError\">\n <Flex Gap=\"2\" Align=\"center\">\n <Checkbox @bind-Checked=\"_termsChecked\" />\n <Label>I accept the terms and conditions</Label>\n </Flex>\n</FormField>\n<FormField Name=\"notifications\" Label=\"Email Notifications\" HelpText=\"Receive updates about your account.\">\n <Switch @bind-Checked=\"_notifChecked\" />\n</FormField>\n<Button OnClick=\"ValidateTerms\">Submit</Button>\n\n@code {\n private bool _termsChecked;\n private bool _notifChecked = true;\n private string? _termsError;\n\n private void ValidateTerms()\n {\n _termsError = _termsChecked ? null : \"You must accept the terms to continue.\";\n }\n}"
37034
+ "name": "OnNodeClick",
37035
+ "type": "EventCallback<FlowNode>",
37036
+ "description": "A node was clicked (not raised for the click that ends a drag)."
36436
37037
  },
36437
37038
  {
36438
- "title": "Default",
36439
- "code": "<FormField Name=\"username\">\n <FormItem>\n <FormLabel>Username</FormLabel>\n <Input Placeholder=\"Enter your username\" />\n <FormDescription>This is your public display name.</FormDescription>\n </FormItem>\n</FormField>"
37039
+ "name": "OnNodeDoubleClick",
37040
+ "type": "EventCallback<FlowNode>",
37041
+ "description": "A node was double-clicked."
37042
+ },
37043
+ {
37044
+ "name": "OnNodeContextMenu",
37045
+ "type": "EventCallback<FlowNodeContextMenuEventArgs>",
37046
+ "description": "A node was right-clicked. The browser menu is suppressed while this has a handler."
37047
+ },
37048
+ {
37049
+ "name": "OnPaneClick",
37050
+ "type": "EventCallback<FlowPoint>",
37051
+ "description": "The empty background was clicked (not dragged); the point is in flow coordinates."
37052
+ },
37053
+ {
37054
+ "name": "OnNodeDragStop",
37055
+ "type": "EventCallback<IReadOnlyList<FlowNodeChange>>",
37056
+ "description": "A drag (or arrow-key move) was committed; one entry per moved node. Raised after NodesChanged."
37057
+ },
37058
+ {
37059
+ "name": "OnEdgeClick",
37060
+ "type": "EventCallback<FlowEdge>",
37061
+ "description": "An edge was clicked (not raised for the click that ends a drag or that opens a connection)."
37062
+ },
37063
+ {
37064
+ "name": "OnConnect",
37065
+ "type": "EventCallback<FlowConnection>",
37066
+ "description": "A connection was dropped on a compatible target handle and passed IsValidConnection. Without a handler the canvas appends a new FlowEdge itself and raises EdgesChanged."
37067
+ },
37068
+ {
37069
+ "name": "OnReconnect",
37070
+ "type": "EventCallback<FlowReconnectEventArgs>",
37071
+ "description": "An existing selected edge's end was dragged onto a different (or the same) compatible handle and passed IsValidConnection. Without a handler the canvas replaces the edge's moved end itself and raises EdgesChanged. Requires EdgesReconnectable."
37072
+ },
37073
+ {
37074
+ "name": "OnSelectionChanged",
37075
+ "type": "EventCallback<FlowSelection>",
37076
+ "description": "Raised after the selection changes — a click, shift/ctrl-click, marquee, edge click, SelectAsync, ClearSelectionAsync or a pane click/Escape that clears it."
37077
+ },
37078
+ {
37079
+ "name": "OnDelete",
37080
+ "type": "EventCallback<FlowSelection>",
37081
+ "description": "DeleteKey was pressed with a non-empty, deletable selection. Without a handler the canvas removes the selected nodes (and every edge touching one of them) and the directly selected edges itself, raising NodesChanged/EdgesChanged."
37082
+ },
37083
+ {
37084
+ "name": "OnNodeResizeStop",
37085
+ "type": "EventCallback<IReadOnlyList<FlowNodeResizeChange>>",
37086
+ "description": "A node was resized by a FlowNodeResizer grip or Shift+arrow keys; one entry per resized node. Raised after NodesChanged."
37087
+ },
37088
+ {
37089
+ "name": "OnPaste",
37090
+ "type": "EventCallback<FlowPasteEventArgs>",
37091
+ "description": "Ctrl+V pasted (or Ctrl+D duplicated) a selection. Raised after NodesChanged/EdgesChanged, with the NEW nodes/edges selected."
37092
+ },
37093
+ {
37094
+ "name": "OnEdgeLabelChanged",
37095
+ "type": "EventCallback<FlowEdge>",
37096
+ "description": "An edge's inline-edited label was committed (EdgeLabelEditable, Enter). Unlike OnConnect/OnDelete/OnReconnect this is a plain notification, not a veto point — there is nothing to validate — so the canvas ALWAYS updates Label itself and raises EdgesChanged first, then this."
36440
37097
  }
36441
37098
  ],
36442
- "subComponents": {
36443
- "FormDescription": {
36444
- "componentName": "FormDescription",
36445
- "fileName": "FormDescription.razor",
37099
+ "enums": [
37100
+ {
37101
+ "name": "FlowBackgroundVariant",
37102
+ "values": [
37103
+ "Dots",
37104
+ "Lines",
37105
+ "Cross"
37106
+ ],
37107
+ "description": "The pattern FlowBackground draws."
37108
+ },
37109
+ {
37110
+ "name": "FlowConnectionMode",
37111
+ "values": [
37112
+ "Strict",
37113
+ "Loose"
37114
+ ],
37115
+ "description": "What a connection gesture (pointer drag or keyboard connect) accepts as a valid target (phase 4). Structural only — IsValidConnection still runs on top of either mode."
37116
+ },
37117
+ {
37118
+ "name": "FlowHandleType",
37119
+ "values": [
37120
+ "Source",
37121
+ "Target"
37122
+ ],
37123
+ "description": "Whether a FlowHandle starts connections (Source) or accepts them (Target)."
37124
+ },
37125
+ {
37126
+ "name": "FlowPosition",
37127
+ "values": [
37128
+ "Left",
37129
+ "Right",
37130
+ "Top",
37131
+ "Bottom"
37132
+ ],
37133
+ "description": "The PHYSICAL side of a node a handle sits on, and the direction an edge leaves/enters it. Physical, not logical: Left stays left under dir=\"rtl\" (the canvas is a geometric surface, not a text flow)."
37134
+ }
37135
+ ],
37136
+ "records": [
37137
+ {
37138
+ "name": "FlowCanvasContext",
37139
+ "signature": "FlowCanvasContext(FlowCanvas Canvas, FlowViewport Viewport, FlowViewport InitialViewport, bool Locked, double MinZoom, double MaxZoom, bool SnapToGrid, int HistoryVersion)",
37140
+ "description": "What the canvas cascades to FlowBackground, FlowControls and its own node/edge layers. Re-created on every render (cascaded with IsFixed=\"false\")."
37141
+ }
37142
+ ],
37143
+ "gotchas": [],
37144
+ "cssVars": [
37145
+ "--color-accent",
37146
+ "--color-accent-foreground",
37147
+ "--color-background",
37148
+ "--color-border",
37149
+ "--color-card",
37150
+ "--color-card-foreground",
37151
+ "--color-foreground",
37152
+ "--color-muted",
37153
+ "--color-muted-foreground",
37154
+ "--color-primary",
37155
+ "--radius"
37156
+ ],
37157
+ "examples": [],
37158
+ "subComponents": {
37159
+ "FlowBackground": {
37160
+ "componentName": "FlowBackground",
37161
+ "fileName": "FlowBackground.razor",
37162
+ "namespace": "Lumeo",
37163
+ "inheritsFrom": null,
37164
+ "implements": [],
37165
+ "parameters": [
37166
+ {
37167
+ "name": "Context",
37168
+ "type": "FlowCanvas.FlowCanvasContext?",
37169
+ "default": null,
37170
+ "description": null,
37171
+ "isCascading": true,
37172
+ "captureUnmatched": false,
37173
+ "isEditorRequired": false
37174
+ },
37175
+ {
37176
+ "name": "Variant",
37177
+ "type": "FlowBackgroundVariant",
37178
+ "default": "FlowBackgroundVariant.Dots",
37179
+ "description": "What the grid draws.",
37180
+ "isCascading": false,
37181
+ "captureUnmatched": false,
37182
+ "isEditorRequired": false
37183
+ },
37184
+ {
37185
+ "name": "Gap",
37186
+ "type": "double",
37187
+ "default": "20",
37188
+ "description": "Grid spacing in flow units.",
37189
+ "isCascading": false,
37190
+ "captureUnmatched": false,
37191
+ "isEditorRequired": false
37192
+ },
37193
+ {
37194
+ "name": "Size",
37195
+ "type": "double",
37196
+ "default": "1",
37197
+ "description": "Dot radius (dots) or half the arm length (cross), in flow units. Ignored for lines.",
37198
+ "isCascading": false,
37199
+ "captureUnmatched": false,
37200
+ "isEditorRequired": false
37201
+ },
37202
+ {
37203
+ "name": "Class",
37204
+ "type": "string?",
37205
+ "default": null,
37206
+ "description": "Additional CSS classes merged onto the background <svg>.",
37207
+ "isCascading": false,
37208
+ "captureUnmatched": false,
37209
+ "isEditorRequired": false
37210
+ },
37211
+ {
37212
+ "name": "AdditionalAttributes",
37213
+ "type": "Dictionary<string, object>?",
37214
+ "default": null,
37215
+ "description": "Captures unmatched attributes and applies them to the background <svg>.",
37216
+ "isCascading": false,
37217
+ "captureUnmatched": true,
37218
+ "isEditorRequired": false
37219
+ }
37220
+ ],
37221
+ "events": [],
37222
+ "enums": [],
37223
+ "records": [],
37224
+ "gotchas": [],
37225
+ "parseFailed": false,
37226
+ "parseError": null
37227
+ },
37228
+ "FlowControls": {
37229
+ "componentName": "FlowControls",
37230
+ "fileName": "FlowControls.razor",
37231
+ "namespace": "Lumeo",
37232
+ "inheritsFrom": null,
37233
+ "implements": [],
37234
+ "parameters": [
37235
+ {
37236
+ "name": "Context",
37237
+ "type": "FlowCanvas.FlowCanvasContext?",
37238
+ "default": null,
37239
+ "description": null,
37240
+ "isCascading": true,
37241
+ "captureUnmatched": false,
37242
+ "isEditorRequired": false
37243
+ },
37244
+ {
37245
+ "name": "Position",
37246
+ "type": "ControlsPosition",
37247
+ "default": "ControlsPosition.BottomLeft",
37248
+ "description": "The corner the controls sit in.",
37249
+ "isCascading": false,
37250
+ "captureUnmatched": false,
37251
+ "isEditorRequired": false
37252
+ },
37253
+ {
37254
+ "name": "Horizontal",
37255
+ "type": "bool",
37256
+ "default": "false",
37257
+ "description": "Lays the buttons out in a row instead of a column.",
37258
+ "isCascading": false,
37259
+ "captureUnmatched": false,
37260
+ "isEditorRequired": false
37261
+ },
37262
+ {
37263
+ "name": "ShowZoom",
37264
+ "type": "bool",
37265
+ "default": "true",
37266
+ "description": "Shows the zoom in / zoom out buttons.",
37267
+ "isCascading": false,
37268
+ "captureUnmatched": false,
37269
+ "isEditorRequired": false
37270
+ },
37271
+ {
37272
+ "name": "ShowFitView",
37273
+ "type": "bool",
37274
+ "default": "true",
37275
+ "description": "Shows the fit-view button.",
37276
+ "isCascading": false,
37277
+ "captureUnmatched": false,
37278
+ "isEditorRequired": false
37279
+ },
37280
+ {
37281
+ "name": "ShowLock",
37282
+ "type": "bool",
37283
+ "default": "true",
37284
+ "description": "Shows the lock toggle (locked = nodes cannot be moved; pan and zoom still work).",
37285
+ "isCascading": false,
37286
+ "captureUnmatched": false,
37287
+ "isEditorRequired": false
37288
+ },
37289
+ {
37290
+ "name": "ShowSnapToggle",
37291
+ "type": "bool",
37292
+ "default": "false",
37293
+ "description": "Shows a grid-icon toggle bound to the canvas' SnapToGrid.",
37294
+ "isCascading": false,
37295
+ "captureUnmatched": false,
37296
+ "isEditorRequired": false
37297
+ },
37298
+ {
37299
+ "name": "ShowHistory",
37300
+ "type": "bool",
37301
+ "default": "false",
37302
+ "description": "Shows undo/redo buttons driven by the canvas' History (disabled with nothing to undo/redo, or when the canvas has no History set).",
37303
+ "isCascading": false,
37304
+ "captureUnmatched": false,
37305
+ "isEditorRequired": false
37306
+ },
37307
+ {
37308
+ "name": "ChildContent",
37309
+ "type": "RenderFragment?",
37310
+ "default": null,
37311
+ "description": "Extra buttons appended after the built-in ones.",
37312
+ "isCascading": false,
37313
+ "captureUnmatched": false,
37314
+ "isEditorRequired": false
37315
+ },
37316
+ {
37317
+ "name": "Class",
37318
+ "type": "string?",
37319
+ "default": null,
37320
+ "description": "Additional CSS classes merged onto the toolbar.",
37321
+ "isCascading": false,
37322
+ "captureUnmatched": false,
37323
+ "isEditorRequired": false
37324
+ },
37325
+ {
37326
+ "name": "AdditionalAttributes",
37327
+ "type": "Dictionary<string, object>?",
37328
+ "default": null,
37329
+ "description": "Captures unmatched attributes and applies them to the toolbar.",
37330
+ "isCascading": false,
37331
+ "captureUnmatched": true,
37332
+ "isEditorRequired": false
37333
+ }
37334
+ ],
37335
+ "events": [],
37336
+ "enums": [
37337
+ {
37338
+ "name": "ControlsPosition",
37339
+ "values": [
37340
+ "TopLeft",
37341
+ "TopRight",
37342
+ "BottomLeft",
37343
+ "BottomRight"
37344
+ ],
37345
+ "description": "Where the controls sit inside the canvas."
37346
+ }
37347
+ ],
37348
+ "records": [],
37349
+ "gotchas": [],
37350
+ "parseFailed": false,
37351
+ "parseError": null
37352
+ },
37353
+ "FlowEdgeLayer": {
37354
+ "componentName": "FlowEdgeLayer",
37355
+ "fileName": "FlowEdgeLayer.razor",
37356
+ "namespace": "Lumeo",
37357
+ "inheritsFrom": null,
37358
+ "implements": [],
37359
+ "parameters": [],
37360
+ "events": [],
37361
+ "enums": [],
37362
+ "records": [],
37363
+ "gotchas": [],
37364
+ "parseFailed": false,
37365
+ "parseError": null
37366
+ },
37367
+ "FlowGroupNode": {
37368
+ "componentName": "FlowGroupNode",
37369
+ "fileName": "FlowGroupNode.razor",
37370
+ "namespace": "Lumeo",
37371
+ "inheritsFrom": null,
37372
+ "implements": [],
37373
+ "parameters": [
37374
+ {
37375
+ "name": "Node",
37376
+ "type": "FlowNode?",
37377
+ "default": null,
37378
+ "description": null,
37379
+ "isCascading": true,
37380
+ "captureUnmatched": false,
37381
+ "isEditorRequired": false
37382
+ },
37383
+ {
37384
+ "name": "Label",
37385
+ "type": "string?",
37386
+ "default": null,
37387
+ "description": "The label in the top-left corner. Defaults to the node's Data (as text), else its Id.",
37388
+ "isCascading": false,
37389
+ "captureUnmatched": false,
37390
+ "isEditorRequired": false
37391
+ },
37392
+ {
37393
+ "name": "Resizable",
37394
+ "type": "bool",
37395
+ "default": "true",
37396
+ "description": "Renders FlowNodeResizer grips while the group is selected. On by default.",
37397
+ "isCascading": false,
37398
+ "captureUnmatched": false,
37399
+ "isEditorRequired": false
37400
+ },
37401
+ {
37402
+ "name": "MinWidth",
37403
+ "type": "double",
37404
+ "default": "120",
37405
+ "description": "Smallest width, both for the box and for a resize, in flow units.",
37406
+ "isCascading": false,
37407
+ "captureUnmatched": false,
37408
+ "isEditorRequired": false
37409
+ },
37410
+ {
37411
+ "name": "MinHeight",
37412
+ "type": "double",
37413
+ "default": "80",
37414
+ "description": "Smallest height, both for the box and for a resize, in flow units.",
37415
+ "isCascading": false,
37416
+ "captureUnmatched": false,
37417
+ "isEditorRequired": false
37418
+ },
37419
+ {
37420
+ "name": "ChildContent",
37421
+ "type": "RenderFragment?",
37422
+ "default": null,
37423
+ "description": "Extra content rendered below the label (a toolbar, a badge).",
37424
+ "isCascading": false,
37425
+ "captureUnmatched": false,
37426
+ "isEditorRequired": false
37427
+ },
37428
+ {
37429
+ "name": "Class",
37430
+ "type": "string?",
37431
+ "default": null,
37432
+ "description": "Additional CSS classes merged onto the group box.",
37433
+ "isCascading": false,
37434
+ "captureUnmatched": false,
37435
+ "isEditorRequired": false
37436
+ },
37437
+ {
37438
+ "name": "AdditionalAttributes",
37439
+ "type": "Dictionary<string, object>?",
37440
+ "default": null,
37441
+ "description": "Captures unmatched attributes and applies them to the group box.",
37442
+ "isCascading": false,
37443
+ "captureUnmatched": true,
37444
+ "isEditorRequired": false
37445
+ }
37446
+ ],
37447
+ "events": [],
37448
+ "enums": [],
37449
+ "records": [],
37450
+ "gotchas": [],
37451
+ "parseFailed": false,
37452
+ "parseError": null
37453
+ },
37454
+ "FlowHandle": {
37455
+ "componentName": "FlowHandle",
37456
+ "fileName": "FlowHandle.razor",
37457
+ "namespace": "Lumeo",
37458
+ "inheritsFrom": null,
37459
+ "implements": [],
37460
+ "parameters": [
37461
+ {
37462
+ "name": "Node",
37463
+ "type": "FlowNode?",
37464
+ "default": null,
37465
+ "description": null,
37466
+ "isCascading": true,
37467
+ "captureUnmatched": false,
37468
+ "isEditorRequired": false
37469
+ },
37470
+ {
37471
+ "name": "Type",
37472
+ "type": "FlowHandleType",
37473
+ "default": "FlowHandleType.Source",
37474
+ "description": "Source (edges start here) or target (edges end here).",
37475
+ "isCascading": false,
37476
+ "captureUnmatched": false,
37477
+ "isEditorRequired": false
37478
+ },
37479
+ {
37480
+ "name": "Position",
37481
+ "type": "FlowPosition",
37482
+ "default": "FlowPosition.Right",
37483
+ "description": "The side of the node the handle sits on, and the direction edges leave/enter it.",
37484
+ "isCascading": false,
37485
+ "captureUnmatched": false,
37486
+ "isEditorRequired": false
37487
+ },
37488
+ {
37489
+ "name": "Id",
37490
+ "type": "string?",
37491
+ "default": null,
37492
+ "description": "Handle id, for nodes with several handles of the same type (matched by FlowEdge.SourceHandle/TargetHandle).",
37493
+ "isCascading": false,
37494
+ "captureUnmatched": false,
37495
+ "isEditorRequired": false
37496
+ },
37497
+ {
37498
+ "name": "Class",
37499
+ "type": "string?",
37500
+ "default": null,
37501
+ "description": "Additional CSS classes merged onto the handle button.",
37502
+ "isCascading": false,
37503
+ "captureUnmatched": false,
37504
+ "isEditorRequired": false
37505
+ },
37506
+ {
37507
+ "name": "AdditionalAttributes",
37508
+ "type": "Dictionary<string, object>?",
37509
+ "default": null,
37510
+ "description": "Captures unmatched attributes and applies them to the handle button.",
37511
+ "isCascading": false,
37512
+ "captureUnmatched": true,
37513
+ "isEditorRequired": false
37514
+ }
37515
+ ],
37516
+ "events": [],
37517
+ "enums": [],
37518
+ "records": [],
37519
+ "gotchas": [],
37520
+ "parseFailed": false,
37521
+ "parseError": null
37522
+ },
37523
+ "FlowMiniMap": {
37524
+ "componentName": "FlowMiniMap",
37525
+ "fileName": "FlowMiniMap.razor",
37526
+ "namespace": "Lumeo",
37527
+ "inheritsFrom": null,
37528
+ "implements": [],
37529
+ "parameters": [
37530
+ {
37531
+ "name": "Context",
37532
+ "type": "FlowCanvas.FlowCanvasContext?",
37533
+ "default": null,
37534
+ "description": null,
37535
+ "isCascading": true,
37536
+ "captureUnmatched": false,
37537
+ "isEditorRequired": false
37538
+ },
37539
+ {
37540
+ "name": "Position",
37541
+ "type": "MiniMapPosition",
37542
+ "default": "MiniMapPosition.BottomRight",
37543
+ "description": "Which corner of the canvas the overview sits in.",
37544
+ "isCascading": false,
37545
+ "captureUnmatched": false,
37546
+ "isEditorRequired": false
37547
+ },
37548
+ {
37549
+ "name": "Width",
37550
+ "type": "double",
37551
+ "default": "160",
37552
+ "description": "Pixel width of the overview.",
37553
+ "isCascading": false,
37554
+ "captureUnmatched": false,
37555
+ "isEditorRequired": false
37556
+ },
37557
+ {
37558
+ "name": "Height",
37559
+ "type": "double",
37560
+ "default": "110",
37561
+ "description": "Pixel height of the overview.",
37562
+ "isCascading": false,
37563
+ "captureUnmatched": false,
37564
+ "isEditorRequired": false
37565
+ },
37566
+ {
37567
+ "name": "NodeColor",
37568
+ "type": "Func<FlowNode, string?>?",
37569
+ "default": null,
37570
+ "description": "Colours a node's rect. Defaults to --color-muted-foreground for every node.",
37571
+ "isCascading": false,
37572
+ "captureUnmatched": false,
37573
+ "isEditorRequired": false
37574
+ },
37575
+ {
37576
+ "name": "Class",
37577
+ "type": "string?",
37578
+ "default": null,
37579
+ "description": "Additional CSS classes merged onto the overview.",
37580
+ "isCascading": false,
37581
+ "captureUnmatched": false,
37582
+ "isEditorRequired": false
37583
+ },
37584
+ {
37585
+ "name": "AdditionalAttributes",
37586
+ "type": "Dictionary<string, object>?",
37587
+ "default": null,
37588
+ "description": "Captures unmatched attributes and applies them to the overview.",
37589
+ "isCascading": false,
37590
+ "captureUnmatched": true,
37591
+ "isEditorRequired": false
37592
+ }
37593
+ ],
37594
+ "events": [],
37595
+ "enums": [
37596
+ {
37597
+ "name": "MiniMapPosition",
37598
+ "values": [
37599
+ "TopLeft",
37600
+ "TopRight",
37601
+ "BottomLeft",
37602
+ "BottomRight"
37603
+ ],
37604
+ "description": "The corner a FlowMiniMap sits in."
37605
+ }
37606
+ ],
37607
+ "records": [],
37608
+ "gotchas": [],
37609
+ "parseFailed": false,
37610
+ "parseError": null
37611
+ },
37612
+ "FlowNodeHost": {
37613
+ "componentName": "FlowNodeHost",
37614
+ "fileName": "FlowNodeHost.razor",
37615
+ "namespace": "Lumeo",
37616
+ "inheritsFrom": null,
37617
+ "implements": [],
37618
+ "parameters": [
37619
+ {
37620
+ "name": "Context",
37621
+ "type": "FlowCanvas.FlowCanvasContext?",
37622
+ "default": null,
37623
+ "description": null,
37624
+ "isCascading": true,
37625
+ "captureUnmatched": false,
37626
+ "isEditorRequired": false
37627
+ },
37628
+ {
37629
+ "name": "Node",
37630
+ "type": "FlowNode",
37631
+ "default": "default!",
37632
+ "description": "The node this host positions and wraps.",
37633
+ "isCascading": false,
37634
+ "captureUnmatched": false,
37635
+ "isEditorRequired": true
37636
+ },
37637
+ {
37638
+ "name": "Class",
37639
+ "type": "string?",
37640
+ "default": null,
37641
+ "description": "Additional CSS classes merged onto the host element.",
37642
+ "isCascading": false,
37643
+ "captureUnmatched": false,
37644
+ "isEditorRequired": false
37645
+ },
37646
+ {
37647
+ "name": "AdditionalAttributes",
37648
+ "type": "Dictionary<string, object>?",
37649
+ "default": null,
37650
+ "description": "Captures unmatched attributes and applies them to the host element.",
37651
+ "isCascading": false,
37652
+ "captureUnmatched": true,
37653
+ "isEditorRequired": false
37654
+ }
37655
+ ],
37656
+ "events": [],
37657
+ "enums": [],
37658
+ "records": [],
37659
+ "gotchas": [],
37660
+ "parseFailed": false,
37661
+ "parseError": null
37662
+ },
37663
+ "FlowNodeResizer": {
37664
+ "componentName": "FlowNodeResizer",
37665
+ "fileName": "FlowNodeResizer.razor",
37666
+ "namespace": "Lumeo",
37667
+ "inheritsFrom": null,
37668
+ "implements": [
37669
+ "IDisposable"
37670
+ ],
37671
+ "parameters": [
37672
+ {
37673
+ "name": "Node",
37674
+ "type": "FlowNode?",
37675
+ "default": null,
37676
+ "description": null,
37677
+ "isCascading": true,
37678
+ "captureUnmatched": false,
37679
+ "isEditorRequired": false
37680
+ },
37681
+ {
37682
+ "name": "Context",
37683
+ "type": "FlowCanvas.FlowCanvasContext?",
37684
+ "default": null,
37685
+ "description": null,
37686
+ "isCascading": true,
37687
+ "captureUnmatched": false,
37688
+ "isEditorRequired": false
37689
+ },
37690
+ {
37691
+ "name": "MinWidth",
37692
+ "type": "double",
37693
+ "default": "50",
37694
+ "description": "Smallest width a resize (pointer or keyboard) may reach, in flow units.",
37695
+ "isCascading": false,
37696
+ "captureUnmatched": false,
37697
+ "isEditorRequired": false
37698
+ },
37699
+ {
37700
+ "name": "MinHeight",
37701
+ "type": "double",
37702
+ "default": "30",
37703
+ "description": "Smallest height a resize (pointer or keyboard) may reach, in flow units.",
37704
+ "isCascading": false,
37705
+ "captureUnmatched": false,
37706
+ "isEditorRequired": false
37707
+ },
37708
+ {
37709
+ "name": "MaxWidth",
37710
+ "type": "double?",
37711
+ "default": null,
37712
+ "description": "Largest width a resize may reach; unbounded when null.",
37713
+ "isCascading": false,
37714
+ "captureUnmatched": false,
37715
+ "isEditorRequired": false
37716
+ },
37717
+ {
37718
+ "name": "MaxHeight",
37719
+ "type": "double?",
37720
+ "default": null,
37721
+ "description": "Largest height a resize may reach; unbounded when null.",
37722
+ "isCascading": false,
37723
+ "captureUnmatched": false,
37724
+ "isEditorRequired": false
37725
+ },
37726
+ {
37727
+ "name": "AlwaysVisible",
37728
+ "type": "bool",
37729
+ "default": "false",
37730
+ "description": "Shows the grips even while the node is not selected. Off by default (React Flow's own convention).",
37731
+ "isCascading": false,
37732
+ "captureUnmatched": false,
37733
+ "isEditorRequired": false
37734
+ },
37735
+ {
37736
+ "name": "Class",
37737
+ "type": "string?",
37738
+ "default": null,
37739
+ "description": "Additional CSS classes merged onto the grip container.",
37740
+ "isCascading": false,
37741
+ "captureUnmatched": false,
37742
+ "isEditorRequired": false
37743
+ },
37744
+ {
37745
+ "name": "AdditionalAttributes",
37746
+ "type": "Dictionary<string, object>?",
37747
+ "default": null,
37748
+ "description": "Captures unmatched attributes and applies them to the grip container.",
37749
+ "isCascading": false,
37750
+ "captureUnmatched": true,
37751
+ "isEditorRequired": false
37752
+ }
37753
+ ],
37754
+ "events": [],
37755
+ "enums": [],
37756
+ "records": [],
37757
+ "gotchas": [],
37758
+ "parseFailed": false,
37759
+ "parseError": null
37760
+ },
37761
+ "FlowNodeToolbar": {
37762
+ "componentName": "FlowNodeToolbar",
37763
+ "fileName": "FlowNodeToolbar.razor",
37764
+ "namespace": "Lumeo",
37765
+ "inheritsFrom": null,
37766
+ "implements": [],
37767
+ "parameters": [
37768
+ {
37769
+ "name": "Context",
37770
+ "type": "FlowCanvas.FlowCanvasContext?",
37771
+ "default": null,
37772
+ "description": null,
37773
+ "isCascading": true,
37774
+ "captureUnmatched": false,
37775
+ "isEditorRequired": false
37776
+ },
37777
+ {
37778
+ "name": "Position",
37779
+ "type": "ToolbarPosition",
37780
+ "default": "ToolbarPosition.Top",
37781
+ "description": "Floats above (default) or below the node.",
37782
+ "isCascading": false,
37783
+ "captureUnmatched": false,
37784
+ "isEditorRequired": false
37785
+ },
37786
+ {
37787
+ "name": "Offset",
37788
+ "type": "double",
37789
+ "default": "8",
37790
+ "description": "Gap between the node and the toolbar, in pane pixels.",
37791
+ "isCascading": false,
37792
+ "captureUnmatched": false,
37793
+ "isEditorRequired": false
37794
+ },
37795
+ {
37796
+ "name": "ChildContent",
37797
+ "type": "RenderFragment?",
37798
+ "default": null,
37799
+ "description": "The toolbar's content — usually a row of Buttons.",
37800
+ "isCascading": false,
37801
+ "captureUnmatched": false,
37802
+ "isEditorRequired": false
37803
+ },
37804
+ {
37805
+ "name": "Class",
37806
+ "type": "string?",
37807
+ "default": null,
37808
+ "description": "Additional CSS classes merged onto the toolbar.",
37809
+ "isCascading": false,
37810
+ "captureUnmatched": false,
37811
+ "isEditorRequired": false
37812
+ },
37813
+ {
37814
+ "name": "AdditionalAttributes",
37815
+ "type": "Dictionary<string, object>?",
37816
+ "default": null,
37817
+ "description": "Captures unmatched attributes and applies them to the toolbar.",
37818
+ "isCascading": false,
37819
+ "captureUnmatched": true,
37820
+ "isEditorRequired": false
37821
+ }
37822
+ ],
37823
+ "events": [],
37824
+ "enums": [
37825
+ {
37826
+ "name": "ToolbarPosition",
37827
+ "values": [
37828
+ "Top",
37829
+ "Bottom"
37830
+ ],
37831
+ "description": "Which edge of the node the toolbar floats off."
37832
+ }
37833
+ ],
37834
+ "records": [],
37835
+ "gotchas": [],
37836
+ "parseFailed": false,
37837
+ "parseError": null
37838
+ },
37839
+ "FlowPanel": {
37840
+ "componentName": "FlowPanel",
37841
+ "fileName": "FlowPanel.razor",
37842
+ "namespace": "Lumeo",
37843
+ "inheritsFrom": null,
37844
+ "implements": [],
37845
+ "parameters": [
37846
+ {
37847
+ "name": "Position",
37848
+ "type": "PanelPosition",
37849
+ "default": "PanelPosition.TopRight",
37850
+ "description": "Which corner of the canvas the panel sits in.",
37851
+ "isCascading": false,
37852
+ "captureUnmatched": false,
37853
+ "isEditorRequired": false
37854
+ },
37855
+ {
37856
+ "name": "ChildContent",
37857
+ "type": "RenderFragment?",
37858
+ "default": null,
37859
+ "description": "The panel's content.",
37860
+ "isCascading": false,
37861
+ "captureUnmatched": false,
37862
+ "isEditorRequired": false
37863
+ },
37864
+ {
37865
+ "name": "Class",
37866
+ "type": "string?",
37867
+ "default": null,
37868
+ "description": "Additional CSS classes merged onto the panel.",
37869
+ "isCascading": false,
37870
+ "captureUnmatched": false,
37871
+ "isEditorRequired": false
37872
+ },
37873
+ {
37874
+ "name": "AdditionalAttributes",
37875
+ "type": "Dictionary<string, object>?",
37876
+ "default": null,
37877
+ "description": "Captures unmatched attributes and applies them to the panel.",
37878
+ "isCascading": false,
37879
+ "captureUnmatched": true,
37880
+ "isEditorRequired": false
37881
+ }
37882
+ ],
37883
+ "events": [],
37884
+ "enums": [
37885
+ {
37886
+ "name": "PanelPosition",
37887
+ "values": [
37888
+ "TopLeft",
37889
+ "TopRight",
37890
+ "BottomLeft",
37891
+ "BottomRight"
37892
+ ],
37893
+ "description": "The corner a FlowPanel sits in."
37894
+ }
37895
+ ],
37896
+ "records": [],
37897
+ "gotchas": [],
37898
+ "parseFailed": false,
37899
+ "parseError": null
37900
+ }
37901
+ },
37902
+ "a11y": {
37903
+ "roles": [
37904
+ "application",
37905
+ "group",
37906
+ "img",
37907
+ "toolbar"
37908
+ ],
37909
+ "ariaAttributes": [
37910
+ "aria-hidden",
37911
+ "aria-label",
37912
+ "aria-live",
37913
+ "aria-orientation",
37914
+ "aria-pressed",
37915
+ "aria-roledescription",
37916
+ "aria-selected"
37917
+ ],
37918
+ "keys": [
37919
+ "ArrowDown",
37920
+ "ArrowLeft",
37921
+ "ArrowRight",
37922
+ "ArrowUp",
37923
+ "Enter",
37924
+ "Escape"
37925
+ ],
37926
+ "keyboardInteractive": true,
37927
+ "focusManaged": true
37928
+ },
37929
+ "parseFailed": false,
37930
+ "parseError": null
37931
+ },
37932
+ "Form": {
37933
+ "name": "Form",
37934
+ "category": "Forms",
37935
+ "subcategory": "Form Composition",
37936
+ "description": "EditForm wrapper with styled validation, field groups, and submit state.",
37937
+ "nugetPackage": "Lumeo",
37938
+ "files": [
37939
+ "UI/Form/DataAnnotationsFormValidator.cs",
37940
+ "UI/Form/Form.razor",
37941
+ "UI/Form/Form.razor.cs",
37942
+ "UI/Form/FormContext.cs",
37943
+ "UI/Form/FormDescription.razor",
37944
+ "UI/Form/FormField.razor",
37945
+ "UI/Form/FormItem.razor",
37946
+ "UI/Form/FormLabel.razor",
37947
+ "UI/Form/FormMessage.razor",
37948
+ "UI/Form/IFormValidator.cs"
37949
+ ],
37950
+ "namespace": "Lumeo",
37951
+ "inheritsFrom": null,
37952
+ "implements": [],
37953
+ "parameters": [
37954
+ {
37955
+ "name": "Model",
37956
+ "type": "TModel?",
37957
+ "default": null,
37958
+ "description": "The form's data model. A JSON snapshot is captured on init (and re-captured whenever a new instance is bound) so ResetValues can restore it later.",
37959
+ "isCascading": false,
37960
+ "captureUnmatched": false,
37961
+ "isEditorRequired": false
37962
+ },
37963
+ {
37964
+ "name": "ChildContent",
37965
+ "type": "RenderFragment?",
37966
+ "default": null,
37967
+ "description": "The form's fields — typically a sequence of FormFields wrapping bound inputs.",
37968
+ "isCascading": false,
37969
+ "captureUnmatched": false,
37970
+ "isEditorRequired": false
37971
+ },
37972
+ {
37973
+ "name": "OnValidSubmit",
37974
+ "type": "EventCallback<TModel>",
37975
+ "default": null,
37976
+ "description": "Invoked with Model on submit when validation passes (no Validator, or it reports no errors).",
37977
+ "isCascading": false,
37978
+ "captureUnmatched": false,
37979
+ "isEditorRequired": false
37980
+ },
37981
+ {
37982
+ "name": "OnInvalidSubmit",
37983
+ "type": "EventCallback<TModel>",
37984
+ "default": null,
37985
+ "description": "Invoked with Model on submit when Validator reports validation errors.",
37986
+ "isCascading": false,
37987
+ "captureUnmatched": false,
37988
+ "isEditorRequired": false
37989
+ },
37990
+ {
37991
+ "name": "Validator",
37992
+ "type": "IFormValidator?",
37993
+ "default": null,
37994
+ "description": "Optional synchronous validator run on submit and via ValidateField; its errors are merged into the cascaded FormContext alongside any async field-level errors.",
37995
+ "isCascading": false,
37996
+ "captureUnmatched": false,
37997
+ "isEditorRequired": false
37998
+ },
37999
+ {
38000
+ "name": "Class",
38001
+ "type": "string?",
38002
+ "default": null,
38003
+ "description": "Additional CSS classes merged onto the <form> element.",
38004
+ "isCascading": false,
38005
+ "captureUnmatched": false,
38006
+ "isEditorRequired": false
38007
+ },
38008
+ {
38009
+ "name": "ModelTypeInfo",
38010
+ "type": "JsonTypeInfo<TModel>?",
38011
+ "default": null,
38012
+ "description": "Optional source-generated JsonTypeInfo{T} for TModel, used for the init/ResetValues snapshot round-trip instead of reflection-based serialization. Without this, the snapshot uses JsonSerializer.Serialize/Deserialize<TModel> via reflection: TModel itself carries [DynamicallyAccessedMembers(All)] so ITS members survive trimming, but that annotation does NOT cascade into the types of TModel's own reference-type properties (e.g. a nested Address POCO) — their members can still be trimmed away, silently dropping nested values on ResetValues. Pass your own JsonSerializerContext-generated MyModelContext.Default.TModel here to cover the whole object graph and be fully trim-safe (#364 review).",
38013
+ "isCascading": false,
38014
+ "captureUnmatched": false,
38015
+ "isEditorRequired": false
38016
+ },
38017
+ {
38018
+ "name": "AdditionalAttributes",
38019
+ "type": "Dictionary<string, object>?",
38020
+ "default": null,
38021
+ "description": "Unmatched attributes splatted onto the <form> element.",
38022
+ "isCascading": false,
38023
+ "captureUnmatched": true,
38024
+ "isEditorRequired": false
38025
+ }
38026
+ ],
38027
+ "events": [
38028
+ {
38029
+ "name": "OnValidSubmit",
38030
+ "type": "EventCallback<TModel>",
38031
+ "description": "Invoked with Model on submit when validation passes (no Validator, or it reports no errors)."
38032
+ },
38033
+ {
38034
+ "name": "OnInvalidSubmit",
38035
+ "type": "EventCallback<TModel>",
38036
+ "description": "Invoked with Model on submit when Validator reports validation errors."
38037
+ }
38038
+ ],
38039
+ "enums": [],
38040
+ "records": [],
38041
+ "gotchas": [],
38042
+ "cssVars": [
38043
+ "--color-destructive",
38044
+ "--color-muted",
38045
+ "--color-muted-foreground"
38046
+ ],
38047
+ "examples": [
38048
+ {
38049
+ "title": "Input with Validation",
38050
+ "code": "<FormField Name=\"email\" Label=\"Email\" Required=\"true\" Error=\"@_emailError\" HelpText=\"We will never share your email.\">\n <Input Type=\"email\" Placeholder=\"you@example.com\" @bind-Value=\"_emailValue\" />\n</FormField>\n<Button OnClick=\"ValidateEmail\">Validate</Button>\n\n@code {\n private string? _emailValue;\n private string? _emailError;\n\n private void ValidateEmail()\n {\n if (string.IsNullOrWhiteSpace(_emailValue) || !_emailValue.Contains('@'))\n _emailError = \"Please enter a valid email address.\";\n else\n _emailError = null;\n }\n}"
38051
+ },
38052
+ {
38053
+ "title": "Select with Validation",
38054
+ "code": "<FormField Name=\"role\" Label=\"Role\" Required=\"true\" Error=\"@_roleError\">\n <Select @bind-Value=\"_roleValue\">\n <SelectTrigger>\n <Text As=\"span\" Class=\"@(_roleValue == null ? \\\"text-muted-foreground\\\" : \"\")\">\n @(_roleValue ?? \"Select a role\")\n </Text>\n </SelectTrigger>\n <SelectContent>\n <SelectItem Value=\"admin\">Admin</SelectItem>\n <SelectItem Value=\"editor\">Editor</SelectItem>\n <SelectItem Value=\"viewer\">Viewer</SelectItem>\n </SelectContent>\n </Select>\n</FormField>\n<Button OnClick=\"ValidateRole\">Validate</Button>\n\n@code {\n private string? _roleValue;\n private string? _roleError;\n\n private void ValidateRole()\n {\n if (string.IsNullOrEmpty(_roleValue))\n _roleError = \"Please select a role.\";\n else\n _roleError = null;\n }\n}"
38055
+ },
38056
+ {
38057
+ "title": "Checkbox and Switch with Validation",
38058
+ "code": "<FormField Name=\"terms\" Error=\"@_termsError\">\n <Flex Gap=\"2\" Align=\"center\">\n <Checkbox @bind-Checked=\"_termsChecked\" />\n <Label>I accept the terms and conditions</Label>\n </Flex>\n</FormField>\n<FormField Name=\"notifications\" Label=\"Email Notifications\" HelpText=\"Receive updates about your account.\">\n <Switch @bind-Checked=\"_notifChecked\" />\n</FormField>\n<Button OnClick=\"ValidateTerms\">Submit</Button>\n\n@code {\n private bool _termsChecked;\n private bool _notifChecked = true;\n private string? _termsError;\n\n private void ValidateTerms()\n {\n _termsError = _termsChecked ? null : \"You must accept the terms to continue.\";\n }\n}"
38059
+ },
38060
+ {
38061
+ "title": "Default",
38062
+ "code": "<FormField Name=\"username\">\n <FormItem>\n <FormLabel>Username</FormLabel>\n <Input Placeholder=\"Enter your username\" />\n <FormDescription>This is your public display name.</FormDescription>\n </FormItem>\n</FormField>"
38063
+ }
38064
+ ],
38065
+ "subComponents": {
38066
+ "FormDescription": {
38067
+ "componentName": "FormDescription",
38068
+ "fileName": "FormDescription.razor",
36446
38069
  "namespace": "Lumeo",
36447
38070
  "inheritsFrom": null,
36448
38071
  "implements": [],
@@ -45409,6 +47032,15 @@
45409
47032
  "captureUnmatched": false,
45410
47033
  "isEditorRequired": false
45411
47034
  },
47035
+ {
47036
+ "name": "MaxHeight",
47037
+ "type": "string?",
47038
+ "default": null,
47039
+ "description": "Overrides the popup's built-in scroll cap on its inner item viewport (a CSS length, e.g. \"20rem\" or \"400px\"). By default the viewport caps itself to the available viewport space in the placement direction — --lumeo-dropdown-available-height, set live by the positioning JS — and scrolls past that.",
47040
+ "isCascading": false,
47041
+ "captureUnmatched": false,
47042
+ "isEditorRequired": false
47043
+ },
45412
47044
  {
45413
47045
  "name": "Class",
45414
47046
  "type": "string?",
@@ -49518,6 +51150,15 @@
49518
51150
  "captureUnmatched": false,
49519
51151
  "isEditorRequired": false
49520
51152
  },
51153
+ {
51154
+ "name": "MatchTriggerWidth",
51155
+ "type": "bool",
51156
+ "default": "false",
51157
+ "description": "When true, the popover's width follows the trigger's rendered width instead of the fixed default (Radix's --radix-popover-trigger-width pattern). Reuses the positioning JS's existing matchWidth plumbing (already used by Select/Combobox/ TreeSelect) so the width re-measures on the same scroll/resize/trigger-resize cadence that already drives repositioning — no separate ResizeObserver needed. The trigger's rendered width is also published as --lumeo-popover-trigger-width on the content element regardless of this flag, so a consumer can drive their own Class width from it (e.g. calc(var(--lumeo-popover-trigger-width) + 1rem)) without opting into the forced width. Default false — existing fixed-width popovers are unaffected.",
51158
+ "isCascading": false,
51159
+ "captureUnmatched": false,
51160
+ "isEditorRequired": false
51161
+ },
49521
51162
  {
49522
51163
  "name": "Class",
49523
51164
  "type": "string?",