@lapis-notes/graph 0.1.0

package/dist/graph-renderer.d.ts

@@ -0,0 +1,226 @@
+import { type SimulationLinkDatum, type SimulationNodeDatum } from "d3-force";
+import type { GraphData, GraphNode, GraphSettings } from "./graph-types";
+export interface GraphRenderNode extends GraphNode, SimulationNodeDatum {
+    radius: number;
+}
+export interface GraphRenderLink extends SimulationLinkDatum<GraphRenderNode> {
+    id: string;
+    count: number;
+    directed: boolean;
+}
+interface GraphRendererCallbacks {
+    onNodeClick: (node: GraphNode, event: MouseEvent) => void;
+    onNodeContextMenu: (node: GraphNode, event: MouseEvent) => void;
+    onLayoutComplete?: (summary: {
+        animated: boolean;
+        durationMs: number;
+        nodeCount: number;
+        linkCount: number;
+    }) => void;
+    onTimeLapseStateChange?: (state: {
+        running: boolean;
+        reason: "started" | "stopped" | "completed" | "graph-changed";
+    }) => void;
+    onNodePreviewChange?: (preview: GraphNodePreview | null) => void;
+}
+export interface GraphPreviewAnchor {
+    getBoundingClientRect(): DOMRect;
+}
+export interface GraphNodePreview {
+    node: GraphNode;
+    anchor: GraphPreviewAnchor;
+}
+export type GraphViewportTransform = {
+    x: number;
+    y: number;
+    k: number;
+};
+type Bounds = {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+};
+export declare const GRAPH_D3_ALPHA_DECAY: number;
+export declare const GRAPH_D3_VELOCITY_DECAY = 0.4;
+export declare function graphPhyllotaxisPosition(index: number, spacing?: number): {
+    x: number;
+    y: number;
+};
+export declare function graphNodeWorldRadius(baseRadius: number, zoom: number): number;
+export declare function graphNodeScreenRadius(baseRadius: number, zoom: number): number;
+export declare function graphNodeSupportsPreview(node: GraphNode): boolean;
+export declare function graphNodePreviewRect(options: {
+    node: GraphRenderNode;
+    transform: GraphViewportTransform;
+    canvasRect: Pick<DOMRect, "left" | "top">;
+}): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare function graphEmphasisAlpha(kind: "node" | "link" | "label", active: boolean, progress: number): number;
+export declare function advanceGraphEmphasis(previous: number, target: number, elapsedMs: number): number;
+export declare function graphLinkScreenWidth(value: number): number;
+export declare function graphLinkUsesAccentPaint(hasEmphasis: boolean, incidentToSource: boolean): boolean;
+export declare function createGraphLinkDegreeMap(nodes: GraphRenderNode[], links: GraphRenderLink[]): ReadonlyMap<string, number>;
+export declare function graphDegreeNormalizedLinkStrength(link: GraphRenderLink, degrees: ReadonlyMap<string, number>, sliderValue: number): number;
+export declare function createGraphForceSimulation(nodes: GraphRenderNode[], links: GraphRenderLink[], settings: GraphSettings): import("d3-force").Simulation<GraphRenderNode, undefined>;
+export declare function createGraphTimeLapsePlan(graph: GraphData): string[];
+export declare function graphTimeLapseVisibleCount(elapsedMs: number, durationMs: number, total: number): number;
+export declare function graphNodeIntersectsViewport(options: {
+    nodeX: number;
+    nodeY: number;
+    screenRadius: number;
+    transform: GraphViewportTransform;
+    viewportWidth: number;
+    viewportHeight: number;
+    margin?: number;
+}): boolean;
+export declare function graphLinkIntersectsViewport(options: {
+    sourceX: number;
+    sourceY: number;
+    targetX: number;
+    targetY: number;
+    transform: GraphViewportTransform;
+    viewportWidth: number;
+    viewportHeight: number;
+    margin?: number;
+}): boolean;
+export declare const GRAPH_MIN_ZOOM: number;
+export declare const GRAPH_MAX_ZOOM = 8;
+export declare const GRAPH_MAX_FIT_ZOOM = 1.35;
+export declare const GRAPH_FOCUS_ZOOM = 1.1;
+export declare const GRAPH_ZOOM_STEP = 1.5;
+export declare function clampGraphZoom(value: number): number;
+export declare function graphFitScale(options: {
+    viewportWidth: number;
+    viewportHeight: number;
+    contentWidth: number;
+    contentHeight: number;
+    padding: number;
+}): number;
+export declare function graphFitTransform(options: {
+    viewportWidth: number;
+    viewportHeight: number;
+    bounds: Bounds;
+    padding: number;
+}): GraphViewportTransform;
+export declare function graphFocusTransform(options: {
+    viewportWidth: number;
+    viewportHeight: number;
+    nodeX: number;
+    nodeY: number;
+    currentScale: number;
+}): GraphViewportTransform;
+export declare function graphNodeLabelAlpha(options: {
+    zoom: number;
+    textFadeThreshold: number;
+    hovered: boolean;
+    context: boolean;
+}): number;
+export type GraphFocusOptions = {
+    zoom?: boolean;
+};
+export declare class GraphRenderer {
+    private readonly wrapperEl;
+    private readonly canvasEl;
+    private readonly emptyStateEl;
+    private readonly context;
+    private readonly callbacks;
+    private simulation;
+    private graph;
+    private settings;
+    private nodes;
+    private links;
+    private neighborMap;
+    private positions;
+    private resizeObserver;
+    private animationFrame;
+    private timeLapseFrame;
+    private timeLapseStartedAt;
+    private timeLapseDurationMs;
+    private timeLapseOrder;
+    private visibleTimeLapseNodes;
+    private hoveredNodeId;
+    private emphasisNodeId;
+    private focusedNodeId;
+    private emphasisProgress;
+    private emphasisTarget;
+    private emphasisFrameAt;
+    private layoutStartedAt;
+    private readonly reducedMotion;
+    private autoCenterNodeId;
+    private autoCenterZoom;
+    private autoFitViewport;
+    private pendingCenterNodeId;
+    private pendingFitViewport;
+    private hasFittedViewport;
+    private lastViewportWidth;
+    private lastViewportHeight;
+    private viewportAdjustedByUser;
+    private pointerMode;
+    private pointerId;
+    private pointerDownNodeId;
+    private pointerMoved;
+    private dragNode;
+    private pointerStart;
+    private panStart;
+    private transform;
+    private readonly hoverIntent;
+    private modifierDown;
+    private previewNodeId;
+    private previewSuppressedNodeId;
+    private readonly handleDocumentKeyDown;
+    private readonly handleDocumentKeyUp;
+    constructor(containerEl: HTMLElement, callbacks: GraphRendererCallbacks);
+    setGraph(graph: GraphData, settings: GraphSettings): void;
+    private hasSameTopology;
+    focusNode(nodeId: string | null, options?: GraphFocusOptions): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    resetView(): void;
+    refreshViewport(): void;
+    startTimeLapse(durationMs?: number): void;
+    stopTimeLapse(reason?: "stopped" | "completed" | "graph-changed", notify?: boolean): void;
+    isTimeLapseRunning(): boolean;
+    dismissPreview(): void;
+    destroy(): void;
+    private observeResize;
+    private bindEvents;
+    private resize;
+    private hasViewportSize;
+    private centerNodeInViewport;
+    private applyFocusAlignment;
+    private applyResizeAlignment;
+    private storePositions;
+    private fitGraphToViewport;
+    private getBounds;
+    private rebuildNeighborMap;
+    private restartSimulation;
+    private prepareInitialFit;
+    private applyAutoCenter;
+    private applyFinalAlignment;
+    private updateEmphasisTarget;
+    private advanceEmphasis;
+    private scheduleTimeLapseFrame;
+    private isNodeVisibleInTimeLapse;
+    private queueRender;
+    private render;
+    private drawLink;
+    private drawNode;
+    private drawLabel;
+    private isNodeActive;
+    private hasEmphasisSource;
+    private isLinkActive;
+    private hitTest;
+    private openPreviewForHoveredNode;
+    private openPreview;
+    private closePreview;
+    private screenToWorld;
+    private pointerDistance;
+    private endPointerInteraction;
+    private zoomAtCenter;
+}
+export {};