import { TSESLint } from '@typescript-eslint/utils'
import { CommonPartitionOptions } from '../types/common-partition-options.js'
import { NewlinesBetweenValueGetter } from './get-newlines-between-errors.js'
import { CommonGroupsOptions } from '../types/common-groups-options.js'
import { SortingNode } from '../types/sorting-node.js'
/**
 * Parameters for generating all types of fixes during sorting.
 *
 * @template T - Type of sorting node extending the base SortingNode.
 */
interface MakeFixesParameters<T extends SortingNode> {
  /**
   * Optional configuration for various sorting behaviors.
   */
  options?: Pick<CommonPartitionOptions, 'partitionByComment'> &
    CommonGroupsOptions<string, unknown, unknown>
  /**
   * Optional function to customize newlines between specific nodes.
   */
  newlinesBetweenValueGetter?: NewlinesBetweenValueGetter<T>
  /**
   * Whether to ignore the highest block comment for the first node. Useful
   * for preserving file-level documentation comments.
   */
  ignoreFirstNodeHighestBlockComment?: boolean
  /**
   * ESLint source code object for accessing comments and tokens.
   */
  sourceCode: TSESLint.SourceCode
  /**
   * Whether any comment-above configuration is missing its comment.
   */
  hasCommentAboveMissing: boolean
  /**
   * ESLint fixer object for creating fix operations.
   */
  fixer: TSESLint.RuleFixer
  /**
   * Array of nodes in their sorted order.
   */
  sortedNodes: T[]
  /**
   * Array of nodes in their original order.
   */
  nodes: T[]
}
/**
 * Orchestrates the generation of all necessary fixes for sorting operations.
 *
 * Coordinates different types of fixes in a specific priority order to ensure
 * proper code transformation:
 *
 * 1. Order fixes - Reorders the nodes themselves
 * 2. Comment-after fixes - Handles inline trailing comments (if needed)
 * 3. Newlines fixes - Adjusts spacing between groups (if configured)
 * 4. Comment-above fixes - Adds/removes separator comments (if only these are
 *    needed).
 *
 * The function returns early when higher-priority fixes are found, as applying
 * multiple fix types simultaneously could cause conflicts. This ensures that
 * each auto-fix operation focuses on one type of change at a time.
 *
 * Notes:
 *
 * - Order fixes replace node ranges; comment-after/newlines operate on inter-node
 *   ranges. They are designed not to overlap, but if ESLint discards
 *   overlapping replacements, a subsequent lint pass will apply the remaining
 *   fixes.
 * - Comment-above fixes are not combined with other fix types to avoid noisy
 *   changes; they are applied only when nothing else is pending.
 *
 * @example
 *
 * ```ts
 * // Configuration with groups and newlines
 * const fixes = makeFixes({
 *   nodes: originalNodes,
 *   sortedNodes: sortedNodes,
 *   options: {
 *     groups: ['imports', 'types', 'functions'],
 *     newlinesBetween: 1,
 *   },
 *   sourceCode,
 *   fixer,
 *   hasCommentAboveMissing: false,
 * })
 * // Returns order fixes if nodes need reordering
 * // Otherwise returns newlines fixes if spacing needs adjustment
 * // Otherwise returns empty array
 * ```
 *
 * @template T - Type of sorting node.
 * @param params - Parameters for generating fixes.
 * @returns Array of ESLint fix operations to apply, prioritized by type.
 */
export declare function makeFixes<T extends SortingNode>({
  ignoreFirstNodeHighestBlockComment,
  newlinesBetweenValueGetter,
  hasCommentAboveMissing,
  sortedNodes,
  sourceCode,
  options,
  fixer,
  nodes,
}: MakeFixesParameters<T>): TSESLint.RuleFix[]
export {}