@sdeverywhere/check-core 0.1.13 → 0.1.15

package/dist/index.d.cts

@@ -1,2184 +0,0 @@
-type SourceName = string;
-type VarId = string;
-type DatasetKey = string;
-type Dataset = Map<number, number>;
-type DatasetMap = Map<DatasetKey, Dataset>;
-
-/**
- * Specifies a constant override that will be applied when running the model.
- *
- * Unlike `InputSetting` (which works with pre-declared input variables that have
- * defined min/max ranges), constant overrides can modify ANY constant in the model
- * when the `customConstants` feature is enabled.
- */
-interface ConstantOverride {
-    /** The variable ID of the constant to be overridden. */
-    varId: VarId;
-    /** The new value for the constant. */
-    value: number;
-}
-/**
- * Specifies a lookup override that will be applied when running the model.
- *
- * The data provided here will override the default data in the generated model
- * for the lookup or data variable identified by `varId`.  When `points` is
- * undefined, any previously-applied override for that variable will be reset
- * back to its original data.
- *
- * Lookup overrides are only effective when the `customLookups` feature is
- * enabled in the bundle.
- */
-interface LookupOverride {
-    /** The variable ID of the lookup or data variable to be overridden. */
-    varId: VarId;
-    /**
-     * The lookup data as a flat array of (x,y) pairs.  If undefined, the lookup
-     * data will be reset to the original data.
-     */
-    points?: Float64Array;
-}
-/** A unique identifier for the scenario, derived from its input settings. */
-type ScenarioSpecUid = string;
-type InputPosition = 'at-default' | 'at-minimum' | 'at-maximum';
-interface PositionSetting {
-    kind: 'position';
-    inputVarId: VarId;
-    position: InputPosition;
-}
-interface ValueSetting {
-    kind: 'value';
-    inputVarId: VarId;
-    value: number;
-}
-type InputSetting = PositionSetting | ValueSetting;
-interface InputSettingsSpec {
-    kind: 'input-settings';
-    uid: ScenarioSpecUid;
-    settings: InputSetting[];
-}
-interface AllInputsSpec {
-    kind: 'all-inputs';
-    uid: ScenarioSpecUid;
-    position: InputPosition;
-}
-type ScenarioSpec = InputSettingsSpec | AllInputsSpec;
-
-interface DatasetsResult {
-    /**
-     * The map of datasets for the scenario.
-     */
-    datasetMap: DatasetMap;
-    /**
-     * The number of milliseconds that elapsed when running the model, or undefined if the model
-     * wasn't run for this scenario.
-     */
-    modelRunTime?: number;
-}
-/**
- * Options for the `getDatasetsForScenario` method.
- */
-interface GetDatasetsOptions {
-    /**
-     * If defined, override the values for the specified constant variables.
-     *
-     * Unlike input settings (which work with pre-declared input variables), constant
-     * overrides can modify ANY constant in the model when the `customConstants` feature
-     * is enabled.
-     *
-     * Note that constant overrides do NOT persist across `getDatasetsForScenario` calls.
-     * They must be provided each time you want to override constants.
-     */
-    constants?: ConstantOverride[];
-    /**
-     * If defined, override the data for the specified lookup or data variables.
-     *
-     * The data provided here will override the default data in the generated model
-     * for each variable identified by `varId`.  Lookup overrides are only effective
-     * when the `customLookups` feature is enabled in the bundle.
-     *
-     * Note that lookup overrides MAY OR MAY NOT persist across `getDatasetsForScenario`
-     * calls, depending on the underlying model/runtime implementation.  If you want to
-     * ensure that previously-applied lookup overrides do not take effect on subsequent
-     * runs, pass an undefined `points` array for the relevant variable to cause the
-     * lookup data to be reset to its original data.
-     */
-    lookups?: LookupOverride[];
-}
-interface DataSource {
-    /**
-     * Return the datasets that result from running the given scenario.
-     *
-     * @param scenarioSpec The scenario spec that defines the inputs for the model run.
-     * @param datasetKeys The keys of the datasets to be fetched.
-     * @param options Optional configuration including constant and lookup overrides.
-     */
-    getDatasetsForScenario(scenarioSpec: ScenarioSpec, datasetKeys: DatasetKey[], options?: GetDatasetsOptions): Promise<DatasetsResult>;
-}
-
-/**
- * Holds information about an item related to a variable used in the model.
- * For example, this can be used to attach information about a graph that
- * an output variable is used in, or a slider that controls an input variable.
- */
-interface RelatedItem {
-    id: string;
-    locationPath: string[];
-}
-/** A unique, stable input identifier. */
-type InputId = string;
-/**
- * Holds information about an input variable that is controlled by a continuous range/slider.
- */
-interface SliderInputVar {
-    /** Indicates that this input is controlled by a continuous range/slider. */
-    kind: 'slider';
-    /**
-     * A unique, stable identifier string for this input.
-     *
-     * This can be used to identify an input variable in a way that is resilient
-     * to the variable's name being changed between two versions of the model.
-     *
-     * For example, if both the "left" and "right" versions of the model have an
-     * input with an `inputId` of 2, but the variable is called "Variable 2" in
-     * the left and "Variable Two" in the right, the inputs can be correlated and
-     * compared despite the different variable names.
-     */
-    inputId: InputId;
-    /** The variable identifier (typically a simplified/canonical ID, like the form used in SDE). */
-    varId: VarId;
-    /** The full variable name as used in the modeling tool. */
-    varName: string;
-    /** The default value of the input. */
-    defaultValue: number;
-    /** The minimum value of the input. */
-    minValue: number;
-    /** The maximum value of the input. */
-    maxValue: number;
-    /** The metadata for the related input control. */
-    relatedItem?: RelatedItem;
-}
-/**
- * Holds information about an input variable that is controlled by a discrete on/off switch.
- */
-interface SwitchInputVar {
-    /** Indicates that this input is controlled by a discrete on/off switch. */
-    kind: 'switch';
-    /**
-     * A unique, stable identifier string for this input.
-     *
-     * This can be used to identify an input variable in a way that is resilient
-     * to the variable's name being changed between two versions of the model.
-     */
-    inputId: InputId;
-    /** The variable identifier (typically a simplified/canonical ID, like the form used in SDE). */
-    varId: VarId;
-    /** The full variable name as used in the modeling tool. */
-    varName: string;
-    /** The default value of the input. */
-    defaultValue: number;
-    /** The value of the variable when this switch is in an "off" state. */
-    offValue: number;
-    /** The value of the variable when this switch is in an "on" state. */
-    onValue: number;
-    /** The metadata for the related input control. */
-    relatedItem?: RelatedItem;
-}
-/**
- * Holds information about an input variable used in the model.  This is a discriminated
- * union; use the `kind` field to determine the underlying variant.
- */
-type InputVar = SliderInputVar | SwitchInputVar;
-/**
- * Holds information about an output variable used in the model.
- */
-interface OutputVar {
-    /** The unique dataset key for this variable (it should include `sourceName` and `varId`). */
-    datasetKey: DatasetKey;
-    /**
-     * The source for the variable (e.g., undefined for a normal model output, "Data" for a variable
-     * that is defined in an external data file).
-     */
-    sourceName?: SourceName;
-    /** The variable identifier (typically a simplified/canonical ID, like the form used in SDE). */
-    varId: VarId;
-    /** The full variable name as used in the modeling tool. */
-    varName: string;
-    /** The metadata for the related visuals/graphs in which this variable is used. */
-    relatedItems?: RelatedItem[];
-}
-/**
- * Holds information about a variable used in the model implementation.
- */
-interface ImplVar {
-    /** The variable identifier, as used in SDE. */
-    varId: VarId;
-    /** The variable name, as used in the modeling tool. */
-    varName: string;
-    /** The variable type (e.g. 'level', 'const'). */
-    varType: string;
-    /** The variable index, used to reference the value in the generated model. */
-    varIndex: number;
-    /** The subscript index values, used to reference the value in the generated model. */
-    subscriptIndices?: number[];
-}
-
-/** The human-readable name for a group of inputs. */
-type InputGroupName = string;
-/** The alias name for an input. */
-type InputAliasName = string;
-/** The name for a custom input setting group. */
-type InputSettingGroupId = string;
-/** The human-readable name for a group of datasets. */
-type DatasetGroupName = string;
-/**
- * Describes a group of implementation variables.
- */
-interface ImplVarGroup {
-    /** The group title. */
-    title: string;
-    /**
-     * The function name in the generated model that is associated with
-     * this group.  This can be used when displaying the group to change
-     * the appearance of the items in the section.
-     */
-    fn?: string;
-    /**
-     * The keys of the variables in this group (corresponding to the
-     * `implVars` map keys).  It is recommended to provide these in the
-     * order that the variables are evaluated in the generated model.
-     */
-    datasetKeys: DatasetKey[];
-}
-/**
- * Includes the properties needed to display a legend item in the UI.
- */
-interface LegendItem {
-    /** The item text. */
-    label: string;
-    /** The color of the item (in CSS/hex format). */
-    color: string;
-}
-/**
- * Includes the properties needed to display a link item in the UI.
- */
-interface LinkItem {
-    /** Whether content is a URL or text to be copied to the clipboard. */
-    kind: 'url' | 'copy';
-    /** The link text that appears in the UI. */
-    text: string;
-    /** The link content (a URL or text). */
-    content: string;
-}
-/** The identifier for a bundle-specific graph. */
-type BundleGraphId = string;
-/**
- * Describes a dataset in a bundle-specific graph.
- */
-interface BundleGraphDatasetSpec {
-    /** The dataset key. */
-    datasetKey: DatasetKey;
-    /** The dataset or variable name. */
-    varName: string;
-    /** The source name. */
-    sourceName?: string;
-    /** The label string (as it appears in the graph legend). */
-    label?: string;
-    /** The color of the plot (in CSS/hex format). */
-    color: string;
-}
-/**
- * Describes a bundle-specific graph.
- */
-interface BundleGraphSpec {
-    /** The graph identifier. */
-    id: BundleGraphId;
-    /** The graph title. */
-    title: string;
-    /** The legend items for the graph. */
-    legendItems: LegendItem[];
-    /** The datasets displayed in this graph. */
-    datasets: BundleGraphDatasetSpec[];
-    /** Metadata for the graph that can be used to diff to another graph. */
-    metadata: Map<string, string>;
-}
-/**
- * Options for configuring a bundle-specific graph view.
- */
-interface BundleGraphViewOptions {
-    /** Whether graph updates will be animated (default is false). */
-    animated?: boolean;
-    /** A hint that indicates the context in which the graph will be displayed. */
-    style?: 'thumbnail' | undefined;
-}
-/**
- * Allows for displaying a bundle-specific graph.
- */
-interface BundleGraphView {
-    /**
-     * Update the data that is displayed in the graph.
-     *
-     * @hidden This method is optional; it is not currently used by the report UI, but may be useful
-     * for other tools that want to display bundle-specific graphs.
-     *
-     * @param datasetMap The map of datasets that contain the data to be displayed in the graph.
-     */
-    updateData?(datasetMap: DatasetMap): void;
-    /** Destroy the underlying graph view and any associated resources. */
-    destroy(): void;
-}
-/**
- * Wrapper around data that can be used to initialize a graph view.
- */
-interface BundleGraphData {
-    /**
-     * Return a graph view that can be attached to the given parent element.  The returned
-     * `BundleGraphView` instance will already be configured to display the data that was
-     * fetched from the model for the associated scenario.
-     *
-     * @param parent The parent element to which the graph view will be attached.
-     * @returns A `BundleGraphView` instance.
-     */
-    createGraphView(parent: HTMLElement): BundleGraphView;
-}
-/**
- * Describes the model that is contained in this bundle.
- */
-interface ModelSpec {
-    /** The size of the model binary, in bytes. */
-    modelSizeInBytes: number;
-    /** The size of the static data, in bytes. */
-    dataSizeInBytes: number;
-    /** The map of all input variables in this version of the model. */
-    inputVars: Map<VarId, InputVar>;
-    /** The map of all output (and static data) variables in this version of the model. */
-    outputVars: Map<DatasetKey, OutputVar>;
-    /** The map of all variables (both internal and exported) in this version of the model. */
-    implVars: Map<DatasetKey, ImplVar>;
-    /** The groupings of internal/implementation variables in this version of the model. */
-    implVarGroups?: ImplVarGroup[];
-    /** The custom input variable aliases defined for this model. */
-    inputAliases?: Map<InputAliasName, VarId>;
-    /** The custom input variable groups defined for this model. */
-    inputGroups?: Map<InputGroupName, InputVar[]>;
-    /** The custom input setting groups defined for this model. */
-    inputSettingGroups?: Map<InputSettingGroupId, InputSetting[]>;
-    /** The custom dataset (output variable) groups defined for this model. */
-    datasetGroups?: Map<DatasetGroupName, DatasetKey[]>;
-    /** The start time (year) for the model. */
-    startTime?: number;
-    /** The end time (year) for the model. */
-    endTime?: number;
-    /** The specs for the bundled graphs. */
-    graphSpecs?: BundleGraphSpec[];
-}
-/**
- * An interface that allows for running the bundled model under different input scenarios
- * and capturing the resulting output data.
- */
-interface BundleModel extends DataSource {
-    /** The spec for the bundled model. */
-    modelSpec: ModelSpec;
-    /**
-     * Load the data used to display the graph by running the model with inputs
-     * configured for the given scenario.
-     *
-     * The returned `BundleGraphData` instance will contain the data associated with the
-     * given graph.  Calling the `createGraphView` method on the `BundleGraphData` instance
-     * will create a `BundleGraphView` that is already configured to display the data
-     * associated with the graph.
-     *
-     * This method is optional; if not implemented, custom graphs will not be displayed in
-     * the report UI.
-     *
-     * @param scenarioSpec The scenario spec that defines the inputs for the model run.
-     * @param graphId The identifier of the graph for which data will be loaded.
-     * @returns The graph data.
-     */
-    getGraphDataForScenario?(scenarioSpec: ScenarioSpec, graphId: BundleGraphId): Promise<BundleGraphData>;
-    /**
-     * Return the links to be displayed for the graph in the given scenario.
-     *
-     * This method is optional; if not implemented, no graph links will be displayed in the report UI.
-     *
-     * @param scenarioSpec The scenario spec that defines the inputs for the model run.
-     * @param graphId The identifier of the graph for which links will be prepared.
-     * @returns An array of `LinkItem` instances.
-     */
-    getGraphLinksForScenario?(scenarioSpec: ScenarioSpec, graphId: BundleGraphId): LinkItem[];
-    /**
-     * Return a graph view that is attached to the given element and that is prepared to display data
-     * for the given graph.
-     *
-     * Unlike `getGraphDataForScenario`, this method only creates the graph view.  The data for the
-     * graph must be provided separately by calling the `updateData` method on the `BundleGraphView`
-     * instance.
-     *
-     * @hidden This method is optional; it is not currently used by the report UI, but may be useful
-     * for other tools that want to display bundle-specific graphs.
-     *
-     * @param parent The parent element to which the graph view will be attached.
-     * @param graphId The identifier of the graph for which the graph view will be prepared.
-     * @param options Optional configuration for the graph view.
-     * @returns A `BundleGraphView` instance.
-     */
-    createGraphView?(parent: HTMLElement, graphId: BundleGraphId, options?: BundleGraphViewOptions): BundleGraphView;
-}
-/**
- * Provides access to the model that is contained in this bundle for use in
- * model-check packages.
- */
-interface Bundle {
-    /**
-     * The version of the bundle.  This should be incremented when there is an
-     * incompatible change to the bundle format.  The model-check tools can use
-     * this value to skip tests if two bundles have different version numbers.
-     */
-    version: number;
-    /** The spec for the bundled model. */
-    modelSpec: ModelSpec;
-    /** Asynchronously initialize the underlying model. */
-    initModel(): Promise<BundleModel>;
-}
-/**
- * Associates a name with a `Bundle`.
- */
-interface NamedBundle {
-    /** The name of the bundle, for example, "Current" or "Baseline". */
-    name: string;
-    /** The associated bundle. */
-    bundle: Bundle;
-}
-/**
- * Represents a bundle that has had its model instances initialized.
- */
-interface LoadedBundle {
-    /** The name of the bundle, for example, "Current" or "Baseline". */
-    name: string;
-    /** The version of the bundle. */
-    version: number;
-    /** The spec for the bundled model. */
-    modelSpec: ModelSpec;
-    /**
-     * The initialized model instances for this bundle.  If `concurrency` was specified
-     * in the config, then there will be that number of model instances in this array,
-     * otherwise there will be one instance.
-     */
-    models: BundleModel[];
-}
-
-/**
- * A terse representation of a subscript.
- */
-interface EncodedSubscript {
-    /** The subscript name (e.g., "Sub1"). */
-    n: string;
-    /** The subscript identifier (e.g., "_sub1"). */
-    i: string;
-}
-/**
- * A terse representation of a variable without subscripts.
- */
-interface EncodedVariable {
-    /** The variable name (corresponds to the base part of `ImplVar.varName` without subscripts). */
-    n: string;
-    /** The variable identifier (corresponds to the base part of `ImplVar.varId` without subscripts). */
-    i: string;
-    /** The variable index (corresponds to `ImplVar.varIndex`). */
-    x: number;
-}
-/**
- * A terse representation of a variable type.
- */
-type EncodedVarType = string;
-/**
- * A terse representation of a variable instance as a flat array.
- *
- * Format: [t, v, si0, si1, ..., sx0, sx1, ...]
- * - Element 0: The index of the associated `EncodedVarType` element in the `varTypes` array (corresponds to `ImplVar.varType`).
- * - Element 1: The index of the associated `EncodedVariable` element in the `variables` array.
- * - Elements 2+: If subscripts are present, first all subscript element indices, then all subscript indices:
- *   - Elements 2 to (2 + n - 1): The indices of the associated `EncodedSubscript` elements in the `subscripts` array.
- *   - Elements (2 + n) to (2 + 2n - 1): The subscript index values (corresponds to `ImplVar.subscriptIndices`).
- */
-type EncodedVarInstance = number[];
-/**
- * The encoded representation of impl variables that eliminates redundancy.
- */
-interface EncodedImplVars {
-    subscripts: EncodedSubscript[];
-    variables: EncodedVariable[];
-    varTypes: EncodedVarType[];
-    varInstances: {
-        [key: string]: EncodedVarInstance[];
-    };
-}
-/**
- * Encode impl variable metadata into a more efficient format.
- *
- * This is used to reduce the size of a bundle by eliminating redundancy in variable/subscript
- * names and identifiers.  The `varInstances` object in the model listing JSON generated by the
- * compiler includes verbose information for each variable instance.  This function puts that
- * information into a more efficient format that can be bundled as a normal JavaScript object
- * in the model-check bundle file, and then decoded and expandedwhen the bundle is loaded.
- *
- * @param input The input structure mapping keys to ImplVar arrays.
- * @returns The encoded representation.
- */
-declare function encodeImplVars(input: {
-    [key: string]: ImplVar[];
-}): EncodedImplVars;
-/**
- * Decode impl variables from the efficient format back to the original structure.
- *
- * @param encoded The encoded representation.
- * @returns The original structure mapping keys to `ImplVar` arrays.
- */
-declare function decodeImplVars(encoded: EncodedImplVars): {
-    [key: string]: ImplVar[];
-};
-
-interface CheckOptions {
-    /** The strings containing check tests in YAML format. */
-    tests: string[];
-}
-interface CheckConfig {
-    /** The loaded bundle being checked. */
-    bundle: LoadedBundle;
-    /** The strings containing check tests in YAML format. */
-    tests: string[];
-}
-
-type TaskKey = string;
-type TaskExecutorKey = string;
-interface BundleModels {
-    L?: BundleModel;
-    R: BundleModel;
-}
-/**
- * Base interface for all tasks in the unified system.
- */
-interface Task {
-    /** Unique key for this task instance. */
-    key: TaskKey;
-    /** The task kind. */
-    kind: string;
-    /** Process the task using the given models. */
-    process(models: BundleModels): Promise<void>;
-}
-/**
- * Executes a single task using a set of `BundleModel` instances.
- */
-interface TaskExecutor {
-    /**
-     * Execute the given task using the set of `BundleModel` instances
-     * associated with this executor.
-     *
-     * @param task The task to execute.
-     * @return A promise that resolves when the task is complete.
-     */
-    execute(task: Task): Promise<void>;
-}
-/**
- * A unified task queue that can process multiple kinds of tasks concurrently
- * while ensuring that BundleModel instances are never accessed concurrently.
- * This replaces the need for multiple separate TaskQueue instances.
- */
-declare class TaskQueue {
-    private readonly executors;
-    /** The single instance. */
-    private static instance;
-    /** The queue of task keys, most recent at front. */
-    private readonly taskKeyQueue;
-    /** The map of tasks. */
-    private readonly taskMap;
-    /** The idle event listeners. */
-    private readonly idleListeners;
-    /** Whether tasks are being processed. */
-    private processing;
-    /** Whether `shutdown` has been called. */
-    private stopped;
-    /**
-     * @param executors The map of available task executors.
-     */
-    constructor(executors: Map<TaskExecutorKey, TaskExecutor>);
-    /**
-     * Initialize the shared `TaskQueue` instance.
-     *
-     * @param executors The map of available task executors.
-     */
-    static initialize(executors: Map<TaskExecutorKey, TaskExecutor>): void;
-    /**
-     * Get the shared `TaskQueue` instance.
-     */
-    static getInstance(): TaskQueue;
-    /**
-     * Add a task to the queue.
-     *
-     * @param task The task to add.
-     */
-    addTask(task: Task): void;
-    /**
-     * Cancel a task.
-     *
-     * @param taskKey The key of the task to cancel.
-     */
-    cancelTask(taskKey: TaskKey): void;
-    /**
-     * Add an idle listener.
-     *
-     * @param listener The listener to add.
-     */
-    onIdle(listener: (error?: Error) => void): void;
-    /**
-     * Remove an idle listener.
-     *
-     * @param listener The listener to remove.
-     */
-    removeIdleListener(listener: (error?: Error) => void): void;
-    /**
-     * Notify the idle listeners.
-     *
-     * @param error The error to notify the listeners with.
-     */
-    private notifyIdle;
-    /**
-     * Shutdown the task queue, cancelling all pending tasks.
-     */
-    shutdown(): void;
-    private processTasksIfNeeded;
-    private processNextTasks;
-}
-
-type CheckDataRequestKey = string;
-/**
- * Options for `requestDataset`.
- */
-interface RequestDatasetOptions {
-    /** Optional constant overrides for the model. */
-    constants?: ConstantOverride[];
-    /** Optional lookup overrides for the model. */
-    lookups?: LookupOverride[];
-}
-/**
- * Coordinates on-demand loading of data used to display a graph representation
- * of a check/predicate.
- */
-declare class CheckDataCoordinator {
-    private readonly taskQueue;
-    constructor(taskQueue: TaskQueue);
-    /**
-     * Request a dataset from the model.
-     *
-     * @param requestKey The unique key for the request.
-     * @param scenarioSpec The scenario spec that defines the inputs for the model run.
-     * @param datasetKey The key of the dataset to be fetched.
-     * @param options Optional configuration including constant and lookup overrides.
-     * @param onResponse The callback that will be called with the dataset.
-     */
-    requestDataset(requestKey: CheckDataRequestKey, scenarioSpec: ScenarioSpec, datasetKey: DatasetKey, options: RequestDatasetOptions | undefined, onResponse: (dataset: Dataset) => void): void;
-    cancelRequest(key: CheckDataRequestKey): void;
-}
-/**
- * Create a `CheckDataCoordinator` instance using the shared task queue.
- */
-declare function createCheckDataCoordinator(): CheckDataCoordinator;
-/**
- * @hidden This is not part of the public API; it is exposed only for use in tests.
- */
-declare function createCheckDataCoordinatorForTests(bundleModel: BundleModel): CheckDataCoordinator;
-
-/** Spec type that allows for matching a check by group and test name. */
-interface CheckNameSpec {
-    /** The name of a check group. */
-    groupName: string;
-    /** The name of a check test. */
-    testName: string;
-}
-type CheckPredicateTimeSingle = number;
-type CheckPredicateTimeRange = [number, number];
-interface CheckPredicateTimeOptions {
-    after_excl?: number;
-    after_incl?: number;
-    before_excl?: number;
-    before_incl?: number;
-}
-type CheckPredicateTimeSpec = CheckPredicateTimeSingle | CheckPredicateTimeRange | CheckPredicateTimeOptions;
-
-type CheckDatasetError = 'no-matches-for-dataset' | 'no-matches-for-group' | 'no-matches-for-type';
-interface CheckDataset {
-    /** The key for the matched dataset; can be undefined if no dataset matched. */
-    datasetKey?: DatasetKey;
-    /** The name of the matched dataset, or the name associated with the error, if defined. */
-    name: string;
-    /** The error info if the dataset query failed to match. */
-    error?: CheckDatasetError;
-}
-
-interface CheckScenarioError {
-    kind: 'unknown-input-group' | 'empty-input-group';
-    /** The name of the input group that failed to match. */
-    name: string;
-}
-interface CheckScenarioInputDesc {
-    /** The name of the input. */
-    name: string;
-    /** The matched input variable; can be undefined if no input matched. */
-    inputVar?: InputVar;
-    /** The position of the input, if this is a position scenario. */
-    position?: InputPosition;
-    /** The value of the input, for the given position or explicit value. */
-    value?: number;
-}
-interface CheckScenario {
-    /** The spec used to configure the model with the matched input(s); can be undefined if input(s) failed to match. */
-    spec?: ScenarioSpec;
-    /** The name of the associated input group, if any. */
-    inputGroupName?: string;
-    /** The descriptions of the inputs; if empty, it is an "all inputs" scenario. */
-    inputDescs: CheckScenarioInputDesc[];
-    /** The error info if the scenario/input query failed to match. */
-    error?: CheckScenarioError;
-}
-
-/**
- * The key type for data references (in the form `<ScenarioUid::DatasetKey>`).
- */
-type CheckDataRefKey = string;
-/**
- * The scenario and dataset referenced by a particular predicate (for cases
- * where the check is against another dataset rather than a constant value).
- */
-interface CheckDataRef {
-    /** The key for the reference; can be undefined if inputs or datasets failed to match. */
-    key?: CheckDataRefKey;
-    /** The scenario used to generate the referenced dataset. */
-    scenario: CheckScenario;
-    /** The referenced dataset. */
-    dataset: CheckDataset;
-}
-
-type CheckPredicateOp = 'gt' | 'gte' | 'lt' | 'lte' | 'eq' | 'approx';
-
-interface CheckResultErrorInfo {
-    kind: 'unknown-dataset' | 'unknown-input' | 'unknown-input-group' | 'empty-input-group';
-    name: string;
-}
-interface CheckResult {
-    status: 'passed' | 'failed' | 'error' | 'skipped';
-    message?: string;
-    failValue?: number;
-    failOp?: CheckPredicateOp;
-    failRefValue?: number;
-    failTime?: number;
-    errorInfo?: CheckResultErrorInfo;
-}
-
-type CheckKey = number;
-
-type CheckStatus = 'passed' | 'failed' | 'error' | 'skipped';
-interface CheckPredicateOpConstantRef {
-    kind: 'constant';
-    value: number;
-}
-interface CheckPredicateOpDataRef {
-    kind: 'data';
-    dataRef: CheckDataRef;
-}
-type CheckPredicateOpRef = CheckPredicateOpConstantRef | CheckPredicateOpDataRef;
-interface CheckPredicateReport {
-    checkKey: CheckKey;
-    result: CheckResult;
-    opRefs: Map<CheckPredicateOp, CheckPredicateOpRef>;
-    opValues: string[];
-    time?: CheckPredicateTimeSpec;
-    tolerance?: number;
-}
-interface CheckDatasetReport {
-    checkDataset: CheckDataset;
-    status: CheckStatus;
-    predicates: CheckPredicateReport[];
-}
-interface CheckScenarioReport {
-    checkScenario: CheckScenario;
-    status: CheckStatus;
-    datasets: CheckDatasetReport[];
-}
-interface CheckTestReport {
-    name: string;
-    status: CheckStatus;
-    scenarios: CheckScenarioReport[];
-}
-interface CheckGroupReport {
-    name: string;
-    tests: CheckTestReport[];
-}
-interface CheckReport {
-    groups: CheckGroupReport[];
-}
-type StyleFunc = (s: string) => string;
-/**
- * Return a string representation of the given scenario.
- *
- * @param scenario The scenario report.
- * @param bold A function that applies bold styling to a string.
- */
-declare function scenarioMessage(scenario: CheckScenarioReport, bold: StyleFunc): string;
-/**
- * Return a string representation of the given dataset.
- *
- * @param dataset The dataset report.
- * @param bold A function that applies bold styling to a string.
- */
-declare function datasetMessage(dataset: CheckDatasetReport, bold: StyleFunc): string;
-/**
- * Return a string representation of the given predicate.
- *
- * @param predicate The predicate report.
- * @param bold A function that applies bold styling to a string.
- */
-declare function predicateMessage(predicate: CheckPredicateReport, bold: StyleFunc): string;
-
-/**
- * A simplified/terse version of `CheckPredicateReport` that matches the
- * format of the JSON objects emitted by the CLI in terse mode.
- */
-interface CheckPredicateSummary {
-    checkKey: CheckKey;
-    result: CheckResult;
-}
-/**
- * A simplified/terse version of `CheckReport` that matches the
- * format of the JSON objects emitted by the CLI in terse mode.
- * This contains predicate summaries for checks that have a status
- * of 'failed', 'error', or 'skipped'.
- */
-interface CheckSummary {
-    predicateSummaries: CheckPredicateSummary[];
-}
-/**
- * Convert a full `CheckReport` to a simplified `CheckSummary` that includes
- * failed, errored, and skipped checks.
- *
- * @param checkReport The full check report.
- * @return The converted check summary.
- */
-declare function checkSummaryFromReport(checkReport: CheckReport): CheckSummary;
-/**
- * Convert a simplified `CheckSummary` to a full `CheckReport` that restores the
- * structure of the tests from the given configuration.
- *
- * @param checkConfig The config used to reconstruct the check test structure.
- * @param checkSummary The simplified check summary.
- * @param skipChecks The checks that were skipped when the original report was created.
- * @return The converted check report.
- */
-declare function checkReportFromSummary(checkConfig: CheckConfig, checkSummary: CheckSummary, skipChecks?: CheckNameSpec[]): CheckReport | undefined;
-
-type ComparisonDatasetName = string;
-type ComparisonDatasetSource = string;
-/**
- * Specifies a dataset (variable) used for comparison.
- */
-interface ComparisonDatasetSpec {
-    kind: 'dataset';
-    /** The name of the dataset (variable). */
-    name: ComparisonDatasetName;
-    /**
-     * The source of the dataset, if it is from an external data file.  If
-     * undefined, the dataset is assumed to be a model output.
-     */
-    source?: ComparisonDatasetSource;
-}
-type ComparisonScenarioId = string;
-type ComparisonScenarioTitle = string;
-type ComparisonScenarioSubtitle = string;
-type ComparisonScenarioInputName = string;
-type ComparisonScenarioInputPosition = 'default' | 'min' | 'max';
-/**
- * Specifies an input that is set to a specific position (default / min / max).
- */
-interface ComparisonScenarioInputAtPositionSpec {
-    kind: 'input-at-position';
-    /** The requested input name or alias. */
-    inputName: ComparisonScenarioInputName;
-    /** The requested position of the input. */
-    position: ComparisonScenarioInputPosition;
-}
-/**
- * Specifies an input that is set to a specific number value.
- */
-interface ComparisonScenarioInputAtValueSpec {
-    kind: 'input-at-value';
-    /** The requested input name or alias. */
-    inputName: ComparisonScenarioInputName;
-    /** The number value of the input. */
-    value: number;
-}
-/**
- * A single input setting for a scenario.  An input can be set to a specific number value,
- * or it can be set to a "position" (default / min / max).
- */
-type ComparisonScenarioInputSpec = ComparisonScenarioInputAtPositionSpec | ComparisonScenarioInputAtValueSpec;
-/**
- * Specifies a single scenario that sets one or more inputs to a value/position.
- */
-interface ComparisonScenarioWithInputsSpec {
-    kind: 'scenario-with-inputs';
-    /** The unique identifier for the scenario. */
-    id?: ComparisonScenarioId;
-    /** The title of the scenario. */
-    title?: ComparisonScenarioTitle;
-    /** The subtitle of the scenario. */
-    subtitle?: ComparisonScenarioSubtitle;
-    /** The input settings for this scenario. */
-    inputs: ComparisonScenarioInputSpec[];
-}
-/**
- * Specifies a single scenario that configures inputs differently for the two
- * model instances.
- */
-interface ComparisonScenarioWithDistinctInputsSpec {
-    kind: 'scenario-with-distinct-inputs';
-    /** The unique identifier for the scenario. */
-    id?: ComparisonScenarioId;
-    /** The title of the scenario. */
-    title?: ComparisonScenarioTitle;
-    /** The subtitle of the scenario. */
-    subtitle?: ComparisonScenarioSubtitle;
-    /** The input settings for this scenario when run with the "left" model. */
-    inputsL: ComparisonScenarioInputSpec[];
-    /** The input settings for this scenario when run with the "right" model. */
-    inputsR: ComparisonScenarioInputSpec[];
-}
-/**
- * Specifies a single scenario that configures inputs according to the setting
- * group defined for each model instance.
- */
-interface ComparisonScenarioWithSettingGroupSpec {
-    kind: 'scenario-with-setting-group';
-    /** The unique identifier for the scenario. */
-    id?: ComparisonScenarioId;
-    /** The title of the scenario. */
-    title?: ComparisonScenarioTitle;
-    /** The subtitle of the scenario. */
-    subtitle?: ComparisonScenarioSubtitle;
-    /** The identifier of the input setting group as used in `ModelSpec.inputSettingGroups`. */
-    settingGroupId: InputSettingGroupId;
-}
-/**
- * Specifies a single scenario that sets all available inputs to position.
- */
-interface ComparisonScenarioWithAllInputsSpec {
-    kind: 'scenario-with-all-inputs';
-    /** The unique identifier for the scenario. */
-    id?: ComparisonScenarioId;
-    /** The title of the scenario. */
-    title?: ComparisonScenarioTitle;
-    /** The subtitle of the scenario. */
-    subtitle?: ComparisonScenarioSubtitle;
-    /** The position that will be used for all available inputs. */
-    position: ComparisonScenarioInputPosition;
-}
-/**
- * Special preset that expands to many scenarios:
- * - one scenario with all inputs at their default
- * - two scenarios for each available input:
- *     - one scenario with the input at its minimum
- *     - one scenario with the input at its maximum
- */
-interface ComparisonScenarioPresetMatrixSpec {
-    kind: 'scenario-matrix';
-}
-/**
- * A definition of input scenario(s).  A scenario can set one input to a value/position, or it
- * can set multiple inputs to particular values/positions.
- */
-type ComparisonScenarioSpec = ComparisonScenarioWithInputsSpec | ComparisonScenarioWithDistinctInputsSpec | ComparisonScenarioWithSettingGroupSpec | ComparisonScenarioWithAllInputsSpec | ComparisonScenarioPresetMatrixSpec;
-/** A reference to a scenario definition. */
-interface ComparisonScenarioRefSpec {
-    kind: 'scenario-ref';
-    /** The ID of the scenario that is referenced. */
-    scenarioId: ComparisonScenarioId;
-    /** The optional title that is used instead of the referenced scenario's title. */
-    title?: ComparisonScenarioTitle;
-    /** The optional subtitle that is used instead of the referenced scenario's subtitle. */
-    subtitle?: ComparisonScenarioSubtitle;
-}
-/** Spec type that allows for matching a comparison scenario by title and subtitle. */
-interface ComparisonScenarioTitleSpec {
-    /** The title of a comparison scenario. */
-    title: string;
-    /** The subtitle of a comparison scenario. */
-    subtitle?: string;
-}
-type ComparisonScenarioGroupId = string;
-type ComparisonScenarioGroupTitle = string;
-/**
- * A definition of a group of input scenarios.  Multiple scenarios can be grouped together under a single name, and
- * can later be referenced by group ID in a view definition.
- */
-interface ComparisonScenarioGroupSpec {
-    kind: 'scenario-group';
-    /** The unique identifier for the group. */
-    id?: ComparisonScenarioGroupId;
-    /** The title of the group. */
-    title: ComparisonScenarioGroupTitle;
-    /** The scenarios that are included in this group. */
-    scenarios: (ComparisonScenarioSpec | ComparisonScenarioRefSpec)[];
-}
-/** A reference to a scenario group definition. */
-interface ComparisonScenarioGroupRefSpec {
-    kind: 'scenario-group-ref';
-    /** The ID of the scenario group that is referenced. */
-    groupId: ComparisonScenarioGroupId;
-}
-type ComparisonGraphId = string;
-/**
- * Specifies a list of graphs to be shown in a view.
- */
-interface ComparisonGraphsArraySpec {
-    kind: 'graphs-array';
-    /** The array of IDs for graphs to show. */
-    graphIds: ComparisonGraphId[];
-}
-/**
- * Specifies a preset list of graphs to be shown in a view.
- */
-interface ComparisonGraphsPresetSpec {
-    kind: 'graphs-preset';
-    /** The preset (currently only "all" is supported, which shows all available graphs). */
-    preset: 'all';
-}
-type ComparisonGraphGroupId = string;
-/**
- * A definition of a group of graphs to be shown in a view.  Multiple graphs can be grouped together
- * under a single ID, and can later be referenced by group ID in a view definition.
- */
-interface ComparisonGraphGroupSpec {
-    kind: 'graph-group';
-    /** The unique identifier for the group. */
-    id: ComparisonGraphGroupId;
-    /** The graphs that are included in this group. */
-    graphIds: ComparisonGraphId[];
-}
-/** A reference to a graph group definition. */
-interface ComparisonGraphGroupRefSpec {
-    kind: 'graph-group-ref';
-    /** The ID of the graph group that is referenced. */
-    groupId: ComparisonGraphGroupId;
-}
-type ComparisonViewTitle = string;
-type ComparisonViewSubtitle = string;
-type ComparisonViewRowTitle = string;
-type ComparisonViewRowSubtitle = string;
-type ComparisonViewItemTitle = string;
-type ComparisonViewItemSubtitle = string;
-type ComparisonViewGraphOrder = 'default' | 'grouped-by-diffs';
-/**
- * Specifies a single comparison box to be shown in a view.
- */
-interface ComparisonViewBoxSpec {
-    kind: 'view-box';
-    /** The title of the box. */
-    title: ComparisonViewItemTitle;
-    /** The subtitle of the box. */
-    subtitle?: ComparisonViewItemSubtitle;
-    /** The dataset shown in this comparison box. */
-    dataset: ComparisonDatasetSpec;
-    /** The scenario shown in this comparison box. */
-    scenarioId: ComparisonScenarioId;
-}
-/**
- * Specifies a row of comparison boxes to be shown in a view.
- */
-interface ComparisonViewRowSpec {
-    kind: 'view-row';
-    /** The title of the row. */
-    title: ComparisonViewRowTitle;
-    /** The subtitle of the row. */
-    subtitle?: ComparisonViewRowSubtitle;
-    /** The array of boxes to be shown in the row. */
-    boxes: ComparisonViewBoxSpec[];
-}
-/**
- * Specifies a set of graphs to be shown in a view.
- */
-type ComparisonViewGraphsSpec = ComparisonGraphsPresetSpec | ComparisonGraphsArraySpec | ComparisonGraphGroupRefSpec;
-/**
- * A definition of a view.  A view presents a set of graphs, either for a single input scenario
- * or for a mix of different dataset/scenario combinations.
- */
-interface ComparisonViewSpec {
-    kind: 'view';
-    /** The title of the view.  If undefined, the title will be inferred from the scenario. */
-    title?: ComparisonViewTitle;
-    /** The subtitle of the view.  If undefined, the subtitle will be inferred from the scenario. */
-    subtitle?: ComparisonViewSubtitle;
-    /** The scenario to be shown in the view if this is a single-scenario view. */
-    scenarioId?: ComparisonScenarioId;
-    /** The array of rows to be shown in the view if this is a freeform view. */
-    rows?: ComparisonViewRowSpec[];
-    /** The graphs to be shown in the view. */
-    graphs?: ComparisonViewGraphsSpec;
-    /**
-     * The order in which the graphs will be displayed.  If undefined, the graphs will be
-     * displayed in the "default" order, i.e., in the same order that the IDs were specified.
-     */
-    graphOrder?: ComparisonViewGraphOrder;
-}
-type ComparisonViewGroupTitle = string;
-/**
- * Specifies a view group with an explicit array of view definitions.
- */
-interface ComparisonViewGroupWithViewsSpec {
-    kind: 'view-group-with-views';
-    /** The title of the group of views. */
-    title: ComparisonViewGroupTitle;
-    /** The views that are included in this group. */
-    views: ComparisonViewSpec[];
-}
-/**
- * Specifies a view group by declaring the scenarios included in the group (one view per scenario), along
- * with a set of graphs that will shown in each view.
- */
-interface ComparisonViewGroupWithScenariosSpec {
-    kind: 'view-group-with-scenarios';
-    /** The title of the group of views. */
-    title: ComparisonViewGroupTitle;
-    /** The scenarios to be included (one view will be created for each scenario). */
-    scenarios: (ComparisonScenarioRefSpec | ComparisonScenarioGroupRefSpec)[];
-    /** The graphs to be shown for each scenario view. */
-    graphs: ComparisonViewGraphsSpec;
-    /**
-     * The order in which the graphs will be displayed.  If undefined, the graphs will be
-     * displayed in the "default" order, i.e., in the same order that the IDs were specified.
-     */
-    graphOrder?: ComparisonViewGraphOrder;
-}
-/**
- * A definition of a group of views.  Multiple related views can be grouped together under a single title
- * to make them easy to distinguish in a report.
- */
-type ComparisonViewGroupSpec = ComparisonViewGroupWithViewsSpec | ComparisonViewGroupWithScenariosSpec;
-/**
- * Contains the scenario and view definitions from one or more sources (JSON/YAML files or manually
- * defined specs).
- */
-interface ComparisonSpecs {
-    /** The requested scenarios. */
-    scenarios?: ComparisonScenarioSpec[];
-    /** The requested scenario groups. */
-    scenarioGroups?: ComparisonScenarioGroupSpec[];
-    /** The requested graph groups. */
-    graphGroups?: ComparisonGraphGroupSpec[];
-    /** The requested view groups. */
-    viewGroups?: ComparisonViewGroupSpec[];
-}
-/** A source of comparison scenario and specifications. */
-interface ComparisonSpecsSource {
-    kind: 'yaml' | 'json';
-    /** The source filename, if known. */
-    filename?: string;
-    /** A string containing YAML or JSON content. */
-    content: string;
-}
-
-/** A resolved dataset that is being compared. */
-interface ComparisonDataset {
-    kind: 'dataset';
-    /** The unique key for the dataset (i.e., output variable or static data). */
-    key: DatasetKey;
-    /**
-     * The resolved output variable from the "left" model that corresponds to this dataset,
-     * or undefined if the variable is not defined in the left model.
-     */
-    outputVarL?: OutputVar;
-    /**
-     * The resolved output variable from the "right" model that corresponds to this dataset,
-     * or undefined if the variable is not defined in the right model.
-     */
-    outputVarR?: OutputVar;
-}
-/** A unique key for a `ComparisonScenario`, generated internally for use by the library. */
-type ComparisonScenarioKey = string & {
-    _brand?: 'ComparisonScenarioKey';
-};
-/** A fatal error indicating that no input variable matched the requested name. */
-interface ComparisonResolverUnknownInputError {
-    kind: 'unknown-input';
-}
-/** A fatal error indicating that no input setting group matched the requested ID. */
-interface ComparisonResolverUnknownInputSettingGroupError {
-    kind: 'unknown-input-setting-group';
-}
-/**
- * A fatal resolution error.  When this is set on an input state, the scenario
- * cannot be run for the affected side: spec construction for that side is
- * skipped and downstream UI annotations render it as an error.
- */
-type ComparisonResolverError = ComparisonResolverUnknownInputError | ComparisonResolverUnknownInputSettingGroupError;
-/**
- * A non-fatal warning indicating that the resolved value falls outside the
- * declared `[minValue, maxValue]` range of a slider (or is not one of the
- * declared values of a switch).  The scenario still runs with the requested
- * value; consumers (e.g. UI annotations) should flag it as a warning.
- */
-interface ComparisonResolverValueOutOfRangeWarning {
-    kind: 'value-out-of-range';
-}
-/**
- * A non-fatal resolution warning.  Warnings do not prevent the scenario from
- * running; they are surfaced as annotations alongside the resolved value.
- */
-type ComparisonResolverWarning = ComparisonResolverValueOutOfRangeWarning;
-/** Describes the resolution state for a scenario input relative to a specific model. */
-interface ComparisonScenarioInputState {
-    /** The matched input variable; can be undefined if no input matched. */
-    inputVar?: InputVar;
-    /** The position of the input, if this is a position scenario. */
-    position?: InputPosition;
-    /** The value of the input, for the given position or explicit value. */
-    value?: number;
-    /** The fatal error info if the input could not be resolved. */
-    error?: ComparisonResolverError;
-    /**
-     * Non-fatal advisory info about the resolved input.  When set (without an
-     * accompanying `error`), the input still resolved and the scenario can run;
-     * consumers should surface the warning alongside the resolved value.
-     */
-    warning?: ComparisonResolverWarning;
-}
-/** A scenario input that has been checked against both "left" and "right" model. */
-interface ComparisonScenarioInput {
-    /** The requested name of the input. */
-    requestedName: string;
-    /** The resolved state of the input for the "left" model. */
-    stateL: ComparisonScenarioInputState;
-    /** The resolved state of the input for the "right" model. */
-    stateR: ComparisonScenarioInputState;
-}
-/** A configuration that sets model inputs to specific values. */
-interface ComparisonScenarioInputSettings {
-    kind: 'input-settings';
-    /** The resolutions for the specified inputs in the scenario. */
-    inputs: ComparisonScenarioInput[];
-    /**
-     * Whether the settings differ between the "left" and "right" models.  This is
-     * typically only used in the case of a scenario based on model-specific setting
-     * groups, where the set of inputs or the input values differ between the two models.
-     */
-    settingsDiffer?: boolean;
-}
-/** A configuration that sets all inputs in the model to a certain position. */
-interface ComparisonScenarioAllInputsSettings {
-    kind: 'all-inputs-settings';
-    /** The input position that will be applied to all available inputs. */
-    position: InputPosition;
-}
-/**
- * The configuration for an input scenario, either a set of individual input settings, or one
- * that sets all inputs in the model to a certain position.
- */
-type ComparisonScenarioSettings = ComparisonScenarioInputSettings | ComparisonScenarioAllInputsSettings;
-/** A single resolved input scenario. */
-interface ComparisonScenario {
-    kind: 'scenario';
-    /** The unique key for the scenario, generated internally for use by the library. */
-    key: ComparisonScenarioKey;
-    /** The unique user-defined identifier for the scenario. */
-    id?: ComparisonScenarioId;
-    /** The scenario title. */
-    title: string;
-    /** The scenario subtitle. */
-    subtitle?: string;
-    /** The resolved settings for the model inputs in this scenario. */
-    settings: ComparisonScenarioSettings;
-    /** The input scenario used to configure the "left" model, or undefined if data not available. */
-    specL?: ScenarioSpec;
-    /** The input scenario used to configure the "right" model, or undefined if data not available. */
-    specR?: ScenarioSpec;
-}
-/** An unresolved input scenario reference. */
-interface ComparisonUnresolvedScenarioRef {
-    kind: 'unresolved-scenario-ref';
-    /** The ID of the referenced scenario that could not be resolved. */
-    scenarioId: ComparisonScenarioId;
-}
-/** A resolved group of input scenarios. */
-interface ComparisonScenarioGroup {
-    kind: 'scenario-group';
-    /** The unique identifier for the group. */
-    id?: ComparisonScenarioGroupId;
-    /** The title of the group. */
-    title: ComparisonScenarioGroupTitle;
-    /**
-     * The scenarios that are included in this group.  This includes scenarios that were successfully
-     * resolved as well as scenario references that could not be resolved.
-     */
-    scenarios: (ComparisonScenario | ComparisonUnresolvedScenarioRef)[];
-}
-/** An unresolved scenario group reference. */
-interface ComparisonUnresolvedScenarioGroupRef {
-    kind: 'unresolved-scenario-group-ref';
-    /** The ID of the referenced scenario group that could not be resolved. */
-    scenarioGroupId: ComparisonScenarioGroupId;
-}
-/** A resolved group of graphs. */
-interface ComparisonGraphGroup {
-    kind: 'graph-group';
-    /** The unique identifier for the group. */
-    id: ComparisonScenarioGroupId;
-    /** The graphs that are included in this group. */
-    graphIds: ComparisonGraphId[];
-}
-/**
- * A resolved comparison box to be shown in a view.
- */
-interface ComparisonViewBox {
-    kind: 'view-box';
-    /** The title of the box. */
-    title: ComparisonViewItemTitle;
-    /** The subtitle of the box. */
-    subtitle?: ComparisonViewItemSubtitle;
-    /** The resolved dataset shown in this comparison box. */
-    dataset: ComparisonDataset;
-    /** The resolved scenario shown in this comparison box. */
-    scenario: ComparisonScenario;
-}
-/**
- * A resolved row of comparison boxes to be shown in a view.
- */
-interface ComparisonViewRow {
-    kind: 'view-row';
-    /** The title of the row. */
-    title: ComparisonViewRowTitle;
-    /** The subtitle of the row. */
-    subtitle?: ComparisonViewRowSubtitle;
-    /** The array of resolved boxes to be shown in the row. */
-    boxes: ComparisonViewBox[];
-}
-/**
- * A resolved view definition.  A view presents a set of graphs, either for a single input scenario
- * or for a mix of different dataset/scenario combinations.
- */
-interface ComparisonView {
-    kind: 'view';
-    /** The title of the view. */
-    title: ComparisonViewTitle;
-    /** The subtitle of the view. */
-    subtitle?: ComparisonViewSubtitle;
-    /** The resolved scenario to be shown in the view if this is a single-scenario view. */
-    scenario?: ComparisonScenario;
-    /** The array of resolved rows to be shown in the view if this is a freeform view. */
-    rows?: ComparisonViewRow[];
-    /** The graphs to be shown for each scenario view. */
-    graphIds: ComparisonGraphId[];
-    /** The order in which the graphs will be displayed. */
-    graphOrder: ComparisonViewGraphOrder;
-}
-/** An unresolved view. */
-interface ComparisonUnresolvedView {
-    kind: 'unresolved-view';
-    /** The requested title of the view, if provided. */
-    title?: ComparisonViewTitle;
-    /** The requested subtitle of the view, if provided. */
-    subtitle?: ComparisonViewSubtitle;
-    /** The name of the referenced dataset that could not be resolved. */
-    datasetName?: ComparisonDatasetName;
-    /** The source of the referenced dataset that could not be resolved. */
-    datasetSource?: ComparisonDatasetSource;
-    /** The ID of the referenced scenario that could not be resolved. */
-    scenarioId?: ComparisonScenarioId;
-    /** The ID of the referenced scenario group that could not be resolved. */
-    scenarioGroupId?: ComparisonScenarioGroupId;
-}
-/** A resolved group of compared scenario/graph views. */
-interface ComparisonViewGroup {
-    kind: 'view-group';
-    /** The title of the group of views. */
-    title: ComparisonViewGroupTitle;
-    /** The array of resolved (and unresolved) views that are included in this group. */
-    views: (ComparisonView | ComparisonUnresolvedView)[];
-}
-
-/**
- * A summary of timing samples collected during a performance run.
- */
-interface PerfReport {
-    /** Minimum sample time, in milliseconds. */
-    readonly minTime: number;
-    /** Maximum sample time, in milliseconds. */
-    readonly maxTime: number;
-    /**
-     * Trimmed mean (interquartile mean) computed from the middle 50% of samples,
-     * in milliseconds.  This is more robust against outliers than a simple mean.
-     */
-    readonly avgTime: number;
-    /** Median (50th percentile) sample time, in milliseconds. */
-    readonly medianTime: number;
-    /** 95th percentile sample time, in milliseconds. */
-    readonly p95Time: number;
-    /** Population standard deviation across all samples, in milliseconds. */
-    readonly stdDev: number;
-    /** All recorded sample times, sorted ascending, in milliseconds. */
-    readonly allTimes: number[];
-}
-/**
- * Collect performance timing samples and produce a robust statistical summary.
- */
-declare class PerfStats {
-    private readonly times;
-    /**
-     * Record a single run time sample.
-     *
-     * @param timeInMillis The run time in milliseconds.
-     */
-    addRun(timeInMillis: number): void;
-    /**
-     * Get the raw run time samples that have been recorded.
-     *
-     * @returns A copy of the recorded run times, in insertion order.
-     */
-    getTimes(): number[];
-    /**
-     * Produce a `PerfReport` summarizing the recorded samples.
-     *
-     * @returns The summary report.
-     */
-    toReport(): PerfReport;
-}
-
-interface DiffPoint {
-    time: number;
-    valueL: number;
-    valueR: number;
-}
-type DiffValidity = 'neither' | 'left-only' | 'right-only' | 'both';
-interface DiffReport {
-    validity: DiffValidity;
-    minValue: number;
-    maxValue: number;
-    avgDiff: number;
-    minDiff: number;
-    maxDiff: number;
-    maxDiffPoint: DiffPoint;
-}
-declare function diffDatasets(datasetL: Dataset | undefined, datasetR: Dataset | undefined): DiffReport;
-
-/**
- * The report for a single comparison test (involving a dataset produced under
- * a specific input scenario).  This includes the full `DiffReport`, whereas
- * a `ComparisonTestSummary` only includes the `maxDiff` value.
- */
-interface ComparisonTestReport {
-    /** The key of the scenario that was compared. */
-    scenarioKey: ComparisonScenarioKey;
-    /** The key of the dataset that was compared. */
-    datasetKey: DatasetKey;
-    /** The diff report for the comparison, or undefined if the test was skipped. */
-    diffReport?: DiffReport;
-    /**
-     * The diff report for the baseline scenario (all inputs at default), or undefined if this
-     * report is for the baseline scenario itself.
-     */
-    baselineDiffReport?: DiffReport;
-}
-/**
- * A simplified/terse version of `ComparisonTestReport` that is used when writing
- * results to a JSON file.  The object keys are terse and it only includes the
- * minimum set of fields (only the `maxDiff` value instead of the full `DiffReport`)
- * to keep the file smaller when there are many reported differences.
- */
-interface ComparisonTestSummary {
-    /** Short for `scenarioKey`. */
-    s: ComparisonScenarioKey;
-    /** Short for `datasetKey`. */
-    d: DatasetKey;
-    /** Short for `maxDiff`. */
-    md?: number;
-    /** Short for `avgDiff`. */
-    ad?: number;
-    /** Short for `maxDiff` relative to baseline `maxDiff`. */
-    mdb?: number;
-    /** Short for `avgDiff` relative to baseline `avgDiff`. */
-    adb?: number;
-}
-/**
- * The roll-up report that contains the results of all individual comparison tests.
- */
-interface ComparisonReport {
-    /** The set of all comparison test reports. */
-    testReports: ComparisonTestReport[];
-    /** The perf report for the "left" model. */
-    perfReportL: PerfReport;
-    /** The perf report for the "right" model. */
-    perfReportR: PerfReport;
-}
-/**
- * A simplified/terse version of `ComparisonReport` that only includes the minimum set
- * of fields needed by the reporting app (to keep the file smaller when there are many
- * reported differences).  This only includes comparison results for which there is
- * a non-zero `maxDiff` value.
- */
-interface ComparisonSummary {
-    /** The simplified set of all terse comparison test summaries. */
-    testSummaries: ComparisonTestSummary[];
-    /** The perf report for the "left" model. */
-    perfReportL: PerfReport;
-    /** The perf report for the "right" model. */
-    perfReportR: PerfReport;
-}
-
-type ComparisonGroupKind = 'by-dataset' | 'by-scenario';
-type ComparisonGroupKey = string;
-/**
- * A group of comparison test summaries associated with a particular scenario or dataset.
- */
-interface ComparisonGroup {
-    /** The kind of group, either 'by-dataset' or 'by-scenario'. */
-    kind: ComparisonGroupKind;
-    /**
-     * The unique key for this group (a `DatasetKey` if grouped by dataset, or a
-     * `ComparisonScenarioKey` if grouped by scenario).
-     */
-    key: ComparisonGroupKey;
-    /** The comparison test summaries for this group. */
-    testSummaries: ComparisonTestSummary[];
-}
-/** Describes the "root" or primary item for a group of comparisons. */
-type ComparisonGroupRoot = ComparisonDataset | ComparisonScenario;
-/** A summary of scores for a group of comparisons. */
-interface ComparisonGroupScores {
-    /** The total number of comparisons (sample size) for this group. */
-    totalDiffCount: number;
-    /** The sum of the diff values for the active sort mode (e.g., `maxDiff`, `avgDiff`) for each threshold bucket. */
-    totalDiffByBucket: number[];
-    /** The number of comparisons that fall into each threshold bucket. */
-    diffCountByBucket: number[];
-    /** The percentage of comparisons that fall into each threshold bucket. */
-    diffPercentByBucket: number[];
-}
-/**
- * A summary of a group of comparisons that includes the resolved scenario/dataset metadata
- * and score information for the group.
- */
-interface ComparisonGroupSummary {
-    /** The metadata for the "root" or primary item for this group of comparisons. */
-    root: ComparisonGroupRoot;
-    /** The group containing the comparison summaries. */
-    group: ComparisonGroup;
-    /** The scores for this group, or undefined if comparisons were not performed for this group. */
-    scores?: ComparisonGroupScores;
-}
-/**
- * Breaks down a set of by-scenario or by-dataset groupings into distinct categories.
- */
-interface ComparisonGroupSummariesByCategory {
-    /**
-     * All groups in a map, keyed by "group key" (either a dataset key or scenario key).
-     */
-    allGroupSummaries: Map<ComparisonGroupKey, ComparisonGroupSummary>;
-    /**
-     * Groups with items that have errors (are not valid) for both "left" and "right" models.
-     */
-    withErrors: ComparisonGroupSummary[];
-    /**
-     * Groups with items that are only valid for the "left" model (for example, datasets that
-     * were removed and no longer available in the "right" model).
-     */
-    onlyInLeft: ComparisonGroupSummary[];
-    /**
-     * Groups with items that are only valid for the "right" model (for example, scenarios
-     * for inputs that were added in the "right" model).
-     */
-    onlyInRight: ComparisonGroupSummary[];
-    /**
-     * Groups with one or more comparisons that have non-zero diff scores; the groups
-     * will be sorted by the diff score according to the active sort mode, with higher
-     * scores at the front of the array.
-     */
-    withDiffs: ComparisonGroupSummary[];
-    /**
-     * Groups where all comparisons have diff scores of zero (no differences between
-     * "left" and "right").
-     */
-    withoutDiffs: ComparisonGroupSummary[];
-}
-/**
- * Rolls up all by-scenario and by-dataset groupings.
- */
-interface ComparisonCategorizedResults {
-    /** All summaries for the comparison tests that were performed. */
-    allTestSummaries: ComparisonTestSummary[];
-    /** The full set of by-scenario groupings. */
-    byScenario: ComparisonGroupSummariesByCategory;
-    /** The full set of by-dataset groupings. */
-    byDataset: ComparisonGroupSummariesByCategory;
-}
-
-/**
- * Provides access to the set of dataset definitions (`ComparisonDataset` instances) that are used
- * when comparing the two models.
- */
-interface ComparisonDatasets {
-    /**
-     * Return all `ComparisonDataset` instances that are available for comparisons.
-     */
-    getAllDatasets(): IterableIterator<ComparisonDataset>;
-    /**
-     * Return the dataset metadata for the given key.
-     *
-     * @param datasetKey The key for the dataset.
-     */
-    getDataset(datasetKey: DatasetKey): ComparisonDataset | undefined;
-    /**
-     * Return the keys for the datasets that should be compared for the given scenario.
-     *
-     * @param scenario The scenario definition.
-     */
-    getDatasetKeysForScenario(scenario: ComparisonScenario): DatasetKey[];
-    /**
-     * Return the reference plots that should be shown in the comparison graph for the
-     * given dataset and scenario.
-     *
-     * @param datasetKey The key for the dataset.
-     * @param scenario The scenario for which the dataset will be displayed.
-     */
-    getReferencePlotsForDataset(datasetKey: DatasetKey, scenario: ComparisonScenario): ComparisonPlot[];
-    /**
-     * Return the context graph IDs that should be shown for the given dataset and scenario.
-     *
-     * @param datasetKey The key for the dataset.
-     * @param scenario The scenario for which the dataset will be displayed.
-     */
-    getContextGraphIdsForDataset(datasetKey: DatasetKey, scenario: ComparisonScenario): BundleGraphId[];
-}
-
-interface ComparisonScenarios {
-    /**
-     * Return all `ComparisonScenario` instances that are available for comparisons.
-     */
-    getAllScenarios(): IterableIterator<ComparisonScenario>;
-    /**
-     * Return the scenario definition for the given key.
-     *
-     * @param key The key for the scenario.
-     */
-    getScenario(key: ComparisonScenarioKey): ComparisonScenario | undefined;
-}
-
-/**
- * Describes an extra plot to be shown in a comparison graph.
- */
-interface ComparisonPlot {
-    /** The dataset key for the plot. */
-    datasetKey: DatasetKey;
-    /** The plot color. */
-    color: string;
-    /** The plot style.  If undefined, defaults to 'normal'. */
-    style?: 'normal' | 'dashed';
-    /** The plot line width, in px units.  If undefined, a default width will be used. */
-    lineWidth?: number;
-}
-interface ComparisonDatasetOptions {
-    /**
-     * The mapping of renamed dataset keys (old or "left" name as the map key,
-     * new or "right" name as the value).
-     */
-    renamedDatasetKeys?: Map<DatasetKey, DatasetKey>;
-    /**
-     * An optional function that allows for limiting the datasets that are compared
-     * for a given scenario.  By default, all datasets are compared for a given
-     * scenario, but if a custom function is provided, it can return a subset of
-     * datasets (for example, to omit datasets that are not relevant).
-     */
-    datasetKeysForScenario?: (allDatasetKeys: DatasetKey[], scenario: ComparisonScenario) => DatasetKey[];
-    /**
-     * An optional function that allows for including additional reference plots
-     * on a comparison graph for a given dataset and scenario.  By default, no
-     * additional reference plots are included, but if a custom function is
-     * provided, it can return an array of `ComparisonPlot` objects.
-     */
-    referencePlotsForDataset?: (dataset: ComparisonDataset, scenario: ComparisonScenario) => ComparisonPlot[];
-    /**
-     * An optional function that allows for customizing the set of context graphs
-     * that are shown for a given dataset and scenario.  By default, all graphs in
-     * which the dataset appears will be shown, but if a custom function is provided,
-     * it can return a different set of graphs (for example, to omit graphs that are
-     * not relevant under the given scenario).
-     */
-    contextGraphIdsForDataset?: (dataset: ComparisonDataset, scenario: ComparisonScenario) => BundleGraphId[];
-}
-/**
- * Describes a row in the comparison report summary view.
- */
-interface ComparisonReportSummaryRow {
-    /** The group summary represented by the row. */
-    groupSummary: ComparisonGroupSummary;
-    /** The custom title for the row (this overrides the default title derived from the summary). */
-    title?: string;
-    /** The custom subtitle for the row (this overrides the default subtitle derived from the summary). */
-    subtitle?: string;
-}
-/**
- * Describes a section in the comparison report summary view.
- */
-interface ComparisonReportSummarySection {
-    /** The text to display for the section header. */
-    headerText: string;
-    /** The summary rows to display in the section. */
-    rows: ComparisonReportSummaryRow[];
-    /**
-     * The initial expanded state of the section.  If undefined, defaults to 'expanded-if-diffs',
-     * meaning the section will be initially expanded only if any rows have differences, otherwise
-     * it will be initially collapsed.
-     */
-    initialState?: 'collapsed' | 'expanded' | 'expanded-if-diffs';
-    /**
-     * Whether the items in the section are stable, i.e., not changing from run to run.  If
-     * undefined, defaults to false.  This can be used to group items in the filter panel.
-     * Set it to true if the group contains a stable set of rows where the order does not
-     * change between runs.  Set it to false (or leave it undefined) if the group contains
-     * rows that have a different order between runs (for example, "Scenarios producing
-     * differences").
-     */
-    stable?: boolean;
-}
-/**
- * Describes an item (box) in the comparison report detail view.
- */
-interface ComparisonReportDetailItem {
-    /** The title of the item. */
-    title: string;
-    /** The subtitle of the item (if any). */
-    subtitle?: string;
-    /** The scenario for the item. */
-    scenario: ComparisonScenario;
-    /** The test summary for the item. */
-    testSummary: ComparisonTestSummary;
-}
-/**
- * Describes a row in the comparison report detail view.
- */
-interface ComparisonReportDetailRow {
-    /** The title of the row. */
-    title: string;
-    /** The subtitle of the row (if any). */
-    subtitle?: string;
-    /** The score for the row (the meaning of the value depends on the chosen statistical method). */
-    score: number;
-    /** The items in this row (one item per box). */
-    items: ComparisonReportDetailItem[];
-}
-interface ComparisonReportOptions {
-    /**
-     * An optional function that allows for customizing the order and grouping of
-     * sections and rows in the "comparisons by scenario" summary view.
-     *
-     * @param summaries The comparison summaries, one summary per scenario.
-     * @returns The sections to display in the "comparisons by scenario" summary view.
-     */
-    summarySectionsForComparisonsByScenario?: (summaries: ComparisonGroupSummariesByCategory) => ComparisonReportSummarySection[];
-    /**
-     * An optional function that allows for customizing the order and grouping of
-     * sections and rows in the "comparisons by dataset" summary view.
-     *
-     * @param summaries The comparison summaries, one summary per dataset.
-     * @returns The sections to display in the "comparisons by dataset" summary view.
-     */
-    summarySectionsForComparisonsByDataset?: (summaries: ComparisonGroupSummariesByCategory) => ComparisonReportSummarySection[];
-    /**
-     * An optional function that allows for customizing the order of rows and boxes
-     * in the detail view for a scenario.
-     *
-     * @param rows The original rows to be displayed in the detail view for a scenario.
-     * @returns The customized rows to display in the detail view for a scenario.
-     */
-    detailRowsForScenario?: (rows: ComparisonReportDetailRow[]) => ComparisonReportDetailRow[];
-    /**
-     * An optional function that allows for customizing the order of rows and boxes
-     * in the detail view for a dataset.
-     *
-     * @param rows The original rows to be displayed in the detail view for a dataset.
-     * @returns The customized rows to display in the detail view for a dataset.
-     */
-    detailRowsForDataset?: (rows: ComparisonReportDetailRow[]) => ComparisonReportDetailRow[];
-}
-interface ComparisonOptions {
-    /** The left-side ("baseline") bundle being compared. */
-    baseline: NamedBundle;
-    /**
-     * The array of thresholds used to color differences.  Defaults to [1, 5, 10]
-     * which will use buckets of 0%, 0-1%, 1-5%, 5-10%, and >10%.
-     */
-    thresholds?: number[];
-    /**
-     * The array of ratio thresholds used to color differences when relative sorting is
-     * active.  Defaults to [1, 2, 3] which will use buckets of 0, 0-1, 1-2, 2-3, and >3.
-     */
-    ratioThresholds?: number[];
-    /**
-     * The requested comparison scenario and view specifications.  These can be
-     * specified in YAML or JSON files, or using `Spec` objects.
-     */
-    specs: (ComparisonSpecs | ComparisonSpecsSource)[];
-    /** Optional configuration for the datasets that are compared for different scenarios. */
-    datasets?: ComparisonDatasetOptions;
-    /** Options for customizing the comparison report. */
-    report?: ComparisonReportOptions;
-}
-interface ComparisonConfig {
-    /** The loaded left-side ("baseline") bundle being compared. */
-    bundleL: LoadedBundle;
-    /** The loaded right-side ("current") bundle being compared. */
-    bundleR: LoadedBundle;
-    /**
-     * The array of thresholds used to color differences.  For example, [1, 5, 10] will use
-     * buckets of 0%, 0-1%, 1-5%, 5-10%, and >10%.
-     */
-    thresholds: number[];
-    /**
-     * The array of ratio thresholds used to color differences when relative sorting is
-     * active.  For example, [1, 2, 3] will use buckets of 0, 0-1, 1-2, 2-3, and >3.
-     */
-    ratioThresholds: number[];
-    /** The set of resolved scenarios that will be compared. */
-    scenarios: ComparisonScenarios;
-    /** The set of resolved datasets that will be compared. */
-    datasets: ComparisonDatasets;
-    /** The set of resolved view groups. */
-    viewGroups: ComparisonViewGroup[];
-    /** Options for customizing the comparison report. */
-    reportOptions?: ComparisonReportOptions;
-}
-
-type ComparisonDataRequestKey = string;
-/**
- * Options for `requestDatasetMaps`.
- */
-interface RequestDatasetMapsOptions {
-    /** Optional constant overrides for the "left" model. */
-    constantsL?: ConstantOverride[];
-    /** Optional constant overrides for the "right" model. */
-    constantsR?: ConstantOverride[];
-    /** Optional lookup overrides for the "left" model. */
-    lookupsL?: LookupOverride[];
-    /** Optional lookup overrides for the "right" model. */
-    lookupsR?: LookupOverride[];
-}
-/**
- * Coordinates loading of data in parallel from two models.
- */
-declare class ComparisonDataCoordinator {
-    private readonly taskQueue;
-    constructor(taskQueue: TaskQueue);
-    /**
-     * Request datasets from the two models.
-     *
-     * @param requestKey The unique key for the request.
-     * @param sourceL The source of the first ("left") dataset.  If "left", the datasets will
-     * be fetched from the "left" bundle's model, otherwise they will be fetched from the
-     * "right" bundle's model.
-     * @param scenarioSpecL The scenario used for the first ("left") model of the comparison.
-     * @param sourceR The source of the second ("right") dataset.  If "left", the datasets
-     * will be fetched from the "left" bundle's model, otherwise they will be fetched from
-     * the "right" bundle's model.
-     * @param scenarioSpecR The scenario used for the second ("right") model of the comparison.
-     * @param datasetKeys The keys of the datasets to be fetched.
-     * @param options Optional configuration including constant and lookup overrides.
-     * @param onResponse The callback that will be called with the dataset maps.
-     */
-    requestDatasetMaps(requestKey: ComparisonDataRequestKey, sourceL: 'left' | 'right', scenarioSpecL: ScenarioSpec, sourceR: 'left' | 'right', scenarioSpecR: ScenarioSpec, datasetKeys: DatasetKey[], options: RequestDatasetMapsOptions | undefined, onResponse: (datasetMapL?: DatasetMap, datasetMapR?: DatasetMap) => void): void;
-    /**
-     * Request graph data from the two models.
-     *
-     * @param requestKey The unique key for the request.
-     * @param sourceL The source of the first ("left") dataset.  If "left", the datasets will
-     * be fetched from the "left" bundle's model, otherwise they will be fetched from the
-     * "right" bundle's model.
-     * @param scenarioSpecL The scenario used for the first ("left") model of the comparison.
-     * @param sourceR The source of the second ("right") dataset.  If "left", the datasets
-     * will be fetched from the "left" bundle's model, otherwise they will be fetched from
-     * the "right" bundle's model.
-     * @param scenarioSpecR The scenario used for the second ("right") model of the comparison.
-     * @param graphId The ID of the graph for which data will be fetched.
-     * @param onResponse The callback that will be called with the graph data.
-     */
-    requestGraphData(requestKey: ComparisonDataRequestKey, sourceL: 'left' | 'right', scenarioSpecL: ScenarioSpec, sourceR: 'left' | 'right', scenarioSpecR: ScenarioSpec, graphId: BundleGraphId, onResponse: (graphDataL?: BundleGraphData, graphDataR?: BundleGraphData) => void): void;
-    cancelRequest(key: ComparisonDataRequestKey): void;
-}
-declare function createComparisonDataCoordinator(): ComparisonDataCoordinator;
-
-type GraphInclusion = 'neither' | 'left-only' | 'right-only' | 'both';
-interface GraphComparisonMetadataReport {
-    /** The key for the metadata field. */
-    key: string;
-    /** The value of the metadata field in the left bundle. */
-    valueL?: string;
-    /** The value of the metadata field in the right bundle. */
-    valueR?: string;
-}
-interface GraphComparisonDatasetReport {
-    /** The dataset key. */
-    datasetKey: DatasetKey;
-    /** The max diff for this dataset. */
-    maxDiff?: number;
-}
-interface GraphComparisonReport {
-    /** Indicates which bundles the graph is defined in. */
-    inclusion: GraphInclusion;
-    /** The metadata fields with differences. */
-    metadataReports: GraphComparisonMetadataReport[];
-    /** The datasets with differences. */
-    datasetReports: GraphComparisonDatasetReport[];
-}
-/**
- * Comparison the metadata and datasets for the given graphs.
- *
- * @param graphL The graph defined in the left bundle.
- * @param graphR The graph defined in the right bundle.
- * @param scenarioKey The key of the scenario used for comparing datasets.
- * @param testSummaries The set of test summaries from a previous comparison run.
- */
-declare function diffGraphs(graphL: BundleGraphSpec | undefined, graphR: BundleGraphSpec | undefined, scenarioKey: ComparisonScenarioKey, testSummaries: ComparisonTestSummary[]): GraphComparisonReport;
-
-/**
- * Convert a full `ComparisonReport` to a simplified `ComparisonSummary` that includes
- * the minimum set of fields needed to keep the file smaller when there are many
- * reported differences.  This only includes comparison results for which there
- * is a non-zero `maxDiff` value.
- *
- * @param comparisonReport The full comparison report.
- * @return The terse summary.
- */
-declare function comparisonSummaryFromReport(comparisonReport: ComparisonReport): ComparisonSummary;
-/**
- * Convert a full `ComparisonTestReport` to a terse `ComparisonTestSummary`.  This will
- * return undefined if the test has a zero `maxDiff` value.
- *
- * @param r The full comparison test report.
- * @param baselineMaxDiff The max diff for the baseline scenario, or undefined if not available.
- * @param baselineAvgDiff The avg diff for the baseline scenario, or undefined if not available.
- * @return The terse comparison test summary.
- */
-declare function testSummaryFromReport(r: ComparisonTestReport, baselineMaxDiff: number | undefined, baselineAvgDiff: number | undefined): ComparisonTestSummary | undefined;
-
-/** The available sort modes for categorizing comparison groups. */
-type ComparisonSortMode = 'max-diff' | 'avg-diff' | 'max-diff-relative' | 'avg-diff-relative';
-
-/**
- * Compute the overall scores for the given group of comparison test summaries.
- *
- * @param testSummaries The comparison test summaries to consider.
- * @param thresholds The array of thresholds that determine the buckets into which
- * the scores will be summarized.
- * @param sortMode The sort mode to determine which field to use for scoring.
- */
-declare function getScoresForTestSummaries(testSummaries: ComparisonTestSummary[], thresholds: number[], sortMode: ComparisonSortMode): ComparisonGroupScores;
-
-/**
- * Given a set of terse test summaries (which only includes summaries for tests with non-zero `maxDiff`
- * scores), restore the full set of summaries and then categorize them.
- *
- * @param comparisonConfig The comparison configuration.
- * @param terseSummaries The set of terse test summaries.
- * @param sortMode The sort mode to determine which field to use for scoring.
- */
-declare function categorizeComparisonTestSummaries(comparisonConfig: ComparisonConfig, terseSummaries: ComparisonTestSummary[], sortMode: ComparisonSortMode): ComparisonCategorizedResults;
-
-/**
- * Additional options that are passed to `getConfigOptions`.
- */
-interface ConfigInitOptions {
-    /** If defined, overrides the displayed name of the baseline ("left") bundle. */
-    bundleNameL?: string;
-    /** If defined, overrides the displayed name of the current ("right") bundle. */
-    bundleNameR?: string;
-}
-/**
- * The user-specified options used by the library to resolve and initialize a `Config` instance.
- */
-interface ConfigOptions {
-    /**
-     * The bundle being checked.  This bundle will also be compared against the
-     * "baseline" bundle, if `comparison` options are defined.
-     */
-    current: NamedBundle;
-    /**
-     * The model check options.
-     */
-    check: CheckOptions;
-    /**
-     * The model comparison options.
-     */
-    comparison?: ComparisonOptions;
-    /**
-     * The number of model instances to initialize for each bundle.
-     *
-     * If undefined, the default behavior will be used, which is to initialize a single
-     * model instance for each bundle.
-     *
-     * If you set this to a value greater than 1, it will allow multiple pairs of model
-     * instances to be run concurrently.  For example, if the number of CPU cores is 8,
-     * setting this to 4 will allow 4 pairs of model instances to be run concurrently,
-     * using all available cores.
-     *
-     * If you set this to 0, the implementation will automatically choose a value based on
-     * the number of available CPU cores (i.e., the number of cores divided by 2).
-     */
-    concurrency?: number;
-}
-/**
- * The resolved configuration for check and comparison tests.
- */
-interface Config {
-    /** The resolved check test configuration. */
-    check: CheckConfig;
-    /** The resolved comparison test configuration. */
-    comparison?: ComparisonConfig;
-}
-
-declare function createConfig(options: ConfigOptions): Promise<Config>;
-
-type CancelRunPerf = () => void;
-interface RunPerfCallbacks {
-    onComplete?: (reportL: PerfReport, reportR: PerfReport) => void;
-    onError?: (error: Error) => void;
-}
-interface RunPerfOptions {
-    /** The mode to run the performance tests (default is 'serial'). */
-    mode?: 'serial' | 'parallel';
-    /** The number of warmups for each perf run (default is 5). */
-    warmupCount?: number;
-    /** The number of times to run the model for each perf run (default is 100). */
-    runCount?: number;
-}
-/**
- * Run performance tests on the bundle models.
- *
- * @param callbacks The callbacks that will be notified.
- * @param options The options for the performance run.
- * @return A function that will cancel the process when invoked.
- */
-declare function runPerf(callbacks: RunPerfCallbacks, options?: RunPerfOptions): CancelRunPerf;
-
-/**
- * The report for a single trace comparison between two datasets.
- *
- * TODO: This is basically the same as `DiffReport`, except that it preserves the
- * diff points.  Maybe we can combine them and make the points array an opt-in thing.
- */
-interface TraceDatasetReport {
-    datasetKey: DatasetKey;
-    validity: DiffValidity;
-    points: Map<number, DiffPoint>;
-    minValue: number;
-    maxValue: number;
-    avgDiff: number;
-    minDiff: number;
-    maxDiff: number;
-    maxDiffPoint: DiffPoint;
-}
-/**
- * The roll-up report that contains the results of the trace comparisons
- * for all datasets.
- */
-interface TraceReport {
-    datasetReports: Map<DatasetKey, TraceDatasetReport>;
-}
-
-type CancelRunTrace = () => void;
-interface RunTraceCallbacks {
-    onComplete?: (traceReport: TraceReport) => void;
-    onError?: (error: Error) => void;
-}
-interface TraceCompareToBundleOptions {
-    kind: 'compare-to-bundle';
-    bundleSide0: 'left' | 'right';
-    scenarioSpec0: ScenarioSpec;
-    bundleSide1: 'left' | 'right';
-    scenarioSpec1: ScenarioSpec;
-}
-interface TraceCompareToExtDataOptions {
-    kind: 'compare-to-ext-data';
-    extData: DatasetMap;
-    bundleSide: 'left' | 'right';
-    scenarioSpec: ScenarioSpec;
-}
-type TraceOptions = TraceCompareToBundleOptions | TraceCompareToExtDataOptions;
-/**
- * Perform a trace run, comparing all datasets from the requested models.
- *
- * @param modelSpec The model spec that provides the datasets to be compared (usually from the "right" bundle).
- * @param callbacks The callbacks that will be notified.
- * @param options Options to control how the trace is run.
- * @return A function that will cancel the process when invoked.
- */
-declare function runTrace(modelSpec: ModelSpec, callbacks: RunTraceCallbacks, options: TraceOptions): CancelRunTrace;
-
-/**
- * The report for a single run of the full check+comparison test suite.
- */
-interface SuiteReport {
-    /** The check report. */
-    checkReport: CheckReport;
-    /** The comparison report (only defined if comparisons were enabled). */
-    comparisonReport?: ComparisonReport;
-}
-/**
- * A simplified/terse version of `SuiteReport` that is used when writing
- * results to a JSON file.  The object keys are terse and it only includes
- * the minimum set of fields (e.g., only the `maxDiff` value instead of the
- * full `DiffReport` for each comparison test) to keep the file smaller
- * when there are many reported differences.
- */
-interface SuiteSummary {
-    /** The date and time the suite was run (in ISO 8601 format, as generated by `Date.toISOString`). */
-    date: string;
-    /** The time in milliseconds that it took to run the suite. */
-    elapsed: number;
-    /** The check summary. */
-    checkSummary: CheckSummary;
-    /** The comparison summary (only defined if comparisons were enabled). */
-    comparisonSummary?: ComparisonSummary;
-}
-
-type CancelRunSuite = () => void;
-interface RunSuiteCallbacks {
-    onProgress?: (pct: number) => void;
-    onComplete?: (suiteReport: SuiteReport) => void;
-    onError?: (error: Error) => void;
-}
-interface RunSuiteOptions {
-    /**
-     * The check tests to skip.  Note that checks are matched by group and name
-     * (case insensitive).
-     */
-    skipChecks?: CheckNameSpec[];
-    /**
-     * The comparison scenarios to skip.  Note that scenarios are matched by
-     * title and subtitle (case insensitive).
-     */
-    skipComparisonScenarios?: ComparisonScenarioTitleSpec[];
-}
-/**
- * Run the full suite of checks and comparisons defined in the given configuration.
- *
- * @param config The test suite configuration.
- * @param callbacks The callbacks that will be notified.
- * @param options Options to control how the tests are run.
- * @return A function that will cancel the process when invoked.
- */
-declare function runSuite(config: Config, callbacks: RunSuiteCallbacks, options?: RunSuiteOptions): CancelRunSuite;
-
-/**
- * Convert a full `SuiteReport` to a simplified `SuiteSummary` that only includes
- * failed/errored checks or comparisons with differences.
- *
- * @param suiteReport The full suite report.
- * @param elapsedMillis The time in milliseconds that it took to run the suite.
- * @return The converted suite summary.
- */
-declare function suiteSummaryFromReport(suiteReport: SuiteReport, elapsedMillis: number): SuiteSummary;
-
-export { type AllInputsSpec, type Bundle, type BundleGraphData, type BundleGraphDatasetSpec, type BundleGraphId, type BundleGraphSpec, type BundleGraphView, type BundleGraphViewOptions, type BundleModel, type CancelRunPerf, type CancelRunSuite, type CancelRunTrace as CancelTrace, type CheckConfig, CheckDataCoordinator, type CheckDataRef, type CheckDataRefKey, type CheckDataRequestKey, type CheckDataset, type CheckDatasetError, type CheckDatasetReport, type CheckGroupReport, type CheckKey, type CheckNameSpec, type CheckOptions, type CheckPredicateOp, type CheckPredicateOpConstantRef, type CheckPredicateOpDataRef, type CheckPredicateOpRef, type CheckPredicateReport, type CheckPredicateSummary, type CheckPredicateTimeOptions, type CheckPredicateTimeRange, type CheckPredicateTimeSingle, type CheckPredicateTimeSpec, type CheckReport, type CheckResult, type CheckResultErrorInfo, type CheckScenario, type CheckScenarioError, type CheckScenarioInputDesc, type CheckScenarioReport, type CheckStatus, type CheckSummary, type CheckTestReport, type ComparisonCategorizedResults, type ComparisonConfig, ComparisonDataCoordinator, type ComparisonDataRequestKey, type ComparisonDataset, type ComparisonDatasetName, type ComparisonDatasetOptions, type ComparisonDatasetSource, type ComparisonDatasetSpec, type ComparisonDatasets, type ComparisonGraphGroup, type ComparisonGraphGroupId, type ComparisonGraphGroupRefSpec, type ComparisonGraphGroupSpec, type ComparisonGraphId, type ComparisonGraphsArraySpec, type ComparisonGraphsPresetSpec, type ComparisonGroup, type ComparisonGroupKey, type ComparisonGroupKind, type ComparisonGroupRoot, type ComparisonGroupScores, type ComparisonGroupSummariesByCategory, type ComparisonGroupSummary, type ComparisonOptions, type ComparisonPlot, type ComparisonReport, type ComparisonReportDetailItem, type ComparisonReportDetailRow, type ComparisonReportOptions, type ComparisonReportSummaryRow, type ComparisonReportSummarySection, type ComparisonResolverError, type ComparisonResolverUnknownInputError, type ComparisonResolverUnknownInputSettingGroupError, type ComparisonResolverValueOutOfRangeWarning, type ComparisonResolverWarning, type ComparisonScenario, type ComparisonScenarioAllInputsSettings, type ComparisonScenarioGroup, type ComparisonScenarioGroupId, type ComparisonScenarioGroupRefSpec, type ComparisonScenarioGroupSpec, type ComparisonScenarioGroupTitle, type ComparisonScenarioId, type ComparisonScenarioInput, type ComparisonScenarioInputAtPositionSpec, type ComparisonScenarioInputAtValueSpec, type ComparisonScenarioInputName, type ComparisonScenarioInputPosition, type ComparisonScenarioInputSettings, type ComparisonScenarioInputSpec, type ComparisonScenarioInputState, type ComparisonScenarioKey, type ComparisonScenarioPresetMatrixSpec, type ComparisonScenarioRefSpec, type ComparisonScenarioSettings, type ComparisonScenarioSpec, type ComparisonScenarioSubtitle, type ComparisonScenarioTitle, type ComparisonScenarioTitleSpec, type ComparisonScenarioWithAllInputsSpec, type ComparisonScenarioWithDistinctInputsSpec, type ComparisonScenarioWithInputsSpec, type ComparisonScenarioWithSettingGroupSpec, type ComparisonScenarios, type ComparisonSortMode, type ComparisonSpecs, type ComparisonSpecsSource, type ComparisonSummary, type ComparisonTestReport, type ComparisonTestSummary, type ComparisonUnresolvedScenarioGroupRef, type ComparisonUnresolvedScenarioRef, type ComparisonUnresolvedView, type ComparisonView, type ComparisonViewBox, type ComparisonViewBoxSpec, type ComparisonViewGraphOrder, type ComparisonViewGraphsSpec, type ComparisonViewGroup, type ComparisonViewGroupSpec, type ComparisonViewGroupTitle, type ComparisonViewGroupWithScenariosSpec, type ComparisonViewGroupWithViewsSpec, type ComparisonViewItemSubtitle, type ComparisonViewItemTitle, type ComparisonViewRow, type ComparisonViewRowSpec, type ComparisonViewRowSubtitle, type ComparisonViewRowTitle, type ComparisonViewSpec, type ComparisonViewSubtitle, type ComparisonViewTitle, type Config, type ConfigInitOptions, type ConfigOptions, type ConstantOverride, type DataSource, type Dataset, type DatasetGroupName, type DatasetKey, type DatasetMap, type DatasetsResult, type DiffPoint, type DiffReport, type DiffValidity, type EncodedImplVars, type EncodedSubscript, type EncodedVarInstance, type EncodedVarType, type EncodedVariable, type GetDatasetsOptions, type GraphComparisonDatasetReport, type GraphComparisonMetadataReport, type GraphComparisonReport, type GraphInclusion, type ImplVar, type ImplVarGroup, type InputAliasName, type InputGroupName, type InputId, type InputPosition, type InputSetting, type InputSettingGroupId, type InputSettingsSpec, type InputVar, type LegendItem, type LinkItem, type LoadedBundle, type LookupOverride, type ModelSpec, type NamedBundle, type OutputVar, type PerfReport, PerfStats, type PositionSetting, type RelatedItem, type RunPerfCallbacks, type RunPerfOptions, type RunSuiteCallbacks, type RunSuiteOptions, type ScenarioSpec, type ScenarioSpecUid, type SliderInputVar, type SourceName, type SuiteReport, type SuiteSummary, type SwitchInputVar, type RunTraceCallbacks as TraceCallbacks, type TraceCompareToBundleOptions, type TraceCompareToExtDataOptions, type TraceDatasetReport, type TraceOptions, type TraceReport, type ValueSetting, type VarId, categorizeComparisonTestSummaries, checkReportFromSummary, checkSummaryFromReport, comparisonSummaryFromReport, createCheckDataCoordinator, createCheckDataCoordinatorForTests, createComparisonDataCoordinator, createConfig, datasetMessage, decodeImplVars, diffDatasets, diffGraphs, encodeImplVars, getScoresForTestSummaries, predicateMessage, runPerf, runSuite, runTrace, scenarioMessage, suiteSummaryFromReport, testSummaryFromReport };