@sisense/sdk-ui 2.29.0 → 2.31.0

package/dist/packages/sdk-ui/src/modules/ai/common/collapsible.d.ts

@@ -1,13 +1,49 @@
 type CollapsibleProps = {
     text: string;
+    /**
+     * Overrides default `Collapsed Lines` count with an explicit pixel value, snapped to whole text rows
+     * internally. Treated as a max-height cap unless `reserveCollapsedHeight` is true.
+     */
+    maxCollapsedHeightPx?: number;
+    /**
+     * Maximum height of the expanded state in pixels.
+     * Content scrolls rather than exceeding this limit. No cap when omitted.
+     */
+    maxExpandedHeightPx?: number;
+    /**
+     * When true the component always occupies exactly `collapsedHeight` pixels even when
+     * text is shorter — prevents widget layout shifts during data loads.
+     * Defaults to false (`max-height` behaviour, container shrinks to content).
+     */
+    reserveCollapsedHeight?: boolean;
+    /** Disables collapsing entirely. */
+    noCollapse?: boolean;
+    /**
+     * Shows a loading overlay at the settled collapsed height.
+     * Only renders `LoadingOverlay` (which requires SisenseContext) when this is `true`.
+     */
+    isLoading?: boolean;
+    /** Shows an error state instead of content. */
+    isError?: boolean;
+    /** Fired when the collapsed state toggles. */
+    onCollapsedChange?: (isCollapsed: boolean) => void;
+    /** Additional CSS class applied to the text container. */
+    textClassName?: string;
+    /**
+     * When true, renders an AI disclaimer line below the narrative text.
+     * The disclaimer is always visible (not clipped when collapsed) but its height is
+     * subtracted from the available text area so the total component height stays within
+     * the configured limit. Defaults to false.
+     */
+    showDisclaimer?: boolean;
 };
 /**
- * Text container with an expand/collapse button for text over the character limit.
+ * Text container with an expand/collapse button for text that overflows the collapsed height.
  *
  * Uses `max-height` + `overflow: hidden` when collapsed (not `line-clamp`), because
  * `white-space: pre-wrap` is incompatible with `-webkit-line-clamp` in browsers.
  *
  * @internal
  */
