@sisense/sdk-ui-vue 2.32.0 → 2.33.1

package/dist/src/components/charts/index.d.ts

@@ -18,3 +18,4 @@ export { AreamapChart, type AreamapChartProps } from './areamap-chart';
 export { ScattermapChart, type ScattermapChartProps } from './scattermap-chart';
 export { StreamgraphChart, type StreamgraphChartProps } from './streamgraph-chart';
 export { AreaRangeChart, type AreaRangeChartProps } from './area-range-chart';
+export { SankeyChart, type SankeyChartProps } from './sankey-chart';

package/dist/src/components/charts/sankey-chart.d.ts

@@ -0,0 +1,178 @@
+import type { SankeyChartProps as SankeyChartPropsPreact } from '@sisense/sdk-ui-preact';
+import type { PropType } from 'vue';
+/**
+ * Props of the {@link @sisense/sdk-ui-vue!SankeyChart | `SankeyChart`} component.
+ */
+export interface SankeyChartProps extends SankeyChartPropsPreact {
+}
+/**
+ * A Vue component that visualizes flow and volume between nodes using a Sankey diagram.
+ *
+ * Node width represents the total flow through that node; link width represents the flow
+ * between two connected nodes.
+ *
+ * @example
+ * Here's how you can use the SankeyChart component in a Vue application:
+ * ```vue
+ * <template>
+ * <SankeyChart
+ *      :dataOptions="sankeyChartProps.dataOptions"
+ *      :dataSet="sankeyChartProps.dataSet"
+ *      :styleOptions="sankeyChartProps.styleOptions"
+ *    />
+ * </template>
+ *
+ * <script setup lang="ts">
+ * import { ref } from 'vue';
+ * import { measureFactory } from '@sisense/sdk-data';
+ * import * as DM from '../assets/sample-ecommerce';
+ * import { SankeyChart, type SankeyChartProps } from '@sisense/sdk-ui-vue';
+ *
+ * const sankeyChartProps = ref<SankeyChartProps>({
+ *   dataSet: DM.DataSource,
+ *   dataOptions: {
+ *     category: [DM.Commerce.Gender, DM.Commerce.AgeRange],
+ *     value: measureFactory.sum(DM.Commerce.Revenue, 'Revenue'),
+ *   },
+ *   styleOptions: {
+ *     orientation: 'horizontal',
+ *     nodeAlignment: 'top',
+ *   },
+ * });
+ * </script>
+ * ```
+ * @param {SankeyChartProps} - Sankey chart properties
+ * @returns Sankey Chart component
+ * @group Charts
+ */
+export declare const SankeyChart: import("vue").DefineComponent<{
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.dataOptions}
+     *
+     * @category Chart
+     */
+    dataOptions: {
+        type: PropType<import("@sisense/sdk-ui-preact").SankeyChartDataOptions>;
+        required: true;
+    };
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.dataSet}
+     *
+     * @category Data
+     */
+    dataSet: PropType<import("@sisense/sdk-data").DataSource | import("@sisense/sdk-data").Data | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.filters}
+     *
+     * @category Data
+     */
+    filters: PropType<import("@sisense/sdk-data").FilterRelations | import("@sisense/sdk-data").Filter[] | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.highlights}
+     *
+     * @category Data
+     */
+    highlights: PropType<import("@sisense/sdk-data").Filter[] | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.styleOptions}
+     *
+     * @category Chart
+     */
+    styleOptions: PropType<import("@sisense/sdk-ui-preact").SankeyStyleOptions | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onBeforeRender}
+     *
+     * @category Callbacks
+     */
+    onBeforeRender: PropType<import("@sisense/sdk-ui-preact").BeforeRenderHandler | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataReady}
+     *
+     * @category Callbacks
+     */
+    onDataReady: PropType<((data: import("@sisense/sdk-data").Data) => import("@sisense/sdk-data").Data) | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataPointClick}
+     *
+     * @category Callbacks
+     */
+    onDataPointClick: PropType<import("@sisense/sdk-ui-preact").DataPointEventHandler | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataPointContextMenu}
+     *
+     * @category Callbacks
+     */
+    onDataPointContextMenu: PropType<import("@sisense/sdk-ui-preact").DataPointEventHandler | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataPointsSelected}
+     *
+     * @category Callbacks
+     */
+    onDataPointsSelected: PropType<import("@sisense/sdk-ui-preact").DataPointsEventHandler | undefined>;
+}, (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>) | null, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.dataOptions}
+     *
+     * @category Chart
+     */
+    dataOptions: {
+        type: PropType<import("@sisense/sdk-ui-preact").SankeyChartDataOptions>;
+        required: true;
+    };
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.dataSet}
+     *
+     * @category Data
+     */
+    dataSet: PropType<import("@sisense/sdk-data").DataSource | import("@sisense/sdk-data").Data | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.filters}
+     *
+     * @category Data
+     */
+    filters: PropType<import("@sisense/sdk-data").FilterRelations | import("@sisense/sdk-data").Filter[] | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.highlights}
+     *
+     * @category Data
+     */
+    highlights: PropType<import("@sisense/sdk-data").Filter[] | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.styleOptions}
+     *
+     * @category Chart
+     */
+    styleOptions: PropType<import("@sisense/sdk-ui-preact").SankeyStyleOptions | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onBeforeRender}
+     *
+     * @category Callbacks
+     */
+    onBeforeRender: PropType<import("@sisense/sdk-ui-preact").BeforeRenderHandler | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataReady}
+     *
+     * @category Callbacks
+     */
+    onDataReady: PropType<((data: import("@sisense/sdk-data").Data) => import("@sisense/sdk-data").Data) | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataPointClick}
+     *
+     * @category Callbacks
+     */
+    onDataPointClick: PropType<import("@sisense/sdk-ui-preact").DataPointEventHandler | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataPointContextMenu}
+     *
+     * @category Callbacks
+     */
+    onDataPointContextMenu: PropType<import("@sisense/sdk-ui-preact").DataPointEventHandler | undefined>;
+    /**
+     * {@inheritDoc @sisense/sdk-ui!SankeyChartProps.onDataPointsSelected}
+     *
+     * @category Callbacks
+     */
+    onDataPointsSelected: PropType<import("@sisense/sdk-ui-preact").DataPointsEventHandler | undefined>;
+}>>, {}, {}>;

