@riebeckite/graph 0.0.0-stage → 0.0.36

package/dist/src/animation.d.ts

@@ -0,0 +1,8 @@
+import type { GraphNode } from "./types.js";
+export type RevealEntry = {
+    id: string;
+    at: number;
+    dated: boolean;
+};
+export declare function buildRevealSchedule(nodes: readonly GraphNode[]): RevealEntry[];
+export declare function hasDatedNodes(nodes: readonly GraphNode[]): boolean;

package/dist/src/document.d.ts

@@ -0,0 +1,31 @@
+import type { GraphDocument } from "./types.js";
+export type GraphSourceLink = {
+    raw: string;
+    slug: string | null;
+    kind: string;
+};
+export type GraphSourceAsset = {
+    path: string;
+    sourcePath?: string;
+};
+export type GraphSourceEntry = {
+    slug: string;
+    title: string;
+    permalink: string;
+    tags?: readonly string[];
+    links?: readonly GraphSourceLink[];
+    assets?: readonly GraphSourceAsset[];
+    date?: string | null;
+};
+export type BuildGraphDocumentOptions = {
+    centerSlug?: string | null;
+    includeTags?: boolean;
+    includeAttachments?: boolean;
+    includeUnresolved?: boolean;
+};
+export declare function buildGraphDocument(entries: readonly GraphSourceEntry[], options?: BuildGraphDocumentOptions): GraphDocument;
+export type SliceGraphDocumentResult = {
+    document: GraphDocument;
+    truncated: boolean;
+};
+export declare function sliceGraphDocument(document: GraphDocument, centerId: string, depth: number, maxNodes?: number): SliceGraphDocumentResult;

package/dist/src/query.d.ts

@@ -0,0 +1,14 @@
+import type { GraphNode } from "./types.js";
+export type GraphQueryField = "text" | "file" | "path" | "tag" | "unsupported";
+export type GraphQueryTerm = {
+    field: GraphQueryField;
+    value: string;
+    negated: boolean;
+};
+export type ParsedGraphQuery = {
+    terms: GraphQueryTerm[];
+    unsupportedOperators: string[];
+};
+export declare function parseGraphQuery(input: string): ParsedGraphQuery;
+export declare function matchesGraphQuery(node: GraphNode, query: ParsedGraphQuery): boolean;
+export declare function normalizeGraphText(value: string): string;

package/dist/src/settings.d.ts

@@ -0,0 +1,52 @@
+import type { GraphSettings } from "./types.js";
+export declare const GRAPH_SETTINGS_RANGES: {
+    readonly depth: {
+        readonly min: 0;
+        readonly max: 5;
+        readonly step: 1;
+    };
+    readonly textFade: {
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.05;
+    };
+    readonly nodeSize: {
+        readonly min: 0.5;
+        readonly max: 2.5;
+        readonly step: 0.1;
+    };
+    readonly linkThickness: {
+        readonly min: 0.25;
+        readonly max: 3;
+        readonly step: 0.05;
+    };
+    readonly centerForce: {
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.05;
+    };
+    readonly repelForce: {
+        readonly min: 0;
+        readonly max: 2000;
+        readonly step: 10;
+    };
+    readonly linkForce: {
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.05;
+    };
+    readonly linkDistance: {
+        readonly min: 30;
+        readonly max: 500;
+        readonly step: 5;
+    };
+};
+export declare const DEFAULT_GRAPH_SETTINGS: GraphSettings;
+export declare function mergeGraphSettings(base: GraphSettings, patch: Partial<GraphSettings>): GraphSettings;
+export declare function normalizeGraphSettings(value: unknown): GraphSettings;
+export declare function readStoredGraphSettings(storage: {
+    getItem(key: string): string | null;
+}, key: string): GraphSettings | null;
+export declare function writeStoredGraphSettings(storage: {
+    setItem(key: string, value: string): void;
+}, key: string, settings: GraphSettings): void;

package/dist/src/simulation.d.ts

