@skmtc/core 0.0.940 → 0.0.942

package/script/context/RenderContext.d.ts

@@ -3,12 +3,12 @@ import type { FilesRenderResult, RenderResult } from './generateTypes.js';
 import type { Definition } from '../dsl/Definition.js';
 import type { PickArgs } from './generateTypes.js';
 import type { ResultType } from '../types/Results.js';
-import type { StackTrail } from './StackTrail.js';
 import type * as log from '../deps/jsr.io/@std/log/0.224.14/mod.js';
 import type { Logger } from '../types/Logger.js';
 import { File } from '../dsl/File.js';
 import type { Preview, Mapping } from '../types/Preview.js';
 import type { JsonFile } from '../dsl/JsonFile.js';
+import type { StackTrail } from './StackTrail.js';
 /**
  * Constructor arguments for {@link RenderContext}.
  */
@@ -23,189 +23,11 @@ type ConstructorArgs = {
     prettierConfig?: PrettierConfigType;
     /** Base path for resolving file paths */
     basePath: string | undefined;
-    /** Stack trail for distributed tracing */
-    stackTrail: StackTrail;
     /** Logger instance for debug information */
     logger: log.Logger;
     /** Function to capture result status */
-    captureCurrentResult: (result: ResultType) => void;
+    captureCurrentResult: (result: ResultType, stackTrail: StackTrail) => void;
 };