package/dist/src/components/dashboard/dashboard-by-id.d.ts

@@ -1,6 +1,6 @@
 import type { DashboardByIdConfig as DashboardByIdConfigPreact, DashboardByIdProps as DashboardByIdPropsPreact } from '@sisense/sdk-ui-preact';
 import type { PropType } from 'vue';
-import type { DashboardHeaderConfig } from './dashboard';
+import { type DashboardHeaderConfig } from './dashboard-header-config';
 /**
  * Configuration for the {@link @sisense/sdk-ui-vue!DashboardById | `DashboardById`} component.
  */

package/dist/src/components/dashboard/dashboard-header-config.d.ts

@@ -0,0 +1,87 @@
+import { type DashboardHeaderConfig as DashboardHeaderConfigPreact, type DashboardHeaderItemComponentProps, type DashboardHeaderItem as DashboardHeaderItemPreact } from '@sisense/sdk-ui-preact';
+import type { Component, DefineComponent } from 'vue';
+/**
+ * A Vue component that renders the content of a custom dashboard header item.
+ * This can be a Vue component options object, a `defineComponent` result, or any valid Vue component.
+ *
+ * The item size resolved by the header layout is provided via the `size` prop.
+ *
+ * @example
+ * A Vue header item component rendering an export button that uses its resolved size:
+ * ```vue
+ * <script setup lang="ts">
+ * import { type DashboardHeaderItemComponentProps } from '@sisense/sdk-ui-vue';
+ *
+ * const props = defineProps<DashboardHeaderItemComponentProps>();
+ *
+ * const onExport = () => {
+ *   // trigger the export
+ * };
+ * </script>
+ * <template>
+ *   <button :style="{ height: props.size.height + 'px' }" @click="onExport">Export</button>
+ * </template>
+ * ```
+ */
+export type DashboardHeaderItemComponent = Component<DashboardHeaderItemComponentProps> | DefineComponent<DashboardHeaderItemComponentProps>;
+/**
+ * A custom item to inject into the dashboard header.
+ */
+export interface DashboardHeaderItem extends Omit<DashboardHeaderItemPreact, 'component'> {
+    /**
+     * Vue component that renders the content of the item.
+     */
+    component: DashboardHeaderItemComponent;
+}
+/**
+ * A dashboard header item after the built-in and custom items have been ordered (position applied).
+ *
+ * This is the shape passed to {@link DashboardHeaderConfig.onBeforeRender}.
+ *
+ * For custom items, `component` is the same Vue component that was registered in
+ * {@link DashboardHeaderConfig.items}, so items can be matched by component identity as well as by
+ * `id`. For built-in items, `component` is an opaque handle to an internal renderer: reorder, keep,
+ * or remove such an item, but do not invoke or replace its component.
+ */
+export type DashboardResolvedHeaderItem = Omit<DashboardHeaderItem, 'position'>;
+/**
+ * Transforms the fully ordered list of dashboard header items right before rendering.
+ */
+export type DashboardHeaderItemsTransform = (items: ReadonlyArray<DashboardResolvedHeaderItem>) => DashboardResolvedHeaderItem[];
+/**
+ * Configuration for the dashboard header.
+ *
+ * Injects custom {@link DashboardHeaderItem | items} into the header and, via
+ * {@link DashboardHeaderConfig.onBeforeRender | `onBeforeRender`}, reorders or removes the
+ * built-in items (referenced by {@link DashboardHeaderTargets}).
+ *
+ * @example
+ * Add a custom item after the title and hide the built-in title:
+ * ```ts
+ * import { DashboardHeaderTargets, type DashboardConfig } from '@sisense/sdk-ui-vue';
+ * import ExportButton from './export-button.vue';
+ *
+ * const config: DashboardConfig = {
+ *   header: {
+ *     items: [
+ *       {
+ *         id: 'export',
+ *         component: ExportButton,
+ *         position: { type: 'after', target: DashboardHeaderTargets.Title },
+ *       },
+ *     ],
+ *     onBeforeRender: (items) => items.filter((item) => item.id !== DashboardHeaderTargets.Title),
+ *   },
+ * };
+ * ```
+ */
+export interface DashboardHeaderConfig extends Omit<DashboardHeaderConfigPreact, 'items' | 'onBeforeRender'> {
+    /**
+     * {@inheritDoc @sisense/sdk-ui!DashboardHeaderConfig.items}
+     */
+    items?: DashboardHeaderItem[];
+    /**
+     * {@inheritDoc @sisense/sdk-ui!DashboardHeaderConfig.onBeforeRender}
+     */
+    onBeforeRender?: DashboardHeaderItemsTransform;
+}

