@sisense/sdk-ui 2.11.0 → 2.12.0

package/dist/packages/sdk-ui/src/analytics-composer/nlq-v3-translator/types.d.ts

@@ -0,0 +1,46 @@
+import { Filter, FilterRelations, JSONArray, JSONValue, Measure } from '@sisense/sdk-data';
+import { DataSchemaContext, NlqTranslationInput } from '../types';
+export declare const ATTRIBUTE_PREFIX = "DM.";
+export type ArgType = 'string' | 'string[]' | 'number' | 'number[]' | 'boolean' | 'Attribute' | 'Attribute[]' | 'Measure' | 'BaseMeasure' | 'Measure[]' | 'Filter' | 'Filter[]' | 'FilterRelationsNode' | 'DateDimension' | 'LevelAttribute' | 'Measure | number' | 'Date | string' | 'string | number' | 'BaseFilterConfig' | 'MembersFilterConfig' | 'CustomFormulaContext' | 'any';
+export interface ArgSchema {
+    type: ArgType;
+    required: boolean;
+}
+export type Arg = string | number | FunctionCall | string[];
+export type ProcessedArg = unknown;
+export type QueryElement = Filter | FilterRelations | Measure;
+export type FactoryFunction = (...args: unknown[]) => QueryElement;
+export type FunctionCall = {
+    function: string;
+    args: Arg[];
+};
+/**
+ * Context object passed to all custom processors containing runtime information
+ * needed for processing.
+ */
+export interface FunctionContext extends DataSchemaContext {
+    /** Path prefix for error messages (e.g., 'args[0].function') */
+    pathPrefix: string;
+}
+export interface ArgContext extends FunctionContext {
+    argSchema: ArgSchema;
+}
+export type DimensionsInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
+export type MeasuresInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
+export type FiltersInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
+export type HighlightsInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
+export type MeasuresFunctionCallInput = NlqTranslationInput<FunctionCall[], DataSchemaContext>;
+export type FiltersFunctionCallInput = NlqTranslationInput<FunctionCall[], DataSchemaContext>;
+export type HighlightsFunctionCallInput = NlqTranslationInput<FunctionCall[], DataSchemaContext>;
+export type NodeInput = NlqTranslationInput<FunctionCall, FunctionContext>;
+export type ArgInput = NlqTranslationInput<Arg, ArgContext>;
+/**
+ * Custom processor function signature.
+ */
+export type CustomFunctionProcessor = (processedArgs: ProcessedArg[], context: FunctionContext) => void;
+export declare function isFunctionCall(value: JSONValue): value is FunctionCall;
+export declare function isFunctionCallArray(value: JSONArray): value is FunctionCall[];
+export declare function isFilterElement(arg: QueryElement): arg is Filter;
+export declare function isFilterRelationsElement(arg: QueryElement): arg is FilterRelations;
+export declare function isMeasureElement(arg: QueryElement): arg is Measure;
+export declare function isStringArray(value: JSONArray): value is string[];

package/dist/packages/sdk-ui/src/analytics-composer/query/query-translator.d.ts

