@buoy-gg/floating-tools-core 2.1.11 → 2.1.13

package/lib/module/devToolsState.js

@@ -1,318 +1 @@
-"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: 'dial',
-  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();
+"use strict";const initialState={isDialOpen:!1,isSettingsOpen:!1,activeSettingsTab:"dial",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;