-export default function Collapsible({ text }: CollapsibleProps): import("react/jsx-runtime").JSX.Element;
+export default function Collapsible({ text, maxCollapsedHeightPx, maxExpandedHeightPx, reserveCollapsedHeight, noCollapse, isLoading, isError, onCollapsedChange, textClassName, showDisclaimer, }: CollapsibleProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/packages/sdk-ui/src/modules/ai/get-nlg-insights-from-widget.d.ts

@@ -1,21 +1,14 @@
 import { HttpClient } from '@sisense/sdk-rest-client';
-import type { WidgetNarrativeNlgOptions } from '../../domains/narrative/core/widget-narrative-options.js';
 import { WidgetProps } from '../../domains/widgets/components/widget/types';
-/**
- * Options for {@link getNlgInsightsFromWidget} function.
- *
- * @internal
- */
-export type GetNlgInsightsFromWidgetOptions = WidgetNarrativeNlgOptions;
 /**
  * Pure function that fetches NLG insights from WidgetProps.
  *
  * This function converts WidgetProps to the required API format and makes an HTTP request
  * to get natural language insights about the chart or pivot data.
  *
- * @param props - WidgetProps containing chart or pivot configuration
+ * @param props - WidgetProps containing chart or pivot configuration (`config.narrative`
+ *   drives {@link WidgetNarrativeConfig})
  * @param httpClient - HttpClient instance for making API requests
- * @param options - Optional configuration including defaultDataSource and verbosity
  * @returns Promise that resolves to the NLG insights answer string
  * @throws Error if dataSource cannot be resolved or if API response is invalid
  * @example
@@ -32,10 +25,8 @@ export type GetNlgInsightsFromWidgetOptions = WidgetNarrativeNlgOptions;
  *
  * const httpClient = new HttpClient(url, auth, env);
  *
- * const insights = await getNlgInsightsFromWidget(widgetProps, httpClient, {
- *   verbosity: 'High',
- * });
+ * const insights = await getNlgInsightsFromWidget(widgetProps, httpClient);
  * ```
  * @internal
  */
-export declare function getNlgInsightsFromWidget(props: WidgetProps, httpClient: HttpClient, options?: GetNlgInsightsFromWidgetOptions): Promise<string>;
+export declare function getNlgInsightsFromWidget(props: WidgetProps, httpClient: HttpClient): Promise<string>;

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

@@ -15,5 +15,5 @@ export { ChatRestApi } from './api/chat-rest-api.js';
 export type { GetNarrativeOptions } from '../../infra/api/narrative/narrative-endpoints.js';
 export { CustomAiContextProvider, type CustomAiContext, type CustomAiContextProviderProps, } from './custom-ai-context-provider.js';
 export { prepareGetNlgInsightsPayload } from '../../domains/narrative/core/build-narrative-request.js';
-export { getNlgInsightsFromWidget, type GetNlgInsightsFromWidgetOptions, } from './get-nlg-insights-from-widget.js';
+export { getNlgInsightsFromWidget } from './get-nlg-insights-from-widget.js';
 export { widgetComposer } from '../../modules/analytics-composer';

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

@@ -40,6 +40,17 @@ export interface FormulaParenCall {
  * @internal Exported for unit tests
  */
 export declare function extractParenFunctionCalls(formula: string): FormulaParenCall[];
+/**
+ * Extracts the raw argument strings from each call to the named function in a formula.
+ * Skips calls inside quoted strings; unparseable calls (unbalanced parentheses) are omitted.
+ *
+ * @param formula - The formula string to scan for function calls
+ * @param funcName - The function name to match (case-insensitive)
+ * @returns An array of argument lists, one inner array per matched call, or an empty array when no calls are found
+ *
+ * @internal
+ */
+export declare function extractFunctionArgs(formula: string, funcName: string): string[][];
 /**
  * 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/shared/expression/datetime-filter-processors.d.ts

@@ -0,0 +1,6 @@
+import { FunctionContext, ProcessedArg } from '../../types.js';
+export declare function processDatetimeMembersFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeRangeFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeFromFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeToFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeRelativeFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/measure-processors.d.ts

@@ -0,0 +1,16 @@
+import { FunctionContext, ProcessedArg } from '../../types.js';
+/**
+ * Validates that the first argument is a numeric attribute.
+ * Used by: sum, average, avg, stdev, variance, median
+ *
+ * SUM, AVG, STDEV, VAR, MEDIAN require numeric columns; applying them to text or datetime
+ * attributes causes the BE translation engine to throw (AGGREGATION_OVER_NON_NUMERIC_FIELD guard).
+ *
+ * @param processedArgs - Processed arguments where args[0] is the attribute
+ * @param context - Processing context with error prefix and other metadata
+ * @returns Same `processedArgs` reference when validation succeeds
+ * @throws Error with descriptive message if validation fails
+ *
+ * @internal
+ */
+export declare function processNumericMeasure(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/process-measured-value.d.ts

@@ -0,0 +1,14 @@
+import { FunctionContext, ProcessedArg } from '../../types.js';
+/**
+ * Validates measuredValue filters: only plain Filter instances are allowed.
+ * FilterRelations (logic.or / logic.and) are rejected because the JAQL engine
+ * does not support them inside measured-value formulas.
+ *
+ * @param processedArgs - [measure, filters, name?, format?]
+ * @param context - Processing context with error prefix
+ * @returns Same `processedArgs` when validation succeeds
+ * @throws Error when any filter entry is a FilterRelations object
+ *
+ * @internal
+ */
+export declare function processMeasuredValue(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];

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

@@ -47,6 +47,10 @@ export declare function parseDimensionalName(dimensionalName: string, schemaInde
 export interface CreateAttributeFromNameOptions {
     /** When the dimensional name has no date level, use this level for datetime columns (e.g. from xdiff function). */
     inferredDateLevel?: string;
+    /** When true, datetime/date/time columns must include an explicit level suffix (or inferredDateLevel). */
+    requireExplicitDateLevel?: boolean;
 }
+/** Options for NLQ paths where a date level must be present in the dimensional name. */
+export declare const REQUIRE_EXPLICIT_DATE_LEVEL: CreateAttributeFromNameOptions;
 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/validation/datetime-member-validation.d.ts

@@ -0,0 +1,2 @@
+export declare function validateDatetimeMemberStrings(members: unknown[], granularity: string, pathPrefix: string): void;
+export declare function validateNoDuplicateMembers(members: string[], pathPrefix: string): void;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/datetime-range-validation.d.ts

@@ -0,0 +1,2 @@
+export declare function validateDatetimeRange(granularity: string, from: Date | string | undefined, to: Date | string | undefined, pathPrefix: string): void;
+export declare function normalizeDatetimeRangeBound(bound: Date | string, granularity: string): string;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/datetime-relative-validation.d.ts

@@ -0,0 +1 @@
+export declare function validateDatetimeRelativeFilter(granularity: string, offset: number, count: number, anchor: Date | string | undefined, pathPrefix: string): void;

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

@@ -0,0 +1,40 @@
+import { Attribute } from '@sisense/sdk-data';
+/** Period granularities that accept calendar-date bounds in JAQL (matches sdk-data DateLevels.dateOnly). */
+export declare const PERIOD_DATE_LEVELS: readonly string[];
+/** Relative date filters supported on the Sisense backend for period levels. */
+export declare const RELATIVE_DATE_LEVELS: readonly string[];
+/** Sisense default first day of week (system.firstday), used when normalizing week members. */
+export declare const DEFAULT_WEEK_STARTS_ON = 1;
+/**
+ * Checks if a string is a valid ISO date or datetime (YYYY-MM-DD…).
+ */
+export declare function isValidIsoDateString(value: string): boolean;
+/**
+ * Checks if a string is a compact YYYYWW week key (e.g. `202500`), not a valid ISO datetime.
+ */
+export declare function isCompactYearWeekKey(value: string): boolean;
+/**
+ * Checks if a string is exactly a four-digit calendar year (e.g. `2024`).
+ */
+export declare function isFourDigitYear(value: string): boolean;
+/**
+ * Checks if a datetime string ends with `T23:59:59`, which is an invalid exclusive upper bound.
+ */
+export declare function hasExclusiveEndOfDayAntiPattern(value: string): boolean;
+/**
+ * Normalizes a date range bound to its string form for validation and comparison.
+ */
+export declare function toDateBoundString(bound: Date | string): string;
+/**
+ * Strips the time component from an ISO datetime, returning the calendar date portion only.
+ */
+export declare function stripClockFromIsoDateTime(bound: string): string;
+/**
+ * Returns a human-readable hint describing valid member formats for the given date granularity.
+ */
+export declare function formatExpectedMemberHint(granularity: string): string;
+/**
+ * Returns the user-facing table.column name for a date level attribute (e.g. `Commerce.Date`),
+ * derived from composeCode rather than the internal JAQL expression.
+ */
+export declare function getDateColumnDisplayName(attribute: Attribute): string;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/flatten-filters.d.ts

@@ -0,0 +1,5 @@
+import { Filter, FilterRelations } from '@sisense/sdk-data';
+/**
+ * Collects all leaf {@link Filter} instances from a filter list or relations tree.
+ */
+export declare function flattenFilters(filters: Filter[] | FilterRelations | null | undefined): Filter[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/normalize-member-for-granularity.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Normalizes a datetime filter member to the start of its calendar period,
+ * matching Sisense backend member encoding.
+ */
+export declare function normalizeMemberForGranularity(member: string, granularity: string): string;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/query-datetime-validation.d.ts

@@ -0,0 +1,7 @@
+import { Attribute, Filter } from '@sisense/sdk-data';
+import { NlqTranslationError } from '../../../types.js';
+export declare function validateQueryDatetimeConsistency(input: {
+    dimensions: Attribute[];
+    filters: Filter[] | import('@sisense/sdk-data').FilterRelations | null | undefined;
+    highlights: Filter[] | null | undefined;
+}): NlqTranslationError[];

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

@@ -114,7 +114,7 @@ export type UiFramework = 'react' | 'vue' | 'angular';
  *
  * @internal
  */
-export type CodeTemplateKey = 'baseChartTmpl' | 'chartTmpl' | 'chartWidgetTmpl' | 'chartWidgetPropsTmpl' | 'widgetByIdTmpl' | 'executeQueryByWidgetIdTmpl' | 'executeQueryTmpl' | 'executePivotQueryTmpl' | 'pivotTableWidgetTmpl' | 'pivotTableWidgetPropsTmpl' | 'dashboardByIdTmpl' | 'dashboardTmpl';
+export type CodeTemplateKey = 'baseChartTmpl' | 'chartTmpl' | 'chartWidgetTmpl' | 'chartWidgetPropsTmpl' | 'widgetByIdTmpl' | 'executeQueryByWidgetIdTmpl' | 'executeQueryTmpl' | 'executePivotQueryTmpl' | 'pivotTableWidgetTmpl' | 'pivotTableWidgetPropsTmpl' | 'customWidgetTmpl' | 'dashboardByIdTmpl' | 'dashboardTmpl';
 /**
  * Code Templates
  *
@@ -235,6 +235,21 @@ export type ChartWidgetCodeProps = Stringify<ChartWidgetProps> & ExtraWidgetCode
  * @internal
  */
 export type PivotTableWidgetCodeProps = Stringify<PivotTableWidgetProps> & ExtraWidgetCodeProps;
+/**
+ * Custom Widget Code Props
+ *
+ * @internal
+ */
+export type CustomWidgetCodeProps = {
+    customWidgetTypeString: string;
+    titleString: string;
+    dataSourceString: string;
+    dataOptionsString: string;
+    filtersString: string;
+    extraImportsString: string;
+    styleOptionsString: string;
+    customOptionsString: string;
+};
 /**
  * Template Key by Widget Type
  *

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

@@ -1,5 +1,5 @@
 import { WidgetProps } from '../../../domains/widgets/components/widget/types';
 import { ByIdWidgetCodeParams, ClientSideWidgetCodeParams, TemplateKeyMapByWidgetType, UiFramework } from '../types.js';
-export declare const toWidgetCodeById: ({ dashboardOid, widgetOid, uiFramework, chartType, includeChart, }: ByIdWidgetCodeParams) => string;
+export declare const toWidgetCodeById: ({ dashboardOid, widgetOid, uiFramework, includeChart, }: ByIdWidgetCodeParams) => 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/props.d.ts

@@ -4,14 +4,14 @@ import { Hierarchy } from './domains/drilldown/hierarchy-model';
 import { ExecuteQueryParams, QueryByWidgetIdState } from './domains/query-execution';
 import { ExecuteQueryResult } from './domains/query-execution/types';
 import { type CustomDataCellFormatter, type CustomHeaderCellFormatter } from './domains/visualizations/components/pivot-table/formatters/types';
-import { AreamapChartDataOptions, BoxplotChartCustomDataOptions, BoxplotChartDataOptions, CalendarHeatmapChartDataOptions, IndicatorChartDataOptions, PivotTableDataOptions, RangeChartDataOptions, RegularChartDataOptions, ScatterChartDataOptions, ScattermapChartDataOptions, TableDataOptions, TabularChartDataOptions } from './domains/visualizations/core/chart-data-options/types';
+import { AreamapChartDataOptions, BoxplotChartCustomDataOptions, BoxplotChartDataOptions, CalendarHeatmapChartDataOptions, IndicatorChartDataOptions, PivotTableDataOptions, RangeChartDataOptions, RegularChartDataOptions, SankeyChartDataOptions, ScatterChartDataOptions, ScattermapChartDataOptions, TableDataOptions, TabularChartDataOptions } from './domains/visualizations/core/chart-data-options/types';
 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 { type AppConfig } from './infra/app/types';
 import type { Module } from './infra/modules';
 import type { Plugin } from './infra/plugins/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';
+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, SankeyStyleOptions, 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';
 export type { MenuItemSection, HighchartsOptions };
@@ -173,7 +173,7 @@ export interface SisenseContextProviderProps {
      *
      * @category Sisense App
      *
-     * @alpha
+     * @beta
      */
     modules?: Module[];
 }
@@ -202,6 +202,12 @@ export interface ExecuteQueryProps {
     offset?: number;
     /** {@inheritDoc ExecuteQueryParams.ungroup} */
     ungroup?: boolean;
+    /**
+     * {@inheritDoc ExecuteQueryParams.includeRowCount}
+     *
+     * @beta
+     */
+    includeRowCount?: boolean;
     /** Function as child component that is called to render the query results */
     children?: (queryResult: ExecuteQueryResult) => ReactNode;
     /** Callback function that is evaluated when query results are ready */
@@ -847,6 +853,37 @@ export interface FunnelChartProps extends BaseChartProps, HighchartsBasedChartEv
      */
     styleOptions?: FunnelStyleOptions;
 }
+/**
+ * Props of the {@link SankeyChart} component.
+ *
+ * @beta
+ *
+ * @example
+ * ```tsx
+ * <SankeyChart
+ *   dataSet={DM.DataSource}
+ *   dataOptions={{
+ *     category: [DM.Commerce.Gender, DM.Category.Category],
+ *     value: measureFactory.sum(DM.Commerce.Revenue),
+ *   }}
+ *   styleOptions={{ orientation: 'horizontal' }}
+ * />
+ * ```
+ */
+export interface SankeyChartProps extends BaseChartProps, HighchartsBasedChartEventProps, RegularChartEventProps {
+    /**
+     * Configurations for how to interpret and present the data passed to the chart.
+     *
+     * @category Chart
+     */
+    dataOptions: SankeyChartDataOptions;
+    /**
+     * Configurations for how to style and present a chart's data.
+     *
+     * @category Chart
+     */
+    styleOptions?: SankeyStyleOptions;
+}
 /**
  * Props of the {@link LineChart} component.
  */
@@ -1180,6 +1217,12 @@ export interface ExecuteQueryByWidgetIdProps {
     count?: number;
     /** {@inheritDoc ExecuteQueryParams.offset} */
     offset?: number;
+    /**
+     * {@inheritDoc ExecuteQueryByWidgetIdParams.includeRowCount}
+     *
+     * @beta
+     */
+    includeRowCount?: boolean;
     /** {@inheritDoc ExecuteQueryByWidgetIdParams.filtersMergeStrategy} */
     filtersMergeStrategy?: FiltersMergeStrategy;
     /** {@inheritDoc ExecuteQueryByWidgetIdParams.includeDashboardFilters} */

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

@@ -9,7 +9,5 @@ export type { ThemeConfig } from '../types';
 export { type TranslationDictionary, PACKAGE_NAMESPACE as translationNamespace, } from '../infra/translation/resources';
 export { CascadingFilterTile, type CascadingFilterTileProps, } from '../domains/filters/components/cascading-filter-tile';
 export { CustomFilterTile, type CustomFilterTileProps, } from '../domains/filters/components/custom-filter-tile';
-export { useSyncedState, type UseSyncedStateOptions } from '../shared/hooks/use-synced-state';
 export { isIndicatorRenderOptions, isHighchartsOptions, type HighchartsOptions, type CalendarHeatmapChartEventProps, } from '../props';
-export type { Module, ModuleRequirement } from '../infra/modules/types.js';
 export { useModuleApiRegistry } from '../infra/modules/modules-context.js';

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

@@ -5,3 +5,11 @@
  * Not recommended for production use.
  */
 export { useQueryCache } from '../domains/query-execution/hooks/use-query-cache/use-query-cache';
+export type { Module, ModuleRequirement } from '../infra/modules/types.js';
+export type { Plugin, BasePluginInfo } from '../infra/plugins/types.js';
+export type { WidgetPlugin, CustomVisualization, CustomVisualizationProps, CustomVisualizationStyleOptions, CustomVisualizationEventProps, CustomVisualizationDataPoint, CustomVisualizationDataPointEventHandler, CustomVisualizationDataPointContextMenuHandler, CustomVisualizationDataPointsEventHandler, VisualizationStateUpdate, DesignPanelProps, DesignPanel, } from '../infra/plugins/widget-plugins/types.js';
+export { useSyncedState, type UseSyncedStateOptions } from '../shared/hooks/use-synced-state';
+export { SankeyChart } from '../domains/visualizations/components/sankey-chart';
+export type { SankeyChartProps } from '../props';
+export type { SankeyChartDataOptions } from '../domains/visualizations/core/chart-data-options/types';
+export type { SankeyStyleOptions, SankeyChartType } from '../types';

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

@@ -8,7 +8,7 @@ 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 { executeCsvQuery, executePivotQuery, executeQuery, executeQueryWithRowCount, } from '../domains/query-execution/core/execute-query';
 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';

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

@@ -24,6 +24,8 @@ export { AreamapChart } from '../domains/visualizations/components/areamap-chart
 export { AreaRangeChart } from '../domains/visualizations/components/area-range-chart';
 export { CalendarHeatmapChart } from '../domains/visualizations/components/calendar-heatmap-chart';
 export { DashboardById, Dashboard, useComposedDashboard, type ComposableDashboardProps, type UseComposedDashboardOptions, type ComposedDashboardResult, type DashboardByIdProps, type DashboardProps, type DashboardLayoutOptions, type DashboardStyleOptions, type DashboardConfig, type DashboardByIdConfig, type WidgetsPanelConfig, type EditModeConfig, type DashboardFiltersPanelConfig, type TabbersConfig, type TabberConfig, type TabberTabConfig, type DashboardChangeEvent, type DashboardFiltersUpdatedEvent, type DashboardFiltersPanelCollapseChangedEvent, type DashboardWidgetsPanelLayoutUpdatedEvent, type DashboardWidgetsPanelIsEditingChangedEvent, type DashboardWidgetsDeletedEvent, } from '../domains/dashboarding';
+export { DashboardHeaderTargets, type DashboardHeaderTarget, } from '../domains/dashboarding/components/dashboard-header/dashboard-header-targets';
+export type { DashboardHeaderConfig, DashboardHeaderItem, DashboardHeaderItemComponent, DashboardHeaderItemComponentProps, DashboardHeaderItemPosition, DashboardHeaderItemSize, DashboardHeaderItemsTransform, DashboardResolvedHeaderItem, } from '../domains/dashboarding/components/dashboard-header/dashboard-header-config';
 /**
  * Jump To Dashboard (JTD) configuration types
  *
@@ -43,9 +45,10 @@ export { DrilldownWidget } from '../domains/drilldown/components/drilldown-widge
 export { ChartWidget, type ChartWidgetProps } from '../domains/widgets/components/chart-widget';
 export { PivotTableWidget, type PivotTableWidgetProps, } from '../domains/widgets/components/pivot-table-widget';
 export { type TextWidgetProps } from '../domains/widgets/components/text-widget';
-export { Widget, type WidgetProps, type WidgetType, type WithCommonWidgetProps, } from '../domains/widgets/components/widget';
+export { Widget, type WidgetProps, type WidgetConfig, type WidgetType, type WithCommonWidgetProps, } from '../domains/widgets/components/widget';
 export { type CustomWidgetProps } from '../domains/widgets/components/custom-widget';
 export { DrilldownBreadcrumbs } from '../domains/drilldown/components/drilldown-breadcrumbs';
+export type { WidgetNarrativeConfig, WidgetNarrativeDisplayLocation, } from '../domains/narrative/core/widget-narrative-config';
 export type { CustomWidgetComponentProps, CustomWidgetComponent, } from '../infra/contexts/custom-widgets-provider/types';
 export { useCustomWidgets, type UseCustomWidgetsResult, } from '../infra/contexts/custom-widgets-provider';
 export { useGetDashboardModel, useGetDashboardModels, 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 WidgetsOptions, type SpecificWidgetOptions, type CommonFiltersOptions, type CommonFiltersApplyMode, type FiltersIgnoringRules, } from '../domains/dashboarding/dashboard-model';

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

@@ -19,17 +19,18 @@ export { QuotaNotification } from '../shared/components/quota-notification/quota
 export type { QuotaNotificationProps } from '../shared/components/quota-notification/quota-notification.js';
 export { useQuotaNotification } from '../shared/hooks/use-quota-notification.js';
 export type { QuotaNotificationOptions, QuotaApiResponse, QuotaState, } from '../shared/hooks/use-quota-notification.js';
-export type { Plugin } from '../infra/plugins/types.js';
-export type { WidgetPlugin, CustomVisualization, CustomVisualizationProps, VisualizationStateUpdate, CustomVisualizationStyleOptions, CustomVisualizationEventProps, CustomVisualizationDataPoint, CustomVisualizationDataPointEventHandler, CustomVisualizationDataPointContextMenuHandler, CustomVisualizationDataPointsEventHandler, DesignPanelProps, DesignPanel, } from '../infra/plugins/widget-plugins/types.js';
 export { LoadingIndicator } from '../shared/components/loading-indicator.js';
 export { DataSchemaBrowser } from '../domains/data-browser/data-schema-browser/data-schema-browser.js';
 export { type NarrativeQueryParams } from '../domains/narrative/core/build-narrative-request.js';
-export { useGetWidgetNarrative, type UseGetWidgetNarrativeOptions, type UseGetWidgetNarrativeParams, type UseGetWidgetNarrativeResult, } from '../domains/narrative/hooks/use-get-widget-narrative.js';
+export { useGetWidgetNarrative, type UseGetWidgetNarrativeParams, type UseGetWidgetNarrativeResult, } from '../domains/narrative/hooks/use-get-widget-narrative.js';
 export { WidgetNarrative, type WidgetNarrativeProps, } from '../domains/narrative/components/widget-narrative.js';
 export type { NlqChartWidgetStyleOptions } from '../types';
 export type { RenderToolbarHandler, RenderTitleHandler } from '../types';
 export { isChartWidgetProps } from '../domains/widgets/components/widget-by-id/utils.js';
 export { isPivotTableWidgetProps } from '../domains/widgets/components/widget-by-id/utils.js';
+export { DashboardModule, type DashboardModuleApi, } from '../domains/dashboarding/dashboard-module/dashboard-module.js';
+export type { DashboardCustomization, DashboardStateApi, } from '../domains/dashboarding/dashboard-module/types.js';
+export { withHeaderItem } from '../domains/dashboarding/dashboard-helpers.js';
 export { useDashboardPersistence } from '../domains/dashboarding/dashboard-model';
 export { createDashboardPersistenceManager } from '../domains/dashboarding/persistence/persistence-manager.js';
 export type { DashboardPersistenceManager } from '../domains/dashboarding/persistence/types.js';

package/dist/packages/sdk-ui/src/shared/components/alert/alert.d.ts

@@ -27,13 +27,6 @@ export interface AlertProps {
      * Callback when alert is dismissed
      */
     onDismiss?: () => void;
-    /**
-     * When true and dismissible, clicking anywhere on the alert (not just the close button)
-     * triggers onDismiss. Useful for banner-style alerts.
-     *
-     * @default false
-     */
-    dismissOnClick?: boolean;
     /**
      * Additional CSS class name
      */
@@ -46,46 +39,4 @@ export interface AlertProps {
  * @returns Alert component
  * @internal
  */
-export declare const Alert: ({ variant, title, description, icon, dismissible, onDismiss, dismissOnClick, className, }: AlertProps) => import("react/jsx-runtime").JSX.Element;
-/**
- * Props for AlertTitle component
- */
-export interface AlertTitleProps {
-    /**
-     * Content of the title
-     */
-    children: ReactNode;
-    /**
-     * Additional CSS class name
-     */
-    className?: string;
-}
-/**
- * Alert title subcomponent
- *
- * @param props - AlertTitle props
- * @returns AlertTitle component
- * @internal
- */
-export declare const AlertTitle: ({ children, className }: AlertTitleProps) => import("react/jsx-runtime").JSX.Element;
-/**
- * Props for AlertDescription component
- */
-export interface AlertDescriptionProps {
-    /**
-     * Content of the description
-     */
-    children: ReactNode;
-    /**
-     * Additional CSS class name
-     */
-    className?: string;
-}
-/**
- * Alert description subcomponent
- *
- * @param props - AlertDescription props
- * @returns AlertDescription component
- * @internal
- */
-export declare const AlertDescription: ({ children, className }: AlertDescriptionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Alert: ({ variant, title, description, icon, dismissible, onDismiss, className, }: AlertProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,2 +1,2 @@
-export { Alert, AlertTitle, AlertDescription } from './alert';
-export type { AlertProps, AlertTitleProps, AlertDescriptionProps } from './alert';
+export { Alert } from './alert';
+export type { AlertProps } from './alert';

package/dist/packages/sdk-ui/src/shared/components/no-results-overlay/images/index.d.ts

@@ -1,2 +1,2 @@
 import { ChartType, TableType } from '../../../../types';
-export declare function getNoResultOverlayImage(type: ChartType | TableType): any;
+export declare function getNoResultOverlayImage(type: ChartType | TableType): string;

package/dist/packages/sdk-ui/src/shared/components/quota-notification/quota-notification.d.ts

@@ -9,24 +9,17 @@ export interface QuotaNotificationProps extends QuotaNotificationOptions {
      * Additional CSS class name
      */
     className?: string;
-    /**
-     * Whether the warning banner has been dismissed (controlled from parent)
-     */
-    warningDismissed?: boolean;
-    /**
-     * Callback when warning is dismissed (for controlled usage)
-     */
-    onDismissWarning?: () => void;
 }
 /**
  * Component that displays credit balance warnings/errors
  *
  * Shows an error banner when credit is exceeded (not dismissible).
- * Shows a warning banner when credit usage >= warningThreshold (dismissible).
+ * Shows a warning banner when credit usage >= warningThreshold (dismissible via close button,
+ * resets each time the assistant loads).
  * Automatically updates via polling every 60 seconds.
  *
  * @param props - QuotaNotification props
  * @returns QuotaNotification component or null
  * @sisenseInternal
  */
-export declare function QuotaNotification({ className, warningDismissed: controlledWarningDismissed, onDismissWarning, enabled, warningThreshold, exceededThreshold, }?: QuotaNotificationProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function QuotaNotification({ className, enabled, warningThreshold, exceededThreshold, }?: QuotaNotificationProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/packages/sdk-ui/src/shared/components/radio.d.ts

@@ -3,6 +3,7 @@ type ButtonProps = {
     value?: string;
     onChange?: (checked: boolean) => void;
     disabled?: boolean;
+    'aria-label'?: string;
 };
 /** @internal */
 export declare const Radio: (props: ButtonProps) => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/shared/hooks/use-synced-state.d.ts

@@ -2,7 +2,8 @@ import { Dispatch, SetStateAction } from 'react';
 /**
  * Options for {@link useSyncedState}.
  *
- * @alpha
+ * @group Helpers
+ * @beta
  */
 export type UseSyncedStateOptions<T> = {
     /**
@@ -22,11 +23,8 @@ export type UseSyncedStateOptions<T> = {
  *
  * @param syncValue - The external value to synchronize with. When this value changes (as
  *   determined by `syncCompareFn`), the local state is updated to match it.
- * @param options - Optional configuration object.
- * @param options.onLocalStateChange - Callback invoked whenever the local state is updated via
- *   the returned setter (not triggered by external `syncValue` synchronization).
- * @param options.syncCompareFn - Custom equality function used to detect changes in `syncValue`.
- *   Defaults to a deep equality check via `isEqual` from lodash-es. See {@link UseSyncedStateOptions}.
+ * @param options - Optional configuration object. See {@link UseSyncedStateOptions} for the
+ *   `onLocalStateChange` and `syncCompareFn` fields.
  * @returns A tuple of `[localState, setState]` — the current local state and a setter that
  *   both updates state and fires `onLocalStateChange`.
  * @example
@@ -35,6 +33,7 @@ export type UseSyncedStateOptions<T> = {
  *   onLocalStateChange: (s) => console.log('local update', s),
  * });
  * ```
- * @alpha
+ * @group Helpers
+ * @beta
  */
 export declare function useSyncedState<T>(syncValue: T, { onLocalStateChange, syncCompareFn }?: UseSyncedStateOptions<T>): [T, Dispatch<SetStateAction<T>>];

package/dist/packages/sdk-ui/src/shared/icons/warning-icon.d.ts

@@ -1,6 +1,5 @@
-import { SVGProps } from 'react';
 /**
  * Quota warning icon - circle with exclamation mark, used for quota warning banner
- * From Figma design; fill #FFCB05
+ * From Figma design; fill #F2B900
  */
-export declare const WarningIcon: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export declare const WarningIcon: () => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/shared/icons/x-circle-icon.d.ts

@@ -1,6 +1,5 @@
-import { SVGProps } from 'react';
 /**
  * X circle icon - circle with X inside, used for quota error banner
- * From Figma design; uses currentColor for fill
+ * From Figma design; fill #D12D04
  */
-export declare const XCircleIcon: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export declare const XCircleIcon: () => import("react/jsx-runtime").JSX.Element;