package/dist/src/components/dashboard/dashboard.d.ts

@@ -1,12 +1,11 @@
-import type { DashboardConfig as DashboardConfigPreact, DashboardFiltersPanelConfig, DashboardHeaderConfig as DashboardHeaderConfigPreact, DashboardProps as DashboardPropsPreact } from '@sisense/sdk-ui-preact';
+import { DashboardHeaderTargets } from '@sisense/sdk-ui-preact';
+import type { DashboardConfig as DashboardConfigPreact, DashboardFiltersPanelConfig, DashboardHeaderItemComponentProps, DashboardHeaderItemPosition, DashboardHeaderItemSize, DashboardHeaderTarget, DashboardProps as DashboardPropsPreact } from '@sisense/sdk-ui-preact';
 import type { PropType } from 'vue';
 import type { WidgetProps } from '../widgets';
-export { DashboardFiltersPanelConfig };
-/**
- * Configuration for the dashboard header.
- */
-export interface DashboardHeaderConfig extends Omit<DashboardHeaderConfigPreact, 'items' | 'onBeforeRender'> {
-}
+import { type DashboardHeaderConfig } from './dashboard-header-config';
+export { DashboardHeaderTargets };
+export type { DashboardFiltersPanelConfig, DashboardHeaderItemComponentProps, DashboardHeaderItemPosition, DashboardHeaderItemSize, DashboardHeaderTarget, };
+export type { DashboardHeaderConfig, DashboardHeaderItem, DashboardHeaderItemComponent, DashboardHeaderItemsTransform, DashboardResolvedHeaderItem, } from './dashboard-header-config';
 /**
  * Configuration for the {@link @sisense/sdk-ui-vue!Dashboard | `Dashboard`} component.
  */

package/dist/src/components/widgets/widget-by-id.d.ts

