@sisense/sdk-ui 2.21.0 → 2.23.0

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/data-options/translate-axis-from-json.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Translates a single data options axis from JSON to CSDK format.
+ * Shared by chart and pivot-table translators.
+ *
+ * @internal
+ */
+import type { Attribute, Measure } from '@sisense/sdk-data';
+import type { StyledColumn, StyledMeasureColumn } from '../../../../../domains/visualizations/core/chart-data-options/types.js';
+import type { NlqTranslationError } from '../../../types.js';
+import type { InternalDataSchemaContext } from '../../types.js';
+import { type AxisType } from './adapters.js';
+export type { AxisType };
+export type TranslatedAxis = (Attribute | StyledColumn)[] | (Measure | StyledMeasureColumn)[];
+/**
+ * Translates a single axis from JSON to CSDK format.
+ *
+ * @param axisKey - The axis key (e.g. 'category', 'value', 'rows', 'columns')
+ * @param axisValue - The axis value (array or single item)
+ * @param axisType - Whether the axis contains dimensions or measures
+ * @param context - Schema context for translation
+ * @param translationErrors - Array to collect errors into
+ * @returns Translated array or null if translation failed
+ */
+export declare function translateSingleAxisFromJSON(axisKey: string, axisValue: unknown, axisType: AxisType, context: InternalDataSchemaContext, translationErrors: NlqTranslationError[]): TranslatedAxis | null;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/data-options/translate-axis-to-json.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Translates a single data options axis from CSDK to JSON format.
+ * Shared by chart and pivot-table translators.
+ *
+ * @internal
+ */
+import type { NlqTranslationResult } from '../../../types.js';
+import type { DimensionItemJSON, MeasureItemJSON } from '../../types.js';
+import type { AxisType } from './adapters.js';
+/**
+ * Translates a single axis from CSDK to JSON format.
+ *
+ * @param axisKey - The axis key (for error messages)
+ * @param axisValue - The axis value (array or single item)
+ * @param axisType - Whether the axis contains dimensions or measures
+ * @returns NlqTranslationResult with translated JSON array
+ */
+export declare function translateSingleAxisToJSON(axisKey: string, axisValue: unknown, axisType: AxisType): NlqTranslationResult<DimensionItemJSON[] | MeasureItemJSON[]>;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/custom-formula/process-custom-formula.d.ts

@@ -1,4 +1,4 @@
-import { FunctionContext, ProcessedArg } from '../../types.js';
+import { FunctionContext, ProcessedArg } from '../../../types.js';
 /**
  * Custom processor for measureFactory.customFormula that:
  * - Validates formula bracket references match context keys

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/custom-formula/validate-custom-formula.d.ts

@@ -1,3 +1,4 @@
+import type { SchemaIndex } from '../../utils/schema-index.js';
 export interface FormulaValidationResult {
     isValid: boolean;
     errors: string[];
@@ -14,7 +15,19 @@ export interface FormulaValidationOptions {
     allowEmptyFormula?: boolean;
     /** Custom error message prefix for better context */
     errorPrefix?: string;
+    /** When provided, time-diff args are validated as datetime dimensions and level-matched */
+    schemaIndex?: SchemaIndex;
 }
+export interface TimeDiffCall {
+    functionName: string;
+    ref1: string;
+    ref2: string;
+}
+/**
+ * Extracts time-diff (or other two-arg bracket) calls from a formula string.
+ * Matches FUNC([ref1], [ref2]) for each function name in the set (case-insensitive).
+ */
+export declare function parseTimeDiffCalls(formula: string, functionNames: readonly string[]): TimeDiffCall[];
 /**
  * Validates that all bracket references in a custom formula exist in the provided context
  * and provides helpful error messages for debugging.

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/execute-function.d.ts

@@ -1,4 +1,4 @@
-import { ProcessedArg, QueryElement } from '../types.js';
+import { ProcessedArg, QueryElement } from '../../types.js';
 /**
  * Executes a factory function with validated arguments using direct factory access
  */

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/factory-function-processors.d.ts

