* Updates Dependencies

* Uses webpack to bundle runtime library into a single file
* Inject the entire file into the Debugee
* Register runtime helpers (hediet_dbgVis)

data-extraction/src/js/api/DataExtractorApi.ts

@@ -0,0 +1,89 @@
+import {
+	ExtractedData,
+	DataExtractionResult,
+} from "../../DataExtractionResult";
+
+export interface DataExtractorApi {
+	/**
+	 * Registers a single extractor.
+	 */
+	registerExtractor<TExtractedData extends ExtractedData>(
+		extractor: DataExtractor<TExtractedData>
+	): void;
+
+	/**
+	 * Registers multiple extractors.
+	 */
+	registerExtractors(extractors: DataExtractor<ExtractedData>[]): void;
+
+	/**
+	 * Extracts data from `value`.
+	 */
+	getData(
+		value: unknown,
+		evalFn: <T>(expression: string) => T,
+		preferredDataExtractorId: string | undefined
+	): JSONString<DataResult>;
+
+	/**
+	 * Registers all default (built-in) extractors.
+	 * @preferExisting if `true`, existing extractors with the same id are not overwritten.
+	 */
+	registerDefaultExtractors(preferExisting?: boolean): void;
+}
+
+export type DataResult =
+	| {
+			kind: "Data";
+			extractionResult: DataExtractionResult;
+	  }
+	| { kind: "NoExtractors" }
+	| { kind: "Error"; message: string };
+
+export interface JSONString<T> extends String {
+	__brand: { json: T };
+}
+
+export interface DataExtractor<T extends ExtractedData> {
+	/**
+	 * Must be unique among all data extractors.
+	 */
+	id: string;
+	getExtractions(
+		data: unknown,
+		extractionCollector: ExtractionCollector<T>,
+		context: DataExtractorContext
+	): void;
+}
+
+export interface ExtractionCollector<T extends ExtractedData> {
+	/**
+	 * Suggests a possible extraction.
+	 */
+	addExtraction(extraction: DataExtraction<T>): void;
+}
+
+export interface DataExtractorContext {
+	/**
+	 * Evaluates an expression in the context of the active stack frame.
+	 */
+	evalFn: <TEval>(expression: string) => TEval;
+}
+
+export interface DataExtraction<TData extends ExtractedData> {
+	/**
+	 * Higher priorities are preferred.
+	 */
+	priority: number;
+
+	/**
+	 * A unique id identifying this extraction among all extractions.
+	 * Required to express extraction preferences.
+	 */
+	id: string;
+	/**
+	 * A user friendly name of this extraction.
+	 */
+	name: string;
+	extractData(): TData;
+}