Plugin Methods

/**
 * Webpack plugin interface method that hooks into webpack compilation process
 * This method is called automatically by webpack and should not be called directly
 * @param {object} compiler - Webpack compiler instance
 * @returns {void}
 */
apply(compiler: object): void;

/**
 * Validates if input object is a valid source map
 * Checks for required properties: version, sources, mappings
 * @param {any} input - Input object to validate
 * @returns {boolean} True if input is a valid source map structure
 */
static isSourceMap(input: any): boolean;

const sourceMapData = {
  version: 3,
  sources: ['input.js'],
  mappings: 'AAAA'
};

if (UglifyJsPlugin.isSourceMap(sourceMapData)) {
  console.log('Valid source map');
}

/**
 * Creates a SourceMapConsumer from input source map object
 * Returns null if input is invalid or cannot be processed
 * @param {object} inputSourceMap - Source map object to process
 * @returns {SourceMapConsumer | null} SourceMapConsumer instance or null
 */
static buildSourceMap(inputSourceMap: object): SourceMapConsumer | null;

const sourceMap = UglifyJsPlugin.buildSourceMap(inputSourceMap);
if (sourceMap) {
  // Use SourceMapConsumer for location mapping
  const originalPosition = sourceMap.originalPositionFor({
    line: 10,
    column: 5
  });
}

/**
 * Formats UglifyJS errors with enhanced location information using source maps
 * Creates detailed error messages with original source locations when available
 * @param {Error} err - UglifyJS error object containing line/col or stack info
 * @param {string} file - File path where the error occurred
 * @param {SourceMapConsumer} sourceMap - Source map for mapping to original locations
 * @param {RequestShortener} requestShortener - Webpack path shortener for clean paths
 * @returns {Error} Enhanced error with location details and context
 */
static buildError(
  err: Error,
  file: string,
  sourceMap: SourceMapConsumer,
  requestShortener: RequestShortener
): Error;

/**
 * Formats UglifyJS warnings with enhanced location information using source maps
 * Applies warning filters and creates user-friendly warning messages
 * @param {string} warning - UglifyJS warning message
 * @param {string} file - File path where the warning occurred
 * @param {SourceMapConsumer} sourceMap - Source map for mapping to original locations
 * @param {RequestShortener} requestShortener - Webpack path shortener for clean paths
 * @param {Function} warningsFilter - Function to determine if warning should be shown
 * @returns {string | null} Formatted warning message or null if filtered out
 */
static buildWarning(
  warning: string,
  file: string,
  sourceMap: SourceMapConsumer,
  requestShortener: RequestShortener,
  warningsFilter: Function
): string | null;

const warning = UglifyJsPlugin.buildWarning(
  'Dropping unreachable code [input.js:15,10]',
  'bundle.js',
  sourceMap,
  requestShortener,
  (warning, source) => !warning.includes('unreachable')
);

// Returns null if filtered, or formatted warning string