@sisense/sdk-ui 2.9.0 → 2.11.0

package/dist/packages/sdk-ui/src/ai/chart/nlq-chart-widget.d.ts

@@ -1,5 +1,6 @@
 import { Filter, Data, FilterRelations } from '@sisense/sdk-data';
 import type { NlqResponseData } from '../../ai';
+import { ChartWidgetProps } from '../../props';
 import { NlqChartWidgetStyleOptions } from '../../types';
 /**
  * Props for {@link NlqChartWidget} component.
@@ -29,6 +30,11 @@ export interface NlqChartWidgetProps {
      * @default true
      */
     styleOptions?: NlqChartWidgetStyleOptions;
+    /**
+     * Widget props if we have them in full, to ensure NlqChartWidget will be rendered
+     * the same way as ChartWidget
+     */
+    widgetProps?: ChartWidgetProps;
 }
 /**
  * React component that renders a chart widget based on NLQ response data.
@@ -52,4 +58,4 @@ export interface NlqChartWidgetProps {
  * @group Generative AI
  * @internal
  */
-export declare const NlqChartWidget: ({ nlqResponse, onDataReady, styleOptions, filters, }: NlqChartWidgetProps) => import("react/jsx-runtime").JSX.Element;
+export declare const NlqChartWidget: ({ nlqResponse, onDataReady, styleOptions, widgetProps, filters, }: NlqChartWidgetProps) => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/analytics-composer/new-nlq-translator/common.d.ts

@@ -13,6 +13,20 @@ export declare function isMeasureElement(arg: QueryElement): arg is Measure;
 export declare function getFactoryFunctionsMap(factoryName: string, factoryObject: Record<string, any>): Record<string, (...args: any[]) => any>;
 export declare const measureFactoryFunctionsMap: Record<string, (...args: any[]) => any>;
 export declare const filterFactoryFunctionsMap: Record<string, (...args: any[]) => any>;
+/**
+ * Validates if a string is likely an attribute based on the actual table schema.
+ *
+ * @param str - The string to check
+ * @param tables - The normalized tables to check against
+ * @returns True if the string matches known table/column combinations
+ */
+export declare function validateLikelyAttribute(str: string, tables: NormalizedTable[]): {
+    isLikelyAttribute: true;
+    suggestion: string;
+} | {
+    isLikelyAttribute: false;
+    suggestion?: never;
+};
 export declare function createAttribute(attributeName: string, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]): import("@sisense/sdk-data").Attribute | import("@sisense/sdk-data").LevelAttribute;
 /**
  * Recursively processes a parsed JSON object to execute filterFactory and measureFactory functions.

package/dist/packages/sdk-ui/src/analytics-composer/new-nlq-translator/translate-dimensions.d.ts

@@ -1,3 +1,3 @@
 import { Attribute, JaqlDataSourceForDto, JSONArray } from '@sisense/sdk-data';
-import { NormalizedTable } from '../types.js';
-export declare const translateDimensionsJSON: (dimensionsJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => Attribute[];
+import { NlqTranslationResult, NormalizedTable } from '../types.js';
+export declare const translateDimensionsJSON: (dimensionsJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => NlqTranslationResult<Attribute[]>;

package/dist/packages/sdk-ui/src/analytics-composer/new-nlq-translator/translate-filters.d.ts

@@ -1,5 +1,5 @@
 import { Filter, FilterRelations, JaqlDataSourceForDto, JSONArray } from '@sisense/sdk-data';
-import { NormalizedTable } from '../types.js';
+import { NlqTranslationResult, NormalizedTable } from '../types.js';
 import { ParsedFunctionCall } from './common.js';
 /**
  * Translate an array of JSON objects to filters
@@ -38,7 +38,7 @@ import { ParsedFunctionCall } from './common.js';
  * @param tables - The tables to use for the filters
  * @returns A Filter[] or FilterRelations object
  */