@@ -2,7 +2,7 @@
  * Custom processing registry for factory functions that require complex validation
  * and transformation beyond basic argument type checking.
  */
-import { CustomFunctionProcessor } from '../types.js';
+import { CustomFunctionProcessor } from '../../types.js';
 /**
  * Registry mapping function paths to their custom processing functions.
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/factory-function-schemas.d.ts

@@ -1,7 +1,7 @@
 /**
  * Comprehensive schema definitions for validating arguments to measureFactory and filterFactory functions.
  */
-import { ArgSchema } from '../types';
+import { ArgSchema } from '../../types.js';
 export declare const FACTORY_FUNCTION_SCHEMAS: Record<string, ArgSchema[]>;
 /**
  * Utility functions for working with function schemas

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/filter-processors.d.ts

@@ -1,4 +1,4 @@
-import { FunctionContext, ProcessedArg } from '../types.js';
+import { FunctionContext, ProcessedArg } from '../../types.js';
 /**
  * Processes filters that accept string | number values
  * Used by: equals, doesntEqual

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/formula-function-schemas.d.ts

@@ -0,0 +1,25 @@
+/** Category of formula function for validation and translation. */
+export type FormulaFunctionCategory = 'time-diff' | 'aggregative' | 'math' | 'growth' | 'date';
+/** Metadata for a formula function (e.g. DDIFF, SUM). */
+export interface FormulaFunctionMeta {
+    category: FormulaFunctionCategory;
+    argCount: number;
+    /** Required date level for time-diff functions (e.g. DateLevels.Days for DDIFF). */
+    requiredDateLevel?: string;
+    /** Argument type constraint; 'datetime' means args must be datetime dimensions. */
+    argType?: 'datetime';
+}
+/** Registry keyed by formula function name (uppercase). */
+export declare const FORMULA_FUNCTION_SCHEMAS: Record<string, FormulaFunctionMeta>;
+/**
+ * Returns formula function names that are time-diff (SDIFF, MNDIFF, HDIFF, DDIFF, MDIFF, QDIFF, YDIFF).
+ */
+export declare function getTimeDiffFormulaFunctions(): readonly string[];
+/**
+ * Returns the required date level for a time-diff function, or undefined if not a time-diff function.
+ */
+export declare function getRequiredDateLevel(formulaFunctionName: string): string | undefined;
+/**
+ * Returns formula function names for a given category.
+ */
+export declare function getFormulaFunctionsByCategory(category: FormulaFunctionCategory): readonly string[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/process-arg.d.ts

@@ -1,4 +1,4 @@
-import { ArgInput, ProcessedArg } from '../types.js';
+import { ArgInput, ProcessedArg } from '../../types.js';
 /**
  * Processes a single argument based on its expected type schema
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/process-node.d.ts

@@ -1,4 +1,4 @@
-import { NodeInput, QueryElement } from '../types.js';
+import { NodeInput, QueryElement } from '../../types.js';
 /**
  * Recursively processes a parsed JSON object to execute filterFactory and measureFactory functions.
  * It includes comprehensive validation based on function schemas.

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/utils/attribute-helpers.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Attribute type predicates for filter validation.
+ *
+ * @internal
+ */
+import { Attribute } from '@sisense/sdk-data';
+/**
+ * Validates that an attribute is compatible with text values
+ *
+ * @param attribute - The attribute to validate
+ * @returns True if the attribute is a text type
+ */
+export declare function isTextAttribute(attribute: Attribute): boolean;
+/**
+ * Validates that an attribute is compatible with numeric values
+ *
+ * @param attribute - The attribute to validate
+ * @returns True if the attribute is a numeric type
+ */
+export declare function isNumericAttribute(attribute: Attribute): boolean;
+/**
+ * Validates that an attribute is a date/datetime type
+ *
+ * @param attribute - The attribute to validate
+ * @returns True if the attribute is a date/datetime type
+ */
+export declare function isDateLevelAttribute(attribute: Attribute): boolean;
+/**
+ * Validates that an attribute is compatible with text OR numeric values
+ * Used for filters like equals, doesntEqual that accept both text and number
+ *
+ * @param attribute - The attribute to validate
+ * @returns True if the attribute is text or numeric type
+ */
+export declare function isTextOrNumericAttribute(attribute: Attribute): boolean;
+/**
+ * Validates that an attribute is NOT a date type
+ * Used for filters that should not work with date attributes
+ *
+ * @param attribute - The attribute to validate
+ * @returns True if the attribute is not a date type
+ */
+export declare function isNonDateLevelAttribute(attribute: Attribute): boolean;
+/**
+ * Gets a display string for the attribute type
+ *
+ * @param attribute - The attribute to get the type display string for
+ * @returns A human-readable string representing the attribute type
+ */
+export declare function getAttributeTypeDisplayString(attribute: Attribute): string;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/utils/fuzzy-match.d.ts

@@ -0,0 +1,16 @@
+/** Maximum edit distance for suggesting "Did you mean?" in error messages */
+export declare const SUGGESTION_THRESHOLD = 3;
+/**
+ * Finds the candidate with the smallest Levenshtein distance to the input.
+ * Used to enhance "not found" errors with "Did you mean 'X'?" when distance <= SUGGESTION_THRESHOLD.
+ *
+ * @param input - The string that was not found
+ * @param candidates - Array of valid candidates to match against
+ * @param getLabel - Function to extract the label string from each candidate
+ * @returns The best match and its distance, or undefined if candidates is empty
+ * @internal
+ */
+export declare function findBestMatch<T>(input: string, candidates: readonly T[], getLabel: (c: T) => string): {
+    best: T;
+    distance: number;
+} | undefined;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{parse-compose-code.d.ts → shared/utils/parse-compose-code.d.ts}

@@ -1,4 +1,4 @@
-import { FunctionCall } from './types.js';
+import { FunctionCall } from '../../types.js';
 /**
  * Parses a composeCode string to FunctionCall format.
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/utils/schema-index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Schema index for efficient table/column lookups and dimensional name parsing.
+ *
+ * @internal
+ */
+import { DateDimension, JaqlDataSourceForDto } from '@sisense/sdk-data';
+import type { NormalizedColumn, NormalizedTable } from '../../../types.js';
+/**
+ * Schema index for efficient table/column lookups and greedy matching
+ * @internal
+ */
+export interface SchemaIndex {
+    /** Tables sorted by name length (descending) for greedy matching */
+    sortedTables: NormalizedTable[];
+    /** Columns sorted by name length (descending) per table for greedy matching */
+    tableColumnMap: Map<string, NormalizedColumn[]>;
+    /** O(1) table lookup by exact name */
+    tableMap: Map<string, NormalizedTable>;
+    /** O(1) column lookup: table name → (column name → column) */
+    columnMap: Map<string, Map<string, NormalizedColumn>>;
+}
+/**
+ * Creates a schema index with pre-sorted arrays and Maps for efficient lookups
+ *
+ * @param tables - Array of normalized tables
+ * @returns SchemaIndex with sorted arrays and Maps
+ * @internal
+ */
+export declare function createSchemaIndex(tables: NormalizedTable[]): SchemaIndex;
+/**
+ * Parses a dimensional name using schema-aware greedy matching to handle dots in table/column names
+ *
+ * @param dimensionalName - The dimensional name (e.g., "DM.Brand.io.Brand" or "DM.Commerce.Date.Years")
+ * @param schemaIndex - The schema index for efficient matching
+ * @returns Parsed result with matched table, column, and optional level
+ * @internal
+ */
+export declare function parseDimensionalName(dimensionalName: string, schemaIndex: SchemaIndex): {
+    table: NormalizedTable;
+    column: NormalizedColumn;
+    level?: string;
+};
+/** Options for {@link createAttributeFromName} when translating custom formula context. */
+export interface CreateAttributeFromNameOptions {
+    /** When the dimensional name has no date level, use this level for datetime columns (e.g. from time-diff function). */
+    inferredDateLevel?: string;
+}
+export declare function createAttributeFromName(attributeName: string, dataSource: JaqlDataSourceForDto, schemaIndex: SchemaIndex, options?: CreateAttributeFromNameOptions): import("@sisense/sdk-data").Attribute | import("@sisense/sdk-data").LevelAttribute;
+export declare function createDateDimensionFromName(dateDimensionName: string, dataSource: JaqlDataSourceForDto, schemaIndex: SchemaIndex): DateDimension;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/utils/translation-helpers.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Translation result and JSON helpers.
+ *
+ * @internal
+ */
+import { JSONValue } from '@sisense/sdk-data';
+import type { NlqTranslationError, NlqTranslationResult } from '../../../types.js';
+/**
+ * Recursively strips [[delimiters]] from all strings in a JSON structure.
+ * Transforms "DM.[[Commerce Sales]].[[Order Date]]" → "DM.Commerce Sales.Order Date"
+ *
+ * @param value - The JSON value to process
+ * @returns The value with all [[delimiters]] stripped from strings
+ * @internal
+ */
+export declare function stripDelimitersFromJson<T extends JSONValue>(value: T): T;
+export declare function getSuccessData<T>(result: NlqTranslationResult<T>): T;
+export declare function getErrors<T>(result: NlqTranslationResult<T>): string[];
+/**
+ * Helper function to collect structured errors from translation operations.
+ *
+ * Executes a translation function and collects any errors into the provided errors array.
+ * Returns the translated data if successful, or null if errors occurred.
+ *
+ * @param translateFn - Function that returns a NlqTranslationResult
+ * @param errors - Array to collect errors into
+ * @param mapError - Optional mapper to transform errors before pushing (e.g., add axis context for chart dataOptions)
+ * @returns The translated data if successful, or null if errors occurred
+ * @internal
+ */
+export declare function collectTranslationErrors<T>(translateFn: () => NlqTranslationResult<T>, errors: NlqTranslationError[], mapError?: (e: NlqTranslationError) => NlqTranslationError): T | null;

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

@@ -1,7 +1,8 @@
-import { Filter, FilterRelations, JaqlDataSourceForDto, JSONArray, JSONValue, Measure } from '@sisense/sdk-data';
+import { Attribute, Filter, FilterRelations, JaqlDataSourceForDto, JSONArray, Measure, PivotGrandTotals } from '@sisense/sdk-data';
 import { CategoryStyle, SeriesStyle, ValueStyle } from '../../../public-api/index.js';
-import { NlqTranslationInput } from '../types.js';
-import type { SchemaIndex } from './common.js';
+import type { PivotTableStyleOptions } from '../../../types.js';
+import { DataSchemaContext, NlqTranslationInput } from '../types.js';
+import type { SchemaIndex } from './shared/utils/schema-index.js';
 /**
  * Internal context type that uses schemaIndex for efficient lookups
  * @internal
@@ -11,6 +12,8 @@ export interface InternalDataSchemaContext {
     dataSource: JaqlDataSourceForDto;
     /** Schema index for efficient table/column lookups */
     schemaIndex: SchemaIndex;
+    /** Chart type for axis-specific translation (e.g., pivot columns, boxplot value) */
+    chartType?: string;
 }
 export declare const DIMENSIONAL_NAME_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';
