/**
 * All of the deprecation types currently used by Sass.
 *
 * Any of these IDs or the deprecation objects they point to can be passed to
 * `fatalDeprecations`, `futureDeprecations`, or `silenceDeprecations`.
 *
 * @category Messages
 */
export interface Deprecations {
  // START AUTOGENERATED LIST
  // Checksum: 2c5800a683ec3b36c9e8d7f6eb427466b7439461

  /**
   * Deprecation for passing a string directly to meta.call().
   *
   * This deprecation was active in the first version of Dart Sass.
   */
  'call-string': Deprecation<'call-string'>;

  /**
   * Deprecation for @elseif.
   *
   * This deprecation became active in Dart Sass 1.3.2.
   */
  elseif: Deprecation<'elseif'>;

  /**
   * Deprecation for @-moz-document.
   *
   * This deprecation became active in Dart Sass 1.7.2.
   */
  'moz-document': Deprecation<'moz-document'>;

  /**
   * Deprecation for imports using relative canonical URLs.
   *
   * This deprecation became active in Dart Sass 1.14.2.
   */
  'relative-canonical': Deprecation<'relative-canonical'>;

  /**
   * Deprecation for declaring new variables with !global.
   *
   * This deprecation became active in Dart Sass 1.17.2.
   */
  'new-global': Deprecation<'new-global'>;

  /**
   * Deprecation for using color module functions in place of plain CSS functions.
   *
   * This deprecation became active in Dart Sass 1.23.0.
   */
  'color-module-compat': Deprecation<'color-module-compat'>;

  /**
   * Deprecation for / operator for division.
   *
   * This deprecation became active in Dart Sass 1.33.0.
   */
  'slash-div': Deprecation<'slash-div'>;

  /**
   * Deprecation for leading, trailing, and repeated combinators.
   *
   * This deprecation became active in Dart Sass 1.54.0.
   */
  'bogus-combinators': Deprecation<'bogus-combinators'>;

  /**
   * Deprecation for ambiguous + and - operators.
   *
   * This deprecation became active in Dart Sass 1.55.0.
   */
  'strict-unary': Deprecation<'strict-unary'>;

  /**
   * Deprecation for passing invalid units to built-in functions.
   *
   * This deprecation became active in Dart Sass 1.56.0.
   */
  'function-units': Deprecation<'function-units'>;

  /**
   * Deprecation for using !default or !global multiple times for one variable.
   *
   * This deprecation became active in Dart Sass 1.62.0.
   */
  'duplicate-var-flags': Deprecation<'duplicate-var-flags'>;

  /**
   * Deprecation for passing null as alpha in the JS API.
   *
   * This deprecation became active in Dart Sass 1.62.3.
   */
  'null-alpha': Deprecation<'null-alpha'>;

  /**
   * Deprecation for passing percentages to the Sass abs() function.
   *
   * This deprecation became active in Dart Sass 1.65.0.
   */
  'abs-percent': Deprecation<'abs-percent'>;

  /**
   * Deprecation for using the current working directory as an implicit load path.
   *
   * This deprecation became active in Dart Sass 1.73.0.
   */
  'fs-importer-cwd': Deprecation<'fs-importer-cwd'>;

  /**
   * Deprecation for function and mixin names beginning with --.
   *
   * This deprecation became active in Dart Sass 1.76.0.
   * It became obsolete in Dart Sass 1.94.0.
   */
  'css-function-mixin': Deprecation<'css-function-mixin'>;

  /**
   * Deprecation for declarations after or between nested rules.
   *
   * This deprecation became active in Dart Sass 1.77.7.
   * It became obsolete in Dart Sass 1.92.0.
   */
  'mixed-decls': Deprecation<'mixed-decls'>;

  /**
   * Deprecation for meta.feature-exists
   *
   * This deprecation became active in Dart Sass 1.78.0.
   */
  'feature-exists': Deprecation<'feature-exists'>;

  /**
   * Deprecation for certain uses of built-in sass:color functions.
   *
   * This deprecation became active in Dart Sass 1.79.0.
   */
  'color-4-api': Deprecation<'color-4-api'>;

  /**
   * Deprecation for using global color functions instead of sass:color.
   *
   * This deprecation became active in Dart Sass 1.79.0.
   */
  'color-functions': Deprecation<'color-functions'>;

  /**
   * Deprecation for legacy JS API.
   *
   * This deprecation became active in Dart Sass 1.79.0.
   */
  'legacy-js-api': Deprecation<'legacy-js-api'>;

  /**
   * Deprecation for @import rules.
   *
   * This deprecation became active in Dart Sass 1.80.0.
   */
  import: Deprecation<'import'>;

  /**
   * Deprecation for global built-in functions that are available in sass: modules.
   *
   * This deprecation became active in Dart Sass 1.80.0.
   */
  'global-builtin': Deprecation<'global-builtin'>;

  /**
   * Deprecation for functions named "type".
   *
   * This deprecation became active in Dart Sass 1.86.0.
   * It became obsolete in Dart Sass 1.92.0.
   */
  'type-function': Deprecation<'type-function'>;

  /**
   * Deprecation for passing a relative url to compileString().
   *
   * This deprecation became active in Dart Sass 1.88.0.
   */
  'compile-string-relative-url': Deprecation<'compile-string-relative-url'>;

  /**
   * Deprecation for a rest parameter before a positional or named parameter.
   *
   * This deprecation became active in Dart Sass 1.91.0.
   */
  'misplaced-rest': Deprecation<'misplaced-rest'>;