@@ -50,7 +50,7 @@ export declare const WidgetById: import("vue").DefineComponent<{
      */
     description: PropType<string | undefined>;
     /** @internal */
-    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | import("@sisense/sdk-ui-preact").DrilldownOptions | undefined>;
+    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").DrilldownOptions | import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!WidgetByIdProps.filters}
      *
@@ -157,7 +157,7 @@ export declare const WidgetById: import("vue").DefineComponent<{
      */
     description: PropType<string | undefined>;
     /** @internal */
-    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | import("@sisense/sdk-ui-preact").DrilldownOptions | undefined>;
+    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").DrilldownOptions | import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!WidgetByIdProps.filters}
      *

package/dist/src/components/widgets/widget.d.ts

@@ -63,7 +63,7 @@ export declare const Widget: import("vue").DefineComponent<{
      * @category Widget
      */
     widgetType: {
-        type: PropType<"filter" | "chart" | "pivot" | "text" | "custom">;
+        type: PropType<"filter" | "text" | "custom" | "chart" | "pivot">;
         required: true;
     };
     /**
@@ -89,7 +89,7 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Chart
      */
-    dataOptions: PropType<import("@sisense/sdk-ui-preact").PivotTableDataOptions | import("@sisense/sdk-ui-preact").GenericDataOptions | import("@sisense/sdk-ui-preact").ChartDataOptions | undefined>;
+    dataOptions: PropType<import("@sisense/sdk-ui-preact").GenericDataOptions | import("@sisense/sdk-ui-preact").ChartDataOptions | import("@sisense/sdk-ui-preact").PivotTableDataOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.filters}
      *
@@ -107,7 +107,7 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Widget
      */
-    styleOptions: PropType<import("@sisense/sdk-ui-preact").TextWidgetStyleOptions | import("@sisense/sdk-ui-preact").WidgetContainerStyleOptions | import("@sisense/sdk-ui-preact").CustomWidgetStyleOptions | import("@sisense/sdk-ui-preact").PivotTableWidgetStyleOptions | import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | undefined>;
+    styleOptions: PropType<import("@sisense/sdk-ui-preact").WidgetContainerStyleOptions | import("@sisense/sdk-ui-preact").CustomWidgetStyleOptions | import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | import("@sisense/sdk-ui-preact").PivotTableWidgetStyleOptions | import("@sisense/sdk-ui-preact").TextWidgetStyleOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.config}
      *
@@ -126,7 +126,7 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Widget
      */
-    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | import("@sisense/sdk-ui-preact").DrilldownOptions | undefined>;
+    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").DrilldownOptions | import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.title}
      *
@@ -170,13 +170,13 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Callbacks
      */
-    onDataPointClick: PropType<import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | import("@sisense/sdk-ui-preact").CustomWidgetDataPointEventHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").AreamapDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").ScattermapDataPointEventHandler | import("@sisense/sdk-ui-preact").IndicatorDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | import("@sisense/sdk-ui-preact").TextWidgetDataPointEventHandler | undefined>;
+    onDataPointClick: PropType<import("@sisense/sdk-ui-preact").CustomWidgetDataPointEventHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").AreamapDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").ScattermapDataPointEventHandler | import("@sisense/sdk-ui-preact").IndicatorDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | import("@sisense/sdk-ui-preact").TextWidgetDataPointEventHandler | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.onDataPointContextMenu}
      *
      * @category Callbacks
      */
-    onDataPointContextMenu: PropType<import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | import("@sisense/sdk-ui-preact").CustomWidgetDataPointContextMenuHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | undefined>;
+    onDataPointContextMenu: PropType<import("@sisense/sdk-ui-preact").CustomWidgetDataPointContextMenuHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.onDataPointsSelected}
      *
@@ -201,7 +201,7 @@ export declare const Widget: import("vue").DefineComponent<{
      * @category Widget
      */
     widgetType: {
-        type: PropType<"filter" | "chart" | "pivot" | "text" | "custom">;
+        type: PropType<"filter" | "text" | "custom" | "chart" | "pivot">;
         required: true;
     };
     /**
@@ -227,7 +227,7 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Chart
      */
-    dataOptions: PropType<import("@sisense/sdk-ui-preact").PivotTableDataOptions | import("@sisense/sdk-ui-preact").GenericDataOptions | import("@sisense/sdk-ui-preact").ChartDataOptions | undefined>;
+    dataOptions: PropType<import("@sisense/sdk-ui-preact").GenericDataOptions | import("@sisense/sdk-ui-preact").ChartDataOptions | import("@sisense/sdk-ui-preact").PivotTableDataOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.filters}
      *
@@ -245,7 +245,7 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Widget
      */
-    styleOptions: PropType<import("@sisense/sdk-ui-preact").TextWidgetStyleOptions | import("@sisense/sdk-ui-preact").WidgetContainerStyleOptions | import("@sisense/sdk-ui-preact").CustomWidgetStyleOptions | import("@sisense/sdk-ui-preact").PivotTableWidgetStyleOptions | import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | undefined>;
+    styleOptions: PropType<import("@sisense/sdk-ui-preact").WidgetContainerStyleOptions | import("@sisense/sdk-ui-preact").CustomWidgetStyleOptions | import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | import("@sisense/sdk-ui-preact").PivotTableWidgetStyleOptions | import("@sisense/sdk-ui-preact").TextWidgetStyleOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.config}
      *
@@ -264,7 +264,7 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Widget
      */
-    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | import("@sisense/sdk-ui-preact").DrilldownOptions | undefined>;
+    drilldownOptions: PropType<import("@sisense/sdk-ui-preact").DrilldownOptions | import("@sisense/sdk-ui-preact").PivotTableDrilldownOptions | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.title}
      *
