pkgs/record_use/lib/src/loading_unit.dart

// Copyright (c) 2026, 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 'canonicalization_context.dart';
import 'definition.dart';

/// A loading unit in which a usage of a [Definition] was recorded.
///
/// A loading unit is a blob in the target format of the compiler that can be
/// loaded separately when an application is loaded. Loading units are either
/// binary blobs containing machine code, web assembly or javascript files.
final class LoadingUnit {
  /// The name of the loading unit.
  final String name;

  /// Creates a [LoadingUnit] with [name].
  const LoadingUnit(this.name);

  /// Canonicalizes the children of this [LoadingUnit].
  LoadingUnit _canonicalizeChildren(CanonicalizationContext context) => this;

  @override
  bool operator ==(Object other) {
    if (identical(this, other)) return true;

    return other is LoadingUnit && other.name == name;
  }

  @override
  int get hashCode => name.hashCode;

  @override
  String toString() => 'LoadingUnit($name)';
}

/// Package private (protected) methods for [LoadingUnit].
///
/// This avoids bloating the public API and public API docs and prevents
/// internal types from leaking from the API.
extension LoadingUnitProtected on LoadingUnit {
  /// Canonicalizes the children of this loading unit.
  LoadingUnit canonicalizeChildren(CanonicalizationContext context) =>
      _canonicalizeChildren(context);
}