@stuly/anode 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 luxluth <delphin.blehoussi93@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# anode
+
+The core headless engine for Anode. It manages graph state, connectivity,
+spatial indexing, and history independently of any UI framework.
+
+## Installation
+
+```bash
+npm install @stuly/anode
+```
+
+## Features
+
+- **Headless Context:** Centralized state management for nodes, links, and sockets.
+- **QuadTree Indexing:** High-performance spatial querying and culling.
+- **Transactional History:** Built-in undo/redo with support for batched actions.
+- **Data Flow:** Automated value propagation between linked sockets.
+
+For detailed documentation and usage examples, see the [root README](../../README.md).

package/dist/anode.d.ts

@@ -0,0 +1,4 @@
+import { Entity, Group, Link, LinkKind, Socket, SocketKind, Vec2 } from "./core/elements.js";
+import { QuadTree, Rect, getLinkCenter, getLinkPath, getLinkPoints } from "./core/layout.js";
+import { CallbackHandle, Context, EntityCallback, EntityMoveCallback, GroupCallback, LinkCallback, SocketCallback, SocketValueCallback } from "./core/context.js";
+export { CallbackHandle, Context, Entity, EntityCallback, EntityMoveCallback, Group, GroupCallback, Link, LinkCallback, LinkKind, QuadTree, Rect, Socket, SocketCallback, SocketKind, SocketValueCallback, Vec2, getLinkCenter, getLinkPath, getLinkPoints };

package/dist/anode.js

@@ -0,0 +1,5 @@
+import { Entity, Group, Link, LinkKind, Socket, SocketKind, Vec2 } from "./core/elements.js";
+import { QuadTree, Rect, getLinkCenter, getLinkPath, getLinkPoints } from "./core/layout.js";
+import { Context } from "./core/context.js";
+
+export { Context, Entity, Group, Link, LinkKind, QuadTree, Rect, Socket, SocketKind, Vec2, getLinkCenter, getLinkPath, getLinkPoints };

package/dist/core/context.d.ts

