@blac/react 2.0.0-rc-6 → 2.0.0-rc-8

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/useExternalBlocStore.ts","../src/useBloc.tsx"],"sourcesContent":["import { Blac, BlacObserver, BlocBase, BlocBaseAbstract, BlocConstructor, BlocHookDependencyArrayFn, BlocState, generateUUID } from '@blac/core';\nimport { useCallback, useMemo, useRef } from 'react';\nimport { BlocHookOptions } from './useBloc';\n\nexport interface ExternalStore<\n  B extends BlocConstructor<BlocBase<any>>\n> {\n  /**\n   * Subscribes to changes in the store and returns an unsubscribe function.\n   * @param onStoreChange - Callback function that will be called whenever the store changes\n   * @returns A function that can be called to unsubscribe from store changes\n   */\n  subscribe: (onStoreChange: (state: BlocState<InstanceType<B>>) => void) => () => void;\n\n  /**\n   * Gets the current snapshot of the store state.\n   * @returns The current state of the store\n   */\n  getSnapshot: () => BlocState<InstanceType<B>> | undefined;\n\n  /**\n   * Gets the server snapshot of the store state.\n   * This is optional and defaults to the same value as getSnapshot.\n   * @returns The server state of the store\n   */\n  getServerSnapshot?: () => BlocState<InstanceType<B>> | undefined;\n}\n\nexport interface ExternalBlacStore<\n  B extends BlocConstructor<BlocBase<any>>\n> {\n  usedKeys: React.RefObject<Set<string>>;\n  usedClassPropKeys: React.RefObject<Set<string>>;\n  externalStore: ExternalStore<B>;\n  instance: React.RefObject<InstanceType<B>>;\n  rid: string;\n}\n\n/**\n * Creates an external store that wraps a Bloc instance, providing a React-compatible interface\n * for subscribing to and accessing bloc state.\n */\nconst useExternalBlocStore = <\n  B extends BlocConstructor<BlocBase<any>>\n>(\n  bloc: B,\n  options: BlocHookOptions<InstanceType<B>> | undefined,\n): ExternalBlacStore<B> => {\n  const { id: blocId, props, selector } = options ?? {};\n\n  const rid = useMemo(() => {\n    return generateUUID();\n  }, []);\n\n  const base = bloc as unknown as BlocBaseAbstract;\n\n  const isIsolated = base.isolated;\n  const effectiveBlocId = isIsolated ? rid : blocId;\n\n  const usedKeys = useRef<Set<string>>(new Set());\n  const usedClassPropKeys = useRef<Set<string>>(new Set());\n\n  const getBloc = useCallback(() => {\n    return Blac.getBloc(bloc, {\n      id: effectiveBlocId,\n      props,\n      instanceRef: rid\n    });\n  }, [bloc, effectiveBlocId, props, rid]);\n\n  const blocInstance = useRef<InstanceType<B>>(getBloc());\n\n  // Update the instance when dependencies change\n  useMemo(() => {\n    blocInstance.current = getBloc();\n  }, [getBloc]);\n\n  const dependencyArray: BlocHookDependencyArrayFn<BlocState<InstanceType<B>>> =\n    useMemo(\n      () =>\n        (newState): ReturnType<BlocHookDependencyArrayFn<BlocState<InstanceType<B>>>> => {\n          const instance = blocInstance.current;\n\n          if (!instance) {\n            return [];\n          }\n\n          // Use custom dependency selector if provided\n          if (selector) {\n            return selector(newState);\n          }\n\n          // Fall back to bloc's default dependency selector if available\n          if (instance.defaultDependencySelector) {\n            return instance.defaultDependencySelector(newState);\n          }\n\n          // For primitive states, use default selector\n          if (typeof newState !== 'object') {\n            // Default behavior for primitive states: re-render if the state itself changes.\n            return [[newState]];\n          }\n\n          // For object states, track which properties were actually used\n          const usedStateValues: unknown[] = [];\n          for (const key of usedKeys.current) {\n            if (key in newState) {\n              usedStateValues.push(newState[key as keyof typeof newState]);\n            }\n          }\n\n          // Track used class properties for dependency tracking, this enables rerenders when class getters change\n          const usedClassValues: unknown[] = [];\n          for (const key of usedClassPropKeys.current) {\n            if (key in instance) {\n              try {\n                const value = instance[key as keyof InstanceType<B>];\n                switch (typeof value) {\n                  case 'function':\n                    continue;\n                  default:\n                    usedClassValues.push(value);\n                    continue;\n                }\n              } catch (error) {\n                Blac.instance.log('useBloc Error', error);\n              }\n            }\n          }\n\n          // If no state properties have been accessed, return empty dependencies to prevent re-renders\n          // Class properties can change independently of state\n          if (usedKeys.current.size === 0) {\n            return usedClassPropKeys.current.size > 0 ? [usedClassValues] : [[]];\n          }\n\n          return [usedStateValues, usedClassValues];\n        },\n      [],\n    );\n\n  const state: ExternalStore<B> = useMemo(() => {\n    return {\n      subscribe: (listener: (state: BlocState<InstanceType<B>>) => void) => {\n        const currentInstance = blocInstance.current;\n        if (!currentInstance) {\n          return () => {}; // Return no-op if no instance\n        }\n\n        const observer: BlacObserver<BlocState<InstanceType<B>>> = {\n          fn: () => {\n            try {\n              // Reset dependency tracking before listener is called \n              // This ensures we only track properties accessed during the current render\n              usedKeys.current = new Set();\n              usedClassPropKeys.current = new Set();\n\n              // Only trigger listener if there are actual subscriptions\n              listener(currentInstance.state);\n            } catch (e) {\n              // Log any errors that occur during the listener callback\n              // This ensures errors in listeners don't break the entire application\n              console.error({\n                e,\n                blocInstance: currentInstance,\n                dependencyArray,\n              });\n            }\n          },\n          // Pass the dependency array to control when the subscription is updated\n          dependencyArray,\n          // Use the provided id to identify this subscription\n          id: rid,\n        }\n\n        Blac.activateBloc(currentInstance);\n\n        // Subscribe to the bloc's observer with the provided listener function\n        // This will trigger the callback whenever the bloc's state changes\n        const unSub = currentInstance._observer.subscribe(observer);\n\n        // Return an unsubscribe function that can be called to clean up the subscription\n        return () => {\n          unSub();\n        };\n      },\n      // Return an immutable snapshot of the current bloc state\n      getSnapshot: (): BlocState<InstanceType<B>> | undefined => {\n        const instance = blocInstance.current;\n        if (!instance) {\n          return {} as BlocState<InstanceType<B>>;\n        }\n        return instance.state;\n      },\n      // Server snapshot mirrors the client snapshot in this implementation\n      getServerSnapshot: (): BlocState<InstanceType<B>> | undefined => {\n        const instance = blocInstance.current;\n        if (!instance) {\n          return {} as BlocState<InstanceType<B>>;\n        }\n        return instance.state;\n      },\n    }\n  }, [blocInstance.current?.uid]); // Re-create store when instance changes\n\n  return {\n    usedKeys,\n    usedClassPropKeys,\n    externalStore: state,\n    instance: blocInstance,\n    rid,\n  };\n};\n\nexport default useExternalBlocStore;\n","import {\n  BlocBase,\n  BlocConstructor,\n  BlocHookDependencyArrayFn,\n  BlocState,\n  InferPropsFromGeneric,\n} from '@blac/core';\nimport {\n  useEffect,\n  useMemo,\n  useRef,\n  useSyncExternalStore\n} from 'react';\nimport useExternalBlocStore from './useExternalBlocStore';\n\n/**\n * Type definition for the return type of the useBloc hook\n * @template B - Bloc constructor type\n */\ntype HookTypes<B extends BlocConstructor<BlocBase<any>>> = [\n  BlocState<InstanceType<B>> | undefined,\n  InstanceType<B> | null,\n];\n\n/**\n * Configuration options for the useBloc hook\n */\nexport interface BlocHookOptions<B extends BlocBase<any>> {\n  id?: string;\n  selector?: BlocHookDependencyArrayFn<BlocState<B>>;\n  props?: InferPropsFromGeneric<B>;\n  onMount?: (bloc: B) => void;\n  onUnmount?: (bloc: B) => void;\n}\n\n/**\n * Default dependency selector that wraps the entire state in an array\n * @template T - State type\n * @returns {Array<Array<T>>} Dependency array containing the entire state\n */\n\n/**\n * React hook for integrating with Blac state management\n *\n * This hook connects a React component to a Bloc state container, providing\n * automatic re-rendering when relevant state changes, dependency tracking,\n * and proper lifecycle management.\n *\n * @template B - Bloc constructor type\n * @template O - BlocHookOptions type\n * @param {B} bloc - Bloc constructor class\n * @param {O} [options] - Configuration options for the hook\n * @returns {HookTypes<B>} Tuple containing [state, bloc instance]\n *\n * @example\n * const [state, counterBloc] = useBloc(CounterBloc);\n * // Access state\n * console.log(state.count);\n * // Call bloc methods\n * counterBloc.increment();\n */\nexport default function useBloc<B extends BlocConstructor<BlocBase<any>>>(\n  bloc: B,\n  options?: BlocHookOptions<InstanceType<B>>,\n): HookTypes<B> {\n  // Determine ID for isolated or shared blocs\n  // const base = bloc as unknown as BlocBaseAbstract;\n  // const isIsolated = base.isolated;\n  // const effectiveBlocId = isIsolated ? rid : blocId;\n  const {\n    externalStore,\n    usedKeys,\n    usedClassPropKeys,\n    instance,\n    rid,\n  } = useExternalBlocStore(bloc, options);\n\n  // Subscribe to state changes using React's external store API\n  const state = useSyncExternalStore<BlocState<InstanceType<B>>>(\n    externalStore.subscribe,\n    () => {\n      const snapshot = externalStore.getSnapshot();\n      if (snapshot === undefined) {\n        throw new Error(`[useBloc] State snapshot is undefined for bloc ${bloc.name}. Bloc may not be properly initialized.`);\n      }\n      return snapshot;\n    },\n    externalStore.getServerSnapshot ? () => {\n      const serverSnapshot = externalStore.getServerSnapshot!();\n      if (serverSnapshot === undefined) {\n        throw new Error(`[useBloc] Server state snapshot is undefined for bloc ${bloc.name}. Bloc may not be properly initialized.`);\n      }\n      return serverSnapshot;\n    } : undefined,\n  );\n\n  // Cache proxies to avoid recreation on every render\n  const stateProxyCache = useRef<WeakMap<object, object>>(new WeakMap());\n  const classProxyCache = useRef<WeakMap<object, object>>(new WeakMap());\n\n  const returnState = useMemo(() => {\n    if (typeof state !== 'object' || state === null) {\n      return state;\n    }\n\n    // Check cache first\n    let proxy = stateProxyCache.current.get(state);\n    if (!proxy) {\n      proxy = new Proxy(state, {\n        get(target, prop) {\n          // Use setTimeout to defer dependency tracking until after render\n          setTimeout(() => {\n            usedKeys.current.add(prop as string);\n          }, 0);\n          const value = target[prop as keyof typeof target];\n          return value;\n        },\n        // Handle symbols and non-enumerable properties\n        has(target, prop) {\n          return prop in target;\n        },\n        ownKeys(target) {\n          return Reflect.ownKeys(target);\n        },\n        getOwnPropertyDescriptor(target, prop) {\n          return Reflect.getOwnPropertyDescriptor(target, prop);\n        }\n      });\n      stateProxyCache.current.set(state as object, proxy as object);\n    }\n    return proxy;\n  }, [state]);\n\n  const returnClass = useMemo(() => {\n    if (!instance.current) {\n      return null;\n    }\n\n    // Check cache first\n    let proxy = classProxyCache.current.get(instance.current);\n    if (!proxy) {\n      proxy = new Proxy(instance.current, {\n        get(target, prop) {\n          if (!target) {\n            return null;\n          }\n          const value = target[prop as keyof InstanceType<B>];\n          if (typeof value !== 'function') {\n            usedClassPropKeys.current.add(prop as string);\n          }\n          return value;\n        },\n      });\n      classProxyCache.current.set(instance.current, proxy);\n    }\n    return proxy;\n  }, [instance.current?.uid]);\n\n  // Create a stable reference object for this component\n  const componentRef = useRef({});\n\n  // Set up bloc lifecycle management\n  useEffect(() => {\n    const currentInstance = instance.current;\n    if (!currentInstance) return;\n    \n    // Pass component reference for proper memory management\n    currentInstance._addConsumer(rid, componentRef.current);\n\n    // Call onMount callback if provided\n    options?.onMount?.(currentInstance);\n\n    // Cleanup: remove this component as a consumer using the captured instance\n    return () => {\n      if (!currentInstance) {\n        return;\n      }\n      options?.onUnmount?.(currentInstance);\n      currentInstance._removeConsumer(rid);\n    };\n  }, [instance.current?.uid, rid]); // Use UID to ensure we re-run when instance changes\n\n  // Safe return with proper typing\n  return [returnState, returnClass] as [BlocState<InstanceType<B>>, InstanceType<B>];\n}\n"],"names":["useExternalBlocStore","bloc","options","blocId","props","selector","rid","useMemo","generateUUID","effectiveBlocId","usedKeys","useRef","usedClassPropKeys","getBloc","useCallback","Blac","blocInstance","dependencyArray","newState","instance","usedStateValues","key","usedClassValues","value","error","state","listener","currentInstance","observer","e","unSub","_a","useBloc","externalStore","useSyncExternalStore","snapshot","serverSnapshot","stateProxyCache","classProxyCache","returnState","proxy","target","prop","returnClass","componentRef","useEffect","_b"],"mappings":"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"}
+{"version":3,"file":"index.es.js","sources":["../src/useExternalBlocStore.ts","../src/DependencyTracker.ts","../src/useBloc.tsx"],"sourcesContent":["import { Blac, BlacObserver, BlocBase, BlocBaseAbstract, BlocConstructor, BlocHookDependencyArrayFn, BlocState, generateUUID } from '@blac/core';\nimport { useCallback, useMemo, useRef } from 'react';\nimport { BlocHookOptions } from './useBloc';\n\nexport interface ExternalStore<\n  B extends BlocConstructor<BlocBase<any>>\n> {\n  /**\n   * Subscribes to changes in the store and returns an unsubscribe function.\n   * @param onStoreChange - Callback function that will be called whenever the store changes\n   * @returns A function that can be called to unsubscribe from store changes\n   */\n  subscribe: (onStoreChange: (state: BlocState<InstanceType<B>>) => void) => () => void;\n\n  /**\n   * Gets the current snapshot of the store state.\n   * @returns The current state of the store\n   */\n  getSnapshot: () => BlocState<InstanceType<B>> | undefined;\n\n  /**\n   * Gets the server snapshot of the store state.\n   * This is optional and defaults to the same value as getSnapshot.\n   * @returns The server state of the store\n   */\n  getServerSnapshot?: () => BlocState<InstanceType<B>> | undefined;\n}\n\nexport interface ExternalBlacStore<\n  B extends BlocConstructor<BlocBase<any>>\n> {\n  usedKeys: React.RefObject<Set<string>>;\n  usedClassPropKeys: React.RefObject<Set<string>>;\n  externalStore: ExternalStore<B>;\n  instance: React.RefObject<InstanceType<B>>;\n  rid: string;\n  hasProxyTracking: React.RefObject<boolean>;\n}\n\n/**\n * Creates an external store that wraps a Bloc instance, providing a React-compatible interface\n * for subscribing to and accessing bloc state.\n */\nconst useExternalBlocStore = <\n  B extends BlocConstructor<BlocBase<any>>\n>(\n  bloc: B,\n  options: BlocHookOptions<InstanceType<B>> | undefined,\n): ExternalBlacStore<B> => {\n  const { id: blocId, props, selector } = options ?? {};\n\n  const rid = useMemo(() => {\n    return generateUUID();\n  }, []);\n\n  const base = bloc as unknown as BlocBaseAbstract;\n\n  const isIsolated = base.isolated;\n  const effectiveBlocId = isIsolated ? rid : blocId;\n\n  const usedKeys = useRef<Set<string>>(new Set());\n  const usedClassPropKeys = useRef<Set<string>>(new Set());\n  \n  // Track whether proxy-based dependency tracking has been initialized\n  // This helps distinguish between direct external store usage and useBloc proxy usage\n  const hasProxyTracking = useRef<boolean>(false);\n\n  const getBloc = useCallback(() => {\n    return Blac.getBloc(bloc, {\n      id: effectiveBlocId,\n      props,\n      instanceRef: rid\n    });\n  }, [bloc, effectiveBlocId, props, rid]);\n\n  const blocInstance = useRef<InstanceType<B>>(getBloc());\n\n  // Update the instance when dependencies change\n  useMemo(() => {\n    blocInstance.current = getBloc();\n  }, [getBloc]);\n\n  // Track previous state and dependencies for selector\n  const previousStateRef = useRef<BlocState<InstanceType<B>> | undefined>(undefined);\n  const lastDependenciesRef = useRef<unknown[][] | undefined>(undefined);\n  const lastStableSnapshot = useRef<BlocState<InstanceType<B>> | undefined>(undefined);\n  \n  // Track bloc instance uid to prevent unnecessary store recreation\n  const blocUidRef = useRef<string | undefined>(undefined);\n  if (blocUidRef.current !== blocInstance.current?.uid) {\n    blocUidRef.current = blocInstance.current?.uid;\n  }\n\n  const dependencyArray = useMemo(\n    () =>\n      (newState: BlocState<InstanceType<B>>, oldState?: BlocState<InstanceType<B>>): unknown[][] => {\n        const instance = blocInstance.current;\n\n        if (!instance) {\n          return [[], []]; // [stateArray, classArray]\n        }\n\n        // Use the provided oldState or fall back to our tracked previous state\n        const previousState = oldState ?? previousStateRef.current;\n        \n        let currentDependencies: unknown[][];\n\n        // Use custom dependency selector if provided\n        if (selector) {\n          const flatDeps = selector(newState, previousState, instance);\n          // Wrap flat custom selector result in the two-array structure for consistency\n          currentDependencies = [flatDeps, []]; // [customSelectorDeps, classArray]\n        }\n        // Fall back to bloc's default dependency selector if available\n        else if (instance.defaultDependencySelector) {\n          const flatDeps = instance.defaultDependencySelector(newState, previousState, instance);\n          // Wrap flat default selector result in the two-array structure for consistency\n          currentDependencies = [flatDeps, []]; // [defaultSelectorDeps, classArray]\n        }\n        // For primitive states, use default selector\n        else if (typeof newState !== 'object') {\n          // Default behavior for primitive states: re-render if the state itself changes.\n          currentDependencies = [[newState], []]; // [primitiveStateArray, classArray]\n        }\n        else {\n          // For object states, track which properties were actually used\n          const stateDependencies: unknown[] = [];\n          const classDependencies: unknown[] = [];\n          \n          // Add state property values that were accessed\n          for (const key of usedKeys.current) {\n            if (key in newState) {\n              stateDependencies.push(newState[key as keyof typeof newState]);\n            }\n          }\n\n          // Add class property values that were accessed\n          for (const key of usedClassPropKeys.current) {\n            if (key in instance) {\n              try {\n                const value = instance[key as keyof InstanceType<B>];\n                if (typeof value !== 'function') {\n                  classDependencies.push(value);\n                }\n              } catch (error) {\n                Blac.instance.log('useBloc Error', error);\n              }\n            }\n          }\n\n          // If no properties have been accessed through proxy\n          if (usedKeys.current.size === 0 && usedClassPropKeys.current.size === 0) {\n            // If proxy tracking has never been initialized, this is direct external store usage\n            // In this case, always track the entire state to ensure notifications\n            if (!hasProxyTracking.current) {\n              stateDependencies.push(newState);\n            }\n            // If proxy tracking was initialized but no properties accessed, \n            // return empty dependencies to prevent unnecessary re-renders\n          }\n\n          currentDependencies = [stateDependencies, classDependencies];\n        }\n\n        // Update tracked state\n        previousStateRef.current = newState;\n\n\n        // Return the dependencies for BlacObserver to compare\n        return currentDependencies;\n        },\n      [],\n    );\n\n  // Store active subscriptions to reuse observers\n  const activeObservers = useRef<Map<Function, { observer: BlacObserver<BlocState<InstanceType<B>>>, unsubscribe: () => void }>>(new Map());\n\n  const state: ExternalStore<B> = useMemo(() => {\n    return {\n      subscribe: (listener: (state: BlocState<InstanceType<B>>) => void) => {\n        \n        const currentInstance = blocInstance.current;\n        if (!currentInstance) {\n          return () => {}; // Return no-op if no instance\n        }\n\n        // Check if we already have an observer for this listener\n        const existing = activeObservers.current.get(listener);\n        if (existing) {\n          return existing.unsubscribe;\n        }\n        const observer: BlacObserver<BlocState<InstanceType<B>>> = {\n          fn: () => {\n            try {\n              \n              // Only reset dependency tracking if we're not using a custom selector\n              // Custom selectors override proxy-based tracking entirely\n              if (!selector && !currentInstance.defaultDependencySelector) {\n                usedKeys.current = new Set();\n                usedClassPropKeys.current = new Set();\n              }\n\n              // Only trigger listener if there are actual subscriptions\n              listener(currentInstance.state);\n            } catch (e) {\n              // Log any errors that occur during the listener callback\n              // This ensures errors in listeners don't break the entire application\n              console.error({\n                e,\n                blocInstance: currentInstance,\n                dependencyArray,\n              });\n            }\n          },\n          // Pass the dependency array to control when the subscription is updated\n          dependencyArray,\n          // Use the provided id to identify this subscription\n          id: rid,\n        }\n\n        Blac.activateBloc(currentInstance);\n\n        // Subscribe to the bloc's observer with the provided listener function\n        // This will trigger the callback whenever the bloc's state changes\n        const unSub = currentInstance._observer.subscribe(observer);\n\n        const unsubscribe = () => {\n          activeObservers.current.delete(listener);\n          unSub();\n        };\n\n        // Store the observer and unsubscribe function\n        activeObservers.current.set(listener, { observer, unsubscribe });\n\n        // Return an unsubscribe function that can be called to clean up the subscription\n        return unsubscribe;\n      },\n      // Return an immutable snapshot of the current bloc state\n      getSnapshot: (): BlocState<InstanceType<B>> | undefined => {\n        const instance = blocInstance.current;\n        if (!instance) {\n          return {} as BlocState<InstanceType<B>>;\n        }\n\n        const currentState = instance.state;\n        const currentDependencies = dependencyArray(currentState, previousStateRef.current);\n        \n        // Check if dependencies have changed using the two-array comparison logic\n        const lastDeps = lastDependenciesRef.current;\n        let dependenciesChanged = false;\n        \n        if (!lastDeps) {\n          // First time - dependencies changed\n          dependenciesChanged = true;\n        } else if (lastDeps.length !== currentDependencies.length) {\n          // Array structure changed\n          dependenciesChanged = true;\n        } else {\n          // Compare each array (state and class dependencies)\n          for (let arrayIndex = 0; arrayIndex < currentDependencies.length; arrayIndex++) {\n            const lastArray = lastDeps[arrayIndex] || [];\n            const newArray = currentDependencies[arrayIndex] || [];\n            \n            if (lastArray.length !== newArray.length) {\n              dependenciesChanged = true;\n              break;\n            }\n            \n            // Compare each dependency value using Object.is\n            for (let i = 0; i < newArray.length; i++) {\n              if (!Object.is(lastArray[i], newArray[i])) {\n                dependenciesChanged = true;\n                break;\n              }\n            }\n            \n            if (dependenciesChanged) break;\n          }\n        }\n        \n        // Update dependency tracking\n        lastDependenciesRef.current = currentDependencies;\n        \n        // If dependencies haven't changed, return the same snapshot reference\n        // This prevents React from re-rendering when dependencies are stable\n        if (!dependenciesChanged && lastStableSnapshot.current) {\n          return lastStableSnapshot.current;\n        }\n        \n        // Dependencies changed - update and return new snapshot\n        lastStableSnapshot.current = currentState;\n        return currentState;\n      },\n      // Server snapshot mirrors the client snapshot in this implementation\n      getServerSnapshot: (): BlocState<InstanceType<B>> | undefined => {\n        const instance = blocInstance.current;\n        if (!instance) {\n          return {} as BlocState<InstanceType<B>>;\n        }\n        return instance.state;\n      },\n    }\n  }, []); // Store is stable - individual methods handle instance changes\n\n  return {\n    usedKeys,\n    usedClassPropKeys,\n    externalStore: state,\n    instance: blocInstance,\n    rid,\n    hasProxyTracking,\n  };\n};\n\nexport default useExternalBlocStore;\n","\nexport interface DependencyMetrics {\n  stateAccessCount: number;\n  classAccessCount: number;\n  proxyCreationCount: number;\n  batchFlushCount: number;\n  averageResolutionTime: number;\n  memoryUsageKB: number;\n}\n\nexport interface DependencyTrackerConfig {\n  enableBatching: boolean;\n  batchTimeout: number;\n  enableMetrics: boolean;\n  maxCacheSize: number;\n  enableDeepTracking: boolean;\n}\n\nexport type DependencyChangeCallback = (changedKeys: Set<string>) => void;\n\nexport class DependencyTracker {\n  private stateKeys = new Set<string>();\n  private classKeys = new Set<string>();\n  private batchedCallbacks = new Set<DependencyChangeCallback>();\n  private flushScheduled = false;\n  private flushTimeoutId: ReturnType<typeof setTimeout> | undefined;\n  \n  private metrics: DependencyMetrics = {\n    stateAccessCount: 0,\n    classAccessCount: 0,\n    proxyCreationCount: 0,\n    batchFlushCount: 0,\n    averageResolutionTime: 0,\n    memoryUsageKB: 0,\n  };\n  \n  private resolutionTimes: number[] = [];\n  \n  private config: DependencyTrackerConfig;\n  \n  private stateProxyCache = new WeakMap<object, object>();\n  private classProxyCache = new WeakMap<object, object>();\n  \n  private lastStateSnapshot: unknown = null;\n  private lastClassSnapshot: unknown = null;\n  \n  constructor(config: Partial<DependencyTrackerConfig> = {}) {\n    this.config = {\n      enableBatching: true,\n      batchTimeout: 0, // Use React's scheduler\n      enableMetrics: process.env.NODE_ENV === 'development',\n      maxCacheSize: 1000,\n      enableDeepTracking: false,\n      ...config,\n    };\n  }\n\n  public trackStateAccess(key: string): void {\n    if (this.config.enableMetrics) {\n      this.metrics.stateAccessCount++;\n    }\n    \n    this.stateKeys.add(key);\n    \n    if (this.config.enableBatching) {\n      this.scheduleFlush();\n    }\n  }\n\n  public trackClassAccess(key: string): void {\n    if (this.config.enableMetrics) {\n      this.metrics.classAccessCount++;\n    }\n    \n    this.classKeys.add(key);\n    \n    if (this.config.enableBatching) {\n      this.scheduleFlush();\n    }\n  }\n\n  public createStateProxy<T extends object>(target: T, onAccess?: (prop: string) => void): T {\n    const cachedProxy = this.stateProxyCache.get(target);\n    if (cachedProxy) {\n      return cachedProxy as T;\n    }\n\n    const startTime = this.config.enableMetrics ? performance.now() : 0;\n\n    const proxy = new Proxy(target, {\n      get: (obj: T, prop: string | symbol) => {\n        if (typeof prop === 'string') {\n          this.trackStateAccess(prop);\n          onAccess?.(prop);\n        }\n        \n        const value = obj[prop as keyof T];\n        \n        if (\n          this.config.enableDeepTracking &&\n          value &&\n          typeof value === 'object' &&\n          !Array.isArray(value)\n        ) {\n          return this.createStateProxy(value as object);\n        }\n        \n        return value;\n      },\n      \n      has: (obj: T, prop: string | symbol) => {\n        return prop in obj;\n      },\n      \n      ownKeys: (obj: T) => {\n        return Reflect.ownKeys(obj);\n      },\n      \n      getOwnPropertyDescriptor: (obj: T, prop: string | symbol) => {\n        return Reflect.getOwnPropertyDescriptor(obj, prop);\n      },\n    });\n\n    this.stateProxyCache.set(target, proxy);\n    \n    if (this.config.enableMetrics) {\n      this.metrics.proxyCreationCount++;\n      const endTime = performance.now();\n      this.resolutionTimes.push(endTime - startTime);\n      this.updateAverageResolutionTime();\n    }\n\n    return proxy;\n  }\n\n  public createClassProxy<T extends object>(target: T, onAccess?: (prop: string) => void): T {\n    const cachedProxy = this.classProxyCache.get(target);\n    if (cachedProxy) {\n      return cachedProxy as T;\n    }\n\n    const startTime = this.config.enableMetrics ? performance.now() : 0;\n\n    const proxy = new Proxy(target, {\n      get: (obj: T, prop: string | symbol) => {\n        const value = obj[prop as keyof T];\n        \n        if (typeof prop === 'string' && typeof value !== 'function') {\n          this.trackClassAccess(prop);\n          onAccess?.(prop);\n        }\n        \n        return value;\n      },\n    });\n\n    this.classProxyCache.set(target, proxy);\n    \n    if (this.config.enableMetrics) {\n      this.metrics.proxyCreationCount++;\n      const endTime = performance.now();\n      this.resolutionTimes.push(endTime - startTime);\n      this.updateAverageResolutionTime();\n    }\n\n    return proxy;\n  }\n\n  public getStateKeys(): Set<string> {\n    return new Set(this.stateKeys);\n  }\n\n  public getClassKeys(): Set<string> {\n    return new Set(this.classKeys);\n  }\n\n  public reset(): void {\n    this.stateKeys.clear();\n    this.classKeys.clear();\n    this.cancelScheduledFlush();\n  }\n\n  public subscribe(callback: DependencyChangeCallback): () => void {\n    this.batchedCallbacks.add(callback);\n    \n    return () => {\n      this.batchedCallbacks.delete(callback);\n    };\n  }\n\n  public computeDependencyArray<TState, TClass>(\n    state: TState,\n    classInstance: TClass,\n  ): unknown[] {\n    const startTime = this.config.enableMetrics ? performance.now() : 0;\n    \n    if (typeof state !== 'object' || state === null) {\n      return [[state]];\n    }\n\n    const stateValues: unknown[] = [];\n    for (const key of this.stateKeys) {\n      if (key in (state as object)) {\n        stateValues.push((state as any)[key]);\n      }\n    }\n\n    const classValues: unknown[] = [];\n    for (const key of this.classKeys) {\n      if (key in (classInstance as object)) {\n        try {\n          const value = (classInstance as any)[key];\n          if (typeof value !== 'function') {\n            classValues.push(value);\n          }\n        } catch (error) {\n        }\n      }\n    }\n\n    if (this.config.enableMetrics) {\n      const endTime = performance.now();\n      this.resolutionTimes.push(endTime - startTime);\n      this.updateAverageResolutionTime();\n    }\n\n    if (stateValues.length === 0 && classValues.length === 0) {\n      return [[]];\n    }\n    \n    if (classValues.length === 0) {\n      return [stateValues];\n    }\n    \n    if (stateValues.length === 0) {\n      return [classValues];\n    }\n    \n    return [stateValues, classValues];\n  }\n\n  public getMetrics(): DependencyMetrics {\n    if (!this.config.enableMetrics) {\n      return {\n        stateAccessCount: 0,\n        classAccessCount: 0,\n        proxyCreationCount: 0,\n        batchFlushCount: 0,\n        averageResolutionTime: 0,\n        memoryUsageKB: 0,\n      };\n    }\n\n    const estimatedMemory = \n      (this.stateKeys.size * 50) +\n      (this.classKeys.size * 50) +\n      (this.stateProxyCache instanceof WeakMap ? 100 : 0) +\n      (this.classProxyCache instanceof WeakMap ? 100 : 0);\n\n    return {\n      ...this.metrics,\n      memoryUsageKB: Math.round(estimatedMemory / 1024),\n    };\n  }\n\n  public clearCaches(): void {\n    this.stateProxyCache = new WeakMap();\n    this.classProxyCache = new WeakMap();\n    this.resolutionTimes = [];\n    \n    if (this.config.enableMetrics) {\n      this.metrics = {\n        stateAccessCount: 0,\n        classAccessCount: 0,\n        proxyCreationCount: 0,\n        batchFlushCount: 0,\n        averageResolutionTime: 0,\n        memoryUsageKB: 0,\n      };\n    }\n  }\n\n  private scheduleFlush(): void {\n    if (this.flushScheduled) {\n      return;\n    }\n\n    this.flushScheduled = true;\n\n    if (this.config.batchTimeout > 0) {\n      this.flushTimeoutId = setTimeout(() => {\n        this.flushBatchedChanges();\n      }, this.config.batchTimeout);\n    } else {\n      Promise.resolve().then(() => this.flushBatchedChanges());\n    }\n  }\n\n  private cancelScheduledFlush(): void {\n    if (this.flushTimeoutId) {\n      clearTimeout(this.flushTimeoutId);\n      this.flushTimeoutId = undefined;\n    }\n    this.flushScheduled = false;\n  }\n\n  private flushBatchedChanges(): void {\n    if (!this.flushScheduled) {\n      return;\n    }\n\n    this.flushScheduled = false;\n    this.flushTimeoutId = undefined;\n\n    if (this.config.enableMetrics) {\n      this.metrics.batchFlushCount++;\n    }\n\n    const allChangedKeys = new Set([...this.stateKeys, ...this.classKeys]);\n    \n    for (const callback of this.batchedCallbacks) {\n      try {\n        callback(allChangedKeys);\n      } catch (error) {\n        console.error('Error in dependency change callback:', error);\n      }\n    }\n  }\n\n  private updateAverageResolutionTime(): void {\n    if (this.resolutionTimes.length === 0) {\n      return;\n    }\n\n    if (this.resolutionTimes.length > 100) {\n      this.resolutionTimes = this.resolutionTimes.slice(-100);\n    }\n\n    const sum = this.resolutionTimes.reduce((a, b) => a + b, 0);\n    this.metrics.averageResolutionTime = sum / this.resolutionTimes.length;\n  }\n}\n\nexport function createDependencyTracker(\n  config?: Partial<DependencyTrackerConfig>,\n): DependencyTracker {\n  return new DependencyTracker(config);\n}\n\nexport const defaultDependencyTracker = createDependencyTracker();","import {\n  BlocBase,\n  BlocConstructor,\n  BlocHookDependencyArrayFn,\n  BlocState,\n  InferPropsFromGeneric,\n} from '@blac/core';\nimport { useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport useExternalBlocStore from './useExternalBlocStore';\nimport { DependencyTracker } from './DependencyTracker';\n\n/**\n * Type definition for the return type of the useBloc hook\n * @template B - Bloc constructor type\n */\ntype HookTypes<B extends BlocConstructor<BlocBase<any>>> = [\n  BlocState<InstanceType<B>>,\n  InstanceType<B>,\n];\n\n/**\n * Configuration options for the useBloc hook\n */\nexport interface BlocHookOptions<B extends BlocBase<any>> {\n  id?: string;\n  selector?: BlocHookDependencyArrayFn<BlocState<B>>;\n  props?: InferPropsFromGeneric<B>;\n  onMount?: (bloc: B) => void;\n  onUnmount?: (bloc: B) => void;\n}\n\n/**\n * Default dependency selector that wraps the entire state in an array\n * @template T - State type\n * @returns {Array<Array<T>>} Dependency array containing the entire state\n */\n\n/**\n * React hook for integrating with Blac state management\n *\n * This hook connects a React component to a Bloc state container, providing\n * automatic re-rendering when relevant state changes, dependency tracking,\n * and proper lifecycle management.\n *\n * @template B - Bloc constructor type\n * @template O - BlocHookOptions type\n * @param {B} bloc - Bloc constructor class\n * @param {O} [options] - Configuration options for the hook\n * @returns {HookTypes<B>} Tuple containing [state, bloc instance]\n *\n * @example\n * const [state, counterBloc] = useBloc(CounterBloc);\n * // Access state\n * console.log(state.count);\n * // Call bloc methods\n * counterBloc.increment();\n */\nexport default function useBloc<B extends BlocConstructor<BlocBase<any>>>(\n  bloc: B,\n  options?: BlocHookOptions<InstanceType<B>>,\n): HookTypes<B> {\n  const {\n    externalStore,\n    usedKeys,\n    usedClassPropKeys,\n    instance,\n    rid,\n    hasProxyTracking,\n  } = useExternalBlocStore(bloc, options);\n\n  const state = useSyncExternalStore<BlocState<InstanceType<B>>>(\n    externalStore.subscribe,\n    () => {\n      const snapshot = externalStore.getSnapshot();\n      if (snapshot === undefined) {\n        throw new Error(\n          `[useBloc] State snapshot is undefined for bloc ${bloc.name}. Bloc may not be properly initialized.`,\n        );\n      }\n      return snapshot;\n    },\n    externalStore.getServerSnapshot\n      ? () => {\n          const serverSnapshot = externalStore.getServerSnapshot!();\n          if (serverSnapshot === undefined) {\n            throw new Error(\n              `[useBloc] Server state snapshot is undefined for bloc ${bloc.name}. Bloc may not be properly initialized.`,\n            );\n          }\n          return serverSnapshot;\n        }\n      : undefined,\n  );\n\n  const dependencyTracker = useRef<DependencyTracker | null>(null);\n  if (!dependencyTracker.current) {\n    dependencyTracker.current = new DependencyTracker({\n      enableBatching: true,\n      enableMetrics: process.env.NODE_ENV === 'development',\n      enableDeepTracking: false,\n    });\n  }\n\n  const stateProxyCache = useRef<WeakMap<object, object>>(new WeakMap());\n  const classProxyCache = useRef<WeakMap<object, object>>(new WeakMap());\n\n  const returnState = useMemo(() => {\n    // If a custom selector is provided, don't use proxy tracking\n    if (options?.selector) {\n      return state;\n    }\n\n    hasProxyTracking.current = true;\n\n    if (typeof state !== 'object' || state === null) {\n      return state;\n    }\n\n    let proxy = stateProxyCache.current.get(state);\n    if (!proxy) {\n      proxy = new Proxy(state, {\n        get(target, prop) {\n          if (typeof prop === 'string') {\n            usedKeys.current.add(prop);\n            dependencyTracker.current?.trackStateAccess(prop);\n          }\n          const value = target[prop as keyof typeof target];\n          return value;\n        },\n        has(target, prop) {\n          return prop in target;\n        },\n        ownKeys(target) {\n          return Reflect.ownKeys(target);\n        },\n        getOwnPropertyDescriptor(target, prop) {\n          return Reflect.getOwnPropertyDescriptor(target, prop);\n        },\n      });\n      stateProxyCache.current.set(state as object, proxy as object);\n    }\n    return proxy;\n  }, [state]);\n\n  const returnClass = useMemo(() => {\n    if (!instance.current) {\n      throw new Error(\n        `[useBloc] Bloc instance is null for ${bloc.name}. This should never happen - bloc instance must be defined.`,\n      );\n    }\n\n    let proxy = classProxyCache.current.get(instance.current);\n    if (!proxy) {\n      proxy = new Proxy(instance.current, {\n        get(target, prop) {\n          if (!target) {\n            throw new Error(\n              `[useBloc] Bloc target is null for ${bloc.name}. This should never happen - bloc target must be defined.`,\n            );\n          }\n          const value = target[prop as keyof InstanceType<B>];\n          if (typeof value !== 'function' && typeof prop === 'string') {\n            usedClassPropKeys.current.add(prop);\n            dependencyTracker.current?.trackClassAccess(prop);\n          }\n          return value;\n        },\n      });\n      classProxyCache.current.set(instance.current, proxy);\n    }\n    return proxy;\n  }, [instance.current?.uid]);\n\n  const componentRef = useRef({});\n\n  useEffect(() => {\n    const currentInstance = instance.current;\n    if (!currentInstance) return;\n\n    currentInstance._addConsumer(rid, componentRef.current);\n\n    options?.onMount?.(currentInstance);\n\n    return () => {\n      if (!currentInstance) {\n        return;\n      }\n      options?.onUnmount?.(currentInstance);\n      currentInstance._removeConsumer(rid);\n\n      dependencyTracker.current?.reset();\n    };\n  }, [instance.current?.uid, rid]);\n  useEffect(() => {\n    if (process.env.NODE_ENV === 'development' && dependencyTracker.current) {\n      const metrics = dependencyTracker.current.getMetrics();\n      if (metrics.stateAccessCount > 0 || metrics.classAccessCount > 0) {\n        console.debug(`[useBloc] ${bloc.name} Performance Metrics:`, metrics);\n      }\n    }\n  });\n\n  if (returnState === undefined) {\n    throw new Error(\n      `[useBloc] State is undefined for ${bloc.name}. This should never happen - state must be defined.`,\n    );\n  }\n  if (!returnClass) {\n    throw new Error(\n      `[useBloc] Instance is null for ${bloc.name}. This should never happen - instance must be defined.`,\n    );\n  }\n\n  return [returnState, returnClass] as [\n    BlocState<InstanceType<B>>,\n    InstanceType<B>,\n  ];\n}\n"],"names":["useExternalBlocStore","bloc","options","blocId","props","selector","rid","useMemo","generateUUID","effectiveBlocId","usedKeys","useRef","usedClassPropKeys","hasProxyTracking","getBloc","useCallback","Blac","blocInstance","previousStateRef","lastDependenciesRef","lastStableSnapshot","blocUidRef","_a","_b","dependencyArray","newState","oldState","instance","previousState","currentDependencies","stateDependencies","classDependencies","key","value","error","activeObservers","state","listener","currentInstance","existing","observer","e","unSub","unsubscribe","currentState","lastDeps","dependenciesChanged","arrayIndex","lastArray","newArray","i","DependencyTracker","config","__publicField","target","onAccess","cachedProxy","startTime","proxy","obj","prop","endTime","callback","classInstance","stateValues","classValues","estimatedMemory","allChangedKeys","sum","a","b","createDependencyTracker","useBloc","externalStore","useSyncExternalStore","snapshot","serverSnapshot","dependencyTracker","stateProxyCache","classProxyCache","returnState","returnClass","componentRef","useEffect","metrics"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blac/react",
-  "version": "2.0.0-rc-6",
+  "version": "2.0.0-rc-8",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
   "main": "dist/index.cjs.js",
@@ -30,7 +30,7 @@
     "@types/react-dom": "^18.0.0 || ^19.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "@blac/core": "2.0.0-rc-6"
+    "@blac/core": "2.0.0-rc-8"
   },
   "peerDependenciesMeta": {
     "@types/react": {

package/src/DependencyTracker.ts

@@ -0,0 +1,350 @@
+
+export interface DependencyMetrics {
+  stateAccessCount: number;
+  classAccessCount: number;
+  proxyCreationCount: number;
+  batchFlushCount: number;
+  averageResolutionTime: number;
+  memoryUsageKB: number;
+}
+
+export interface DependencyTrackerConfig {
+  enableBatching: boolean;
+  batchTimeout: number;
+  enableMetrics: boolean;
+  maxCacheSize: number;
+  enableDeepTracking: boolean;
+}
+
+export type DependencyChangeCallback = (changedKeys: Set<string>) => void;
+
+export class DependencyTracker {
+  private stateKeys = new Set<string>();
+  private classKeys = new Set<string>();
+  private batchedCallbacks = new Set<DependencyChangeCallback>();
+  private flushScheduled = false;
+  private flushTimeoutId: ReturnType<typeof setTimeout> | undefined;
+  
+  private metrics: DependencyMetrics = {
+    stateAccessCount: 0,
+    classAccessCount: 0,
+    proxyCreationCount: 0,
+    batchFlushCount: 0,
+    averageResolutionTime: 0,
+    memoryUsageKB: 0,
+  };
+  
+  private resolutionTimes: number[] = [];
+  
+  private config: DependencyTrackerConfig;
+  
+  private stateProxyCache = new WeakMap<object, object>();
+  private classProxyCache = new WeakMap<object, object>();
+  
+  private lastStateSnapshot: unknown = null;
+  private lastClassSnapshot: unknown = null;
+  
+  constructor(config: Partial<DependencyTrackerConfig> = {}) {
+    this.config = {
+      enableBatching: true,
+      batchTimeout: 0, // Use React's scheduler
+      enableMetrics: process.env.NODE_ENV === 'development',
+      maxCacheSize: 1000,
+      enableDeepTracking: false,
+      ...config,
+    };
+  }
+
+  public trackStateAccess(key: string): void {
+    if (this.config.enableMetrics) {
+      this.metrics.stateAccessCount++;
+    }
+    
+    this.stateKeys.add(key);
+    
+    if (this.config.enableBatching) {
+      this.scheduleFlush();
+    }
+  }
+
+  public trackClassAccess(key: string): void {
+    if (this.config.enableMetrics) {
+      this.metrics.classAccessCount++;
+    }
+    
+    this.classKeys.add(key);
+    
+    if (this.config.enableBatching) {
+      this.scheduleFlush();
+    }
+  }
+
+  public createStateProxy<T extends object>(target: T, onAccess?: (prop: string) => void): T {
+    const cachedProxy = this.stateProxyCache.get(target);
+    if (cachedProxy) {
+      return cachedProxy as T;
+    }
+
+    const startTime = this.config.enableMetrics ? performance.now() : 0;
+
+    const proxy = new Proxy(target, {
+      get: (obj: T, prop: string | symbol) => {
+        if (typeof prop === 'string') {
+          this.trackStateAccess(prop);
+          onAccess?.(prop);
+        }
+        
+        const value = obj[prop as keyof T];
+        
+        if (
+          this.config.enableDeepTracking &&
+          value &&
+          typeof value === 'object' &&
+          !Array.isArray(value)
+        ) {
+          return this.createStateProxy(value as object);
+        }
+        
+        return value;
+      },
+      
+      has: (obj: T, prop: string | symbol) => {
+        return prop in obj;
+      },
+      
+      ownKeys: (obj: T) => {
+        return Reflect.ownKeys(obj);
+      },
+      
+      getOwnPropertyDescriptor: (obj: T, prop: string | symbol) => {
+        return Reflect.getOwnPropertyDescriptor(obj, prop);
+      },
+    });
+
+    this.stateProxyCache.set(target, proxy);
+    
+    if (this.config.enableMetrics) {
+      this.metrics.proxyCreationCount++;
+      const endTime = performance.now();
+      this.resolutionTimes.push(endTime - startTime);
+      this.updateAverageResolutionTime();
+    }
+
+    return proxy;
+  }
+
+  public createClassProxy<T extends object>(target: T, onAccess?: (prop: string) => void): T {
+    const cachedProxy = this.classProxyCache.get(target);
+    if (cachedProxy) {
+      return cachedProxy as T;
+    }
+
+    const startTime = this.config.enableMetrics ? performance.now() : 0;
+
+    const proxy = new Proxy(target, {
+      get: (obj: T, prop: string | symbol) => {
+        const value = obj[prop as keyof T];
+        
+        if (typeof prop === 'string' && typeof value !== 'function') {
+          this.trackClassAccess(prop);
+          onAccess?.(prop);
+        }
+        
+        return value;
+      },
+    });
+
+    this.classProxyCache.set(target, proxy);
+    
+    if (this.config.enableMetrics) {
+      this.metrics.proxyCreationCount++;
+      const endTime = performance.now();
+      this.resolutionTimes.push(endTime - startTime);
+      this.updateAverageResolutionTime();
+    }
+
+    return proxy;
+  }
+
+  public getStateKeys(): Set<string> {
+    return new Set(this.stateKeys);
+  }
+
+  public getClassKeys(): Set<string> {
+    return new Set(this.classKeys);
+  }
+
+  public reset(): void {
+    this.stateKeys.clear();
+    this.classKeys.clear();
+    this.cancelScheduledFlush();
+  }
+
+  public subscribe(callback: DependencyChangeCallback): () => void {
+    this.batchedCallbacks.add(callback);
+    
+    return () => {
+      this.batchedCallbacks.delete(callback);
+    };
+  }
+
+  public computeDependencyArray<TState, TClass>(
+    state: TState,
+    classInstance: TClass,
+  ): unknown[] {
+    const startTime = this.config.enableMetrics ? performance.now() : 0;
+    
+    if (typeof state !== 'object' || state === null) {
+      return [[state]];
+    }
+
+    const stateValues: unknown[] = [];
+    for (const key of this.stateKeys) {
+      if (key in (state as object)) {
+        stateValues.push((state as any)[key]);
+      }
+    }
+
+    const classValues: unknown[] = [];
+    for (const key of this.classKeys) {
+      if (key in (classInstance as object)) {
+        try {
+          const value = (classInstance as any)[key];
+          if (typeof value !== 'function') {
+            classValues.push(value);
+          }
+        } catch (error) {
+        }
+      }
+    }
+
+    if (this.config.enableMetrics) {
+      const endTime = performance.now();
+      this.resolutionTimes.push(endTime - startTime);
+      this.updateAverageResolutionTime();
+    }
+
+    if (stateValues.length === 0 && classValues.length === 0) {
+      return [[]];
+    }
+    
+    if (classValues.length === 0) {
+      return [stateValues];
+    }
+    
+    if (stateValues.length === 0) {
+      return [classValues];
+    }
+    
+    return [stateValues, classValues];
+  }
+
+  public getMetrics(): DependencyMetrics {
+    if (!this.config.enableMetrics) {
+      return {
+        stateAccessCount: 0,
+        classAccessCount: 0,
+        proxyCreationCount: 0,
+        batchFlushCount: 0,
+        averageResolutionTime: 0,
+        memoryUsageKB: 0,
+      };
+    }
+
+    const estimatedMemory = 
+      (this.stateKeys.size * 50) +
+      (this.classKeys.size * 50) +
+      (this.stateProxyCache instanceof WeakMap ? 100 : 0) +
+      (this.classProxyCache instanceof WeakMap ? 100 : 0);
+
+    return {
+      ...this.metrics,
+      memoryUsageKB: Math.round(estimatedMemory / 1024),
+    };
+  }
+
+  public clearCaches(): void {
+    this.stateProxyCache = new WeakMap();
+    this.classProxyCache = new WeakMap();
+    this.resolutionTimes = [];
+    
+    if (this.config.enableMetrics) {
+      this.metrics = {
+        stateAccessCount: 0,
+        classAccessCount: 0,
+        proxyCreationCount: 0,
+        batchFlushCount: 0,
+        averageResolutionTime: 0,
+        memoryUsageKB: 0,
+      };
+    }
+  }
+
+  private scheduleFlush(): void {
+    if (this.flushScheduled) {
+      return;
+    }
+
+    this.flushScheduled = true;
+
+    if (this.config.batchTimeout > 0) {
+      this.flushTimeoutId = setTimeout(() => {
+        this.flushBatchedChanges();
+      }, this.config.batchTimeout);
+    } else {
+      Promise.resolve().then(() => this.flushBatchedChanges());
+    }
+  }
+
+  private cancelScheduledFlush(): void {
+    if (this.flushTimeoutId) {
+      clearTimeout(this.flushTimeoutId);
+      this.flushTimeoutId = undefined;
+    }
+    this.flushScheduled = false;
+  }
+
+  private flushBatchedChanges(): void {
+    if (!this.flushScheduled) {
+      return;
+    }
+
+    this.flushScheduled = false;
+    this.flushTimeoutId = undefined;
+
+    if (this.config.enableMetrics) {
+      this.metrics.batchFlushCount++;
+    }
+
+    const allChangedKeys = new Set([...this.stateKeys, ...this.classKeys]);
+    
+    for (const callback of this.batchedCallbacks) {
+      try {
+        callback(allChangedKeys);
+      } catch (error) {
+        console.error('Error in dependency change callback:', error);
+      }
+    }
+  }
+
+  private updateAverageResolutionTime(): void {
+    if (this.resolutionTimes.length === 0) {
+      return;
+    }
+
+    if (this.resolutionTimes.length > 100) {
+      this.resolutionTimes = this.resolutionTimes.slice(-100);
+    }
+
+    const sum = this.resolutionTimes.reduce((a, b) => a + b, 0);
+    this.metrics.averageResolutionTime = sum / this.resolutionTimes.length;
+  }
+}
+
+export function createDependencyTracker(
+  config?: Partial<DependencyTrackerConfig>,
+): DependencyTracker {
+  return new DependencyTracker(config);
+}
+
+export const defaultDependencyTracker = createDependencyTracker();