@3plate/graph-core 0.1.7 → 0.1.9

package/dist/index.d.cts

@@ -11,11 +11,24 @@ type Dims = {
 
 type MarkerType = 'arrow' | 'circle' | 'diamond' | 'bar' | 'none';
 
+/**
+ * Ingestion source configuration.
+ * Used to connect to an external data source for graph updates.
+ */
+type IngestionConfig = {
+    type: 'websocket';
+    url: string;
+    reconnectMs?: number;
+} | {
+    type: 'file';
+    url: string;
+    intervalMs?: number;
+};
 /**
  * Arguments to the API constructor.
  *
- * The caller can specify nodes and edges, or history,
- * but not both.
+ * The caller can specify nodes and edges, history, or ingestion config,
+ * but not multiple.
  *
  * The root element ID is required.
  */
@@ -28,6 +41,8 @@ type APIArguments<N, E> = {
     edges?: E[];
     /** Initial history */
     history?: Update<N, E>[];
+    /** Ingestion source configuration */
+    ingestion?: IngestionConfig;
     /** Events */
     events?: EventsOptions<N, E>;
     /** Root element ID */
@@ -370,11 +385,19 @@ declare class API<N, E> {
     private nextNodeId;
     private nextEdgeId;
     private events;
+    private ingest?;
+    private ingestionSource?;
+    private ingestionConfig?;
+    private prevProps;
     root: string;
     constructor(args: APIArguments<N, E>);
     reset(): void;
     /** Initialize the API */
     init(): Promise<void>;
+    /** Connect to the configured ingestion source */
+    private connectIngestion;
+    /** Disconnect from the ingestion source */
+    private disconnectIngestion;
     private applyHistory;
     /** Current history index (0-based) */
     getHistoryIndex(): number;
@@ -446,6 +469,20 @@ declare class API<N, E> {
     }): void;
     /** Update color mode without recreating the canvas */
     setColorMode(colorMode: 'light' | 'dark' | 'system'): void;
+    /**
+     * Apply prop changes by diffing against previously applied props.
+     * This is a convenience method for framework wrappers that centralizes
+     * the logic for detecting and applying changes to nodes, edges, history, and options.
+     * The API stores the previous props internally, so you just pass the new props.
+     *
+     * @param props - The new props to apply
+     */
+    applyProps(props: {
+        nodes?: N[];
+        edges?: E[];
+        history?: Update<N, E>[];
+        options?: APIOptions<N, E>;
+    }): void;
     /** Cleanup resources when the graph is destroyed */
     destroy(): void;
 }
@@ -648,4 +685,4 @@ declare class Playground {
 
 declare function graph<N, E>(args?: APIArguments<N, E>): Promise<API<N, E>>;
 
-export { API, type APIArguments, type APIOptions, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, FileSystemSource, type HistoryMessage, Ingest, type IngestMessage, Playground, type PlaygroundOptions, type SnapshotMessage, type Update, type UpdateMessage, Updater, WebSocketSource, graph as default, graph };
+export { API, type APIArguments, type APIOptions, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, FileSystemSource, type HistoryMessage, Ingest, type IngestMessage, type IngestionConfig, Playground, type PlaygroundOptions, type SnapshotMessage, type Update, type UpdateMessage, Updater, WebSocketSource, graph as default, graph };

package/dist/index.d.ts

@@ -11,11 +11,24 @@ type Dims = {
 
 type MarkerType = 'arrow' | 'circle' | 'diamond' | 'bar' | 'none';
 
+/**
+ * Ingestion source configuration.
+ * Used to connect to an external data source for graph updates.
+ */
+type IngestionConfig = {
+    type: 'websocket';
+    url: string;
+    reconnectMs?: number;
+} | {
+    type: 'file';
+    url: string;
+    intervalMs?: number;
+};
 /**
  * Arguments to the API constructor.
  *
- * The caller can specify nodes and edges, or history,
- * but not both.
+ * The caller can specify nodes and edges, history, or ingestion config,
+ * but not multiple.
  *
  * The root element ID is required.
  */
@@ -28,6 +41,8 @@ type APIArguments<N, E> = {
     edges?: E[];
     /** Initial history */
     history?: Update<N, E>[];
+    /** Ingestion source configuration */
+    ingestion?: IngestionConfig;
     /** Events */
     events?: EventsOptions<N, E>;
     /** Root element ID */
@@ -370,11 +385,19 @@ declare class API<N, E> {
     private nextNodeId;
     private nextEdgeId;
     private events;
+    private ingest?;
+    private ingestionSource?;
+    private ingestionConfig?;
+    private prevProps;
     root: string;
     constructor(args: APIArguments<N, E>);
     reset(): void;
     /** Initialize the API */
     init(): Promise<void>;
+    /** Connect to the configured ingestion source */
+    private connectIngestion;
+    /** Disconnect from the ingestion source */
+    private disconnectIngestion;
     private applyHistory;
     /** Current history index (0-based) */
     getHistoryIndex(): number;
@@ -446,6 +469,20 @@ declare class API<N, E> {
     }): void;
     /** Update color mode without recreating the canvas */
     setColorMode(colorMode: 'light' | 'dark' | 'system'): void;
+    /**
+     * Apply prop changes by diffing against previously applied props.
+     * This is a convenience method for framework wrappers that centralizes
+     * the logic for detecting and applying changes to nodes, edges, history, and options.
+     * The API stores the previous props internally, so you just pass the new props.
+     *
+     * @param props - The new props to apply
+     */
+    applyProps(props: {
+        nodes?: N[];
+        edges?: E[];
+        history?: Update<N, E>[];
+        options?: APIOptions<N, E>;
+    }): void;
     /** Cleanup resources when the graph is destroyed */
     destroy(): void;
 }
@@ -648,4 +685,4 @@ declare class Playground {
 
 declare function graph<N, E>(args?: APIArguments<N, E>): Promise<API<N, E>>;
 
-export { API, type APIArguments, type APIOptions, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, FileSystemSource, type HistoryMessage, Ingest, type IngestMessage, Playground, type PlaygroundOptions, type SnapshotMessage, type Update, type UpdateMessage, Updater, WebSocketSource, graph as default, graph };
+export { API, type APIArguments, type APIOptions, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, FileSystemSource, type HistoryMessage, Ingest, type IngestMessage, type IngestionConfig, Playground, type PlaygroundOptions, type SnapshotMessage, type Update, type UpdateMessage, Updater, WebSocketSource, graph as default, graph };