@@ -52,12 +55,35 @@ 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;
+/**
+ * Type guard: value is a non-null object (Record<string, unknown>).
+ * @internal
+ */
+export declare function isRecordStringUnknown(value: unknown): value is Record<string, unknown>;
+export declare function isFunctionCall(value: unknown): 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[];
+/**
+ * Enriched dimension translation result. Style uses CategoryStyle (same as StyledColumn).
+ *
+ * @internal
+ */
+export type DimensionTranslationItem = {
+    attribute: Attribute;
+    style?: CategoryStyle;
+};
+/**
+ * Enriched measure translation result. Style uses ValueStyle & SeriesStyle (same as StyledMeasureColumn).
+ *
+ * @internal
+ */
+export type MeasureTranslationItem = {
+    measure: Measure;
+    style?: ValueStyle & SeriesStyle;
+};
 /**
  * JSON-facing type for a styled dimension/attribute.
  * Reusable for query JSON and future chart JSON (translateChartFromJSON).
@@ -102,3 +128,88 @@ export declare function isStyledColumnJSON(value: unknown): value is StyledColum
  * @internal
  */
 export declare function isStyledMeasureColumnJSON(value: unknown): value is StyledMeasureColumnJSON;
+/**
+ * JSON representation of chart data options.
+ * Maps axis names to arrays of dimension or measure items.
+ * Supports all chart types (cartesian, categorical, scatter, etc.).
+ *
+ * @internal
+ */
+export interface DataOptionsJSON {
+    category?: DimensionItemJSON[];
+    /** Array for cartesian/categorical; single for calendar-heatmap */
+    value?: MeasureItemJSON[] | MeasureItemJSON;
+    breakBy?: DimensionItemJSON[];
+    x?: DimensionItemJSON | MeasureItemJSON;
+    y?: DimensionItemJSON | MeasureItemJSON;
+    breakByPoint?: DimensionItemJSON;
+    breakByColor?: DimensionItemJSON | MeasureItemJSON;
+    size?: MeasureItemJSON;
+    boxType?: MeasureItemJSON;
+    outliers?: MeasureItemJSON[];
+    geo?: DimensionItemJSON[];
+    colorBy?: MeasureItemJSON;
+    details?: DimensionItemJSON;
+    color?: MeasureItemJSON[];
+    date?: DimensionItemJSON;
+    columns?: (DimensionItemJSON | MeasureItemJSON)[];
+    rows?: DimensionItemJSON[];
+    values?: MeasureItemJSON[];
+    secondary?: MeasureItemJSON[];
+    min?: MeasureItemJSON[];
+    max?: MeasureItemJSON[];
+}
+/**
+ * JSON representation of a chart configuration from NLQ API.
+ * Matches the structure returned by NLQ v3 for chart recommendations.
+ * Reusable for chart JSON translation (translateChartFromJSON/translateChartToJSON).
+ *
+ * @internal
+ */
+export interface ChartJSON {
+    /** Chart type (e.g., 'column', 'line', 'bar', 'pie', 'scatter') */
+    chartType: string;
+    /** Data options mapping chart axes to dimensions/measures */
+    dataOptions: DataOptionsJSON;
+    /** Optional style options for chart appearance (colors, legend, axes, etc.) */
+    styleOptions?: Record<string, unknown>;
+    /** Optional filters to apply to the chart data */
+    filters?: FunctionCall[];
+    /** Optional highlights (filter criteria) to apply to the chart */
+    highlights?: FunctionCall[];
+}
+/**
+ * Input type for chart translation (JSON → CSDK).
+ * Combines chartJSON with data schema context.
+ *
+ * @internal
+ */
+export type ChartInput = NlqTranslationInput<ChartJSON, DataSchemaContext>;
+/**
+ * JSON representation of pivot table data options.
+ *
+ * @internal
+ */
+export interface PivotTableDataOptionsJSON {
+    rows?: DimensionItemJSON[];
+    columns?: DimensionItemJSON[];
+    values?: MeasureItemJSON[];
+    grandTotals?: PivotGrandTotals;
+}
+/**
+ * JSON representation of pivot table config from NLQ API.
+ *
+ * @internal
+ */
+export interface PivotTableJSON {
+    dataOptions: PivotTableDataOptionsJSON;
+    styleOptions?: PivotTableStyleOptions;
+    filters?: FunctionCall[];
+    highlights?: FunctionCall[];
+}
+/**
+ * Input type for pivot table translation (JSON → CSDK).
+ *
+ * @internal
+ */
+export type PivotTableInput = NlqTranslationInput<PivotTableJSON, DataSchemaContext>;

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

