@squeed/flow-sdk 2.0.22 → 2.0.25

package/dist/index.d.cts

@@ -51,7 +51,9 @@ export declare type BackgroundVariant = BackgroundPattern | "transparent";
 export declare function bindSqueedCallbacks(json: SqueedJson, compiledEdges: FlowDiagramEdge[], callbacks: FlowDiagramCallbacks, onJsonChange?: (json: SqueedJson, change: SqueedChange) => void, formSchema?: FormSchema): FlowDiagramCallbacks;
 
 export declare const BottomBar: MemoExoticComponent<    {
-(): JSX_2.Element;
+({ nodeGridControlsTarget, }?: {
+nodeGridControlsTarget?: HTMLElement | null;
+}): JSX_2.Element;
 displayName: string;
 }>;
 
@@ -169,6 +171,8 @@ export declare type ContractType = {
     ports?: Record<string, ContractPort>;
 };
 
+export declare function copySelection(json: SqueedJson, ids: string[]): SqueedJson;
+
 export declare function createFlowDiagram(jsnObjct: any, path?: string, nodes?: any[], edges?: any[], activeLabel?: string, flowConfig?: any, nodeConfig?: any): {
     nodes: any[];
     edges: any[];
@@ -243,6 +247,11 @@ export declare function DiagramAppearanceControls(): JSX_2.Element;
 
 export declare function downloadSvg(canvas: HTMLElement, filename?: string): Promise<void>;
 
+export declare function duplicateSelection(json: SqueedJson, ids: string[]): {
+    json: SqueedJson;
+    ids: string[];
+};
+
 export declare const DynamicIcon: ({ name, svg, ...props }: {
     [x: string]: any;
     name: any;
@@ -284,6 +293,8 @@ export declare function FlowDiagram({ loading, loader, ...props }: FlowDiagramPr
 
 /** Event callbacks for the flow diagram */
 export declare interface FlowDiagramCallbacks {
+    onNodesCopy?: (ids: string[]) => boolean | void | Promise<boolean | void>;
+    onNodesDuplicate?: (ids: string[]) => boolean | void;
     onGraphEdgeColorChange?: (color: string) => void;
     onAllNodesIconLabelChange?: (enabled: boolean) => void;
     onNodeCreateRequest?: (request: FlowNodeCreationRequest) => boolean;
@@ -295,6 +306,13 @@ export declare interface FlowDiagramCallbacks {
     onEdgeRadiusChange?: (radius: number) => void;
     onCompactPropertyLayoutChange?: (enabled: boolean) => void;
     onBackgroundVariantChange?: (variant: BackgroundVariant) => void;
+    onNodeGridZoomOut?: (options: NodeGridOptions) => boolean;
+    onNodeGridFillRequest?: (options: NodeGridOptions) => boolean;
+    onNodeGridModeRequest?: (enabled: boolean, options: NodeGridOptions) => boolean;
+    onNodeGridDrop?: (nodeId: string, point: {
+        x: number;
+        y: number;
+    }, modifiers?: NodeSelectionModifiers) => boolean;
     /** Fires when a node is clicked/selected */
     onNodeSelect?: (nodeId: string, nodeData: any, modifiers?: NodeSelectionModifiers) => void;
     onBackgroundClick?: () => void;
@@ -312,14 +330,16 @@ export declare interface FlowDiagramCallbacks {
         position: any;
         sourceNodeId?: string;
         isArrayMode?: boolean;
-    }) => void;
+    }) => boolean | void;
     /** Fires when a node is deleted */
     onNodeDelete?: (nodeId: string, nodeData: any) => void;
     /** Fires when a node label is edited inline */
     onNodeLabelChange?: (nodeId: string, newLabel: string) => void;
-    onNodeContentChange?: (nodeId: string, content: string) => void;
+    onNodeSubtitleChange?: (nodeId: string, subtitle: string) => void;
+    onNodeContentChange?: (nodeId: string, content: NodeContent) => void;
     /** Fires when a node's collapse toggle is clicked */
     onNodeCollapse?: (nodeId: string, collapsed: boolean) => void;
+    onNodeParentChange?: (nodeId: string, parentId: string) => void;
     /** Fires when a node's color is changed via the toolbar */
     onNodeColorChange?: (nodeId: string, colorType: "text" | "bg", color: string) => void;
     /** Fires when a node's icon is changed via the toolbar */
@@ -383,6 +403,7 @@ export declare interface FlowDiagramCallbacks {
 export declare interface FlowDiagramConfig {
     bottomBarExtra?: React.ReactNode;
     bottomBarCollapsed?: boolean;
+    bottomBarNavigation?: boolean;
     /** Animate fit/center/focus actions for 300ms by default. Per-action flags override this; reduced motion stays instant. */
     animateViewport?: boolean;
     disableAnimations?: boolean;
@@ -403,6 +424,7 @@ export declare interface FlowDiagramConfig {
     edgeMode?: EdgeMode;
     compactPropertyLayout?: boolean;
     nodeViewModes?: Record<string, NodeViewMode>;
+    allNodesIconLabel?: boolean;
     workflowContract?: WorkflowContract;
     /** Layout algorithm */
     layout?: LayoutAlgorithm;
@@ -420,6 +442,10 @@ export declare interface FlowDiagramConfig {
     parentNodeStyle?: ParentNodeStyle;
     /** Min zoom level (default: 0.01) */
     minZoom?: number;
+    nodeGridSpacing?: "collision" | "layout";
+    nodeGridConnections?: boolean;
+    bottomBarCollision?: boolean;
+    bottomBarFill?: boolean;
     /** Max zoom level (default: 1.5) */
     maxZoom?: number;
     /** Initial viewport position and zoom */
@@ -448,7 +474,7 @@ export declare interface FlowDiagramConfig {
     renderBottomBar?: (props: BottomBarRenderProps) => React.ReactNode;
     /** Built-in node/edge selection toolbars (bottom bar swaps to them on select). `false` disables. */
     selectionToolbar?: SelectionToolbarConfig | false;
-    /** Custom node view components to override SDK defaults. Keys: objectView, arrayView, text, parentContainer */
+    /** Custom views: objectView, arrayView, text, parentContainer; jsxContent receives JsxContentRendererProps. */
     customViews?: Record<string, React.ComponentType<any>>;
     /** Disable built-in keyboard shortcuts (Z/M/D) when the consumer handles its own */
     disableKeyboardShortcuts?: boolean;
@@ -467,6 +493,8 @@ export declare interface FlowDiagramContextValue {
     setAllNodesIconLabel: (enabled: boolean) => void;
     nodeViewModes: Record<string, NodeViewMode>;
     setNodeViewMode: (nodeId: string, mode: NodeViewMode) => void;
+    nodeRadiusPreviews: Record<string, number>;
+    setNodeRadiusPreview: (ids: string[], radius: number | undefined) => void;
     spacing: number;
     edgeRadius: number | undefined;
     setEdgeRadius: (radius: number) => void;
@@ -507,6 +535,11 @@ export declare interface FlowDiagramContextValue {
     setIsPinned: (v: boolean) => void;
     isPerformanceMode: boolean;
     setIsPerformanceMode: (v: boolean) => void;
+    nodeGridOptions: NodeGridOptions | null;
+    setNodeGridOptions: (options: NodeGridOptions | null) => void;
+    lastNodeGridOptions: NodeGridOptions;
+    fillRadiusEditedIds: ReadonlySet<string>;
+    setFillRadiusEditedIds: (ids: Set<string>) => void;
     engineRef: React.MutableRefObject<FlowEngine | null>;
     callbacks: FlowDiagramCallbacks;
     config: FlowDiagramConfig;
@@ -639,6 +672,11 @@ export declare interface FlowEngine {
     clientToModel(clientX: number, clientY: number): Point;
     modelToClient(p: Point): Point;
     getNodeBox(id: string): Box | undefined;
+    detectNodeCollisions(options?: NodeCollisionOptions): NodeCollision[];
+    resolveNodeCollisions(options?: ResolveNodeCollisionsOptions): NodeCollisionResolution;
+    arrangeNodesInGrid(options?: NodeGridOptions): NodeGridArrangement;
+    setNodeGridMode(enabled: boolean, options?: NodeGridOptions): void;
+    swapGridNodes(source: string, target: string, animate?: boolean): boolean;
     setNodePosition(id: string, position: Point | undefined, options?: {
         persist?: boolean;
     }): boolean;
@@ -807,6 +845,18 @@ export declare function getInteractionSurface(surface: string, border: string):
 
 export declare function getNode(json: SqueedJson, address: string): any;
 
+export declare function getSelectionRoots(json: SqueedJson, ids: string[]): string[];
+
+declare interface GridDivider {
+    section: string;
+    axis: "x" | "y";
+    row: number;
+    index: number;
+    weights: number[];
+    length: number;
+    position: Point;
+}
+
 export declare interface JsonPlaybackState {
     position: number;
     total: number;
@@ -822,11 +872,26 @@ export declare interface JsonStreamOptions<Document> {
     maxBytes?: number;
 }
 
+export declare interface JsxContentRendererProps {
+    components: {
+        type: string;
+        [key: string]: unknown;
+    }[];
+    colorMode?: "light" | "dark";
+    fillHeight?: boolean;
+}
+
 export declare type LayoutAlgorithm = "dagre" | "elk" | "tidytree" | "concentric" | "cose";
 
 export declare const LIGHT_BLACK = "#c6c6c6";
 
-export declare const NODE_TYPE_VIEWS: readonly ["", "icon-label", "object", "text"];
+export declare function LoadingBorder({ active, label, radius, }: {
+    active?: boolean;
+    label?: string;
+    radius?: number;
+}): JSX_2.Element;
+
+export declare const NODE_TYPE_VIEWS: readonly ["", "icon-label", "object", "text", "grid", "parent"];
 
 export declare type NodeAlignment = "leading" | "center" | "trailing";
 
@@ -837,11 +902,31 @@ export declare function NodeBorderRadiusControl({ ids, showDivider, }: {
     showDivider?: boolean;
 }): JSX_2.Element;
 
+export declare interface NodeCollision {
+    source: string;
+    target: string;
+    overlap: Point;
+}
+
+export declare interface NodeCollisionOptions {
+    margin?: number;
+}
+
+export declare interface NodeCollisionResolution {
+    positions: Map<string, Point>;
+    movedNodeIds: string[];
+    collisions: NodeCollision[];
+    iterations: number;
+    resolved: boolean;
+}
+
 export declare function NodeConfigSummary({ nodeAddress, expanded, }: {
     nodeAddress: string;
     expanded?: boolean;
 }): JSX_2.Element;
 
+export declare type NodeContent = string | Record<string, unknown>[];
+
 export declare function NodeForm({ nodeAddress, structured, }: {
     nodeAddress: string;
     structured?: boolean;
@@ -859,6 +944,38 @@ export declare function NodeFormPopover({ nodeAddress, active, label, open, onCl
     width?: number;
 }): JSX_2.Element;
 
+export declare interface NodeGridArrangement {
+    dividers?: GridDivider[];
+    positions: Map<string, Point>;
+    movedNodeIds: string[];
+    skippedNodeIds: string[];
+    collisions: NodeCollision[];
+    bounds?: Rect;
+    sizes?: Map<string, {
+        w: number;
+        h: number;
+    }>;
+}
+
+export declare interface NodeGridOptions extends NodeCollisionOptions {
+    adjustment?: {
+        enabled?: boolean;
+        sections?: Record<string, {
+            rows?: number[];
+            columns?: number[][];
+        }>;
+    };
+    order?: string[];
+    columns?: number;
+    animate?: boolean;
+    gaps?: number | {
+        x: number;
+        y: number;
+    };
+    fill?: boolean;
+    padding?: number;
+}
+
 export declare function NodeIconPicker({ nodeId, edgeId, value, open: requestedOpen, onOpenChange, }: {
     nodeId?: string;
     edgeId?: string;
@@ -894,9 +1011,10 @@ export declare interface NodeSelectionModifiers {
 export declare type NodeSpacing = number | "compact" | "normal" | "spacious";
 
 /** Bottom-bar contents while one or more nodes are selected */
-export declare function NodeTools({ ids, onClose, }: {
+export declare function NodeTools({ ids, onClose, afterLabel, }: {
     ids: string[];
     onClose: () => void;
+    afterLabel?: ReactNode;
 }): JSX_2.Element;
 
 export declare type NodeTypeView = Exclude<(typeof NODE_TYPE_VIEWS)[number], "">;
@@ -976,6 +1094,13 @@ export declare function readFormSchema(file: Pick<File, "name" | "size" | "text"
 
 export declare function readWorkflowContract(file: File): Promise<WorkflowContract>;
 
+declare interface Rect {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+
 /** Removes explicit edges or suppresses a hierarchy edge without deleting its child. */
 export declare function removeEdge(json: SqueedJson, edge: RenderedEdgeRef): {
     json: SqueedJson;
@@ -995,6 +1120,8 @@ export declare interface RenderedEdgeRef extends FlowEdgeProperties {
     };
 }
 
+export declare function reparentNode(json: SqueedJson, nodeId: string, parentId: string): SqueedJson;
+
 /**
  * Resolve which JSON node carries an edge's keys.
  * parent→child edges (implicit hierarchy) are configured on the child;
@@ -1005,6 +1132,11 @@ export declare function resolveEdgeOwner(edge: RenderedEdgeRef): {
     kind: "hierarchy" | "target" | "connection";
 };
 
+export declare interface ResolveNodeCollisionsOptions extends NodeCollisionOptions {
+    animate?: boolean;
+    maxIterations?: number;
+}
+
 export declare function resolveStateView(view: SqueedJson, state: SqueedJson): SqueedJson;
 
 declare interface RuntimeReference {
@@ -1180,11 +1312,14 @@ rememberAction?: boolean;
 
 export declare const ToolbarRangeInput: ForwardRefExoticComponent<Omit<DetailedHTMLProps<InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & RefAttributes<HTMLInputElement>>;
 
-export declare function ToolbarScrollContainer({ children, background, border, endElement, }: {
+export declare function ToolbarScrollContainer({ children, background, border, endElement, startElement, startElementWidth, framed, }: {
     children: ReactNode;
     background: string;
     border: string;
     endElement?: ReactNode;
+    startElement?: ReactNode;
+    startElementWidth?: number;
+    framed?: boolean;
 }): JSX_2.Element;
 
 export declare function ToolbarSelect({ children, value, onValueChange, disabled, style, title, icon, popupContent, footer, labelCase, "aria-label": label, ...triggerProps }: {
@@ -1294,6 +1429,8 @@ export declare function useThemeContentColors(color: any): {
     highlightColorFaint: string;
 };
 
+export declare function validateGridAdjustment(adjustment: NodeGridOptions["adjustment"]): void;
+
 declare interface ViewportState {
     pan: Point;
     zoom: number;

package/dist/index.d.ts

@@ -51,7 +51,9 @@ export declare type BackgroundVariant = BackgroundPattern | "transparent";
 export declare function bindSqueedCallbacks(json: SqueedJson, compiledEdges: FlowDiagramEdge[], callbacks: FlowDiagramCallbacks, onJsonChange?: (json: SqueedJson, change: SqueedChange) => void, formSchema?: FormSchema): FlowDiagramCallbacks;
 
 export declare const BottomBar: MemoExoticComponent<    {
-(): JSX_2.Element;
+({ nodeGridControlsTarget, }?: {
+nodeGridControlsTarget?: HTMLElement | null;
+}): JSX_2.Element;
 displayName: string;
 }>;
 
@@ -169,6 +171,8 @@ export declare type ContractType = {
     ports?: Record<string, ContractPort>;
 };
 
+export declare function copySelection(json: SqueedJson, ids: string[]): SqueedJson;
+
 export declare function createFlowDiagram(jsnObjct: any, path?: string, nodes?: any[], edges?: any[], activeLabel?: string, flowConfig?: any, nodeConfig?: any): {
     nodes: any[];
     edges: any[];
@@ -243,6 +247,11 @@ export declare function DiagramAppearanceControls(): JSX_2.Element;
 
 export declare function downloadSvg(canvas: HTMLElement, filename?: string): Promise<void>;
 
+export declare function duplicateSelection(json: SqueedJson, ids: string[]): {
+    json: SqueedJson;
+    ids: string[];
+};
+
 export declare const DynamicIcon: ({ name, svg, ...props }: {
     [x: string]: any;
     name: any;
@@ -284,6 +293,8 @@ export declare function FlowDiagram({ loading, loader, ...props }: FlowDiagramPr
 
 /** Event callbacks for the flow diagram */
 export declare interface FlowDiagramCallbacks {
+    onNodesCopy?: (ids: string[]) => boolean | void | Promise<boolean | void>;
+    onNodesDuplicate?: (ids: string[]) => boolean | void;
     onGraphEdgeColorChange?: (color: string) => void;
     onAllNodesIconLabelChange?: (enabled: boolean) => void;
     onNodeCreateRequest?: (request: FlowNodeCreationRequest) => boolean;
@@ -295,6 +306,13 @@ export declare interface FlowDiagramCallbacks {
     onEdgeRadiusChange?: (radius: number) => void;
     onCompactPropertyLayoutChange?: (enabled: boolean) => void;
     onBackgroundVariantChange?: (variant: BackgroundVariant) => void;
+    onNodeGridZoomOut?: (options: NodeGridOptions) => boolean;
+    onNodeGridFillRequest?: (options: NodeGridOptions) => boolean;
+    onNodeGridModeRequest?: (enabled: boolean, options: NodeGridOptions) => boolean;
+    onNodeGridDrop?: (nodeId: string, point: {
+        x: number;
+        y: number;
+    }, modifiers?: NodeSelectionModifiers) => boolean;
     /** Fires when a node is clicked/selected */
     onNodeSelect?: (nodeId: string, nodeData: any, modifiers?: NodeSelectionModifiers) => void;
     onBackgroundClick?: () => void;
@@ -312,14 +330,16 @@ export declare interface FlowDiagramCallbacks {
         position: any;
         sourceNodeId?: string;
         isArrayMode?: boolean;
-    }) => void;
+    }) => boolean | void;
     /** Fires when a node is deleted */
     onNodeDelete?: (nodeId: string, nodeData: any) => void;
     /** Fires when a node label is edited inline */
     onNodeLabelChange?: (nodeId: string, newLabel: string) => void;
-    onNodeContentChange?: (nodeId: string, content: string) => void;
+    onNodeSubtitleChange?: (nodeId: string, subtitle: string) => void;
+    onNodeContentChange?: (nodeId: string, content: NodeContent) => void;
     /** Fires when a node's collapse toggle is clicked */
     onNodeCollapse?: (nodeId: string, collapsed: boolean) => void;
+    onNodeParentChange?: (nodeId: string, parentId: string) => void;
     /** Fires when a node's color is changed via the toolbar */
     onNodeColorChange?: (nodeId: string, colorType: "text" | "bg", color: string) => void;
     /** Fires when a node's icon is changed via the toolbar */
@@ -383,6 +403,7 @@ export declare interface FlowDiagramCallbacks {
 export declare interface FlowDiagramConfig {
     bottomBarExtra?: React.ReactNode;
     bottomBarCollapsed?: boolean;
+    bottomBarNavigation?: boolean;
     /** Animate fit/center/focus actions for 300ms by default. Per-action flags override this; reduced motion stays instant. */
     animateViewport?: boolean;
     disableAnimations?: boolean;
@@ -403,6 +424,7 @@ export declare interface FlowDiagramConfig {
     edgeMode?: EdgeMode;
     compactPropertyLayout?: boolean;
     nodeViewModes?: Record<string, NodeViewMode>;
+    allNodesIconLabel?: boolean;
     workflowContract?: WorkflowContract;
     /** Layout algorithm */
     layout?: LayoutAlgorithm;
@@ -420,6 +442,10 @@ export declare interface FlowDiagramConfig {
     parentNodeStyle?: ParentNodeStyle;
     /** Min zoom level (default: 0.01) */
     minZoom?: number;
+    nodeGridSpacing?: "collision" | "layout";
+    nodeGridConnections?: boolean;
+    bottomBarCollision?: boolean;
+    bottomBarFill?: boolean;
     /** Max zoom level (default: 1.5) */
     maxZoom?: number;
     /** Initial viewport position and zoom */
@@ -448,7 +474,7 @@ export declare interface FlowDiagramConfig {
     renderBottomBar?: (props: BottomBarRenderProps) => React.ReactNode;
     /** Built-in node/edge selection toolbars (bottom bar swaps to them on select). `false` disables. */
     selectionToolbar?: SelectionToolbarConfig | false;
-    /** Custom node view components to override SDK defaults. Keys: objectView, arrayView, text, parentContainer */
+    /** Custom views: objectView, arrayView, text, parentContainer; jsxContent receives JsxContentRendererProps. */
     customViews?: Record<string, React.ComponentType<any>>;
     /** Disable built-in keyboard shortcuts (Z/M/D) when the consumer handles its own */
     disableKeyboardShortcuts?: boolean;
@@ -467,6 +493,8 @@ export declare interface FlowDiagramContextValue {
     setAllNodesIconLabel: (enabled: boolean) => void;
     nodeViewModes: Record<string, NodeViewMode>;
     setNodeViewMode: (nodeId: string, mode: NodeViewMode) => void;
+    nodeRadiusPreviews: Record<string, number>;
+    setNodeRadiusPreview: (ids: string[], radius: number | undefined) => void;
     spacing: number;
     edgeRadius: number | undefined;
     setEdgeRadius: (radius: number) => void;
@@ -507,6 +535,11 @@ export declare interface FlowDiagramContextValue {
     setIsPinned: (v: boolean) => void;
     isPerformanceMode: boolean;
     setIsPerformanceMode: (v: boolean) => void;
+    nodeGridOptions: NodeGridOptions | null;
+    setNodeGridOptions: (options: NodeGridOptions | null) => void;
+    lastNodeGridOptions: NodeGridOptions;
+    fillRadiusEditedIds: ReadonlySet<string>;
+    setFillRadiusEditedIds: (ids: Set<string>) => void;
     engineRef: React.MutableRefObject<FlowEngine | null>;
     callbacks: FlowDiagramCallbacks;
     config: FlowDiagramConfig;
@@ -639,6 +672,11 @@ export declare interface FlowEngine {
     clientToModel(clientX: number, clientY: number): Point;
     modelToClient(p: Point): Point;
     getNodeBox(id: string): Box | undefined;
+    detectNodeCollisions(options?: NodeCollisionOptions): NodeCollision[];
+    resolveNodeCollisions(options?: ResolveNodeCollisionsOptions): NodeCollisionResolution;
+    arrangeNodesInGrid(options?: NodeGridOptions): NodeGridArrangement;
+    setNodeGridMode(enabled: boolean, options?: NodeGridOptions): void;
+    swapGridNodes(source: string, target: string, animate?: boolean): boolean;
     setNodePosition(id: string, position: Point | undefined, options?: {
         persist?: boolean;
     }): boolean;
@@ -807,6 +845,18 @@ export declare function getInteractionSurface(surface: string, border: string):
 
 export declare function getNode(json: SqueedJson, address: string): any;
 
+export declare function getSelectionRoots(json: SqueedJson, ids: string[]): string[];
+
+declare interface GridDivider {
+    section: string;
+    axis: "x" | "y";
+    row: number;
+    index: number;
+    weights: number[];
+    length: number;
+    position: Point;
+}
+
 export declare interface JsonPlaybackState {
     position: number;
     total: number;
@@ -822,11 +872,26 @@ export declare interface JsonStreamOptions<Document> {
     maxBytes?: number;
 }
 
+export declare interface JsxContentRendererProps {
+    components: {
+        type: string;
+        [key: string]: unknown;
+    }[];
+    colorMode?: "light" | "dark";
+    fillHeight?: boolean;
+}
+
 export declare type LayoutAlgorithm = "dagre" | "elk" | "tidytree" | "concentric" | "cose";
 
 export declare const LIGHT_BLACK = "#c6c6c6";
 
-export declare const NODE_TYPE_VIEWS: readonly ["", "icon-label", "object", "text"];
+export declare function LoadingBorder({ active, label, radius, }: {
+    active?: boolean;
+    label?: string;
+    radius?: number;
+}): JSX_2.Element;
+
+export declare const NODE_TYPE_VIEWS: readonly ["", "icon-label", "object", "text", "grid", "parent"];
 
 export declare type NodeAlignment = "leading" | "center" | "trailing";
 
@@ -837,11 +902,31 @@ export declare function NodeBorderRadiusControl({ ids, showDivider, }: {
     showDivider?: boolean;
 }): JSX_2.Element;
 
+export declare interface NodeCollision {
+    source: string;
+    target: string;
+    overlap: Point;
+}
+
+export declare interface NodeCollisionOptions {
+    margin?: number;
+}
+
+export declare interface NodeCollisionResolution {
+    positions: Map<string, Point>;
+    movedNodeIds: string[];
+    collisions: NodeCollision[];
+    iterations: number;
+    resolved: boolean;
+}
+
 export declare function NodeConfigSummary({ nodeAddress, expanded, }: {
     nodeAddress: string;
     expanded?: boolean;
 }): JSX_2.Element;
 
+export declare type NodeContent = string | Record<string, unknown>[];
+
 export declare function NodeForm({ nodeAddress, structured, }: {
     nodeAddress: string;
     structured?: boolean;
@@ -859,6 +944,38 @@ export declare function NodeFormPopover({ nodeAddress, active, label, open, onCl
     width?: number;
 }): JSX_2.Element;
 
+export declare interface NodeGridArrangement {
+    dividers?: GridDivider[];
+    positions: Map<string, Point>;
+    movedNodeIds: string[];
+    skippedNodeIds: string[];
+    collisions: NodeCollision[];
+    bounds?: Rect;
+    sizes?: Map<string, {
+        w: number;
+        h: number;
+    }>;
+}
+
+export declare interface NodeGridOptions extends NodeCollisionOptions {
+    adjustment?: {
+        enabled?: boolean;
+        sections?: Record<string, {
+            rows?: number[];
+            columns?: number[][];
+        }>;
+    };
+    order?: string[];
+    columns?: number;
+    animate?: boolean;
+    gaps?: number | {
+        x: number;
+        y: number;
+    };
+    fill?: boolean;
+    padding?: number;
+}
+
 export declare function NodeIconPicker({ nodeId, edgeId, value, open: requestedOpen, onOpenChange, }: {
     nodeId?: string;
     edgeId?: string;
@@ -894,9 +1011,10 @@ export declare interface NodeSelectionModifiers {
 export declare type NodeSpacing = number | "compact" | "normal" | "spacious";
 
 /** Bottom-bar contents while one or more nodes are selected */
-export declare function NodeTools({ ids, onClose, }: {
+export declare function NodeTools({ ids, onClose, afterLabel, }: {
     ids: string[];
     onClose: () => void;
+    afterLabel?: ReactNode;
 }): JSX_2.Element;
 
 export declare type NodeTypeView = Exclude<(typeof NODE_TYPE_VIEWS)[number], "">;
@@ -976,6 +1094,13 @@ export declare function readFormSchema(file: Pick<File, "name" | "size" | "text"
 
 export declare function readWorkflowContract(file: File): Promise<WorkflowContract>;
 
+declare interface Rect {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+
 /** Removes explicit edges or suppresses a hierarchy edge without deleting its child. */
 export declare function removeEdge(json: SqueedJson, edge: RenderedEdgeRef): {
     json: SqueedJson;
@@ -995,6 +1120,8 @@ export declare interface RenderedEdgeRef extends FlowEdgeProperties {
     };
 }
 
+export declare function reparentNode(json: SqueedJson, nodeId: string, parentId: string): SqueedJson;
+
 /**
  * Resolve which JSON node carries an edge's keys.
  * parent→child edges (implicit hierarchy) are configured on the child;
@@ -1005,6 +1132,11 @@ export declare function resolveEdgeOwner(edge: RenderedEdgeRef): {
     kind: "hierarchy" | "target" | "connection";
 };
 
+export declare interface ResolveNodeCollisionsOptions extends NodeCollisionOptions {
+    animate?: boolean;
+    maxIterations?: number;
+}
+
 export declare function resolveStateView(view: SqueedJson, state: SqueedJson): SqueedJson;
 
 declare interface RuntimeReference {
@@ -1180,11 +1312,14 @@ rememberAction?: boolean;
 
 export declare const ToolbarRangeInput: ForwardRefExoticComponent<Omit<DetailedHTMLProps<InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & RefAttributes<HTMLInputElement>>;
 
-export declare function ToolbarScrollContainer({ children, background, border, endElement, }: {
+export declare function ToolbarScrollContainer({ children, background, border, endElement, startElement, startElementWidth, framed, }: {
     children: ReactNode;
     background: string;
     border: string;
     endElement?: ReactNode;
+    startElement?: ReactNode;
+    startElementWidth?: number;
+    framed?: boolean;
 }): JSX_2.Element;
 
 export declare function ToolbarSelect({ children, value, onValueChange, disabled, style, title, icon, popupContent, footer, labelCase, "aria-label": label, ...triggerProps }: {
@@ -1294,6 +1429,8 @@ export declare function useThemeContentColors(color: any): {
     highlightColorFaint: string;
 };
 
+export declare function validateGridAdjustment(adjustment: NodeGridOptions["adjustment"]): void;
+
 declare interface ViewportState {
     pan: Point;
     zoom: number;