@sisense/sdk-ui 2.29.0 → 2.30.0

package/dist/packages/sdk-ui/src/domains/narrative/hooks/use-get-widget-narrative.d.ts

@@ -1,42 +1,33 @@
 import type { WidgetProps } from '../../../domains/widgets/components/widget/types';
-import type { WidgetNarrativeOptions } from '../core/widget-narrative-options.js';
+import type { HookEnableParam } from '../../../shared/hooks/types';
 import { type WidgetNarrativeQueryState } from './use-widget-narrative-state.js';
 /**
- * Options for {@link useGetWidgetNarrative}.
+ * Parameters for {@link useGetWidgetNarrative}.
  *
  * @remarks
- * Narration endpoint selection defaults from `app.settings.narrative.canGenerateNarrativeViaAI`
- * on {@link useSisenseContext} when `canGenerateNarrativeViaAI` is omitted. Optional overrides
- * match the imperative `getNlgInsightsFromWidget` helper for per-call behavior.
- * @sisenseInternal
- */
-export type UseGetWidgetNarrativeOptions = WidgetNarrativeOptions & {
-    /**
-     * When `false`, skips the narrative request.
-     *
-     * @default true
-     */
-    enabled?: boolean;
-};
-/**
+ * Narrative endpoint selection uses `app.settings.narrative.canGenerateNarrativeViaAI` from
+ * {@link useSisenseContext}. {@link WidgetNarrativeOptions} come from
+ * `widgetProps.aiOptions.narrative` (see {@link getCompleteWidgetNarrativeOptions}).
+ *
+ * The `enabled` flag follows {@link HookEnableParam} (defaults to `true` when omitted).
  * @sisenseInternal
  */
 export type UseGetWidgetNarrativeParams = {
     /** Widget configuration whose query drives the narrative (chart or pivot). */
     widgetProps: WidgetProps;
-} & UseGetWidgetNarrativeOptions;
+} & HookEnableParam;
 /**
  * @sisenseInternal
  */
 export type UseGetWidgetNarrativeResult = WidgetNarrativeQueryState & {
     /**
      * `true` when `widgetProps` is a chart or pivot widget and narrative params could be built
-     * (including resolving `dataSource` via `defaultDataSource`).
+     * (including resolving `dataSource` via context `defaultDataSource` when omitted on props).
      */
     supported: boolean;
     /**
-     * Mirrors {@link UseGetWidgetNarrativeOptions.enabled}. When `false`, narrative is opted out and
-     * `data` is not populated from cache.
+     * Effective value after applying {@link HookEnableParam} defaults (always `true` or `false`).
+     * When `false`, narrative is opted out and `data` is not populated from cache.
      */
     enabled: boolean;
 };