@@ -1,4 +1,4 @@
-import { JaqlDataSourceForDto, JSONArray, JSONValue, MetadataItem } from '@sisense/sdk-data';
+import { JaqlDataSourceForDto, JSONArray, MetadataItem } from '@sisense/sdk-data';
 import type { DashboardByIdConfig } from '../../domains/dashboarding';
 import { DashboardProps } from '../../domains/dashboarding/types.js';
 import { ExecutePivotQueryParams, ExecuteQueryParams } from '../../domains/query-execution/index.js';
@@ -353,12 +353,12 @@ export type QueryInput = NlqTranslationInput<NlqResponseJSON, DataSchemaContext>
  * @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 category of the query/chart element that failed (dimensions, measures, filters, highlights, dataOptions, chartType, styleOptions) */
+    category: 'dimensions' | 'measures' | 'filters' | 'highlights' | 'dataOptions' | 'chartType' | 'styleOptions';
+    /** The index of the element within its category array, or axis key for dataOptions (e.g. "category", "value") */
+    index: number | string;
     /** The complete original input that caused the error */
-    input: JSONValue;
+    input: unknown;
 };
 /**
  * Structured error information for translation failures.

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

@@ -8,8 +8,8 @@ import { AreamapChartDataOptions, BoxplotChartCustomDataOptions, BoxplotChartDat
 import { HighchartsOptions } from './domains/visualizations/core/chart-options-processor/chart-options-service';
 import type { ChartWidgetProps } from './domains/widgets/components/chart-widget/types';
 import { FiltersMergeStrategy } from './domains/widgets/components/widget-by-id/types';
-import { AppConfig } from './infra/app/client-application';
-import { HookEnableParam } from './shared/hooks/types';
+import { type AppConfig } from './infra/app/types';
+import type { Plugin } from './infra/contexts/plugin-provider/types';
 import { AreamapDataPoint, AreamapStyleOptions, AreaRangeStyleOptions, AreaStyleOptions, BoxplotDataPoint, BoxplotStyleOptions, CalendarHeatmapDataPoint, CalendarHeatmapStyleOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ChartDataOptions, ChartDataPoints, ChartStyleOptions, ChartType, CustomDrilldownResult, DataPoint, DrilldownOptions, DrilldownSelection, FunnelStyleOptions, IndicatorDataPoint, IndicatorRenderOptions, IndicatorStyleOptions, LineStyleOptions, MenuAlignment, MenuItemSection, MenuPosition, PieStyleOptions, PivotTableDataPoint, PivotTableDrilldownOptions, PivotTableStyleOptions, PolarStyleOptions, RegularChartStyleOptions, RegularChartType, ScatterDataPoint, ScattermapDataPoint, ScattermapStyleOptions, ScatterStyleOptions, StackableStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, TableStyleOptions, TabularChartStyleOptions, TextWidgetDataPoint, ThemeConfig, ThemeOid, ThemeSettings, TreemapStyleOptions, WidgetByIdStyleOptions } from './types';
 export type { TabberButtonsWidgetProps } from './domains/widgets/components/tabber-buttons-widget/types';
 export type { WidgetProps, WidgetType, WithCommonWidgetProps, } from './domains/widgets/components/widget/types';
@@ -137,6 +137,18 @@ export interface SisenseContextProviderProps {
      * @internal
      */
     disableFusionPalette?: boolean;
