@sisense/sdk-ui 2.29.0 → 2.31.0

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

@@ -0,0 +1,94 @@
+import type { FunnelSeriesLabels, PieSeriesLabels, SeriesLabelsBase } from '../../../../../types';
+/** Fusion funnel/pie `style.labels` including value-label formatting fields. */
+export type CategoricalFusionLabels = {
+    enabled: boolean;
+    categories: boolean;
+    percent: boolean;
+    value: boolean;
+    decimals: boolean;
+    rotation?: number;
+    customRotation?: number | null;
+    prefix?: string;
+    suffix?: string;
+    backgroundColor?: string | null;
+    backgroundPadding?: number | null;
+    borderColor?: string | null;
+    borderWidth?: number | null;
+    borderRadius?: number | null;
+    xOffset?: number | null;
+    yOffset?: number | null;
+};
+export type CategoricalFusionLabelsDto = {
+    enabled: boolean;
+    categories: boolean;
+    percent: boolean;
+    value: boolean;
+    decimals: boolean;
+    rotation: number;
+    customRotation: number | null;
+    prefix: string;
+    suffix: string;
+    backgroundColor: string | null;
+    backgroundPadding: number;
+    borderColor: string | null;
+    borderWidth: number;
+    borderRadius: number;
+    xOffset: number;
+    yOffset: number;
+};
+/**
+ * Resolves effective label rotation from Fusion DTO (customRotation overrides preset).
+ *
+ * @param labels - Fusion categorical labels DTO fragment
+ * @returns Effective rotation in degrees
+ * @internal
+ */
+export declare function getFusionCategoricalLabelsRotation(labels: CategoricalFusionLabels): number;
+/**
+ * Maps Fusion label formatting fields to CSDK seriesLabels styling props.
+ *
+ * @param labels - Fusion categorical labels DTO fragment
+ * @returns Partial series label styling props derived from Fusion formatting fields
+ * @internal
+ */
+export declare function extractCategoricalLabelFormatting(labels: CategoricalFusionLabels): Pick<SeriesLabelsBase, 'rotation' | 'prefix' | 'suffix' | 'backgroundColor' | 'padding' | 'borderColor' | 'borderWidth' | 'borderRadius' | 'xOffset' | 'yOffset'>;
+/**
+ * Builds CSDK pie series labels from Fusion funnel/pie `style.labels`.
+ *
+ * @param labels - Fusion categorical labels DTO
+ * @returns Pie series labels configuration
+ * @internal
+ */
+export declare function buildPieSeriesLabelsFromFusionLabels(labels: CategoricalFusionLabels): PieSeriesLabels;
+/**
+ * Builds CSDK funnel series labels from Fusion funnel/pie `style.labels`.
+ *
+ * @param labels - Fusion categorical labels DTO
+ * @returns Funnel series labels configuration
+ * @internal
+ */
+export declare function buildFunnelSeriesLabelsFromFusionLabels(labels: CategoricalFusionLabels): FunnelSeriesLabels;
+type CategoricalSeriesLabels = PieSeriesLabels | FunnelSeriesLabels;
+export declare const DEFAULT_CATEGORICAL_FUSION_LABEL_FORMATTING: {
+    readonly rotation: 0;
+    readonly customRotation: null;
+    readonly prefix: "";
+    readonly suffix: "";
+    readonly backgroundColor: null;
+    readonly backgroundPadding: 2;
+    readonly borderColor: null;
+    readonly borderWidth: 1;
+    readonly borderRadius: 0;
+    readonly xOffset: 0;
+    readonly yOffset: 0;
+};
+/**
+ * Maps CSDK seriesLabels back to Fusion funnel/pie `style.labels` DTO.
+ *
+ * @param labels - Partial Fusion categorical labels DTO fragment, if any
+ * @param seriesLabels - CSDK pie or funnel series label options
+ * @returns Fusion categorical labels DTO with formatting defaults applied
+ * @internal
+ */
+export declare function toFusionCategoricalLabelsFromSeriesLabels(labels: Partial<CategoricalFusionLabels> | undefined, seriesLabels: CategoricalSeriesLabels | undefined): CategoricalFusionLabelsDto;
+export {};

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

@@ -2,3 +2,4 @@ export * from './apply-partial-dto-style.js';
 export * from './extract-unsupported-style-options.js';
 export * from './translate-widget-style-options.js';
 export * from './to-widget-dto-style.js';
