@sisense/sdk-ui 2.22.0 → 2.23.0

package/dist/packages/sdk-ui/src/domains/dashboarding/components/editable-layout/const.d.ts

@@ -1,3 +1,4 @@
+export declare const DRAG_ACTIVATION_DISTANCE_PX = 5;
 export declare const RESIZE_LINE_SIZE = 4;
 export declare const MIN_ROW_HEIGHT = 60;
 export declare const MAX_ROW_HEIGHT = 1500;

package/dist/packages/sdk-ui/src/domains/dashboarding/components/editable-layout/smart-pointer-sensor.d.ts

@@ -0,0 +1,17 @@
+import type { PointerEvent } from 'react';
+import { PointerSensor } from '@dnd-kit/core';
+import type { PointerSensorOptions } from '@dnd-kit/core';
+/**
+ * PointerSensor that skips activation when the event originates from interactive
+ * elements (input, textarea, select, button, contenteditable) or elements
+ * explicitly marked with the `data-no-dnd` attribute.
+ * Prevents DnD from stealing focus and keyboard events from the widget title editor.
+ *
+ * @internal
+ */
+export declare class SmartPointerSensor extends PointerSensor {
+    static activators: {
+        eventName: "onPointerDown";
+        handler: ({ nativeEvent: event }: PointerEvent, { onActivation }: PointerSensorOptions) => boolean;
+    }[];
+}

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/get-dashboard-model.d.ts