@@ -0,0 +1,141 @@
+import { Entity, Group, Link, LinkKind, Socket, SocketKind, Vec2 } from "./elements.js";
+import { QuadTree } from "./layout.js";
+import { HistoryAction, HistoryManager } from "./history.js";
+
+//#region src/core/context.d.ts
+type EntityCallback<T> = (entity: Entity<T>) => void;
+type LinkCallback = (link: Link) => void;
+type SocketCallback = (socket: Socket) => void;
+type EntityMoveCallback<T> = (entity: Entity<T>, pos: Vec2) => void;
+type GroupCallback = (group: Group) => void;
+type SocketValueCallback = (socket: Socket, value: any) => void;
+type CallbackHandle = number;
+declare class Context<T = any> {
+  private eid;
+  private lid;
+  private sid;
+  private gid;
+  private freeEids;
+  private freeLids;
+  private freeSids;
+  private freeGids;
+  private callbackIds;
+  private freeCallbackIds;
+  private entityCreateCallbacks;
+  private entityDropCallbacks;
+  private entityMoveCallbacks;
+  private socketMoveCallbacks;
+  private socketValueCallbacks;
+  private linkCreateCallbacks;
+  private linkDropCallbacks;
+  private linkUpdateCallbacks;
+  private socketCreateCallbacks;
+  private socketDropCallbacks;
+  private groupCreateCallbacks;
+  private groupDropCallbacks;
+  private bulkChangeCallbacks;
+  entities: Map<number, Entity<T>>;
+  links: Map<number, Link>;
+  sockets: Map<number, Socket>;
+  groups: Map<number, Group>;
+  quadTree: QuadTree<number>;
+  history: HistoryManager;
+  private isApplyingHistory;
+  private currentBatch;
+  private currentUndoBatch;
+  private isBatchingQuadTree;
+  private getNextEid;
+  private getNextLid;
+  private getNextSid;
+  private getNextGid;
+  private getNextCallbackHandle;
+  private setupEntity;
+  notifyBulkChange(): void;
+  registerBulkChangeListener(cb: () => void): CallbackHandle;
+  setSocketValue(socketId: number, value: any): void;
+  registerSocketValueListener(cb: SocketValueCallback): CallbackHandle;
+  record(doActions: HistoryAction | HistoryAction[], undoActions: HistoryAction | HistoryAction[], label?: string): void;
+  batch(fn: () => void, label?: string): void;
+  undo(): void;
+  redo(): void;
+  private applyAction;
+  registerEntityCreateListener(cb: EntityCallback<T>): CallbackHandle;
+  registerEntityDropListener(cb: EntityCallback<T>): CallbackHandle;
+  registerEntityMoveListener(cb: EntityMoveCallback<T>): CallbackHandle;
+  registerSocketMoveListener(cb: SocketCallback): CallbackHandle;
+  notifySocketMove(socket: Socket): void;
+  registerLinkCreateListener(cb: LinkCallback): CallbackHandle;
+  registerLinkDropListener(cb: LinkCallback): CallbackHandle;
+  registerLinkUpdateListener(cb: LinkCallback): CallbackHandle;
+  registerSocketCreateListener(cb: SocketCallback): CallbackHandle;
+  registerSocketDropListener(cb: SocketCallback): CallbackHandle;
+  registerGroupCreateListener(cb: GroupCallback): CallbackHandle;
+  registerGroupDropListener(cb: GroupCallback): CallbackHandle;
+  unregisterListener(handle: CallbackHandle): boolean;
+  newGroup(name?: string): Group;
+  dropGroup(group: Group): void;
+  getWorldPosition(entityId: number): Vec2;
+  getGroupWorldPosition(groupId: number): Vec2;
+  moveGroup(group: Group, dx: number, dy: number): void;
+  addToGroup(groupId: number, entityId: number): void;
+  removeFromGroup(groupId: number, entityId: number): void;
+  addGroupToGroup(parentGroupId: number, childGroupId: number): void;
+  removeGroupFromGroup(parentGroupId: number, childGroupId: number): void;
+  updateQuadTree(): void;
+  newEntity(inner: T, forcedId?: number): Entity<T>;
+  dropEntity(entity: Entity<T>): void;
+  newSocket(entity: Entity<T>, kind: SocketKind, name?: string, forcedId?: number): Socket;
+  dropSocket(socket: Socket): void;
+  newLink(from: Socket, to: Socket, kind?: LinkKind, forcedId?: number, inner?: any): Link<any> | null;
+  updateLink(link: Link, fromId?: number, toId?: number): void;
+  setLinkWaypoints(link: Link, waypoints: Vec2[]): void;
+  canLink(from: Socket, to: Socket): boolean;
+  detectCycle(from: Socket, to: Socket): boolean;
+  dropLink(link: Link): void;
+  toJSON(): {
+    entities: {
+      id: number;
+      position: {
+        x: number;
+        y: number;
+      };
+      inner: T;
+      parentId: number | null;
+      sockets: {
+        id: number;
+        kind: SocketKind;
+        name: string;
+        offset: {
+          x: number;
+          y: number;
+        };
+      }[];
+    }[];
+    links: {
+      id: number;
+      from: number;
+      to: number;
+      kind: LinkKind;
+      waypoints: {
+        x: number;
+        y: number;
+      }[];
+      inner: any;
+    }[];
+    groups: {
+      id: number;
+      name: string;
+      entities: number[];
+      groups: number[];
+      position: {
+        x: number;
+        y: number;
+      };
+      parentId: number | null;
+    }[];
+  };
+  fromJSON(data: any): void;
+}
+//#endregion
+export { CallbackHandle, Context, EntityCallback, EntityMoveCallback, GroupCallback, LinkCallback, SocketCallback, SocketValueCallback };
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/core/context.ts"],"mappings":"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"}