@buoy-gg/floating-tools-core 7.0.38 → 7.0.39

package/lib/module/devToolsState.js

@@ -1 +1,318 @@
-"use strict";const initialState={isDialOpen:!1,isSettingsOpen:!1,activeSettingsTab:"floating",isInitialized:!1};export function devToolsReducer(t,e){switch(e.type){case"OPEN_DIAL":return{...t,isDialOpen:!0};case"CLOSE_DIAL":return{...t,isDialOpen:!1};case"TOGGLE_DIAL":return{...t,isDialOpen:!t.isDialOpen};case"OPEN_SETTINGS":return{...t,isSettingsOpen:!0,isDialOpen:!1};case"CLOSE_SETTINGS":return{...t,isSettingsOpen:!1};case"SET_SETTINGS_TAB":return{...t,activeSettingsTab:e.tab};case"INITIALIZE":return{...t,isInitialized:!0};default:return t}}export class DevToolsStateManager{listeners=new Set;constructor(t){this.state={...initialState,...t}}getState=()=>this.state;getServerState=()=>initialState;isDialOpen(){return this.state.isDialOpen}isSettingsOpen(){return this.state.isSettingsOpen}isInitialized(){return this.state.isInitialized}getActiveSettingsTab(){return this.state.activeSettingsTab}dispatch(t){const e=devToolsReducer(this.state,t);e!==this.state&&(this.state=e,this.notifyListeners())}openDial(){this.dispatch({type:"OPEN_DIAL"})}closeDial(){this.dispatch({type:"CLOSE_DIAL"})}toggleDial(){this.dispatch({type:"TOGGLE_DIAL"})}openSettings(){this.dispatch({type:"OPEN_SETTINGS"})}closeSettings(){this.dispatch({type:"CLOSE_SETTINGS"})}setSettingsTab(t){this.dispatch({type:"SET_SETTINGS_TAB",tab:t})}initialize(){this.dispatch({type:"INITIALIZE"})}subscribe=t=>(this.listeners.add(t),()=>{this.listeners.delete(t)});notifyListeners(){this.listeners.forEach(t=>{try{t()}catch(t){console.error("Error in DevToolsStateManager listener:",t)}})}get listenerCount(){return this.listeners.size}reset(){this.state={...initialState},this.notifyListeners()}}export const devToolsStateManager=new DevToolsStateManager;
+"use strict";
+
+/**
+ * DevToolsState - Pure state management for floating dev tools.
+ *
+ * Platform-agnostic state machine for managing:
+ * - Dial menu open/closed state
+ * - Settings modal open/closed state
+ * - Active settings tab
+ *
+ * This is a headless state manager with no React or platform dependencies.
+ * Use with useSyncExternalStore or similar subscription patterns.
+ */
+
+// =============================
+// State Types
+// =============================
+
+/**
+ * Complete state of the floating dev tools system.
+ */
+
+/**
+ * Actions that can be dispatched to modify state.
+ */
+
+// =============================
+// Initial State
+// =============================
+
+const initialState = {
+  isDialOpen: false,
+  isSettingsOpen: false,
+  activeSettingsTab: 'floating',
+  isInitialized: false
+};
+
+// =============================
+// Reducer
+// =============================
+
+/**
+ * Pure reducer function for DevTools state.
+ * Can be used standalone or with any state management library.
+ */
+export function devToolsReducer(state, action) {
+  switch (action.type) {
+    case 'OPEN_DIAL':
+      return {
+        ...state,
+        isDialOpen: true
+      };
+    case 'CLOSE_DIAL':
+      return {
+        ...state,
+        isDialOpen: false
+      };
+    case 'TOGGLE_DIAL':
+      return {
+        ...state,
+        isDialOpen: !state.isDialOpen
+      };
+    case 'OPEN_SETTINGS':
+      // Close dial when opening settings
+      return {
+        ...state,
+        isSettingsOpen: true,
+        isDialOpen: false
+      };
+    case 'CLOSE_SETTINGS':
+      return {
+        ...state,
+        isSettingsOpen: false
+      };
+    case 'SET_SETTINGS_TAB':
+      return {
+        ...state,
+        activeSettingsTab: action.tab
+      };
+    case 'INITIALIZE':
+      return {
+        ...state,
+        isInitialized: true
+      };
+    default:
+      return state;
+  }
+}
+
+// =============================
+// State Manager Class
+// =============================
+
+/**
+ * DevToolsStateManager - Subscribable state container.
+ *
+ * Follows the external store pattern for compatibility with
+ * React's useSyncExternalStore and similar patterns.
+ *
+ * @example
+ * ```ts
+ * const manager = new DevToolsStateManager();
+ *
+ * // Subscribe to changes
+ * const unsubscribe = manager.subscribe(() => {
+ *   console.log('State changed:', manager.getState());
+ * });
+ *
+ * // Dispatch actions
+ * manager.openDial();
+ * manager.openSettings();
+ *
+ * // Clean up
+ * unsubscribe();
+ * ```
+ */
+export class DevToolsStateManager {
+  listeners = new Set();
+  constructor(initialStateOverride) {
+    this.state = {
+      ...initialState,
+      ...initialStateOverride
+    };
+  }
+
+  // =============================
+  // Query Methods
+  // =============================
+
+  /**
+   * Get the current state snapshot.
+   * Safe to call at any time.
+   */
+  getState = () => {
+    return this.state;
+  };
+
+  /**
+   * Get server snapshot for SSR.
+   * Returns initial state for hydration consistency.
+   */
+  getServerState = () => {
+    return initialState;
+  };
+
+  /**
+   * Check if dial menu is open.
+   */
+  isDialOpen() {
+    return this.state.isDialOpen;
+  }
+
+  /**
+   * Check if settings modal is open.
+   */
+  isSettingsOpen() {
+    return this.state.isSettingsOpen;
+  }
+
+  /**
+   * Check if state has been initialized.
+   */
+  isInitialized() {
+    return this.state.isInitialized;
+  }
+
+  /**
+   * Get active settings tab.
+   */
+  getActiveSettingsTab() {
+    return this.state.activeSettingsTab;
+  }
+
+  // =============================
+  // Command Methods
+  // =============================
+
+  /**
+   * Dispatch an action to update state.
+   */
+  dispatch(action) {
+    const newState = devToolsReducer(this.state, action);
+
+    // Only notify if state actually changed
+    if (newState !== this.state) {
+      this.state = newState;
+      this.notifyListeners();
+    }
+  }
+
+  /**
+   * Open the dial menu.
+   */
+  openDial() {
+    this.dispatch({
+      type: 'OPEN_DIAL'
+    });
+  }
+
+  /**
+   * Close the dial menu.
+   */
+  closeDial() {
+    this.dispatch({
+      type: 'CLOSE_DIAL'
+    });
+  }
+
+  /**
+   * Toggle the dial menu open/closed.
+   */
+  toggleDial() {
+    this.dispatch({
+      type: 'TOGGLE_DIAL'
+    });
+  }
+
+  /**
+   * Open the settings modal.
+   * Also closes the dial menu if open.
+   */
+  openSettings() {
+    this.dispatch({
+      type: 'OPEN_SETTINGS'
+    });
+  }
+
+  /**
+   * Close the settings modal.
+   */
+  closeSettings() {
+    this.dispatch({
+      type: 'CLOSE_SETTINGS'
+    });
+  }
+
+  /**
+   * Set the active settings tab.
+   */
+  setSettingsTab(tab) {
+    this.dispatch({
+      type: 'SET_SETTINGS_TAB',
+      tab
+    });
+  }
+
+  /**
+   * Mark state as initialized.
+   * Call after loading persisted state.
+   */
+  initialize() {
+    this.dispatch({
+      type: 'INITIALIZE'
+    });
+  }
+
+  // =============================
+  // Subscription
+  // =============================
+
+  /**
+   * Subscribe to state changes.
+   * Returns an unsubscribe function.
+   *
+   * Compatible with React's useSyncExternalStore.
+   */
+  subscribe = listener => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+
+  /**
+   * Notify all listeners of state change.
+   */
+  notifyListeners() {
+    this.listeners.forEach(listener => {
+      try {
+        listener();
+      } catch (error) {
+        console.error('Error in DevToolsStateManager listener:', error);
+      }
+    });
+  }
+
+  /**
+   * Get the number of active listeners.
+   * Useful for debugging.
+   */
+  get listenerCount() {
+    return this.listeners.size;
+  }
+
+  /**
+   * Reset state to initial values.
+   * Useful for testing.
+   */
+  reset() {
+    this.state = {
+      ...initialState
+    };
+    this.notifyListeners();
+  }
+}
+
+// =============================
+// Default Instance
+// =============================
+
+/**
+ * Default global DevToolsStateManager instance.
+ * Use this for app-wide state management.
+ *
+ * For isolated testing or multiple instances,
+ * create a new DevToolsStateManager instead.
+ */
+export const devToolsStateManager = new DevToolsStateManager();