@cocorof/graphier 0.1.0 → 1.2.0

package/dist/index.d.ts

@@ -38,6 +38,12 @@ export declare interface ConnectionGroup {
     nodes: GraphNode[];
 }
 
+/** Context menu event: node + screen position for rendering custom menu */
+export declare type ContextMenuHandler = (node: GraphNode, position: {
+    x: number;
+    y: number;
+}) => void;
+
 export declare const DEFAULT_LAYOUT: Required<LayoutConfig>;
 
 export declare const DEFAULT_STYLE: Required<StyleConfig>;
@@ -96,8 +102,21 @@ export declare interface LayoutConfig {
     velocityDecay?: number;
     /** Convergence threshold — simulation stops when alpha drops below this (default: 0.005) */
     settledThreshold?: number;
+    /**
+     * Spread multiplier — scales charge strength and link distance to control
+     * how far apart nodes spread. 1.0 = default, 2.0 = twice as spread out.
+     * Automatically scaled by node count when set to "auto".
+     * (default: "auto")
+     */
+    spreadFactor?: "auto" | number;
 }
 
+/** Layout settled callback */
+export declare type LayoutSettledHandler = () => void;
+
+/** Layout tick callback with simulation alpha */
+export declare type LayoutTickHandler = (alpha: number) => void;
+
 export declare type LinkEventHandler = (link: GraphLink) => void;
 
 export declare const minimal: ThemeConfig;
@@ -115,6 +134,20 @@ export declare interface NetworkGraph3DProps {
     onNodeDoubleClick?: NodeEventHandler;
     /** Hover on a node (null = hover out) */
     onNodeHover?: NullableNodeEventHandler;
+    /** Right-click on a node — receives node + screen position for custom menu */
+    onContextMenu?: ContextMenuHandler;
+    /** Click on an edge/link */
+    onLinkClick?: LinkEventHandler;
+    /** Hover on an edge/link (null = hover out) */
+    onLinkHover?: NullableLinkEventHandler;
+    /** Node drag (fires continuously during drag) */
+    onNodeDrag?: NodeDragHandler;
+    /** Node drag end */
+    onNodeDragEnd?: NodeDragHandler;
+    /** Fired when force simulation converges */
+    onLayoutSettled?: LayoutSettledHandler;
+    /** Fired on each layout tick with current alpha */
+    onLayoutTick?: LayoutTickHandler;
     /** Currently selected node ID (controlled mode) */
     selectedNodeId?: string | null;
     /** Number of hops to highlight around selected node (default: 3) */
@@ -164,8 +197,10 @@ export declare interface NetworkGraph3DRef {
     getRenderer(): THREE.WebGLRenderer | null;
     /** Access the Three.js camera */
     getCamera(): THREE.PerspectiveCamera | null;
-    /** Capture a screenshot as a Blob */
-    screenshot(): Promise<Blob | null>;
+    /** Capture a screenshot as a PNG data URL string (synchronous, matches original) */
+    captureScreenshot(): string | null;
+    /** Re-run force layout from current positions (useful after changing spreadFactor) */
+    reheatLayout(): void;
 }
 
 export declare function NodeDetailPanel(props: NodeDetailPanelProps): JSX_2.Element;
@@ -189,8 +224,17 @@ export declare interface NodeDetailPanelProps {
     style?: CSSProperties;
 }
 
+/** Node drag event (fires during drag) */
+export declare type NodeDragHandler = (node: GraphNode, position: {
+    x: number;
+    y: number;
+    z: number;
+}) => void;
+
 export declare type NodeEventHandler = (node: GraphNode) => void;
 
+export declare type NullableLinkEventHandler = (link: GraphLink | null) => void;
+
 export declare type NullableNodeEventHandler = (node: GraphNode | null) => void;
 
 /** Runtime node with layout positions (internal) */
@@ -205,6 +249,12 @@ export declare interface RendererConfig {
     antialias?: boolean;
     /** Max device pixel ratio (default: 1.5) */
     pixelRatioMax?: number;
+    /**
+     * Camera control mode:
+     * - "fly" (default): WASD/arrow thrust-based flight with inertia (matches original)
+     * - "orbit": z/x zoom, arrow keys orbit around target
+     */
+    cameraMode?: "fly" | "orbit";
 }
 
 export declare interface ResolvedTheme {
@@ -245,6 +295,11 @@ export declare interface StyleConfig {
     maxLabels?: number;
     /** Edge line width multiplier (default: 1.0). Note: WebGL limits linewidth to 1 on most platforms. */
     edgeWidthScale?: number;
+    /**
+     * Fly camera thrust speed multiplier (default: 1.0).
+     * 0.5 = half speed, 2.0 = double speed.
+     */
+    flySpeed?: number;
 }
 
 export declare interface SubgraphOptions {