+    /**
+     * Array of plugins to register.
+     *
+     * Plugins should satisfy the following conditions:
+     * - Name uniqueness (duplicates are skipped with a warning)
+     * - Version compatibility with the current SDK version
+     *
+     * @category Sisense App
+     *
+     * @internal
+     */
+    plugins?: Plugin[];
 }
 /**
  * Props for {@link ExecuteQuery} component.
@@ -1377,25 +1389,6 @@ export interface DrilldownWidgetProps {
      */
     children: (customDrilldownResult: CustomDrilldownResult) => ReactNode;
 }
-/**
- * Params of the {@link useGetSharedFormula} hook
- *
- * Can consist either of an oid or a name/dataSource pair
- */
-export interface UseGetSharedFormulaParams extends HookEnableParam {
-    /**
-     * Formula identifier
-     */
-    oid?: string;
-    /**
-     * Formula name
-     */
-    name?: string;
-    /**
-     * Data source - e.g. `Sample ECommerce`
-     */
-    dataSource?: DataSource;
-}
 /**
  * Props of the {@link CalendarHeatmapChart} component.
  */

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

@@ -4,4 +4,4 @@
  * Alpha APIs are highly experimental and subject to change.
  * Not recommended for production use.
  */
-export { useQueryCache } from '../domains/query-execution/hooks/use-query-cache/use-query-cache';
+export { useDashboardTheme } from '../domains/dashboarding/use-dashboard-theme.js';

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

