Function derefWeakRef

packages/core/src/utils/weakRef.ts:48–65

(ref: MaybeWeakRef<T> | undefined)

 * @returns The referenced object, or undefined if GC'd or ref was undefined
 */
export function derefWeakRef<T extends object>(ref: MaybeWeakRef<T> | undefined): T | undefined {
  if (!ref) {
    return undefined;
  }

  // Check if this is a WeakRef (has deref method)
  if (typeof ref === 'object' && 'deref' in ref && typeof ref.deref === 'function') {
    try {
      return ref.deref();
    } catch {
      // deref() failed - treat as GC'd
      return undefined;
    }
  }

  // Direct reference fallback
  return ref as T;
}