@sisense/sdk-ui 2.10.0 → 2.12.0

package/dist/packages/sdk-ui/src/analytics-composer/{new-nlq-translator → nlq-v3-translator}/translate-query.d.ts

@@ -1,6 +1,6 @@
-import { JaqlDataSourceForDto } from '@sisense/sdk-data';
-import { NormalizedTable, NlqResponseJSON } from '../types.js';
 import { BaseQueryParams } from '../../query-execution';
+import { NlqTranslationResult } from '../types.js';
+import { QueryInput } from '../types.js';
 /**
  * Translate Query JSON generated by the new NLQ API to BaseQueryParams object.
  *
@@ -37,7 +37,7 @@ import { BaseQueryParams } from '../../query-execution';
     }
  *
  * is translated to the following Query object:
- * {
+ * {success: true, data: {
   "dataSource": {
     "address": "LocalHost",
     "id": "localhost_aSampleIAAaECommerce",
@@ -214,11 +214,9 @@ import { BaseQueryParams } from '../../query-execution';
       "type": "basemeasure",
     },
   ],
-}
- * @param queryJSON - A JSON string representing the query generated by the new NLQ API
- * @param dataSource - The data source to use for the query
- * @param tables - The tables to use for the query
- * @returns BaseQueryParams object
+}}
+ * @param input - QueryInput object
+ * @returns NlqTranslationResult<BaseQueryParams>
  * @internal
  */
