@dschz/solid-flow 0.3.0-next.2 → 0.3.0-next.4

package/dist/index/index.d.ts

@@ -1,7 +1,8 @@
 import { JSX } from "@solidjs/web";
-import { Align, Align as Align$1, AriaLabelConfig, AriaLabelConfig as AriaLabelConfig$1, BezierPathOptions, BezierPathOptions as BezierPathOptions$1, Box, ColorMode, ColorMode as ColorMode$1, ColorModeClass, ColorModeClass as ColorModeClass$1, Connection, Connection as Connection$1, ConnectionLineType, ConnectionLineType as ConnectionLineType$1, ConnectionMode, ConnectionMode as ConnectionMode$1, ConnectionState, ControlLinePosition, ControlPosition, ControlPosition as ControlPosition$1, CoordinateExtent, CoordinateExtent as CoordinateExtent$1, DefaultEdgeOptionsBase, Dimensions, EdgeBase, EdgeMarker, EdgeMarkerType, EdgePosition, EdgeToolbarBaseProps, FinalConnectionState, FitBounds, FitBoundsOptions, FitBoundsOptions as FitBoundsOptions$1, FitViewOptionsBase, GetBezierPathParams, GetSmoothStepPathParams, GetStraightPathParams, Handle as Handle$1, HandleConnection, HandleConnection as HandleConnection$1, HandleProps, HandleType, InternalNodeBase, IsValidConnection, MarkerProps, MarkerType, NodeBase, NodeConnection, NodeConnection as NodeConnection$1, NodeOrigin, NodeOrigin as NodeOrigin$1, NodeProps as NodeProps$1, OnBeforeDeleteBase, OnConnect, OnConnectEnd, OnConnectEnd as OnConnectEnd$1, OnConnectStart, OnConnectStart as OnConnectStart$1, OnConnectStartParams, OnError, OnError as OnError$1, OnMove, OnMove as OnMove$1, OnMoveEnd, OnMoveEnd as OnMoveEnd$1, OnMoveStart, OnMoveStart as OnMoveStart$1, OnReconnect, OnReconnect as OnReconnect$1, OnReconnectEnd, OnReconnectEnd as OnReconnectEnd$1, OnReconnectStart, OnReconnectStart as OnReconnectStart$1, OnResize, OnResize as OnResize$1, OnResizeEnd, OnResizeEnd as OnResizeEnd$1, OnResizeStart, OnResizeStart as OnResizeStart$1, OnSelectionDrag, PanOnScrollMode, PanOnScrollMode as PanOnScrollMode$1, PanelPosition, PanelPosition as PanelPosition$1, Position, Position as Position$1, ProOptions, ProOptions as ProOptions$1, Rect, Rect as Rect$1, ResizeControlVariant, ResizeControlVariant as ResizeControlVariant$1, ResizeDragEvent, ResizeParams, ResizeParamsWithDirection, SelectionMode, SelectionMode as SelectionMode$1, SelectionRect, SetCenter, SetCenterOptions, SetCenterOptions as SetCenterOptions$1, SetViewport, ShouldResize, ShouldResize as ShouldResize$1, SmoothStepPathOptions, SmoothStepPathOptions as SmoothStepPathOptions$1, SnapGrid, SnapGrid as SnapGrid$1, StepPathOptions, Transform, UpdateNodeInternals, Viewport, Viewport as Viewport$1, ViewportHelperFunctionOptions, ViewportHelperFunctionOptions as ViewportHelperFunctionOptions$1, XYPosition, XYPosition as XYPosition$1, XYZPosition, ZIndexMode, ZoomInOut, addEdge, getBezierEdgeCenter, getBezierPath, getConnectedEdges, getEdgeCenter, getIncomers, getNodesBounds, getOutgoers, getSmoothStepPath, getStraightPath, getViewportForBounds } from "@xyflow/system";
+import { Align as Align$1, AriaLabelConfig as AriaLabelConfig$1, BezierPathOptions as BezierPathOptions$1, Box as Box$1, ColorMode as ColorMode$1, ColorModeClass as ColorModeClass$1, Connection, Connection as Connection$1, ConnectionLineType, ConnectionLineType as ConnectionLineType$1, ConnectionMode, ConnectionMode as ConnectionMode$1, ConnectionState, ControlLinePosition, ControlPosition, ControlPosition as ControlPosition$1, CoordinateExtent, CoordinateExtent as CoordinateExtent$1, DefaultEdgeOptionsBase, Dimensions as Dimensions$1, EdgeBase, EdgeMarker, EdgeMarkerType as EdgeMarkerType$1, EdgePosition, EdgeToolbarBaseProps, FinalConnectionState, FitBounds, FitBoundsOptions as FitBoundsOptions$1, FitViewOptionsBase, GetBezierPathParams as GetBezierPathParams$1, GetSmoothStepPathParams as GetSmoothStepPathParams$1, GetStraightPathParams as GetStraightPathParams$1, Handle as Handle$1, HandleConnection, HandleConnection as HandleConnection$1, HandleProps, HandleType, InternalNodeBase, IsValidConnection as IsValidConnection$1, MarkerProps, MarkerType, NodeBase, NodeConnection, NodeConnection as NodeConnection$1, NodeOrigin, NodeOrigin as NodeOrigin$1, NodeProps as NodeProps$1, OnBeforeDeleteBase, OnConnect as OnConnect$1, OnConnectEnd as OnConnectEnd$1, OnConnectStart as OnConnectStart$1, OnConnectStartParams as OnConnectStartParams$1, OnError as OnError$1, OnMove, OnMove as OnMove$1, OnMoveEnd as OnMoveEnd$1, OnMoveStart as OnMoveStart$1, OnReconnect as OnReconnect$1, OnReconnectEnd as OnReconnectEnd$1, OnReconnectStart as OnReconnectStart$1, OnResize as OnResize$1, OnResizeEnd as OnResizeEnd$1, OnResizeStart as OnResizeStart$1, OnSelectionDrag as OnSelectionDrag$1, PanOnScrollMode, PanOnScrollMode as PanOnScrollMode$1, PanelPosition, PanelPosition as PanelPosition$1, Position, Position as Position$1, ProOptions as ProOptions$1, Rect as Rect$1, ResizeControlVariant, ResizeControlVariant as ResizeControlVariant$1, ResizeDragEvent as ResizeDragEvent$1, ResizeParams as ResizeParams$1, ResizeParamsWithDirection as ResizeParamsWithDirection$1, SelectionMode as SelectionMode$1, SelectionRect as SelectionRect$1, SetCenter, SetCenterOptions as SetCenterOptions$1, SetViewport, ShouldResize, ShouldResize as ShouldResize$1, SmoothStepPathOptions as SmoothStepPathOptions$1, SnapGrid as SnapGrid$1, StepPathOptions, Transform as Transform$1, UpdateNodeInternals, Viewport, Viewport as Viewport$1, ViewportHelperFunctionOptions as ViewportHelperFunctionOptions$1, XYPosition, XYPosition as XYPosition$1, XYZPosition as XYZPosition$1, ZIndexMode, ZoomInOut, addEdge, getBezierEdgeCenter as getBezierEdgeCenter$1, getBezierPath, getConnectedEdges, getEdgeCenter as getEdgeCenter$1, getIncomers, getNodesBounds, getOutgoers, getSmoothStepPath, getStraightPath, getViewportForBounds } from "@xyflow/system";
 import { Accessor, ParentComponent, ParentProps, Store, StoreSetter } from "solid-js";
 //#region src/types/custom.d.ts
+/** An arbitrary string-keyed record — the unconstrained default for node/edge data. */
 type UnknownStruct = Record<string, unknown>;
 //#endregion
 //#region src/types/node.d.ts
@@ -26,10 +27,14 @@ type Node<NodeData extends UnknownStruct = UnknownStruct, NodeType extends strin
    */
   ariaRole?: JSX.HTMLAttributes<HTMLDivElement>["role"];
   /**
-   * General escape hatch for adding custom attributes to the node's DOM element.
+   * General escape hatch for adding custom attributes to the node's DOM
+   * element. Event handlers, refs, and content-injection props are excluded
+   * (Svelte Flow parity: their omit of `keyof DOMAttributes`); interaction
+   * belongs on the node component, not here.
    */