@@ -40,6 +40,7 @@ export interface GetDashboardModelOptions {
  * @param themeSettings - Optional theme settings
  * @param appSettings - Optional application settings
  * @returns The dashboard model
- * @internal
+ *
+ * @internal @sisenseInternal
  */
 export declare function getDashboardModel(http: HttpClient, dashboardOid: string, options?: GetDashboardModelOptions, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): Promise<DashboardModel>;

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/dashboard-model-reducer/types.d.ts

@@ -14,14 +14,24 @@ export declare enum UseDashboardModelActionTypeInternal {
 /**
  * Action types for the dashboard model state used in {@link useDashboardModel}.
  *
- * @internal
+ * @sisenseInternal
  */
 export declare enum UseDashboardModelActionType {
     FILTERS_UPDATE = "FILTERS.UPDATE",
     ADD_WIDGET = "WIDGETS.ADD",
+    PATCH_WIDGET = "WIDGETS.PATCH",
     WIDGETS_PANEL_LAYOUT_UPDATE = "WIDGETS_PANEL_LAYOUT.UPDATE",
     WIDGETS_DELETE = "WIDGETS.DELETE"
 }
+/**
+ * Fields that can be safely patched on a widget without full DTO reconstruction.
+ * Intentionally narrow — extend only when lossless roundtrip is guaranteed.
+ *
+ * @internal
+ */
+export type WidgetPatch = {
+    title?: string;
+};
 /**
  * Internal actions for the dashboard model state used in {@link useDashboardModel}.
  *
@@ -42,7 +52,7 @@ export type UseDashboardModelInternalAction = UseDashboardModelAction | {
  *
  * @internal
  */
-export type UseDashboardModelAction = UseDashboardModelFilterUpdateAction | UseDashboardModelAddWidgetAction | UseDashboardModelLayoutUpdateAction | UseDashboardWidgetsDeleteAction;
+export type UseDashboardModelAction = UseDashboardModelFilterUpdateAction | UseDashboardModelAddWidgetAction | UseDashboardModelPatchWidgetAction | UseDashboardModelLayoutUpdateAction | UseDashboardWidgetsDeleteAction;
 /**
  * Filter update actions for the dashboard model state used in {@link useDashboardModel}.
  *
@@ -72,6 +82,18 @@ export type UseDashboardModelAddWidgetAction = {
         widgetOptions?: SpecificWidgetOptions;
     };
 };
+/**
+ * Patch widget action for the dashboard model state used in {@link useDashboardModel}.
+ *
+ * @internal
+ */
+export type UseDashboardModelPatchWidgetAction = {
+    type: UseDashboardModelActionType.PATCH_WIDGET;
+    payload: {
+        widgetOid: string;
+        patch: WidgetPatch;
+    };
+};
 /**
  * Layout update action for the dashboard model state used in {@link useDashboardModel}.
  *

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/dashboard-model-reducer/utils.d.ts

@@ -7,7 +7,8 @@ import { AddWidgetPayload } from './types.js';
  *
  * @param filtersOrFilterRelations - The filters or filter relations to translate
  * @returns The translated filters and relations DTOs for Fusion
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare function translateFiltersAndRelationsToDto(filtersOrFilterRelations: Filter[] | FilterRelations): {
     filters: (import("../../../../../infra/api/types/dashboard-dto.js").FilterDto | import("../../../../../infra/api/types/dashboard-dto.js").CascadingFilterDto)[];

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/use-dashboard-persistence.d.ts

@@ -36,6 +36,7 @@ export interface UseDashboardPersistenceResult {
  *
  * @param params - Parameters for dashboard persistence
  * @returns Dashboard persistence state and dispatch function
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare function useDashboardPersistence({ dashboard, persist, sharedMode, }: UseDashboardPersistenceParams): UseDashboardPersistenceResult;

package/dist/packages/sdk-ui/src/domains/dashboarding/hooks/jtd/jtd-types.d.ts

@@ -200,7 +200,7 @@ export interface JumpToDashboardConfigForPivot extends Omit<JumpToDashboardConfi
     /**
      * Map of target dashboards for different dimensions/measures
      *
-     * @alpha
+     * @beta
      * @example
      *
      * const FormulaMeasure = dashboardProps.widgets[0].dataOptions.values[0];

package/dist/packages/sdk-ui/src/domains/dashboarding/hooks/rename-widget/use-widget-renaming.d.ts

@@ -0,0 +1,34 @@
+import type { WidgetProps } from '../../../../domains/widgets/components/widget/types.js';
+import type { DashboardPersistenceManager } from '../../types.js';
+/** Options for the widget renaming middleware hook. */
+export type UseWidgetRenamingParams = {
+    /** Current widgets. */
+    widgets: WidgetProps[];
+    /** When false, returns widgets unchanged (no config.header.title.editing.enabled, no persistence wrap). */
+    enabled?: boolean;
+    /** When provided, persists widget renames to the server on title/changed. */
+    persistence?: Pick<DashboardPersistenceManager, 'patchWidget'>;
+};
+/** Output of the widget renaming middleware. */
+export type WidgetRenamingOutput = {
+    widgets: WidgetProps[];
+};
+/**
+ * Middleware hook that enables widget-level rename UI and optionally persists renames.
+ * Sets config.header.title.editing.enabled on each widget so ChartWidget/PivotTableWidget show rename UI.
+ * When persistence is set, wraps widget onChange to call patchWidget on title/changed
+ * before forwarding to the change-detection layer.
+ *
+ * @param options - Options containing widgets, enabled flag, and optional persistence.
+ * @returns Widgets with config.header.title.editing.enabled and optionally wrapped onChange.
+ *
+ * @example
+ * ```ts
+ * const { widgets: widgetsWithRename } = useWidgetRenaming({
+ *   widgets: widgetsWithDuplicate,
+ *   enabled: true,
+ *   persistence,
+ * });
+ * ```
+ */
+export declare function useWidgetRenaming(params: UseWidgetRenamingParams): WidgetRenamingOutput;

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

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
-import { DashboardStyleOptions, SpecificWidgetOptions, WidgetsOptions, WidgetsPanelLayout } from '../../domains/dashboarding/dashboard-model';
+import { DashboardStyleOptions, SpecificWidgetOptions, WidgetPatch, WidgetsOptions, WidgetsPanelLayout } from '../../domains/dashboarding/dashboard-model';
 import { TabbersConfig } from '../../domains/dashboarding/hooks/use-tabber';
 import { FiltersPanelConfig } from '../../domains/filters/components/filters-panel/types';
 import { WidgetProps } from '../../domains/widgets/components/widget/types';
@@ -234,6 +234,22 @@ export interface EditModeConfig {
          */
         enabled: boolean;
     };
+    /**
+     * Configuration for the widget renaming feature.
+     *
+     * @internal
+     */
+    renameWidget?: {
+        /**
+         * When `true`, adds a "Rename widget" menu item to each widget header.
+         * On click, triggers inline title editing of the widget.
+         * Only has effect when edit mode is also enabled (`editMode.enabled`).
+         *
+         * If not specified, the default value is `false`.
+         * @internal
+         */
+        enabled: boolean;
+    };
 }
 /**
  * Dashboard configuration
@@ -314,6 +330,12 @@ export type DashboardPersistenceManager = {
         widgetsPanelLayout: WidgetsPanelLayout;
         widgetOptions?: SpecificWidgetOptions;
     }>;
+    /**
+     * Patch a single field (e.g. title) on an existing widget.
+     *
+     * @internal
+     */
+    patchWidget: (widgetOid: string, patch: WidgetPatch) => Promise<void>;
 };
 /**
  * Props for the Dashboard component

package/dist/packages/sdk-ui/src/domains/dashboarding/use-dashboard-theme.d.ts

@@ -34,8 +34,8 @@ export declare const useDashboardThemeInternal: ({ styleOptions }: DashboardThem
  * React hook that returns dashboard theme settings
  *
  * @group Dashboards
+ *
  * @alpha
- * @internal
  */
 export declare const useDashboardTheme: (args_0: DashboardThemeParams) => {
     themeSettings: {

package/dist/packages/sdk-ui/src/domains/data-browser/add-filter-popover/add-filter-data-browser.d.ts

@@ -1,4 +1,4 @@
-import { DataSource } from '@sisense/sdk-data';
+import { DataSource, DataSourceField, Dimension } from '@sisense/sdk-data';
 import { AttributiveElement } from '../dimensions-browser/types.js';
 type AddFilterDataBrowserProps = {
     dataSources: DataSource[];
@@ -13,4 +13,5 @@ type AddFilterDataBrowserProps = {
  * A component that allows users to select a data source and an attribute to create a filter.
  */
 export declare const AddFilterDataBrowser: ({ initialDataSource, dataSources, disabledAttributes, onAttributeClick, }: AddFilterDataBrowserProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useGetDimensionsFromDataSourceFields: (dataSourceFields: DataSourceField[] | undefined, dataSource: DataSource) => Dimension[];
 export {};

package/dist/packages/sdk-ui/src/domains/data-browser/data-schema-browser/data-schema-browser.d.ts

@@ -8,7 +8,8 @@ type DataSchemaBrowserProps = {
  *
  * @param params DataSchemaBrowserProps
  * @returns ReactElement
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare const DataSchemaBrowser: ({ dimensions, collapseAll }: DataSchemaBrowserProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/packages/sdk-ui/src/domains/data-browser/dimensions-browser/types.d.ts

@@ -54,6 +54,7 @@ export type AttributiveElement = Attribute | DateDimension;
  */
 export type AttributeActionConfig = {
     onClick(this: void, attribute: AttributiveElement): void;
+    getLabel?: (this: void, attribute: AttributiveElement) => string;
 };
 /**
  * Config for secondary action to be performed on an attribute.
@@ -65,10 +66,17 @@ export type AttributeSecondaryActionConfig = {
     SecondaryActionButtonIcon: React.ComponentType<{
         attribute: AttributiveElement;
     }>;
+    /**
+     * When true, the row keeps hover/focus style after the secondary action is clicked (e.g. while a menu is open).
+     * Call the `onSubmit` callback passed to `onClick` to clear the focus (e.g. when the menu closes).
+     */
+    keepFocusedOnClick?: boolean;
     /**
      * Callback to be executed when the secondary action button is clicked.
+     * The optional event provides the click position for positioning menus.
+     * When keepFocusedOnClick is true, `onSubmit` is provided; call it to clear the focused state (e.g. in menu onClose).
      */
-    onClick(this: void, attribute: AttributiveElement): void;
+    onClick(this: void, attribute: AttributiveElement, event: React.MouseEvent, onSubmit: () => void): void;
 };
 /**
  * Config for secondary action to be performed on a dimension.

package/dist/packages/sdk-ui/src/domains/formulas/fetch-formula.d.ts

@@ -1,5 +1,5 @@
 import { DataSource, DimensionalCalculatedMeasure } from '@sisense/sdk-data';
-import { ClientApplication } from '../../infra/app/client-application';
+import { type ClientApplication } from '../../infra/app/types';
 /**
  * Fetch a formula by oid from the default Sisense instance
  *

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

@@ -1,7 +1,7 @@
 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 { ClientApplication } from '../../../infra/app/client-application.js';
+import { type ClientApplication } from '../../../infra/app/types.js';
 /**
  * All the properties that fully describe a query you want to send.
  *

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

@@ -1,5 +1,5 @@
 import { QueryResultData } from '@sisense/sdk-data';
-import { ClientApplication } from '../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../infra/app/types';
 import { ExecuteQueryByWidgetIdParams, QueryByWidgetIdQueryParams, QueryByWidgetIdState } from '../../types';
 /**
  * React hook that executes a data query extracted from an existing widget in the Sisense instance.

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-query-cache/use-query-cache.d.ts

@@ -5,7 +5,8 @@
  *
  * @returns QueryCacheClient instance
  * @group Queries
- * @alpha
+ *
+ * @beta
  */
 export declare function useQueryCache(): {
     clear: () => void;

package/dist/packages/sdk-ui/src/domains/visualizations/components/boxplot-chart/boxplot-utils.d.ts

@@ -1,5 +1,5 @@
 import { Attribute, DataSource, Filter, FilterRelationsJaql, Measure, QueryResultData } from '@sisense/sdk-data';
-import { ClientApplication } from '../../../../infra/app/client-application.js';
+import { type ClientApplication } from '../../../../infra/app/types.js';
 import { executeQuery as executeQueryFunction } from '../../../query-execution/core/execute-query.js';
 import { BoxplotChartCustomDataOptions, BoxplotChartDataOptionsInternal } from '../../core/chart-data-options/types.js';
 /**

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/helpers/get-load-data-function.d.ts

@@ -1,7 +1,7 @@
 import { QueryResultData } from '@sisense/sdk-data';
 import { QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { QueryDescription } from '../../../../../domains/query-execution/core/execute-query';
-import { ClientApplication } from '../../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../../infra/app/types';
 import { ChartType } from '../../../../../types';
 import { ChartDataOptionsInternal } from '../../../core/chart-data-options/types';
 export type LoadDataFunction = (options: {

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

@@ -1,7 +1,7 @@
 import { QueryResultData } from '@sisense/sdk-data';
 import { QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { QueryDescription } from '../../../../../../domains/query-execution/core/execute-query';
-import { ClientApplication } from '../../../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../../../infra/app/types.js';
 /**
  * Load data by a regular single query execution.
  */

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

@@ -10,7 +10,7 @@ import { AreamapChartDataOptions, AreamapChartDataOptionsInternal, CalendarHeatm
 import { DataTable } from '../../../../../domains/visualizations/core/chart-data-processor/table-processor';
 import type { CartesianChartData, CategoricalChartData, ScattermapChartData } from '../../../../../domains/visualizations/core/chart-data/types';
 import { DesignOptions } from '../../../../../domains/visualizations/core/chart-options-processor/translations/types';
-import { ClientApplication } from '../../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../../infra/app/types';
 import type { AreamapStyleOptions, AreaStyleOptions, CalendarHeatmapStyleOptions, ChartDataOptions, ChartStyleOptions, FunnelStyleOptions, LineStyleOptions, PieStyleOptions, PolarStyleOptions, ScattermapStyleOptions, StackableStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, TreemapStyleOptions } from '../../../../../types';
 import { AreamapData } from './areamap-chart/types';
 import { CalendarHeatmapChartData } from './highchart-based-charts/calendar-heatmap-chart/data';

package/dist/packages/sdk-ui/src/domains/widgets/change-events.d.ts

@@ -0,0 +1,73 @@
+import { Attribute } from '@sisense/sdk-data';
+import { DataOptionLocation, DrilldownSelection } from '../../types';
+/**
+ * Event triggered when chart widget drilldown selections change.
+ *
+ * @example
+ * ```ts
+ * { type: 'drilldownSelections/changed', payload: [{ points: [...], nextDimension }] }
+ * ```
+ */
+export interface ChartWidgetDrilldownSelectionsChangedEvent {
+    /** Event type */
+    type: 'drilldownSelections/changed';
+    /** The new drilldown selections */
+    payload: DrilldownSelection[];
+}
+/**
+ * Event triggered when widget title changes (e.g. inline rename).
+ *
+ * @example
+ * ```ts
+ * { type: 'title/changed', payload: { title: 'New Title' } }
+ * ```
+ */
+export interface WidgetTitleChangedEvent {
+    /** Event type */
+    type: 'title/changed';
+    /** The new title */
+    payload: {
+        title: string;
+    };
+}
+/**
+ * Events that can be triggered by the ChartWidget component.
+ */
+export type ChartWidgetChangeEvent = ChartWidgetDrilldownSelectionsChangedEvent | WidgetTitleChangedEvent;
+/**
+ * Event triggered when pivot table widget drilldown selections change.
+ *
+ * @example
+ * ```ts
+ * { type: 'drilldownSelections/changed', payload: { target, selections } }
+ * ```
+ */
+export interface PivotTableWidgetDrilldownSelectionsChangedEvent {
+    /** Event type */
+    type: 'drilldownSelections/changed';
+    /** The drilldown target and new selections */
+    payload: {
+        target: Attribute | DataOptionLocation;
+        selections: DrilldownSelection[];
+    };
+}
+/**
+ * Events that can be triggered by the PivotTableWidget component.
+ */
+export type PivotTableWidgetChangeEvent = PivotTableWidgetDrilldownSelectionsChangedEvent | WidgetTitleChangedEvent;
+/**
+ * Events that can be triggered by widget components.
+ *
+ * Union of all widget-specific change events. Extensible for TextWidget, CustomWidget future events.
+ *
+ * @example
+ * ```ts
+ * ChartWidget onChange handler:
+ * onChange={(event) => {
+ *   if (event.type === 'drilldownSelections/changed') {
+ *     setDrilldownSelections(event.payload);
+ *   }
+ * }}
+ * ```
+ */
+export type WidgetChangeEvent = ChartWidgetChangeEvent | PivotTableWidgetChangeEvent;

package/dist/packages/sdk-ui/src/domains/widgets/components/chart-widget/types.d.ts

@@ -1,8 +1,10 @@
 import { ReactNode } from 'react';
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
+import type { ChartWidgetChangeEvent, ChartWidgetDrilldownSelectionsChangedEvent } from '../../../../domains/widgets/change-events';
 import type { ChartEventProps } from '../../../../props';
 import { ChartDataOptions, ChartType, ChartWidgetStyleOptions, DrilldownOptions } from '../../../../types';
 import { WidgetConfig } from '../widget/types';
+export type { ChartWidgetChangeEvent, ChartWidgetDrilldownSelectionsChangedEvent };
 /**
  * Props for the {@link ChartWidget} component
  *
@@ -95,6 +97,14 @@ export interface ChartWidgetProps extends ChartEventProps {
      * @category Widget
      */
     highlightSelectionDisabled?: boolean;
-    /** @internal */
-    onChange?: (props: Partial<ChartWidgetProps>) => void;
+    /**
+     * Callback to receive widget change events.
+     *
+     * Invoked when the widget state changes (e.g. drilldown selections).
+     * See {@link ChartWidgetChangeEvent} for event types.
+     *
+     * @param event - The change event that occurred
+     * @internal
+     */
+    onChange?: (event: ChartWidgetChangeEvent) => void;
 }

package/dist/packages/sdk-ui/src/domains/widgets/components/pivot-table-widget/types.d.ts

@@ -2,9 +2,11 @@ import { ReactNode } from 'react';
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
 import type { CustomDataCellFormatter, CustomHeaderCellFormatter } from '../../../../domains/visualizations/components/pivot-table/formatters/types';
 import { PivotTableDataOptions } from '../../../../domains/visualizations/core/chart-data-options/types';
+import type { PivotTableWidgetChangeEvent, PivotTableWidgetDrilldownSelectionsChangedEvent } from '../../../../domains/widgets/change-events';
 import type { PivotTableDataPointEventHandler } from '../../../../props';
 import { PivotTableDrilldownOptions, PivotTableWidgetStyleOptions } from '../../../../types';
 import { WidgetConfig } from '../widget/types';
+export type { PivotTableWidgetChangeEvent, PivotTableWidgetDrilldownSelectionsChangedEvent };
 /**
  * Props for the {@link PivotTableWidget} component
  */
@@ -136,6 +138,14 @@ export interface PivotTableWidgetProps {
      * @internal
      */
     onHeaderCellFormat?: CustomHeaderCellFormatter;
-    /** @internal */
-    onChange?: (props: Partial<PivotTableWidgetProps>) => void;
+    /**
+     * Callback to receive widget change events.
+     *
+     * Invoked when the widget state changes (e.g. drilldown selections).
+     * See {@link PivotTableWidgetChangeEvent} for event types.
+     *
+     * @param event - The change event that occurred
+     * @internal
+     */
+    onChange?: (event: PivotTableWidgetChangeEvent) => void;
 }

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/translate-dashboard-filters.d.ts

@@ -8,7 +8,8 @@ import { FiltersIgnoringRules, WidgetDto } from './types.js';
  * @param dashboard - The dashboard containing the filters.
  * @param widget - The widget containing the filters.
  * @returns An object containing an array of filters and an array of highlights.
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare function extractCombinedFilters(dashboard: DashboardDto, widget: WidgetDto): {
     filters: import("@sisense/sdk-data").Filter[];
@@ -4788,6 +4789,7 @@ export declare function getDashboardFilters(dashboardFilters: Array<FilterDto |
                 jaql: import("@sisense/sdk-data").FilterJaql;
             } | undefined;
         } | undefined;
+        indexed?: boolean | undefined;
         merged?: boolean | undefined;
         panel?: "rows" | "columns" | undefined;
     };

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/translate-widget-data-options.d.ts

@@ -5,7 +5,7 @@ import { BoxplotWidgetStyle, FusionWidgetType, Panel, PanelItem, WidgetStyle } f
 export declare function createDataColumn(item: PanelItem, customPaletteColors?: Color[]): StyledColumn | StyledMeasureColumn;
 /** @internal */
 export declare function createPanelItem(column: StyledColumn | StyledMeasureColumn): PanelItem;
-/** @internal */
+/** @sisenseInternal */
 export declare const createDataOptionsFromPanels: (panels: Panel[], variantColors: Color[]) => {
     [key: string]: any[];
 };

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/types.d.ts

@@ -44,7 +44,7 @@ export declare enum WidgetDashboardFilterMode {
  * This is the (not-comprehensive) structure of the response from the
  * `/api/v1/dashboards/${dashboardOid}/widgets/${widgetOid}` endpoint.
  *
- * @internal
+ * @sisenseInternal
  */
 export interface WidgetDto {
     oid: string;

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/utils.d.ts

@@ -100,7 +100,8 @@ export declare function isTextWidgetProps(widgetProps: CommonWidgetProps): widge
  *
  * @param widgetProps - The widget props to check.
  * @returns whether the widget props is for a pivot table widget
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare function isPivotTableWidgetProps(widgetProps: CommonWidgetProps): widgetProps is WithCommonWidgetProps<PivotTableWidgetProps, 'pivot'>;
 /**
@@ -116,7 +117,7 @@ export declare function isCustomWidgetProps(widgetProps: CommonWidgetProps): wid
  *
  * @param widgetProps - The widget props to check.
  * @returns whether the widget props is for a chart widget
- * @internal
+ * @sisenseInternal
  */
 export declare function isChartWidgetProps(widgetProps: CommonWidgetProps): widgetProps is WithCommonWidgetProps<ChartWidgetProps, 'chart'>;
 export declare function getInternalWidgetType(widgetProps: CommonWidgetProps): WidgetTypeInternal;

package/dist/packages/sdk-ui/src/domains/widgets/event-to-delta.d.ts

@@ -0,0 +1,17 @@
+import type { WidgetChangeEvent } from './change-events';
+import type { WidgetProps } from './components/widget/types';
+/**
+ * Reduces a WidgetChangeEvent to a Partial<WidgetProps> delta for state merge.
+ *
+ * Pure, allocation-only; no mutation. Used by the composition layer (e.g. useComposedDashboard)
+ * to translate atomic events into prop updates.
+ *
+ * Validates that the event payload structure matches the widget type before applying.
+ * Returns empty delta when payload structure is incompatible (e.g. chart array payload
+ * for a pivot widget), avoiding silent corruption.
+ *
+ * @param event - The widget change event
+ * @param currentWidget - The current widget state
+ * @returns A partial props object to merge into the widget
+ */
+export declare function widgetChangeEventToDelta(event: WidgetChangeEvent, currentWidget: WidgetProps): Partial<WidgetProps>;

package/dist/packages/sdk-ui/src/domains/widgets/helpers/header-menu-utils.d.ts

@@ -1,9 +1,19 @@
-import { MenuItem } from '../../../shared/types/menu-item';
-import { WidgetProps } from '../components/widget/types';
+import type { MenuItem } from '../../../shared/types/menu-item';
+import type { WidgetProps } from '../components/widget/types';
+import type { WidgetHeaderConfig } from '../shared/widget-header/types';
 /**
- * Adds a menu item to the widget header.
+ * Transformer: adds a menu item to a header config (pure, non-mutating).
+ *
+ * @param menuItem - The menu item to append to toolbar.menu.items.
+ * @returns A transformer that maps WidgetHeaderConfig to WidgetHeaderConfig with the menu item appended.
+ * @internal
+ */
+export declare function withMenuItemInHeaderConfig(menuItem: MenuItem): (headerConfig: WidgetHeaderConfig) => WidgetHeaderConfig;
+/**
+ * Adds a menu item to the widget header (transforms full WidgetProps).
+ *
  * @param menuItem - The menu item to add.
- * @returns A function that adds a menu item to the widget header.
+ * @returns A transformer that maps WidgetProps to WidgetProps with the item in config.header.toolbar.menu.items.
  * @internal
  */
 export declare function withHeaderMenuItem(menuItem: MenuItem): (widget: WidgetProps) => WidgetProps;

package/dist/packages/sdk-ui/src/domains/widgets/helpers/index.d.ts

@@ -3,5 +3,6 @@
  * @internal
  */
 export declare const widgetHelpers: {
+    withMenuItemInHeaderConfig(menuItem: import("../../../shared/types/menu-item").MenuItem): (headerConfig: import("../shared/widget-header/types").WidgetHeaderConfig) => import("../shared/widget-header/types").WidgetHeaderConfig;
     withHeaderMenuItem(menuItem: import("../../../shared/types/menu-item").MenuItem): (widget: import("../components/widget").WidgetProps) => import("../components/widget").WidgetProps;
 };

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-title-renaming.d.ts

@@ -0,0 +1,27 @@
+import type { WidgetChangeEvent } from '../../../domains/widgets/change-events.js';
+import type { TitleEditorConfig } from '../../../domains/widgets/shared/widget-header/types.js';
+import type { MenuItem } from '../../../shared/types/menu-item.js';
+/** Parameters for the title renaming hook. */
+export type UseTitleRenamingParams = {
+    /** Whether inline title renaming is enabled. */
+    enabled: boolean;
+    /** Handler called when the user commits a new title. */
+    onChange?: (event: WidgetChangeEvent) => void;
+};
+/** Result of the title renaming hook. */
+export type UseTitleRenamingResult = {
+    /** "Rename" menu item to inject into the header toolbar; undefined when not enabled. */
+    renameMenuItem: MenuItem | undefined;
+    /** Config for the inline title editor; undefined when not enabled. */
+    titleEditorConfig: TitleEditorConfig | undefined;
+};
+/**
+ * Hook that manages inline title renaming state: isEditing, start/cancel/commit
+ * callbacks, titleEditorConfig for the title editor, and a prepared "Rename" menu item.
+ * Emits title/changed on commit.
+ *
+ * @param params - Hook parameters
+ * @returns renameMenuItem and titleEditorConfig
+ * @internal
+ */
+export declare function useTitleRenaming(params: UseTitleRenamingParams): UseTitleRenamingResult;

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-widget-header-management.d.ts

@@ -0,0 +1,28 @@
+import type { WidgetChangeEvent } from '../../../domains/widgets/change-events.js';
+import type { TitleEditorConfig, WidgetHeaderConfig } from '../../../domains/widgets/shared/widget-header/types.js';
+/** Parameters for the widget header management hook. */
+export type UseWidgetHeaderManagementParams = {
+    /** Current title (from props). */
+    title?: string;
+    /** onChange handler (from props). */
+    onChange?: (event: WidgetChangeEvent) => void;
+    /** Merged config.header from props (may already have toolbar.menu.items). */
+    headerConfig?: WidgetHeaderConfig;
+};
+/** Result of the widget header management hook. */
+export type UseWidgetHeaderManagementResult = {
+    /** Merged header config (e.g. rename menu in toolbar). */
+    headerConfig: WidgetHeaderConfig;
+    /** Inline title editor config when rename is enabled. Pass to WidgetContainer as separate prop. */
+    titleEditor?: TitleEditorConfig;
+};
+/**
+ * Hook that manages widget header UI for rename: adds "Rename" menu item
+ * and delegates inline title editing to useTitleRenaming.
+ * Used by ChartWidget and PivotTableWidget when config.header.title.editing.enabled is true.
+ *
+ * @param params - Hook parameters
+ * @returns Merged header config to pass to WidgetContainer
+ * @internal
+ */
+export declare function useWidgetHeaderManagement(params: UseWidgetHeaderManagementParams): UseWidgetHeaderManagementResult;