-export declare const translateQueryJSON: (queryJSON: NlqResponseJSON, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => BaseQueryParams;
+export declare const translateQueryJSON: (input: QueryInput) => NlqTranslationResult<BaseQueryParams>;

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
  */
@@ -110,7 +110,7 @@ export type AppConfig = {
         onTrackingEvent?: (payload: TrackingEventDetails) => void;
     };
     /**
-     * Configuration of the Jump to Dashboard feature
+     * Configuration of the Jump To Dashboard feature
      *
      * This feature is currently in Beta.
      *
@@ -138,7 +138,7 @@ export type AppConfig = {
      */
     jumpToDashboardConfig?: {
         /**
-         * Whether to enable or disable the jump to dashboard feature
+         * Whether to enable or disable the Jump To Dashboard feature
          *
          * If not specified, the default value is `true`
          */

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/calendar-heatmap-chart.d.ts

@@ -1,12 +1,26 @@
 /// <reference types="react" />
 import { CalendarHeatmapChartProps } from './props';
 /**
- * A React component representing a calendar heatmap chart.
+ * A React component that visualizes values over days in a calendar-like view,
+ * making it easy to identify daily patterns or anomalies
  *
  * @param props - Calendar Heatmap chart properties
  * @returns Calendar Heatmap Chart component
  * @group Charts
- *
- * @internal
+ * @example
+ * ```tsx
+ * <CalendarHeatmapChart
+ *   dataSet={DM.DataSource}
+ *   dataOptions={{
+ *     date: DM.Commerce.Date.Days,
+ *     value: measureFactory.sum(DM.Commerce.Cost)
+ *   }}
+ *   styleOptions={{
+ *     width: 800,
+ *     height: 600,
+ *     viewType: 'quarter'
+ *   }}
+ * />
+ * ```
  */
 export declare const CalendarHeatmapChart: import("react").FunctionComponent<CalendarHeatmapChartProps>;

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

@@ -3,77 +3,98 @@ import { ViewType } from './types';
  * Default calendar heatmap chart configuration constants
  */
 export declare const CALENDAR_HEATMAP_DEFAULTS: {
-    /** Default cell size in pixels */
-    readonly CELL_SIZE: 50;
     /** Default view type */
     readonly VIEW_TYPE: ViewType.MONTH;
     /** Default color for days without data */
-    readonly NO_DATA_COLOR: "rgb(245, 245, 245)";
-    /** Transparent color for empty calendar cells */
-    readonly EMPTY_CELL_COLOR: "transparent";
-    /** Default chart background color */
-    readonly BACKGROUND_COLOR: "white";
+    readonly NO_DATA_COLOR: "#f5f5f5";
     /** Default border width for cells */
     readonly BORDER_WIDTH: 0;
     /** Minimum cell size for showing data labels */
-    readonly MIN_CELL_SIZE_FOR_LABELS: 10;
+    readonly MIN_CELL_SIZE_FOR_LABELS: 20;
     /** Total cells in a full calendar grid (6 rows × 7 days) */
     readonly TOTAL_CALENDAR_CELLS: 42;
     /** Days in a week */
     readonly DAYS_IN_WEEK: 7;
     /** Maximum calendar rows */
     readonly MAX_CALENDAR_ROWS: 6;
+    /** Show cell labels (day numbers) by default */
+    readonly SHOW_CELL_LABEL: true;
+    /** Show day labels (weekday names) by default */
+    readonly SHOW_DAY_LABEL: true;
+    /** Show month labels by default */
+    readonly SHOW_MONTH_LABEL: true;
+    /** Minimum сhart size threshold for using short month names */
+    readonly SHORT_MONTH_NAME_CHART_SIZE_THRESHOLD: 120;
+    /** Minimum сhart size threshold for showing day labels */
+    readonly SHOW_DAY_LABEL_CHART_SIZE_THRESHOLD: 120;
+    /** Minimum сhart size threshold for showing cell labels */
+    readonly SHOW_CELL_LABEL_CHART_SIZE_THRESHOLD: 120;
+    /** Default weekend enabled state */
+    readonly WEEKEND_ENABLED: false;
+    /** Default weekend days */
+    readonly WEEKEND_DAYS: readonly ["saturday", "sunday"];
+    /** Default weekend cell color */
+    readonly WEEKEND_CELL_COLOR: "#e6e6e6";
+    /** Default weekend hide values */
+    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
  */
 export declare const CALENDAR_HEATMAP_COLORS: {
-    /** Color stops for the heatmap gradient */
-    readonly GRADIENT_STOPS: readonly [[number, string], [number, string], [number, string]];
-    /** Default text color */
-    readonly TEXT_COLOR: "#333";
+    /** Default minimum color brightness percent */
+    readonly MIN_COLOR_BRIGHTNESS_PERCENT: 0.5;
+    /** Default maximum color brightness percent */
+    readonly MAX_COLOR_BRIGHTNESS_PERCENT: -0.3;
+    /** Default tooltip color brightness percent */
+    readonly TOOLTIP_COLOR_BRIGHTNESS_PERCENT: -0.2;
     /** Border color for tooltips */
     readonly TOOLTIP_BORDER_COLOR: "#c0c0c0";
 };
-/**
- * Calendar layout configuration
- */
-export declare const CALENDAR_LAYOUT: {
-    /** Weekday abbreviations for calendar header */
-    readonly WEEKDAY_LABELS: readonly ["S", "M", "T", "W", "T", "F", "S"];
-    /** Margin calculations based on cell size */
-    readonly MARGIN_RATIOS: {
-        readonly TOP: 0.8;
-        readonly BOTTOM: 0.4;
-        readonly LEFT: 0.3;
-        readonly RIGHT: 0.3;
+export declare const CALENDAR_HEATMAP_SIZING: {
+    /** Default gap width */
+    readonly GAP_WIDTH: 30;
+    /** Default gap height */
+    readonly GAP_HEIGHT: 10;
+    /** Default margins */
+    readonly MARGINS: {
+        readonly TOP: 20;
+        readonly RIGHT: 40;
+        readonly BOTTOM: 20;
+        readonly LEFT: 40;
     };
-    /** Minimum margin values */
-    readonly MIN_MARGINS: {
-        readonly TOP: 60;
-        readonly BOTTOM: 30;
-        readonly LEFT: 20;
-        readonly RIGHT: 20;
+    readonly COLUMNS: 7;
+    readonly ROWS: 7;
+    readonly MIN_CELL_SIZE: 4;
+    readonly MAX_CELL_SIZE: 80;
+    readonly TITLE_HEIGHT: 20;
+    readonly PAGINATION_HEIGHT: 45;
+    readonly PAGINATION_BUTTON_SIZE: {
+        readonly WIDTH: 30;
+        readonly HEIGHT: 30;
     };
+    readonly MIN_TOOLTIP_WIDTH: 110;
 };
 /**
  * Font size and spacing calculations
  */
 export declare const CALENDAR_TYPOGRAPHY: {
-    /** Font size ratio relative to cell size */
-    readonly FONT_SIZE_RATIO: 0.2;
+    /** Font size ratio relative to cell size for day cell labels */
+    readonly FONT_SIZE_RATIO: 0.3;
     /** Minimum font size */
     readonly MIN_FONT_SIZE: 10;
-    /** Maximum font size */
-    readonly MAX_FONT_SIZE: 24;
+    /** Maximum font size for all labels (except pagination) */
+    readonly MAX_FONT_SIZE: 13;
     /** Label position adjustment ratio */
     readonly LABEL_Y_OFFSET_RATIO: 0.08;
     /** Axis label position ratio */
     readonly AXIS_LABEL_Y_RATIO: 0.3;
     /** Axis offset ratio */
     readonly AXIS_OFFSET_RATIO: 0.4;
-    /** Axis label font size ratio */
-    readonly AXIS_FONT_SIZE_RATIO: 0.24;
     /** Minimum axis font size */
     readonly MIN_AXIS_FONT_SIZE: 12;
 };
@@ -85,3 +106,15 @@ export declare const CALENDAR_HEATMAP_DATA_TYPE: "calendar-heatmap";
  * Full month date format
  */
 export declare const FULL_MONTH_DATE_FORMAT = "MMMM";
+/**
+ * Short month date format (3 letters)
+ */
+export declare const SHORT_MONTH_DATE_FORMAT = "MMM";
+/**
+ * Single letter day abbreviation format
+ */
+export declare const SINGLE_LETTER_DAY_DATE_FORMAT = "EEEEE";
+/**
+ * Reference Sunday date
+ */
+export declare const REFERENCE_SUNDAY_DATE = "2023-01-01T00:00:00Z";

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

@@ -1,12 +1,14 @@
 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
  *
  * Converts user-provided data options to the internal format used by the chart engine,
  * applying default date formatting and normalizing columns.
+ * Ensures that the date attribute has 'day' level granularity, which is required
+ * for proper calendar heatmap visualization.
  *
  * @param dataOptions - User-provided calendar heatmap chart data options
  * @returns Normalized internal data options

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

@@ -1,10 +1,11 @@
-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;
     value?: number;
     blur?: boolean;
+    color?: string;
 };
 export type CalendarHeatmapChartData = {
     type: 'calendar-heatmap';

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/extras-options.d.ts

@@ -1,4 +1,3 @@
-import { BuildContext } from '../../../types.js';
 import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service.js';
 /**
  * Prepares the Highcharts's extras options (title, colorAxis, accessibility) for calendar heatmap
@@ -6,4 +5,4 @@ import { HighchartsOptionsInternal } from '../../../../../../chart-options-proce
  * @param ctx - The highcharts options builder context
  * @returns Extras options object
  */
-export declare function getExtrasOptions(ctx: BuildContext<'calendar-heatmap'>): Partial<HighchartsOptionsInternal>;
+export declare function getExtrasOptions(): Partial<HighchartsOptionsInternal>;