@arcgis/charts-components 5.0.0-next.13 → 5.0.0-next.130

package/dist/model/serial-chart-model/utils/serial-chart-series.d.ts

@@ -24,65 +24,66 @@ export declare const setAssignToSecondValueAxis: (props: {
 }) => void;
 /**
  * Gets the name of the series for the provided index.
- * @param {number} seriesIndex - The index of the series.
- * @param {ChartConfig} config - The chart configuration.
- * @returns {string | undefined}
+ *
+ * @param seriesIndex - The index of the series.
+ * @param config - The chart configuration.
  */
 export declare const getSeriesName: (seriesIndex: number, config: ChartConfig) => string | undefined;
 /**
  * Sets the name of the series for the provided index.
- * @param {string} newName - The new name for the series.
- * @param {number} seriesIndex - The index of the series.
- * @param {ChartConfig} config - The chart configuration.
+ *
+ * @param newName - The new name for the series.
+ * @param seriesIndex - The index of the series.
+ * @param config - The chart configuration.
  */
 export declare const setSeriesName: (newName: string, seriesIndex: number, config: ChartConfig) => void;
 /**
  * Gets the color of the series for the provided index.
- * @param {number} seriesIndex - The index of the series.
- * @param {ChartConfig} config - The chart configuration.
- * @returns {Color | undefined}
+ *
+ * @param seriesIndex - The index of the series.
+ * @param config - The chart configuration.
  */
 export declare const getSeriesColor: (seriesIndex: number, config: ChartConfig) => Color | undefined;
 /**
  * Sets the color of the series for the provided index.
- * @param {Color | undefined} newColor - The new color for the series.
- * @param {number} seriesIndex - The index of the series.
- * @param {ChartConfig} config - The chart configuration.
+ *
+ * @param newColor - The new color for the series.
+ * @param seriesIndex - The index of the series.
+ * @param config - The chart configuration.
  */
 export declare const setSeriesColor: (newColor: Color | undefined, seriesIndex: number, config: ChartConfig) => void;
 /**
  * Gets the list of series IDs in the order they appear in the chart config.
- * @param {ChartConfig} config - The chart configuration.
- * @returns {WebChartTypes | undefined}
+ *
+ * @param config - The chart configuration.
  */
 export declare const getOrderOfSeries: (config: ChartConfig) => string[];
 /**
  * Updates the order of the series in the chart config.
- * @param {string[]} newSeriesOrder - The new order of the series.
- * @param {ChartConfig} config - The chart configuration.
+ *
+ * @param newSeriesOrder - The new order of the series.
+ * @param config - The chart configuration.
  */
 export declare const setOrderOfSeries: (newSeriesOrder: string[], config: ChartConfig) => void;
 /**
  * Gets how the bars/lines should be placed when multiple series are rendered in the same chart, say when "split by" operation is executed on any field or
  * when multiple attributes/fields corresponding to the same set of classes are to be visualized.
  *
- * Currently this property is only used for bar and line series.
+ * **Note**: Currently this property is only used for bar and line series.
  *
- * @param {SerialChartConfig} config - The chart configuration.
- * @default sideBySide
+ * @param config - The chart configuration.
  */
 export declare const getStackedType: (config: SerialChartConfig) => WebChartStackedKinds | undefined;
 /**
  * Sets how the bars/lines should be placed when multiple series are rendered in the same chart, say when "split by" operation is executed on any field or
  * when multiple attributes/fields corresponding to the same set of classes are to be visualized.
  *
- * Currently this property is only used for bar and line series.
+ * **Note**: Currently this property is only used for bar and line series.
  *
- * @param {SerialChartConfig} props.config - The chart configuration.
- * @param {WebChartStackedKinds | undefined} props.newStackedType - The new stacked type.
- * @param {LayerInfo | undefined} props.layerInfo - The layer information.
- * @param {CommonStrings} props.commonStrings - The common strings.
- * @default sideBySide
+ * @param props.newStackedType - The new stacked type.
+ * @param props.config - The chart configuration.
+ * @param props.layerInfo - The layer information.
+ * @param props.commonStrings - The common strings.
  */
 export declare const setStackedType: (props: {
     newStackedType: WebChartStackedKinds | undefined;
@@ -91,17 +92,15 @@ export declare const setStackedType: (props: {
     commonStrings: CommonStrings;
 }) => void;
 /**
- * Gets the `nullCategory` for the chart series.
+ * Gets the `nullCategory` for the chart series. The `nullCategory` containing text and color, or undefined if not found.
  *
- * @param {SerialChartConfig} config The chart configuration.
- * @returns {WebChartNullCategory | undefined}
- *          The nullCategory containing text and color, or undefined if not found.
+ * @param config - The chart configuration.
  */
 export declare const getNullCategory: (config: SerialChartConfig) => WebChartNullCategory | undefined;
 /**
  * Sets the `nullCategory` for all bar and line chart series in the given chart config.
  *
- * @param {SerialChartConfig} config The chart configuration.
- * @param {WebChartNullCategory} nullCategory The nullCategory object containing text and color.
+ * @param config - The chart configuration.
+ * @param nullCategory - The nullCategory object containing text and color.
  */
 export declare const setNullCategory: (config: SerialChartConfig, nullCategory?: WebChartNullCategory) => void;

package/dist/model/shared/axes.d.ts

@@ -30,10 +30,11 @@ export declare const setAxis: (props: {
     axisIndex: number;
 }) => void;
 /**
- * Get the maximum or minimum bound of the axis
- * @param {WebChart} props.config - the config object
- * @param {number} props.axisIndex - the index of the axis
- * @param {boolean} props.isMax - whether it is the max bound or not
+ * Get the maximum or minimum bound of the axis.
+ *
+ * @param props.config - the config object
+ * @param props.axisIndex - the index of the axis
+ * @param props.isMax - whether it is the max bound or not
  */
 export declare const getAxisBound: (props: {
     config: WebChart;
@@ -41,11 +42,12 @@ export declare const getAxisBound: (props: {
     isMax: boolean;
 }) => number;
 /**
- * Set the axis bound
- * @param {WebChart} props.config - the config object
- * @param {number | null} props.value - the value to set
- * @param {number} props.axisIndex - the index of the axis
- * @param {boolean} props.isMax - whether it is the max bound
+ * Set the axis bound.
+ *
+ * @param props.config - the config object
+ * @param props.value - the value to set
+ * @param props.axisIndex - the index of the axis
+ * @param props.isMax - whether it is the max bound
  */
 export declare const setAxisBound: (props: {
     config: WebChart;
@@ -54,24 +56,10 @@ export declare const setAxisBound: (props: {
     isMax: boolean;
 }) => void;
 /**
- * Set the minimum X bound
- * @param config - the config object
- * @param newMinXBound - the value to set
- */
-export declare const setMinXBound: (config: ChartConfig, newMinXBound: number | null) => void;
-/**
- * Get the valueFormat of the x-axis
- * @param config
- * @returns
+ * Get the valueFormat of the x-axis.
  */
 export declare const getXAxisValueFormat: (config: ChartConfig) => CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions | undefined;
 export declare const setXAxisValueFormat: (config: ChartConfig, commonStrings: CommonStrings, valueFormat?: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions) => void;
-/**
- * Get the valueFormat of the y-axis
- * @param config - the config object
- */
-export declare const getYAxisValueFormat: (config: ChartConfig) => NumberFormatOptions | undefined;
-export declare const setYAxisValueFormat: (config: ChartConfig, commonStrings: CommonStrings, valueFormat?: NumberFormatOptions) => void;
 /**
  * Set the integer only values in the axis
  * @param config - the config object
@@ -88,10 +76,10 @@ export declare const isDualAxisSupported: (config: WebChart) => boolean;
 /**
  * Validates the axis index based on the chart configuration and whether it supports dual axes.
  *
- * @param {number} props.axisIndex - axisIndex The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
- * @param {WebChart} props.config - config The chart config.
- * @param {boolean} [props.isMultiAxis] - isMultiAxis Optional flag indicating if the chart supports multiple axes (has a x-axis and y-axis).
- * @returns {boolean} - Returns true if the axis index is valid, false otherwise.
+ * @param props.axisIndex - The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
+ * @param props.config - The chart config.
+ * @param props.isMultiAxis - Optional flag indicating if the chart supports multiple axes (has a x-axis and y-axis).
+ * @returns Returns `true` if the axis index is valid, `false` otherwise.
  */
 export declare const validateAxisIndex: (props: {
     axisIndex: number;
@@ -102,9 +90,9 @@ export declare const validateAxisIndex: (props: {
  * Run a util function on valid axis, ensuring that only valid changes are applied on the valid axes.
  * If the index is invalid, it returns undefined.
  *
- * @param {number} props.axisIndex - The index of the axis to validate (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
- * @param {function} props.func - The function to run with the valid axis index.
- * @param {WebChart} props.config - The chart configuration object.
+ * @param props.axisIndex - The index of the axis to validate (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
+ * @param props.func - The function to run with the valid axis index.
+ * @param props.config - The chart configuration object.
  */
 export declare const runWithDualAxisGuard: <T>(props: {
     axisIndex: number;
@@ -112,17 +100,19 @@ export declare const runWithDualAxisGuard: <T>(props: {
     config: WebChart;
 }) => T | undefined;
 /**
- * Get the value format of the axis based on the axis index
- * @param {number} axisIndex The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
- * @returns {CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions | undefined} The value format options for the specified axis index
+ * Get the value format of the axis based on the axis index.
+ *
+ * @param axisIndex The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
+ * @returns The value format options for the specified axis index
  */
 export declare const getAxisValueFormat: (axisIndex: number, config: WebChart) => CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions | undefined;
 /**
  * Sets the value format for the specified axis.
- * @param {WebChart} props.config - The chart configuration object
- * @param {CommonStrings} props.commonStrings - Common strings
- * @param {CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions} [props.valueFormat] - The value format to set
- * @param {number} [props.axisIndex=0] - The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis)
+ *
+ * @param props.config - The chart configuration object
+ * @param props.commonStrings - Common strings
+ * @param props.valueFormat - The value format to set
+ * @param props.axisIndex - The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis)
  */
 export declare const setAxisValueFormat: (props: {
     config: WebChart;
@@ -132,23 +122,21 @@ export declare const setAxisValueFormat: (props: {
 }) => void;
 /**
  * Gets whether logarithmic scale is enabled for the specified axis.
- * @param {WebChart} config The chart configuration object.
- * @param {number} axisIndex The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
- *
- * `true`: Logarithmic scale is enabled for the specified axis.
- *
- * `false`: Logarithmic scale is disabled for the specified axis.
+ * - `true`: Logarithmic scale is enabled for the specified axis.
+ * - `false`: Logarithmic scale is disabled for the specified axis.
  *
- * @returns {boolean}
+ * @param config - The chart configuration object.
+ * @param axisIndex - The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
  */
 export declare const getAxisLogarithmic: (config: WebChart, axisIndex: number) => boolean;
 /**
  * Sets whether logarithmic scale is enabled for the specified axis.
- * `true`: Enable logarithmic scale for the specified axis.
- * `false`: Disable logarithmic scale for the specified axis.
- * @param {WebChart} props.config The chart configuration object.
- * @param {boolean} props.isLogarithmic Whether to enable logarithmic scale for the specified axis.
- * @param {number} props.axisIndex The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
+ * - `true`: Enable logarithmic scale for the specified axis.
+ * - `false`: Disable logarithmic scale for the specified axis.
+ *
+ * @param props.config - The chart configuration object.
+ * @param props.isLogarithmic - Whether to enable logarithmic scale for the specified axis.
+ * @param props.axisIndex - The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
  */
 export declare const setAxisLogarithmic: (props: {
     config: WebChart;
@@ -157,15 +145,17 @@ export declare const setAxisLogarithmic: (props: {
 }) => void;
 /**
  * Gets the scrollbar configuration for the specified axis.
- * @param {WebChart} config The chart configuration object.
- * @param {number} axisIndex The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
- * @returns {WebChartAxisScrollBar | undefined} The scrollbar configuration for the specified axis.
+ *
+ * @param config - The chart configuration object.
+ * @param axisIndex - The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
+ * @returns The scrollbar configuration for the specified axis.
  */
 export declare const getAxisScrollbar: (config: WebChart, axisIndex: number) => WebChartAxisScrollBar | undefined;
 /**
  * Sets the scrollbar configuration for the specified axis.
- * @param {WebChartAxisScrollBar} scrollbar The scrollbar configuration to set.
- * @param {number} axisIndex The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
+ *
+ * @param scrollbar - The scrollbar configuration to set.
+ * @param axisIndex - The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
  */
 export declare const setAxisScrollbar: (props: {
     config: WebChart;

package/dist/model/shared/data.d.ts

@@ -1,19 +1,34 @@
+import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
+import { SupportedLayer } from '../../interfaces';
+import { IField, WebChartOrderDataByTypes, WebChartSortOrderKinds, WebChartStatisticType } from '../../spec';
 import { ChartConfig } from '../../utils';
-import { SupportedLayer, WebChartStatisticType } from '../../spec';
-import { PieChartDataModes, SerialChartDataSortingKinds } from '../interfaces/common';
 import { SerialChartConfig } from '../interfaces/chart-interfaces';
-import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
+import { HeatChartDataSortingKinds, PieChartDataModes, SerialChartDataSortingKinds } from '../interfaces/common';
+/**
+ * Gets the sort order kind for serial charts.
+ * @param orderBy The order by value(s)
+ * @param orderType The order type value
+ * @returns
+ */
+export declare function getSerialChartSortOrderKind(orderBy: string[] | WebChartSortOrderKinds, orderType: Omit<WebChartOrderDataByTypes, "arcgis-charts-multi-axes">): SerialChartDataSortingKinds;
+/**
+ * Gets the sort order kind for heat charts.
+ * @param orderBy The order by value(s)
+ * @param orderType The order type value
+ * @returns
+ */
+export declare function getHeatChartSortOrderKind(orderBy: string[] | WebChartSortOrderKinds, orderType: Omit<WebChartOrderDataByTypes, "arcgis-charts-multi-axes">): HeatChartDataSortingKinds;
 /**
- * Get the sort order kind for the bar and line chart
- * @param {SerialChartConfig} config - the chart configuration
+ * Get the sort order kind for the bar and line chart.
  *
- * @returns {SerialChartDataSortingKinds}
+ * @param config - the chart configuration
  */
 export declare const getSortOrderKindForBarLineChart: (config: SerialChartConfig) => SerialChartDataSortingKinds;
 /**
  * Check if custom sort is enabled based on the chart type.
- * @param {SerialChartConfig} config - The chart config.
- * @returns {boolean} - True if custom sort is enabled, otherwise false.
+ *
+ * @param config - The chart config.
+ * @returns True if custom sort is enabled, otherwise false.
  */
 export declare const isCustomSortEnabled: (config: SerialChartConfig) => boolean;
 /**
@@ -25,30 +40,36 @@ export declare const isCustomSortEnabled: (config: SerialChartConfig) => boolean
  */
 export declare const getOrderByList: (config: SerialChartConfig) => string[];
 /**
- * Set the sort order kind for the bar and line chart
- * @param {SerialChartDataSortingKinds} newSortOrderKind - the new sort order kind
- * @param {ChartConfig} config - the chart configuration
- * @param {string[] | undefined} orderByList - the list of fields to order by
+ * Set the sort order kind for the bar and line chart.
+ *
+ * @param newSortOrderKind - the new sort order kind
+ * @param config - the chart configuration
+ * @param orderByList - the list of fields to order by
+ * @param isYAxis - whether to set the sort order for y-axis (heat chart only)
  */
-export declare const setSortOrderKind: (newSortOrderKind: SerialChartDataSortingKinds, config: ChartConfig, orderByList?: string[]) => void;
+export declare const setSortOrderKind: (newSortOrderKind: HeatChartDataSortingKinds | SerialChartDataSortingKinds, config: ChartConfig, orderByList?: string[], isYAxis?: boolean) => void;
 /**
  * Gets the x-axis field.
- * @param {ChartConfig} config - The chart config.
- * @returns {string}
+ *
+ * @param config - The chart config.
  */
 export declare const getXAxisField: (config: ChartConfig) => string;
 /**
  * Get the name and description for the series.y based on the chart type and sub-type.
  * This function is used to determine the name and description for the y-axis in the chart configuration.
  *
- * @param {ChartConfig} props.config - The chart configuration object.
- * @param {string} props.xAxisField - The field used for the x-axis.
- * @param {string[]} props.numericFields - The list of numeric fields available in the data.
- * @param {WebChartStatisticType} props.aggregationType - The type of aggregation to apply to the numeric fields.
- * @param {PieChartDataModes} [props.mode] - [Optional] The mode for pie chart data, if applicable.
- * @param {FeatureLayerView | SupportedLayer} [props.layer] - [Optional] The layer from which the data is being queried.
+ * @param props.config - The chart configuration object.
+ * @param props.xAxisField - The field used for the x-axis.
+ * @param props.numericFields - The list of numeric fields available in the data.
+ * @param props.aggregationType - The type of aggregation to apply to the numeric fields.
+ * @param props.mode - The mode for pie chart data, if applicable.
+ * @param props.layer - The layer from which the data is being queried.
+ * @param props.numericFieldIndex - The index of the numeric field to use when multiple fields are available.
+ * @param props.seriesIndex - The index of the series being configured, useful when multiple series exist.
+ * @param props.splitByField - The field used to split the data into multiple series.
+ * @param props.fieldList - List of fields to use instead of fetching them from the layer.
  *
- * @returns {Object} An object containing the name and description for the series.y field.
+ * @returns An object containing the name and description for the series.y field.
  */
 export declare const getYForNewSeries: (props: {
     config: ChartConfig;
@@ -60,11 +81,49 @@ export declare const getYForNewSeries: (props: {
     numericFieldIndex?: number;
     seriesIndex?: number;
     splitByField?: string;
+    fieldList?: IField[];
 }) => {
     name: string;
     description: string;
 };
+/**
+ * Determines if the x-axis field is considered "empty" for chart from fields scenarios.
+ *
+ * An x-axis field is considered empty when:
+ * - the x-axis field is not defined, or
+ * - the x-axis field is an empty string, or
+ * - the x-axis field does not match any of the layer fields
+ * - the x-axis field is set to the default "from fields" variation name
+ *
+ * @param props.fieldName - The field used for the x-axis.
+ * @param props.fieldList - list of fields to use instead of fetching them from the layer
+ *
+ * @returns `true` if the x-axis field is empty, otherwise `false`.
+ */
+export declare function xAxisFieldIsEmpty(props: {
+    fieldName: string;
+    fieldList: IField[];
+}): boolean;
 /**
  * Determines if the chart should be built as a "chart from fields" based on the x-axis field and numeric fields.
+ *
+ * This is true when `xAxisFieldIsEmpty` returns true, meaning:
+ * - the x-axis field is not defined, or
+ * - the x-axis field is an empty string, or
+ * - the x-axis field does not match any of the layer fields
+ * - the x-axis field is set to the default "from fields" variation name
+ *
+ * AND
+ *
+ * - there is at least one numeric field available (excluding objectId field)
+ *
+ * @param props.fieldName - The field used for the x-axis.
+ * @param props.numericFields - The list of numeric fields.
+ * @param props.queryObject - the query object (feature layer or feature layer view)
+ * @param props.fieldList - list of fields to use instead of fetching them from the layer
  */
-export declare function shouldUseChartFromFields(xAxisField?: string, numericFields?: string[]): boolean;
+export declare function shouldUseChartFromFields(props: {
+    fieldName: string;
+    numericFields: string[];
+    fieldList: IField[];
+}): boolean;

package/dist/model/shared/model-types.d.ts

@@ -1,4 +1,4 @@
-import { ChartConfig, ChartTypes } from '../../utils';
+import { ChartTypes, ChartConfig } from '../../utils';
 import { ModelOfType, ModelTypes } from '../interfaces/common';
 import { ChartModel } from '../chart-model/chart-model';
 /**

package/dist/model/shared/setup-utils.d.ts

@@ -1,64 +1,61 @@
-import { ChartConfig } from '../../utils';
-import { IFeatureLayer, SupportedLayer } from '../../spec';
 import { ModelOfType, ModelTypes } from '../interfaces/common';
-declare namespace CreateModelPropsOptions {
-    /**
-     * Properties used by the `createModel` function to create a new model based on the provided `layer` and `chartType`.
-     *
-     * A new model of the specified type will be created using default values.
-     */
-    type LayerAndType<T extends ModelTypes> = {
-        layer: SupportedLayer;
-        chartType: T;
-    };
-    /**
-     * Properties used by the `createModel` function to create a new model based on the provided `iLayer` and `chartType`.
-     *
-     * A new model of the specified type will be created using default values.
-     */
-    type ILayerAndType<T extends ModelTypes> = {
-        iLayer: IFeatureLayer;
-        chartType: T;
-    };
-    /**
-     * Properties used by the `createModel` function to create a new model based on the provided `iLayer` and `config`.
-     *
-     * The `config` is considered "sourceless" since its `iLayer` property is not required.
-     */
-    type LayerAndSourcelessConfig<T extends ModelTypes> = {
-        layer: SupportedLayer;
-        config: ChartConfig<T>;
-    };
-    /**
-     * Properties used by the `createModel` function to create a new model based on the provided `iLayer` and `config`.
-     *
-     * The `config` is considered "sourceless" since its `iLayer` property is not required.
-     */
-    type ILayerAndSourcelessConfig<T extends ModelTypes> = {
-        iLayer: IFeatureLayer;
-        config: ChartConfig<T>;
-    };
-    /**
-     * Properties used by the `createModel` function to create a new model based on the provided `config`.
-     *
-     * **Note: The `config` must have its `iLayer` property (source) defined.**
-     */
-    type SourcedConfig<T extends ModelTypes> = {
-        config: ChartConfig<T>;
-    };
-}
+import { SupportedLayer } from '../../interfaces';
+import { IFeatureLayer } from '../../spec/rest-js-types';
+import { ChartConfig } from '../../utils/types/index';
 /**
- * Properties used by the `createModel` function to create a new model.
+ * Properties used by the `createModel` function to create a new model based on the provided `layer` and `chartType`.
  *
+ * A new model of the specified type will be created using default values.
+ */
+type LayerAndType<T extends ModelTypes> = {
+    layer: SupportedLayer;
+    chartType: T;
+};
+/**
+ * Properties used by the `createModel` function to create a new model based on the provided `iLayer` and `chartType`.
+ *
+ * A new model of the specified type will be created using default values.
+ */
+type ILayerAndType<T extends ModelTypes> = {
+    iLayer: IFeatureLayer;
+    chartType: T;
+};
+/**
+ * Properties used by the `createModel` function to create a new model based on the provided `iLayer` and `config`.
+ *
+ * The `config` is considered "sourceless" since its `iLayer` property is not required.
+ */
+type LayerAndSourcelessConfig<T extends ModelTypes> = {
+    layer: SupportedLayer;
+    config: ChartConfig<T>;
+};
+/**
+ * Properties used by the `createModel` function to create a new model based on the provided `iLayer` and `config`.
+ *
+ * The `config` is considered "sourceless" since its `iLayer` property is not required.
+ */
+type ILayerAndSourcelessConfig<T extends ModelTypes> = {
+    iLayer: IFeatureLayer;
+    config: ChartConfig<T>;
+};
+/**
+ * Properties used by the `createModel` function to create a new model based on the provided `config`.
+ *
+ * **Note: The `config` must have its `iLayer` property (source) defined.**
+ */
+type SourcedConfig<T extends ModelTypes> = {
+    config: ChartConfig<T>;
+};
+/**
+ * Properties used by the `createModel` function to create a new model.
  * Various combinations of `layer`, `iLayer`, `chartType`, and `config` are supported.
  */
-type CreateModelProps<T extends ModelTypes> = CreateModelPropsOptions.ILayerAndSourcelessConfig<T> | CreateModelPropsOptions.ILayerAndType<T> | CreateModelPropsOptions.LayerAndSourcelessConfig<T> | CreateModelPropsOptions.LayerAndType<T> | CreateModelPropsOptions.SourcedConfig<T>;
+type CreateModelProps<T extends ModelTypes> = ILayerAndSourcelessConfig<T> | ILayerAndType<T> | LayerAndSourcelessConfig<T> | LayerAndType<T> | SourcedConfig<T>;
 /**
  * Creates a new chart model for config interaction based on the provided properties.
- *
  * Various combinations of properties `layer`, `iLayer`, `chartType`, and `config` are supported.
  *
- * @param {CreateModelProps} props - The properties used to set up the chart.
+ * @param props - The properties used to set up the chart.
  */
 export declare function createModel<T extends ModelTypes>(props: CreateModelProps<T>): Promise<ModelOfType<T>>;
 export {};