@@ -4,4 +4,4 @@
  * Beta APIs are under evaluation and may change in future releases.
  * Not recommended for production use.
  */
-export {};
+export { useQueryCache } from '../domains/query-execution/hooks/use-query-cache/use-query-cache';

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

@@ -4,11 +4,12 @@
  * Such APIs are for CSDK cross-packages usage only.
  * These APIs may change without notice and are not part of the public contract.
  */
-export { type ClientApplication, createClientApplication } from '../infra/app/client-application';
+export { type ClientApplication } from '../infra/app/types';
+export { createClientApplication } from '../infra/app/client-application';
 export { queryStateReducer } from '../domains/query-execution/hooks/shared/query-state-reducer';
 export { useExecuteCsvQueryInternal, useExecutePivotQueryInternal, executeQueryByWidgetId, } from '../domains/query-execution';
 export { executeCsvQuery, executePivotQuery, executeQuery, } from '../domains/query-execution/core/execute-query';
-export { useDashboardModel, getDashboardModel, getDashboardModels, translateToDashboardResponse, translateToDashboardsResponse, translateFiltersAndRelationsToDto, } from '../domains/dashboarding/dashboard-model';
+export { useDashboardModel, getDashboardModel, getDashboardModels, translateToDashboardResponse, translateToDashboardsResponse, } from '../domains/dashboarding/dashboard-model';
 export { getWidgetModel } from '../domains/widgets/widget-model';
 export { getHierarchyModels } from '../domains/drilldown/hierarchy-model';
 export { getThemeSettingsByOid } from '../infra/themes/theme-loader';
