// Copyright (c) 2021, 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.

// THIS FILE IS GENERATED. DO NOT EDIT.
//
// Instead modify 'pkg/analyzer/messages.yaml' and run
// 'dart run pkg/analyzer/tool/messages/generate.dart' to update.

// While transitioning `HintCodes` to `WarningCodes`, we refer to deprecated
// codes here.
// ignore_for_file: deprecated_member_use_from_same_package
//
// Generated comments don't quite align with flutter style.
// ignore_for_file: flutter_style_todos

/// @docImport 'package:analyzer/src/dart/error/syntactic_errors.g.dart';
/// @docImport 'package:analyzer/src/error/inference_error.dart';
@Deprecated(
  // This library is deprecated to prevent it from being accidentally imported
  // It should only be imported by the corresponding non-code-generated library
  // (which suppresses the deprecation warning using an "ignore" comment).
  'Use package:analyzer/src/pubspec/pubspec_warning_code.dart instead',
)
library;

import "package:_fe_analyzer_shared/src/base/errors.dart";

class PubspecWarningCode extends DiagnosticCode {
  /// Parameters:
  /// 0: the path to the asset directory as given in the file.
  static const PubspecWarningCode ASSET_DIRECTORY_DOES_NOT_EXIST =
      PubspecWarningCode(
        'ASSET_DIRECTORY_DOES_NOT_EXIST',
        "The asset directory '{0}' doesn't exist.",
        correctionMessage:
            "Try creating the directory or fixing the path to the directory.",
        hasPublishedDocs: true,
      );

  /// Parameters:
  /// 0: the path to the asset as given in the file.
  static const PubspecWarningCode ASSET_DOES_NOT_EXIST = PubspecWarningCode(
    'ASSET_DOES_NOT_EXIST',
    "The asset file '{0}' doesn't exist.",
    correctionMessage: "Try creating the file or fixing the path to the file.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode ASSET_FIELD_NOT_LIST = PubspecWarningCode(
    'ASSET_FIELD_NOT_LIST',
    "The value of the 'assets' field is expected to be a list of relative file "
        "paths.",
    correctionMessage:
        "Try converting the value to be a list of relative file paths.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode ASSET_MISSING_PATH = PubspecWarningCode(
    'ASSET_MISSING_PATH',
    "Asset map entry must contain a 'path' field.",
    correctionMessage: "Try adding a 'path' field.",
    hasPublishedDocs: true,
  );

  /// This code is deprecated in favor of the
  /// 'ASSET_NOT_STRING_OR_MAP' code, and will be removed.
  ///
  /// No parameters.
  static const PubspecWarningCode ASSET_NOT_STRING = PubspecWarningCode(
    'ASSET_NOT_STRING',
    "Assets are required to be file paths (strings).",
    correctionMessage: "Try converting the value to be a string.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode ASSET_NOT_STRING_OR_MAP = PubspecWarningCode(
    'ASSET_NOT_STRING_OR_MAP',
    "An asset value is required to be a file path (string) or map.",
    correctionMessage: "Try converting the value to be a string or map.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode ASSET_PATH_NOT_STRING = PubspecWarningCode(
    'ASSET_PATH_NOT_STRING',
    "Asset paths are required to be file paths (strings).",
    correctionMessage: "Try converting the value to be a string.",
    hasPublishedDocs: true,
  );

  /// Parameters:
  /// 0: the name of the field
  static const PubspecWarningCode DEPENDENCIES_FIELD_NOT_MAP =
      PubspecWarningCode(
        'DEPENDENCIES_FIELD_NOT_MAP',
        "The value of the '{0}' field is expected to be a map.",
        correctionMessage: "Try converting the value to be a map.",
        hasPublishedDocs: true,
      );

  /// Parameters:
  /// 0: the name of the field
  static const PubspecWarningCode DEPRECATED_FIELD = PubspecWarningCode(
    'DEPRECATED_FIELD',
    "The '{0}' field is no longer used and can be removed.",
    correctionMessage: "Try removing the field.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode FLUTTER_FIELD_NOT_MAP = PubspecWarningCode(
    'FLUTTER_FIELD_NOT_MAP',
    "The value of the 'flutter' field is expected to be a map.",
    correctionMessage: "Try converting the value to be a map.",
    hasPublishedDocs: true,
  );

  /// Parameters:
  /// 0: the kind of dependency.
  static const PubspecWarningCode INVALID_DEPENDENCY = PubspecWarningCode(
    'INVALID_DEPENDENCY',
    "Publishable packages can't have '{0}' dependencies.",
    correctionMessage:
        "Try adding a 'publish_to: none' entry to mark the package as not for "
        "publishing or remove the {0} dependency.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode INVALID_PLATFORMS_FIELD = PubspecWarningCode(
    'INVALID_PLATFORMS_FIELD',
    "The 'platforms' field must be a map with platforms as keys.",
    correctionMessage:
        "Try changing the 'platforms' field to a map with platforms as keys.",
    hasPublishedDocs: true,
  );