@@ -0,0 +1,38 @@
+import type { GraphLink } from "./types.js";
+export type SimulationOptions = {
+    centerForce: number;
+    repelForce: number;
+    linkForce: number;
+    linkDistance: number;
+};
+export type SimulationNode = {
+    id: string;
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    fx: number | null;
+    fy: number | null;
+};
+export type GraphSimulation = {
+    nodes: readonly SimulationNode[];
+    tick(): boolean;
+    reheat(alpha?: number): void;
+    setOptions(options: SimulationOptions): void;
+    fix(id: string, x: number, y: number): void;
+    release(id: string): void;
+    stop(): void;
+    isActive(): boolean;
+    getAlpha(): number;
+};
+export type CreateSimulationInput = {
+    nodeIds: readonly string[];
+    links: readonly GraphLink[];
+    options: SimulationOptions;
+    positions?: ReadonlyMap<string, {
+        x: number;
+        y: number;
+    }>;
+    centerId?: string | null;
+};
+export declare function createGraphSimulation(input: CreateSimulationInput): GraphSimulation;

package/dist/src/types.d.ts

@@ -0,0 +1,56 @@
+export type GraphNodeKind = "note" | "unresolved" | "attachment" | "tag";
+export type GraphNode = {
+    id: string;
+    kind: GraphNodeKind;
+    slug: string | null;
+    title: string;
+    permalink: string | null;
+    path: string;
+    tags: string[];
+    date: string | null;
+};
+export type GraphLink = {
+    source: string;
+    target: string;
+};
+export type GraphDocument = {
+    nodes: GraphNode[];
+    links: GraphLink[];
+    centerId: string | null;
+};
+export type GraphGroup = {
+    id: string;
+    query: string;
+    color: string;
+};
+export type GraphSettings = {
+    search: string;
+    showTags: boolean;
+    showAttachments: boolean;
+    existingOnly: boolean;
+    showOrphans: boolean;
+    depth: number;
+    arrows: boolean;
+    textFade: number;
+    nodeSize: number;
+    linkThickness: number;
+    animate: boolean;
+    centerForce: number;
+    repelForce: number;
+    linkForce: number;
+    linkDistance: number;
+    groups: GraphGroup[];
+};
+export type GraphMode = "local" | "global";
+export type VisibleGraphNode = GraphNode & {
+    degree: number;
+    radius: number;
+    color: string;
+    groupId: string | null;
+};
+export type VisibleGraph = {
+    nodes: VisibleGraphNode[];
+    links: GraphLink[];
+    centerId: string | null;
+    unsupportedOperators: string[];
+};

package/dist/src/view.d.ts

@@ -0,0 +1,9 @@
+import type { GraphDocument, GraphMode, GraphSettings, VisibleGraph } from "./types.js";
+export type BuildVisibleGraphInput = {
+    document: GraphDocument;
+    settings: GraphSettings;
+    mode: GraphMode;
+    centerId?: string | null;
+};
+export declare function buildVisibleGraph(input: BuildVisibleGraphInput): VisibleGraph;
+export declare function collectLocalNodeIds(adjacency: ReadonlyMap<string, readonly string[]>, centerId: string | null, depth: number): Set<string>;

package/dist/ui.d.ts

@@ -0,0 +1,21 @@
+import type { GraphDocument, GraphMode, GraphNode, GraphSettings } from "./index.js";
+export type GraphViewProps = {
+    document: GraphDocument;
+    mode?: GraphMode;
+    centerId?: string | null;
+    initialSettings?: Partial<GraphSettings>;
+    storageKey?: string;
+    search?: string;
+    onSearchChange?: (value: string) => void;
+    selectedId?: string | null;
+    onSelect?: (node: GraphNode | null) => void;
+    onOpen?: (node: GraphNode) => void;
+    onShowLocal?: (node: GraphNode) => void;
+    expandable?: boolean;
+    showHeader?: boolean;
+    showModeLabel?: boolean;
+    heading?: string;
+    maxDepth?: number;
+    class?: string;
+};
+export default function GraphView(props: GraphViewProps): import("hono/jsx/jsx-dev-runtime").JSX.Element;