@@ -18,12 +19,14 @@ export { getSelectionTitleMenuItem, getDrilldownMenuItems, } from '../domains/dr
 export { processDrilldownSelections } from '../domains/drilldown/hooks/use-drilldown-core';
 export { CommonWidget, type CommonWidgetProps } from '../domains/widgets/components/common-widget';
 export { TableWidget, type TableWidgetProps } from '../domains/widgets/components/table-widget';
-export * from '../infra/contexts/custom-widgets-provider/custom-widgets-provider-adapter';
+export { CustomWidgetsProviderAdapter, type CustomWidgetsContextAdapter, type CustomWidgetsProviderAdapterProps, } from '../infra/contexts/custom-widgets-provider/custom-widgets-provider-adapter';
+export { useGetSharedFormulaInternal } from '../domains/formulas/use-get-shared-formula';
 export { translateColumnToAttribute } from '../domains/visualizations/core/chart-data-options/utils';
 export { isSameAttribute } from '../shared/utils/filters';
-export { isChartWidgetProps, isPivotTableWidgetProps, isTextWidgetProps, isCustomWidgetProps, } from '../domains/widgets/components/widget-by-id/utils';
+export { isTextWidgetProps, isCustomWidgetProps, } from '../domains/widgets/components/widget-by-id/utils';
 export { getChartType } from '../domains/widgets/components/widget-by-id/utils';
 export type { SoftUnion } from '../shared/utils/utility-types';
 export type { BeforeMenuOpenHandler } from '../infra/contexts/menu-provider/types';
