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

package/dist/core/Vertex.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Vertex - Event-driven state container (Bloc pattern)
+ *
+ * Simplified version that includes its own event handling,
+ * since events are only needed for the Vertex pattern.
+ */
+import { StateContainer } from './StateContainer';
+import { BaseEvent } from '../types/events';
+/**
+ * Event handler signature (synchronous only)
+ */
+export type EventHandler<E extends BaseEvent, S> = (event: E, emit: (state: S) => void) => void;
+/**
+ * Type-safe event constructor
+ */
+export type EventConstructor<T extends BaseEvent = BaseEvent> = new (...args: never[]) => T;
+/**
+ * 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.
+ */
+export declare abstract class Vertex<S, E extends BaseEvent = BaseEvent> extends StateContainer<S> {
+    private eventHandlers;
+    private isProcessing;
+    private eventQueue;
+    /**
+     * Create a new Vertex
+     * @param initialState Initial state value
+     */
+    constructor(initialState: S);
+    /**
+     * Register an event handler
+     * Arrow function to maintain correct 'this' binding
+     */
+    protected on: <T extends E>(EventClass: EventConstructor<T>, handler: EventHandler<T, S>) => 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
+ */
+export declare class IncrementEvent implements BaseEvent {
+    readonly amount: number;
+    readonly type = "increment";
+    readonly timestamp: number;
+    constructor(amount?: number);
+}
+export declare class DecrementEvent implements BaseEvent {
+    readonly amount: number;
+    readonly type = "decrement";
+    readonly timestamp: number;
+    constructor(amount?: number);
+}
+export declare class ResetEvent implements BaseEvent {
+    readonly type = "reset";
+    readonly timestamp: number;
+}
+/**
+ * Example: Counter Vertex
+ * Demonstrates proper typing and event handling
+ */
+export 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
+ */
+export interface AuthState {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user: {
+        id: string;
+        name: string;
+        email: string;
+    } | null;
+    error: string | null;
+}
+export declare class LoginEvent implements BaseEvent {
+    readonly email: string;
+    readonly password: string;
+    readonly type = "login";
+    readonly timestamp: number;
+    constructor(email: string, password: string);
+}
+export declare class LogoutEvent implements BaseEvent {
+    readonly type = "logout";
+    readonly timestamp: number;
+}
+export declare class AuthVertex extends Vertex<AuthState> {
+    constructor();
+    login: (email: string, password: string) => void;
+    logout: () => void;
+}
+//# sourceMappingURL=Vertex.d.ts.map