  /// Parameters:
  /// 0: the list of packages missing from the dependencies and the list of
  ///    packages missing from the dev_dependencies (if any) in the pubspec
  ///    file.
  static const PubspecWarningCode MISSING_DEPENDENCY = PubspecWarningCode(
    'MISSING_DEPENDENCY',
    "Missing a dependency on imported package '{0}'.",
    correctionMessage: "Try adding {0}.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode MISSING_NAME = PubspecWarningCode(
    'MISSING_NAME',
    "The 'name' field is required but missing.",
    correctionMessage: "Try adding a field named 'name'.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode NAME_NOT_STRING = PubspecWarningCode(
    'NAME_NOT_STRING',
    "The value of the 'name' field is required to be a string.",
    correctionMessage: "Try converting the value to be a string.",
    hasPublishedDocs: true,
  );

  /// Parameters:
  /// 0: the path to the dependency as given in the file.
  static const PubspecWarningCode PATH_DOES_NOT_EXIST = PubspecWarningCode(
    'PATH_DOES_NOT_EXIST',
    "The path '{0}' doesn't exist.",
    correctionMessage:
        "Try creating the referenced path or using a path that exists.",
    hasPublishedDocs: true,
  );

  /// Parameters:
  /// 0: the path as given in the file.
  static const PubspecWarningCode PATH_NOT_POSIX = PubspecWarningCode(
    'PATH_NOT_POSIX',
    "The path '{0}' isn't a POSIX-style path.",
    correctionMessage: "Try converting the value to a POSIX-style path.",
    hasPublishedDocs: true,
  );

  /// Parameters:
  /// 0: the path to the dependency as given in the file.
  static const PubspecWarningCode
  PATH_PUBSPEC_DOES_NOT_EXIST = PubspecWarningCode(
    'PATH_PUBSPEC_DOES_NOT_EXIST',
    "The directory '{0}' doesn't contain a pubspec.",
    correctionMessage:
        "Try creating a pubspec in the referenced directory or using a path "
        "that has a pubspec.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode PLATFORM_VALUE_DISALLOWED =
      PubspecWarningCode(
        'PLATFORM_VALUE_DISALLOWED',
        "Keys in the `platforms` field can't have values.",
        correctionMessage: "Try removing the value, while keeping the key.",
        hasPublishedDocs: true,
      );

  /// Parameters:
  /// 0: the unknown platform.
  static const PubspecWarningCode UNKNOWN_PLATFORM = PubspecWarningCode(
    'UNKNOWN_PLATFORM',
    "The platform '{0}' is not a recognized platform.",
    correctionMessage: "Try correcting the platform name or removing it.",
    hasPublishedDocs: true,
  );

  /// Parameters:
  /// 0: the name of the package in the dev_dependency list.
  static const PubspecWarningCode
  UNNECESSARY_DEV_DEPENDENCY = PubspecWarningCode(
    'UNNECESSARY_DEV_DEPENDENCY',
    "The dev dependency on {0} is unnecessary because there is also a normal "
        "dependency on that package.",
    correctionMessage: "Try removing the dev dependency.",
    hasPublishedDocs: true,
  );

  /// No parameters.
  static const PubspecWarningCode WORKSPACE_FIELD_NOT_LIST = PubspecWarningCode(
    'WORKSPACE_FIELD_NOT_LIST',
    "The value of the 'workspace' field is required to be a list of relative "
        "file paths.",
    correctionMessage:
        "Try converting the value to be a list of relative file paths.",
  );

  /// No parameters.
  static const PubspecWarningCode WORKSPACE_VALUE_NOT_STRING =
      PubspecWarningCode(
        'WORKSPACE_VALUE_NOT_STRING',
        "Workspace entries are required to be directory paths (strings).",
        correctionMessage: "Try converting the value to be a string.",
      );

  /// Parameters:
  /// 0: the path of the directory that contains the pubspec.yaml file.
  static const PubspecWarningCode WORKSPACE_VALUE_NOT_SUBDIRECTORY =
      PubspecWarningCode(
        'WORKSPACE_VALUE_NOT_SUBDIRECTORY',
        "Workspace values must be a relative path of a subdirectory of '{0}'.",
        correctionMessage:
            "Try using a subdirectory of the directory containing the "
            "'pubspec.yaml' file.",
      );

  /// Initialize a newly created error code to have the given [name].
  const PubspecWarningCode(
    String name,
    String problemMessage, {
    super.correctionMessage,
    super.hasPublishedDocs = false,
    super.isUnresolvedIdentifier = false,
    String? uniqueName,
  }) : super(
         name: name,
         problemMessage: problemMessage,
         uniqueName: 'PubspecWarningCode.${uniqueName ?? name}',
       );

  @override
  DiagnosticSeverity get severity => DiagnosticSeverity.WARNING;

  @override
  DiagnosticType get type => DiagnosticType.STATIC_WARNING;
}