@sdeverywhere/check-core 0.1.4 → 0.1.5

package/dist/index.d.cts

@@ -149,6 +149,8 @@ interface ImplVar {
 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 dataset. */
 type DatasetGroupName = string;
 /**
@@ -235,6 +237,8 @@ interface ModelSpec {
     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. */
@@ -575,6 +579,21 @@ interface ComparisonScenarioWithDistinctInputsSpec {
     /** 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.
  */
@@ -603,7 +622,7 @@ interface ComparisonScenarioPresetMatrixSpec {
  * 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 | ComparisonScenarioWithAllInputsSpec | ComparisonScenarioPresetMatrixSpec;
+type ComparisonScenarioSpec = ComparisonScenarioWithInputsSpec | ComparisonScenarioWithDistinctInputsSpec | ComparisonScenarioWithSettingGroupSpec | ComparisonScenarioWithAllInputsSpec | ComparisonScenarioPresetMatrixSpec;
 /** A reference to a scenario definition. */
 interface ComparisonScenarioRefSpec {
     kind: 'scenario-ref';
@@ -809,10 +828,13 @@ type ComparisonScenarioKey = string & {
 interface ComparisonResolverUnknownInputError {
     kind: 'unknown-input';
 }
+interface ComparisonResolverUnknownInputSettingGroupError {
+    kind: 'unknown-input-setting-group';
+}
 interface ComparisonResolverInvalidValueError {
     kind: 'invalid-value';
 }
-type ComparisonResolverError = ComparisonResolverUnknownInputError | ComparisonResolverInvalidValueError;
+type ComparisonResolverError = ComparisonResolverUnknownInputError | ComparisonResolverUnknownInputSettingGroupError | ComparisonResolverInvalidValueError;
 /** 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. */
@@ -838,6 +860,12 @@ 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 {
@@ -1537,4 +1565,4 @@ declare function runSuite(config: Config, callbacks: RunSuiteCallbacks, options?
  */
 declare function suiteSummaryFromReport(suiteReport: SuiteReport): SuiteSummary;
 
-export { type AllInputsSpec, type Bundle, type BundleGraphData, type BundleGraphDatasetSpec, type BundleGraphId, type BundleGraphSpec, type BundleGraphView, type BundleModel, CheckDataCoordinator, type CheckDataRequestKey, type CheckDatasetReport, type CheckGroupReport, type CheckKey, 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 ComparisonResolverInvalidValueError, type ComparisonResolverUnknownInputError, 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 ComparisonScenarioWithAllInputsSpec, type ComparisonScenarioWithDistinctInputsSpec, type ComparisonScenarioWithInputsSpec, type ComparisonScenarios, 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 DataSource, type Dataset, type DatasetGroupName, type DatasetKey, type DatasetMap, type DatasetsResult, type DiffPoint, type DiffReport, type DiffValidity, type Dimension, type GraphComparisonDatasetReport, type GraphComparisonMetadataReport, type GraphComparisonReport, type GraphInclusion, type ImplVar, type InputAliasName, type InputGroupName, type InputId, type InputPosition, type InputSetting, type InputSettingsSpec, type InputVar, type LegendItem, type LinkItem, type LoadedBundle, type ModelSpec, type NamedBundle, type OutputVar, type PerfReport, PerfRunner, PerfStats, type PositionSetting, type RelatedItem, type RunSuiteCallbacks, type RunSuiteOptions, type ScenarioSpec, type ScenarioSpecUid, type SourceName, type Subscript, type SuiteReport, type SuiteSummary, type ValueSetting, type VarId, categorizeComparisonTestSummaries, checkReportFromSummary, checkSummaryFromReport, comparisonSummaryFromReport, createConfig, datasetMessage, diffDatasets, diffGraphs, getScoresForTestSummaries, predicateMessage, runSuite, scenarioMessage, suiteSummaryFromReport };
+export { type AllInputsSpec, type Bundle, type BundleGraphData, type BundleGraphDatasetSpec, type BundleGraphId, type BundleGraphSpec, type BundleGraphView, type BundleModel, CheckDataCoordinator, type CheckDataRequestKey, type CheckDatasetReport, type CheckGroupReport, type CheckKey, 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 ComparisonResolverInvalidValueError, type ComparisonResolverUnknownInputError, type ComparisonResolverUnknownInputSettingGroupError, 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 ComparisonScenarioWithAllInputsSpec, type ComparisonScenarioWithDistinctInputsSpec, type ComparisonScenarioWithInputsSpec, type ComparisonScenarioWithSettingGroupSpec, type ComparisonScenarios, 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 DataSource, type Dataset, type DatasetGroupName, type DatasetKey, type DatasetMap, type DatasetsResult, type DiffPoint, type DiffReport, type DiffValidity, type Dimension, type GraphComparisonDatasetReport, type GraphComparisonMetadataReport, type GraphComparisonReport, type GraphInclusion, type ImplVar, type InputAliasName, type InputGroupName, type InputId, type InputPosition, type InputSetting, type InputSettingGroupId, type InputSettingsSpec, type InputVar, type LegendItem, type LinkItem, type LoadedBundle, type ModelSpec, type NamedBundle, type OutputVar, type PerfReport, PerfRunner, PerfStats, type PositionSetting, type RelatedItem, type RunSuiteCallbacks, type RunSuiteOptions, type ScenarioSpec, type ScenarioSpecUid, type SourceName, type Subscript, type SuiteReport, type SuiteSummary, type ValueSetting, type VarId, categorizeComparisonTestSummaries, checkReportFromSummary, checkSummaryFromReport, comparisonSummaryFromReport, createConfig, datasetMessage, diffDatasets, diffGraphs, getScoresForTestSummaries, predicateMessage, runSuite, scenarioMessage, suiteSummaryFromReport };

package/dist/index.d.ts

@@ -149,6 +149,8 @@ interface ImplVar {
 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 dataset. */
 type DatasetGroupName = string;
 /**
@@ -235,6 +237,8 @@ interface ModelSpec {
     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. */
@@ -575,6 +579,21 @@ interface ComparisonScenarioWithDistinctInputsSpec {
     /** 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.
  */
@@ -603,7 +622,7 @@ interface ComparisonScenarioPresetMatrixSpec {
  * 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 | ComparisonScenarioWithAllInputsSpec | ComparisonScenarioPresetMatrixSpec;
+type ComparisonScenarioSpec = ComparisonScenarioWithInputsSpec | ComparisonScenarioWithDistinctInputsSpec | ComparisonScenarioWithSettingGroupSpec | ComparisonScenarioWithAllInputsSpec | ComparisonScenarioPresetMatrixSpec;
 /** A reference to a scenario definition. */
 interface ComparisonScenarioRefSpec {
     kind: 'scenario-ref';
@@ -809,10 +828,13 @@ type ComparisonScenarioKey = string & {
 interface ComparisonResolverUnknownInputError {
     kind: 'unknown-input';
 }
+interface ComparisonResolverUnknownInputSettingGroupError {
+    kind: 'unknown-input-setting-group';
+}
 interface ComparisonResolverInvalidValueError {
     kind: 'invalid-value';
 }
-type ComparisonResolverError = ComparisonResolverUnknownInputError | ComparisonResolverInvalidValueError;
+type ComparisonResolverError = ComparisonResolverUnknownInputError | ComparisonResolverUnknownInputSettingGroupError | ComparisonResolverInvalidValueError;
 /** 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. */
@@ -838,6 +860,12 @@ 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 {
@@ -1537,4 +1565,4 @@ declare function runSuite(config: Config, callbacks: RunSuiteCallbacks, options?
  */
 declare function suiteSummaryFromReport(suiteReport: SuiteReport): SuiteSummary;
 
-export { type AllInputsSpec, type Bundle, type BundleGraphData, type BundleGraphDatasetSpec, type BundleGraphId, type BundleGraphSpec, type BundleGraphView, type BundleModel, CheckDataCoordinator, type CheckDataRequestKey, type CheckDatasetReport, type CheckGroupReport, type CheckKey, 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 ComparisonResolverInvalidValueError, type ComparisonResolverUnknownInputError, 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 ComparisonScenarioWithAllInputsSpec, type ComparisonScenarioWithDistinctInputsSpec, type ComparisonScenarioWithInputsSpec, type ComparisonScenarios, 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 DataSource, type Dataset, type DatasetGroupName, type DatasetKey, type DatasetMap, type DatasetsResult, type DiffPoint, type DiffReport, type DiffValidity, type Dimension, type GraphComparisonDatasetReport, type GraphComparisonMetadataReport, type GraphComparisonReport, type GraphInclusion, type ImplVar, type InputAliasName, type InputGroupName, type InputId, type InputPosition, type InputSetting, type InputSettingsSpec, type InputVar, type LegendItem, type LinkItem, type LoadedBundle, type ModelSpec, type NamedBundle, type OutputVar, type PerfReport, PerfRunner, PerfStats, type PositionSetting, type RelatedItem, type RunSuiteCallbacks, type RunSuiteOptions, type ScenarioSpec, type ScenarioSpecUid, type SourceName, type Subscript, type SuiteReport, type SuiteSummary, type ValueSetting, type VarId, categorizeComparisonTestSummaries, checkReportFromSummary, checkSummaryFromReport, comparisonSummaryFromReport, createConfig, datasetMessage, diffDatasets, diffGraphs, getScoresForTestSummaries, predicateMessage, runSuite, scenarioMessage, suiteSummaryFromReport };
+export { type AllInputsSpec, type Bundle, type BundleGraphData, type BundleGraphDatasetSpec, type BundleGraphId, type BundleGraphSpec, type BundleGraphView, type BundleModel, CheckDataCoordinator, type CheckDataRequestKey, type CheckDatasetReport, type CheckGroupReport, type CheckKey, 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 ComparisonResolverInvalidValueError, type ComparisonResolverUnknownInputError, type ComparisonResolverUnknownInputSettingGroupError, 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 ComparisonScenarioWithAllInputsSpec, type ComparisonScenarioWithDistinctInputsSpec, type ComparisonScenarioWithInputsSpec, type ComparisonScenarioWithSettingGroupSpec, type ComparisonScenarios, 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 DataSource, type Dataset, type DatasetGroupName, type DatasetKey, type DatasetMap, type DatasetsResult, type DiffPoint, type DiffReport, type DiffValidity, type Dimension, type GraphComparisonDatasetReport, type GraphComparisonMetadataReport, type GraphComparisonReport, type GraphInclusion, type ImplVar, type InputAliasName, type InputGroupName, type InputId, type InputPosition, type InputSetting, type InputSettingGroupId, type InputSettingsSpec, type InputVar, type LegendItem, type LinkItem, type LoadedBundle, type ModelSpec, type NamedBundle, type OutputVar, type PerfReport, PerfRunner, PerfStats, type PositionSetting, type RelatedItem, type RunSuiteCallbacks, type RunSuiteOptions, type ScenarioSpec, type ScenarioSpecUid, type SourceName, type Subscript, type SuiteReport, type SuiteSummary, type ValueSetting, type VarId, categorizeComparisonTestSummaries, checkReportFromSummary, checkSummaryFromReport, comparisonSummaryFromReport, createConfig, datasetMessage, diffDatasets, diffGraphs, getScoresForTestSummaries, predicateMessage, runSuite, scenarioMessage, suiteSummaryFromReport };

package/dist/index.js

@@ -3084,6 +3084,7 @@ import { assertNever as assertNever11 } from "assert-never";
 // src/bundle/model-inputs.ts
 var ModelInputs = class {
   constructor(modelSpec) {
+    this.modelSpec = modelSpec;
     /** All inputs keyed by lookup name (lowercase variable name or alias). */
     this.inputsByLookupName = /* @__PURE__ */ new Map();
     /** All input ID aliases. */
@@ -3130,6 +3131,14 @@ var ModelInputs = class {
   getInputVarForName(name) {
     return this.inputsByLookupName.get(name.toLowerCase());
   }
+  /**
+   * Return the `InputVar` that matches the requested variable ID.
+   *
+   * @param varId The variable identifier to match.
+   */
+  getInputVarForVarId(varId) {
+    return this.modelSpec.inputVars.get(varId);
+  }
 };
 
 // src/comparison/config/resolve/comparison-scenario-specs.ts
@@ -3351,6 +3360,19 @@ function resolveScenariosFromSpec(modelInputsL, modelInputsR, scenarioSpec, genK
         )
       ];
     }
+    case "scenario-with-setting-group": {
+      return [
+        resolveScenarioForSettingGroup(
+          modelInputsL,
+          modelInputsR,
+          genKey(),
+          scenarioSpec.id,
+          scenarioSpec.title,
+          scenarioSpec.subtitle,
+          scenarioSpec.settingGroupId
+        )
+      ];
+    }
     default:
       assertNever11(scenarioSpec);
   }
@@ -3480,6 +3502,113 @@ function resolveScenarioForDistinctInputSpecs(modelInputsL, modelInputsR, key, i
     specR
   };
 }
+function resolveScenarioForSettingGroup(modelInputsL, modelInputsR, key, id, title, subtitle, settingGroupId) {
+  var _a, _b;
+  function inputVarNameForVarId(modelInputs, varId) {
+    const inputVar = modelInputs.getInputVarForVarId(varId);
+    if (inputVar !== void 0) {
+      return inputVar.varName;
+    } else {
+      return varId;
+    }
+  }
+  function inputPositionForPosition(position) {
+    switch (position) {
+      case "at-minimum":
+        return "min";
+      case "at-maximum":
+        return "max";
+      case "at-default":
+        return "default";
+      default:
+        throw new Error(`Unknown input position: ${position}`);
+    }
+  }
+  function inputSpecForSetting(modelInputs, inputSetting) {
+    switch (inputSetting.kind) {
+      case "position":
+        return {
+          kind: "input-at-position",
+          inputName: inputVarNameForVarId(modelInputs, inputSetting.inputVarId),
+          position: inputPositionForPosition(inputSetting.position)
+        };
+      case "value":
+        return {
+          kind: "input-at-value",
+          inputName: inputVarNameForVarId(modelInputs, inputSetting.inputVarId),
+          value: inputSetting.value
+        };
+      default:
+        throw new Error(`Unknown input setting kind: ${inputSetting}`);
+    }
+  }
+  function inputSpecsForSettingGroup(modelInputs, inputSettings) {
+    return inputSettings.map((inputSetting) => inputSpecForSetting(modelInputs, inputSetting));
+  }
+  const inputSettingsL = ((_a = modelInputsL.modelSpec.inputSettingGroups) == null ? void 0 : _a.get(settingGroupId)) || [];
+  const inputSettingsR = ((_b = modelInputsR.modelSpec.inputSettingGroups) == null ? void 0 : _b.get(settingGroupId)) || [];
+  const inputsL = inputSpecsForSettingGroup(modelInputsL, inputSettingsL);
+  const inputsR = inputSpecsForSettingGroup(modelInputsR, inputSettingsR);
+  const scenario = resolveScenarioForDistinctInputSpecs(
+    modelInputsL,
+    modelInputsR,
+    key,
+    id,
+    title,
+    subtitle,
+    inputsL,
+    inputsR
+  );
+  function scenarioString(scenario2) {
+    if (scenario2.kind === "input-settings") {
+      const settings = scenario2.settings.map((setting) => {
+        switch (setting.kind) {
+          case "position":
+            return `${setting.inputVarId}=${setting.position}`;
+          case "value":
+            return `${setting.inputVarId}=${setting.value}`;
+          default:
+            throw new Error(`Unexpected input setting kind: ${setting}`);
+        }
+      });
+      return settings.sort().join("__");
+    } else {
+      throw new Error(`Unexpected scenario spec kind: ${scenario2.kind}`);
+    }
+  }
+  function scenariosAreEqual(scenarioL, scenarioR) {
+    return scenarioString(scenarioL) === scenarioString(scenarioR);
+  }
+  function errorState(inputSettings) {
+    if (inputSettings.length === 0) {
+      return { error: { kind: "unknown-input-setting-group" } };
+    } else {
+      return {};
+    }
+  }
+  if (inputSettingsL.length === 0 || inputSettingsR.length === 0) {
+    if (scenario.settings.kind === "input-settings") {
+      const errorSetting = {
+        requestedName: settingGroupId,
+        stateL: errorState(inputSettingsL),
+        stateR: errorState(inputSettingsR)
+      };
+      scenario.settings.inputs.unshift(errorSetting);
+    }
+    if (inputSettingsL.length === 0) {
+      scenario.specL = void 0;
+    }
+    if (inputSettingsR.length === 0) {
+      scenario.specR = void 0;
+    }
+  }
+  if (scenario.settings.kind === "input-settings") {
+    if (scenario.specL && scenario.specR && !scenariosAreEqual(scenario.specL, scenario.specR)) {
+      scenario.settings.settingsDiffer = true;
+    }
+  }
+  return scenario;
+}
 function resolveInputForName(modelInputsL, modelInputsR, inputName, at) {
   return {
     requestedName: inputName,