-export * from '../shared/hooks/data-load-state-reducer';
-export * from '../domains/widgets/helpers';
+export { type DataState, type DataLoadingState, type DataErrorState, type DataSuccessState, dataLoadStateReducer, } from '../shared/hooks/data-load-state-reducer';
+export { trackHook } from '../infra/decorators/hook-decorators/with-tracking';
+export { widgetHelpers } from '../domains/widgets/helpers';

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

@@ -50,11 +50,11 @@ export { TabberButtonsWidget } from '../domains/widgets/components/tabber-button
 export { DrilldownBreadcrumbs } from '../domains/drilldown/components/drilldown-breadcrumbs';
 export * from '../infra/contexts/custom-widgets-provider/types';
 export { useCustomWidgets } from '../infra/contexts/custom-widgets-provider';
-export { useGetDashboardModel, useGetDashboardModels, useDashboardModel, type DashboardModel, type GetDashboardModelParams, type GetDashboardModelsParams, type DashboardModelState, type DashboardModelLoadingState, type DashboardModelSuccessState, type DashboardModelErrorState, type DashboardModelsState, type DashboardModelsLoadingState, type DashboardModelsSuccessState, type DashboardModelsErrorState, 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, UseDashboardModelActionType, } from '../domains/dashboarding/dashboard-model';
+export { useGetDashboardModel, useGetDashboardModels, useDashboardModel, type DashboardModel, type GetDashboardModelParams, type GetDashboardModelsParams, type DashboardModelState, type DashboardModelLoadingState, type DashboardModelSuccessState, type DashboardModelErrorState, type DashboardModelsState, type DashboardModelsLoadingState, type DashboardModelsSuccessState, type DashboardModelsErrorState, type GetDashboardModelOptions, type GetDashboardModelsOptions, type WidgetsPanelColumnLayout, type WidgetsPanelLayout, type WidgetsPanelColumn, type WidgetsPanelRow, type WidgetsPanelCell, type WidgetId, type DashboardId, type WidgetsOptions, type SpecificWidgetOptions, type CommonFiltersOptions, type CommonFiltersApplyMode, type FiltersIgnoringRules, } from '../domains/dashboarding/dashboard-model';
 export { useGetWidgetModel, type WidgetModel, type WidgetDataOptions, type WidgetModelState, type WidgetModelLoadingState, type WidgetModelErrorState, type WidgetModelSuccessState, type GetWidgetModelParams, } from '../domains/widgets/widget-model';
 export { useGetHierarchyModels, type HierarchyModel, type Hierarchy, type HierarchyId, type GetHierarchyModelsParams, type HierarchyModelsState, type HierarchyModelsLoadingState, type HierarchyModelsErrorState, type HierarchyModelsSuccessState, } from '../domains/drilldown/hierarchy-model';
 export * from '../domains/filters';
-export * from '../domains/formulas';
+export { useGetSharedFormula, type GetSharedFormulaParams, type UseGetSharedFormulaParams, type SharedFormulaState, type SharedFormulaLoadingState, type SharedFormulaErrorState, type SharedFormulaSuccessState, } from '../domains/formulas';
 export { DataSchemaBrowser } from '../domains/data-browser/data-schema-browser/data-schema-browser';
 export { useGetDataSourceDimensions, useGetDataSourceFields, type GetDataSourceDimensionsParams, type DataSourceDimensionsState, type DataSourceDimensionsLoadingState, type DataSourceDimensionsErrorState, type DataSourceDimensionsSuccessState, } from '../domains/data-browser/data-source-dimensional-model';
 export { ThemeProvider } from '../infra/contexts/theme-provider';