feat: support experimental loader emitDiagnostic

[h-a-n-a]

Summary

closes #5913

Supported experimental loader API emitDiagnostic.

This works almost the same as emitError or emitWarning. But, it's for emitting rich-formatted diagnostics.

export interface DiagnosticLocation {
	/** Text for highlighting the location */
	text?: string;
	/** 1-based line */
	line: number;
	/** 0-based column in bytes */
	column: number;
	/** Length in bytes */
	length: number;
}

export interface Diagnostic {
	message: string;
	help?: string;
	sourceCode?: string;
	/**
	 * Location to the source code.
	 *
	 * If `sourceCode` is not provided, location will be omitted.
	 */
	location?: DiagnosticLocation;
	file?: string;
	severity: "error" | "warning";
}

interface LoaderExperiments {
	emitDiagnostic(diagnostic: Diagnostic): void;
}

Example

For loader:

/** @type {import("@rspack/core").LoaderDefinition} */
module.exports = function() {
	this.experiments.emitDiagnostic({
		message: "`React` is not defined",
		severity: "error",
		sourceCode: `<div></div>`,
		help: "try to import `React`",
		location: {
			line: 1,
			column: 1,
			length: 3,
		}
	});
	return ""
}

it outputs:

ERROR in (./with-help.js!) 1:1-4
  × ModuleError: `React` is not defined
   ╭────
 1 │ <div></div>
   ·  ───
   ╰────
  help: try to import `React`

Note: This is an experimental API and is rspack-specific.

Checklist

• Tests updated (or not required).
• Documentation updated (or not required).

[netlify]

✅ Deploy Preview for rspack canceled.

Name	Link
🔨 Latest commit	cbc2c1d
🔍 Latest deploy log	https://app.netlify.com/sites/rspack/deploys/66ec0b2fda3e320008af261a

[hardfist]

LGTM, waiting for @colinaaa's feedback on this

[colinaaa]

It looks great to me! Thank you @h-a-n-a @hardfist