@pulse-js/tools 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -1,41 +1,103 @@
+/**
+ * Pulse Agent
+ *
+ * Responsible for observing the Pulse Registry and communicating with the UI.
+ * It serializes reactive state and handles remote actions.
+ */
+declare class PulseAgent {
+    private static instance;
+    private listeners;
+    private registryUnsubscribe;
+    private unsubs;
+    private broadcastTimer;
+    private constructor();
+    static getInstance(): PulseAgent;
+    private setupRegistryObserver;
+    /**
+     * Synchronizes subscriptions with the registry.
+     */
+    private syncSubscriptions;
+    /**
+     * Debounced broadcast to avoid rapid-fire messages.
+     */
+    private broadcastStateDebounced;
+    /**
+     * Broadcasts the current state of all registered units.
+     */
+    broadcastState(): void;
+    /**
+     * Recursively strips non-cloneable values (functions) from an object.
+     */
+    private serialize;
+    /**
+     * Emits an event to any connected clients.
+     */
+    private emit;
+    /**
+     * Connect a local listener (useful for the same-page UI).
+     */
+    onEvent(listener: (event: any) => void): () => boolean;
+    /**
+     * Handles an action from the DevTools UI.
+     */
+    handleAction(action: {
+        type: string;
+        uid?: string;
+        payload?: any;
+    }): void;
+    dispose(): void;
+}
+
+/**
+ * Pulse Inspector Web Component (Client) 2.0
+ */
 declare class PulseInspector extends HTMLElement {
     private shadow;
     private units;
     private state;
     private isDragging;
     private offset;
-    private editingUnit;
-    private editValue;
-    private unsubscribeRegistry?;
-    private unitSubscriptions;
-    private shortcut;
+    private totalDragDistance;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     private loadState;
     private saveState;
-    private refreshUnits;
-    private updateUnitSubscriptions;
-    private setupListeners;
-    private handleKeyDown;
+    private setupAgentConnection;
+    private setupGlobalListeners;
     private handleResize;
-    private toggle;
-    private totalDragDistance;
     private handleMouseDown;
     private handleClick;
-    private handleEditSubmit;
-    private handleEditKeydown;
+    private sendAction;
     private render;
-    private renderInspector;
     private renderUnitCard;
-    private renderTree;
-    private renderTreeNode;
-    private renderReason;
-    private formatReasonText;
     private formatValue;
-    private safeStringify;
     private getStatusColor;
     private getStyles;
 }
 
-export { PulseInspector };
+interface Snapshot {
+    timestamp: number;
+    data: Record<string, any>;
+}
+/**
+ * Pulse TimeTravel
+ *
+ * Captures snapshots of the Pulse Registry and allows "rewinding" to previous states.
+ */
+declare class TimeTravel {
+    private snapshots;
+    private maxSnapshots;
+    /**
+     * Captures a point-in-time snapshot of all registered sources.
+     */
+    capture(): void;
+    /**
+     * Reverts the registry state to a specific snapshot index.
+     */
+    travel(index: number): void;
+    getHistory(): Snapshot[];
+    clear(): void;
+}
+
+export { PulseAgent, PulseInspector, TimeTravel };

package/dist/index.d.ts

@@ -1,41 +1,103 @@
+/**
+ * Pulse Agent
+ *
+ * Responsible for observing the Pulse Registry and communicating with the UI.
+ * It serializes reactive state and handles remote actions.
+ */
+declare class PulseAgent {
+    private static instance;
+    private listeners;
+    private registryUnsubscribe;
+    private unsubs;
+    private broadcastTimer;
+    private constructor();
+    static getInstance(): PulseAgent;
+    private setupRegistryObserver;
+    /**
+     * Synchronizes subscriptions with the registry.
+     */
+    private syncSubscriptions;
+    /**
+     * Debounced broadcast to avoid rapid-fire messages.
+     */
+    private broadcastStateDebounced;
+    /**
+     * Broadcasts the current state of all registered units.
+     */
+    broadcastState(): void;
+    /**
+     * Recursively strips non-cloneable values (functions) from an object.
+     */
+    private serialize;
+    /**
+     * Emits an event to any connected clients.
+     */
+    private emit;
+    /**
+     * Connect a local listener (useful for the same-page UI).
+     */
+    onEvent(listener: (event: any) => void): () => boolean;
+    /**
+     * Handles an action from the DevTools UI.
+     */
+    handleAction(action: {
+        type: string;
+        uid?: string;
+        payload?: any;
+    }): void;
+    dispose(): void;
+}
+
+/**
+ * Pulse Inspector Web Component (Client) 2.0
+ */
 declare class PulseInspector extends HTMLElement {
     private shadow;
     private units;
     private state;
     private isDragging;
     private offset;
-    private editingUnit;
-    private editValue;
-    private unsubscribeRegistry?;
-    private unitSubscriptions;
-    private shortcut;
+    private totalDragDistance;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     private loadState;
     private saveState;
-    private refreshUnits;
-    private updateUnitSubscriptions;
-    private setupListeners;
-    private handleKeyDown;
+    private setupAgentConnection;
+    private setupGlobalListeners;
     private handleResize;
-    private toggle;
-    private totalDragDistance;
     private handleMouseDown;
     private handleClick;
-    private handleEditSubmit;
-    private handleEditKeydown;
+    private sendAction;
     private render;
-    private renderInspector;
     private renderUnitCard;
-    private renderTree;
-    private renderTreeNode;
-    private renderReason;
-    private formatReasonText;
     private formatValue;
-    private safeStringify;
     private getStatusColor;
     private getStyles;
 }
 
-export { PulseInspector };
+interface Snapshot {
+    timestamp: number;
+    data: Record<string, any>;
+}
+/**
+ * Pulse TimeTravel
+ *
+ * Captures snapshots of the Pulse Registry and allows "rewinding" to previous states.
+ */
+declare class TimeTravel {
+    private snapshots;
+    private maxSnapshots;
+    /**
+     * Captures a point-in-time snapshot of all registered sources.
+     */
+    capture(): void;
+    /**
+     * Reverts the registry state to a specific snapshot index.
+     */
+    travel(index: number): void;
+    getHistory(): Snapshot[];
+    clear(): void;
+}
+
+export { PulseAgent, PulseInspector, TimeTravel };