@@ -308,13 +308,13 @@ export declare const Widget: import("vue").DefineComponent<{
      *
      * @category Callbacks
      */
-    onDataPointClick: PropType<import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | import("@sisense/sdk-ui-preact").CustomWidgetDataPointEventHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").AreamapDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").ScattermapDataPointEventHandler | import("@sisense/sdk-ui-preact").IndicatorDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | import("@sisense/sdk-ui-preact").TextWidgetDataPointEventHandler | undefined>;
+    onDataPointClick: PropType<import("@sisense/sdk-ui-preact").CustomWidgetDataPointEventHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").AreamapDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").ScattermapDataPointEventHandler | import("@sisense/sdk-ui-preact").IndicatorDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | import("@sisense/sdk-ui-preact").TextWidgetDataPointEventHandler | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.onDataPointContextMenu}
      *
      * @category Callbacks
      */
-    onDataPointContextMenu: PropType<import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | import("@sisense/sdk-ui-preact").CustomWidgetDataPointContextMenuHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | undefined>;
+    onDataPointContextMenu: PropType<import("@sisense/sdk-ui-preact").CustomWidgetDataPointContextMenuHandler<import("@sisense/sdk-ui-preact").AbstractDataPointWithEntries> | import("@sisense/sdk-ui-preact").DataPointEventHandler | import("@sisense/sdk-ui-preact").ScatterDataPointEventHandler | import("@sisense/sdk-ui-preact").BoxplotDataPointEventHandler | import("@sisense/sdk-ui-preact").CalendarHeatmapDataPointEventHandler | import("@sisense/sdk-ui-preact").KpiDataPointEventHandler | import("@sisense/sdk-ui-preact").PivotTableDataPointEventHandler | undefined>;
     /**
      * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.onDataPointsSelected}
      *

package/dist/src/helpers/component-translator.d.ts

@@ -0,0 +1,64 @@
+import { type PreactNode } from '@sisense/sdk-ui-preact';
+import { type Component, type DefineComponent } from 'vue';
+import { type VueComponentAdapterContexts } from './vue-component-adapter';
+/**
+ * A preact component. Its render output matches the preact-facing component interfaces, so a
+ * component produced by {@link ComponentTranslator.toPreactComponent} can be handed to any of them
+ * (custom widget map, dashboard header item, ...).
+ *
+ * @internal
+ */
+export type PreactComponent<Props> = (props: Props) => PreactNode;
+/**
+ * A Vue component: a component options object, a `defineComponent` result, or any valid Vue
+ * component.
+ *
+ * @internal
+ */
+export type VueComponent<Props> = Component<Props> | DefineComponent<Props>;
+type AnyObject = Record<string, any>;
+/**
+ * Translates components between Vue and preact in both directions.
+ *
+ * Shared infrastructure for features that let consumers pass a native Vue component into an
+ * otherwise preact-facing interface — custom widgets and dashboard header items today, widget and
+ * filter-tile headers in the future — and that hand preact components back to consumers, where
+ * every component is exposed as a real Vue component.
+ *
+ * The two methods are inverses of each other, and translation is stable: the same input always
+ * yields the same output instance, so the renderer sees a constant component identity across
+ * re-renders (no unmount/remount) and consumers get back the very component they passed in.
+ * Translating a wrapper back always unwraps it, so a component never gets wrapped twice.
+ *
+ * The translator owns no live component instances: it produces components and adapter *factories*,
+ * and each adapter is created and destroyed by the wrapper that mounts it. Both registries are
+ * keyed weakly, so nothing has to be released explicitly when the host component unmounts.
+ *
+ * @internal
+ */
+export type ComponentTranslator = ReturnType<typeof createComponentTranslator>;
+/**
+ * Creates a {@link ComponentTranslator}.
+ *
+ * @param contexts - Parent contexts provided to each Vue component adapted for preact, captured in
+ * the host component's `setup`.
+ * @internal
+ */
+export declare function createComponentTranslator(contexts: VueComponentAdapterContexts): {
+    /**
+     * Translates a Vue component into a preact component.
+     *
+     * A Vue wrapper produced by {@link fromPreactComponent} is unwrapped back to the preact
+     * component it renders, rather than being wrapped a second time.
+     */
+    toPreactComponent: <Props extends AnyObject>(component: VueComponent<Props>) => PreactComponent<Props>;
+    /**
+     * Translates a preact component into a Vue component.
+     *
+     * A preact wrapper produced by {@link toPreactComponent} is unwrapped back to the Vue component
+     * it renders; any other preact component is wrapped in a generated Vue component that renders
+     * it, so consumers can render it in a Vue template like any other component.
+     */
+    fromPreactComponent: <Props_1 extends AnyObject>(component: PreactComponent<Props_1>) => VueComponent<Props_1>;
+};
+export {};