-export declare const translateFiltersFromJSONFunctionCall: (filtersJSON: ParsedFunctionCall[], dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => Filter[] | FilterRelations;
-export declare const translateFiltersJSON: (filtersJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => Filter[] | FilterRelations;
-export declare const translateHighlightsFromJSONFunctionCall: (highlightsJSON: ParsedFunctionCall[], dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => Filter[];
-export declare const translateHighlightsJSON: (highlightsJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => Filter[];
+export declare const translateFiltersFromJSONFunctionCall: (filtersJSON: ParsedFunctionCall[], dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => NlqTranslationResult<Filter[] | FilterRelations>;
+export declare const translateFiltersJSON: (filtersJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => NlqTranslationResult<Filter[] | FilterRelations>;
+export declare const translateHighlightsFromJSONFunctionCall: (highlightsJSON: ParsedFunctionCall[], dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => NlqTranslationResult<Filter[]>;
+export declare const translateHighlightsJSON: (highlightsJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => NlqTranslationResult<Filter[]>;

package/dist/packages/sdk-ui/src/analytics-composer/new-nlq-translator/translate-measures.d.ts

@@ -1,5 +1,5 @@
 import { JaqlDataSourceForDto, JSONArray, Measure } from '@sisense/sdk-data';
-import { NormalizedTable } from '../types.js';
+import { NlqTranslationResult, NormalizedTable } from '../types.js';
 import { ParsedFunctionCall } from './common.js';
 /**
  * Translate an array of JSON objects to measures
@@ -26,5 +26,5 @@ import { ParsedFunctionCall } from './common.js';
  * @param tables - The tables to use for the measures
  * @returns A Measure[] object
  */
-export declare const translateMeasuresFromJSONFunctionCall: (measuresJSON: ParsedFunctionCall[], dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => Measure[];
-export declare const translateMeasuresJSON: (measuresJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => Measure[];
+export declare const translateMeasuresFromJSONFunctionCall: (measuresJSON: ParsedFunctionCall[], dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => NlqTranslationResult<Measure[]>;
+export declare const translateMeasuresJSON: (measuresJSON: JSONArray, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]) => NlqTranslationResult<Measure[]>;

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

@@ -316,4 +316,16 @@ export type NlqResponseJSON = {
     filters: JSONArray;
     highlights?: JSONArray;
 };
+/**
+ * Represents the result of a translation operation that can either succeed with data or fail with errors.
+ *
+ * @internal
+ */
+export type NlqTranslationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: string[];
+};
 export {};

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

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

@@ -0,0 +1,26 @@
+/// <reference types="react" />
+import { CalendarHeatmapChartProps } from './props';
+/**
+ * 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
+ * @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/restructured-charts/highchart-based-charts/calendar-heatmap-chart/calendar-heatmap-chart-builder.d.ts

@@ -0,0 +1,8 @@
+import { ChartBuilder } from '../../../../chart/restructured-charts/types.js';
+/**
+ * Calendar heatmap chart builder configuration
+ *
+ * Provides a complete configuration for building calendar heatmap charts,
+ * including data processing, styling, and rendering capabilities.
+ */
+export declare const calendarHeatmapChartBuilder: ChartBuilder<'calendar-heatmap'>;

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

@@ -0,0 +1,118 @@
+import { ViewType } from './types';
+/**
+ * Default calendar heatmap chart configuration constants
+ */
+export declare const CALENDAR_HEATMAP_DEFAULTS: {
+    /** Default view type */
+    readonly VIEW_TYPE: ViewType.MONTH;
+    /** Default color for days without data */
+    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: 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";
+};
+/**
+ * Calendar heatmap color scheme configuration
+ */
+export declare const CALENDAR_HEATMAP_COLORS: {
+    /** 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";
+};
+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;
+    };
+    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 for day cell labels */
+    readonly FONT_SIZE_RATIO: 0.3;
+    /** Minimum font size */
+    readonly MIN_FONT_SIZE: 10;
+    /** 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;
+    /** Minimum axis font size */
+    readonly MIN_AXIS_FONT_SIZE: 12;
+};
+/**
+ * Calendar heatmap data type
+ */
+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

@@ -0,0 +1,56 @@
+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';
+/**
+ * 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
+ */
+export declare function translateCalendarHeatmapChartDataOptions(dataOptions: CalendarHeatmapChartDataOptions): CalendarHeatmapChartDataOptionsInternal;
+/**
+ * Extracts attributes from calendar heatmap chart data options
+ *
+ * Returns an array of attributes that can be used for data queries.
+ * For calendar heatmaps, this typically includes the date attribute.
+ *
+ * @param dataOptions - Internal calendar heatmap chart data options
+ * @returns Array of attributes extracted from the data options
+ */
+export declare function getCalendarHeatmapAttributes(dataOptions: CalendarHeatmapChartDataOptionsInternal): Attribute[];
+/**
+ * Extracts measures from calendar heatmap chart data options
+ *
+ * Returns an array of measures that can be used for data queries.
+ * For calendar heatmaps, this typically includes the value measure.
+ *
+ * @param dataOptions - Internal calendar heatmap chart data options
+ * @returns Array of measures extracted from the data options
+ */
+export declare function getCalendarHeatmapMeasures(dataOptions: CalendarHeatmapChartDataOptionsInternal): Measure[];
+/**
+ * Type guard to check if data options are valid for calendar heatmap charts
+ *
+ * Validates that the provided data options contain the required properties
+ * for calendar heatmap charts (date and value).
+ *
+ * @param dataOptions - Data options to validate
+ * @returns True if the data options are valid for calendar heatmap charts
+ */
+export declare function isCalendarHeatmapChartDataOptions(dataOptions: ChartDataOptions): dataOptions is CalendarHeatmapChartDataOptions;
+/**
+ * Type guard to check if internal data options are valid for calendar heatmap charts
+ *
+ * Validates that the provided internal data options contain the required properties
+ * and are properly structured for calendar heatmap charts.
+ *
+ * @param dataOptions - Internal data options to validate
+ * @returns True if the internal data options are valid for calendar heatmap charts
+ */
+export declare function isCalendarHeatmapChartDataOptionsInternal(dataOptions: ChartDataOptionsInternal): dataOptions is CalendarHeatmapChartDataOptionsInternal;

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

@@ -0,0 +1 @@
+export * from './data-options.js';

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

@@ -0,0 +1,34 @@
+import { DataTable } from '../../../../chart-data-processor/table-processor';
+import { CalendarHeatmapChartDataOptionsInternal } from '../../../../chart-data-options/types';
+import { ChartData } from '../../../../chart-data/types';
+export type CalendarHeatmapDataValue = {
+    date: Date;
+    value?: number;
+    blur?: boolean;
+    color?: string;
+};
+export type CalendarHeatmapChartData = {
+    type: 'calendar-heatmap';
+    values: CalendarHeatmapDataValue[];
+};
+/**
+ * Converts a data table to calendar heatmap chart data format
+ *
+ * Transforms raw data table rows into the specific format required for calendar heatmap visualization,
+ * extracting date and value pairs from the configured columns.
+ *
+ * @param chartDataOptions - Internal data options specifying which columns to use
+ * @param dataTable - Raw data table containing the source data
+ * @returns Formatted calendar heatmap chart data
+
+ */
+export declare function getCalendarHeatmapChartData(chartDataOptions: CalendarHeatmapChartDataOptionsInternal, dataTable: DataTable): CalendarHeatmapChartData;
+/**
+ * Type guard to check if chart data is calendar heatmap chart data
+ *
+ * Validates that the provided chart data is specifically formatted for calendar heatmap charts.
+ *
+ * @param chartData - Chart data to validate
+ * @returns True if the chart data is calendar heatmap chart data
+ */
+export declare function isCalendarHeatmapChartData(chartData: ChartData): chartData is CalendarHeatmapChartData;

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

@@ -0,0 +1,22 @@
+import { CalendarHeatmapStyleOptions, ChartStyleOptions } from '../../../../types';
+import { DesignOptions } from '../../../../chart-options-processor/translations/types';
+/**
+ * Translates calendar heatmap style options to design options
+ *
+ * Converts user-provided style options to the internal design options format
+ * used by the chart engine, applying default values where necessary.
+ *
+ * @param styleOptions - User-provided calendar heatmap style options
+ * @returns Translated design options for internal use
+ */
+export declare function translateCalendarHeatmapStyleOptionsToDesignOptions(styleOptions: CalendarHeatmapStyleOptions): DesignOptions<'calendar-heatmap'>;
+/**
+ * Type guard to check if style options are valid for calendar heatmap charts
+ *
+ * Validates that the provided style options are properly structured for calendar heatmap charts.
+ * Since all style options are optional, this primarily checks for basic object structure.
+ *
+ * @param styleOptions - Style options to validate
+ * @returns True if the style options are valid for calendar heatmap charts
+ */
+export declare function isCalendarHeatmapStyleOptions(styleOptions: ChartStyleOptions): styleOptions is CalendarHeatmapStyleOptions;

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

@@ -0,0 +1,8 @@
+import { HighchartsOptionsBuilder } from '../../types.js';
+/**
+ * Main Highcharts options builder for calendar heatmap charts
+ *
+ * Combines all individual configuration builders to create complete
+ * Highcharts options for calendar heatmap visualization.
+ */
+export declare const calendarHeatmapHighchartsOptionsBuilder: HighchartsOptionsBuilder<'calendar-heatmap'>;

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

@@ -0,0 +1 @@
+export { calendarHeatmapHighchartsOptionsBuilder } from './highcharts-options-builder.js';

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

@@ -0,0 +1,12 @@
+import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service.js';
+import { BuildContext } from '../../../types.js';
+/**
+ * Prepares the Highcharts's axes options for calendar heatmap
+ *
+ * @param ctx - The highcharts options builder context
+ * @returns Axes configuration object with xAxis and yAxis
+ */
+export declare function getAxesOptions(ctx: BuildContext<'calendar-heatmap'>): {
+    xAxis: HighchartsOptionsInternal['xAxis'];
+    yAxis: HighchartsOptionsInternal['yAxis'];
+};

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

@@ -0,0 +1,9 @@
+import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service.js';
+import { BuildContext } from '../../../types.js';
+/**
+ * Prepares the Highcharts's chart options for calendar heatmap
+ *
+ * @param ctx - The highcharts options builder context
+ * @returns Highchart's chart options object
+ */
+export declare function getChartOptions(ctx: BuildContext<'calendar-heatmap'>): HighchartsOptionsInternal['chart'];

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

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

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

@@ -0,0 +1,7 @@
+export { getAxesOptions } from './axes-options.js';
+export { getChartOptions } from './chart-options.js';
+export { getExtrasOptions } from './extras-options.js';
+export { getLegendOptions } from './legend-options.js';
+export { getPlotOptions } from './plot-options.js';
+export { getSeriesOptions } from './series-options';
+export { getTooltipOptions } from './tooltip-options.js';

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

@@ -0,0 +1,8 @@
+import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service';
+/**
+ * Prepares the Highcharts's legend options for calendar heatmap
+ *
+ * @param ctx - The highcharts options builder context
+ * @returns Legend options object
+ */
+export declare function getLegendOptions(): HighchartsOptionsInternal['legend'];

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

@@ -0,0 +1,9 @@
+import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service';
+import { BuildContext } from '../../../types';
+/**
+ * Prepares the Highcharts's plot options for calendar heatmap
+ *
+ * @param ctx - The highcharts options builder context
+ * @returns Plot options object
+ */
+export declare function getPlotOptions(ctx: BuildContext<'calendar-heatmap'>): HighchartsOptionsInternal['plotOptions'];

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

@@ -0,0 +1,42 @@
+import { CalendarHeatmapChartData } from '../../../data.js';
+import { DateFormatter } from '../../../../../../../common/formatters/create-date-formatter.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
+ */
+export interface CalendarChartDataPoint {
+    /** X coordinate (day of week, 0-6) */
+    x: number;
+    /** Y coordinate (week row, 0-5) */
+    y: number;
+    /** Data value or null for cells without data */
+    value: number | null;
+    /** Date timestamp */
+    date: number;
+    /** Date string for tooltip display */
+    dateString?: string;
+    /** Custom color override */
+    color?: string;
+    /** Class name for the data point */
+    className?: string;
+    /** Custom properties for the data point */
+    custom: {
+        /** Day of the month (1-31) */
+        monthDay?: number;
+        /** Whether this cell has data */
+        hasData?: boolean;
+        /** Whether this data point should be blurred for highlighting */
+        blur?: boolean;
+    };
+}
+/**
+ * Generates calendar chart data for an entire month with provided data values
+ *
+ * @param data - Array of data points with dates and values
+ * @param dateFormatter - Date formatter function
+ * @param startOfWeek - Week start preference
+ * @param weekendsConfig - Weekend configuration (days, cellColor, hideValues)
+ * @returns Array of calendar chart data points formatted for Highcharts
+ */
+export declare function generateCalendarChartData(data: CalendarHeatmapChartData, dateFormatter: DateFormatter, startOfWeek: CalendarDayOfWeek, weekendsConfig: CalendarHeatmapChartDesignOptions['weekends']): CalendarChartDataPoint[];

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

@@ -0,0 +1 @@
+export { getSeriesOptions } from './series-options.js';

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

@@ -0,0 +1,9 @@
+import { HighchartsOptionsInternal } from '../../../../../../../chart-options-processor/chart-options-service.js';
+import { BuildContext } from '../../../../types.js';
+/**
+ * Prepares the Highcharts's series options for calendar heatmap
+ *
+ * @param ctx - The highcharts options builder context
+ * @returns Array of series options
+ */
+export declare function getSeriesOptions(ctx: BuildContext<'calendar-heatmap'>): HighchartsOptionsInternal['series'];

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

@@ -0,0 +1,9 @@
+import { BuildContext } from '../../../types.js';
+import { HighchartsOptionsInternal } from '../../../../../../chart-options-processor/chart-options-service.js';
+/**
+ * Prepares the Highcharts's tooltip options for calendar heatmap
+ *
+ * @param ctx - The highcharts options builder context
+ * @returns Tooltip options object
+ */
+export declare function getTooltipOptions(ctx: BuildContext<'calendar-heatmap'>): HighchartsOptionsInternal['tooltip'];

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

@@ -0,0 +1,34 @@
+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';
+export declare const ChartsContainer: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+} & {
+    viewType: CalendarHeatmapViewType;
+    gridCols: number;
+    gridRows: number;
+}, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const ChartWrapper: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+}, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const ChartTitle: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+}, React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, {}>;
+interface CalendarHeatmapChartsGridProps {
+    monthCharts: (HighchartsOptionsInternal | null)[];
+    availableMonths: MonthInfo[];
+    currentViewIndex: number;
+    viewType: CalendarHeatmapViewType;
+    size: ContainerSize;
+    monthLabels?: {
+        enabled?: boolean;
+        style?: TextStyle;
+    };
+}
+export declare const CalendarHeatmapChartsGrid: React.FC<CalendarHeatmapChartsGridProps>;
+export {};

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

@@ -0,0 +1,15 @@
+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';
+export declare const ChartRootContainer: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+} & Themable, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const ChartsWrapper: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+}, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export type CalendarHeatmapProps = HighchartsBasedChartRendererProps<'calendar-heatmap'>;
+export declare function CalendarHeatmap({ chartData, dataOptions, designOptions, onDataPointClick, onDataPointContextMenu, onDataPointsSelected, onBeforeRender, size, }: CalendarHeatmapProps): import("react/jsx-runtime").JSX.Element;
+export declare const isCalendarHeatmapProps: (props: ChartRendererProps) => props is CalendarHeatmapProps;

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

@@ -0,0 +1,31 @@
+import React from 'react';
+import { MonthInfo } from '../helpers/view-helpers.js';
+import { CalendarHeatmapViewType } from '../../../../../../types.js';
+import { Themable } from '../../../../../../theme-provider/types.js';
+export declare const PaginationContainer: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+}, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const NavigationButton: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+} & {
+    disabled: boolean;
+}, React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {}>;
+export declare const ViewDisplay: import("@emotion/styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefined;
+} & Themable, React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+interface CalendarPaginationProps {
+    currentViewIndex: number;
+    availableMonths: MonthInfo[];
+    viewType: CalendarHeatmapViewType;
+    onGoToFirst: () => void;
+    onGoToPrevious: () => void;
+    onGoToNext: () => void;
+    onGoToLast: () => void;
+    onGoToPreviousGroup?: () => void;
+    onGoToNextGroup?: () => void;
+}
+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

@@ -0,0 +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;