@@ -1,5 +1,5 @@
-import { ExpandedQueryModel, SimpleQueryModel, SimpleChartRecommendations, ChartRecommendations } from '../types.js';
-import { MetadataItem, MetadataItemJaql, DataSourceField } from '@sisense/sdk-data';
+import { DataSourceField, MetadataItem, MetadataItemJaql } from '@sisense/sdk-data';
+import { ChartRecommendations, ExpandedQueryModel, SimpleChartRecommendations, SimpleQueryModel } from '../types.js';
 /**
  * A class that translates ExpandedQueryModel (Raw JAQL+Chart Recommendations)
  * to SimpleQueryModel (Simple JAQL+Simple Chart Options) and vice versa.

package/dist/packages/sdk-ui/src/analytics-composer/types.d.ts

@@ -1,10 +1,10 @@
-import { WidgetProps, ChartWidgetProps, PivotTableWidgetProps } from '../props';
-import { ChartDataOptions, ChartStyleOptions } from '../types';
-import { ExecuteQueryParams, ExecutePivotQueryParams } from '../query-execution';
-import { JSONArray, MetadataItem } from '@sisense/sdk-data';
-import { DynamicChartType } from '../chart-options-processor/translations/types.js';
+import { JaqlDataSourceForDto, JSONArray, JSONValue, MetadataItem } from '@sisense/sdk-data';
 import { AnyColumn } from '../chart-data-options/types.js';
 import { DashboardProps } from '../dashboard/types.js';
+import { ChartWidgetProps, PivotTableWidgetProps, WidgetProps } from '../props';
+import { ExecutePivotQueryParams, ExecuteQueryParams } from '../query-execution';
+import { ChartDataOptions, ChartStyleOptions } from '../types';
+import { DynamicChartType } from '../chart-options-processor/translations/types.js';
 type Stringify<T> = {
     [K in keyof T as `${K & string}String`]: string;
 };
@@ -152,6 +152,7 @@ export type WidgetCodeConfig = BaseCodeConfig & {
  */
 export type ClientSideWidgetCodeParams = BaseCodeConfig & {
     widgetProps: WidgetProps;
+    removeDefaultProps?: boolean;
 };
 /**
  * By ID Widget Code Params
@@ -305,6 +306,15 @@ export type NormalizedTable = {
     name: string;
     columns: NormalizedField[];
 };
+/**
+ * NLQ generic input with context for translation
+ *
+ * @internal
+ */
+export type NlqTranslationInput<DataType, ContextType> = {
+    data: DataType;
+    context: ContextType;
+};
 /**
  * Response JSON generated by the new NLQ API.
  *
@@ -317,15 +327,66 @@ export type NlqResponseJSON = {
     highlights?: JSONArray;
 };
 /**
- * Represents the result of a translation operation that can either succeed with data or fail with errors.
+ * Data schema context for translation
  *
  * @internal
  */