@@ -53,8 +44,6 @@ export type UseGetWidgetNarrativeResult = WidgetNarrativeQueryState & {
  * ```tsx
  * const { data, isLoading, supported } = useGetWidgetNarrative({
  *   widgetProps,
- *   defaultDataSource: DM.DataSource,
- *   verbosity: 'Low',
  * });
  * ```
  * @sisenseInternal

package/dist/packages/sdk-ui/src/domains/narrative/hooks/use-line-height.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+/**
+ * Measures the line height of the element referenced by `ref` in pixels.
+ * Re-measures on resize and after fonts load. Returns `null` until measured.
+ *
+ * @param ref - Ref to the element whose line height should be measured.
+ * @returns The line height in pixels, or `null` if not yet measured.
+ * @internal
+ */
+export declare function useLineHeight<T extends HTMLElement>(ref: React.RefObject<T | null>): number | null;

package/dist/packages/sdk-ui/src/domains/narrative/hooks/use-widget-narrative-state.d.ts

@@ -1,6 +1,6 @@
 import { WidgetProps } from '../../../domains/widgets/components/widget/types';
 import type { NarrativeRequest } from '../../../infra/api/narrative/narrative-api-types.js';
-import type { WidgetNarrativeOptions } from '../core/widget-narrative-options.js';
+import type { HookEnableParam } from '../../../shared/hooks/types';
 /**
  * Hook state aligned with legacy {@link UseGetNlgInsightsState}; used by {@link useGetWidgetNarrative}.
  *
@@ -16,24 +16,23 @@ export type WidgetNarrativeQueryState = {
 };
 export type UseWidgetNarrativeStateParams = {
     widgetProps: WidgetProps;
-    enabled?: boolean;
-} & WidgetNarrativeOptions;
+} & HookEnableParam;
 export type UseWidgetNarrativeStateResult = WidgetNarrativeQueryState & {
     supported: boolean;
     /**
-     * Mirrors the `enabled` param. When `false`, the narrative is opted out: `data` is cleared (no
-     * cached fallback), `narrativeRequest` is undefined, and loading/error flags reflect a disabled
-     * query rather than "no insights."
+     * Effective value after applying {@link HookEnableParam} defaults (always `true` or `false`).
+     * When `false`, narrative is opted out: `data` is cleared (no cached fallback), `narrativeRequest`
+     * is undefined, and loading/error flags reflect a disabled query rather than "no insights."
      */
     enabled: boolean;
     /** Present when `supported` and `enabled`; used by {@link WidgetNarrative} for feedback payload only. */
     narrativeRequest: NarrativeRequest | undefined;
 };
 /**
- * Resolves chart or pivot widget props to a narration request and runs `getNarrative` via TanStack Query.
- * Depends on {@link useSisenseContext} (`httpClient`, narration settings) and a `QueryClientProvider`.
+ * Resolves chart or pivot widget props to a narrative request and runs `getNarrative` via TanStack Query.
+ * Depends on {@link useSisenseContext} (`httpClient`, narrative settings) and a `QueryClientProvider`.
  * Not exported from `@sisenseInternal` public API.
  *
  * @internal
  */
-export declare function useWidgetNarrativeState({ widgetProps, defaultDataSource, verbosity, enabled, ignoreTrendAndForecast, canGenerateNarrativeViaAI: optionsCanGenerateNarrativeViaAI, }: UseWidgetNarrativeStateParams): UseWidgetNarrativeStateResult;
+export declare function useWidgetNarrativeState({ widgetProps, enabled, }: UseWidgetNarrativeStateParams): UseWidgetNarrativeStateResult;

package/dist/packages/sdk-ui/src/domains/query-execution/core/execute-query.d.ts

@@ -1,6 +1,6 @@
 import { Attribute, DataSource, Measure, PivotAttribute, PivotMeasure, PivotQueryResultData, QueryResultData } from '@sisense/sdk-data';
 import type { PivotQueryDescription as InternalPivotQueryDescription, QueryDescription as InternalQueryDescription, QueryExecutionConfig } from '@sisense/sdk-query-client';
-import { CreateCacheKeyFn } from '../../../shared/utils/create-cache';
+import { CacheKey, CreateCacheKeyFn } from '../../../shared/utils/create-cache';
 import { type ClientApplication } from '../../../infra/app/types.js';
 /**
  * All the properties that fully describe a query you want to send.
@@ -30,9 +30,42 @@ export declare const prepareQueryParams: (queryDescription: QueryDescription, de
 /** @internal */
 export declare function executeQuery(queryDescription: QueryDescription, app: ClientApplication, executionConfig?: QueryExecutionConfig): Promise<QueryResultData>;
 /** @internal */
+export declare function executeRowCountQuery(queryDescription: QueryDescription, app: ClientApplication, executionConfig?: QueryExecutionConfig): Promise<number>;
+/** Result of a data query executed together with its total row count. */
+export type QueryResultWithRowCount = {
+    data: QueryResultData;
+    /**
+     * Total row count of the query, ignoring `count`/`offset` paging.
+     * Undefined when the total could not be retrieved.
+     */
+    rowCount?: number;
+};
+/**
+ * Executes a data query together with a row count query and returns both the
+ * result data and the total row count.
+ *
+ * A row count failure does not fail the data query: `rowCount` is left
+ * undefined when the total cannot be retrieved (e.g. a Sisense instance
+ * without the row count API).
+ *
+ * @internal
+ */
+export declare function executeQueryWithRowCount(queryDescription: QueryDescription, app: ClientApplication, executionConfig?: QueryExecutionConfig, baseExecuteQuery?: typeof executeQuery): Promise<QueryResultWithRowCount>;
+/** @internal */
 export declare const executeCsvQuery: (queryDescription: QueryDescription, app: ClientApplication, executionConfig?: QueryExecutionConfig) => Promise<Blob>;
 /** @internal */
 export declare const executePivotQuery: (queryDescription: PivotQueryDescription, app: ClientApplication, executionConfig?: QueryExecutionConfig) => Promise<PivotQueryResultData>;
 export declare const createExecuteQueryCacheKey: CreateCacheKeyFn<typeof executeQuery>;
 export declare const executeQueryWithCache: typeof executeQuery;
 export declare const clearExecuteQueryCache: (specificKey?: string | undefined) => void;