-  domAttributes?: Omit<JSX.HTMLAttributes<HTMLDivElement>, "id" | "style" | "class" | "draggable" | "role" | "aria-label" | keyof JSX.HTMLAttributes<HTMLDivElement>>;
+  domAttributes?: Omit<JSX.HTMLAttributes<HTMLDivElement>, "id" | "style" | "class" | "draggable" | "role" | "aria-label" | "innerHTML" | "textContent" | "children" | keyof JSX.CustomAttributes<HTMLDivElement> | keyof JSX.EventHandlersElement<HTMLDivElement> | keyof JSX.EventHandlersWindow<HTMLDivElement>>;
 };
+/** Props passed to a node component (custom or built-in). */
 type NodeProps<TData extends UnknownStruct = UnknownStruct, TType extends string | undefined = string | undefined> = NodeProps$1<Node<TData, TType>>;
 /**
  * Map of node types to their components.
@@ -37,9 +42,11 @@ type NodeProps<TData extends UnknownStruct = UnknownStruct, TType extends string
 type NodeTypes = { [K in string]: {
   bivarianceHack(props: NodeProps<Record<string, unknown>, string | undefined>): JSX.Element;
 }["bivarianceHack"]; };
+/** Union of the built-in node shapes (input, output, default, group). */
 type BuiltInNode = Node<{
   label: string;
 }, "input" | "output" | "default"> | Node<Record<string, never>, "group">;
