@blac/core 2.0.0-rc.4 → 2.0.0-rc.6

package/dist/index.d.cts

@@ -1,11 +1,141 @@
-//#region src/core/StateContainerRegistry.d.ts
+//#region src/types/events.d.ts
+/**
+ * Base event interface for type-safe event system
+ */
+/**
+ * Base event interface
+ * Used by Vertex for event-driven state management
+ */
+interface BaseEvent {
+  readonly type: string;
+  readonly timestamp: number;
+  readonly source?: string;
+}
+//#endregion
+//#region src/core/Vertex.d.ts
 
+/**
+ * Event handler signature (synchronous only)
+ */
+type EventHandler<E$1 extends BaseEvent, S$1> = (event: E$1, emit: (state: S$1) => void) => void;
+/**
+ * Type-safe event constructor
+ */
+type EventConstructor<T$1 extends BaseEvent = BaseEvent> = new (...args: never[]) => T$1;
+/**
+ * Vertex is an event-driven state container (Bloc pattern)
+ *
+ * Includes its own simple event system since events are only needed
+ * for the Vertex pattern, not for the base StateContainer.
+ */
+declare abstract class Vertex<S$1, E$1 extends BaseEvent = BaseEvent> extends StateContainer<S$1> {
+  private eventHandlers;
+  private isProcessing;
+  private eventQueue;
+  /**
+   * Create a new Vertex
+   * @param initialState Initial state value
+   * @param config Configuration options
+   */
+  constructor(initialState: S$1, config?: StateContainerConfig);
+  /**
+   * Register an event handler
+   * Arrow function to maintain correct 'this' binding
+   */
+  protected on: <T extends E$1>(EventClass: EventConstructor<T>, handler: EventHandler<T, S$1>) => void;
+  /**
+   * Add an event to be processed
+   * Arrow function to maintain correct 'this' binding in React
+   */
+  add: (event: E$1) => void;
+  /**
+   * Process an event (synchronously)
+   */
+  private processEvent;
+  /**
+   * Handle a single event (synchronously)
+   */
+  private handleEvent;
+  /**
+   * Hook for handling event processing errors
+   */
+  protected onEventError(event: E$1, error: Error): void;
+}
+/**
+ * Example: Counter Events
+ */
+declare class IncrementEvent implements BaseEvent {
+  readonly amount: number;
+  readonly type = "increment";
+  readonly timestamp: number;
+  constructor(amount?: number);
+}
+declare class DecrementEvent implements BaseEvent {
+  readonly amount: number;
+  readonly type = "decrement";
+  readonly timestamp: number;
+  constructor(amount?: number);
+}
+declare class ResetEvent implements BaseEvent {
+  readonly type = "reset";
+  readonly timestamp: number;
+}
+/**
+ * Example: Counter Vertex
+ * Demonstrates proper typing and event handling
+ */
+declare class CounterVertex extends Vertex<number> {
+  constructor();
+  increment: (amount?: number) => void;
+  decrement: (amount?: number) => void;
+  reset: () => void;
+}
+/**
+ * Auth State and Events for testing async handlers
+ */
+interface AuthState {
+  isAuthenticated: boolean;
+  isLoading: boolean;
+  user: {
+    id: string;
+    name: string;
+    email: string;
+  } | null;
+  error: string | null;
+}
+declare class LoginEvent implements BaseEvent {
+  readonly email: string;
+  readonly password: string;
+  readonly type = "login";
+  readonly timestamp: number;
+  constructor(email: string, password: string);
+}
+declare class LogoutEvent implements BaseEvent {
+  readonly type = "logout";
+  readonly timestamp: number;
+}
+declare class AuthVertex extends Vertex<AuthState> {
+  constructor();
+  login: (email: string, password: string) => void;
+  logout: () => void;
+}
+//#endregion
+//#region src/core/StateContainerRegistry.d.ts
+/**
+ * Lifecycle events that can be observed
+ */
+type LifecycleEvent = 'created' | 'stateChanged' | 'eventAdded' | 'disposed';
+/**
+ * Listener function types for each lifecycle event
+ */
+type LifecycleListener<E$1 extends LifecycleEvent> = E$1 extends 'created' ? (container: StateContainer<any>) => void : E$1 extends 'stateChanged' ? (container: StateContainer<any>, previousState: any, currentState: any) => void : E$1 extends 'eventAdded' ? (container: Vertex<any, any>, event: any) => void : E$1 extends 'disposed' ? (container: StateContainer<any>) => void : never;
 /**
  * Registry for managing StateContainer instances
  */
 declare class StateContainerRegistry {
   private readonly instances;
   private readonly types;
+  private readonly listeners;
   /**
    * Register a type with isolation mode
    */
@@ -49,6 +179,18 @@ declare class StateContainerRegistry {
    * Check if an instance exists
    */
   hasInstance<T extends StateContainer<any>>(constructor: new (...args: any[]) => T, key?: string): boolean;
+  /**
+   * Subscribe to lifecycle events
+   * @param event - The lifecycle event to listen for
+   * @param listener - The listener function to call when the event occurs
+   * @returns Unsubscribe function
+   */
+  on<E extends LifecycleEvent>(event: E, listener: LifecycleListener<E>): () => void;
+  /**
+   * Emit lifecycle event to all listeners
+   * @internal - Called by StateContainer/Vertex lifecycle methods
+   */
+  emit(event: LifecycleEvent, ...args: any[]): void;
 }
 /**
  * Global default registry instance
@@ -75,7 +217,7 @@ type StateListener<S$1> = (state: S$1) => void;
  * Base abstract class for all state containers
  */
 declare abstract class StateContainer<S$1> {
-  private static _registry;
+  protected static _registry: StateContainerRegistry;
   /**
    * Set a custom registry (mainly for testing)
    */
@@ -249,127 +391,6 @@ declare class TodoCubit extends Cubit<TodoState> {
   get activeTodoCount(): number;
 }
 //#endregion
-//#region src/types/events.d.ts
-/**
- * Base event interface for type-safe event system
- */
-/**
- * Base event interface
- * Used by Vertex for event-driven state management
- */
-interface BaseEvent {
-  readonly type: string;
-  readonly timestamp: number;
-  readonly source?: string;
-}
-//#endregion
-//#region src/core/Vertex.d.ts
-/**
- * Event handler signature (synchronous only)
- */
-type EventHandler<E extends BaseEvent, S$1> = (event: E, emit: (state: S$1) => void) => void;
-/**
- * Type-safe event constructor
- */
-type EventConstructor<T$1 extends BaseEvent = BaseEvent> = new (...args: never[]) => T$1;
-/**
- * Vertex is an event-driven state container (Bloc pattern)
- *
- * Includes its own simple event system since events are only needed
- * for the Vertex pattern, not for the base StateContainer.
- */
-declare abstract class Vertex<S$1, E extends BaseEvent = BaseEvent> extends StateContainer<S$1> {
-  private eventHandlers;
-  private isProcessing;
-  private eventQueue;
-  /**
-   * Create a new Vertex
-   * @param initialState Initial state value
-   * @param config Configuration options
-   */
-  constructor(initialState: S$1, config?: StateContainerConfig);
-  /**
-   * Register an event handler
-   * Arrow function to maintain correct 'this' binding
-   */
-  protected on: <T extends E>(EventClass: EventConstructor<T>, handler: EventHandler<T, S$1>) => void;
-  /**
-   * Add an event to be processed
-   * Arrow function to maintain correct 'this' binding in React
-   */
-  add: (event: E) => void;
-  /**
-   * Process an event (synchronously)
-   */
-  private processEvent;
-  /**
-   * Handle a single event (synchronously)
-   */
-  private handleEvent;
-  /**
-   * Hook for handling event processing errors
-   */
-  protected onEventError(event: E, error: Error): void;
-}
-/**
- * Example: Counter Events
- */
-declare class IncrementEvent implements BaseEvent {
-  readonly amount: number;
-  readonly type = "increment";
-  readonly timestamp: number;
-  constructor(amount?: number);
-}
-declare class DecrementEvent implements BaseEvent {
-  readonly amount: number;
-  readonly type = "decrement";
-  readonly timestamp: number;
-  constructor(amount?: number);
-}
-declare class ResetEvent implements BaseEvent {
-  readonly type = "reset";
-  readonly timestamp: number;
-}
-/**
- * Example: Counter Vertex
- * Demonstrates proper typing and event handling
- */
-declare class CounterVertex extends Vertex<number> {
-  constructor();
-  increment: (amount?: number) => void;
-  decrement: (amount?: number) => void;
-  reset: () => void;
-}
-/**
- * Auth State and Events for testing async handlers
- */
-interface AuthState {
-  isAuthenticated: boolean;
-  isLoading: boolean;
-  user: {
-    id: string;
-    name: string;
-    email: string;
-  } | null;
-  error: string | null;
-}
-declare class LoginEvent implements BaseEvent {
-  readonly email: string;
-  readonly password: string;
-  readonly type = "login";
-  readonly timestamp: number;
-  constructor(email: string, password: string);
-}
-declare class LogoutEvent implements BaseEvent {
-  readonly type = "logout";
-  readonly timestamp: number;
-}
-declare class AuthVertex extends Vertex<AuthState> {
-  constructor();
-  login: (email: string, password: string) => void;
-  logout: () => void;
-}
-//#endregion
 //#region src/types/branded.d.ts
 /**
  * Branded types for type-safe IDs
@@ -860,5 +881,5 @@ declare function generateSimpleId(prefix: string): string;
  */
 declare function __resetIdCounters(): void;
 //#endregion
-export { type AnyObject, AuthState, AuthVertex, BLAC_DEFAULTS, type BaseEvent, BlocConstructor, type Brand, type BrandedId, CounterCubit, CounterVertex, Cubit, DecrementEvent, EventConstructor, EventHandler, ExtractConstructorArgs, ExtractState, IncrementEvent, type InstanceId, type LogConfig, type LogEntry, LogLevel, LoginEvent, LogoutEvent, PathInfo, ProxyTracker, ProxyTrackerState, ResetEvent, StateContainer, StateContainerConfig, StateContainerRegistry, TodoCubit, TodoState, TrackerState, Vertex, __resetIdCounters, captureTrackedPaths, configureLogger, createArrayProxy, createIdGenerator, createLogger, createProxy, createProxyForTarget, createProxyInternal, createProxyTrackerState, createTrackerState, debug, error, generateId, generateSimpleId, getValueAtPath, globalProxyTracker, globalRegistry, hasChanges, hasTrackedData, info, isProxyable, parsePath, shallowEqual, startProxyTracking, startTracking, stopProxyTracking, trackAccess, warn };
+export { type AnyObject, AuthState, AuthVertex, BLAC_DEFAULTS, type BaseEvent, BlocConstructor, type Brand, type BrandedId, CounterCubit, CounterVertex, Cubit, DecrementEvent, EventConstructor, EventHandler, ExtractConstructorArgs, ExtractState, IncrementEvent, type InstanceId, type LifecycleEvent, type LifecycleListener, type LogConfig, type LogEntry, LogLevel, LoginEvent, LogoutEvent, PathInfo, ProxyTracker, ProxyTrackerState, ResetEvent, StateContainer, StateContainerConfig, StateContainerRegistry, TodoCubit, TodoState, TrackerState, Vertex, __resetIdCounters, captureTrackedPaths, configureLogger, createArrayProxy, createIdGenerator, createLogger, createProxy, createProxyForTarget, createProxyInternal, createProxyTrackerState, createTrackerState, debug, error, generateId, generateSimpleId, getValueAtPath, globalProxyTracker, globalRegistry, hasChanges, hasTrackedData, info, isProxyable, parsePath, shallowEqual, startProxyTracking, startTracking, stopProxyTracking, trackAccess, warn };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,11 +1,141 @@
-//#region src/core/StateContainerRegistry.d.ts
+//#region src/types/events.d.ts
+/**
+ * Base event interface for type-safe event system
+ */
+/**
+ * Base event interface
+ * Used by Vertex for event-driven state management
+ */
+interface BaseEvent {
+  readonly type: string;
+  readonly timestamp: number;
+  readonly source?: string;
+}
+//#endregion
+//#region src/core/Vertex.d.ts
 
+/**
+ * Event handler signature (synchronous only)
+ */
+type EventHandler<E$1 extends BaseEvent, S$1> = (event: E$1, emit: (state: S$1) => void) => void;
+/**
+ * Type-safe event constructor
+ */
+type EventConstructor<T$1 extends BaseEvent = BaseEvent> = new (...args: never[]) => T$1;
+/**
+ * Vertex is an event-driven state container (Bloc pattern)
+ *
+ * Includes its own simple event system since events are only needed
+ * for the Vertex pattern, not for the base StateContainer.
+ */
+declare abstract class Vertex<S$1, E$1 extends BaseEvent = BaseEvent> extends StateContainer<S$1> {
+  private eventHandlers;
+  private isProcessing;
+  private eventQueue;
+  /**
+   * Create a new Vertex
+   * @param initialState Initial state value
+   * @param config Configuration options
+   */
+  constructor(initialState: S$1, config?: StateContainerConfig);
+  /**
+   * Register an event handler
+   * Arrow function to maintain correct 'this' binding
+   */
+  protected on: <T extends E$1>(EventClass: EventConstructor<T>, handler: EventHandler<T, S$1>) => void;
+  /**
+   * Add an event to be processed
+   * Arrow function to maintain correct 'this' binding in React
+   */
+  add: (event: E$1) => void;
+  /**
+   * Process an event (synchronously)
+   */
+  private processEvent;
+  /**
+   * Handle a single event (synchronously)
+   */
+  private handleEvent;
+  /**
+   * Hook for handling event processing errors
+   */
+  protected onEventError(event: E$1, error: Error): void;
+}
+/**
+ * Example: Counter Events
+ */
+declare class IncrementEvent implements BaseEvent {
+  readonly amount: number;
+  readonly type = "increment";
+  readonly timestamp: number;
+  constructor(amount?: number);
+}
+declare class DecrementEvent implements BaseEvent {
+  readonly amount: number;
+  readonly type = "decrement";
+  readonly timestamp: number;
+  constructor(amount?: number);
+}
+declare class ResetEvent implements BaseEvent {
+  readonly type = "reset";
+  readonly timestamp: number;
+}
+/**
+ * Example: Counter Vertex
+ * Demonstrates proper typing and event handling
+ */
+declare class CounterVertex extends Vertex<number> {
+  constructor();
+  increment: (amount?: number) => void;
+  decrement: (amount?: number) => void;
+  reset: () => void;
+}
+/**
+ * Auth State and Events for testing async handlers
+ */
+interface AuthState {
+  isAuthenticated: boolean;
+  isLoading: boolean;
+  user: {
+    id: string;
+    name: string;
+    email: string;
+  } | null;
+  error: string | null;
+}
+declare class LoginEvent implements BaseEvent {
+  readonly email: string;
+  readonly password: string;
+  readonly type = "login";
+  readonly timestamp: number;
+  constructor(email: string, password: string);
+}
+declare class LogoutEvent implements BaseEvent {
+  readonly type = "logout";
+  readonly timestamp: number;
+}
+declare class AuthVertex extends Vertex<AuthState> {
+  constructor();
+  login: (email: string, password: string) => void;
+  logout: () => void;
+}
+//#endregion
+//#region src/core/StateContainerRegistry.d.ts
+/**
+ * Lifecycle events that can be observed
+ */
+type LifecycleEvent = 'created' | 'stateChanged' | 'eventAdded' | 'disposed';
+/**
+ * Listener function types for each lifecycle event
+ */
+type LifecycleListener<E$1 extends LifecycleEvent> = E$1 extends 'created' ? (container: StateContainer<any>) => void : E$1 extends 'stateChanged' ? (container: StateContainer<any>, previousState: any, currentState: any) => void : E$1 extends 'eventAdded' ? (container: Vertex<any, any>, event: any) => void : E$1 extends 'disposed' ? (container: StateContainer<any>) => void : never;
 /**
  * Registry for managing StateContainer instances
  */
 declare class StateContainerRegistry {
   private readonly instances;
   private readonly types;
+  private readonly listeners;
   /**
    * Register a type with isolation mode
    */
@@ -49,6 +179,18 @@ declare class StateContainerRegistry {
    * Check if an instance exists
    */
   hasInstance<T extends StateContainer<any>>(constructor: new (...args: any[]) => T, key?: string): boolean;
+  /**
+   * Subscribe to lifecycle events
+   * @param event - The lifecycle event to listen for
+   * @param listener - The listener function to call when the event occurs
+   * @returns Unsubscribe function
+   */
+  on<E extends LifecycleEvent>(event: E, listener: LifecycleListener<E>): () => void;
+  /**
+   * Emit lifecycle event to all listeners
+   * @internal - Called by StateContainer/Vertex lifecycle methods
+   */
+  emit(event: LifecycleEvent, ...args: any[]): void;
 }
 /**
  * Global default registry instance
@@ -75,7 +217,7 @@ type StateListener<S$1> = (state: S$1) => void;
  * Base abstract class for all state containers
  */
 declare abstract class StateContainer<S$1> {
-  private static _registry;
+  protected static _registry: StateContainerRegistry;
   /**
    * Set a custom registry (mainly for testing)
    */
@@ -249,127 +391,6 @@ declare class TodoCubit extends Cubit<TodoState> {
   get activeTodoCount(): number;
 }
 //#endregion
-//#region src/types/events.d.ts
-/**
- * Base event interface for type-safe event system
- */
-/**
- * Base event interface
- * Used by Vertex for event-driven state management
- */
-interface BaseEvent {
-  readonly type: string;
-  readonly timestamp: number;
-  readonly source?: string;
-}
-//#endregion
-//#region src/core/Vertex.d.ts
-/**
- * Event handler signature (synchronous only)
- */
-type EventHandler<E extends BaseEvent, S$1> = (event: E, emit: (state: S$1) => void) => void;
-/**
- * Type-safe event constructor
- */
-type EventConstructor<T$1 extends BaseEvent = BaseEvent> = new (...args: never[]) => T$1;
-/**
- * Vertex is an event-driven state container (Bloc pattern)
- *
- * Includes its own simple event system since events are only needed
- * for the Vertex pattern, not for the base StateContainer.
- */
-declare abstract class Vertex<S$1, E extends BaseEvent = BaseEvent> extends StateContainer<S$1> {
-  private eventHandlers;
-  private isProcessing;
-  private eventQueue;
-  /**
-   * Create a new Vertex
-   * @param initialState Initial state value
-   * @param config Configuration options
-   */
-  constructor(initialState: S$1, config?: StateContainerConfig);
-  /**
-   * Register an event handler
-   * Arrow function to maintain correct 'this' binding
-   */
-  protected on: <T extends E>(EventClass: EventConstructor<T>, handler: EventHandler<T, S$1>) => void;
-  /**
-   * Add an event to be processed
-   * Arrow function to maintain correct 'this' binding in React
-   */
-  add: (event: E) => void;
-  /**
-   * Process an event (synchronously)
-   */
-  private processEvent;
-  /**
-   * Handle a single event (synchronously)
-   */
-  private handleEvent;
-  /**
-   * Hook for handling event processing errors
-   */
-  protected onEventError(event: E, error: Error): void;
-}
-/**
- * Example: Counter Events
- */
-declare class IncrementEvent implements BaseEvent {
-  readonly amount: number;
-  readonly type = "increment";
-  readonly timestamp: number;
-  constructor(amount?: number);
-}
-declare class DecrementEvent implements BaseEvent {
-  readonly amount: number;
-  readonly type = "decrement";
-  readonly timestamp: number;
-  constructor(amount?: number);
-}
-declare class ResetEvent implements BaseEvent {
-  readonly type = "reset";
-  readonly timestamp: number;
-}
-/**
- * Example: Counter Vertex
- * Demonstrates proper typing and event handling
- */
-declare class CounterVertex extends Vertex<number> {
-  constructor();
-  increment: (amount?: number) => void;
-  decrement: (amount?: number) => void;
-  reset: () => void;
-}
-/**
- * Auth State and Events for testing async handlers
- */
-interface AuthState {
-  isAuthenticated: boolean;
-  isLoading: boolean;
-  user: {
-    id: string;
-    name: string;
-    email: string;
-  } | null;
-  error: string | null;
-}
-declare class LoginEvent implements BaseEvent {
-  readonly email: string;
-  readonly password: string;
-  readonly type = "login";
-  readonly timestamp: number;
-  constructor(email: string, password: string);
-}
-declare class LogoutEvent implements BaseEvent {
-  readonly type = "logout";
-  readonly timestamp: number;
-}
-declare class AuthVertex extends Vertex<AuthState> {
-  constructor();
-  login: (email: string, password: string) => void;
-  logout: () => void;
-}
-//#endregion
 //#region src/types/branded.d.ts
 /**
  * Branded types for type-safe IDs
@@ -860,5 +881,5 @@ declare function generateSimpleId(prefix: string): string;
  */
 declare function __resetIdCounters(): void;
 //#endregion
-export { type AnyObject, AuthState, AuthVertex, BLAC_DEFAULTS, type BaseEvent, BlocConstructor, type Brand, type BrandedId, CounterCubit, CounterVertex, Cubit, DecrementEvent, EventConstructor, EventHandler, ExtractConstructorArgs, ExtractState, IncrementEvent, type InstanceId, type LogConfig, type LogEntry, LogLevel, LoginEvent, LogoutEvent, PathInfo, ProxyTracker, ProxyTrackerState, ResetEvent, StateContainer, StateContainerConfig, StateContainerRegistry, TodoCubit, TodoState, TrackerState, Vertex, __resetIdCounters, captureTrackedPaths, configureLogger, createArrayProxy, createIdGenerator, createLogger, createProxy, createProxyForTarget, createProxyInternal, createProxyTrackerState, createTrackerState, debug, error, generateId, generateSimpleId, getValueAtPath, globalProxyTracker, globalRegistry, hasChanges, hasTrackedData, info, isProxyable, parsePath, shallowEqual, startProxyTracking, startTracking, stopProxyTracking, trackAccess, warn };
+export { type AnyObject, AuthState, AuthVertex, BLAC_DEFAULTS, type BaseEvent, BlocConstructor, type Brand, type BrandedId, CounterCubit, CounterVertex, Cubit, DecrementEvent, EventConstructor, EventHandler, ExtractConstructorArgs, ExtractState, IncrementEvent, type InstanceId, type LifecycleEvent, type LifecycleListener, type LogConfig, type LogEntry, LogLevel, LoginEvent, LogoutEvent, PathInfo, ProxyTracker, ProxyTrackerState, ResetEvent, StateContainer, StateContainerConfig, StateContainerRegistry, TodoCubit, TodoState, TrackerState, Vertex, __resetIdCounters, captureTrackedPaths, configureLogger, createArrayProxy, createIdGenerator, createLogger, createProxy, createProxyForTarget, createProxyInternal, createProxyTrackerState, createTrackerState, debug, error, generateId, generateSimpleId, getValueAtPath, globalProxyTracker, globalRegistry, hasChanges, hasTrackedData, info, isProxyable, parsePath, shallowEqual, startProxyTracking, startTracking, stopProxyTracking, trackAccess, warn };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -81,6 +81,7 @@ function __resetIdCounters() {
 var StateContainerRegistry = class {
 	instances = /* @__PURE__ */ new Map();
 	types = /* @__PURE__ */ new Map();
+	listeners = /* @__PURE__ */ new Map();
 	/**
 	* Register a type with isolation mode
 	*/
@@ -195,6 +196,32 @@ var StateContainerRegistry = class {
 		const instanceKey = `${constructor.name}:${key || "default"}`;
 		return this.instances.has(instanceKey);
 	}
+	/**
+	* Subscribe to lifecycle events
+	* @param event - The lifecycle event to listen for
+	* @param listener - The listener function to call when the event occurs
+	* @returns Unsubscribe function
+	*/
+	on(event, listener) {
+		if (!this.listeners.has(event)) this.listeners.set(event, /* @__PURE__ */ new Set());
+		this.listeners.get(event).add(listener);
+		return () => {
+			this.listeners.get(event)?.delete(listener);
+		};
+	}
+	/**
+	* Emit lifecycle event to all listeners
+	* @internal - Called by StateContainer/Vertex lifecycle methods
+	*/
+	emit(event, ...args) {
+		const listeners = this.listeners.get(event);
+		if (!listeners || listeners.size === 0) return;
+		for (const listener of listeners) try {
+			listener(...args);
+		} catch (error$1) {
+			console.error(`[BlaC] Listener error for '${event}':`, error$1);
+		}
+	}
 };
 /**
 * Global default registry instance
@@ -290,6 +317,7 @@ var StateContainer = class StateContainer {
 		this.name = config.name || this.constructor.name;
 		this.debug = config.debug ?? false;
 		this.instanceId = config.instanceId || generateSimpleId(this.constructor.name);
+		StateContainer._registry.emit("created", this);
 	}
 	/**
 	* Get the current state
@@ -321,6 +349,7 @@ var StateContainer = class StateContainer {
 		this._disposed = true;
 		this.onDispose?.();
 		this.listeners.clear();
+		StateContainer._registry.emit("disposed", this);
 		if (this.debug) console.log(`[${this.name}] Disposed successfully`);
 	}
 	/**
@@ -337,6 +366,7 @@ var StateContainer = class StateContainer {
 		} catch (error$1) {
 			console.error(`[${this.name}] Error in listener:`, error$1);
 		}
+		StateContainer._registry.emit("stateChanged", this, previousState, newState);
 	}
 	/**
 	* Update state using a function
@@ -511,6 +541,7 @@ var Vertex = class extends StateContainer {
 	* Arrow function to maintain correct 'this' binding in React
 	*/
 	add = (event) => {
+		StateContainer._registry.emit("eventAdded", this, event);
 		this.processEvent(event);
 	};
 	/**