+/**
+ * Creates a cache key for a row count query.
+ *
+ * The key is page-independent: `count` and `offset` are excluded so the total
+ * row count is reused across pages of the same query.
+ *
+ * @internal
+ */
+export declare const createRowCountQueryCacheKey: CreateCacheKeyFn<typeof executeRowCountQuery>;
+/** @internal */
+export declare const clearRowCountQueryCache: (specificKey?: CacheKey) => void;

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-execute-excel-query/excel-export/build-jaql-excel-export.d.ts

@@ -1,4 +1,4 @@
-import { type Attribute, type DataSource, type Measure } from '@sisense/sdk-data';
+import { type Attribute, type DataSource, type Filter, type FilterRelations, type Measure, type MetadataItem } from '@sisense/sdk-data';
 /** `by` field for JAQL export requests. */
 export declare const EXCEL_EXPORT_JAQL_BY = "export";
 /**
@@ -16,6 +16,7 @@ type ExcelExportJaqlWidgetContext = {
 type XlsxExportQueryParams = {
     dimensions?: readonly Attribute[];
     measures?: readonly Measure[];
+    filters?: readonly Filter[] | FilterRelations;
 };
 /**
  * Resolves XLSX metadata `panel` for a dimension.
@@ -32,17 +33,24 @@ export declare function resolveExcelDimensionMetadataPanel(dimension: Attribute,
  */
 export declare function createPanelsMetadataForXlsx(dimensions: XlsxExportQueryParams['dimensions'], measures: XlsxExportQueryParams['measures'], mergeRows: boolean): {
     jaql: {
-        column: any;
-        title: any;
-        dim: any;
+        column: string | undefined;
+        title: string | undefined;
+        dim: string | undefined;
         merged: boolean;
     };
     field: {
         id: string;
         index: number;
     };
-    format: Record<string, any>;
+    format: Record<string, unknown>;
     panel: "measures" | ExcelExportDimensionPanel;
 }[];
+/**
+ * Returns `scope`-panel metadata for filters.
+ *
+ * @param filters - Scope filters (plain list or filter relations)
+ * @returns Filter metadata for the export JAQL
+ */
+export declare function createFiltersMetadataForXlsx(filters: readonly Filter[] | FilterRelations | undefined): MetadataItem[];
 export declare function buildJaqlForExcelExport(params: XlsxExportQueryParams, context: ExcelExportJaqlWidgetContext): Record<string, unknown>;
 export {};

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-execute-excel-query/excel-export/build-xlsx-export-payload.d.ts

@@ -21,6 +21,11 @@ export type XlsxExportRequestPayload = {
     jaql: Record<string, unknown>;
     mergeRows: boolean;
     language: string;
+    widgetStyles?: {
+        coloringRules?: {
+            alternatingRows?: boolean;
+        };
+    };
 };
 /**
  * Builds the XLSX JAQL export request body shared by chart, pivot, and custom widgets.

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-execute-query-by-widget-id/use-execute-query-by-widget-id.d.ts

@@ -46,8 +46,9 @@ export declare function useExecuteQueryByWidgetIdInternal(params: ExecuteQueryBy
  */
 export declare function useParamsChanged(params: ExecuteQueryByWidgetIdParams): boolean;
 /** @internal */
