cherrypick/benchmark_di/lib/di_adapters/di_adapter.dart

import 'package:benchmark_di/scenarios/universal_binding_mode.dart';

/// Универсальная абстракция для DI-адаптера с унифицированной функцией регистрации.
/// Теперь для каждого адаптера задаём строгий generic тип контейнера.
typedef Registration<TContainer> = void Function(TContainer);

abstract class DIAdapter<TContainer> {
  /// Устанавливает зависимости с помощью строго типизированного контейнера.
  void setupDependencies(void Function(TContainer container) registration);

  /// Возвращает типобезопасную функцию регистрации зависимостей под конкретный сценарий.
  Registration<TContainer> universalRegistration<S extends Enum>({
    required S scenario,
    required int chainCount,
    required int nestingDepth,
    required UniversalBindingMode bindingMode,
  });

  /// Резолвит (возвращает) экземпляр типа [T] (по имени, если требуется).
  T resolve<T extends Object>({String? named});

  /// Асинхронно резолвит экземпляр типа [T] (если нужно).
  Future<T> resolveAsync<T extends Object>({String? named});

  /// Уничтожает/отчищает DI-контейнер.
  void teardown();

  /// Открывает дочерний scope и возвращает новый адаптер (если поддерживается).
  DIAdapter<TContainer> openSubScope(String name);

  /// Ожидание готовности DI контейнера (если нужно для async DI).
  Future<void> waitForAsyncReady() async {}
}