@cocorof/graphier 0.1.0 → 1.1.1

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>;
@@ -98,6 +104,12 @@ export declare interface LayoutConfig {
     settledThreshold?: 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 +127,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 +190,8 @@ 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;
 }
 
 export declare function NodeDetailPanel(props: NodeDetailPanelProps): JSX_2.Element;
@@ -189,8 +215,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 +240,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 {