lib/src/model/feature_set.dart

// Copyright (c) 2020, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import 'package:dartdoc/src/model/language_feature.dart';
import 'package:dartdoc/src/model/model.dart';

/// [ModelElement]s can have different language features that can alter
/// the user interpretation of the interface.
mixin FeatureSet {
  PackageGraph get packageGraph;
  Library get library;

  /// A list of language features that both apply to this [ModelElement] and
  /// make sense to display in context.
  Iterable<LanguageFeature> get displayedLanguageFeatures sync* {
    // TODO(jcollins-g): Implement mixed-mode handling and the tagging of
    // legacy interfaces.
    if (isNNBD) {
      yield LanguageFeature(
          'Null safety', packageGraph.rendererFactory.featureRenderer);
    }
  }

  bool get hasFeatureSet => displayedLanguageFeatures.isNotEmpty;

  // TODO(jcollins-g): This is an approximation and not strictly true for
  // inheritance/reexports.
  bool get isNNBD => library.isNNBD;
}