-export type NlqTranslationResult<T> = {
+export interface DataSchemaContext {
+    /** The data source being used for the query */
+    dataSource: JaqlDataSourceForDto;
+    /** Available tables for attribute resolution */
+    tables: NormalizedTable[];
+}
+/**
+ * Query input for translation
+ *
+ * @internal
+ */
+export type QueryInput = NlqTranslationInput<NlqResponseJSON, DataSchemaContext>;
+/**
+ * Context information for error generation
+ *
+ * @internal
+ */
+export type NlqTranslationErrorContext = {
+    /** The category of the query element that failed (dimensions, measures, filters, highlights) */
+    category: 'dimensions' | 'measures' | 'filters' | 'highlights';
+    /** The index of the element within its category array */
+    index: number;
+    /** The complete original input that caused the error */
+    input: JSONValue;
+};
+/**
+ * Structured error information for translation failures.
+ *
+ * @internal
+ */
+export type NlqTranslationError = NlqTranslationErrorContext & {
+    /** Human-readable error message describing what went wrong */
+    message: string;
+};
+/**
+ * Structured error response format for translation failures.
+ *
+ * @internal
+ */
+export type NlqTranslationErrorResult = {
+    success: false;
+    errors: NlqTranslationError[];
+};
+/**
+ * Success response format for translation operations.
+ *
+ * @internal
+ */
+export type NlqTranslationSuccessResult<T> = {
     success: true;
     data: T;
-} | {
-    success: false;
-    errors: string[];
 };
+/**
+ * Represents the result of a translation operation that can either succeed with data or fail with errors.
+ *
+ * @internal
+ */
+export type NlqTranslationResult<T> = NlqTranslationSuccessResult<T> | NlqTranslationErrorResult;
 export {};

package/dist/packages/sdk-ui/src/analytics-composer/widget/chart-options/get-widget-options.d.ts

@@ -1,6 +1,6 @@
-import { ChartDataOptions, ChartType, ChartStyleOptions } from '../../../types';
 import { MetadataItem } from '@sisense/sdk-data';
 import { AxesMapping, ChartRecommendations, ExpandedQueryModel } from '../../../analytics-composer/types';
+import { ChartDataOptions, ChartStyleOptions, ChartType } from '../../../types';
 /**
  * @internal
  */

package/dist/packages/sdk-ui/src/analytics-composer/widget/to-widget-code.d.ts

@@ -1,5 +1,5 @@
 import { WidgetProps } from '../../props';
-import { ByIdWidgetCodeParams, ClientSideWidgetCodeParams, UiFramework, TemplateKeyMapByWidgetType } from '../types.js';
+import { ByIdWidgetCodeParams, ClientSideWidgetCodeParams, TemplateKeyMapByWidgetType, UiFramework } from '../types.js';
 export declare const toWidgetCodeById: ({ dashboardOid, widgetOid, uiFramework, chartType, includeChart, }: ByIdWidgetCodeParams) => string;
-export declare const getWidgetCode: (widgetProps: WidgetProps, uiFramework: UiFramework, templateKeyMap: TemplateKeyMapByWidgetType) => string;
-export declare const toWidgetCodeClientSide: ({ widgetProps, uiFramework, }: ClientSideWidgetCodeParams) => string;
+export declare const getWidgetCode: (widgetProps: WidgetProps, uiFramework: UiFramework, templateKeyMap: TemplateKeyMapByWidgetType, removeDefaultProps?: boolean) => string;
+export declare const toWidgetCodeClientSide: ({ widgetProps, uiFramework, removeDefaultProps, }: ClientSideWidgetCodeParams) => string;

package/dist/packages/sdk-ui/src/analytics-composer/widget/to-widget-props.d.ts

@@ -1,3 +1,3 @@
-import { WidgetProps } from '../../index.js';
+import { WidgetProps } from '../../props';
 import { ExpandedQueryModel, WidgetPropsConfig } from '../types.js';
 export declare const toWidgetPropsFromQuery: (queryModel: ExpandedQueryModel, config?: WidgetPropsConfig) => WidgetProps | undefined;

package/dist/packages/sdk-ui/src/api/rest-api.d.ts

@@ -1,11 +1,11 @@
+import { type DataSource, DataSourceField } from '@sisense/sdk-data';
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { FeatureCollection as GeoJsonFeatureCollection } from 'geojson';
-import { DataSourceField, type DataSource } from '@sisense/sdk-data';
-import { HierarchyDto, SharedFormulaDto, WidgetDto } from '../widget-by-id/types';
-import type { DashboardDto } from './types/dashboard-dto';
-import { TranslatableError } from '../translation/translatable-error';
 import { PaletteDto } from '../api/types/palette-dto';
 import { GetHierarchiesOptions } from '../models/hierarchy/types';
+import { TranslatableError } from '../translation/translatable-error';
+import { HierarchyDto, SharedFormulaDto, WidgetDto } from '../widget-by-id/types';
+import type { DashboardDto } from './types/dashboard-dto';
 type GetDashboardsOptions = {
     searchByTitle?: string;
     fields?: string[];
@@ -35,11 +35,16 @@ export declare class RestApi {
         layout?: import("./types/dashboard-dto").LayoutDto | undefined;
         style?: import("./types/dashboard-dto").DashboardStyleDto | undefined;
         settings?: import("./types/dashboard-dto").DashboardSettings | undefined;
+        userAuth?: import("../utils/utility-types").AnyObject | undefined;
     } & import("../utils/utility-types").AnyObject)[]>;
     /**
      * Get a specific dashboard
      */
     getDashboard: (dashboardOid: string, options?: GetDashboardOptions) => Promise<DashboardDto | undefined>;
+    /**
+     * Get a specific dashboard using the legacy API version
+     */
+    getDashboardLegacy: (dashboardOid: string) => Promise<DashboardDto | undefined>;
     /**
      * Get all widgets of a specific dashboard
      */

package/dist/packages/sdk-ui/src/api/types/dashboard-dto.d.ts

@@ -1,6 +1,6 @@
-import { WidgetDto } from '../../widget-by-id/types';
 import { FilterJaql, FilterRelationsModel, FilterRelationsModelNode, JaqlDataSource } from '@sisense/sdk-data';
 import { AnyObject } from '../../utils/utility-types';
+import { WidgetDto } from '../../widget-by-id/types';
 /** @internal */
 export type LayoutDto = {
     columns?: {
@@ -67,5 +67,6 @@ export type DashboardDto = {
     layout?: LayoutDto;
     style?: DashboardStyleDto;
     settings?: DashboardSettings;
+    userAuth?: AnyObject;
 } & AnyObject;
 export {};

package/dist/packages/sdk-ui/src/app/client-application.d.ts

@@ -1,12 +1,12 @@
-import { HttpClient } from '@sisense/sdk-rest-client';
-import { QueryClient } from '@sisense/sdk-query-client';
 import { DataSource } from '@sisense/sdk-data';
 import { PivotClient } from '@sisense/sdk-pivot-client';
+import { QueryClient } from '@sisense/sdk-query-client';
+import { HttpClient } from '@sisense/sdk-rest-client';
 import { TrackingEventDetails } from '@sisense/sdk-tracking';
+import { SisenseContextProviderProps } from '../props';
 import { DateConfig } from '../query/date-formats';
+import { LoadingIndicatorConfig, TranslationConfig } from '../types';
 import { AppSettings } from './settings/settings';
-import { TranslationConfig, LoadingIndicatorConfig } from '../types';
-import { SisenseContextProviderProps } from '../props';
 /**
  * Application configuration
  */

package/dist/packages/sdk-ui/src/boxplot-utils.d.ts

@@ -1,7 +1,7 @@
-import { Attribute, Measure, Filter, QueryResultData, DataSource, FilterRelationsJaql } from '@sisense/sdk-data';
+import { Attribute, DataSource, Filter, FilterRelationsJaql, Measure, QueryResultData } from '@sisense/sdk-data';
 import { ClientApplication } from './app/client-application.js';
-import { executeQuery as executeQueryFunction } from './query/execute-query.js';
 import { BoxplotChartCustomDataOptions, BoxplotChartDataOptionsInternal } from './chart-data-options/types.js';
+import { executeQuery as executeQueryFunction } from './query/execute-query.js';
 /**
  * Processes box whisker data and outliers data to combine them into a single data set.
  *

package/dist/packages/sdk-ui/src/chart/helpers/get-load-data-function.d.ts

@@ -1,8 +1,8 @@
+import { QueryResultData } from '@sisense/sdk-data';
+import { QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { ClientApplication } from '../../app/client-application';
 import { QueryDescription } from '../../query/execute-query';
 import { ChartType } from '../../types';
-import { QueryResultData } from '@sisense/sdk-data';
-import { QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { ChartDataOptionsInternal } from '../../chart-data-options/types';
 export type LoadDataFunction = (options: {
     app: ClientApplication;

package/dist/packages/sdk-ui/src/chart/helpers/use-chart-renderer-props.d.ts

@@ -1,9 +1,9 @@
+import { Data, DataSource } from '@sisense/sdk-data';
 import { ChartDataOptionsInternal } from '../../chart-data-options/types';
 import { ChartData } from '../../chart-data/types';
 import { DesignOptions } from '../../chart-options-processor/translations/types';
 import { ChartProps } from '../../props';
 import { ChartType } from '../../types';
-import { Data, DataSource } from '@sisense/sdk-data';
 import { ChartRendererProps } from '../types';
 type UnpreparedInternalChartProps = {
     dataSet?: DataSource | Data;

package/dist/packages/sdk-ui/src/chart/helpers/use-synced-data.d.ts

@@ -1,8 +1,8 @@
-import { Attribute, Data, DataSource, Filter, FilterRelations, Measure } from '@sisense/sdk-data';
 import { Dispatch, SetStateAction } from 'react';
+import { Attribute, Data, DataSource, Filter, FilterRelations, Measure } from '@sisense/sdk-data';
 import { ChartDataOptionsInternal } from '../../chart-data-options/types';
-import { ChartType } from '../../types';
 import { DataColumnNamesMapping } from '../../chart-data-options/validate-data-options';
+import { ChartType } from '../../types';
 import { LoadDataFunction } from './get-load-data-function';
 type DataSet = DataSource | Data | undefined;
 type UseSyncedDataProps = {

package/dist/packages/sdk-ui/src/chart/restructured-charts/areamap-chart/renderer/areamap.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="react" />
 import { AreamapChartDataOptionsInternal } from '../../../../chart-data-options/types.js';
 import { ChartData } from '../../../../chart-data/types.js';
-import { AreamapDataPointEventHandler } from '../../../../props.js';
 import { ChartRendererProps } from '../../../../chart/types.js';
+import { AreamapDataPointEventHandler } from '../../../../props.js';
 import { AreamapChartDesignOptions, AreamapData } from '../types.js';
 export type AreamapProps = {
     chartData: AreamapData;

package/dist/packages/sdk-ui/src/chart/restructured-charts/helpers/data-loading.d.ts

@@ -1,7 +1,7 @@
-import { ClientApplication } from '../../../app/client-application';
-import { QueryDescription } from '../../../query/execute-query';
 import { QueryResultData } from '@sisense/sdk-data';
 import { QueryExecutionConfig } from '@sisense/sdk-query-client';
+import { ClientApplication } from '../../../app/client-application';
+import { QueryDescription } from '../../../query/execute-query';
 /**
  * Load data by a regular single query execution.
  */

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/constants.d.ts

@@ -39,6 +39,8 @@ export declare const CALENDAR_HEATMAP_DEFAULTS: {
     readonly WEEKEND_HIDE_VALUES: true;
     /** Default start of week */
     readonly START_OF_WEEK: "sunday";
+    /** Show pagination controls by default */
+    readonly SHOW_PAGINATION: true;
 };
 /**
  * Calendar heatmap color scheme configuration

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/data-options/data-options.d.ts

@@ -1,7 +1,7 @@
 import { Attribute, Measure } from '@sisense/sdk-data';
 import { CalendarHeatmapChartDataOptions, CalendarHeatmapChartDataOptionsInternal } from '../../../../../chart-data-options/types';
-import { ChartDataOptions } from '../../../../../types';
 import { ChartDataOptionsInternal } from '../../../../../chart-data-options/types';
+import { ChartDataOptions } from '../../../../../types';
 /**
  * Translates calendar heatmap chart data options from user format to internal format
  *

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/data.d.ts

@@ -1,5 +1,5 @@
-import { DataTable } from '../../../../chart-data-processor/table-processor';
 import { CalendarHeatmapChartDataOptionsInternal } from '../../../../chart-data-options/types';
+import { DataTable } from '../../../../chart-data-processor/table-processor';
 import { ChartData } from '../../../../chart-data/types';
 export type CalendarHeatmapDataValue = {
     date: Date;

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/design-options.d.ts

@@ -1,5 +1,5 @@
-import { CalendarHeatmapStyleOptions, ChartStyleOptions } from '../../../../types';
 import { DesignOptions } from '../../../../chart-options-processor/translations/types';
+import { CalendarHeatmapStyleOptions, ChartStyleOptions } from '../../../../types';
 /**
  * Translates calendar heatmap style options to design options
  *

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/highchart-options-builder/options/series-options/calendar-data-generator.d.ts

@@ -1,7 +1,7 @@
-import { CalendarHeatmapChartData } from '../../../data.js';
+import { CalendarHeatmapChartDesignOptions } from '../../../../../../../chart-options-processor/translations/design-options.js';
 import { DateFormatter } from '../../../../../../../common/formatters/create-date-formatter.js';
+import { CalendarHeatmapChartData } from '../../../data.js';
 import { CalendarDayOfWeek } from '../../../utils/calendar-utils.js';
-import { CalendarHeatmapChartDesignOptions } from '../../../../../../../chart-options-processor/translations/design-options.js';
 /**
  * Represents a calendar chart data point for Highcharts
  */

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/highchart-options-builder/options/tooltip-options.d.ts

@@ -1,5 +1,5 @@
-import { BuildContext } from '../../../types.js';
 import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service.js';
+import { BuildContext } from '../../../types.js';
 /**
  * Prepares the Highcharts's tooltip options for calendar heatmap
  *

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/calendar-heatmap-charts-grid.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
 import { HighchartsOptionsInternal } from '../../../../../chart-options-processor/chart-options-service';
-import { MonthInfo } from './helpers/view-helpers.js';
-import { CalendarHeatmapViewType, TextStyle } from '../../../../../types';
 import { ContainerSize } from '../../../../../dynamic-size-container/dynamic-size-container';
+import { CalendarHeatmapViewType, TextStyle } from '../../../../../types';
+import { MonthData, MonthInfo } from './helpers/view-helpers.js';
 export declare const ChartsContainer: import("@emotion/styled").StyledComponent<{
     theme?: import("@emotion/react").Theme | undefined;
     as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
@@ -22,7 +22,7 @@ export declare const ChartTitle: import("@emotion/styled").StyledComponent<{
 interface CalendarHeatmapChartsGridProps {
     monthCharts: (HighchartsOptionsInternal | null)[];
     availableMonths: MonthInfo[];
-    currentViewIndex: number;
+    currentMonth: MonthData;
     viewType: CalendarHeatmapViewType;
     size: ContainerSize;
     monthLabels?: {

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/calendar-heatmap.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { HighchartsBasedChartRendererProps } from '../../highcharts-based-chart-renderer/highcharts-based-chart-renderer.js';
 import { ChartRendererProps } from '../../../../../chart/types.js';
 import { Themable } from '../../../../../theme-provider/types.js';
+import { HighchartsBasedChartRendererProps } from '../../highcharts-based-chart-renderer/highcharts-based-chart-renderer.js';
 export declare const ChartRootContainer: import("@emotion/styled").StyledComponent<{
     theme?: import("@emotion/react").Theme | undefined;
     as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/calendar-pagination/calendar-pagination.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { MonthInfo } from '../helpers/view-helpers.js';
-import { CalendarHeatmapViewType } from '../../../../../../types.js';
 import { Themable } from '../../../../../../theme-provider/types.js';
+import { CalendarHeatmapViewType, TextStyle } from '../../../../../../types.js';
+import { MonthData, MonthInfo } from '../helpers/view-helpers.js';
 export declare const PaginationContainer: import("@emotion/styled").StyledComponent<{
     theme?: import("@emotion/react").Theme | undefined;
     as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
@@ -17,15 +17,11 @@ export declare const ViewDisplay: import("@emotion/styled").StyledComponent<{
     as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
 } & Themable, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 interface CalendarPaginationProps {
-    currentViewIndex: number;
+    value: MonthData;
     availableMonths: MonthInfo[];
     viewType: CalendarHeatmapViewType;
-    onGoToFirst: () => void;
-    onGoToPrevious: () => void;
-    onGoToNext: () => void;
-    onGoToLast: () => void;
-    onGoToPreviousGroup?: () => void;
-    onGoToNextGroup?: () => void;
+    onChange: (month: MonthData) => void;
+    labelStyle?: TextStyle;
 }
 export declare const CalendarPagination: React.FC<CalendarPaginationProps>;
 export {};

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/calendar-pagination/helpers.d.ts

@@ -1,3 +1,3 @@
-import { MonthInfo } from '../helpers/view-helpers.js';
 import { CalendarHeatmapViewType } from '../../../../../../types.js';
-export declare function formatViewTitle(availableMonths: MonthInfo[], currentViewIndex: number, viewType: CalendarHeatmapViewType): string;
+import { MonthData, MonthInfo } from '../helpers/view-helpers.js';
+export declare function formatViewTitle(availableMonths: MonthInfo[], currentMonth: MonthData, viewType: CalendarHeatmapViewType): string;

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/helpers/data-helpers.d.ts

@@ -1,4 +1,2 @@
-import { MonthInfo } from './view-helpers.js';
 import { CalendarHeatmapChartData } from '../../data.js';
 export declare function filterChartDataForMonth(chartData: CalendarHeatmapChartData, targetYear: number, targetMonth: number): CalendarHeatmapChartData;
-export declare function filterChartDataForMonths(chartData: CalendarHeatmapChartData, months: MonthInfo[]): CalendarHeatmapChartData;

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/helpers/sizing-helpers.d.ts

@@ -1,5 +1,5 @@
-import { CalendarHeatmapViewType } from '../../../../../../types.js';
 import { ContainerSize } from '../../../../../../dynamic-size-container/dynamic-size-container';
+import { CalendarHeatmapViewType } from '../../../../../../types.js';
 export interface CalendarSize extends ContainerSize {
     cellSize: number;
 }

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/helpers/view-helpers.d.ts

@@ -1,16 +1,33 @@
-import { CalendarHeatmapChartData } from '../../data';
 import { CalendarHeatmapViewType } from '../../../../../../types';
+import { CalendarHeatmapChartData } from '../../data';
 import { CalendarSize } from './sizing-helpers';
-export interface MonthInfo {
+export interface MonthData {
     year: number;
     month: number;
+}
+export interface MonthInfo extends MonthData {
     monthName: string;
 }
+/**
+ * Creates a Date from MonthData
+ */
+export declare function convertMonthDataToDate(monthData: MonthData): Date;
+/**
+ * Creates a MonthData from a Date
+ */
+export declare function convertDateToMonthData(date: Date): MonthData;
+/**
+ * Compares two MonthData objects chronologically
+ * @returns negative if a < b, positive if a > b, zero if equal
+ */
+export declare function compareMonthData(a: MonthData, b: MonthData): number;
 export declare function shouldUseShortMonthNames(calendarSize: CalendarSize): boolean;
-export declare function getAvailableMonths(chartData: CalendarHeatmapChartData, dateFormatter: (date: Date, format: string) => string, useShortMonthNames?: boolean): MonthInfo[];
+export declare function generateAvailableMonthsFromData(chartData: CalendarHeatmapChartData, monthDateFormatter: (date: Date) => string): MonthInfo[];
+export declare function getAvailableMonths(chartData: CalendarHeatmapChartData, dateFormatter: (date: Date, format: string) => string, useShortMonthNames?: boolean, initialMonth?: MonthData, viewType?: CalendarHeatmapViewType): MonthInfo[];
+export declare function getInitialViewIndex(availableMonths: MonthInfo[], initialDate?: Date): number;
 export declare function getMonthsPerView(viewType: CalendarHeatmapViewType): number;
 export declare function getGridLayout(viewType: CalendarHeatmapViewType): {
     columns: string;
     rows: string;
 };
-export declare function getDisplayMonths(availableMonths: MonthInfo[], currentViewIndex: number, viewType: CalendarHeatmapViewType): MonthInfo[];
+export declare function getDisplayMonths(availableMonths: MonthInfo[], currentMonth: MonthData, viewType: CalendarHeatmapViewType): MonthInfo[];

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/hooks/index.d.ts

@@ -1,4 +1,3 @@
-export { useCalendarHeatmapNavigation } from './use-calendar-heatmap-navigation.js';
 export { useCalendarHeatmapChartOptions } from './use-calendar-heatmap-chart-options.js';
-export type { CalendarHeatmapNavigationResult } from './use-calendar-heatmap-navigation.js';
+export { useCalendarHeatmapPagination } from './use-calendar-heatmap-pagination.js';
 export type { UseCalendarHeatmapChartOptionsParams } from './use-calendar-heatmap-chart-options.js';

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/hooks/use-calendar-heatmap-chart-options.d.ts

@@ -1,18 +1,18 @@
 import { CalendarHeatmapChartDataOptionsInternal } from '../../../../../../chart-data-options/types';
+import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service';
 import { CalendarHeatmapChartDesignOptions } from '../../../../../../chart-options-processor/translations/design-options';
 import { BeforeRenderHandler } from '../../../../../../props';
-import { MonthInfo } from '../helpers/view-helpers.js';
-import { CalendarSize } from '../helpers/sizing-helpers.js';
+import { CalendarHeatmapChartEventProps } from '../../../../../../props.jsx';
 import { CalendarHeatmapViewType } from '../../../../../../types.js';
-import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service';
 import { CalendarHeatmapChartData } from '../../data.js';
-import { CalendarHeatmapChartEventProps } from '../../../../../../props.jsx';
+import { CalendarSize } from '../helpers/sizing-helpers.js';
+import { MonthData, MonthInfo } from '../helpers/view-helpers.js';
 export interface UseCalendarHeatmapChartOptionsParams {
     chartData: CalendarHeatmapChartData;
     dataOptions: CalendarHeatmapChartDataOptionsInternal;
     designOptions: CalendarHeatmapChartDesignOptions;
     availableMonths: MonthInfo[];
-    currentViewIndex: number;
+    currentMonth: MonthData;
     viewType: CalendarHeatmapViewType;
     chartSize: CalendarSize;
     eventHandlers: Pick<CalendarHeatmapChartEventProps, 'onDataPointClick' | 'onDataPointContextMenu' | 'onDataPointsSelected'>;
@@ -30,7 +30,7 @@ export interface UseCalendarHeatmapChartOptionsParams {
  * @param params.dataOptions - Internal data options configuration
  * @param params.designOptions - Design and styling options for the chart
  * @param params.availableMonths - Array of all available months
- * @param params.currentViewIndex - Current view index
+ * @param params.currentMonth - Current month
  * @param params.viewType - View type that determines how many months to display
  * @param params.chartSizes - Array of size configurations for each chart
  * @param params.eventHandlers - Event handlers for data point interactions
@@ -44,7 +44,7 @@ export interface UseCalendarHeatmapChartOptionsParams {
  *   dataOptions,
  *   designOptions,
  *   availableMonths,
- *   currentViewIndex,
+ *   currentMonth,
  *   viewType,
  *   chartSize,
  *   eventHandlers: { onDataPointClick: handleClick },
@@ -52,4 +52,4 @@ export interface UseCalendarHeatmapChartOptionsParams {
  * });
  * ```
  */
-export declare function useCalendarHeatmapChartOptions({ chartData, dataOptions, designOptions, availableMonths, currentViewIndex, viewType, chartSize, eventHandlers, onBeforeRender, }: UseCalendarHeatmapChartOptionsParams): HighchartsOptionsInternal[];
+export declare function useCalendarHeatmapChartOptions({ chartData, dataOptions, designOptions, availableMonths, currentMonth, viewType, chartSize, eventHandlers, onBeforeRender, }: UseCalendarHeatmapChartOptionsParams): HighchartsOptionsInternal[];

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/renderer/hooks/use-calendar-heatmap-pagination.d.ts

@@ -0,0 +1,23 @@
+import { CalendarHeatmapChartData } from '../../data.js';
+import { MonthData } from '../helpers/view-helpers.js';
+type UseCalendarHeatmapPaginationParams = {
+    chartData: CalendarHeatmapChartData;
+    startMonth?: Date;
+};
+type UseCalendarHeatmapPaginationResult = {
+    currentMonth: MonthData;
+    setCurrentMonth: (month: MonthData) => void;
+};
+/**
+ * Custom hook for managing calendar pagination state and actions.
+ *
+ * Provides pagination functionality for calendar views including:
+ * - Current month management
+ *
+ * @param params - The parameters for the hook
+ * @param params.chartData - The calendar heatmap chart data
+ * @param params.startMonth - Optional start month to display initially
+ * @returns The result of the hook
+ */
+export declare const useCalendarHeatmapPagination: (params: UseCalendarHeatmapPaginationParams) => UseCalendarHeatmapPaginationResult;
+export {};

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/cartesians/helpers/data-options.d.ts

@@ -1,6 +1,6 @@
+import { Attribute, CalculatedMeasureColumn, Column, Measure, MeasureColumn } from '@sisense/sdk-data';
 import { CartesianChartDataOptionsInternal, ChartDataOptions, ChartDataOptionsInternal } from '../../../../../chart-data-options/types';
 import { CartesianChartDataOptions } from '../../../../../types';
-import { Attribute, CalculatedMeasureColumn, Column, Measure, MeasureColumn } from '@sisense/sdk-data';
 /**
  * Translates the data options for cartesian charts to internal format.
  */

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/cartesians/helpers/highchart-options/axis.d.ts

@@ -1,5 +1,5 @@
+import { XAxisOrientation } from '../../../../../../chart-options-processor/cartesian/utils/axis/axis-builders';
+import { AxisSettings } from '../../../../../../chart-options-processor/translations/axis-section';
 import { BuildContext } from '../../../types';
 import { CartesianChartTypes } from '../../types';
-import { AxisSettings } from '../../../../../../chart-options-processor/translations/axis-section';
-import { XAxisOrientation } from '../../../../../../chart-options-processor/cartesian/utils/axis/axis-builders';
 export declare const getCartesianXAxis: (ctx: BuildContext<CartesianChartTypes>, orientation: XAxisOrientation) => AxisSettings[];

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/cartesians/helpers/highchart-options/tooltip.d.ts

@@ -1,4 +1,4 @@
+import { TooltipSettings } from '../../../../../../chart-options-processor/translations/tooltip-utils';
 import { BuildContext } from '../../../types';
 import { CartesianChartTypes } from '../../types';
-import { TooltipSettings } from '../../../../../../chart-options-processor/translations/tooltip-utils';
 export declare const getBasicCartesianTooltip: (ctx: BuildContext<CartesianChartTypes>) => TooltipSettings;

package/dist/packages/sdk-ui/src/chart/restructured-charts/highchart-based-charts/cartesians/helpers/highchart-options/y-axis.d.ts

@@ -1,6 +1,6 @@
+import { AxisSettings } from '../../../../../../chart-options-processor/translations/axis-section';
 import { BuildContext } from '../../../types';
 import { CartesianChartTypes } from '../../types';
-import { AxisSettings } from '../../../../../../chart-options-processor/translations/axis-section';
 /**
  * Creates basic Y-axis settings for cartesian charts with data-driven min/max calculation.
  * This function provides the foundation Y-axis configuration that can be enhanced