+export * from './widget-narrative-style.js';

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/translate-widget-style-options/series-label-affix-style.d.ts

@@ -0,0 +1,59 @@
+import type { SeriesLabelsBase } from '../../../../../types';
+/** Fusion widget `seriesLabels` / categorical `labels` affix formatting fields. */
+export type FusionSeriesLabelAffix = {
+    prefix?: string;
+    suffix?: string;
+    backgroundColor?: string | null;
+    backgroundPadding?: number | null;
+    borderColor?: string | null;
+    borderWidth?: number | null;
+    borderRadius?: number | null;
+    xOffset?: number | null;
+    yOffset?: number | null;
+};
+type PublicSeriesLabelAffix = Pick<SeriesLabelsBase, 'prefix' | 'suffix' | 'backgroundColor' | 'padding' | 'borderColor' | 'borderWidth' | 'borderRadius' | 'xOffset' | 'yOffset'>;
+/**
+ * Clearable affix fields used during Fusion → StyleOptions translation.
+ * `null` means an explicit reset; normalized away before public StyleOptions.
+ *
+ * @internal
+ */
+export type InternalSeriesLabelAffix = {
+    [K in keyof PublicSeriesLabelAffix]?: PublicSeriesLabelAffix[K] | null;
+};
+type SeriesLabelColor = NonNullable<SeriesLabelsBase['backgroundColor']>;
+/**
+ * Maps internal affix fields (which may carry explicit `null` clears) to public
+ * StyleOptions fields. Cleared values are omitted from the public shape.
+ *
+ * @param affix - Internal affix fragment, possibly containing explicit clears
+ * @returns Public series label affix fields safe for StyleOptions
+ * @internal
+ */
+export declare function toPublicSeriesLabelAffixFields(affix: Partial<InternalSeriesLabelAffix>): Partial<PublicSeriesLabelAffix>;
+/**
+ * Maps CSDK series label color to Fusion string color; gradients and `auto` are not supported.
+ *
+ * @param color - CSDK series label color value
+ * @returns Fusion-compatible color string, or `undefined` when not representable
+ * @internal
+ */
+export declare const toFusionSeriesLabelColor: (color: SeriesLabelColor | string | null | undefined) => string | null | undefined;
+/**
+ * Maps Fusion series label affix fields to internal CSDK affix props.
+ * Each field is mapped independently so pie/funnel and cartesian charts share the same rules.
+ *
+ * @param labels - Fusion series label affix fragment
+ * @returns Partial internal affix props; may include explicit `null` clears
+ * @internal
+ */
+export declare function extractSeriesLabelAffixFromFusion(labels: FusionSeriesLabelAffix): Partial<InternalSeriesLabelAffix>;
+/**
+ * Maps CSDK seriesLabels affix fields to a Fusion DTO fragment.
+ *
+ * @param seriesLabels - CSDK series label affix fields
+ * @returns Fusion series label affix fragment
+ * @internal
+ */
+export declare function toFusionSeriesLabelAffixFromSdk(seriesLabels: Partial<PublicSeriesLabelAffix> | undefined): FusionSeriesLabelAffix;
+export {};

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

@@ -1,4 +1,4 @@
-import { TabberButtonsWidgetStyleOptions } from '../../../../../types.js';
+import { TabberButtonsWidgetCustomOptions, TabberButtonsWidgetStyleOptions } from '../../../../../types.js';
 import { TabberWidgetDto, TabberWidgetDtoStyle } from '../types.js';
 /**
  * Extracts style options from TabberWidgetDtoStyle.
@@ -21,3 +21,19 @@ export declare function extractTabberButtonsWidgetCustomOptions(tabberDto: Tabbe
     tabNames: string[];
     activeTab: number;
 };
+/**
+ * Builds the tabber DTO style from CSDK tabber style and custom options.
+ * Inverse of {@link extractTabberButtonsWidgetStyleOptions} and
+ * {@link extractTabberButtonsWidgetCustomOptions}: re-encodes the lowercase enum
+ * values back to uppercase, reconstructs the `useSelectedBkg`/`useUnselectedBkg`
+ * flags from the presence of the corresponding background colors, and
+ * re-materializes `tabs`/`activeTab` from the custom options.
+ *
+ * Note: `displayWidgetIds`/`hideWidgetIds` are not represented in the CSDK
+ * widget model, so the re-materialized tabs carry empty id lists.
+ *
+ * @param styleOptions - The tabber style options from WidgetModel.styleOptions
+ * @param customOptions - The tabber custom options from WidgetModel.customOptions
+ * @returns The tabber widget style for the DTO
+ */
+export declare function toTabberWidgetStyle(styleOptions: TabberButtonsWidgetStyleOptions, customOptions: TabberButtonsWidgetCustomOptions): TabberWidgetDtoStyle;

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