package/dist/src/helpers/dashboard-props-preact-translator.d.ts

@@ -0,0 +1,33 @@
+import type { DashboardByIdProps as DashboardByIdPropsPreact, DashboardProps as DashboardPropsPreact } from '@sisense/sdk-ui-preact';
+import type { DashboardProps } from '../components/dashboard/dashboard';
+import type { DashboardByIdProps } from '../components/dashboard/dashboard-by-id';
+import type { ComponentTranslator } from './component-translator';
+/**
+ * Converts Vue `Dashboard` props into the preact props rendered by the underlying component.
+ *
+ * The object structure is always translated — for Vue that is the `config.header` section, whose
+ * shape matches preact's apart from the flavor of the components it carries.
+ *
+ * `componentTranslator` additionally converts the components carried in the props (today the custom
+ * `config.header` items) into preact components. Pass it whenever the result will be **rendered**.
+ * Omit it for pure props manipulation — filter helpers, dashboard model translation, prop
+ * composition — where the components are never rendered and are carried through as they are.
+ */
+export declare function toPreactDashboardProps(vueProps: DashboardProps, componentTranslator?: ComponentTranslator): DashboardPropsPreact;
+/**
+ * Converts preact `Dashboard` props into Vue props.
+ *
+ * `componentTranslator` additionally resolves the components carried in the props back to the Vue
+ * components they wrap. Omit it for pure props manipulation, where the components are carried
+ * through as they are.
+ */
+export declare function toDashboardProps(preactProps: DashboardPropsPreact, componentTranslator?: ComponentTranslator): DashboardProps;
+/**
+ * Converts Vue `DashboardById` props into the preact props rendered by the underlying component.
+ *
+ * Behaves like {@link toPreactDashboardProps}: the structure is always translated, and
+ * `componentTranslator` additionally converts the components carried in `config.header`.
+ */
+export declare function toPreactDashboardByIdProps(vueProps: DashboardByIdProps, componentTranslator?: ComponentTranslator): DashboardByIdPropsPreact;
+/** Mirror of {@link toPreactDashboardByIdProps} for the preact -> Vue direction. */
+export declare function toDashboardByIdProps(preactProps: DashboardByIdPropsPreact, componentTranslator?: ComponentTranslator): DashboardByIdProps;

package/dist/src/helpers/setup-helper.d.ts

@@ -6,9 +6,18 @@ export declare function toDeepRaw<T>(data: T): T;
 /**
  * Renders a component without children.
  *
+ * `props` is either the component's reactive props object, or a getter returning the props to
+ * render. Use a getter when the Vue-flavored props need converting into the preact props shape
+ * (e.g. converting Vue components carried in props into preact components): it is called on every
+ * render, so prop updates keep flowing through Vue's reactivity. Converting once before calling
+ * this helper would instead snapshot the props at `setup` time and freeze them.
+ *
+ * A props object is unwrapped with {@link toDeepRaw} before rendering; a getter owns that step, so
+ * it can convert the already-unwrapped props.
+ *
  * @internal
  */
