@3plate/graph-core 0.1.10 → 0.1.12

package/dist/index.cjs

@@ -3678,7 +3678,7 @@ var Ingest = class {
    * Apply an incoming ingest message to the API.
    * - snapshot: rebuild state from nodes/edges (clears prior history)
    * - update: apply incremental update
-   * - history: initialize from a set of frames (clears prior history)
+   * - history: initialize from a set of updates (clears prior history)
    */
   async apply(msg) {
     switch (msg.type) {
@@ -3699,7 +3699,7 @@ var Ingest = class {
         break;
       }
       case "history": {
-        await this.api.replaceHistory(msg.frames);
+        await this.api.replaceHistory(msg.history);
         break;
       }
     }
@@ -4073,9 +4073,9 @@ var API = class {
     this.canvas.editMode.editable = editable;
   }
   /** Replace entire history (clears prior) */
-  async replaceHistory(frames) {
+  async replaceHistory(history) {
     this.reset();
-    this.history = frames;
+    this.history = history;
     await this.applyHistory();
   }
   /** Rebuild from snapshot (nodes/edges) */
@@ -4542,8 +4542,8 @@ var API = class {
         }
       } else if (prev.history && isHistoryPrefix(prev.history, props.history)) {
         const prevLength = prev.history.length;
-        const newFrames = props.history.slice(prevLength);
-        for (const frame of newFrames) {
+        const newUpdates = props.history.slice(prevLength);
+        for (const frame of newUpdates) {
           this.update((u) => {
             if (frame.addNodes) u.addNodes(...frame.addNodes);
             if (frame.removeNodes) u.deleteNodes(...frame.removeNodes);

package/dist/index.d.cts

@@ -12,6 +12,87 @@ type Dims = {
 
 type MarkerType = 'arrow' | 'circle' | 'diamond' | 'bar' | 'none';
 
+type SnapshotMessage<N, E> = {
+    type: 'snapshot';
+    nodes: N[];
+    edges: E[];
+    description?: string;
+};
+type UpdateMessage<N, E> = {
+    type: 'update';
+    description?: string;
+} & Update<N, E>;
+type HistoryMessage<N, E> = {
+    type: 'history';
+    history: Update<N, E>[];
+};
+type IngestMessage<N, E> = SnapshotMessage<N, E> | UpdateMessage<N, E> | HistoryMessage<N, E>;
+/**
+ * Ingest class handles applying ingest messages to an API instance.
+ * This is the core ingestion functionality, separate from UI concerns.
+ */
+declare class Ingest<N, E> {
+    api: API<N, E>;
+    constructor(api: API<N, E>);
+    /**
+     * Apply an incoming ingest message to the API.
+     * - snapshot: rebuild state from nodes/edges (clears prior history)
+     * - update: apply incremental update
+     * - history: initialize from a set of updates (clears prior history)
+     */
+    apply(msg: IngestMessage<N, E>): Promise<void>;
+}
+
+type WebSocketStatus = 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
+type WebSocketStatusListener = (status: WebSocketStatus, detail?: any) => void;
+type WebSocketSourceArgs<N, E> = {
+    url: string;
+    onMessage: (msg: IngestMessage<N, E>) => void;
+    onStatus?: WebSocketStatusListener;
+    reconnectMs?: number;
+};
+declare class WebSocketSource<N, E> {
+    private url;
+    private ws;
+    private onMessage;
+    private onStatus?;
+    private reconnectMs;
+    private closedByUser;
+    private connectStartTime;
+    private totalTimeoutMs;
+    private totalTimeoutTimer;
+    constructor(args: WebSocketSourceArgs<N, E>);
+    connect(): void;
+    disconnect(): void;
+    private startTotalTimeout;
+    private clearTotalTimeout;
+    private open;
+}
+
+type FileStatus = 'idle' | 'opened' | 'reading' | 'error' | 'closed';
+type FileStatusListener = (status: FileStatus, detail?: any) => void;
+type FileSourceArgs<N, E> = {
+    url: string;
+    onMessage: (msg: IngestMessage<N, E>) => void;
+    onStatus?: FileStatusListener;
+    intervalMs?: number;
+};
+declare class FileSource<N, E> {
+    private url;
+    private onMessage;
+    private onStatus?;
+    private timer;
+    private lastETag;
+    private lastContent;
+    private intervalMs;
+    private closed;
+    constructor(args: FileSourceArgs<N, E>);
+    connect(): Promise<void>;
+    close(): void;
+    private startPolling;
+    private poll;
+}
+
 /** WebSocket ingestion configuration */
 type WebSocketIngestionConfig = {
     type: 'websocket';
@@ -19,12 +100,8 @@ type WebSocketIngestionConfig = {
     url: string;
     /** Reconnect interval in milliseconds */
     reconnectMs?: number;
-    /** Callback when the WebSocket connection is established */
-    onConnect?: () => void;
-    /** Callback when the WebSocket connection is closed */
-    onDisconnect?: () => void;
-    /** Callback when the WebSocket connection encounters an error */
-    onError?: (error: Error) => void;
+    /** Status listener */
+    onStatus?: WebSocketStatusListener;
 };
 /** File ingestion configuration */
 type FileIngestionConfig = {
@@ -33,6 +110,8 @@ type FileIngestionConfig = {
     url: string;
     /** Polling interval in milliseconds */
     intervalMs?: number;
+    /** Status listener */
+    onStatus?: FileStatusListener;
 };
 /**
  * Ingestion source configuration.
@@ -421,7 +500,7 @@ declare class API<N, E> {
     /** Toggle canvas editable mode without re-creating the graph */
     setEditable(editable: boolean): void;
     /** Replace entire history (clears prior) */
-    replaceHistory(frames: Update<N, E>[]): Promise<void>;
+    replaceHistory(history: Update<N, E>[]): Promise<void>;
     /** Rebuild from snapshot (nodes/edges) */
     replaceSnapshot(nodes: N[], edges: E[], description?: string): Promise<void>;
     private get graph();
@@ -502,68 +581,11 @@ declare class API<N, E> {
     destroy(): void;
 }
 
-type SnapshotMessage<N, E> = {
-    type: 'snapshot';
-    nodes: N[];
-    edges: E[];
-    description?: string;
-};
-type UpdateMessage<N, E> = {
-    type: 'update';
-    description?: string;
-} & Update<N, E>;
-type HistoryMessage<N, E> = {
-    type: 'history';
-    frames: Update<N, E>[];
-};
-type IngestMessage<N, E> = SnapshotMessage<N, E> | UpdateMessage<N, E> | HistoryMessage<N, E>;
-/**
- * Ingest class handles applying ingest messages to an API instance.
- * This is the core ingestion functionality, separate from UI concerns.
- */
-declare class Ingest<N, E> {
-    api: API<N, E>;
-    constructor(api: API<N, E>);
-    /**
-     * Apply an incoming ingest message to the API.
-     * - snapshot: rebuild state from nodes/edges (clears prior history)
-     * - update: apply incremental update
-     * - history: initialize from a set of frames (clears prior history)
-     */
-    apply(msg: IngestMessage<N, E>): Promise<void>;
-}
-
-type WebSocketStatus = 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
-type WebSocketStatusListener = (status: WebSocketStatus, detail?: any) => void;
-type WebSocketSourceArgs<N, E> = {
-    url: string;
-    onMessage: (msg: IngestMessage<N, E>) => void;
-    onStatus?: WebSocketStatusListener;
-    reconnectMs?: number;
-};
-declare class WebSocketSource<N, E> {
-    private url;
-    private ws;
-    private onMessage;
-    private onStatus?;
-    private reconnectMs;
-    private closedByUser;
-    private connectStartTime;
-    private totalTimeoutMs;
-    private totalTimeoutTimer;
-    constructor(args: WebSocketSourceArgs<N, E>);
-    connect(): void;
-    disconnect(): void;
-    private startTotalTimeout;
-    private clearTotalTimeout;
-    private open;
-}
-
-type StatusListener$1 = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
+type StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
 type FileSystemSourceArgs<N, E> = {
     filename: string;
     onMessage: (msg: IngestMessage<N, E>) => void;
-    onStatus?: StatusListener$1;
+    onStatus?: StatusListener;
     intervalMs?: number;
 };
 declare class FileSystemSource<N, E> {
@@ -581,29 +603,6 @@ declare class FileSystemSource<N, E> {
     private readNewLines;
 }
 
-type StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
-type FileSourceArgs<N, E> = {
-    url: string;
-    onMessage: (msg: IngestMessage<N, E>) => void;
-    onStatus?: StatusListener;
-    intervalMs?: number;
-};
-declare class FileSource<N, E> {
-    private url;
-    private onMessage;
-    private onStatus?;
-    private timer;
-    private lastETag;
-    private lastContent;
-    private intervalMs;
-    private closed;
-    constructor(args: FileSourceArgs<N, E>);
-    connect(): Promise<void>;
-    close(): void;
-    private startPolling;
-    private poll;
-}
-
 /**
  * Types for the Playground component
  */
@@ -719,4 +718,4 @@ declare class Playground {
 
 declare function graph<N, E>(args?: APIArguments<N, E>): Promise<API<N, E>>;
 
-export { API, type APIArguments, type APIOptions, type CanvasTheme, type ColorMode, type EdgeProps, type EdgeTheme, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, type FileSourceArgs, FileSystemSource, type FileSystemSourceArgs, type HistoryMessage, Ingest, type IngestMessage, type IngestionConfig, type NewEdge, type NewNode, type NodeAlign, type NodeProps, type NodeTheme, type Orientation, Playground, type PlaygroundOptions, type PortProps, type PortStyle, type PortTheme, type RenderNode, type SnapshotMessage, type ThemeVars, type Update, type UpdateMessage, Updater, WebSocketSource, type WebSocketSourceArgs, type WebSocketStatus, type WebSocketStatusListener, graph as default, graph };
+export { API, type APIArguments, type APIOptions, type CanvasTheme, type ColorMode, type EdgeProps, type EdgeTheme, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, type FileSourceArgs, type FileStatus, type FileStatusListener, FileSystemSource, type FileSystemSourceArgs, type HistoryMessage, Ingest, type IngestMessage, type IngestionConfig, type NewEdge, type NewNode, type NodeAlign, type NodeProps, type NodeTheme, type Orientation, Playground, type PlaygroundOptions, type PortProps, type PortStyle, type PortTheme, type RenderNode, type SnapshotMessage, type ThemeVars, type Update, type UpdateMessage, Updater, WebSocketSource, type WebSocketSourceArgs, type WebSocketStatus, type WebSocketStatusListener, graph as default, graph };

package/dist/index.d.ts

@@ -12,6 +12,87 @@ type Dims = {
 
 type MarkerType = 'arrow' | 'circle' | 'diamond' | 'bar' | 'none';
 
+type SnapshotMessage<N, E> = {
+    type: 'snapshot';
+    nodes: N[];
+    edges: E[];
+    description?: string;
+};
+type UpdateMessage<N, E> = {
+    type: 'update';
+    description?: string;
+} & Update<N, E>;
+type HistoryMessage<N, E> = {
+    type: 'history';
+    history: Update<N, E>[];
+};
+type IngestMessage<N, E> = SnapshotMessage<N, E> | UpdateMessage<N, E> | HistoryMessage<N, E>;
+/**
+ * Ingest class handles applying ingest messages to an API instance.
+ * This is the core ingestion functionality, separate from UI concerns.
+ */
+declare class Ingest<N, E> {
+    api: API<N, E>;
+    constructor(api: API<N, E>);
+    /**
+     * Apply an incoming ingest message to the API.
+     * - snapshot: rebuild state from nodes/edges (clears prior history)
+     * - update: apply incremental update
+     * - history: initialize from a set of updates (clears prior history)
+     */
+    apply(msg: IngestMessage<N, E>): Promise<void>;
+}
+
+type WebSocketStatus = 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
+type WebSocketStatusListener = (status: WebSocketStatus, detail?: any) => void;
+type WebSocketSourceArgs<N, E> = {
+    url: string;
+    onMessage: (msg: IngestMessage<N, E>) => void;
+    onStatus?: WebSocketStatusListener;
+    reconnectMs?: number;
+};
+declare class WebSocketSource<N, E> {
+    private url;
+    private ws;
+    private onMessage;
+    private onStatus?;
+    private reconnectMs;
+    private closedByUser;
+    private connectStartTime;
+    private totalTimeoutMs;
+    private totalTimeoutTimer;
+    constructor(args: WebSocketSourceArgs<N, E>);
+    connect(): void;
+    disconnect(): void;
+    private startTotalTimeout;
+    private clearTotalTimeout;
+    private open;
+}
+
+type FileStatus = 'idle' | 'opened' | 'reading' | 'error' | 'closed';
+type FileStatusListener = (status: FileStatus, detail?: any) => void;
+type FileSourceArgs<N, E> = {
+    url: string;
+    onMessage: (msg: IngestMessage<N, E>) => void;
+    onStatus?: FileStatusListener;
+    intervalMs?: number;
+};
+declare class FileSource<N, E> {
+    private url;
+    private onMessage;
+    private onStatus?;
+    private timer;
+    private lastETag;
+    private lastContent;
+    private intervalMs;
+    private closed;
+    constructor(args: FileSourceArgs<N, E>);
+    connect(): Promise<void>;
+    close(): void;
+    private startPolling;
+    private poll;
+}
+
 /** WebSocket ingestion configuration */
 type WebSocketIngestionConfig = {
     type: 'websocket';
@@ -19,12 +100,8 @@ type WebSocketIngestionConfig = {
     url: string;
     /** Reconnect interval in milliseconds */
     reconnectMs?: number;
-    /** Callback when the WebSocket connection is established */
-    onConnect?: () => void;
-    /** Callback when the WebSocket connection is closed */
-    onDisconnect?: () => void;
-    /** Callback when the WebSocket connection encounters an error */
-    onError?: (error: Error) => void;
+    /** Status listener */
+    onStatus?: WebSocketStatusListener;
 };
 /** File ingestion configuration */
 type FileIngestionConfig = {
@@ -33,6 +110,8 @@ type FileIngestionConfig = {
     url: string;
     /** Polling interval in milliseconds */
     intervalMs?: number;
+    /** Status listener */
+    onStatus?: FileStatusListener;
 };
 /**
  * Ingestion source configuration.
@@ -421,7 +500,7 @@ declare class API<N, E> {
     /** Toggle canvas editable mode without re-creating the graph */
     setEditable(editable: boolean): void;
     /** Replace entire history (clears prior) */
-    replaceHistory(frames: Update<N, E>[]): Promise<void>;
+    replaceHistory(history: Update<N, E>[]): Promise<void>;
     /** Rebuild from snapshot (nodes/edges) */
     replaceSnapshot(nodes: N[], edges: E[], description?: string): Promise<void>;
     private get graph();
@@ -502,68 +581,11 @@ declare class API<N, E> {
     destroy(): void;
 }
 
-type SnapshotMessage<N, E> = {
-    type: 'snapshot';
-    nodes: N[];
-    edges: E[];
-    description?: string;
-};
-type UpdateMessage<N, E> = {
-    type: 'update';
-    description?: string;
-} & Update<N, E>;
-type HistoryMessage<N, E> = {
-    type: 'history';
-    frames: Update<N, E>[];
-};
-type IngestMessage<N, E> = SnapshotMessage<N, E> | UpdateMessage<N, E> | HistoryMessage<N, E>;
-/**
- * Ingest class handles applying ingest messages to an API instance.
- * This is the core ingestion functionality, separate from UI concerns.
- */
-declare class Ingest<N, E> {
-    api: API<N, E>;
-    constructor(api: API<N, E>);
-    /**
-     * Apply an incoming ingest message to the API.
-     * - snapshot: rebuild state from nodes/edges (clears prior history)
-     * - update: apply incremental update
-     * - history: initialize from a set of frames (clears prior history)
-     */
-    apply(msg: IngestMessage<N, E>): Promise<void>;
-}
-
-type WebSocketStatus = 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
-type WebSocketStatusListener = (status: WebSocketStatus, detail?: any) => void;
-type WebSocketSourceArgs<N, E> = {
-    url: string;
-    onMessage: (msg: IngestMessage<N, E>) => void;
-    onStatus?: WebSocketStatusListener;
-    reconnectMs?: number;
-};
-declare class WebSocketSource<N, E> {
-    private url;
-    private ws;
-    private onMessage;
-    private onStatus?;
-    private reconnectMs;
-    private closedByUser;
-    private connectStartTime;
-    private totalTimeoutMs;
-    private totalTimeoutTimer;
-    constructor(args: WebSocketSourceArgs<N, E>);
-    connect(): void;
-    disconnect(): void;
-    private startTotalTimeout;
-    private clearTotalTimeout;
-    private open;
-}
-
-type StatusListener$1 = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
+type StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
 type FileSystemSourceArgs<N, E> = {
     filename: string;
     onMessage: (msg: IngestMessage<N, E>) => void;
-    onStatus?: StatusListener$1;
+    onStatus?: StatusListener;
     intervalMs?: number;
 };
 declare class FileSystemSource<N, E> {
@@ -581,29 +603,6 @@ declare class FileSystemSource<N, E> {
     private readNewLines;
 }
 
-type StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
-type FileSourceArgs<N, E> = {
-    url: string;
-    onMessage: (msg: IngestMessage<N, E>) => void;
-    onStatus?: StatusListener;
-    intervalMs?: number;
-};
-declare class FileSource<N, E> {
-    private url;
-    private onMessage;
-    private onStatus?;
-    private timer;
-    private lastETag;
-    private lastContent;
-    private intervalMs;
-    private closed;
-    constructor(args: FileSourceArgs<N, E>);
-    connect(): Promise<void>;
-    close(): void;
-    private startPolling;
-    private poll;
-}
-
 /**
  * Types for the Playground component
  */
@@ -719,4 +718,4 @@ declare class Playground {
 
 declare function graph<N, E>(args?: APIArguments<N, E>): Promise<API<N, E>>;
 
-export { API, type APIArguments, type APIOptions, type CanvasTheme, type ColorMode, type EdgeProps, type EdgeTheme, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, type FileSourceArgs, FileSystemSource, type FileSystemSourceArgs, type HistoryMessage, Ingest, type IngestMessage, type IngestionConfig, type NewEdge, type NewNode, type NodeAlign, type NodeProps, type NodeTheme, type Orientation, Playground, type PlaygroundOptions, type PortProps, type PortStyle, type PortTheme, type RenderNode, type SnapshotMessage, type ThemeVars, type Update, type UpdateMessage, Updater, WebSocketSource, type WebSocketSourceArgs, type WebSocketStatus, type WebSocketStatusListener, graph as default, graph };
+export { API, type APIArguments, type APIOptions, type CanvasTheme, type ColorMode, type EdgeProps, type EdgeTheme, type EventsOptions, type Example, type ExampleEdge, type ExampleNode, type ExampleOptions, FileSource, type FileSourceArgs, type FileStatus, type FileStatusListener, FileSystemSource, type FileSystemSourceArgs, type HistoryMessage, Ingest, type IngestMessage, type IngestionConfig, type NewEdge, type NewNode, type NodeAlign, type NodeProps, type NodeTheme, type Orientation, Playground, type PlaygroundOptions, type PortProps, type PortStyle, type PortTheme, type RenderNode, type SnapshotMessage, type ThemeVars, type Update, type UpdateMessage, Updater, WebSocketSource, type WebSocketSourceArgs, type WebSocketStatus, type WebSocketStatusListener, graph as default, graph };

package/dist/index.js

@@ -3635,7 +3635,7 @@ var Ingest = class {
    * Apply an incoming ingest message to the API.
    * - snapshot: rebuild state from nodes/edges (clears prior history)
    * - update: apply incremental update
-   * - history: initialize from a set of frames (clears prior history)
+   * - history: initialize from a set of updates (clears prior history)
    */
   async apply(msg) {
     switch (msg.type) {
@@ -3656,7 +3656,7 @@ var Ingest = class {
         break;
       }
       case "history": {
-        await this.api.replaceHistory(msg.frames);
+        await this.api.replaceHistory(msg.history);
         break;
       }
     }
@@ -4030,9 +4030,9 @@ var API = class {
     this.canvas.editMode.editable = editable;
   }
   /** Replace entire history (clears prior) */
-  async replaceHistory(frames) {
+  async replaceHistory(history) {
     this.reset();
-    this.history = frames;
+    this.history = history;
     await this.applyHistory();
   }
   /** Rebuild from snapshot (nodes/edges) */
@@ -4499,8 +4499,8 @@ var API = class {
         }
       } else if (prev.history && isHistoryPrefix(prev.history, props.history)) {
         const prevLength = prev.history.length;
-        const newFrames = props.history.slice(prevLength);
-        for (const frame of newFrames) {
+        const newUpdates = props.history.slice(prevLength);
+        for (const frame of newUpdates) {
           this.update((u) => {
             if (frame.addNodes) u.addNodes(...frame.addNodes);
             if (frame.removeNodes) u.deleteNodes(...frame.removeNodes);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3plate/graph-core",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "type": "module",
   "license": "GPL-3.0",
   "repository": {
@@ -8,13 +8,15 @@
     "url": "https://github.com/3plt/graph",
     "directory": "packages/core"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     }
   },
   "files": [