  /**
   * Deprecation for configuring private variables in @use, @forward, or load-css().
   *
   * This deprecation became active in Dart Sass 1.92.0.
   */
  'with-private': Deprecation<'with-private'>;

  /**
   * Deprecation for the Sass if($condition, $if-true, $if-false) function.
   *
   * This deprecation became active in Dart Sass 1.95.0.
   */
  'if-function': Deprecation<'if-function'>;

  /**
   * Deprecation for uppercase reserved function names.
   *
   * This deprecation became active in Dart Sass 1.98.0.
   */
  'function-name': Deprecation<'function-name'>;

  /**
   * Deprecation for adjacent compound selectors like `[class]a`.
   *
   * This deprecation became active in Dart Sass 1.100.0.
   */
  'adjacent-compounds': Deprecation<'adjacent-compounds'>;

  /**
   * Deprecation for selecting versions beyond the current one for `fatalDeprecations`.
   *
   * This deprecation became active in Dart Sass 1.107.0.
   */
  'deprecation-version': Deprecation<'deprecation-version'>;

  // END AUTOGENERATED LIST

  /**
   * Used for any user-emitted deprecation warnings.
   */
  'user-authored': Deprecation<'user-authored', 'user'>;
}

/**
 * A value that selects a set of {@link Deprecation}s.
 *
 * * {@link DeprecationOrId} selects a single deprecation.
 * * `Version` selects all deprecations that were present in that version of the
 *   current Sass implementation. The version must be less than or equal to the
 *   version of the library being used.
 * * `DeprecationSelector[]` selects all deprecations selected by any of the
 *   listed selectors.
 * * {@link DeprecationSelectorDifference} selects all deprecations matched by a
 *   `DeprecationSelector` *other than* a list of specific deprecations.
 *
 * @category Messages
 */
export type DeprecationSelector =
  | DeprecationOrId
  | Version
  | DeprecationSelectorDifference
  | DeprecationSelector[];

/**
 * Either a deprecation or its ID, either of which can be passed to any of
 * the relevant compiler options.
 *
 * @category Messages
 * @compatibility dart: "1.74.0", node: false
 */
export type DeprecationOrId = Deprecation | keyof Deprecations;

/**
 * An object that selects all deprecations selected by a
 * {@link DeprecationSelector} other than a specific list of excluded
 * deprecations.
 *
 * @category Messages
 * @compatibility dart: "1.106.0", node: false
 */
export interface DeprecationSelectorDifference {
  /** The selected deprecations this, unless excluded by {@link exclude}. */
  include: DeprecationSelector;

  /**
   * Deprecations that are *not* selected.
   *
   * These deprecations must be selected by {@link include}.
   */
  exclude: DeprecationOrId | DeprecationOrId[];
}

/**
 * The possible statuses that each deprecation can have.
 *
 * * "active" deprecations are currently emitting deprecation warnings.
 * * "future" deprecations are not yet active, but will be in the future.
 * * "obsolete" deprecations were once active, but no longer are.
 *
 * The only "user" deprecation is "user-authored", which is used for deprecation
 * warnings coming from user code.
 *
 * @category Messages
 * @compatibility dart: "1.74.0", node: false
 */
export type DeprecationStatus = 'active' | 'user' | 'future' | 'obsolete';

/**
 * A deprecated feature in the language.
 *
 * @category Messages
 * @compatibility dart: "1.74.0", node: false
 */
export interface Deprecation<
  id extends keyof Deprecations = keyof Deprecations,
  status extends DeprecationStatus = DeprecationStatus
> {
  /** The unique ID of this deprecation. */
  id: id;

  /** The current status of this deprecation. */
  status: status;

  /** A human-readable description of this deprecation. */
  description?: string;

  /** The version this deprecation first became active in. */
  deprecatedIn: status extends 'future' | 'user' ? null : Version;

  /** The version this deprecation became obsolete in. */
  obsoleteIn: status extends 'obsolete' ? Version : null;
}

/**
 * A semantic version of the compiler.
 *
 * @category Messages
 * @compatibility dart: "1.74.0", node: false
 */
export class Version {
  /**
   * Constructs a new version.
   *
   * All components must be non-negative integers.
   *
   * @param major - The major version.
   * @param minor - The minor version.
   * @param patch - The patch version.
   */
  constructor(major: number, minor: number, patch: number);
  readonly major: number;
  readonly minor: number;
  readonly patch: number;

  /**
   * Parses a version from a string.
   *
   * This throws an error if a valid version can't be parsed.
   *
   * @param version - A string in the form "major.minor.patch".
   */
  static parse(version: string): Version;
}

/**
 * Additional, non-deprecation properties available on the {@link deprecations}
 * property.
 *
 * Due to TypeScript constraints, these must be declared separately to avoid
 * violating the `Record` type. All of these fields are non-enumerable so it's
 * still safe to iterate over all deprecations.
 *
 * @category Messages
 * @compatibility dart: "1.106.0", node: false
 */
export interface DeprecationsUtil {
  /** Selects all deprecations that will become errors in Dart Sass 2.0.0. */
  dartSass2: DeprecationSelector;
}

/**
 * An object containing all deprecation types.
 *
 * @category Messages
 * @compatibility dart: "1.74.0", node: false
 */
export const deprecations: Deprecations & DeprecationsUtil;