-export declare function executeQueryByWidgetId({ widgetOid, dashboardOid, filters, highlights, filtersMergeStrategy, count, offset, includeDashboardFilters, app, onBeforeQuery, }: ExecuteQueryByWidgetIdParams & {
+export declare function executeQueryByWidgetId({ widgetOid, dashboardOid, filters, highlights, filtersMergeStrategy, count, offset, includeRowCount, includeDashboardFilters, app, onBeforeQuery, }: ExecuteQueryByWidgetIdParams & {
     app: ClientApplication;
 }): Promise<{
     data: QueryResultData;
+    rowCount?: number;
 } & QueryByWidgetIdQueryParams>;

package/dist/packages/sdk-ui/src/domains/query-execution/types.d.ts

@@ -197,6 +197,23 @@ export interface ExecuteQueryByWidgetIdParams {
     count?: number;
     /** {@inheritDoc ExecuteQueryParams.offset} */
     offset?: number;
+    /**
+     * Boolean flag whether to include the total row count of the query result,
+     * ignoring the `count` and `offset` paging.
+     *
+     * When enabled, the total is returned as `rowCount` in the query state
+     * ({@link QueryByWidgetIdState.rowCount}) and is reused for subsequent pages of the same query.
+     *
+     * Row count feature requires a Sisense instance version of 2026.3.0 or greater.
+     * On older versions, the query still succeeds and `rowCount` stays `undefined`.
+     *
+     * Not supported for pivot table widgets.
+     *
+     * If not specified, the default value is `false`
+     *
+     * @beta
+     */
+    includeRowCount?: boolean;
     /**
      * Strategy for merging the existing widget filters (including highlights) with the filters provided via the `filters` and `highlights` props:
      *
@@ -230,7 +247,17 @@ export type QueryByWidgetIdQueryParams = {
 /**
  * State of a query execution retrieving data of Fusion widget.
  */
-export type QueryByWidgetIdState = QueryState & QueryByWidgetIdQueryParams;
+export type QueryByWidgetIdState = QueryState & QueryByWidgetIdQueryParams & {
+    /**
+     * Total row count of the query result, ignoring the `count` and `offset` paging.
+     *
+     * Populated only when {@link ExecuteQueryByWidgetIdParams.includeRowCount} is enabled and
+     * the Sisense instance supports the row count API; `undefined` otherwise.
+     *
+     * @beta
+     */
+    rowCount?: number;
+};
 /**
  * Base query parameters
  *
@@ -287,6 +314,22 @@ export interface ExecuteQueryParams extends BaseQueryParams {
      * If not specified, the default value is `false`
      */
     ungroup?: boolean;
+    /**
+     * Boolean flag whether to include the total row count of the query result,
+     * ignoring the `count` and `offset` paging.
+     *
+     * When enabled, an additional row count query is sent to the server alongside
+     * the data query, and the total is returned in {@link ExecuteQueryResult.rowCount}.
+     * The retrieved total is reused for subsequent pages of the same query.
+     *
+     * Row count feature requires a Sisense instance version of 2026.3.0 or greater.
+     * On older versions, the query still succeeds and `rowCount` stays `undefined`.
+     *
+     * If not specified, the default value is `false`
+     *
+     * @beta
+     */
+    includeRowCount?: boolean;
     /**
      * Sync or async callback that allows to modify the JAQL payload before it is sent to the server.
      *
@@ -318,6 +361,15 @@ export type ExecuteQueryResult = QueryState & {
      * @internal
      */
     isAllItemsLoaded: boolean;
+    /**
+     * Total row count of the query result, ignoring the `count` and `offset` paging.
+     *
+     * Populated only when {@link ExecuteQueryParams.includeRowCount} is enabled and
+     * the Sisense instance supports the row count API; `undefined` otherwise.
+     *
+     * @beta
+     */
+    rowCount?: number;
 };
 /** Configuration for {@link useExecuteCsvQuery} hook. */
 export type ExecuteCSVQueryConfig = {
@@ -329,13 +381,13 @@ export type ExecuteCSVQueryConfig = {
 /**
  * Parameters for {@link useExecuteCsvQuery} hook.
  */
-export interface ExecuteCsvQueryParams extends ExecuteQueryParams {
+export interface ExecuteCsvQueryParams extends Omit<ExecuteQueryParams, 'includeRowCount'> {
     config?: ExecuteCSVQueryConfig;
 }
 /**
  * Parameters for {@link useExecuteExcelQueryInternal} (JAQL XLSX export).
  */
-export interface ExecuteExcelQueryParams extends ExecuteQueryParams {
+export interface ExecuteExcelQueryParams extends Omit<ExecuteQueryParams, 'includeRowCount'> {
     /** `false` = repeat rows (Angular default); `true` = merge rows. */
     mergeRows: boolean;
     /** Suggested download file name (e.g. from widget title). */

package/dist/packages/sdk-ui/src/domains/shared/header/header-item-size.d.ts

@@ -0,0 +1,30 @@
+import { CSSProperties } from 'react';
+import { HeaderItemFill, HeaderItemSize } from './types.js';
+/**
+ * Default size (in pixels) for a header item dimension that is not specified.
+ *
+ * Each component can override this with its own default (e.g. the dashboard uses 28px) by passing
+ * `defaultSize` to the renderer.
+ */
+export declare const DEFAULT_HEADER_ITEM_SIZE = 24;
+/**
+ * Applies the default-size fallback to a (possibly partial) size.
+ *
+ * The result is what gets passed to a {@link HeaderItemComponent} via `props.size`.
+ */
+export declare const resolveHeaderItemSize: (size?: HeaderItemSize, defaultSize?: number) => Required<HeaderItemSize>;
+/**
+ * Maps a resolved size and the internal {@link HeaderItemFill} to the CSS for an item's wrapper.
+ *
+ * - `fill: 'grow'` → flexible, grows to fill the row (the center spacer).
+ * - `fill: 'truncate'` → natural content width, shrinkable (the title — enables ellipsis).
+ * - `fill: 'content'` → natural content width, never shrinks (built-in action buttons/menu — so a
+ *   long title cannot squeeze and clip their icons).
+ * - no `fill` (external items) → fixed pixel `width` (provided or defaulted).
+ *
+ * `fill` is internal: it is set only on built-in items. External items never carry it, so they are
+ * always laid out at a fixed pixel width.
+ *
+ * `height` is applied as a fixed pixel height (provided or defaulted).
+ */
+export declare const getHeaderItemStyle: (size: Required<HeaderItemSize>, fill?: HeaderItemFill) => CSSProperties;

package/dist/packages/sdk-ui/src/domains/shared/header/header-items-renderer.d.ts

@@ -0,0 +1,19 @@
+import { ResolvedHeaderItem } from './types.js';
+/**
+ * Props for {@link HeaderItemsRenderer}.
+ *
+ * @internal
+ */
+export interface HeaderItemsRendererProps {
+    /** The resolved, ordered header items to render. */
+    items: ResolvedHeaderItem[];
+    /**
+     * Default size (px) applied to items that don't specify one. Lets each component pick its own
+     * default (the dashboard uses 28). Defaults to {@link DEFAULT_HEADER_ITEM_SIZE}.
+     */
+    defaultSize?: number;
+}
+/**
+ * Renders a resolved list of header items as a single horizontal flex row.
+ */
+export declare const HeaderItemsRenderer: ({ items, defaultSize }: HeaderItemsRendererProps) => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/domains/shared/header/header-spacer-item.d.ts

@@ -0,0 +1,9 @@
+import { HeaderItem } from './types.js';
+/**
+ * Creates a flexible, empty "spacer" header item.
+ *
+ * The spacer renders nothing but grows (`fill: 'grow'`) to fill the available width, separating the
+ * leading group of items (e.g. the title) from the trailing group (action buttons). It is also the
+ * anchor that `{ type: 'auto' }` items are placed after.
+ */
+export declare const createHeaderSpacerItem: (id: string) => HeaderItem;

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

@@ -0,0 +1,6 @@
+export type { HeaderConfig, HeaderItem, HeaderItemComponent, HeaderItemComponentProps, HeaderItemFill, HeaderItemPosition, HeaderItemSize, HeaderItemsTransform, ResolvedHeaderItem, } from './types.js';
+export { resolveHeaderItems, type ResolveHeaderItemsOptions } from './resolve-header-items.js';
+export { useResolvedHeaderItems } from './use-resolved-header-items.js';
+export { HeaderItemsRenderer, type HeaderItemsRendererProps } from './header-items-renderer.js';
+export { getHeaderItemStyle, resolveHeaderItemSize, DEFAULT_HEADER_ITEM_SIZE, } from './header-item-size.js';
+export { createHeaderSpacerItem } from './header-spacer-item.js';

package/dist/packages/sdk-ui/src/domains/shared/header/resolve-header-items.d.ts

@@ -0,0 +1,17 @@
+import { HeaderConfig, HeaderItem, ResolvedHeaderItem } from './types.js';
+/**
+ * Options for {@link resolveHeaderItems}.
+ */
+export interface ResolveHeaderItemsOptions {
+    /**
+     * Id of the item that `{ type: 'auto' }` items are placed immediately after (the center spacer).
+     *
+     * If not provided or not present, auto items fall back to the end of the header.
+     */
+    autoAnchorId?: string;
+}
+/**
+ * Resolves the final, ordered list of header items from the built-in items and the user
+ * {@link HeaderConfig}.
+ */
+export declare const resolveHeaderItems: (builtInItems: HeaderItem[], config?: HeaderConfig, options?: ResolveHeaderItemsOptions) => ResolvedHeaderItem[];

package/dist/packages/sdk-ui/src/domains/shared/header/types.d.ts

@@ -0,0 +1,98 @@
+import { ReactNode } from 'react';
+/**
+ * Size configuration for a header item, in pixels.
+ */
+export interface HeaderItemSize {
+    /** Fixed width (px). Falls back to the component's default item size. */
+    width?: number;
+    /** Fixed height (px). Falls back to the component's default item size. */
+    height?: number;
+}
+/**
+ * Props passed to a header item component when it is rendered.
+ */
+export interface HeaderItemComponentProps {
+    /** The size resolved for the item by the header layout, with defaults applied. */
+    size: {
+        /** Fixed width (px). */
+        width: number;
+        /** Fixed height (px). */
+        height: number;
+    };
+}
+/**
+ * A React component that renders the content of a header item.
+ */
+export type HeaderItemComponent = (props: HeaderItemComponentProps) => ReactNode;
+/**
+ * Internal layout behavior for built-in items whose width is not a fixed pixel value:
+ * - `content` — natural content width, never shrinks (built-in action buttons/menu).
+ * - `truncate` — natural content width that may shrink/ellipsize (the title).
+ * - `grow` — flexible width that absorbs the remaining space (the center spacer).
+ *
+ * Set only on built-in items; external (user-provided) items never carry it.
+ */
+export type HeaderItemFill = 'content' | 'truncate' | 'grow';
+/**
+ * Describes where a header item is placed relative to the other items.
+ */
+export type HeaderItemPosition = {
+    type: 'auto';
+} | {
+    type: 'before';
+    target: string;
+} | {
+    type: 'after';
+    target: string;
+} | {
+    type: 'first';
+} | {
+    type: 'last';
+};
+/**
+ * A single configurable item in a component header (title, button, menu, …).
+ */
+export interface HeaderItem {
+    /** Unique identifier of the item. */
+    id: string;
+    /** Component that renders the content of the item. */
+    component: HeaderItemComponent;
+    /** Where to place the item. Defaults to `{ type: 'auto' }`. */
+    position?: HeaderItemPosition;
+    /** Size configuration for the item. Each unspecified dimension falls back to the default. */
+    size?: HeaderItemSize;
+    /** Internal CSS fill behavior (built-ins only). */
+    fill?: HeaderItemFill;
+    /**
+     * Anchor-only flag (built-ins only). A hidden item takes part in `before`/`after` ordering as a
+     * stable anchor, but is removed before `onBeforeRender` and never rendered. This lets external
+     * items target a built-in (e.g. the filter toggle) by id even when the current configuration
+     * hides it, so positioning stays stable as built-ins appear/disappear. External items never set
+     * this — they are always rendered.
+     */
+    hidden?: boolean;
+}
+/**
+ * A header item after the built-in and user items have been merged and ordered. Same shape as
+ * {@link HeaderItem} but without `position`, which has already been applied.
+ */
+export type ResolvedHeaderItem = Omit<HeaderItem, 'position'>;
+/**
+ * Transforms the fully ordered list of header items right before rendering.
+ *
+ * @internal
+ */
+export type HeaderItemsTransform = (items: ReadonlyArray<ResolvedHeaderItem>) => ResolvedHeaderItem[];
+/**
+ * Internal header configuration consumed by the resolver. Components expose their own public config
+ * type (e.g. `DashboardHeaderConfig`) that is structurally assignable to this.
+ */
+export interface HeaderConfig {
+    /** Custom items to inject into the header. */
+    items?: HeaderItem[];
+    /**
+     * Advanced hook to inspect and rewrite the full, ordered list of header items (built-in + user)
+     * immediately before rendering. The only way to modify or remove built-in items.
+     */
+    onBeforeRender?: HeaderItemsTransform;
+}

package/dist/packages/sdk-ui/src/domains/shared/header/use-resolved-header-items.d.ts

@@ -0,0 +1,10 @@
+import { ResolveHeaderItemsOptions } from './resolve-header-items.js';
+import { HeaderConfig, HeaderItem, ResolvedHeaderItem } from './types.js';
+/**
+ * Memoized React hook wrapper around {@link resolveHeaderItems}.
+ *
+ * Recomputes only when the built-in items, the user config, or the auto-anchor change.
+ *
+ * @internal
+ */
+export declare const useResolvedHeaderItems: (builtInItems: HeaderItem[], config?: HeaderConfig, options?: ResolveHeaderItemsOptions) => ResolvedHeaderItem[];

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/areamap-chart/data/areamap-data.d.ts

@@ -1,4 +1,6 @@
 import { type AreamapChartDataOptionsInternal } from '../../../../../../../domains/visualizations/core/chart-data-options/types.js';
 import { DataTable } from '../../../../../../../domains/visualizations/core/chart-data-processor/table-processor.js';
 import { AreamapData } from '../types.js';
-export declare const getAreamapData: (dataOptions: AreamapChartDataOptionsInternal, dataTable: DataTable) => AreamapData;
+export declare const getAreamapData: (dataOptions: AreamapChartDataOptionsInternal, dataTable: DataTable, options?: {
+    defaultNumberFormattingEnabled?: boolean;
+}) => AreamapData;

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/cartesians/helpers/data.d.ts

@@ -1,4 +1,6 @@
 import { CartesianChartDataOptionsInternal } from '../../../../../../../../domains/visualizations/core/chart-data-options/types';
 import { DataTable } from '../../../../../../../../domains/visualizations/core/chart-data-processor/table-processor';
 import { CartesianChartData } from '../../../../../../../../domains/visualizations/core/chart-data/types';
-export declare function getCartesianChartData(chartDataOptions: CartesianChartDataOptionsInternal, dataTable: DataTable): CartesianChartData;
+export declare function getCartesianChartData(chartDataOptions: CartesianChartDataOptionsInternal, dataTable: DataTable, options?: {
+    defaultNumberFormattingEnabled?: boolean;
+}): CartesianChartData;

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/cartesians/stackable/streamgraph-chart/helpers/chart-data.d.ts

@@ -5,4 +5,6 @@ import { CartesianChartData } from '../../../../../../../../../../domains/visual
  * Composes the base cartesian chart data loader with the streamgraph-specific
  * normalization transformer to ensure continuous flow.
  */
-export declare const getStreamgraphChartData: (chartDataOptions: import("../../../../../../../../core/chart-data-options/types.js").CartesianChartDataOptionsInternal, dataTable: import("../../../../../../../../core/chart-data-processor/table-processor.js").DataTable) => CartesianChartData;
+export declare const getStreamgraphChartData: (chartDataOptions: import("../../../../../../../../core/chart-data-options/types.js").CartesianChartDataOptionsInternal, dataTable: import("../../../../../../../../core/chart-data-processor/table-processor.js").DataTable, options?: {
+    defaultNumberFormattingEnabled?: boolean | undefined;
+} | undefined) => CartesianChartData;

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/categoricals/helpers/data.d.ts

@@ -10,4 +10,6 @@ export declare const loadCategoricalData: typeof loadDataBySingleQuery;
 /**
  * Transforms data table to categorical chart data.
  */
-export declare function getCategoricalChartDataFromTable(dataOptions: CategoricalChartDataOptionsInternal, dataTable: DataTable): CategoricalChartData;
+export declare function getCategoricalChartDataFromTable(dataOptions: CategoricalChartDataOptionsInternal, dataTable: DataTable, options?: {
+    defaultNumberFormattingEnabled?: boolean;
+}): CategoricalChartData;

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/categoricals/sunburst-chart/data/index.d.ts

@@ -3,5 +3,7 @@ import { loadDataBySingleQuery } from '../../../../helpers/data-loading.js';
 import type { SunburstChartData, SunburstChartDataOptionsInternal } from '../types.js';
 export declare const dataTranslators: {
     loadData: typeof loadDataBySingleQuery;
-    getChartData: (dataOptions: SunburstChartDataOptionsInternal, dataTable: DataTable) => SunburstChartData;
+    getChartData: (dataOptions: SunburstChartDataOptionsInternal, dataTable: DataTable, options?: {
+        defaultNumberFormattingEnabled?: boolean;
+    }) => SunburstChartData;
 };

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/categoricals/treemap-chart/data/index.d.ts

@@ -3,5 +3,7 @@ import { loadDataBySingleQuery } from '../../../../helpers/data-loading.js';
 import type { TreemapChartData, TreemapChartDataOptionsInternal } from '../types.js';
 export declare const dataTranslators: {
     loadData: typeof loadDataBySingleQuery;
-    getChartData: (dataOptions: TreemapChartDataOptionsInternal, dataTable: DataTable) => TreemapChartData;
+    getChartData: (dataOptions: TreemapChartDataOptionsInternal, dataTable: DataTable, options?: {
+        defaultNumberFormattingEnabled?: boolean;
+    }) => TreemapChartData;
 };

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/highcharts-based-chart-renderer/build-highchart-options.d.ts

@@ -20,6 +20,7 @@ export declare const buildHighchartsOptions: <CT extends HighchartBasedChartType
         themeSettings: import("../../../../../../../types.js").CompleteThemeSettingsInternal;
         dateFormatter: (date: Date, format: string) => string;
         accessibilityEnabled: boolean;
+        defaultNumberFormattingEnabled: boolean;
     };
     onBeforeRender?: BeforeRenderHandler | undefined;
 }) => HighchartsOptionsInternal;

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/sankey-chart/alerts/index.d.ts

@@ -0,0 +1,5 @@
+import { BuildContext } from '../../types';
+/**
+ * Returns alert messages for Sankey charts.
+ */
+export declare function getSankeyChartAlerts(ctx: BuildContext<'sankey'>): string[];

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/sankey-chart/data/index.d.ts

@@ -0,0 +1,22 @@
+import { DataTable } from '../../../../../../../../domains/visualizations/core/chart-data-processor/table-processor';
+import { loadDataBySingleQuery } from '../../../helpers/data-loading';
+import { SankeyChartData, SankeyChartDataOptionsInternal } from '../types';
+/** Highcharts Sankey stops rendering beyond this many links (turboThreshold). */
+export declare const SANKEY_LINKS_LIMIT = 1000;
+/**
+ * Transforms a flat DataTable (grouped by all categories + value) into SankeyChartData.
+ *
+ * For each adjacent pair of categories (i, i+1), rows are aggregated to compute
+ * total flow weights between each unique (from, to) pair. This client-side aggregation
+ * allows a single query to power multi-stage Sankey diagrams.
+ *
+ * Example: categories=[Gender, Condition, AgeRange], value=Revenue
+ *   - Gender→Condition links: group rows by (Gender, Condition), sum Revenue
+ *   - Condition→AgeRange links: group rows by (Condition, AgeRange), sum Revenue
+ */
+declare function getSankeyChartData(dataOptions: SankeyChartDataOptionsInternal, dataTable: DataTable): SankeyChartData;
+export declare const dataTranslators: {
+    loadData: typeof loadDataBySingleQuery;
+    getChartData: typeof getSankeyChartData;
+};
+export {};