chore(extras): polish axis auto-hide docs and tests

Co-authored-by: ivanvpetrov <110455887+ivanvpetrov@users.noreply.github.com>
Agent-Logs-Url: https://github.com/IgniteUI/igniteui-angular/sessions/0938b32f-510b-4e57-aa3b-bc186cb5b085

Author: Copilot

projects/igniteui-angular-extras/src/lib/directives/chart-integration/chart-integration.directive.spec.ts

@@ -291,7 +291,7 @@ describe('IgxChartIntegrationDirective', () => {
 
         it('should auto-hide y-axis and skip series creation when autoHideYAxisWhenNoData is enabled and no numeric values exist', () => {
             directive.autoHideYAxisWhenNoData = true;
-            directive.chartData = [{ name: 'A', value: Number.NaN }, { name: 'B', value: undefined as any }];
+            directive.chartData = [{ name: 'A', value: Number.NaN }, { name: 'B', value: Number.NaN }];
 
             const axisAddArgs: any[] = [];
             const seriesAddSpy = jasmine.createSpy('seriesAdd');

projects/igniteui-angular-extras/src/lib/directives/chart-integration/chart-integration.directive.ts

@@ -89,6 +89,13 @@ export class IgxChartIntegrationDirective {
     @Input()
     public defaultLabelMemberPath: string = undefined;
 
+    /**
+     * When set to `true`, the directive automatically hides the Y-axis if the
+     * selected numeric member paths do not contain finite numeric values in the
+     * current data view.
+     *
+     * @default false
+     */
     @Input()
     public autoHideYAxisWhenNoData = false;
 
@@ -285,17 +292,17 @@ export class IgxChartIntegrationDirective {
         const customComponentOptions: IChartComponentOptions = this.customChartComponentOptions.get(type) || {};
         const customChartOptions = customComponentOptions.chartOptions || {};
         const customSeriesModel = customComponentOptions.seriesModel || {};
-        const valueMemberPathsWithData = this._valueMemberPaths.filter(memberPath => this.hasSeriesData(memberPath));
-        const valueMemberPathsForSeries = this.autoHideYAxisWhenNoData ? valueMemberPathsWithData : this._valueMemberPaths;
+        const pathsWithData = this._valueMemberPaths.filter(memberPath => this.hasSeriesData(memberPath));
+        const seriesPaths = this.autoHideYAxisWhenNoData ? pathsWithData : this._valueMemberPaths;
         chartComponentOptions.chartOptions = { ...this.dataChartOptions, ...customChartOptions };
         if (type.indexOf('Scatter') !== -1) {
             this.addScatterChartDataOptions(type, chartComponentOptions);
         } else {
             chartComponentOptions.seriesModel = { ...this.dataChartSeriesOptionsModel, ...customSeriesModel };
-            const hideYAxis = this.autoHideYAxisWhenNoData && valueMemberPathsWithData.length === 0;
+            const hideYAxis = this.autoHideYAxisWhenNoData && pathsWithData.length === 0;
             this.setAxisLabelOption(type, chartComponentOptions, hideYAxis);
             const options: IOptions[] = [];
-            valueMemberPathsForSeries.forEach(valueMemberPath => {
+            seriesPaths.forEach(valueMemberPath => {
                 const dataOptions = {
                     title: valueMemberPath,
                     valueMemberPath
@@ -352,6 +359,13 @@ export class IgxChartIntegrationDirective {
         return dataRecord;
     }
 
+    /**
+     * Checks whether the current data set contains at least one finite numeric
+     * value for the provided member path.
+     *
+     * @param memberPath The numeric member path to inspect.
+     * @returns `true` when at least one finite number exists for the path.
+     */
     private hasSeriesData(memberPath: string): boolean {
         return this._chartData.some(record => Number.isFinite(record[memberPath]));
     }