-export declare const setupHelper: <C extends AnyComponentFunction>(component: C, props: Parameters<C>[0], contextConnectors?: ContextConnector<any>[]) => (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+export declare const setupHelper: <C extends AnyComponentFunction>(component: C, props: Parameters<C>[0] | (() => Parameters<C>[0]), contextConnectors?: ContextConnector<any>[]) => (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>) | null;
 /**

package/dist/src/helpers/vue-component-adapter.d.ts

@@ -1,7 +1,18 @@
-import type { CompleteThemeSettingsInternal, CustomSisenseContext } from '@sisense/sdk-ui-preact';
-import type { ExternalComponentAdapter } from '@sisense/sdk-ui-preact';
+import { type CompleteThemeSettingsInternal, type CustomSisenseContext, type CustomWidgetsContextAdapter, type ExternalComponentAdapter } from '@sisense/sdk-ui-preact';
 import { type Component, type DefineComponent, type Ref } from 'vue';
 type AnyObject = Record<string, any>;
+/**
+ * Parent Vue contexts captured when an adapter is created and provided to the adapted component's
+ * isolated Vue app, so it resolves Sisense, theme, and custom-widget context the same way it
+ * would inside the host application tree.
+ *
+ * @internal
+ */
+export type VueComponentAdapterContexts = {
+    sisenseContext: Ref<CustomSisenseContext>;
+    themeContext: Ref<CompleteThemeSettingsInternal>;
+    customWidgetsContext: Ref<CustomWidgetsContextAdapter>;
+};
 /**
  * Adapter class that manages the lifecycle of a Vue component
  * rendered within a Preact context. This provides efficient updates
@@ -20,11 +31,7 @@ export declare class VueComponentAdapter<Props extends AnyObject> implements Ext
     private container;
     private isDestroyed;
     private propsRef;
-    constructor(componentClass: Component<Props> | DefineComponent<Props>, contexts: {
-        sisenseContext: Ref<CustomSisenseContext>;
-        themeContext: Ref<CompleteThemeSettingsInternal>;
-        customWidgetsContext: Ref<any>;
-    });
+    constructor(componentClass: Component<Props> | DefineComponent<Props>, contexts: VueComponentAdapterContexts);
     /**
      * Mounts the Vue component into the container element.
      * This should only be called once when the Preact wrapper mounts.

package/dist/src/sdk-ui-core-exports.d.ts

@@ -1,2 +1,3 @@
 export { boxWhiskerProcessResult, extractDimensionsAndMeasures, formatNumber, formatDate, getDefaultDateFormat, formatDataSet, } from '@sisense/sdk-ui-preact';
-export type { ChartType, CartesianChartType, CategoricalChartType, ScatterChartType, IndicatorChartType, BoxplotChartType, CalendarHeatmapChartType, ScattermapChartType, AreamapChartType, TableType, AreaSubtype, LineSubtype, PieSubtype, PolarSubtype, StackableSubtype, BoxplotSubtype, CalendarHeatmapSubtype, WidgetType, CartesianWidgetType, CategoricalWidgetType, TabularWidgetType, ExecuteQueryByWidgetIdParams, ExecuteQueryParams, GetWidgetModelParams, GetSharedFormulaParams, GetDashboardModelParams, UseGetSharedFormulaParams, GetDashboardModelsParams, GetHierarchyModelsParams, CommonDataOptions, FormatDateOptions, FormatDataSetOptions, ChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ScatterChartDataOptions, IndicatorChartDataOptions, BoxplotChartDataOptions, BoxplotChartCustomDataOptions, CalendarHeatmapChartDataOptions, ScattermapChartDataOptions, AreamapChartDataOptions, TableDataOptions, PivotTableDataOptions, WidgetDataOptions, NumberFormatConfig, DecimalScale, DataColorCondition, ConditionalDataColorOptions, DataColorOptions, RangeDataColorOptions, UniformDataColorOptions, ValueToColorMap, MultiColumnValueToColorMap, SortDirection, BoxWhiskerType, ScattermapLocationLevel, StyledColumn, StyledMeasureColumn, PivotRowsSort, DataOptionLocation, ChartStyleOptions, LineStyleOptions, AreaStyleOptions, StackableStyleOptions, PieStyleOptions, FunnelStyleOptions, PolarStyleOptions, IndicatorStyleOptions, NumericSimpleIndicatorStyleOptions, NumericBarIndicatorStyleOptions, GaugeIndicatorStyleOptions, ScatterStyleOptions, TreemapStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, BoxplotStyleOptions, CalendarHeatmapStyleOptions, ScattermapStyleOptions, AreamapStyleOptions, ChartWidgetStyleOptions, WidgetStyleOptions, WidgetByIdStyleOptions, TableStyleOptions, PivotTableStyleOptions, AreaRangeStyleOptions, DataLimits, Legend, Markers, Labels, IndicatorComponents, ScatterMarkerSize, LineWidth, LineOptions, DashStyle, EndCapType, AxisLabel, Convolution, SeriesLabels, X2Title, ScattermapMarkers, CalendarHeatmapViewType, WidgetModel, DashboardModel, BeforeRenderHandler, DataPoint, ScatterDataPoint, HighchartsOptions, BoxplotDataPoint, CalendarHeatmapDataPoint, CalendarDayOfWeek, IndicatorBeforeRenderHandler, IndicatorRenderOptions, DashboardLayoutOptions, WidgetsPanelLayout, WidgetsPanelColumnLayout, WidgetId, WidgetsOptions, WidgetConfig, WidgetNarrativeConfig, WidgetNarrativeDisplayLocation, AppConfig, DateConfig, MenuItemSection, MonthOfYear, DayOfWeek, DateLevel, ThemeOid, GetDashboardModelOptions, GetDashboardModelsOptions, SeriesChartType, MenuPosition, ThemeSettings, Color, ColorPaletteTheme, Navigator, DrilldownOptions, DrilldownSelection, PivotTableDrilldownOptions, PivotTableSelectableDrilldownOptions, PivotTableNonSelectableDrilldownOptions, Member, FilterVariant, FilterWidgetProps, FilterWidgetFilterType, TranslationConfig, Plugin, } from '@sisense/sdk-ui-preact';
+export { WidgetHeaderMenuTargets } from '@sisense/sdk-ui-preact';
+export type { ChartType, CartesianChartType, CategoricalChartType, ScatterChartType, IndicatorChartType, BoxplotChartType, CalendarHeatmapChartType, ScattermapChartType, AreamapChartType, SankeyChartType, TableType, AreaSubtype, LineSubtype, PieSubtype, PolarSubtype, StackableSubtype, BoxplotSubtype, CalendarHeatmapSubtype, WidgetType, CartesianWidgetType, CategoricalWidgetType, TabularWidgetType, ExecuteQueryByWidgetIdParams, ExecuteQueryParams, GetWidgetModelParams, GetSharedFormulaParams, GetDashboardModelParams, UseGetSharedFormulaParams, GetDashboardModelsParams, GetHierarchyModelsParams, CommonDataOptions, FormatDateOptions, FormatDataSetOptions, ChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ScatterChartDataOptions, IndicatorChartDataOptions, BoxplotChartDataOptions, BoxplotChartCustomDataOptions, CalendarHeatmapChartDataOptions, ScattermapChartDataOptions, AreamapChartDataOptions, SankeyChartDataOptions, TableDataOptions, PivotTableDataOptions, WidgetDataOptions, NumberFormatConfig, DecimalScale, DataColorCondition, ConditionalDataColorOptions, DataColorOptions, RangeDataColorOptions, UniformDataColorOptions, ValueToColorMap, MultiColumnValueToColorMap, SortDirection, BoxWhiskerType, ScattermapLocationLevel, StyledColumn, StyledMeasureColumn, PivotRowsSort, DataOptionLocation, ChartStyleOptions, LineStyleOptions, AreaStyleOptions, StackableStyleOptions, PieStyleOptions, FunnelStyleOptions, PolarStyleOptions, IndicatorStyleOptions, NumericSimpleIndicatorStyleOptions, NumericBarIndicatorStyleOptions, GaugeIndicatorStyleOptions, ScatterStyleOptions, TreemapStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, BoxplotStyleOptions, CalendarHeatmapStyleOptions, ScattermapStyleOptions, AreamapStyleOptions, SankeyStyleOptions, ChartWidgetStyleOptions, WidgetStyleOptions, WidgetByIdStyleOptions, TableStyleOptions, PivotTableStyleOptions, AreaRangeStyleOptions, DataLimits, Legend, Markers, Labels, IndicatorComponents, ScatterMarkerSize, LineWidth, LineOptions, DashStyle, EndCapType, AxisLabel, Convolution, SeriesLabels, X2Title, ScattermapMarkers, CalendarHeatmapViewType, WidgetModel, DashboardModel, BeforeRenderHandler, DataPoint, ScatterDataPoint, HighchartsOptions, BoxplotDataPoint, CalendarHeatmapDataPoint, CalendarDayOfWeek, IndicatorBeforeRenderHandler, IndicatorRenderOptions, DashboardLayoutOptions, WidgetsPanelLayout, WidgetsPanelColumnLayout, WidgetId, WidgetsOptions, WidgetConfig, WidgetHeaderConfig, WidgetHeaderMenuActionItem, WidgetHeaderMenuConfig, WidgetHeaderMenuItem, WidgetHeaderMenuSubmenuItem, WidgetHeaderMenuTarget, WidgetNarrativeConfig, WidgetNarrativeDisplayLocation, AppConfig, DateConfig, MenuItemSection, MonthOfYear, DayOfWeek, DateLevel, ThemeOid, GetDashboardModelOptions, GetDashboardModelsOptions, SeriesChartType, MenuPosition, ThemeSettings, Color, ColorPaletteTheme, Navigator, DrilldownOptions, DrilldownSelection, PivotTableDrilldownOptions, PivotTableSelectableDrilldownOptions, PivotTableNonSelectableDrilldownOptions, Member, FilterVariant, FilterWidgetProps, FilterWidgetFilterType, TranslationConfig, Plugin, } from '@sisense/sdk-ui-preact';

package/dist/src/utilities/dashboard-helpers.d.ts

@@ -1,5 +1,10 @@
 import type { Filter, FilterRelations } from '@sisense/sdk-data';
 import type { DashboardProps } from '../components/dashboard';
+/**
+ * The helpers below manipulate props and never render them, so they convert the object structure
+ * only — passing no component translator, which carries the components in `config.header` through
+ * as they are.
+ */
 /**
  * {@inheritDoc @sisense/sdk-ui!dashboardHelpers.replaceFilters}
  *