@3plate/graph-core 0.1.9 → 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;
       }
     }
@@ -3717,11 +3717,11 @@ var WebSocketSource = class {
   connectStartTime = null;
   totalTimeoutMs = 1e4;
   totalTimeoutTimer = null;
-  constructor(url, onMessage, onStatus, reconnectMs = 1500) {
-    this.url = url;
-    this.onMessage = onMessage;
-    this.onStatus = onStatus;
-    this.reconnectMs = reconnectMs;
+  constructor(args) {
+    this.url = args.url;
+    this.onMessage = args.onMessage;
+    this.onStatus = args.onStatus;
+    this.reconnectMs = args.reconnectMs ?? 1500;
   }
   connect() {
     this.closedByUser = false;
@@ -3822,11 +3822,11 @@ var FileSource = class {
   lastContent = "";
   intervalMs = 1e3;
   closed = false;
-  constructor(url, onMessage, onStatus, intervalMs = 1e3) {
-    this.url = url;
-    this.onMessage = onMessage;
-    this.onStatus = onStatus;
-    this.intervalMs = intervalMs;
+  constructor(args) {
+    this.url = args.url;
+    this.onMessage = args.onMessage;
+    this.onStatus = args.onStatus;
+    this.intervalMs = args.intervalMs ?? 1e3;
   }
   async connect() {
     this.closed = false;
@@ -3888,6 +3888,68 @@ var FileSource = class {
   }
 };
 
+// src/api/sources/FileSystemSource.ts
+var FileSystemSource = class {
+  handle = null;
+  onMessage;
+  onStatus;
+  timer = null;
+  lastSize = 0;
+  filename;
+  intervalMs;
+  constructor(args) {
+    this.filename = args.filename;
+    this.onMessage = args.onMessage;
+    this.onStatus = args.onStatus;
+    this.intervalMs = args.intervalMs ?? 1e3;
+  }
+  async openDirectory() {
+    try {
+      const dir = await window.showDirectoryPicker?.();
+      if (!dir) throw new Error("File System Access not supported or cancelled");
+      const handle = await dir.getFileHandle(this.filename, { create: false });
+      this.handle = handle;
+      this.onStatus?.("opened", { file: this.filename });
+      this.lastSize = 0;
+      this.startPolling();
+    } catch (e) {
+      this.onStatus?.("error", e);
+    }
+  }
+  close() {
+    if (this.timer) {
+      window.clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.handle = null;
+    this.onStatus?.("closed");
+  }
+  startPolling() {
+    if (this.timer) window.clearInterval(this.timer);
+    this.timer = window.setInterval(() => this.readNewLines(), this.intervalMs);
+  }
+  async readNewLines() {
+    try {
+      if (!this.handle) return;
+      this.onStatus?.("reading");
+      const file = await this.handle.getFile();
+      if (file.size === this.lastSize) return;
+      const slice = await file.slice(this.lastSize).text();
+      this.lastSize = file.size;
+      const lines = slice.split("\n").map((l) => l.trim()).filter(Boolean);
+      for (const line of lines) {
+        try {
+          const obj = JSON.parse(line);
+          this.onMessage(obj);
+        } catch {
+        }
+      }
+    } catch (e) {
+      this.onStatus?.("error", e);
+    }
+  }
+};
+
 // src/api/api.ts
 var log11 = logger("api");
 var API = class {
@@ -3970,29 +4032,19 @@ var API = class {
   /** Connect to the configured ingestion source */
   connectIngestion() {
     if (!this.ingestionConfig || !this.ingest) return;
-    const handleMessage = (msg) => {
-      this.ingest.apply(msg);
+    const args = {
+      ...this.ingestionConfig,
+      onMessage: (msg) => {
+        this.ingest.apply(msg);
+      }
     };
-    switch (this.ingestionConfig.type) {
-      case "websocket":
-        this.ingestionSource = new WebSocketSource(
-          this.ingestionConfig.url,
-          handleMessage,
-          void 0,
-          this.ingestionConfig.reconnectMs
-        );
-        this.ingestionSource.connect();
-        break;
-      case "file":
-        this.ingestionSource = new FileSource(
-          this.ingestionConfig.url,
-          handleMessage,
-          void 0,
-          this.ingestionConfig.intervalMs
-        );
-        this.ingestionSource.connect();
-        break;
-    }
+    const source = {
+      "websocket": WebSocketSource,
+      "file": FileSource,
+      "filesystem": FileSystemSource
+    }[this.ingestionConfig.type];
+    this.ingestionSource = new source[this.ingestionConfig.type](args);
+    this.ingestionSource?.connect();
   }
   /** Disconnect from the ingestion source */
   disconnectIngestion() {
@@ -4021,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) */
@@ -4490,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);
@@ -4578,68 +4630,6 @@ function shallowEqualUpdate(a, b) {
   return true;
 }
 
-// src/api/sources/FileSystemSource.ts
-var FileSystemSource = class {
-  handle = null;
-  onMessage;
-  onStatus;
-  timer = null;
-  lastSize = 0;
-  filename;
-  intervalMs;
-  constructor(onMessage, onStatus, filename = "graph.ndjson", intervalMs = 1e3) {
-    this.onMessage = onMessage;
-    this.onStatus = onStatus;
-    this.filename = filename;
-    this.intervalMs = intervalMs;
-  }
-  async openDirectory() {
-    try {
-      const dir = await window.showDirectoryPicker?.();
-      if (!dir) throw new Error("File System Access not supported or cancelled");
-      const handle = await dir.getFileHandle(this.filename, { create: false });
-      this.handle = handle;
-      this.onStatus?.("opened", { file: this.filename });
-      this.lastSize = 0;
-      this.startPolling();
-    } catch (e) {
-      this.onStatus?.("error", e);
-    }
-  }
-  close() {
-    if (this.timer) {
-      window.clearInterval(this.timer);
-      this.timer = null;
-    }
-    this.handle = null;
-    this.onStatus?.("closed");
-  }
-  startPolling() {
-    if (this.timer) window.clearInterval(this.timer);
-    this.timer = window.setInterval(() => this.readNewLines(), this.intervalMs);
-  }
-  async readNewLines() {
-    try {
-      if (!this.handle) return;
-      this.onStatus?.("reading");
-      const file = await this.handle.getFile();
-      if (file.size === this.lastSize) return;
-      const slice = await file.slice(this.lastSize).text();
-      this.lastSize = file.size;
-      const lines = slice.split("\n").map((l) => l.trim()).filter(Boolean);
-      for (const line of lines) {
-        try {
-          const obj = JSON.parse(line);
-          this.onMessage(obj);
-        } catch {
-        }
-      }
-    } catch (e) {
-      this.onStatus?.("error", e);
-    }
-  }
-};
-
 // src/playground/playground.ts
 var import_styles2 = __toESM(require("./styles.css?raw"), 1);
 var Playground = class {
@@ -4918,10 +4908,18 @@ var Playground = class {
     this.disconnectAllSources();
     if (example.source.type === "websocket") {
       this.wsUrl = example.source.url;
-      this.wsSource = new WebSocketSource(example.source.url, this.handleIngestMessage.bind(this), this.updateWsStatus);
+      this.wsSource = new WebSocketSource({
+        url: example.source.url,
+        onMessage: this.handleIngestMessage.bind(this),
+        onStatus: this.updateWsStatus
+      });
       this.wsSource.connect();
     } else if (example.source.type === "file") {
-      this.fileSource = new FileSource(example.source.path, this.handleIngestMessage.bind(this), this.updateFileStatus);
+      this.fileSource = new FileSource({
+        url: example.source.path,
+        onMessage: this.handleIngestMessage.bind(this),
+        onStatus: this.updateFileStatus
+      });
       this.fileSource.connect();
     }
   }
@@ -5321,7 +5319,11 @@ var Playground = class {
     if (this.wsSource) {
       this.wsSource.disconnect();
     }
-    this.wsSource = new WebSocketSource(url, this.handleIngestMessage.bind(this), this.updateWsStatus);
+    this.wsSource = new WebSocketSource({
+      url,
+      onMessage: this.handleIngestMessage.bind(this),
+      onStatus: this.updateWsStatus
+    });
     this.wsSource.connect();
     this.updateSourceModal();
   }
@@ -5342,7 +5344,11 @@ var Playground = class {
   }
   async handleOpenFolder() {
     if (!this.fsSource) {
-      this.fsSource = new FileSystemSource(this.handleIngestMessage.bind(this), this.updateFsStatus);
+      this.fsSource = new FileSystemSource({
+        filename: "graph.ndjson",
+        onMessage: this.handleIngestMessage.bind(this),
+        onStatus: this.updateFsStatus
+      });
     }
     this.updateSourceModal();
     await this.fsSource.openDirectory();

package/dist/index.d.cts

@@ -3,6 +3,7 @@ type MergeOrder = Side[];
 type NodeAlign = 'natural' | 'top' | 'bottom' | 'left' | 'right';
 type Orientation = 'TB' | 'BT' | 'LR' | 'RL';
 type Nav = 'first' | 'last' | 'prev' | 'next';
+type PortStyle = 'inside' | 'outside' | 'custom';
 type LayoutStep = 'alignChildren' | 'alignParents' | 'compact';
 type Dims = {
     w: number;
@@ -11,19 +12,112 @@ 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>;
 /**
- * Ingestion source configuration.
- * Used to connect to an external data source for graph updates.
+ * Ingest class handles applying ingest messages to an API instance.
+ * This is the core ingestion functionality, separate from UI concerns.
  */
-type IngestionConfig = {
+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';
+    /** WebSocket URL */
     url: string;
+    /** Reconnect interval in milliseconds */
     reconnectMs?: number;
-} | {
+    /** Status listener */
+    onStatus?: WebSocketStatusListener;
+};
+/** File ingestion configuration */
+type FileIngestionConfig = {
     type: 'file';
+    /** File URL */
     url: string;
+    /** Polling interval in milliseconds */
     intervalMs?: number;
+    /** Status listener */
+    onStatus?: FileStatusListener;
 };
+/**
+ * Ingestion source configuration.
+ * Used to connect to an external data source for graph updates.
+ */
+type IngestionConfig = WebSocketIngestionConfig | FileIngestionConfig;
 /**
  * Arguments to the API constructor.
  *
@@ -406,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();
@@ -487,57 +581,13 @@ 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 StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
+type FileSystemSourceArgs<N, E> = {
+    filename: string;
+    onMessage: (msg: IngestMessage<N, E>) => void;
+    onStatus?: StatusListener;
+    intervalMs?: number;
 };
-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 StatusListener$2 = (status: 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error', detail?: any) => void;
-declare class WebSocketSource<N, E> {
-    private url;
-    private ws;
-    private onMessage;
-    private onStatus?;
-    private reconnectMs;
-    private closedByUser;
-    private connectStartTime;
-    private totalTimeoutMs;
-    private totalTimeoutTimer;
-    constructor(url: string, onMessage: (msg: IngestMessage<N, E>) => void, onStatus?: StatusListener$2, reconnectMs?: number);
-    connect(): void;
-    disconnect(): void;
-    private startTotalTimeout;
-    private clearTotalTimeout;
-    private open;
-}
-
-type StatusListener$1 = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
 declare class FileSystemSource<N, E> {
     private handle;
     private onMessage;
@@ -546,30 +596,13 @@ declare class FileSystemSource<N, E> {
     private lastSize;
     private filename;
     private intervalMs;
-    constructor(onMessage: (msg: IngestMessage<N, E>) => void, onStatus?: StatusListener$1, filename?: string, intervalMs?: number);
+    constructor(args: FileSystemSourceArgs<N, E>);
     openDirectory(): Promise<void>;
     close(): void;
     private startPolling;
     private readNewLines;
 }
 
-type StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
-declare class FileSource<N, E> {
-    private url;
-    private onMessage;
-    private onStatus?;
-    private timer;
-    private lastETag;
-    private lastContent;
-    private intervalMs;
-    private closed;
-    constructor(url: string, onMessage: (msg: IngestMessage<N, E>) => void, onStatus?: StatusListener, intervalMs?: number);
-    connect(): Promise<void>;
-    close(): void;
-    private startPolling;
-    private poll;
-}
-
 /**
  * Types for the Playground component
  */
@@ -685,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 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 };
+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

@@ -3,6 +3,7 @@ type MergeOrder = Side[];
 type NodeAlign = 'natural' | 'top' | 'bottom' | 'left' | 'right';
 type Orientation = 'TB' | 'BT' | 'LR' | 'RL';
 type Nav = 'first' | 'last' | 'prev' | 'next';
+type PortStyle = 'inside' | 'outside' | 'custom';
 type LayoutStep = 'alignChildren' | 'alignParents' | 'compact';
 type Dims = {
     w: number;
@@ -11,19 +12,112 @@ 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>;
 /**
- * Ingestion source configuration.
- * Used to connect to an external data source for graph updates.
+ * Ingest class handles applying ingest messages to an API instance.
+ * This is the core ingestion functionality, separate from UI concerns.
  */
-type IngestionConfig = {
+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';
+    /** WebSocket URL */
     url: string;
+    /** Reconnect interval in milliseconds */
     reconnectMs?: number;
-} | {
+    /** Status listener */
+    onStatus?: WebSocketStatusListener;
+};
+/** File ingestion configuration */
+type FileIngestionConfig = {
     type: 'file';
+    /** File URL */
     url: string;
+    /** Polling interval in milliseconds */
     intervalMs?: number;
+    /** Status listener */
+    onStatus?: FileStatusListener;
 };
+/**
+ * Ingestion source configuration.
+ * Used to connect to an external data source for graph updates.
+ */
+type IngestionConfig = WebSocketIngestionConfig | FileIngestionConfig;
 /**
  * Arguments to the API constructor.
  *
@@ -406,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();
@@ -487,57 +581,13 @@ 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 StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
+type FileSystemSourceArgs<N, E> = {
+    filename: string;
+    onMessage: (msg: IngestMessage<N, E>) => void;
+    onStatus?: StatusListener;
+    intervalMs?: number;
 };
-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 StatusListener$2 = (status: 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error', detail?: any) => void;
-declare class WebSocketSource<N, E> {
-    private url;
-    private ws;
-    private onMessage;
-    private onStatus?;
-    private reconnectMs;
-    private closedByUser;
-    private connectStartTime;
-    private totalTimeoutMs;
-    private totalTimeoutTimer;
-    constructor(url: string, onMessage: (msg: IngestMessage<N, E>) => void, onStatus?: StatusListener$2, reconnectMs?: number);
-    connect(): void;
-    disconnect(): void;
-    private startTotalTimeout;
-    private clearTotalTimeout;
-    private open;
-}
-
-type StatusListener$1 = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
 declare class FileSystemSource<N, E> {
     private handle;
     private onMessage;
@@ -546,30 +596,13 @@ declare class FileSystemSource<N, E> {
     private lastSize;
     private filename;
     private intervalMs;
-    constructor(onMessage: (msg: IngestMessage<N, E>) => void, onStatus?: StatusListener$1, filename?: string, intervalMs?: number);
+    constructor(args: FileSystemSourceArgs<N, E>);
     openDirectory(): Promise<void>;
     close(): void;
     private startPolling;
     private readNewLines;
 }
 
-type StatusListener = (status: 'idle' | 'opened' | 'reading' | 'error' | 'closed', detail?: any) => void;
-declare class FileSource<N, E> {
-    private url;
-    private onMessage;
-    private onStatus?;
-    private timer;
-    private lastETag;
-    private lastContent;
-    private intervalMs;
-    private closed;
-    constructor(url: string, onMessage: (msg: IngestMessage<N, E>) => void, onStatus?: StatusListener, intervalMs?: number);
-    connect(): Promise<void>;
-    close(): void;
-    private startPolling;
-    private poll;
-}
-
 /**
  * Types for the Playground component
  */
@@ -685,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 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 };
+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;
       }
     }
@@ -3674,11 +3674,11 @@ var WebSocketSource = class {
   connectStartTime = null;
   totalTimeoutMs = 1e4;
   totalTimeoutTimer = null;
-  constructor(url, onMessage, onStatus, reconnectMs = 1500) {
-    this.url = url;
-    this.onMessage = onMessage;
-    this.onStatus = onStatus;
-    this.reconnectMs = reconnectMs;
+  constructor(args) {
+    this.url = args.url;
+    this.onMessage = args.onMessage;
+    this.onStatus = args.onStatus;
+    this.reconnectMs = args.reconnectMs ?? 1500;
   }
   connect() {
     this.closedByUser = false;
@@ -3779,11 +3779,11 @@ var FileSource = class {
   lastContent = "";
   intervalMs = 1e3;
   closed = false;
-  constructor(url, onMessage, onStatus, intervalMs = 1e3) {
-    this.url = url;
-    this.onMessage = onMessage;
-    this.onStatus = onStatus;
-    this.intervalMs = intervalMs;
+  constructor(args) {
+    this.url = args.url;
+    this.onMessage = args.onMessage;
+    this.onStatus = args.onStatus;
+    this.intervalMs = args.intervalMs ?? 1e3;
   }
   async connect() {
     this.closed = false;
@@ -3845,6 +3845,68 @@ var FileSource = class {
   }
 };
 
+// src/api/sources/FileSystemSource.ts
+var FileSystemSource = class {
+  handle = null;
+  onMessage;
+  onStatus;
+  timer = null;
+  lastSize = 0;
+  filename;
+  intervalMs;
+  constructor(args) {
+    this.filename = args.filename;
+    this.onMessage = args.onMessage;
+    this.onStatus = args.onStatus;
+    this.intervalMs = args.intervalMs ?? 1e3;
+  }
+  async openDirectory() {
+    try {
+      const dir = await window.showDirectoryPicker?.();
+      if (!dir) throw new Error("File System Access not supported or cancelled");
+      const handle = await dir.getFileHandle(this.filename, { create: false });
+      this.handle = handle;
+      this.onStatus?.("opened", { file: this.filename });
+      this.lastSize = 0;
+      this.startPolling();
+    } catch (e) {
+      this.onStatus?.("error", e);
+    }
+  }
+  close() {
+    if (this.timer) {
+      window.clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.handle = null;
+    this.onStatus?.("closed");
+  }
+  startPolling() {
+    if (this.timer) window.clearInterval(this.timer);
+    this.timer = window.setInterval(() => this.readNewLines(), this.intervalMs);
+  }
+  async readNewLines() {
+    try {
+      if (!this.handle) return;
+      this.onStatus?.("reading");
+      const file = await this.handle.getFile();
+      if (file.size === this.lastSize) return;
+      const slice = await file.slice(this.lastSize).text();
+      this.lastSize = file.size;
+      const lines = slice.split("\n").map((l) => l.trim()).filter(Boolean);
+      for (const line of lines) {
+        try {
+          const obj = JSON.parse(line);
+          this.onMessage(obj);
+        } catch {
+        }
+      }
+    } catch (e) {
+      this.onStatus?.("error", e);
+    }
+  }
+};
+
 // src/api/api.ts
 var log11 = logger("api");
 var API = class {
@@ -3927,29 +3989,19 @@ var API = class {
   /** Connect to the configured ingestion source */
   connectIngestion() {
     if (!this.ingestionConfig || !this.ingest) return;
-    const handleMessage = (msg) => {
-      this.ingest.apply(msg);
+    const args = {
+      ...this.ingestionConfig,
+      onMessage: (msg) => {
+        this.ingest.apply(msg);
+      }
     };
-    switch (this.ingestionConfig.type) {
-      case "websocket":
-        this.ingestionSource = new WebSocketSource(
-          this.ingestionConfig.url,
-          handleMessage,
-          void 0,
-          this.ingestionConfig.reconnectMs
-        );
-        this.ingestionSource.connect();
-        break;
-      case "file":
-        this.ingestionSource = new FileSource(
-          this.ingestionConfig.url,
-          handleMessage,
-          void 0,
-          this.ingestionConfig.intervalMs
-        );
-        this.ingestionSource.connect();
-        break;
-    }
+    const source = {
+      "websocket": WebSocketSource,
+      "file": FileSource,
+      "filesystem": FileSystemSource
+    }[this.ingestionConfig.type];
+    this.ingestionSource = new source[this.ingestionConfig.type](args);
+    this.ingestionSource?.connect();
   }
   /** Disconnect from the ingestion source */
   disconnectIngestion() {
@@ -3978,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) */
@@ -4447,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);
@@ -4535,68 +4587,6 @@ function shallowEqualUpdate(a, b) {
   return true;
 }
 
-// src/api/sources/FileSystemSource.ts
-var FileSystemSource = class {
-  handle = null;
-  onMessage;
-  onStatus;
-  timer = null;
-  lastSize = 0;
-  filename;
-  intervalMs;
-  constructor(onMessage, onStatus, filename = "graph.ndjson", intervalMs = 1e3) {
-    this.onMessage = onMessage;
-    this.onStatus = onStatus;
-    this.filename = filename;
-    this.intervalMs = intervalMs;
-  }
-  async openDirectory() {
-    try {
-      const dir = await window.showDirectoryPicker?.();
-      if (!dir) throw new Error("File System Access not supported or cancelled");
-      const handle = await dir.getFileHandle(this.filename, { create: false });
-      this.handle = handle;
-      this.onStatus?.("opened", { file: this.filename });
-      this.lastSize = 0;
-      this.startPolling();
-    } catch (e) {
-      this.onStatus?.("error", e);
-    }
-  }
-  close() {
-    if (this.timer) {
-      window.clearInterval(this.timer);
-      this.timer = null;
-    }
-    this.handle = null;
-    this.onStatus?.("closed");
-  }
-  startPolling() {
-    if (this.timer) window.clearInterval(this.timer);
-    this.timer = window.setInterval(() => this.readNewLines(), this.intervalMs);
-  }
-  async readNewLines() {
-    try {
-      if (!this.handle) return;
-      this.onStatus?.("reading");
-      const file = await this.handle.getFile();
-      if (file.size === this.lastSize) return;
-      const slice = await file.slice(this.lastSize).text();
-      this.lastSize = file.size;
-      const lines = slice.split("\n").map((l) => l.trim()).filter(Boolean);
-      for (const line of lines) {
-        try {
-          const obj = JSON.parse(line);
-          this.onMessage(obj);
-        } catch {
-        }
-      }
-    } catch (e) {
-      this.onStatus?.("error", e);
-    }
-  }
-};
-
 // src/playground/playground.ts
 import styles2 from "./styles.css?raw";
 var Playground = class {
@@ -4875,10 +4865,18 @@ var Playground = class {
     this.disconnectAllSources();
     if (example.source.type === "websocket") {
       this.wsUrl = example.source.url;
-      this.wsSource = new WebSocketSource(example.source.url, this.handleIngestMessage.bind(this), this.updateWsStatus);
+      this.wsSource = new WebSocketSource({
+        url: example.source.url,
+        onMessage: this.handleIngestMessage.bind(this),
+        onStatus: this.updateWsStatus
+      });
       this.wsSource.connect();
     } else if (example.source.type === "file") {
-      this.fileSource = new FileSource(example.source.path, this.handleIngestMessage.bind(this), this.updateFileStatus);
+      this.fileSource = new FileSource({
+        url: example.source.path,
+        onMessage: this.handleIngestMessage.bind(this),
+        onStatus: this.updateFileStatus
+      });
       this.fileSource.connect();
     }
   }
@@ -5278,7 +5276,11 @@ var Playground = class {
     if (this.wsSource) {
       this.wsSource.disconnect();
     }
-    this.wsSource = new WebSocketSource(url, this.handleIngestMessage.bind(this), this.updateWsStatus);
+    this.wsSource = new WebSocketSource({
+      url,
+      onMessage: this.handleIngestMessage.bind(this),
+      onStatus: this.updateWsStatus
+    });
     this.wsSource.connect();
     this.updateSourceModal();
   }
@@ -5299,7 +5301,11 @@ var Playground = class {
   }
   async handleOpenFolder() {
     if (!this.fsSource) {
-      this.fsSource = new FileSystemSource(this.handleIngestMessage.bind(this), this.updateFsStatus);
+      this.fsSource = new FileSystemSource({
+        filename: "graph.ndjson",
+        onMessage: this.handleIngestMessage.bind(this),
+        onStatus: this.updateFsStatus
+      });
     }
     this.updateSourceModal();
     await this.fsSource.openDirectory();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3plate/graph-core",
-  "version": "0.1.9",
+  "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": [