+/** The built-in node renderer map, keyed by node type. */
 type BuiltInNodeTypes = {
   input: (props: NodeProps<{
     label: string;
@@ -115,10 +122,13 @@ type BaseEdgeProps = {
 type BezierEdgeProps = EdgeProps<Record<string, unknown>, "default"> & {
   pathOptions?: BezierPathOptions$1;
 };
+/** Props for the built-in straight edge. */
 type StraightEdgeProps = Omit<EdgeProps<Record<string, unknown>, "straight">, "sourcePosition" | "targetPosition">;
+/** Props for the built-in step edge. */
 type StepEdgeProps = EdgeProps<Record<string, unknown>, "step"> & {
   pathOptions?: StepPathOptions;
 };
+/** Props for the built-in smooth-step edge. */
 type SmoothStepEdgeProps = EdgeProps<Record<string, unknown>, "smoothstep"> & {
   pathOptions?: SmoothStepPathOptions$1;
 };
@@ -141,6 +151,7 @@ type BuiltInEdge = BezierEdgeProps | StraightEdgeProps | StepEdgeProps | SmoothS
 type EdgeTypes = { [K in string]: {
   bivarianceHack(props: EdgeProps<Record<string, unknown>, string | undefined>): JSX.Element;
 }["bivarianceHack"]; };
+/** Defaults applied to every new edge added to the flow. */
 type DefaultEdgeOptions = DefaultEdgeOptionsBase<Edge>;
 type EdgeLayouted<EdgeType extends Edge = Edge> = EdgeType & EdgePosition & {
   sourceNode?: Node;
@@ -164,6 +175,7 @@ type NodeTargetEventWithPointer<T = PointerEvent, NodeType extends Node = Node>
   nodes: NodeType[];
   event: T;
 }) => void;
+/** Node pointer and drag event handlers accepted by the flow. */
 type NodeEvents<NodeType extends Node = Node> = {
   /** This event handler is called when a user clicks on a node. */
   onNodeClick?: NodeEventWithPointer<MouseEvent | TouchEvent, NodeType>;
@@ -182,12 +194,14 @@ type NodeEvents<NodeType extends Node = Node> = {
   /** This event handler is called when the pointer of a user moves over a node. */
   onNodePointerMove?: NodeEventWithPointer<PointerEvent, NodeType>;
 };
+/** Selection-box event handlers. */
 type NodeSelectionEvents<NodeType extends Node = Node> = {
   /** This event handler is called when a user right-clicks the selection box. */
   onSelectionContextMenu?: NodesEventWithPointer<PointerEvent, NodeType>;
   /** This event handler is called when a user clicks the selection box. */
   onSelectionClick?: NodesEventWithPointer<MouseEvent, NodeType>;
 };
+/** Pane (background) event handlers. */
 type PaneEvents = {
   /** This event handler is called when a user clicks the pane. */
   onPaneClick?: ({ event }: {
@@ -198,6 +212,7 @@ type PaneEvents = {
     event: PointerEvent;
   }) => void;
 };
+/** Edge pointer event handlers. */
 type EdgeEvents<EdgeType extends Edge = Edge> = {
   /** This event handler is called when a user clicks an edge. */
   onEdgeClick?: ({ edge, event }: {
@@ -220,10 +235,12 @@ type EdgeEvents<EdgeType extends Edge = Edge> = {
     event: PointerEvent;
   }) => void;
 };
+/** Handlers fired after node/edge deletions. */
 type DeleteEvents<NodeType extends Node = Node, EdgeType extends Edge = Edge> = {
   onNodesDelete?: (nodes: NodeType[]) => void;
   onEdgesDelete?: (edges: EdgeType[]) => void;
 };
+/** Handlers for edge reconnection gestures. */
 type EdgeReconnectEvents<EdgeType extends Edge = Edge> = {
   /**
    * This handler is called when the source or target of a reconnectable edge is dragged from the
@@ -241,7 +258,7 @@ type EdgeReconnectEvents<EdgeType extends Edge = Edge> = {
    */
   onReconnectEnd?: (event: MouseEvent | TouchEvent, edge: EdgeType, handleType: HandleType, connectionState: FinalConnectionState) => void;
 };
-type OnSelectionDrag$1<NodeType extends Node = Node> = (event: MouseEvent, nodes: NodeType[]) => void;
+type OnSelectionDrag$2<NodeType extends Node = Node> = (event: MouseEvent, nodes: NodeType[]) => void;
 //#endregion
 //#region src/types/general.d.ts
 type Position$2 = `${Position$1}`;
@@ -272,25 +289,34 @@ type ConnectionLineComponentProps<NodeType extends Node = Node> = {
 type SelectionMode$2 = `${SelectionMode$1}`;
 type PanOnScrollMode$2 = `${PanOnScrollMode$1}`;
 type ResizeControlVariant$2 = `${ResizeControlVariant$1}`;
+/** A single keyboard modifier key. */
 type ShortcutModifier = "alt" | "ctrl" | "meta" | "shift";
+/** Modifier requirement for a shortcut: none (`null`/`false`), one modifier, or a list that must all be held. */
 type ShortcutModifierDefinition = null | false | ShortcutModifier | (ShortcutModifier | ShortcutModifier[])[];
+/** Alias of `ShortcutModifierDefinition`. */
 type KeyModifier = ShortcutModifierDefinition;
+/** A key name plus an optional modifier requirement. */
 type KeyDefinitionObject = {
   key: string;
   modifier?: KeyModifier;
 };
+/** A shortcut key: a plain key name or a `KeyDefinitionObject`. */
 type KeyDefinition = string | KeyDefinitionObject;
+/** Live state of an in-progress connection gesture. */
 type ConnectionData = {
   connectionPosition: XYPosition$1 | null;
   connectionStartHandle: Handle$1 | null;
   connectionEndHandle: Handle$1 | null;
   connectionStatus: string | null;
 };
+/** Options for `fitView`: padding, zoom bounds, duration, and the node subset to fit. */
 type FitViewOptions<NodeType extends Node = Node> = FitViewOptionsBase<NodeType>;
+/** Handler called after nodes and/or edges are deleted. */
 type OnDelete<NodeType extends Node = Node, EdgeType extends Edge = Edge> = (params: {
   nodes: NodeType[];
   edges: EdgeType[];
 }) => void;
+/** A connection together with the id of the edge it produced. */
 type EdgeConnection = Connection$1 & {
   id: string;
 };
@@ -298,17 +324,22 @@ type EdgeConnection = Connection$1 & {
 type OnBeforeEdgeConnect<EdgeType extends Edge = Edge> = (connection: EdgeConnection) => EdgeType | EdgeConnection | undefined;
 /** Callback that gets called after a handle connection is created. */
 type OnEdgeConnect = (connection: EdgeConnection) => void;
+/** Callback fired before a reconnect is applied; return the modified edge, or `undefined` to cancel. */
 type OnBeforeReconnect<EdgeType extends Edge = Edge> = (newEdge: EdgeType, oldEdge: EdgeType) => EdgeType | undefined;
+/** Callback fired before nodes/edges are deleted; can abort or narrow the deletion. */
 type OnBeforeDelete<NodeType extends Node = Node, EdgeType extends Edge = Edge> = OnBeforeDeleteBase<NodeType, EdgeType>;
-type IsValidConnection$1<EdgeType extends Edge = Edge> = (edge: EdgeType | Connection$1) => boolean;
+type IsValidConnection$2<EdgeType extends Edge = Edge> = (edge: EdgeType | Connection$1) => boolean;
+/** Handler called when the set of selected nodes and edges changes. */
 type OnSelectionChange<NodeType extends Node = Node, EdgeType extends Edge = Edge> = (params: {
   nodes: NodeType[];
   edges: EdgeType[];
 }) => void;
+/** A nodes + edges pair describing a (sub)graph. */
 type NodeGraph<NodeType extends Node = Node, EdgeType extends Edge = Edge> = {
   readonly nodes: NodeType[];
   readonly edges: EdgeType[];
 };
+/** Callback that maps a completed connection to the edge to create. */
 type OnEdgeCreate<EdgeType extends Edge = Edge> = (connection: Connection$1) => EdgeType | Connection$1;
 //#endregion
 //#region src/components/connection/ConnectionLine.d.ts
@@ -318,6 +349,7 @@ type ConnectionLineProps<NodeType extends Node = Node> = {
   readonly component: (props: ConnectionLineComponentProps<NodeType>) => JSX.Element;
   readonly containerStyle: string | JSX.CSSProperties;
 };
+/** Internal component rendering the in-progress connection line. */
 declare const ConnectionLine: <NodeType extends Node = Node>(props: ParentProps<Partial<ConnectionLineProps<NodeType>>>) => JSX.Element;
 //#endregion
 //#region src/components/container/EdgeRenderer.d.ts
@@ -325,12 +357,14 @@ type EdgeRendererProps<EdgeType extends Edge = Edge> = EdgeEvents<EdgeType> & {
   readonly defaultEdgeOptions?: DefaultEdgeOptions;
   readonly reconnectRadius: number;
 };
+/** Internal renderer iterating the edge id list into `EdgeWrapper`s. */
 declare const EdgeRenderer: <NodeType extends Node = Node, EdgeType extends Edge = Edge>(props: EdgeRendererProps<EdgeType>) => JSX.Element;
 //#endregion
 //#region src/components/container/NodeRenderer.d.ts
 type NodeRendererProps<NodeType extends Node = Node> = NodeEvents<NodeType> & {
   readonly nodeClickDistance: number;
 };
+/** Internal renderer iterating the node id list into `NodeWrapper`s; owns the shared measurement `ResizeObserver`. */
 declare const NodeRenderer: <NodeType extends Node = Node>(props: NodeRendererProps<NodeType>) => JSX.Element;
 //#endregion
 //#region src/components/container/Pane.d.ts
@@ -342,6 +376,7 @@ type PaneProps = PaneEvents & {
   readonly onSelectionStart?: (event: PointerEvent) => void;
   readonly onSelectionEnd?: (event: PointerEvent) => void;
 };
+/** Internal interaction surface handling pane clicks, the selection box, and pan gestures. */
 declare const Pane: <NodeType extends Node = Node, EdgeType extends Edge = Edge>(props: ParentProps<PaneProps>) => JSX.Element;
 //#endregion
 //#region src/components/container/Panel.d.ts
@@ -354,9 +389,11 @@ type PanelProps = Omit<JSX.HTMLAttributes<HTMLDivElement>, "style"> & {
   readonly "data-testid"?: string;
   readonly "data-message"?: string;
 };
+/** Positioned overlay container for UI placed above the flow (used by `Controls`, `MiniMap`, attribution). */
 declare const Panel: (props: ParentProps<PanelProps>) => JSX.Element;
 //#endregion
 //#region src/components/container/ViewportPortal.d.ts
+/** Portals children into graph coordinate space so they pan and zoom with the viewport. */
 declare const ViewportPortal: (props: ParentProps) => JSX.Element;
 //#endregion
 //#region src/components/container/Zoom.d.ts
@@ -377,15 +414,19 @@ type ZoomProps = {
   readonly paneClickDistance: number;
   readonly selectionOnDrag?: boolean;
 };
+/** Internal viewport controller wiring pan/zoom gestures (XYPanZoom) to the flow. */
 declare const Zoom: (props: ParentProps<ZoomProps>) => JSX.Element;
 //#endregion
 //#region src/components/edge/BaseEdge.d.ts
+/** Lowest-level edge primitive: renders the SVG path, label, and interaction width. */
 declare const BaseEdge: (props: ParentProps<BaseEdgeProps>) => JSX.Element;
 //#endregion
 //#region src/components/edge/BezierEdge.d.ts
+/** Built-in bezier edge component. */
 declare const BezierEdge: (props: BezierEdgeProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/BezierEdgeInternal.d.ts
+/** Renderer-internal bezier edge variant. */
 declare const BezierEdgeInternal: (props: BezierEdgeProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/EdgeLabel.d.ts
@@ -398,9 +439,11 @@ type EdgeLabelProps = {
   readonly transparent?: boolean;
   readonly style?: JSX.CSSProperties;
 } & Omit<JSX.HTMLAttributes<HTMLDivElement>, "style">;
+/** Renders an edge label positioned in graph coordinates. */
 declare const EdgeLabel: (props: ParentProps<EdgeLabelProps>) => JSX.Element;
 //#endregion
 //#region src/components/edge/EdgeLabelRenderer.d.ts
+/** Portals edge labels into a shared HTML layer rendered above the edge SVG. */
 declare const EdgeLabelRenderer: (props: ParentProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/EdgeReconnectAnchor.d.ts
@@ -410,32 +453,45 @@ type EdgeReconnectAnchorProps = {
   readonly style?: JSX.CSSProperties;
   readonly position?: XYPosition$1;
   readonly size?: number;
+  /** Externally mark the anchor as reconnecting (hides its children), in
+   * addition to the gesture-driven internal state. */
   readonly reconnecting?: boolean;
+  /** Called when a reconnect gesture on this anchor starts/ends — the Solid
+   * translation of Svelte Flow's `bind:reconnecting`. */
+  readonly onReconnectingChange?: (reconnecting: boolean) => void;
 } & Omit<JSX.HTMLAttributes<HTMLDivElement>, "style">;
+/** Grab area that lets an edge end be dragged off its handle and reconnected. */
 declare const EdgeReconnectAnchor: (props: ParentProps<EdgeReconnectAnchorProps>) => JSX.Element;
 //#endregion
 //#region src/components/edge/EdgeWrapper.d.ts
 type EdgeWrapperProps<EdgeType extends Edge = Edge> = EdgeEvents<EdgeType> & {
   readonly edgeId: string;
 };
+/** Internal per-edge wrapper: interaction, a11y, viewport culling, and the dynamic edge component. */
 declare const EdgeWrapper: <NodeType extends Node = Node, EdgeType extends Edge = Edge>(props: EdgeWrapperProps<EdgeType>) => JSX.Element;
 //#endregion
 //#region src/components/edge/SmoothStepEdge.d.ts
+/** Built-in smooth-step edge component. */
 declare const SmoothStepEdge: (props: SmoothStepEdgeProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/SmoothStepEdgeInternal.d.ts
+/** Renderer-internal smooth-step edge variant. */
 declare const SmoothStepEdgeInternal: (props: SmoothStepEdgeProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/StepEdge.d.ts
+/** Built-in step edge component. */
 declare const StepEdge: (props: StepEdgeProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/StepEdgeInternal.d.ts
+/** Renderer-internal step edge variant. */
 declare const StepEdgeInternal: (props: StepEdgeProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/StraightEdge.d.ts
+/** Built-in straight edge component. */
 declare const StraightEdge: (props: StraightEdgeProps) => JSX.Element;
 //#endregion
 //#region src/components/edge/StraightEdgeInternal.d.ts
+/** Renderer-internal straight edge variant. */
 declare const StraightEdgeInternal: (props: Omit<StraightEdgeProps, "sourcePosition" | "targetPosition">) => JSX.Element;
 //#endregion
 //#region src/components/handle/Handle.d.ts
@@ -446,6 +502,7 @@ type HandleProps$1 = Omit<HandleProps, "position"> & {
   readonly onConnect?: (connections: Connection$1[]) => void;
   readonly onDisconnect?: (connections: Connection$1[]) => void;
 } & Omit<JSX.HTMLAttributes<HTMLDivElement>, "style">;
+/** Connection point on a node; place inside custom nodes to make them connectable. */
 declare const Handle: <NodeType extends Node = Node, EdgeType extends Edge = Edge>(props: ParentProps<HandleProps$1>) => JSX.Element;
 //#endregion
 //#region src/components/marker/Marker.d.ts
@@ -453,20 +510,25 @@ type MarkerProps$1 = MarkerProps & {
   readonly markerUnits?: "strokeWidth" | "userSpaceOnUse";
   readonly strokeWidth?: number;
 };
+/** Internal SVG `<marker>` definition for one edge marker configuration. */
 declare const Marker: (props: MarkerProps$1) => JSX.Element;
 //#endregion
 //#region src/components/marker/MarkerDefinition.d.ts
+/** Internal collector rendering every unique edge marker into one SVG defs block. */
 declare const MarkerDefinition: () => JSX.Element;
 //#endregion
 //#region src/components/node/DefaultNode.d.ts
+/** Built-in default node: label with source and target handles. */
 declare const DefaultNode: (props: NodeProps<{
   label: string;
 }, "default">) => JSX.Element;
 //#endregion
 //#region src/components/node/GroupNode.d.ts
+/** Built-in group node: a plain container for child nodes. */
 declare const GroupNode: (props: NodeProps<Record<string, never>>) => JSX.Element;
 //#endregion
 //#region src/components/node/InputNode.d.ts
+/** Built-in input node: label with a source handle only. */
 declare const InputNode: (props: NodeProps<{
   label: string;
 }>) => JSX.Element;
@@ -477,15 +539,18 @@ type NodeWrapperProps<NodeType extends Node = Node> = NodeEvents<NodeType> & {
   readonly resizeObserver: ResizeObserver | undefined;
   readonly nodeClickDistance: number;
 };
+/** Internal per-node wrapper: dragging, selection, a11y, measurement, viewport culling, and the dynamic node component. */
 declare const NodeWrapper: <NodeType extends Node = Node>(props: NodeWrapperProps<NodeType>) => JSX.Element;
 //#endregion
 //#region src/components/node/OutputNode.d.ts
+/** Built-in output node: label with a target handle only. */
 declare const OutputNode: (props: NodeProps<{
   label: string;
 }>) => JSX.Element;
 //#endregion
 //#region src/components/selection/NodeSelection.d.ts
 type NodeSelectionProps<NodeType extends Node = Node> = NodeSelectionEvents<NodeType> & Pick<NodeEvents<NodeType>, "onNodeDrag" | "onNodeDragStart" | "onNodeDragStop">;
+/** Internal draggable bounding box rendered around multi-selected nodes. */
 declare const NodeSelection: <NodeType extends Node = Node>(props: NodeSelectionProps<NodeType>) => JSX.Element;
 //#endregion
 //#region src/components/selection/Selection.d.ts
@@ -496,9 +561,11 @@ type SelectionProps = {
   readonly height?: number | string;
   readonly isVisible?: boolean;
 };
+/** Internal selection-rectangle visual. */
 declare const Selection: (props: SelectionProps) => JSX.Element;
 //#endregion
 //#region src/core/flowProps.d.ts
+/** Initial (uncontrolled) values used to seed a flow before the first measure/fit. */
 type SolidFlowInitialProps = {
   readonly initialNodes: Node[];
   readonly initialEdges: Edge[];
@@ -507,6 +574,10 @@ type SolidFlowInitialProps = {
   readonly fitView: boolean;
   readonly nodeOrigin: NodeOrigin$1;
 };
+/**
+ * Props accepted by the `SolidFlow` component — the full configuration surface
+ * of a flow, and the config contract of the headless core (`createFlowState`).
+ */
 type SolidFlowProps<NodeType extends Node = Node, EdgeType extends Edge = Edge> = NodeEvents<NodeType> & NodeSelectionEvents<NodeType> & EdgeEvents<EdgeType> & DeleteEvents<NodeType, EdgeType> & PaneEvents & {
   /**
    * The id of the flow. This is necessary if you want to render multiple flows.
@@ -783,13 +854,25 @@ type SolidFlowProps<NodeType extends Node = Node, EdgeType extends Edge = Edge>
    */
   readonly selectionOnDrag?: boolean;
   /**
-   * Viewport culling: elements outside the (overscanned) viewport are hidden
-   * with CSS (`visibility: hidden` + `pointer-events: none`). Everything
-   * stays mounted — custom nodes keep their DOM state off-screen, and
-   * measurement/fitView/minimap are unaffected. Selected elements are never
-   * culled. Set to `false` to keep every element visible; note that culled
-   * elements leave the accessibility tree and tab order while off-screen.
-   * @default true
+   * Only render (mount) elements inside the overscanned viewport: nodes and
+   * edges outside it are unmounted entirely, and remount as the viewport
+   * reaches them. This is the heavy-duty tier for very large graphs — at
+   * 10k nodes it cuts the DOM by ~16x, roughly halves memory, and makes
+   * node drags ~3.7x faster (fewer live subscribers).
+   *
+   * The flow's data graph is unaffected: positions, selection, and cached
+   * measurements live outside the components, so an unmounted node comes
+   * back exactly as it left (at its measured size, still selected).
+   * Component-LOCAL state does not survive — signals created inside a
+   * custom node, uncontrolled inputs, scroll positions of inner elements.
+   * Keep state you care about in `node.data`. Never unmounted: selected
+   * elements, unmeasured nodes, and the node holding DOM focus.
+   *
+   * Independent of this prop, off-viewport elements are always CSS-culled
+   * (`visibility: hidden` + `pointer-events: none`, everything stays
+   * mounted) — that tier has no user-visible semantics beyond leaving the
+   * accessibility tree and tab order while off-screen.
+   * @default false
    */
   readonly onlyRenderVisibleElements?: boolean;
   /**
@@ -896,7 +979,7 @@ type SolidFlowProps<NodeType extends Node = Node, EdgeType extends Edge = Edge>
    * before doing so.
    */
   readonly proOptions?: ProOptions$1;
-  readonly isValidConnection?: IsValidConnection$1<EdgeType>;
+  readonly isValidConnection?: IsValidConnection$2<EdgeType>;
   /** This event handler is called when the user begins to pan or zoom the viewport */
   readonly onMoveStart?: OnMoveStart$1;
   /** This event handler is called when the user pans or zooms the viewport */
@@ -944,11 +1027,11 @@ type SolidFlowProps<NodeType extends Node = Node, EdgeType extends Edge = Edge>
   /** This event handler gets called when the selected nodes & edges change */
   readonly onSelectionChange?: OnSelectionChange<NodeType, EdgeType>;
   /** This event handler gets called when a user starts to drag a selection box. */
-  readonly onSelectionDragStart?: OnSelectionDrag$1<NodeType>;
+  readonly onSelectionDragStart?: OnSelectionDrag$2<NodeType>;
   /** This event handler gets called when a user drags a selection box. */
-  readonly onSelectionDrag?: OnSelectionDrag$1<NodeType>;
+  readonly onSelectionDrag?: OnSelectionDrag$2<NodeType>;
   /** This event handler gets called when a user stops dragging a selection box. */
-  readonly onSelectionDragStop?: OnSelectionDrag$1<NodeType>;
+  readonly onSelectionDragStop?: OnSelectionDrag$2<NodeType>;
   /** This event handler gets called when the user starts to drag a selection box */
   readonly onSelectionStart?: (event: PointerEvent) => void;
   /** This event handler gets called when the user finishes dragging a selection box */
@@ -960,20 +1043,33 @@ type SolidFlowProps<NodeType extends Node = Node, EdgeType extends Edge = Edge>
   readonly ariaLabelConfig?: Partial<AriaLabelConfig$1>;
 };
 //#endregion
-//#region src/components/SolidFlow/component.d.ts
+//#region src/components/SolidFlow.d.ts
 type SolidFlowComponentProps<NodeType extends Node = Node, EdgeType extends Edge = Edge> = ParentProps<SolidFlowProps<NodeType, EdgeType>> & Omit<JSX.HTMLAttributes<HTMLDivElement>, "style" | "onselectionchange" | "onSelectionChange">;
+/** The flow canvas component: renders nodes and edges and wires up viewport and interactions. */
 declare const SolidFlow: <NodeType extends Node = Node, EdgeType extends Edge = Edge>(props: SolidFlowComponentProps<NodeType, EdgeType>) => JSX.Element;
 //#endregion
-//#region src/components/SolidFlow/provider.d.ts
+//#region src/components/SolidFlowProvider.d.ts
+/** Hoists flow state above `SolidFlow` so hooks work outside the component (multi-panel UIs). */
 declare const SolidFlowProvider: <NodeType extends Node = Node, EdgeType extends Edge = Edge>(props: ParentProps<SolidFlowProps<NodeType, EdgeType>>) => JSX.Element;
 //#endregion
 //#region src/core/createEdgeStore.d.ts
-type ExtractEdgeInfo<T> = T extends ((props: EdgeProps<infer TData, infer TType>) => unknown) ? {
-  data: TData;
-  type: TType;
-} : never;
+type EdgeDataOf<T> = T extends ((props: EdgeProps<infer TData, infer _TType>) => unknown) ? TData : UnknownStruct;
 type AllEdgeTypes<TUserEdgeTypes extends EdgeTypes> = TUserEdgeTypes extends Record<string, never> ? BuiltInEdgeTypes : BuiltInEdgeTypes & TUserEdgeTypes;
-type EdgesInput<TUserEdgeTypes extends EdgeTypes> = { [K in keyof AllEdgeTypes<TUserEdgeTypes>]: Edge<ExtractEdgeInfo<AllEdgeTypes<TUserEdgeTypes>[K]>["data"], ExtractEdgeInfo<AllEdgeTypes<TUserEdgeTypes>[K]>["type"]>; }[keyof AllEdgeTypes<TUserEdgeTypes>];
+/**
+ * The discriminated union of edge configurations for a renderer map: one
+ * member per built-in and custom edge type, with `data` narrowed by the
+ * `type` discriminant (the MAP KEY — what the renderer actually matches).
+ * Use it to carry `createEdgeStore`'s guided typing anywhere a plain array
+ * or vanilla store is typed:
+ *
+ * ```typescript
+ * const initialEdges = [
+ *   { id: "e1", source: "1", target: "2", type: "labeled", data: { label: "hi" } },
+ * ] satisfies EdgesFor<typeof edgeTypes>[];
+ * ```
+ */
+type EdgesFor<TUserEdgeTypes extends EdgeTypes = Record<string, never>> = { [K in keyof AllEdgeTypes<TUserEdgeTypes>]: Edge<EdgeDataOf<AllEdgeTypes<TUserEdgeTypes>[K]>, K & string>; }[keyof AllEdgeTypes<TUserEdgeTypes>];
+type EdgesInput<TUserEdgeTypes extends EdgeTypes> = EdgesFor<TUserEdgeTypes>;
 /**
  * Creates a type-safe reactive store of edges for use in Solid Flow.
  *
@@ -1050,7 +1146,7 @@ type EdgesInput<TUserEdgeTypes extends EdgeTypes> = { [K in keyof AllEdgeTypes<T
  * - Works seamlessly with both built-in and custom node types
  * - Type errors prevent invalid type names or incorrect data structures
  */
-declare const createEdgeStore: <TUserEdgeTypes extends EdgeTypes = Record<string, never>>(edges: EdgesInput<TUserEdgeTypes>[]) => readonly [Store<EdgesInput<TUserEdgeTypes>[]>, StoreSetter<EdgesInput<TUserEdgeTypes>[]>];
+declare const createEdgeStore: <TUserEdgeTypes extends EdgeTypes = Record<string, never>>(edges: NoInfer<EdgesInput<TUserEdgeTypes>>[]) => readonly [Store<EdgesInput<TUserEdgeTypes>[]>, StoreSetter<EdgesInput<TUserEdgeTypes>[]>];
 //#endregion
 //#region src/core/projections/connections.d.ts
 /**
@@ -1060,6 +1156,7 @@ declare const createEdgeStore: <TUserEdgeTypes extends EdgeTypes = Record<string
  *   `${nodeId}` · `${nodeId}-${type}` · `${nodeId}-${type}-${handleId}`
  */
 declare const connectionKey: (nodeId: string, type?: HandleType, handleId?: string | null) => string;
+/** The connections index: a handle's `connectionKey` mapped to its live `HandleConnection`s. */
 type ConnectionsRecord = Record<string, Record<string, HandleConnection$1>>;
 //#endregion
 //#region src/core/flowState.d.ts
@@ -1205,12 +1302,23 @@ type FlowCommands<NodeType extends Node = Node, EdgeType extends Edge = Edge> =
 };
 //#endregion
 //#region src/core/createNodeStore.d.ts
-type ExtractNodeInfo<T> = T extends ((props: NodeProps<infer TData, infer TType>) => unknown) ? {
-  data: TData;
-  type: TType;
-} : never;
+type NodeDataOf<T> = T extends ((props: NodeProps<infer TData, infer _TType>) => unknown) ? TData : UnknownStruct;
 type AllNodeTypes<TUserNodeTypes extends NodeTypes> = TUserNodeTypes extends Record<string, never> ? BuiltInNodeTypes : BuiltInNodeTypes & TUserNodeTypes;
-type NodesInput<TUserNodeTypes extends NodeTypes> = { [K in keyof AllNodeTypes<TUserNodeTypes>]: Node<ExtractNodeInfo<AllNodeTypes<TUserNodeTypes>[K]>["data"], ExtractNodeInfo<AllNodeTypes<TUserNodeTypes>[K]>["type"]>; }[keyof AllNodeTypes<TUserNodeTypes>];
+/**
+ * The discriminated union of node configurations for a renderer map: one
+ * member per built-in and custom node type, with `data` narrowed by the
+ * `type` discriminant (the MAP KEY — what the renderer actually matches).
+ * Use it to carry `createNodeStore`'s guided typing anywhere a plain array
+ * or vanilla store is typed:
+ *
+ * ```typescript
+ * const initialNodes = [
+ *   { id: "1", type: "custom", position: { x: 0, y: 0 }, data: { value: 1 } },
+ * ] satisfies NodesFor<typeof nodeTypes>[];
+ * ```
+ */
+type NodesFor<TUserNodeTypes extends NodeTypes = Record<string, never>> = { [K in keyof AllNodeTypes<TUserNodeTypes>]: Node<NodeDataOf<AllNodeTypes<TUserNodeTypes>[K]>, K & string>; }[keyof AllNodeTypes<TUserNodeTypes>];
+type NodesInput<TUserNodeTypes extends NodeTypes> = NodesFor<TUserNodeTypes>;
 /**
  * Creates a type-safe reactive store of nodes for use in Solid Flow.
  *
@@ -1282,7 +1390,7 @@ type NodesInput<TUserNodeTypes extends NodeTypes> = { [K in keyof AllNodeTypes<T
  * - Works seamlessly with both built-in and custom node types
  * - Type errors prevent invalid type names or incorrect data structures
  */
-declare const createNodeStore: <TUserNodeTypes extends NodeTypes = Record<string, never>>(nodes: NodesInput<TUserNodeTypes>[]) => readonly [Store<NodesInput<TUserNodeTypes>[]>, StoreSetter<NodesInput<TUserNodeTypes>[]>];
+declare const createNodeStore: <TUserNodeTypes extends NodeTypes = Record<string, never>>(nodes: NoInfer<NodesInput<TUserNodeTypes>>[]) => readonly [Store<NodesInput<TUserNodeTypes>[]>, StoreSetter<NodesInput<TUserNodeTypes>[]>];
 //#endregion
 //#region src/hooks/useColorMode.d.ts
 /**
@@ -1312,14 +1420,14 @@ declare function useConnection(): Accessor<ConnectionState>;
  * @public
  * @returns store with an array of nodes
  */
-declare function useNodes<NodeType extends Node = Node>(): Accessor<NodeType[]>;
+declare function useNodes<NodeType extends Node = Node>(): Accessor<readonly NodeType[]>;
 /**
  * Hook for getting the current edges from the store.
  *
  * @public
  * @returns store with an array of edges
  */
-declare function useEdges<EdgeType extends Edge = Edge>(): Accessor<EdgeType[]>;
+declare function useEdges<EdgeType extends Edge = Edge>(): Accessor<readonly EdgeType[]>;
 /**
  * Hook for getting the current viewport from the store.
  *
@@ -1328,9 +1436,6 @@ declare function useEdges<EdgeType extends Edge = Edge>(): Accessor<EdgeType[]>;
  */
 declare function useViewport(): Accessor<Viewport$1>;
 //#endregion
-//#region src/hooks/useHandleEdgeSelect.d.ts
-declare function useHandleEdgeSelect(): (id: string) => void;
-//#endregion
 //#region src/hooks/useInitialized.d.ts
 /**
  * Hook for seeing if all nodes have been measured.
@@ -1354,11 +1459,16 @@ declare function useViewportInitialized(): Accessor<boolean>;
 //#endregion
 //#region src/hooks/useInternalNode.d.ts
 /**
- * Hook to get an internal node by id.
+ * Hook to get an internal node (the node enriched with measured dimensions,
+ * absolute position, and z-order) by id.
+ *
+ * The id is an accessor (not a plain string) on purpose: passing a raw
+ * reactive read like `props.nodeId` would capture the value once and silently
+ * lose reactivity — `useInternalNode(() => props.nodeId)` keeps it live.
  *
  * @public
- * @param id - the node id
- * @returns an accessor with an internal node or undefined
+ * @param id - a reactive accessor for the node id
+ * @returns an accessor with the internal node, or undefined while absent
  */
 declare function useInternalNode(id: Accessor<string>): Accessor<InternalNode | undefined>;
 //#endregion
@@ -1390,6 +1500,7 @@ type NodeData<NodeType extends Node> = Pick<NodeType, "id" | "data" | "type">;
  * @returns A memo with an array of data objects
  */
 declare function useNodesData<NodeType extends Node = Node>(nodeId: Accessor<string | undefined | null>): Accessor<NodeData<NodeType> | undefined>;
+/** Reactive accessor for the `data` of one or many nodes by id. */
 declare function useNodesData<NodeType extends Node = Node>(nodeIds: Accessor<string[] | undefined | null>): Accessor<NodeData<NodeType>[]>;
 //#endregion
 //#region src/hooks/useSolidFlow.d.ts
@@ -1400,36 +1511,16 @@ declare function useNodesData<NodeType extends Node = Node>(nodeIds: Accessor<st
  * familiarity — `useSolidFlow().fitView()` and
  * `useSolidFlow().commands.fitView()` are the same function.
  *
- * The imperative getters are deprecated: event handlers are untracked scopes
- * in Solid, so reading `flow.viewport.zoom` (or `flow.internalNodes[id]`)
- * inside one already IS the imperative read — no wrapper needed — while the
- * same read in a tracked scope subscribes.
+ * There are no imperative getters: event handlers are untracked scopes in
+ * Solid, so reading `flow.viewport.zoom` (or `flow.internalNodes[id]`) inside
+ * one already IS the imperative read — while the same read in a tracked scope
+ * subscribes.
  */
 type UseSolidFlowReturn<NodeType extends Node = Node, EdgeType extends Edge = Edge> = FlowCommands<NodeType, EdgeType> & {
   /** The flow's data graph as one reactive struct — the canonical read surface. */
   readonly flow: FlowState<NodeType, EdgeType>;
   /** The flow's write surface (same functions as the spread members). */
   readonly commands: FlowCommands<NodeType, EdgeType>;
-  /** @deprecated Read `flow.internalNodes[id]` instead. */
-  readonly getInternalNode: (id: string) => InternalNode<NodeType> | undefined;
-  /** @deprecated Read `flow.internalNodes[id]?.internals.userNode` (or find in `flow.nodes`) instead. */
-  readonly getNode: (id: string) => NodeType | undefined;
-  /** @deprecated Read `flow.nodes` (or map ids over `flow.internalNodes`) instead. */
-  readonly getNodes: (ids?: string[]) => NodeType[];
-  /** @deprecated Read `flow.edges` (or find by id) instead. */
-  readonly getEdge: (id: string) => EdgeType | undefined;
-  /** @deprecated Read `flow.edges` (or filter by ids) instead. */
-  readonly getEdges: (ids?: string[]) => EdgeType[];
-  /** @deprecated Read `flow.viewport` instead. */
-  readonly getViewport: () => Viewport$1;
-  /** @deprecated Read `flow.viewport.zoom` instead. */
-  readonly getZoom: () => number;
-  /** @deprecated Read `flow.connections[connectionKey(nodeId, type, id)]` (or use `useNodeConnections`) instead. */
-  readonly getHandleConnections: (params: {
-    type: HandleType;
-    nodeId: string;
-    id?: string | null;
-  }) => HandleConnection$1[];
 };
 /**
  * Hook for accessing the flow instance: `{ flow, commands }` plus the
@@ -1439,7 +1530,7 @@ type UseSolidFlowReturn<NodeType extends Node = Node, EdgeType extends Edge = Ed
  * `const { flow, commands } = useSolidFlow()`.
  *
  * @public
- * @returns the flow's read struct, write surface, and deprecated aliases
+ * @returns the flow's read struct and write surface
  */
 declare function useSolidFlow<NodeType extends Node = Node, EdgeType extends Edge = Edge>(): UseSolidFlowReturn<NodeType, EdgeType>;
 //#endregion
@@ -1452,10 +1543,36 @@ declare function useSolidFlow<NodeType extends Node = Node, EdgeType extends Edg
  */
 declare function useUpdateNodeInternals(): UpdateNodeInternals;
 //#endregion
+//#region src/contexts/edgeId.d.ts
+/**
+ * Returns the id of the edge this component is rendered inside. Available
+ * anywhere in a custom edge's subtree (provided by the edge wrapper), so
+ * nested components — like a custom edge label — can learn their host edge
+ * without prop drilling.
+ *
+ * @public
+ * @returns a reactive accessor for the surrounding edge's id
+ */
+declare function useEdgeId(): Accessor<string>;
+//#endregion
+//#region src/contexts/nodeId.d.ts
+/**
+ * Returns the id of the node this component is rendered inside. Available
+ * anywhere in a custom node's subtree (provided by the node wrapper), so
+ * nested components — like a custom `Handle` — can learn their host node
+ * without prop drilling.
+ *
+ * @public
+ * @returns a reactive accessor for the surrounding node's id
+ */
+declare function useNodeId(): Accessor<string>;
+//#endregion
 //#region src/plugins/background/types.d.ts
+/** Available background pattern styles. */
 type BackgroundVariant = "lines" | "dots" | "cross";
 //#endregion
 //#region src/plugins/background/Background.d.ts
+/** Props for the `Background` plugin. */
 type BackgroundProps = {
   readonly id?: string;
   /** Variant of the pattern
@@ -1479,6 +1596,7 @@ type BackgroundProps = {
   /** Style applied to the container */
   readonly style?: JSX.CSSProperties;
 };
+/** Canvas background pattern (lines, dots, or cross) rendered beneath the graph. */
 declare const Background: (props: BackgroundProps) => JSX.Element;
 //#endregion
 //#region src/plugins/controls/ControlButton.d.ts
@@ -1491,6 +1609,7 @@ type ControlButtonProps = Omit<JSX.ButtonHTMLAttributes<HTMLButtonElement>, "onC
   readonly borderColor?: string;
   readonly onClick?: JSX.EventHandler<HTMLButtonElement, MouseEvent>;
 };
+/** A styled button for use inside `Controls`. */
 declare const ControlButton: (props: ParentProps<ControlButtonProps>) => JSX.Element;
 //#endregion
 //#region src/plugins/controls/Controls.d.ts
@@ -1518,11 +1637,42 @@ type ControlsProps = {
   readonly beforeControls?: JSX.Element;
   readonly afterControls?: JSX.Element;
 } & Omit<JSX.HTMLAttributes<HTMLDivElement>, "style">;
+/** Viewport control panel: zoom in/out, fit view, and interactivity lock. */
 declare const Controls: (props: ParentProps<ControlsProps>) => JSX.Element;
 //#endregion
+//#region src/plugins/minimap/MiniMapNode.d.ts
+/**
+ * Props passed to a minimap node renderer — the default `MiniMapNode` or a
+ * custom component supplied via the `MiniMap` `nodeComponent` prop. Position
+ * and dimensions are in flow coordinates (the minimap svg's viewBox space).
+ */
+type MiniMapNodeProps = {
+  /** The id of the node this minimap representation stands for. */
+  readonly id: string;
+  readonly class?: string;
+  readonly x: number;
+  readonly y: number;
+  readonly width?: number;
+  readonly height?: number;
+  readonly borderRadius?: number;
+  readonly color?: string;
+  readonly shapeRendering: JSX.RectSVGAttributes<SVGRectElement>["shape-rendering"];
+  readonly strokeColor?: string;
+  readonly strokeWidth?: number;
+  readonly selected?: boolean;
+  /** The node's own style; its background feeds the default fill fallback. */
+  readonly style?: JSX.CSSProperties;
+  /** Click handler (wired when the `MiniMap` has `onNodeClick`); call with the node id. */
+  readonly onClick?: (event: MouseEvent, id: string) => void;
+};
+/** The default minimap node: a rounded rect. Custom `nodeComponent`s can wrap it. */
+declare const MiniMapNode: (props: MiniMapNodeProps) => JSX.Element;
+//#endregion
 //#region src/plugins/minimap/MiniMap.d.ts
+/** Derives a per-node minimap attribute (color, stroke, class) from the node. */
 type GetMiniMapNodeAttribute<NodeType extends Node> = (node: NodeType) => string;
-type MiniMapProps<NodeType extends Node> = Omit<JSX.HTMLAttributes<HTMLDivElement>, "style"> & {
+/** Props for the `MiniMap` plugin. */
+type MiniMapProps<NodeType extends Node> = Omit<JSX.HTMLAttributes<HTMLDivElement>, "style" | "onClick"> & {
   /** Background color of minimap */
   readonly bgColor?: string;
   /** Color of nodes on the minimap */
@@ -1554,13 +1704,23 @@ type MiniMapProps<NodeType extends Node> = Omit<JSX.HTMLAttributes<HTMLDivElemen
   readonly width?: number;
   /** Height of minimap */
   readonly height?: number;
+  /** Called when the minimap pane is clicked, with the position in flow coordinates. */
+  readonly onClick?: (event: MouseEvent, position: XYPosition$1) => void;
+  /** Called when a node on the minimap is clicked. */
+  readonly onNodeClick?: (event: MouseEvent, node: NodeType) => void;
   readonly pannable?: boolean;
   readonly zoomable?: boolean;
+  /**
+   * Custom component rendering each node on the minimap (receives
+   * {@link MiniMapNodeProps}); defaults to the built-in rounded rect.
+   */
+  readonly nodeComponent?: (props: MiniMapNodeProps) => JSX.Element;
   /** Invert the direction when panning the minimap viewport */
   readonly inversePan?: boolean;
   /** Step size for zooming in/out */
   readonly zoomStep?: number;
 };
+/** Miniature overview map of the whole flow, with optional pan/zoom interaction. */
 declare const MiniMap: <NodeType extends Node>(props: ParentProps<Partial<MiniMapProps<NodeType>>>) => JSX.Element;
 //#endregion
 //#region src/plugins/nodeResizer/NodeResizer.d.ts
@@ -1600,6 +1760,7 @@ type NodeResizerProps = {
   /** Callback called when resizing ends */
   readonly onResizeEnd?: OnResizeEnd$1;
 } & Omit<JSX.HTMLAttributes<HTMLDivElement>, "onResize" | "style">;
+/** Resize handles and lines around a node; place inside a custom node to make it resizable. */
 declare const NodeResizer: (props: Partial<NodeResizerProps>) => JSX.Element;
 //#endregion
 //#region src/plugins/nodeResizer/ResizeControl.d.ts
@@ -1617,9 +1778,11 @@ type ResizeControlProps = NodeResizerSubProps & {
   readonly color?: string;
   readonly style?: JSX.CSSProperties;
 } & Omit<JSX.HTMLAttributes<HTMLDivElement>, "onResize" | "style">;
+/** A single resize handle or line — the building block of `NodeResizer`. */
 declare const ResizeControl: <NodeType extends Node = Node>(props: ParentProps<ResizeControlProps>) => JSX.Element;
 //#endregion
 //#region src/plugins/toolbar/EdgeToolbar.d.ts
+/** Props for the `EdgeToolbar` plugin. */
 type EdgeToolbarProps = EdgeToolbarBaseProps & {
   /** If `true`, clicking the toolbar selects the edge it belongs to. */
   readonly selectEdgeOnClick?: boolean;
@@ -1634,6 +1797,7 @@ type EdgeToolbarProps = EdgeToolbarBaseProps & {
 declare const EdgeToolbar: (props: ParentProps<EdgeToolbarProps>) => JSX.Element;
 //#endregion
 //#region src/plugins/toolbar/NodeToolbar.d.ts
+/** Props for the `NodeToolbar` plugin. */
 type NodeToolbarProps = Omit<JSX.HTMLAttributes<HTMLDivElement>, "style"> & {
   /** The id of the node, or array of ids the toolbar should be displayed at */
   readonly nodeId: string | string[];
@@ -1653,6 +1817,98 @@ type NodeToolbarProps = Omit<JSX.HTMLAttributes<HTMLDivElement>, "style"> & {
   /** Style of the toolbar */
   readonly style: Omit<JSX.CSSProperties, "z-index" | "position" | "transform">;
 };
+/** Toolbar attached to a node, rendered above the graph so it does not scale with zoom. */
 declare const NodeToolbar: ParentComponent<Partial<NodeToolbarProps>>;
 //#endregion
-export { type Align, type AriaLabelConfig, Background, type BackgroundProps, type BackgroundVariant, BaseEdge, BezierEdge, BezierEdgeInternal, type BezierEdgeProps, type BezierPathOptions, type Box, type BuiltInEdge, type BuiltInNode, type BuiltInNodeTypes, type ColorMode, type ColorModeClass, type Connection, ConnectionData, ConnectionLine, ConnectionLineComponentProps, ConnectionLineType, ConnectionMode, type ConnectionsRecord, ControlButton, type ControlLinePosition, type ControlPosition, Controls, type CoordinateExtent, type DefaultEdgeOptions, DefaultNode, DeleteEvents, type Dimensions, type Edge, EdgeConnection, EdgeEvents, EdgeLabel, EdgeLabelRenderer, type EdgeMarker, type EdgeMarkerType, type EdgeProps, EdgeReconnectAnchor, EdgeReconnectEvents, EdgeRenderer, EdgeToolbar, EdgeToolbarProps, type EdgeTypes, EdgeWrapper, type FitBounds, type FitBoundsOptions, FitViewOptions, type FlowCommands, type FlowSelection, type FlowState, type GetBezierPathParams, type GetSmoothStepPathParams, type GetStraightPathParams, GroupNode, Handle, type HandleConnection, InputNode, type InternalNode, IsValidConnection, KeyDefinition, KeyDefinitionObject, KeyModifier, Marker, MarkerDefinition, MarkerType, MiniMap, type Node, type NodeConnection, NodeEvents, NodeGraph, type NodeOrigin, type NodeProps, NodeRenderer, NodeResizer, NodeSelection, NodeSelectionEvents, NodeToolbar, NodeToolbarProps, type NodeTypes, NodeWrapper, OnBeforeDelete, OnBeforeEdgeConnect, OnBeforeReconnect, type OnConnect, type OnConnectEnd, type OnConnectStart, type OnConnectStartParams, OnDelete, OnEdgeConnect, OnEdgeCreate, type OnError, type OnMove, type OnMoveEnd, type OnMoveStart, type OnReconnect, type OnReconnectEnd, type OnReconnectStart, type OnResize, type OnResizeEnd, type OnResizeStart, OnSelectionChange, OnSelectionDrag, OutputNode, PanOnScrollMode, Pane, PaneEvents, Panel, type PanelPosition, Position, type ProOptions, type Rect, ResizeControl, ResizeControlVariant, type ResizeDragEvent, type ResizeParams, type ResizeParamsWithDirection, Selection, SelectionMode, type SelectionRect, type SetCenter, type SetCenterOptions, type SetViewport, ShortcutModifier, ShortcutModifierDefinition, type ShouldResize, SmoothStepEdge, SmoothStepEdgeInternal, type SmoothStepEdgeProps, type SmoothStepPathOptions, type SnapGrid, SolidFlow, type SolidFlowInitialProps, type SolidFlowProps, SolidFlowProvider, StepEdge, StepEdgeInternal, type StepEdgeProps, StraightEdge, StraightEdgeInternal, type StraightEdgeProps, type Transform, UseSolidFlowReturn, Viewport, type ViewportHelperFunctionOptions, ViewportPortal, type XYPosition, type XYZPosition, Zoom, addEdge, connectionKey, createEdgeStore, createNodeStore, getBezierEdgeCenter, getBezierPath, getConnectedEdges, getEdgeCenter, getIncomers, getNodesBounds, getOutgoers, getSmoothStepPath, getStraightPath, getViewportForBounds, useColorMode, useConnection, useEdges, useHandleEdgeSelect, useInternalNode, useNodeConnections, useNodes, useNodesData, useNodesInitialized, useSolidFlow, useUpdateNodeInternals, useViewport, useViewportInitialized };
+//#region src/types/system.d.ts
+/** Alignment of an attached element (e.g. a toolbar) along its side: 'start' | 'center' | 'end'. */
+type Align = Align$1;
+/** Configurable UI strings and ARIA descriptions (localization / a11y overrides). */
+type AriaLabelConfig = AriaLabelConfig$1;
+/** Options controlling bezier edge path curvature. */
+type BezierPathOptions = BezierPathOptions$1;
+/** A rectangle expressed as top-left position plus bottom-right extent. */
+type Box = Box$1;
+/** Color scheme for the flow: an explicit class or 'system' (media-query resolved). */
+type ColorMode = ColorMode$1;
+/** A resolved color scheme class: 'light' | 'dark'. */
+type ColorModeClass = ColorModeClass$1;
+/** A width/height pair. */
+type Dimensions = Dimensions$1;
+/** An edge marker reference: a marker type string or a full `EdgeMarker` config. */
+type EdgeMarkerType = EdgeMarkerType$1;
+/** Options for fitting the viewport to a set of bounds. */
+type FitBoundsOptions = FitBoundsOptions$1;
+/** Parameters accepted by `getBezierPath`. */
+type GetBezierPathParams = GetBezierPathParams$1;
+/** Parameters accepted by `getSmoothStepPath`. */
+type GetSmoothStepPathParams = GetSmoothStepPathParams$1;
+/** Parameters accepted by `getStraightPath`. */
+type GetStraightPathParams = GetStraightPathParams$1;
+/** Predicate deciding whether a pending connection may become an edge. */
+type IsValidConnection<EdgeType extends EdgeBase = EdgeBase> = IsValidConnection$1<EdgeType>;
+/** Handler called when a connection successfully completes. */
+type OnConnect = OnConnect$1;
+/** Handler called when a connection gesture ends (whether or not an edge was made). */
+type OnConnectEnd<NodeType extends NodeBase = NodeBase> = OnConnectEnd$1<NodeType>;
+/** Handler called when a user starts dragging a connection from a handle. */
+type OnConnectStart = OnConnectStart$1;
+/** The handle a connection gesture started from. */
+type OnConnectStartParams = OnConnectStartParams$1;
+/** Handler for internal, non-fatal flow errors (logged instead of thrown). */
+type OnError = OnError$1;
+/** Handler called when the user starts panning or zooming the viewport. */
+type OnMoveStart = OnMove$1;
+/** Handler called when the user stops panning or zooming the viewport. */
+type OnMoveEnd = OnMove$1;
+/** Handler called after an edge has been reconnected to a different handle. */
+type OnReconnect<EdgeType extends EdgeBase = EdgeBase> = OnReconnect$1<EdgeType>;
+/** Handler called when an edge reconnection gesture ends. */
+type OnReconnectEnd<NodeType extends NodeBase = NodeBase, EdgeType extends EdgeBase = EdgeBase> = OnReconnectEnd$1<NodeType, EdgeType>;
+/** Handler called when the user starts dragging an edge end off its handle. */
+type OnReconnectStart<EdgeType extends EdgeBase = EdgeBase> = OnReconnectStart$1<EdgeType>;
+/** Handler called while a node is being resized. */
+type OnResize = OnResize$1;
+/** Handler called when a node resize gesture ends. */
+type OnResizeEnd = OnResizeEnd$1;
+/** Handler called when a node resize gesture starts. */
+type OnResizeStart = OnResizeStart$1;
+/** Handler called while a selection of nodes is dragged. */
+type OnSelectionDrag<NodeType extends NodeBase = NodeBase> = OnSelectionDrag$1<NodeType>;
+/** Pro/attribution options (`hideAttribution`). */
+type ProOptions = ProOptions$1;
+/** A rectangle: position plus dimensions. */
+type Rect = Rect$1;
+/** The drag event delivered to resize handlers. */
+type ResizeDragEvent = ResizeDragEvent$1;
+/** Geometry of a resize step: position and dimensions. */
+type ResizeParams = ResizeParams$1;
+/** Resize geometry plus the direction of the drag. */
+type ResizeParamsWithDirection = ResizeParamsWithDirection$1;
+/** The user-drawn selection rectangle in flow coordinates. */
+type SelectionRect = SelectionRect$1;
+/** Options for `setCenter`: zoom and transition behavior. */
+type SetCenterOptions = SetCenterOptions$1;
+/** Options controlling smooth-step edge path geometry. */
+type SmoothStepPathOptions = SmoothStepPathOptions$1;
+/** Grid nodes snap to while dragging: `[x, y]` step sizes. */
+type SnapGrid = SnapGrid$1;
+/** The viewport transform as `[translateX, translateY, zoom]`. */
+type Transform = Transform$1;
+/** Common options for viewport helper functions (e.g. transition duration). */
+type ViewportHelperFunctionOptions = ViewportHelperFunctionOptions$1;
+/** An x/y position with a z-index. */
+type XYZPosition = XYZPosition$1;
+/**
+ * How drag-selection decides membership: 'full' requires nodes to be fully
+ * inside the selection box, 'partial' selects on any overlap.
+ */
+declare const SelectionMode: typeof SelectionMode$1;
+/** See {@link SelectionMode}. */
+type SelectionMode = SelectionMode$1;
+/** Returns the center `[x, y]` of a straight edge between two points. */
+declare const getEdgeCenter: typeof getEdgeCenter$1;
+/** Returns the label center and offsets for a bezier edge. */
+declare const getBezierEdgeCenter: typeof getBezierEdgeCenter$1;
+//#endregion
+export { Align, AriaLabelConfig, Background, type BackgroundProps, type BackgroundVariant, BaseEdge, BezierEdge, BezierEdgeInternal, type BezierEdgeProps, BezierPathOptions, Box, type BuiltInEdge, type BuiltInNode, type BuiltInNodeTypes, ColorMode, ColorModeClass, type Connection, ConnectionData, ConnectionLine, ConnectionLineComponentProps, ConnectionLineType, ConnectionMode, type ConnectionsRecord, ControlButton, type ControlLinePosition, type ControlPosition, Controls, type CoordinateExtent, type DefaultEdgeOptions, DefaultNode, DeleteEvents, Dimensions, type Edge, EdgeConnection, EdgeEvents, EdgeLabel, EdgeLabelRenderer, type EdgeMarker, EdgeMarkerType, type EdgeProps, EdgeReconnectAnchor, EdgeReconnectEvents, EdgeRenderer, EdgeToolbar, EdgeToolbarProps, type EdgeTypes, EdgeWrapper, type EdgesFor, type FitBounds, FitBoundsOptions, FitViewOptions, type FlowCommands, type FlowSelection, type FlowState, GetBezierPathParams, type GetMiniMapNodeAttribute, GetSmoothStepPathParams, GetStraightPathParams, GroupNode, Handle, type HandleConnection, InputNode, type InternalNode, IsValidConnection, KeyDefinition, KeyDefinitionObject, KeyModifier, Marker, MarkerDefinition, MarkerType, MiniMap, MiniMapNode, type MiniMapNodeProps, type MiniMapProps, type Node, type NodeConnection, NodeEvents, NodeGraph, type NodeOrigin, type NodeProps, NodeRenderer, NodeResizer, NodeSelection, NodeSelectionEvents, NodeToolbar, NodeToolbarProps, type NodeTypes, NodeWrapper, type NodesFor, OnBeforeDelete, OnBeforeEdgeConnect, OnBeforeReconnect, OnConnect, OnConnectEnd, OnConnectStart, OnConnectStartParams, OnDelete, OnEdgeConnect, OnEdgeCreate, OnError, type OnMove, OnMoveEnd, OnMoveStart, OnReconnect, OnReconnectEnd, OnReconnectStart, OnResize, OnResizeEnd, OnResizeStart, OnSelectionChange, OnSelectionDrag, OutputNode, PanOnScrollMode, Pane, PaneEvents, Panel, type PanelPosition, Position, ProOptions, Rect, ResizeControl, ResizeControlVariant, ResizeDragEvent, ResizeParams, ResizeParamsWithDirection, Selection, SelectionMode, SelectionRect, type SetCenter, SetCenterOptions, type SetViewport, ShortcutModifier, ShortcutModifierDefinition, type ShouldResize, SmoothStepEdge, SmoothStepEdgeInternal, type SmoothStepEdgeProps, SmoothStepPathOptions, SnapGrid, SolidFlow, type SolidFlowInitialProps, type SolidFlowProps, SolidFlowProvider, StepEdge, StepEdgeInternal, type StepEdgeProps, StraightEdge, StraightEdgeInternal, type StraightEdgeProps, Transform, UseSolidFlowReturn, Viewport, ViewportHelperFunctionOptions, ViewportPortal, type XYPosition, XYZPosition, Zoom, addEdge, connectionKey, createEdgeStore, createNodeStore, getBezierEdgeCenter, getBezierPath, getConnectedEdges, getEdgeCenter, getIncomers, getNodesBounds, getOutgoers, getSmoothStepPath, getStraightPath, getViewportForBounds, useColorMode, useConnection, useEdgeId, useEdges, useInternalNode, useNodeConnections, useNodeId, useNodes, useNodesData, useNodesInitialized, useSolidFlow, useUpdateNodeInternals, useViewport, useViewportInitialized };