-/**
- * The rendering context for the final phase of the SKMTC transformation pipeline.
- *
- * `RenderContext` is responsible for taking the generated artifacts from the generation
- * phase and rendering them into their final form with proper formatting, path resolution,
- * and file preparation. It handles code formatting via Biome, path normalization,
- * and produces the final artifacts ready for writing to the filesystem.
- *
- * This context represents the culmination of the three-phase SKMTC pipeline, transforming
- * generator outputs into production-ready code files with proper formatting and structure.
- *
- * ## Key Features
- *
- * - **Code Formatting**: Automatic Biome formatting for generated TypeScript/JavaScript code
- * - **Path Resolution**: Intelligent path resolution with base path support
- * - **Content Collation**: Combines all generated content into organized file structures
- * - **Metadata Generation**: Tracks file statistics (lines, characters) and relationships
- * - **Performance Monitoring**: Built-in tracing and performance measurement
- *
- * @example Basic rendering usage
- * ```typescript
- * import { RenderContext } from '@skmtc/core';
- *
- * const renderContext = new RenderContext({
- *   files: generatedFiles,
- *   previews: previewData,
- *   mappings: mappingData,
- *   prettierConfig: {
- *     semi: false,
- *     singleQuote: true,
- *     trailingComma: 'all'
- *   },
- *   basePath: './src/generated',
- *   stackTrail: traceStack,
- *   logger: myLogger,
- *   captureCurrentResult: (result) => console.log(result)
- * });
- *
- * const rendered = await renderContext.render();
- *
- * // Access rendered files
- * Object.entries(rendered.artifacts).forEach(([path, content]) => {
- *   console.log(`Rendered ${path}: ${rendered.files[path].lines} lines`);
- *   // Write to filesystem
- *   await Deno.writeTextFile(path, content);
- * });
- * ```
- *
- * @example With custom formatter configuration
- * ```typescript
- * const renderContext = new RenderContext({
- *   files: generatedFiles,
- *   previews: {},
- *   mappings: {},
- *   prettierConfig: {
- *     printWidth: 120,
- *     tabWidth: 2,
- *     semi: true,
- *     singleQuote: true,
- *     trailingComma: 'es5',
- *     bracketSpacing: true,
- *     arrowParens: 'avoid'
- *   },
- *   basePath: './packages/api-client/src',
- *   stackTrail: stack,
- *   logger: logger,
- *   captureCurrentResult: resultHandler
- * });
- *
- * const result = await renderContext.render();
- *
- * // All TypeScript files are automatically formatted
- * console.log('Formatted files:', Object.keys(result.artifacts).length);
- * ```
- *
- * @example Processing render results
- * ```typescript
- * const rendered = await renderContext.render();
- *
- * // Analyze file statistics
- * const totalLines = Object.values(rendered.files)
- *   .reduce((sum, file) => sum + file.lines, 0);
- * const totalChars = Object.values(rendered.files)
- *   .reduce((sum, file) => sum + file.characters, 0);
- *
- * console.log(`Generated ${Object.keys(rendered.artifacts).length} files`);
- * console.log(`Total lines: ${totalLines}`);
- * console.log(`Total characters: ${totalChars}`);
- *
- * // Check for large files
- * const largeFiles = Object.entries(rendered.files)
- *   .filter(([_, metadata]) => metadata.lines > 1000)
- *   .map(([path, metadata]) => ({ path, lines: metadata.lines }));
- *
- * if (largeFiles.length > 0) {
- *   console.log('Large files detected:', largeFiles);
- * }
- *
- * // Access preview and mapping data
- * console.log('Previews available:', Object.keys(rendered.previews));
- * console.log('Mappings available:', Object.keys(rendered.mappings));
- * ```
- *
- * @example Integration with CoreContext
- * ```typescript
- * // Typically used within CoreContext.toArtifacts()
- * class CustomCoreContext extends CoreContext {
- *   async renderWithPostProcessing(
- *     files: Map<string, File | JsonFile>,
- *     previews: Record<string, Record<string, Preview>>,
- *     mappings: Record<string, Record<string, Mapping>>
- *   ) {
- *     const renderContext = new RenderContext({
- *       files,
- *       previews,
- *       mappings,
- *       prettierConfig: this.prettierConfig,
- *       basePath: this.settings?.basePath,
- *       stackTrail: this.stackTrail,
- *       logger: this.logger,
- *       captureCurrentResult: this.captureCurrentResult.bind(this)
- *     });
- *
- *     const rendered = await renderContext.render();
- *
- *     // Post-process rendered files
- *     const processedArtifacts: Record<string, string> = {};
- *
- *     for (const [path, content] of Object.entries(rendered.artifacts)) {
- *       // Add file headers, license notices, etc.
- *       const processedContent = this.addFileHeader(content, path);
- *       processedArtifacts[path] = processedContent;
- *     }
- *
- *     return {
- *       ...rendered,
- *       artifacts: processedArtifacts
- *     };
- *   }
- * }
- * ```
- *
- * @example Error handling during rendering
- * ```typescript
- * try {
- *   const renderContext = new RenderContext({
- *     files: generatedFiles,
- *     previews: {},
- *     mappings: {},
- *     prettierConfig: prettierConfig,
- *     basePath: './invalid-path', // This might cause issues
- *     stackTrail: stack,
- *     logger: logger,
- *     captureCurrentResult: (result) => {
- *       if (result === 'error') {
- *         console.error('Render error detected');
- *       }
- *     }
- *   });
- *
- *   const result = await renderContext.render();
- *
- *   // Check if any files failed to render
- *   const failedFiles = Object.entries(result.files)
- *     .filter(([path, metadata]) => metadata.lines === 0)
- *     .map(([path]) => path);
- *
- *   if (failedFiles.length > 0) {
- *     console.warn('Files with no content:', failedFiles);
- *   }
- *
- * } catch (error) {
- *   console.error('Render operation failed:', error);
- * }
- * ```
- */
 export declare class RenderContext {
     #private;
     /** Map of generated files to render */
@@ -219,7 +41,7 @@ export declare class RenderContext {
     /** Logger instance for debug information */
     logger: Logger;
     /** Function to capture result status */
-    captureCurrentResult: (result: ResultType) => void;
+    captureCurrentResult: (result: ResultType, stackTrail: StackTrail) => void;
     /**
      * Creates a new RenderContext instance with the specified configuration.
      *
@@ -228,7 +50,7 @@ export declare class RenderContext {
      *
      * @param args - Constructor arguments containing all required configuration
      */
-    constructor({ files, previews, mappings, prettierConfig, basePath, logger, stackTrail, captureCurrentResult }: ConstructorArgs);
+    constructor({ files, previews, mappings, prettierConfig, basePath, logger, captureCurrentResult }: ConstructorArgs);
     /**
      * Renders all files in the context to their final formatted form.
      *
@@ -260,7 +82,7 @@ export declare class RenderContext {
      * });
      * ```
      */
-    render(): Omit<RenderResult, 'results'>;
+    render(stackTrail: StackTrail): Omit<RenderResult, 'results'>;
     /**
      * Collates all files in the context into a unified render result.
      *
@@ -288,32 +110,7 @@ export declare class RenderContext {
      * console.log(collated.files['/path/to/file.ts'].characters);
      * ```
      */
-    collate(): FilesRenderResult;
-    /**
-     * Executes a function within a tracing context for performance monitoring.
-     *
-     * This method wraps function execution with distributed tracing capabilities,
-     * allowing performance monitoring and debugging of the rendering pipeline.
-     * It integrates with the stack trail to provide hierarchical tracing.
-     *
-     * @template T - The return type of the traced function
-     * @param token - Trace identifier (string or array of strings)
-     * @param fn - Function to execute within the trace context
-     * @returns The result of executing the traced function
-     *
-     * @example
-     * ```typescript
-     * const result = renderContext.trace('format-file', () => {
-     *   return biome.formatContent(projectKey, content, { filePath: 'file.ts' });
-     * });
-     *
-     * // With hierarchical tracing
-     * const result = renderContext.trace(['render', 'format'], () => {
-     *   return complexFormattingOperation();
-     * });
-     * ```
-     */
-    trace<T>(token: string, fn: () => T): T;
+    collate(stackTrail: StackTrail): FilesRenderResult;
     /**
      * Retrieves a file from the context by its normalized path.
      *

package/script/context/RenderContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderContext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderContext.ts"],"names":[],"mappings":"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"}

package/script/context/RenderContext.js

@@ -13,190 +13,13 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _RenderContext_prettierConfig, _RenderContext_stackTrail;
+var _RenderContext_prettierConfig;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RenderContext = void 0;
 const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
 const normalize_js_1 = require("../deps/jsr.io/@std/path/1.1.2/normalize.js");
 const toResolvedArtifactPath_js_1 = require("../helpers/toResolvedArtifactPath.js");
-const tracer_js_1 = require("../helpers/tracer.js");
 const File_js_1 = require("../dsl/File.js");
-/**
- * The rendering context for the final phase of the SKMTC transformation pipeline.
- *
- * `RenderContext` is responsible for taking the generated artifacts from the generation
- * phase and rendering them into their final form with proper formatting, path resolution,
- * and file preparation. It handles code formatting via Biome, path normalization,
- * and produces the final artifacts ready for writing to the filesystem.
- *
- * This context represents the culmination of the three-phase SKMTC pipeline, transforming
- * generator outputs into production-ready code files with proper formatting and structure.
- *
- * ## Key Features
- *
- * - **Code Formatting**: Automatic Biome formatting for generated TypeScript/JavaScript code
- * - **Path Resolution**: Intelligent path resolution with base path support
- * - **Content Collation**: Combines all generated content into organized file structures
- * - **Metadata Generation**: Tracks file statistics (lines, characters) and relationships
- * - **Performance Monitoring**: Built-in tracing and performance measurement
- *
- * @example Basic rendering usage
- * ```typescript
- * import { RenderContext } from '@skmtc/core';
- *
- * const renderContext = new RenderContext({
- *   files: generatedFiles,
- *   previews: previewData,
- *   mappings: mappingData,
- *   prettierConfig: {
- *     semi: false,
- *     singleQuote: true,
- *     trailingComma: 'all'
- *   },
- *   basePath: './src/generated',
- *   stackTrail: traceStack,
- *   logger: myLogger,
- *   captureCurrentResult: (result) => console.log(result)
- * });
- *
- * const rendered = await renderContext.render();
- *
- * // Access rendered files
- * Object.entries(rendered.artifacts).forEach(([path, content]) => {
- *   console.log(`Rendered ${path}: ${rendered.files[path].lines} lines`);
- *   // Write to filesystem
- *   await Deno.writeTextFile(path, content);
- * });
- * ```
- *
- * @example With custom formatter configuration
- * ```typescript
- * const renderContext = new RenderContext({
- *   files: generatedFiles,
- *   previews: {},
- *   mappings: {},
- *   prettierConfig: {
- *     printWidth: 120,
- *     tabWidth: 2,
- *     semi: true,
- *     singleQuote: true,
- *     trailingComma: 'es5',
- *     bracketSpacing: true,
- *     arrowParens: 'avoid'
- *   },
- *   basePath: './packages/api-client/src',
- *   stackTrail: stack,
- *   logger: logger,
- *   captureCurrentResult: resultHandler
- * });
- *
- * const result = await renderContext.render();
- *
- * // All TypeScript files are automatically formatted
- * console.log('Formatted files:', Object.keys(result.artifacts).length);
- * ```
- *
- * @example Processing render results
- * ```typescript
- * const rendered = await renderContext.render();
- *
- * // Analyze file statistics
- * const totalLines = Object.values(rendered.files)
- *   .reduce((sum, file) => sum + file.lines, 0);
- * const totalChars = Object.values(rendered.files)
- *   .reduce((sum, file) => sum + file.characters, 0);
- *
- * console.log(`Generated ${Object.keys(rendered.artifacts).length} files`);
- * console.log(`Total lines: ${totalLines}`);
- * console.log(`Total characters: ${totalChars}`);
- *
- * // Check for large files
- * const largeFiles = Object.entries(rendered.files)
- *   .filter(([_, metadata]) => metadata.lines > 1000)
- *   .map(([path, metadata]) => ({ path, lines: metadata.lines }));
- *
- * if (largeFiles.length > 0) {
- *   console.log('Large files detected:', largeFiles);
- * }
- *
- * // Access preview and mapping data
- * console.log('Previews available:', Object.keys(rendered.previews));
- * console.log('Mappings available:', Object.keys(rendered.mappings));
- * ```
- *
- * @example Integration with CoreContext
- * ```typescript
- * // Typically used within CoreContext.toArtifacts()
- * class CustomCoreContext extends CoreContext {
- *   async renderWithPostProcessing(
- *     files: Map<string, File | JsonFile>,
- *     previews: Record<string, Record<string, Preview>>,
- *     mappings: Record<string, Record<string, Mapping>>
- *   ) {
- *     const renderContext = new RenderContext({
- *       files,
- *       previews,
- *       mappings,
- *       prettierConfig: this.prettierConfig,
- *       basePath: this.settings?.basePath,
- *       stackTrail: this.stackTrail,
- *       logger: this.logger,
- *       captureCurrentResult: this.captureCurrentResult.bind(this)
- *     });
- *
- *     const rendered = await renderContext.render();
- *
- *     // Post-process rendered files
- *     const processedArtifacts: Record<string, string> = {};
- *
- *     for (const [path, content] of Object.entries(rendered.artifacts)) {
- *       // Add file headers, license notices, etc.
- *       const processedContent = this.addFileHeader(content, path);
- *       processedArtifacts[path] = processedContent;
- *     }
- *
- *     return {
- *       ...rendered,
- *       artifacts: processedArtifacts
- *     };
- *   }
- * }
- * ```
- *
- * @example Error handling during rendering
- * ```typescript
- * try {
- *   const renderContext = new RenderContext({
- *     files: generatedFiles,
- *     previews: {},
- *     mappings: {},
- *     prettierConfig: prettierConfig,
- *     basePath: './invalid-path', // This might cause issues
- *     stackTrail: stack,
- *     logger: logger,
- *     captureCurrentResult: (result) => {
- *       if (result === 'error') {
- *         console.error('Render error detected');
- *       }
- *     }
- *   });
- *
- *   const result = await renderContext.render();
- *
- *   // Check if any files failed to render
- *   const failedFiles = Object.entries(result.files)
- *     .filter(([path, metadata]) => metadata.lines === 0)
- *     .map(([path]) => path);
- *
- *   if (failedFiles.length > 0) {
- *     console.warn('Files with no content:', failedFiles);
- *   }
- *
- * } catch (error) {
- *   console.error('Render operation failed:', error);
- * }
- * ```
- */
 class RenderContext {
     /**
      * Creates a new RenderContext instance with the specified configuration.
@@ -206,7 +29,7 @@ class RenderContext {
      *
      * @param args - Constructor arguments containing all required configuration
      */
-    constructor({ files, previews, mappings, prettierConfig, basePath, logger, stackTrail, captureCurrentResult }) {
+    constructor({ files, previews, mappings, prettierConfig, basePath, logger, captureCurrentResult }) {
         /** Map of generated files to render */
         Object.defineProperty(this, "files", {
             enumerable: true,
@@ -244,8 +67,6 @@ class RenderContext {
             writable: true,
             value: void 0
         });
-        /** Stack trail for distributed tracing */
-        _RenderContext_stackTrail.set(this, void 0);
         /** Function to capture result status */
         Object.defineProperty(this, "captureCurrentResult", {
             enumerable: true,
@@ -259,7 +80,6 @@ class RenderContext {
         __classPrivateFieldSet(this, _RenderContext_prettierConfig, prettierConfig, "f");
         this.basePath = basePath;
         this.logger = logger;
-        __classPrivateFieldSet(this, _RenderContext_stackTrail, stackTrail, "f");
         this.captureCurrentResult = captureCurrentResult;
     }
     /**
@@ -293,8 +113,8 @@ class RenderContext {
      * });
      * ```
      */
-    render() {
-        const result = this.collate();
+    render(stackTrail) {
+        const result = this.collate(stackTrail);
         const rendered = {
             artifacts: result.artifacts,
             files: result.files,
@@ -330,18 +150,18 @@ class RenderContext {
      * console.log(collated.files['/path/to/file.ts'].characters);
      * ```
      */
-    collate() {
+    collate(stackTrail) {
         const fileEntries = Array.from(this.files.entries());
         const fileObjects = fileEntries
             .map(([destinationPath, file]) => {
-            return this.trace(destinationPath, () => {
+            return stackTrail.trace(destinationPath, st => {
                 const renderedFile = renderFile({
                     content: file.toString(),
                     destinationPath,
                     basePath: this.basePath,
                     prettierConfig: __classPrivateFieldGet(this, _RenderContext_prettierConfig, "f")
                 });
-                this.captureCurrentResult('success');
+                this.captureCurrentResult('success', st);
                 return renderedFile;
             });
         })
@@ -360,33 +180,6 @@ class RenderContext {
         }
         return output;
     }
-    /**
-     * Executes a function within a tracing context for performance monitoring.
-     *
-     * This method wraps function execution with distributed tracing capabilities,
-     * allowing performance monitoring and debugging of the rendering pipeline.
-     * It integrates with the stack trail to provide hierarchical tracing.
-     *
-     * @template T - The return type of the traced function
-     * @param token - Trace identifier (string or array of strings)
-     * @param fn - Function to execute within the trace context
-     * @returns The result of executing the traced function
-     *
-     * @example
-     * ```typescript
-     * const result = renderContext.trace('format-file', () => {
-     *   return biome.formatContent(projectKey, content, { filePath: 'file.ts' });
-     * });
-     *
-     * // With hierarchical tracing
-     * const result = renderContext.trace(['render', 'format'], () => {
-     *   return complexFormattingOperation();
-     * });
-     * ```
-     */
-    trace(token, fn) {
-        return (0, tracer_js_1.tracer)(__classPrivateFieldGet(this, _RenderContext_stackTrail, "f"), token, fn);
-    }
     /**
      * Retrieves a file from the context by its normalized path.
      *
@@ -452,7 +245,7 @@ class RenderContext {
     }
 }
 exports.RenderContext = RenderContext;
-_RenderContext_prettierConfig = new WeakMap(), _RenderContext_stackTrail = new WeakMap();
+_RenderContext_prettierConfig = new WeakMap();
 /**
  * Renders a single file with formatting and metadata calculation.
  *

package/script/context/ResultsHandler.d.ts

@@ -17,73 +17,6 @@ export interface ResultsHandlerOptions {
     /** Formatter function for log messages */
     formatter?: (logRecord: LogRecord) => string;
 }
-/**
- * Custom log handler that captures warning and error results for SKMTC processing.
- *
- * The `ResultsHandler` extends Deno's standard library BaseHandler to provide
- * specialized logging behavior for the SKMTC pipeline. It integrates with the
- * CoreContext to capture warnings and errors as structured results that can be
- * analyzed and reported after processing completes.
- *
- * This handler ensures that important processing issues are captured and stored
- * in the context's results system rather than just being logged to the console.
- *
- * ## Key Features
- *
- * - **Result Capture**: Automatically captures WARN and ERROR logs as results
- * - **Immediate Flushing**: Critical errors trigger immediate flush
- * - **Lifecycle Management**: Proper setup and cleanup with event handlers
- * - **Context Integration**: Seamlessly integrates with CoreContext results system
- *
- * @example Setting up the handler
- * ```typescript
- * import { getLogger } from '@std/log';
- * import { ResultsHandler, CoreContext } from '@skmtc/core';
- *
- * const context = new CoreContext({
- *   // ... context options
- * });
- *
- * const handler = new ResultsHandler('WARN', {
- *   context: context,
- *   formatter: '[{levelName}] {msg}'
- * });
- *
- * const logger = getLogger();
- * logger.addHandler(handler);
- *
- * // Now warnings and errors will be captured as results
- * logger.warning('Schema validation issue detected');
- * logger.error('Failed to process operation');
- * ```
- *
- * @example Integration in pipeline
- * ```typescript
- * class ProcessingPipeline {
- *   async process(document: OasDocument) {
- *     const context = new CoreContext(options);
- *
- *     // Set up results handler
- *     const handler = new ResultsHandler('WARN', { context });
- *     const logger = getLogger();
- *     logger.addHandler(handler);
- *
- *     try {
- *       const result = await this.processDocument(document, context);
- *
- *       // Check captured results
- *       if (context.results.hasWarnings()) {
- *         console.log('Processing completed with warnings');
- *       }
- *
- *       return result;
- *     } finally {
- *       handler.destroy();
- *     }
- *   }
- * }
- * ```
- */
 export declare class ResultsHandler extends BaseHandler implements LogHandlerBase {
     #private;
     /** The CoreContext instance for capturing results */

package/script/context/ResultsHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResultsHandler.d.ts","sourceRoot":"","sources":["../../src/context/ResultsHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,4CAA4C,CAAA;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,OAAO,EAAE,WAAW,CAAA;IACpB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,MAAM,CAAA;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,qBAAa,cAAe,SAAQ,WAAY,YAAW,cAAc;;IACvE,qDAAqD;IACrD,OAAO,EAAE,WAAW,CAAA;IAOpB;;;;;;;;;;;;;;OAcG;gBACS,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,qBAAqB;IAMhE;;;;;;;OAOG;IACM,KAAK;IAMd;;;;;;;;;OASG;IACM,MAAM,CAAC,SAAS,EAAE,SAAS;IASpC;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM;IAWrB;;;;;;;OAOG;IACH,KAAK;IAWL;;;;;;;;;;;;;;;;;;;;;OAqBG;IACM,OAAO;CAKjB"}
+{"version":3,"file":"ResultsHandler.d.ts","sourceRoot":"","sources":["../../src/context/ResultsHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,4CAA4C,CAAA;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAInD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,OAAO,EAAE,WAAW,CAAA;IACpB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,MAAM,CAAA;CAC7C;AACD,qBAAa,cAAe,SAAQ,WAAY,YAAW,cAAc;;IACvE,qDAAqD;IACrD,OAAO,EAAE,WAAW,CAAA;IAOpB;;;;;;;;;;;;;;OAcG;gBACS,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,qBAAqB;IAMhE;;;;;;;OAOG;IACM,KAAK;IAMd;;;;;;;;;OASG;IACM,MAAM,CAAC,SAAS,EAAE,SAAS;IASpC;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM;IAYrB;;;;;;;OAOG;IACH,KAAK;IAWL;;;;;;;;;;;;;;;;;;;;;OAqBG;IACM,OAAO;CAKjB"}