@@ -1,7 +1,7 @@
 import type { PivotGrandTotals } from '@sisense/sdk-data';
 import type { BoxWhiskerType } from '../../../../../domains/visualizations/core/chart-data-options/types.js';
 import { AppSettings } from '../../../../../infra/app/settings/settings.js';
-import type { AreamapType, AreaStyleOptions, AxisLabel, BoxplotStyleOptions, CalendarHeatmapStyleOptions, CompleteThemeSettingsInternal, DataLimits, FunnelStyleOptions, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, ScattermapStyleOptions, ScatterStyleOptions, SeriesLabels, StackableStyleOptions, SunburstStyleOptions, TableStyleOptions, TreemapStyleOptions, WidgetStyleOptions } from '../../../../../types.js';
+import type { AreamapType, AreaStyleOptions, AxisLabel, BoxplotStyleOptions, CalendarHeatmapStyleOptions, CompleteThemeSettingsInternal, DataLimits, FunnelStyleOptions, IndicatorStyleOptions, LegendOptions, LineOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, ScattermapStyleOptions, ScatterStyleOptions, SeriesLabels, StackableStyleOptions, SunburstStyleOptions, TableStyleOptions, TreemapStyleOptions, WidgetStyleOptions } from '../../../../../types.js';
 import type { AxisStyle, BoxplotWidgetStyle, CalendarHeatmapWidgetStyle, CartesianWidgetStyle, FunnelWidgetStyle, PivotWidgetStyle, PolarWidgetStyle, ScattermapWidgetStyle, ScatterWidgetStyle, SunburstWidgetStyle, TableWidgetStyle, TreemapWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
 /**
  * Maps SDK legend options to Fusion DTO legend style.
@@ -42,6 +42,18 @@ export type LineWidthToken = (typeof LINE_WIDTH_TOKENS)[number];
 export declare function toLineWidthStyle(lineWidth?: LineWidth | {
     width?: string | number;
 }): CartesianWidgetStyle['lineWidth'];
+/**
+ * Maps CSDK line.width (px) to Fusion lineWidth.customWidth on DTO.
+ *
+ * @internal
+ */
+export declare function toLineCustomWidthStyle(line?: LineOptions): number | undefined;
+/**
+ * Maps SDK line dash options to Fusion DTO line style.
+ *
+ * @internal
+ */
+export declare function toLineDashStyle(line?: LineOptions): CartesianWidgetStyle['line'];
 /**
  * Maps SDK markers options to Fusion DTO markers style.
  *

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

@@ -0,0 +1,31 @@
+import type { WidgetNarrativeConfig } from '../../../../../domains/narrative/core/widget-narrative-config';
+import type { WidgetDtoNarration, WidgetStyle } from '../../../../../domains/widgets/components/widget-by-id/types.js';
+/**
+ * Maps Fusion `style.narration` into SDK {@link WidgetNarrativeConfig},
+ * including `feedback` when present on the DTO.
+ *
+ * Reads boolean `autoShow`; legacy string `displayMode` (`onLoad` / `onClick`) is still accepted for
+ * older payloads when `autoShow` is absent.
+ *
+ * @param dto - Fusion narration payload, if any
+ * @returns Partial narrative options, or `undefined` when absent or empty
+ * @internal
+ */
+export declare function extractWidgetNarrativeConfigFromDto(dto: WidgetDtoNarration | undefined): WidgetNarrativeConfig | undefined;
+/**
+ * Builds Fusion `style.narration` from SDK {@link WidgetNarrativeConfig} only (typed fields).
+ *
+ * @param narrative - SDK narrative slice from {@link WidgetConfig.narrative}
+ * @returns Narration DTO, or `undefined` when nothing should be written
+ * @internal
+ */
+export declare function narrativeConfigToWidgetDtoNarration(narrative: WidgetNarrativeConfig | undefined): WidgetDtoNarration | undefined;
+/**
+ * Merges narrative options onto a Fusion widget `style` object for {@link toWidgetDto}.
+ *
+ * @param baseStyle - Chart or pivot style object without narration
+ * @param narrative - SDK narrative from {@link WidgetModel.config}
+ * @returns `WidgetStyle` with narration merged, or base style unchanged when narrative is absent
+ * @internal
+ */
+export declare function mergeWidgetStyleWithNarrativeForDto(baseStyle: WidgetStyle, narrative: WidgetNarrativeConfig | undefined): WidgetStyle;

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

@@ -1,6 +1,6 @@
 import { BaseJaql, FormulaContext, FormulaJaql, Jaql, JaqlDataSource, JaqlSortDirection } from '@sisense/sdk-data';
 import { JtdConfigDto } from '../../../../domains/dashboarding/hooks/jtd/jtd-types';
-import { WidgetContainerStyleOptions } from '../../../../types';
+import { DashStyle, WidgetContainerStyleOptions } from '../../../../types';
 import { HierarchyId } from '../../../../domains/drilldown/hierarchy-model';
 import { LEGACY_DESIGN_TYPES } from '../../../../infra/themes/legacy-design-settings';
 /**
@@ -322,6 +322,26 @@ export type PanelColorFormatConditionOperator = '<' | '>' | '≤' | '<=' | '≥'
 type LabelsStyle = {
     enabled: boolean;
     rotation: number;
+    /** Custom rotation in degrees from Fusion design panel. Overrides rotation when set. */
+    customRotation?: number | null;
+    /** Text prepended to each value label. */
+    prefix?: string;
+    /** Text appended to each value label. */
+    suffix?: string;
+    /** Background color behind each value label. */
+    backgroundColor?: string | null;
+    /** Padding in pixels around value label text when background color is set. */
+    backgroundPadding?: number | null;
+    /** Border color around each value label. */
+    borderColor?: string | null;
+    /** Border width in pixels when border color is set. */
+    borderWidth?: number | null;
+    /** Border radius in pixels when border color is set. */
+    borderRadius?: number | null;
+    /** Horizontal offset of value labels in pixels. */
+    xOffset?: number | null;
+    /** Vertical offset of value labels in pixels. */
+    yOffset?: number | null;
     /**
      * @internal
      */
@@ -377,6 +397,17 @@ export type CartesianWidgetStyle = BaseWidgetStyle & WidgetContainerStyleOptions
     y2Axis?: AxisStyle;
     lineWidth?: {
         width: string;
+        /** Custom line width in px from Fusion design panel. Overrides width when > 0. */
+        customWidth?: number | null;
+    };
+    /** CSDK-compatible line stroke options (e.g. dashStyle, width from styleOptions.line). */
+    line?: {
+        dashStyle?: DashStyle;
+        width?: number;
+    };
+    /** Fusion design-panel dash style token (`lineType`). Maps to CSDK `line.dashStyle`; not curve line type (straight/smooth). */
+    lineStyle?: {
+        lineType?: string;
     };
     markers?: {
         enabled: boolean;
@@ -413,6 +444,17 @@ export type FunnelWidgetStyle = BaseWidgetStyle & WidgetContainerStyleOptions &
         percent: boolean;
         value: boolean;
         decimals: boolean;
+        rotation?: number;
+        customRotation?: number | null;
+        prefix?: string;
+        suffix?: string;
+        backgroundColor?: string | null;
+        backgroundPadding?: number | null;
+        borderColor?: string | null;
+        borderWidth?: number | null;
+        borderRadius?: number | null;
+        xOffset?: number | null;
+        yOffset?: number | null;
     };
 };
 export type PieWidgetStyle = BaseWidgetStyle & WidgetContainerStyleOptions & {
@@ -422,6 +464,17 @@ export type PieWidgetStyle = BaseWidgetStyle & WidgetContainerStyleOptions & {
         percent: boolean;
         value: boolean;
         decimals: boolean;
+        rotation?: number;
+        customRotation?: number | null;
+        prefix?: string;
+        suffix?: string;
+        backgroundColor?: string | null;
+        backgroundPadding?: number | null;
+        borderColor?: string | null;
+        borderWidth?: number | null;
+        borderRadius?: number | null;
+        xOffset?: number | null;
+        yOffset?: number | null;
     };
     dataLimits?: DataLimits;
     convolution?: {
@@ -439,6 +492,24 @@ export type TableWidgetStyle = {
     'width/content': boolean;
     'width/window': boolean;
     pageSize: number;
+    /**
+     * Live table UI state written by Fusion's table widget. `colResize.columns` is the
+     * authoritative source of on-screen column widths — unlike `panels.items[].colSize`
+     * (a write-once snapshot that goes stale once a column is disabled/re-enabled), it's
+     * kept in sync with the table's currently visible columns.
+     */
+    tableState?: {
+        colResize?: {
+            /** Pixel widths (e.g. `'84.3906px'`), one per visible column, in display order. */
+            columns: string[];
+            /**
+             * Total table width in pixels at resize time. Fusion renders each column as
+             * `(columnPx / sum(columns)) × tableSize`, so this must stay in sync with the
+             * sum of `columns` for absolute pixel rendering.
+             */
+            tableSize?: number;
+        };
+    };
 };
 export type IndicatorWidgetStyle = WidgetContainerStyleOptions & {
     'indicator/gauge': {
@@ -568,9 +639,38 @@ export type CalendarHeatmapWidgetStyle = {
         month: number;
     };
 };
+/**
+ * Fusion `style.narration` payload (chart widgets and others that support narration).
+ *
+ * @internal
+ */
+export type WidgetDtoNarration = {
+    enabled?: boolean;
+    /** Placement string from Fusion; maps to SDK `displayLocation`. */
+    display?: string;
+    format?: string;
+    verbosity?: string;
+    up_sentiment?: string;
+    aggregation?: string;
+    labels?: readonly {
+        id: string;
+        title: string;
+        singular: string;
+        plural: string;
+    }[];
+    includeTrendAndForecast?: boolean;
+    /** When `true`, narrative is shown as soon as the widget loads */
+    autoShow?: boolean;
+    /** Narrative feedback actions */
+    feedback?: {
+        enabled?: boolean;
+    };
+    /** Fraction (0–1) of the content area height reserved for the narrative; maps to SDK `height`. */
+    size?: number;
+};
 export type WidgetStyle = {
     widgetDesign?: WidgetDesign;
-    narration?: any;
+    narration?: WidgetDtoNarration;
 } & (CartesianWidgetStyle | PolarWidgetStyle | FunnelWidgetStyle | PieWidgetStyle | ScatterWidgetStyle | TableWidgetStyle | IndicatorWidgetStyle | TreemapWidgetStyle | SunburstWidgetStyle | BoxplotWidgetStyle | ScattermapWidgetStyle | AreamapWidgetStyle | PivotWidgetStyle | CalendarHeatmapWidgetStyle | TextWidgetDtoStyle | TabberWidgetDtoStyle);
 export declare enum FiltersMergeStrategyEnum {
     WIDGET_FIRST = "widgetFirst",

package/dist/packages/sdk-ui/src/domains/widgets/helpers/excel-export-map-dimensions-measures.d.ts

@@ -1,4 +1,10 @@
-import { type Attribute, type Measure } from '@sisense/sdk-data';
+import { type Attribute, type CalculatedMeasureColumn, type Measure, type MeasureColumn } from '@sisense/sdk-data';
+import type { StyledMeasureColumn } from '../../../domains/visualizations/core/chart-data-options/types.js';
+import type { NumberFormatConfig } from '../../../types';
+export type MeasureWithExcelExportFormat = Measure & {
+    readonly excelNumberFormatConfig?: NumberFormatConfig;
+};
+type MeasureColumnInput = MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
 /**
  * Returns attributes prepared for Excel JAQL export: dimensional level attributes without an
  * explicit display format receive a level-appropriate default so the backend renders human-readable
@@ -15,4 +21,13 @@ export declare function mapAttributesForExcelExport(attributes: readonly Attribu
  * @param measures - Raw measures from chart or pivot translation
  * @returns New array of measures safe to pass as export measures
  */
-export declare function mapMeasuresForExcelExport(measures: readonly Measure[]): Measure[];
+export declare function mapMeasuresForExcelExport(measures: readonly Measure[]): MeasureWithExcelExportFormat[];
+/**
+ * Maps a styled measure column to a measure for Excel export, preserving `numberFormatConfig`.
+ */
+export declare function mapMeasureColumnForExcelExport(column: MeasureColumnInput): MeasureWithExcelExportFormat;
+/**
+ * Maps measure columns to measures for Excel export, preserving per-column `numberFormatConfig`.
+ */
+export declare function mapMeasureColumnsForExcelExport(columns: readonly MeasureColumnInput[]): MeasureWithExcelExportFormat[];
+export {};

package/dist/packages/sdk-ui/src/domains/widgets/helpers/number-format-config-to-numeric-mask.d.ts

@@ -0,0 +1,5 @@
+import type { NumberFormatConfig } from '../../../types';
+/**
+ * Converts Compose {@link NumberFormatConfig} to a Fusion numeric mask for XLSX export metadata.
+ */
+export declare function numberFormatConfigToNumericMask(config: NumberFormatConfig): Record<string, unknown>;

package/dist/packages/sdk-ui/src/domains/widgets/shared/widget-container/widget-container.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import { type ReactNode, type RefObject } from 'react';
 import { WidgetContainerStyleOptions } from '../../../../types';
 import { TitleEditorConfig, WidgetHeaderConfig } from '../widget-header/types.js';
 export interface WidgetContainerProps {
@@ -16,6 +16,12 @@ export interface WidgetContainerProps {
     bottomSlot?: ReactNode;
     children: ReactNode;
     onRefresh?: () => void;
+    /**
+     * Ref attached to the content area below the header (topSlot + chart + bottomSlot).
+     * Use to measure the available height for narrative-to-chart ratio calculations.
+     * @internal
+     */
+    contentAreaRef?: RefObject<HTMLDivElement | null>;
 }
 /** @internal */
 export declare const WidgetContainer: React.FC<WidgetContainerProps>;

package/dist/packages/sdk-ui/src/domains/widgets/widget-model/widget-model.d.ts

@@ -1,9 +1,9 @@
 import { DataSource, Filter } from '@sisense/sdk-data';
-import { EmptyObject } from '@sisense/sdk-query-client/src/helpers/utility-types';
 import type { JumpToDashboardConfig, JumpToDashboardConfigForPivot } from '../../../domains/dashboarding/hooks/jtd/jtd-types';
 import { ChartDataOptions, PivotTableDataOptions } from '../../../domains/visualizations/core/chart-data-options/types';
+import { EmptyObject } from '../../../shared/utils/utility-types';
 import { ChartType, DrilldownOptions, PivotTableDrilldownOptions, WidgetStyleOptions } from '../../../types';
-import type { WidgetType } from '../components/widget/types';
+import type { WidgetConfig, WidgetType } from '../components/widget/types';
 /**
  * Widget data options.
  */
@@ -49,6 +49,10 @@ export interface WidgetModel {
      * Widget style options.
      */
     styleOptions: WidgetStyleOptions;
+    /**
+     * Widget configuration.
+     */
+    config?: WidgetConfig;
     /**
      * Custom widget options. Only present for custom widgets.
      *

package/dist/packages/sdk-ui/src/infra/api/narrative/narrative-endpoints.d.ts

@@ -24,9 +24,9 @@ export type GetNarrativeOptions = {
  * retried once with the fallback payload.
  *
  * @param httpClient - HttpClient instance
- * @param request - Narration request payload
+ * @param request - Narrative request payload
  * @param options - Optional; `canGenerateNarrativeViaAI` (typically from `app.settings.narrative`)
- * @returns Promise that resolves with narration JSON or `undefined` (same semantics as `HttpClient.post`)
+ * @returns Promise that resolves with narrative JSON or `undefined` (same semantics as `HttpClient.post`)
  * @internal
  */
 export declare function getNarrative(httpClient: HttpClient, request: NarrativeRequest, options?: GetNarrativeOptions): Promise<NarrativeResponse | undefined>;

package/dist/packages/sdk-ui/src/infra/app/settings/settings.d.ts

@@ -101,11 +101,22 @@ type ServerSettings = {
     serverVersion: string;
     serverFeatures: FeatureMap;
     ai: AiSettingsSlice;
+    /**
+     * Whether this is a Sisense-managed (cloud) deployment.
+     * From `api/globals` props.isManagedService; `false` for on-prem.
+     */
+    isManaged: boolean;
     narrative: {
         /** From `api/v2/settings/ai` narration.enabled */
         isEnabled: boolean;
         /** Computed from `narrationUnified` and the unlimited or credit-based narrative entitlements. */
         canGenerateNarrativeViaAI: boolean;
+        /**
+         * Narrative text provider from the license (`api/globals` props.narrationProvider).
+         * `arria` is the legacy 3rd-party engine served only via `POST /api/v1/narration/widget`,
+         * which CSDK does not support; `sisenseAI` uses the AI endpoints CSDK can call.
+         */
+        provider?: 'arria' | 'sisenseAI';
     };
     user: {
         tenant: {

package/dist/packages/sdk-ui/src/infra/app/settings/types/features.d.ts

@@ -35,8 +35,6 @@ type BuildDestinationFeature = Feature<'buildDestination', {
 type VersionHistoryFeature = Feature<'versionHistory'>;
 type EmbedCodeFeature = Feature<'embedCode'>;
 type LiveCustomColumnFeature = Feature<'liveCustomColumn'>;
-type ExportingEngineV2Feature = Feature<'exportingEngineV2'>;
-type ExportingXlsxV2Feature = Feature<'exportingXlsxV2'>;
 type ExportingCsvFeature = Feature<'exportingCsv', {
     localized: boolean;
 }>;
@@ -132,7 +130,7 @@ type AiAssistantFeature = Feature<'aiAssistant', {
 type AiStudioFeature = Feature<'aiStudio'>;
 type NewNavigationBetaFeature = Feature<'newNavigationBeta'>;
 type ApiTelemetryFeature = Feature<'apiTelemetry'>;
-export type Features = (AlertingFeature | LiveQueryFeature | NlqFeature | PivotFeature | CustomCodeFeature | CustomCodeTransformationFeature | BuildDestinationFeature | VersionHistoryFeature | EmbedCodeFeature | LiveCustomColumnFeature | ExportingEngineV2Feature | ExportingXlsxV2Feature | ExportingCsvFeature | ConnectionManagementFeature | SisenseLightFeature | WizardSqlEditorFeature | MultiTenancyFeature | BloxFeature | FunnelFeature | Cloud360Feature | BreakByToggleFeature | GitIntegrationFeature | InfusionFeature | InfusionWebClientFeature | NotebooksFeature | AdminWebClientFeature | DateTimeFiltersFeature | TextFiltersFeature | NumericFiltersFeature | FilterRelationsEnabledFeature | TimeLevelSupportEnabledFeature | SyncDashboardEventsFeature | UserProfileFeature | ScatterFeature | CustomFontsFeature | PreferWidgetImageServerExportFeature | NewAdminUIFeature | SharedFormulasFeature | SideBarFeature | InfusionTokenEndpointFeature | ExplanationsForIndicatorWidgetsFeature | ExplanationsForCategoricalWidgetsFeature | WidgetDesignStyleFeature | FiscalOnFeature | ReactAnalyticsWidgetEditorFeature | DynamicSQLFeature | NewCustomConnectorFeature | CrossTenantPerspectivesFeature | EnableDatamodelPerspectiveFeature | AlwaysDirectRelationsFeature | ModelStatisticsFeature | ExportingCsvFormattedFeature | FlexibleTooltipsFeature | DimensionalModelingFeature | CloudCDNFeature | OnboardingFeature | AiAssistantFeature | AiStudioFeature | NewNavigationBetaFeature | ApiTelemetryFeature)[];
+export type Features = (AlertingFeature | LiveQueryFeature | NlqFeature | PivotFeature | CustomCodeFeature | CustomCodeTransformationFeature | BuildDestinationFeature | VersionHistoryFeature | EmbedCodeFeature | LiveCustomColumnFeature | ExportingCsvFeature | ConnectionManagementFeature | SisenseLightFeature | WizardSqlEditorFeature | MultiTenancyFeature | BloxFeature | FunnelFeature | Cloud360Feature | BreakByToggleFeature | GitIntegrationFeature | InfusionFeature | InfusionWebClientFeature | NotebooksFeature | AdminWebClientFeature | DateTimeFiltersFeature | TextFiltersFeature | NumericFiltersFeature | FilterRelationsEnabledFeature | TimeLevelSupportEnabledFeature | SyncDashboardEventsFeature | UserProfileFeature | ScatterFeature | CustomFontsFeature | PreferWidgetImageServerExportFeature | NewAdminUIFeature | SharedFormulasFeature | SideBarFeature | InfusionTokenEndpointFeature | ExplanationsForIndicatorWidgetsFeature | ExplanationsForCategoricalWidgetsFeature | WidgetDesignStyleFeature | FiscalOnFeature | ReactAnalyticsWidgetEditorFeature | DynamicSQLFeature | NewCustomConnectorFeature | CrossTenantPerspectivesFeature | EnableDatamodelPerspectiveFeature | AlwaysDirectRelationsFeature | ModelStatisticsFeature | ExportingCsvFormattedFeature | FlexibleTooltipsFeature | DimensionalModelingFeature | CloudCDNFeature | OnboardingFeature | AiAssistantFeature | AiStudioFeature | NewNavigationBetaFeature | ApiTelemetryFeature)[];
 export type FeatureByKey<K extends string> = Extract<Features[number], {
     key: K;
 }>;

package/dist/packages/sdk-ui/src/infra/app/types.d.ts

@@ -160,6 +160,23 @@ export type AppConfig = {
          */
         enabled?: boolean;
     };
+    /**
+     * Configuration of the Narrative feature for widgets
+     */
+    narrativeConfig?: {
+        /**
+         * Whether to enable or disable the Widget Narrative feature
+         *
+         * When `true`, the Widget Narrative feature is enabled if the Fusion server supports it.
+         *
+         * When `false`, the Widget Narrative feature is disabled.
+         *
+         * Note: The Widget Narrative feature requires Sisense Intelligence Narratives to be enabled on the connected Sisense Fusion environment.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+    };
     /**
      * Global configuration for some specific aspects of data visualizations.
      */

package/dist/packages/sdk-ui/src/infra/decorators/component-decorators/with-tracking/use-track-component-init.d.ts

@@ -1,9 +1,17 @@
 import { ReactNode } from 'react';
 import { TrackingDecoratorConfig } from './with-tracking';
 type TrackingComponentConfig = TrackingDecoratorConfig;
+type TrackingContextValue = {
+    skipNested: boolean;
+};
 export declare const TrackingContextProvider: ({ skipNested, children, }: {
     children: ReactNode;
     skipNested?: boolean | undefined;
 }) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Reads whether the current subtree is already inside a tracking context — i.e. an ancestor
+ * component is being tracked, so nested components must not fire their own init event.
+ */
+export declare const useTrackingContext: () => TrackingContextValue;
 export declare const useTrackComponentInit: <P extends {}>(trackingComponentConfig: TrackingComponentConfig, props: P) => void;
 export {};

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

@@ -13,14 +13,30 @@ export interface ApiField<TValue, TRegistry> {
  */
 export type ApiSchema = Record<string, ApiField<any, any>>;
 /**
- * Module definition
+ * A module definition which represents a named, versioned unit of Compose SDK functionality which could be consumed separately.
  *
- * @alpha
+ * A module can require other modules (`requires`), include other modules (`includes`),
+ * contribute to the API of the modules it requires (`integrations`), and declare its own
+ * API for other modules to contribute to (`api`).
+ *
+ * @example
+ * A module that contributes a customization to the built-in `dashboard` module:
+ * ```ts
+ * const dashboardBadgeModule: Module = {
+ *   name: 'dashboard-badge',
+ *   version: '1.0.0',
+ *   requires: ['dashboard'],
+ *   integrations: {
+ *     dashboard: { customizations: [addBadgeToDashboardHeader] },
+ *   },
+ * };
+ * ```
+ * @beta
  */
 export interface Module<TSchema = any> {
     /** Unique module identifier, e.g. `'dashboard'`. */
     name: string;
-    /** Module version */
+    /** Semver version of the module (e.g. `'1.0.0'`), validated against `requiredVersion` constraints declared by other modules. */
     version: string;
     /**
      * Modules this module integrates with.
@@ -30,10 +46,13 @@ export interface Module<TSchema = any> {
      * - `{ ..., requiredVersion: '^2.0.0' }` → optional semver range constraint.
      */
     requires?: ReadonlyArray<ModuleRequirement>;
-    /** Modules this one ships as part of its own feature */
+    /** Modules this one ships as part of its own feature. */
     includes?: ReadonlyArray<Module>;
     /**
      * Declarative contributions to other modules, keyed by target module name.
+     *
+     * Every target must be declared in {@link requires}; contributions to
+     * undeclared modules throw at startup.
      */
     integrations?: Record<string, unknown>;
     /** Producer-side API declaration; defines registries other modules contribute to. */
@@ -42,7 +61,7 @@ export interface Module<TSchema = any> {
 /**
  * Hard or soft requirement on another module, optionally version-constrained.
  *
- * @alpha
+ * @beta
  */
 export type ModuleRequirement = string | {
     name: string;