@sisense/sdk-ui 2.9.0 → 2.11.0

package/dist/packages/sdk-ui/src/dashboard/hooks/use-edit-mode-toolbar.d.ts

@@ -1,6 +1,7 @@
 import { WidgetsPanelLayout } from '../../models';
 /**
  * Props for the useEditModeToolbar hook
+ * @internal
  */
 export interface UseEditModeToolbarProps {
     /**
@@ -23,6 +24,7 @@ export interface UseEditModeToolbarProps {
 }
 /**
  * Return type for the useEditModeToolbar hook
+ * @internal
  */
 export interface UseEditModeToolbarResult {
     /**
@@ -47,5 +49,6 @@ export interface UseEditModeToolbarResult {
  *
  * @param props Configuration options for the toolbar
  * @returns Layout state and toolbar component
+ * @internal
  */
 export declare function useEditModeToolbar({ initialLayout, onApply, onCancel, historyCapacity, }: UseEditModeToolbarProps): UseEditModeToolbarResult;

package/dist/packages/sdk-ui/src/dashboard/hooks/use-jtd-widget.d.ts

@@ -0,0 +1,68 @@
+import { WidgetProps } from '../../props.js';
+import { JumpToDashboardConfig } from './jtd/jtd-types';
+import { JumpToDashboardConfigForPivot } from './use-jtd';
+/**
+ * Hook to add Jump To Dashboard (JTD) functionality to individual Widget components.
+ *
+ * Jump To Dashboard (JTD) allows users to navigate from one dashboard to another when interacting with widgets,
+ * such as clicking on chart data points or using context menus. This hook is particularly useful when rendering
+ * Widget components directly (not through a Dashboard component), but you still want JTD navigation functionality.
+ *
+ * For widgets that are part of a dashboard, consider using `applyJtdConfig` or `applyJtdConfigs` instead,
+ * as they apply JTD configuration at the dashboard level rather than individual widget level.
+ *
+ * Note: dashboard-only 'includeDashboardFilters' is not supported and would just be ignored, since we do not have a dashboard in the current context.
+ *
+ * This hook enhances the provided widget props with JTD navigation capabilities, including:
+ * - Click and right-click event handlers for navigation
+ * - Hyperlink styling for actionable pivot cells (when applicable)
+ * - JTD icon display in widget headers
+ *
+ * @example
+ * Basic JTD configuration with right-click navigation.
+ * ```typescript
+ * import { useJtdWidget } from '@sisense/sdk-ui';
+ *
+ * const jtdConfig: JumpToDashboardConfig = {
+ *   targets: [{ id: 'dashboard-1', caption: 'Sales Dashboard' }],
+ *   interaction: {
+ *     triggerMethod: 'rightclick',
+ *     captionPrefix: 'Jump to'
+ *   }
+ * };
+ *
+ * const MyComponent = () => {
+ *   const widgetWithJtd = useJtdWidget(myWidgetProps, jtdConfig);
+ *
+ *   return <Widget {...widgetWithJtd} />;
+ * };
+ * ```
+ *
+ * @example
+ * JTD configuration with multiple targets and custom styling.
+ * ```typescript
+ * const jtdConfig: JumpToDashboardConfig = {
+ *   enabled: true,
+ *   targets: [
+ *     { id: 'sales-dashboard', caption: 'Sales Analysis' },
+ *     { id: 'marketing-dashboard', caption: 'Marketing Insights' }
+ *   ],
+ *   interaction: {
+ *     triggerMethod: 'click',
+ *     captionPrefix: 'Navigate to',
+ *     showIcon: true
+ *   },
+ *   filtering: {
+ *     mergeWithTargetFilters: true,
+ *     includeWidgetFilters: true
+ *   }
+ * };
+ *
+ * const widgetWithJtd = useJtdWidget(chartProps, jtdConfig);
+ * ```
+ *
+ * @returns Enhanced widget props with JTD navigation capabilities, menu combination, and styling applied
+ *
+ * @group Dashboards
+ */
+export declare const useJtdWidget: (widgetProps: WidgetProps | null, config: JumpToDashboardConfig | JumpToDashboardConfigForPivot) => WidgetProps | null;

package/dist/packages/sdk-ui/src/dashboard/hooks/use-jtd.d.ts

@@ -1,22 +1,48 @@
 import { type Filter } from '@sisense/sdk-data';
 import { WidgetProps } from '../../props.js';
 import { OpenMenuFn } from '../../common/components/menu/types.js';
-import { WidgetsOptions } from '../../index-typedoc';
+import { CompleteThemeSettings, WidgetsOptions } from '../../index-typedoc';
+import { type JtdActions } from '../../dashboard/hooks/jtd/jtd-types';
+import { JtdConfig } from '../../dashboard/hooks/jtd/jtd-types';
 /**
- * Jump to Dashboard (JTD) hook.
+ * Shared function to apply JTD functionality to a widget.
+ * Extracted to avoid code duplication between use-jtd.ts and use-jtd-widget.ts
+ *
+ * @param widgetProps - The widget props to enhance
+ * @param config - JTD application configuration
+ * @returns Enhanced widget props with JTD functionality
+ * @internal
+ */
+export declare const applyJtdToWidget: (widgetProps: WidgetProps, config: {
+    normalizedJtdConfig: JtdConfig;
+    dashboardFilters: Filter[];
+    originalWidgetFilters: Filter[];
+    extraFilters?: Filter[];
+    actions: JtdActions;
+    themeSettings: CompleteThemeSettings;
+}) => WidgetProps;
+/**
+ * Internal Jump To Dashboard (JTD) hook.
  * Implements the JTD functionality for each widget with JTD config.
- * @param widgetOptions - The widget options of the dashboard
- * @param dashboardFilters - The dashboard filters to use
- * @param widgetFilters - The widget filters to use
- * @param openMenu - The open menu function to use
+ * Supports both legacy JtdConfig and new JumpToDashboardConfig formats.
+ *
+ * @param config - The configuration object
+ * @param config.widgetOptions - The widget options of the dashboard
+ * @param config.dashboardFilters - The dashboard filters to use
+ * @param config.widgetFilters - The widget filters to use
+ * @param config.extraFilters - Extra filters to apply with highest priority
+ * @param config.openMenu - The open menu function to use
  * @returns The connect to widget props function
+ * @internal
  */
-export declare const useJtd: ({ widgetOptions, dashboardFilters, widgetFilters, openMenu, }: {
+export declare const useJtdInternal: ({ widgetOptions, dashboardFilters, widgetFilters, openMenu, extraFilters, }: {
     widgetOptions: WidgetsOptions;
     dashboardFilters?: Filter[] | undefined;
     widgetFilters?: Map<string, Filter[]> | undefined;
+    extraFilters?: Filter[] | undefined;
     openMenu: OpenMenuFn;
 }) => {
     connectToWidgetProps: (widgetProps: WidgetProps) => WidgetProps;
 };
 export * from './jtd';
+export { useJtdWidget } from './use-jtd-widget';

package/dist/packages/sdk-ui/src/dashboard/hooks/use-tabber.d.ts

@@ -2,6 +2,9 @@ import { WidgetProps } from '../../props';
 import { WidgetPanelLayoutManager } from '../../dashboard/hooks/use-widgets-layout';
 import { TabberTab } from '../../types';
 import { TabbersOptions, WidgetsPanelColumnLayout } from '../../models';
+/**
+ * @internal
+ */
 export type UseTabber = ({ widgets, config, }: {
     widgets: WidgetProps[];
     config?: TabbersOptions | undefined;
@@ -9,10 +12,20 @@ export type UseTabber = ({ widgets, config, }: {
     layoutManager: WidgetPanelLayoutManager;
     widgets: WidgetProps[];
 };
+/**
+ * @internal
+ */
 export type SingleTabberConfig = {
     tabs: TabberTab[];
     activeTab: number;
 };
 export declare const isTabberWidget: (widget: WidgetProps) => boolean;
 export declare const modifyLayout: (tabbersOptions: TabbersOptions, tabberState: Record<string, number>) => (layout: WidgetsPanelColumnLayout) => WidgetsPanelColumnLayout;
+/**
+ * Hook that modifies widget properties so it became a tabber widget.
+ * Incapsulates logic for updating layout via navigating tabs
+ * @param widgets
+ * @param tabbersConfigs
+ * @internal
+ */
 export declare const useTabber: UseTabber;

package/dist/packages/sdk-ui/src/dashboard/index.d.ts

@@ -2,4 +2,5 @@ export { DashboardById } from './dashboard-by-id';
 export { Dashboard } from './dashboard';
 export { useComposedDashboard, useComposedDashboardInternal, type ComposableDashboardProps, type UseComposedDashboardOptions, } from './use-composed-dashboard';
 export { useDashboardTheme, type DashboardThemeParams } from './use-dashboard-theme';
+export * from './hooks';
 export type { DashboardByIdProps, DashboardProps, DashboardLayoutOptions, DashboardStyleOptions, DashboardConfig, DashboardByIdConfig, WidgetsPanelConfig, EditModeConfig, DashboardFiltersPanelConfig, } from './types';

package/dist/packages/sdk-ui/src/filters/components/filter-editor-popover/utils.d.ts

@@ -1,5 +1,4 @@
-import { TFunction } from '@sisense/sdk-common';
-import { Filter, MembersFilter, DimensionalLevelAttribute, RelativeDateFilter } from '@sisense/sdk-data';
+import { Filter, MembersFilter, RelativeDateFilter } from '@sisense/sdk-data';
 export declare function isSupportedByFilterEditor(filter: Filter): boolean;
 export declare function isIncludeAllFilter(filter: Filter): filter is MembersFilter;
 export declare function isIncludeMembersFilter(filter: Filter): filter is MembersFilter;
@@ -8,7 +7,6 @@ export declare function isConditionalFilter(filter: Filter): boolean;
 export declare function isNumericBetweenFilter(filter: Filter): boolean;
 export declare function isRelativeDateFilterWithAnchor(filter: Filter): filter is RelativeDateFilter;
 export declare function isRelativeDateFilterWithoutAnchor(filter: Filter): filter is RelativeDateFilter;
-export declare function createLevelAttribute(baseLevelAttribute: DimensionalLevelAttribute, granularity: string, t: TFunction): DimensionalLevelAttribute;
 /**
  * Formats a given Date object into a string in the format "YYYY-MM-DDT00:00:00".
  *

package/dist/packages/sdk-ui/src/index.d.ts

@@ -37,6 +37,7 @@ export * from './boxplot-chart';
 export * from './scattermap-chart';
 export * from './areamap-chart';
 export * from './area-range-chart';
+export * from './calendar-heatmap-chart';
 export * from './sisense-context/custom-sisense-context-provider';
 export * from './theme-provider/custom-theme-provider';
 export * from './custom-widgets-provider/custom-widgets-provider-adapter';
@@ -45,7 +46,7 @@ export { useCustomWidgets } from './custom-widgets-provider';
 export { extractDimensionsAndMeasures, useExecuteCustomWidgetQuery, useExecuteCustomWidgetQueryInternal, type ExecuteCustomWidgetQueryParams, type CustomWidgetQueryState, } from './custom-widgets-provider';
 export { getThemeSettingsByOid } from './themes/theme-loader';
 export { getDefaultThemeSettings } from './theme-provider/default-theme-settings';
-export { useGetDashboardModel, useGetDashboardModels, useDashboardModel, useDashboardPersistence, getDashboardModel, getDashboardModels, useGetWidgetModel, getWidgetModel, translateToDashboardResponse, translateToDashboardsResponse, useGetHierarchyModels, getHierarchyModels, translateFiltersAndRelationsToDto, type DashboardModel, type GetDashboardModelParams, type GetDashboardModelsParams, type DashboardModelState, type DashboardModelLoadingState, type DashboardModelSuccessState, type DashboardModelErrorState, type DashboardModelsState, type DashboardModelsLoadingState, type DashboardModelsSuccessState, type DashboardModelsErrorState, type WidgetModel, type WidgetDataOptions, type WidgetModelState, type WidgetModelLoadingState, type WidgetModelErrorState, type WidgetModelSuccessState, type GetWidgetModelParams, type GetDashboardModelOptions, type GetDashboardModelsOptions, type WidgetsPanelColumnLayout, type WidgetsPanelLayout, type WidgetsPanelColumn, type WidgetsPanelRow, type WidgetsPanelCell, type WidgetId, type WidgetsOptions, type CommonFiltersOptions, type CommonFiltersApplyMode, type FiltersIgnoringRules, type HierarchyModel, type Hierarchy, type HierarchyId, type GetHierarchyModelsParams, type HierarchyModelsState, type HierarchyModelsLoadingState, type HierarchyModelsErrorState, type HierarchyModelsSuccessState, UseDashboardModelActionType, } from './models';
+export { useGetDashboardModel, useGetDashboardModels, useDashboardModel, useDashboardPersistence, getDashboardModel, getDashboardModels, useGetWidgetModel, getWidgetModel, translateToDashboardResponse, translateToDashboardsResponse, useGetHierarchyModels, getHierarchyModels, translateFiltersAndRelationsToDto, type DashboardModel, type GetDashboardModelParams, type GetDashboardModelsParams, type DashboardModelState, type DashboardModelLoadingState, type DashboardModelSuccessState, type DashboardModelErrorState, type DashboardModelsState, type DashboardModelsLoadingState, type DashboardModelsSuccessState, type DashboardModelsErrorState, type WidgetModel, type WidgetDataOptions, type WidgetModelState, type WidgetModelLoadingState, type WidgetModelErrorState, type WidgetModelSuccessState, type GetWidgetModelParams, type GetDashboardModelOptions, type GetDashboardModelsOptions, type WidgetsPanelColumnLayout, type WidgetsPanelLayout, type WidgetsPanelColumn, type WidgetsPanelRow, type WidgetsPanelCell, type WidgetId, type DashboardId, type WidgetsOptions, type CommonFiltersOptions, type CommonFiltersApplyMode, type FiltersIgnoringRules, type HierarchyModel, type Hierarchy, type HierarchyId, type GetHierarchyModelsParams, type HierarchyModelsState, type HierarchyModelsLoadingState, type HierarchyModelsErrorState, type HierarchyModelsSuccessState, UseDashboardModelActionType, } from './models';
 /**
  * Utility functions to translate a Fusion widget model from and to other widget data structures
  *
@@ -69,6 +70,13 @@ export * as dashboardModelTranslator from './models/dashboard/dashboard-model-tr
  * @shortDescription Utility functions to manipulate dashboard elements
  */
 export * as dashboardHelpers from './dashboard/dashboard-helpers';
+/**
+ * Jump To Dashboard (JTD) configuration types
+ *
+ * @group Dashboards
+ * @shortDescription Configuration types for Jump To Dashboard functionality
+ */
+export type { JumpToDashboardConfig } from './dashboard/hooks/jtd';
 export type { AutoZoomNavigatorScrollerLocation } from './widget-by-id/types';
 export { boxWhiskerProcessResult } from './boxplot-utils';
 export { queryStateReducer } from './query-execution/query-state-reducer';
@@ -89,6 +97,7 @@ export { LoadingIndicator } from './common/components/loading-indicator';
 export { LoadingOverlay } from './common/components/loading-overlay';
 export { useFetch, type RequestConfig, type UseQueryResult } from './common/hooks/use-fetch';
 export { useGetDataSourceFields } from './common/hooks/fusion-endpoints/use-get-data-source-fields';
+export { useJtdWidget } from './dashboard/hooks/use-jtd-widget';
 export type { EmptyObject } from './utils/utility-types';
 export { translateColumnToAttribute } from './chart-data-options/utils';
 export { isSameAttribute } from './utils/filters';

package/dist/packages/sdk-ui/src/models/dashboard/translate-dashboard-utils.d.ts

@@ -1,10 +1,23 @@
 import { type LayoutDto, type FilterDto, type CascadingFilterDto, DashboardDto } from '../../api/types/dashboard-dto';
 import type { WidgetsPanelColumnLayout, WidgetsOptions, TabbersOptions } from './types';
-import { Filter, FilterRelations, FilterRelationsModel, FilterRelationsModelNode } from '@sisense/sdk-data';
-import { WidgetDto } from '../../widget-by-id/types';
+import { Filter, FilterRelations, FilterRelationsModel, FilterRelationsModelNode, Measure, Dimension } from '@sisense/sdk-data';
+import { Panel, WidgetDto } from '../../widget-by-id/types';
+import { TriggerMethod, JtdTarget } from '../../dashboard/hooks/jtd/jtd-types';
 import { RestApi } from '../../api/rest-api';
 export declare const translateLayout: (layout: LayoutDto) => WidgetsPanelColumnLayout;
 export declare function extractDashboardFilters(dashboardFilters: Array<FilterDto | CascadingFilterDto>, filterRelationsModel?: FilterRelationsModel | FilterRelationsModelNode): Filter[] | FilterRelations;
+export declare const getJtdNavigateType: (widget: WidgetDto) => TriggerMethod;
+export declare const convertDimensionsToDimIndexes: (widget: WidgetDto, dimensionIds: string[]) => string[];
+/**
+ * Extract pivot targets configuration from widget DTO and build Map-based targets
+ * @param widget - Widget DTO with drillToDashboardConfig
+ * @returns Map of dimensions/measures to their targets or undefined if no targets found
+ * @internal
+ */
+export declare function extractPivotTargetsConfigFromWidgetDto(widget: WidgetDto): Map<Dimension | {
+    dimension: Dimension;
+    location: 'row' | 'column' | 'value';
+} | Measure, JtdTarget[]> | undefined;
 export declare function translateWidgetsOptions(widgets?: WidgetDto[]): WidgetsOptions;
 export declare function translateTabbersOptions(widgets?: WidgetDto[]): TabbersOptions;
 /**
@@ -16,3 +29,14 @@ export declare function translateTabbersOptions(widgets?: WidgetDto[]): TabbersO
  * @internal
  */
 export declare function withSharedFormulas(dashboard: DashboardDto, api: RestApi): Promise<DashboardDto>;
+/**
+ * Find dimension or measure by instanceId in widget panels and convert to proper type
+ * @param panels - Widget metadata panels to search
+ * @param pivotDimension - Instance ID to find, this is not a PivotDimId, it is the instanceId of the dimension or measure
+ * @returns Dimension/Measure object with optional location info or undefined if not found
+ * @internal
+ */
+export declare function findDimensionByInstanceId(panels: Panel[], pivotDimension: string): Dimension | Measure | {
+    dimension: Dimension;
+    location: 'row' | 'column' | 'value';
+} | undefined;

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

@@ -1,6 +1,6 @@
 import { CommonFiltersOptions } from '../../common-filters/types';
 import { ColorPaletteTheme, TabberConfig } from '../../types';
-import { JtdConfig } from '../../widget-by-id/types';
+import type { JumpToDashboardConfig, JumpToDashboardConfigForPivot } from '../../dashboard/hooks/jtd/jtd-types';
 export type { CommonFiltersOptions, CommonFiltersApplyMode, FiltersIgnoringRules, } from '../../common-filters/types';
 /**
  * Part of Dashboard layout, which describes how widgets are arranged in a cell
@@ -59,6 +59,11 @@ export type WidgetsPanelLayout = WidgetsPanelColumnLayout;
  * Widget ID
  */
 export type WidgetId = string;
+/**
+ * Dashboard ID
+ * @internal
+ */
+export type DashboardId = string;
 /**
  * Options for widgets in a dashboard
  *
@@ -67,10 +72,9 @@ export type WidgetId = string;
 export type WidgetsOptions = Record<WidgetId, {
     filtersOptions?: CommonFiltersOptions;
     /**
-     * Jump to dashboard config for widgets
-      @internal
+     * Jump To Dashboard config for widgets.
      */
-    jtdConfig?: JtdConfig;
+    jtdConfig?: JumpToDashboardConfig | JumpToDashboardConfigForPivot;
 }>;
 /**
  * Options for TabberWidets in a dashboard

package/dist/packages/sdk-ui/src/pivot-table/formatters/header-cell-formatters/header-cell-value-formatter.d.ts

@@ -1,5 +1,6 @@
 import type { PivotTableDataOptions } from '../../../chart-data-options/types.js';
-import type { DateFormatter, HeaderCellFormatter } from '../types.js';
+import type { HeaderCellFormatter } from '../types.js';
+import { DateFormatter } from '../../../common/formatters/create-date-formatter.js';
 export declare const createHeaderCellValueFormatter: (dataOptions: PivotTableDataOptions, dateFormatter: DateFormatter) => HeaderCellFormatter;
 /**
  * Formats the date time string or Date object.

package/dist/packages/sdk-ui/src/pivot-table/formatters/types.d.ts

@@ -44,4 +44,3 @@ export type HeaderCellFormatter = (cell: PivotTreeNode, jaqlPanelItem: JaqlPanel
  * @returns Formatting result object or void to skip formatting
  */
 export type CustomHeaderCellFormatter = (cell: PivotTreeNode, jaqlPanelItem: JaqlPanel | undefined, dataOption?: AnyColumn, id?: string) => CellFormattingResult | void;
-export type DateFormatter = (date: Date, format: string) => string;

package/dist/packages/sdk-ui/src/polar-chart.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 import { PolarChartProps } from './props';
 /**
- * A React component comparing multiple categories/variables with a spacial perspective in a radial chart.
+ * A React component comparing multiple categories/variables with a spatial perspective in a radial chart.
  *
  * ## Example
  *

package/dist/packages/sdk-ui/src/props.d.ts

@@ -1,9 +1,9 @@
 import { Attribute, Filter, Measure, DataSource, Data, QueryResultData, FilterRelations } from '@sisense/sdk-data';
-import { ChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ThemeSettings, PolarStyleOptions, PieStyleOptions, StackableStyleOptions, LineStyleOptions, AreaStyleOptions, FunnelStyleOptions, ScatterStyleOptions, ChartStyleOptions, ChartType, IndicatorStyleOptions, DrilldownOptions, ThemeOid, TreemapStyleOptions, CustomDrilldownResult, MenuPosition, MenuAlignment, MenuItemSection, SunburstStyleOptions, ChartWidgetStyleOptions, TableWidgetStyleOptions, WidgetByIdStyleOptions, BoxplotStyleOptions, ScattermapStyleOptions, AreamapStyleOptions, DataPoint, ScatterDataPoint, AreamapDataPoint, BoxplotDataPoint, ChartDataPoints, ScattermapDataPoint, PivotTableStyleOptions, PivotTableWidgetStyleOptions, RegularChartType, RegularChartStyleOptions, TabularChartStyleOptions, TableStyleOptions, AreaRangeStyleOptions, DrilldownSelection, TextWidgetStyleOptions, GenericDataOptions, IndicatorRenderOptions, TabberStyleProps, IndicatorDataPoint, TextWidgetDataPoint, CustomWidgetStyleOptions, PivotTableDataPoint } from './types';
+import { ChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ThemeSettings, PolarStyleOptions, PieStyleOptions, StackableStyleOptions, LineStyleOptions, AreaStyleOptions, FunnelStyleOptions, ScatterStyleOptions, ChartStyleOptions, ChartType, IndicatorStyleOptions, DrilldownOptions, ThemeOid, TreemapStyleOptions, CustomDrilldownResult, MenuPosition, MenuAlignment, MenuItemSection, SunburstStyleOptions, ChartWidgetStyleOptions, TableWidgetStyleOptions, WidgetByIdStyleOptions, BoxplotStyleOptions, ScattermapStyleOptions, AreamapStyleOptions, DataPoint, ScatterDataPoint, AreamapDataPoint, BoxplotDataPoint, ChartDataPoints, ScattermapDataPoint, PivotTableStyleOptions, PivotTableWidgetStyleOptions, RegularChartType, RegularChartStyleOptions, TabularChartStyleOptions, TableStyleOptions, AreaRangeStyleOptions, DrilldownSelection, TextWidgetStyleOptions, GenericDataOptions, IndicatorRenderOptions, TabberStyleProps, IndicatorDataPoint, TextWidgetDataPoint, CustomWidgetStyleOptions, PivotTableDataPoint, CalendarHeatmapStyleOptions, CalendarHeatmapDataPoint } from './types';
 import { type CustomDataCellFormatter, type CustomHeaderCellFormatter } from './pivot-table/formatters/types';
 import { HighchartsOptions } from './chart-options-processor/chart-options-service';
 import { ComponentType, PropsWithChildren, ReactNode } from 'react';
-import { IndicatorChartDataOptions, BoxplotChartCustomDataOptions, BoxplotChartDataOptions, ScatterChartDataOptions, TableDataOptions, ScattermapChartDataOptions, AreamapChartDataOptions, PivotTableDataOptions, RegularChartDataOptions, TabularChartDataOptions, RangeChartDataOptions } from './chart-data-options/types';
+import { IndicatorChartDataOptions, BoxplotChartCustomDataOptions, BoxplotChartDataOptions, ScatterChartDataOptions, TableDataOptions, ScattermapChartDataOptions, AreamapChartDataOptions, PivotTableDataOptions, RegularChartDataOptions, TabularChartDataOptions, RangeChartDataOptions, CalendarHeatmapChartDataOptions } from './chart-data-options/types';
 import { AppConfig } from './app/client-application';
 import { ExecuteQueryParams, QueryByWidgetIdState } from './query-execution';
 import { FiltersMergeStrategy } from './widget-by-id/types';
@@ -44,7 +44,7 @@ export interface SisenseContextProviderProps {
      */
     ssoEnabled?: boolean;
     /**
-     * Token for [bearer authentication](https://sisense.dev/guides/restApi/using-rest-api.html).
+     * Token for [bearer authentication](https://developer.sisense.com/guides/restApi/using-rest-api.html).
      *
      * To signify that the token is pending (e.g., being generated), set the value to `null`. This is supported for React and Vue only.
      *
@@ -297,6 +297,22 @@ export type IndicatorDataPointEventHandler = (
 point: IndicatorDataPoint, 
 /** Native MouseEvent */
 nativeEvent: MouseEvent) => void;
+/**
+ * Click handler for when a calendar-heatmap data point is clicked
+ */
+export type CalendarHeatmapDataPointEventHandler = (
+/** Data point that was clicked */
+point: CalendarHeatmapDataPoint, 
+/** Native PointerEvent */
+nativeEvent: PointerEvent) => void;
+/**
+ * Click handler for when multiple calendar-heatmap data points are selected.
+ */
+export type CalendarHeatmapDataPointsEventHandler = (
+/** Data points that were selected */
+points: CalendarHeatmapDataPoint[], 
+/** Native MouseEvent */
+nativeEvent: MouseEvent) => void;
 /**
  * Click handler for when text widget is clicked.
  *
@@ -458,6 +474,32 @@ interface IndicatorChartEventProps extends BaseChartEventProps {
      */
     onDataPointClick?: IndicatorDataPointEventHandler;
 }
+/**
+ * Event props for CalendarHeatmap chart which uses CalendarHeatmapDataPoint type
+ * to describe data points for events.
+ *
+ * @internal
+ */
+export interface CalendarHeatmapChartEventProps extends BaseChartEventProps, HighchartsBasedChartEventProps {
+    /**
+     * Click handler callback for a data point
+     *
+     * @category Callbacks
+     */
+    onDataPointClick?: CalendarHeatmapDataPointEventHandler;
+    /**
+     * Context menu handler callback for a data point
+     *
+     * @category Callbacks
+     */
+    onDataPointContextMenu?: CalendarHeatmapDataPointEventHandler;
+    /**
+     * Handler callback for selection of multiple data points
+     *
+     * @category Callbacks
+     */
+    onDataPointsSelected?: CalendarHeatmapDataPointsEventHandler;
+}
 /**
  * Base Chart Props to be extended by {@link ChartProps}
  *
@@ -472,7 +514,7 @@ export interface BaseChartProps extends BaseChartEventProps {
      *
      * (1) Sisense data source name as a string. For example, `'Sample ECommerce'`. Typically, you
      * retrieve the data source name from a data model you create using the `get-data-model`
-     * {@link https://sisense.dev/guides/sdk/guides/cli.html | command} of the Compose SDK CLI. Under the hood, the chart
+     * {@link https://developer.sisense.com/guides/sdk/guides/cli.html | command} of the Compose SDK CLI. The chart
      * connects to the data source, executes a query, and loads the data as specified in
      * `dataOptions`, `filters`, and `highlights`.
      *
@@ -565,19 +607,19 @@ interface ChartEventProps extends BaseChartEventProps {
      *
      * @category Callbacks
      */
-    onDataPointClick?: DataPointEventHandler | ScatterDataPointEventHandler | AreamapDataPointEventHandler | BoxplotDataPointEventHandler | ScattermapDataPointEventHandler | IndicatorDataPointEventHandler;
+    onDataPointClick?: DataPointEventHandler | ScatterDataPointEventHandler | AreamapDataPointEventHandler | BoxplotDataPointEventHandler | ScattermapDataPointEventHandler | IndicatorDataPointEventHandler | CalendarHeatmapDataPointEventHandler;
     /**
      * Context menu handler callback for a data point
      *
      * @category Callbacks
      */
-    onDataPointContextMenu?: DataPointEventHandler | ScatterDataPointEventHandler | BoxplotDataPointEventHandler;
+    onDataPointContextMenu?: DataPointEventHandler | ScatterDataPointEventHandler | BoxplotDataPointEventHandler | CalendarHeatmapDataPointEventHandler;
     /**
      * Handler callback for selection of multiple data points
      *
      * @category Callbacks
      */
-    onDataPointsSelected?: DataPointsEventHandler | ScatterDataPointsEventHandler;
+    onDataPointsSelected?: DataPointsEventHandler | ScatterDataPointsEventHandler | CalendarHeatmapDataPointsEventHandler;
     /**
      * A callback that allows you to customize the underlying chart element before it is rendered. The returned options are then used when rendering the chart.
      *
@@ -1717,3 +1759,20 @@ export interface UseGetSharedFormulaParams extends HookEnableParam {
      */
     dataSource?: DataSource;
 }
+/**
+ * Props of the {@link CalendarHeatmapChart} component.
+ */
+export interface CalendarHeatmapChartProps extends BaseChartProps, CalendarHeatmapChartEventProps {
+    /**
+     * Configurations for how to interpret and present the data passed to the chart
+     *
+     * @category Chart
+     */
+    dataOptions: CalendarHeatmapChartDataOptions;
+    /**
+     * Configurations for how to style and present a chart's data.
+     *
+     * @category Chart
+     */
+    styleOptions?: CalendarHeatmapStyleOptions;
+}

package/dist/packages/sdk-ui/src/sisense-chart/types.d.ts

@@ -2,9 +2,9 @@ import { ChartDataOptionsInternal } from '../chart-data-options/types';
 import { ChartData } from '../chart-data/types.js';
 import { ChartDesignOptions } from '../chart-options-processor/translations/types.js';
 import { BeforeRenderHandler } from '../props.js';
-import { BoxplotChartType, BoxplotDataPoint, CartesianChartType, CategoricalChartType, DataPoint, ScatterChartType, ScatterDataPoint } from '../types.js';
+import { BoxplotChartType, BoxplotDataPoint, CalendarHeatmapDataPoint, CartesianChartType, CategoricalChartType, DataPoint, ScatterChartType, ScatterDataPoint } from '../types.js';
 export type SisenseChartDataPointsEventHandler = (points: SisenseChartDataPoint[], nativeEvent: MouseEvent) => void;
-export type SisenseChartDataPoint = DataPoint | ScatterDataPoint | BoxplotDataPoint;
+export type SisenseChartDataPoint = DataPoint | ScatterDataPoint | BoxplotDataPoint | CalendarHeatmapDataPoint;
 export type SisenseChartDataPointEventHandler = (point: SisenseChartDataPoint, nativeEvent: PointerEvent) => void;
 export interface SisenseChartProps {
     chartType: SisenseChartType;

package/dist/packages/sdk-ui/src/theme-provider/default-theme-settings.d.ts

@@ -10,6 +10,7 @@ export declare const DEFAULT_FILTER_PANEL_DIVIDER_LINE_WIDTH = 1;
 export declare const DEFAULT_FILTER_PANEL_BORDER_COLOR = "#DADADA";
 export declare const DEFAULT_FILTER_PANEL_BORDER_WIDTH = 1;
 export declare const DEFAULT_TITLE_FONT_SIZE = 15;
+export declare const DEFAULT_HYPERLINK_COLOR = "#1FAFF3";
 /**
  * Returns default theme settings, which can be used as base for custom theme options.
  *

package/dist/packages/sdk-ui/src/translation/resources/en.d.ts

@@ -373,6 +373,17 @@ export declare const translation: {
     jumpToDashboard: {
         defaultCaption: string;
         jumpableTooltip: string;
+        noDrillTargets: string;
+    };
+    calendarHeatmap: {
+        navigation: {
+            firstMonth: string;
+            lastMonth: string;
+            previousMonth: string;
+            nextMonth: string;
+            previousGroup: string;
+            nextGroup: string;
+        };
     };
 };
 /**

package/dist/packages/sdk-ui/src/translation/resources/index.d.ts

@@ -383,6 +383,17 @@ export declare const resources: {
         jumpToDashboard: {
             defaultCaption: string;
             jumpableTooltip: string;
+            noDrillTargets: string;
+        };
+        calendarHeatmap: {
+            navigation: {
+                firstMonth: string;
+                lastMonth: string;
+                previousMonth: string;
+                nextMonth: string;
+                previousGroup: string;
+                nextGroup: string;
+            };
         };
     };
     uk: {
@@ -760,6 +771,17 @@ export declare const resources: {
         jumpToDashboard: {
             defaultCaption: string;
             jumpableTooltip: string;
+            noDrillTargets: string;
+        };
+        calendarHeatmap: {
+            navigation: {
+                firstMonth: string;
+                lastMonth: string;
+                previousMonth: string;
+                nextMonth: string;
+                previousGroup: string;
+                nextGroup: string;
+            };
         };
     };
 };