@sisense/sdk-ui 2.25.0 → 2.27.0

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

@@ -41,6 +41,7 @@ export interface GetDashboardModelOptions {
  * @param appSettings - Optional application settings
  * @returns The dashboard model
  *
- * @internal @sisenseInternal
+ * @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/get-dashboard-models.d.ts

@@ -1,4 +1,6 @@
 import { HttpClient } from '@sisense/sdk-rest-client';
+import { AppSettings } from '../../../infra/app/settings/settings';
+import { CompleteThemeSettings } from '../../../types';
 export interface GetDashboardModelsOptions {
     /**
      * Dashboard title to search by
@@ -12,4 +14,4 @@ export interface GetDashboardModelsOptions {
     includeWidgets?: boolean;
 }
 /** @internal */
-export declare function getDashboardModels(http: HttpClient, options?: GetDashboardModelsOptions): Promise<import('../../../domains/dashboarding/dashboard-model').DashboardModel[]>;
+export declare function getDashboardModels(http: HttpClient, options?: GetDashboardModelsOptions, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): Promise<import('../../../domains/dashboarding/dashboard-model').DashboardModel[]>;

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

@@ -1,24 +1,36 @@
 import { Dimension, Filter, FilterRelations, FilterRelationsModel, FilterRelationsModelNode, Measure } from '@sisense/sdk-data';
-import { JtdTarget, TriggerMethod } from '../../../domains/dashboarding/hooks/jtd/jtd-types';
+import { JtdTarget, JumpToDashboardConfig, JumpToDashboardConfigForPivot, TriggerMethod } from '../../../domains/dashboarding/hooks/jtd/jtd-types';
 import { TabbersConfig } from '../../../domains/dashboarding/hooks/use-tabber';
 import { Panel, WidgetDto } from '../../../domains/widgets/components/widget-by-id/types';
 import { RestApi } from '../../../infra/api/rest-api';
 import { type CascadingFilterDto, DashboardDto, type FilterDto, type LayoutDto } from '../../../infra/api/types/dashboard-dto';
 import type { SpecificWidgetOptions, WidgetsOptions, WidgetsPanelColumnLayout } from './types';
+type WidgetJtdDtoSlice = Pick<WidgetDto, 'oid' | 'type' | 'metadata' | 'drillToDashboardConfig'>;
 export declare const translateLayout: (layout: LayoutDto) => WidgetsPanelColumnLayout;
 export declare function extractDashboardFilters(dashboardFilters: Array<FilterDto | CascadingFilterDto>, filterRelationsModel?: FilterRelationsModel | FilterRelationsModelNode): Filter[] | FilterRelations;
-export declare const getJtdNavigateType: (widget: WidgetDto) => TriggerMethod;
-export declare const convertDimensionsToDimIndexes: (widget: WidgetDto, dimensionIds: string[]) => string[];
+export declare const getJtdNavigateType: (widget: WidgetJtdDtoSlice) => TriggerMethod;
+export declare const convertDimensionsToDimIndexes: (widget: WidgetJtdDtoSlice, dimensionIds: string[]) => string[];
 /**
  * Extract pivot targets configuration from widget DTO and build Map-based targets
+ *
  * @param widget - Widget DTO with drillToDashboardConfig
  * @returns Map of dimensions/measures to their targets or undefined if no targets found
  * @internal
  */
-export declare function extractPivotTargetsConfigFromWidgetDto(widget: WidgetDto): Map<Dimension | {
+export declare function extractPivotTargetsConfigFromWidgetDto(widget: WidgetJtdDtoSlice): Map<Dimension | {
     dimension: Dimension;
     location: 'row' | 'column' | 'value';
 } | Measure, JtdTarget[]> | undefined;
+/**
+ * Converts a Fusion {@link WidgetDto}'s `drillToDashboardConfig` into Compose SDK JumpToDashboardConfig | JumpToDashboardConfigForPivot
+ * {@link JumpToDashboardConfig} {@link JumpToDashboardConfigForPivot} for use with {@link useJtdWidget}
+ *
+ * @param widget - Fusion widget DTO (or the subset of fields used for JTD translation)
+ * @returns JTD config, or `undefined` when there is no versioned JTD DTO or the widget type does not support JTD
+ *
+ * @group Dashboards
+ */
+export declare function jumpToDashboardConfigFromWidgetDto(widget: WidgetJtdDtoSlice): JumpToDashboardConfig | JumpToDashboardConfigForPivot | undefined;
 export declare function translateWidgetsOptions(widgets?: WidgetDto[]): WidgetsOptions;
 /**
  * Applies {@link SpecificWidgetOptions} to a {@link WidgetDto}.
@@ -39,6 +51,7 @@ export declare function translateTabbersOptions(widgets?: WidgetDto[]): TabbersC
 export declare function withSharedFormulas(dashboard: DashboardDto, api: RestApi): Promise<DashboardDto>;
 /**
  * Find dimension or measure by instanceId in widget panels and convert to proper type
+ *
  * @param panels - Widget metadata panels to search
  * @param pivotDimension - Instance ID to find, this is not a PivotDimId, it is the instanceId of the dimension or measure
  * @returns Dimension/Measure object with optional location info or undefined if not found
@@ -48,3 +61,4 @@ export declare function findDimensionByInstanceId(panels: Panel[], pivotDimensio
     dimension: Dimension;
     location: 'row' | 'column' | 'value';
 } | undefined;
+export {};

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

@@ -1,5 +1,7 @@
 import { CommonFiltersOptions } from '../../../domains/dashboarding/common-filters/types';
 import type { JumpToDashboardConfig, JumpToDashboardConfigForPivot } from '../../../domains/dashboarding/hooks/jtd/jtd-types';
+import type { UnsupportedStyleOptions } from '../../../domains/widgets/components/widget-by-id/translate-widget-style-options/extract-unsupported-style-options.js';
+import type { WidgetDto } from '../../../domains/widgets/components/widget-by-id/types';
 import { ColorPaletteTheme } from '../../../types';
 export type { CommonFiltersOptions, CommonFiltersApplyMode, FiltersIgnoringRules, } from '../../../domains/dashboarding/common-filters/types';
 /**
@@ -8,6 +10,7 @@ export type { CommonFiltersOptions, CommonFiltersApplyMode, FiltersIgnoringRules
 export interface WidgetsPanelCell {
     /**
      * Flag that indicates if the cell is hidden
+     *
      * @internal
      */
     hidden?: boolean;
@@ -66,6 +69,7 @@ export type WidgetsPanelLayout = WidgetsPanelColumnLayout;
 export type WidgetId = string;
 /**
  * Dashboard ID
+ *
  * @internal
  */
 export type DashboardId = string;
@@ -87,6 +91,21 @@ export type SpecificWidgetOptions = {
      * Jump To Dashboard config for widgets.
      */
     jtdConfig?: JumpToDashboardConfig | JumpToDashboardConfigForPivot;
+    /**
+     * Partial snapshot of raw DTO fields preserved from the server response.
+     * Required to include all existing options/style when PATCHing a single field (e.g. previousScrollerLocation),
+     * because the server replaces the entire object rather than merging.
+     *
+     * `style` carries only the unsupported style fields not yet first-class translated by the
+     * CSDK widget model (extracted via `extractUnsupportedStyleOptions`); they are re-attached
+     * to the DTO during serialization with lower priority than rebuilt translation output.
+     *
+     * @internal
+     */
+    partialDtoOptions?: {
+        options?: WidgetDto['options'];
+        style?: UnsupportedStyleOptions;
+    };
 };
 /**
  * Style options for the dashboard.

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

@@ -1,3 +1,4 @@
+import { DataSource } from '@sisense/sdk-data';
 import { RestApi } from '../../../../../infra/api/rest-api';
 import { AppSettings } from '../../../../../infra/app/settings/settings';
 import { CompleteThemeSettings } from '../../../../../types';
@@ -15,6 +16,12 @@ export type PersistDashboardModelMiddlewareParams = {
     appSettings: AppSettings;
     /** Theme settings forwarded to {@link toWidgetDto} (used as defaults for widget design) */
     themeSettings: CompleteThemeSettings;
+    /**
+     * Dashboard-level data source. Used as a fallback data source for widgets
+     * whose model does not carry one (e.g. text widgets), so the produced DTO
+     * still satisfies the server's datasource schema.
+     */
+    dashboardDataSource?: DataSource;
 };
 /**
  * Middleware that persists the dashboard model changes to the Sisense server.
@@ -22,4 +29,4 @@ export type PersistDashboardModelMiddlewareParams = {
  * @returns Promise resolving to the action (possibly transformed, e.g. for ADD_WIDGET)
  * @internal
  */
-export declare function persistDashboardModelMiddleware({ dashboardOid, action, restApi, sharedMode, appSettings, themeSettings, }: PersistDashboardModelMiddlewareParams): Promise<UseDashboardModelInternalAction>;
+export declare function persistDashboardModelMiddleware({ dashboardOid, action, restApi, sharedMode, appSettings, themeSettings, dashboardDataSource, }: PersistDashboardModelMiddlewareParams): Promise<UseDashboardModelInternalAction>;

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

@@ -1,5 +1,6 @@
 import { Filter, FilterRelations } from '@sisense/sdk-data';
 import { DashboardModel, SpecificWidgetOptions, WidgetsPanelLayout } from '../../../../../domains/dashboarding/dashboard-model';
+import type { WidgetDto } from '../../../../../domains/widgets/components/widget-by-id/types';
 import { WidgetModel } from '../../../../../domains/widgets/widget-model';
 export type UseDashboardModelState = DashboardModel | null;
 /**
@@ -34,6 +35,17 @@ export type WidgetPatch = {
      * The title of the widget.
      */
     title?: string;
+    /**
+     * Full widget options to send in the PATCH request.
+     * Must include all existing option fields alongside the changed ones, because
+     * the server replaces the entire options object rather than merging.
+     */
+    options?: Partial<NonNullable<WidgetDto['options']>> & {
+        previousScrollerLocation: {
+            min: number;
+            max: number;
+        };
+    };
 };
 /**
  * Internal actions 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

@@ -5,8 +5,11 @@ import { AddWidgetPayload } from './types.js';
 /**
  * Translates filters and relations to DTOs.
  *
- * @param filtersOrFilterRelations - The filters or filter relations to translate
- * @returns The translated filters and relations DTOs for Fusion
+ * `filterRelations[].datasource` is always a **string** (never `undefined`), so Fusion validation
+ * does not break. The value is derived from `filter.dataSource` / `filter.attribute.dataSource`
+ * when present; otherwise `''`.
+ *
+ * @param filtersOrFilterRelations - Flat filters or a filter-relations tree
  *
  * @sisenseInternal
  */

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

@@ -0,0 +1,16 @@
+import type { WidgetsOptions } from '../../../domains/dashboarding/dashboard-model';
+import type { DashboardPersistenceManager } from '../../../domains/dashboarding/persistence/types';
+type ScrollerChangeHandler = (min: number, max: number) => void;
+/**
+ * Returns a stable per-widget factory of debounced scroller-position savers.
+ * Each call with the same widgetOid reuses the same debounced function.
+ * All pending debouncers are cancelled on unmount.
+ *
+ * @param persistence - The dashboard persistence manager. When `undefined`, the returned factory is a no-op.
+ * @param widgetsOptions - Current widget DTO options map, used to include all existing options in the PATCH
+ *   so the server does not discard other option fields when updating `previousScrollerLocation`.
+ * @returns Function that maps a widget OID to its debounced save handler.
+ * @internal
+ */
+export declare function useWidgetScrollPersistence(persistence: DashboardPersistenceManager | undefined, widgetsOptions?: WidgetsOptions): (widgetOid: string) => ScrollerChangeHandler;
+export {};

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

@@ -10,14 +10,15 @@ export type UseComposedDashboardOptions = {
     onFiltersChange?: (filters: Filter[] | FilterRelations) => void;
     /**
      * Persistence manager for the dashboard
+     *
      * @sisenseInternal
      */
     persistence?: DashboardPersistenceManager;
     /**
      * Runtime edit mode state. When provided (e.g. by Dashboard), used for duplicate-widget visibility
      * instead of only config.widgetsPanel.editMode.isEditing.
-     * @internal
      *
+     * @internal
      * @deprecated Temporal workaround. Edit mode (with history management) should be managed by the `useComposedDashboard` hook instead of the Dashboard component.
      */
     isEditing?: boolean;
@@ -78,11 +79,9 @@ export declare function useComposedDashboardInternal<D extends ComposableDashboa
  * }
  *   export default CodeExample;
  * ```
- *
  * @template {D extends ComposableDashboardProps | DashboardProps} D - The type parameter for a dashboard properties, restricted to ComposableDashboardProps or DashboardProps
  * @param {D} initialDashboard - set of properties for the Dashboard component
  * @param {UseComposedDashboardOptions} [options] - Options for the composable.
- *
  * @return {ComposedDashboardResult} An object containing the composed dashboard and APIs to interact with it.
  * @group Dashboards
  */

package/dist/packages/sdk-ui/src/domains/data-browser/data-source-dimensional-model/hooks/use-get-data-source-dimensions.d.ts

@@ -69,10 +69,20 @@ export interface GetDataSourceDimensionsParams {
     /** The search value to filter by */
     searchValue?: string;
 }
+/**
+ * {@link useGetDataSourceDimensions} without tracking to be used inside other hooks or components.
+ *
+ * @param params - The parameters for getting the dimensions
+ * @returns The dimensions state
+ * @internal
+ */
+export declare function useGetDataSourceDimensionsInternal(params: GetDataSourceDimensionsParams): DataSourceDimensionsState;
 /**
  * Gets the dimensions of a data source.
  *
  * @param params - The parameters for getting the dimensions
  * @returns The dimensions state
+ * @group Fusion Assets
+ * @fusionEmbed
  */
 export declare const useGetDataSourceDimensions: (params: GetDataSourceDimensionsParams) => DataSourceDimensionsState;

package/dist/packages/sdk-ui/src/domains/data-browser/data-source-dimensional-model/hooks/use-get-data-source-fields.d.ts

@@ -9,6 +9,7 @@ import { RestApiHookState } from '../../../../shared/utils/utility-types';
  * @param params.count - The number of items to return
  * @param params.offset - The offset for pagination
  * @param params.searchValue - The search value to filter by
+ * @param params.cacheTime - The cache time in milliseconds
  * @returns The data source fields state
  * @internal
  */
@@ -18,6 +19,7 @@ export declare const useGetDataSourceFields: (params: {
     count?: number;
     offset?: number;
     searchValue?: string;
+    cacheTime?: number;
 }) => DataSourceFieldsState;
 type DataSourceFieldsState = RestApiHookState<'dataSourceFields', DataSourceField[]>;
 export {};

package/dist/packages/sdk-ui/src/domains/drilldown/components/drilldown-widget/drilldown-widget.d.ts

@@ -22,8 +22,8 @@ import { DrilldownWidgetProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=use-cases%2Fdrilldown&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/drilldown/hooks/use-drilldown.d.ts

@@ -23,5 +23,5 @@ export declare const useDrilldown: ({ initialDimension, initialDrilldownSelectio
 /** @internal */
 export declare function getSelectionTitleMenuItem(points: DataPoint[], drilldownDimension: Attribute): MenuItemSection;
 /** @internal */
-export declare function getDrilldownMenuItems(availableDrilldownPaths: (Attribute | Hierarchy)[], drilldownDimension: Attribute, selectFn: (nextDimension: Attribute, hierarchy?: Hierarchy) => void, translate: TFunction): MenuItemSection;
+export declare function getDrilldownMenuItems(availableDrilldownPaths: (Attribute | Hierarchy)[], drilldownDimension: Attribute, selectFn: (nextDimension: Attribute, hierarchy?: Hierarchy) => void, translate: TFunction): MenuItemSection | null;
 export {};

package/dist/packages/sdk-ui/src/domains/drilldown/hooks/use-hierarchies-loader.d.ts

@@ -0,0 +1,17 @@
+import { Attribute, DataSource } from '@sisense/sdk-data';
+import { Hierarchy, HierarchyId } from '../hierarchy-model';
+export interface GetHierarchiesParams {
+    /** The attribute/dimension for which to load hierarchies */
+    attribute: Attribute;
+    /** The data source from which to retrieve hierarchies */
+    dataSource?: DataSource;
+    /** The hierarchy IDs to load */
+    ids: HierarchyId[];
+}
+/**
+ * Provides a `getHierarchies` function that loads hierarchy models from a Fusion instance by ID,
+ * including any hierarchies marked as `alwaysIncluded`.
+ */
+export declare function useHierarchiesLoader(): {
+    getHierarchies: (params: GetHierarchiesParams) => Promise<Hierarchy[]>;
+};

package/dist/packages/sdk-ui/src/domains/filters/components/cascading-filter-tile/cascading-filter-tile.d.ts

@@ -5,7 +5,7 @@ import type { FilterTileConfig } from '../filter-tile/types.js';
 /**
  * Props for {@link CascadingFilterTile}
  *
- * @internal
+ * @alpha
  */
 export interface CascadingFilterTileProps {
     /** Cascading filter object to initialize filter type and default values */
@@ -43,6 +43,6 @@ export interface CascadingFilterTileProps {
  * @param props - Cascading filter tile props
  * @returns Cascading filter tile component
  * @group Filter Tiles
- * @internal
+ * @alpha
  */
 export declare const CascadingFilterTile: import("react").FunctionComponent<CascadingFilterTileProps>;

package/dist/packages/sdk-ui/src/domains/filters/components/custom-filter-tile.d.ts

@@ -5,7 +5,7 @@ import { FilterTileDesignOptions } from './filter-tile-container';
 /**
  * Props for {@link CustomFilterTile}
  *
- * @internal
+ * @alpha
  */
 export interface CustomFilterTileProps {
     /** Custom filter. */
@@ -38,7 +38,6 @@ export interface CustomFilterTileProps {
 /**
  * UI component for a custom filter defined with JAQL.
  *
- * @internal
  * @example
  * ```tsx
  * const filterJaql = { from: 10, to: 20000 };
@@ -59,5 +58,6 @@ export interface CustomFilterTileProps {
  * @param props - Custom filter tile props
  * @returns Custom filter tile component
  * @group Filter Tiles
+ * @alpha
  */
 export declare const CustomFilterTile: import("react").FunctionComponent<CustomFilterTileProps>;

package/dist/packages/sdk-ui/src/domains/narrative/core/widget-narrative-options.d.ts

@@ -10,9 +10,17 @@ export interface WidgetNarrativeOptions {
     defaultDataSource?: DataSource;
     /** The verbosity of the NLG summarization */
     verbosity?: 'Low' | 'High';
-    /** When false, legacy narration endpoint only; when true or undefined, try unified then fallback. */
-    isUnifiedNarrationEnabled?: boolean;
-    isSisenseAiEnabled?: boolean;
+    /**
+     * When `true`, attempts the unified AI narrative endpoint and falls back to the legacy endpoint
+     * on 404. When `false` or omitted, only the legacy endpoint is used.
+     *
+     * **Hook-based flows** (e.g. {@link useGetWidgetNarrative}): when omitted, the value is read
+     * from `app.settings.narrative.canGenerateNarrativeViaAI` via {@link useSisenseContext}.
+     *
+     * **Imperative helpers** (e.g. {@link getNlgInsightsFromWidget}): no context fallback is
+     * performed — omitting this option is equivalent to `false` (legacy endpoint only).
+     */
+    canGenerateNarrativeViaAI?: boolean;
     /**
      * When `true`, trend and forecast companion measures are omitted from the narrative JAQL so
      * requests stay compatible with backends that do not yet support them.

package/dist/packages/sdk-ui/src/domains/narrative/core/widget-props-to-narrative-params.d.ts

@@ -1,7 +1,7 @@
 import { DataSource } from '@sisense/sdk-data';
 import { ChartWidgetProps } from '../../../domains/widgets/components/chart-widget/types';
 import type { PivotTableWidgetProps } from '../../../domains/widgets/components/pivot-table-widget/types';
-import type { WithCommonWidgetProps } from '../../../domains/widgets/components/widget/types';
+import type { WidgetProps, WithCommonWidgetProps } from '../../../domains/widgets/components/widget/types';
 import type { NarrativeRequest } from '../../../infra/api/narrative/narrative-api-types.js';
 import type { NarrativeQueryParams } from './build-narrative-request.js';
 /**
@@ -34,3 +34,53 @@ export declare function convertPivotWidgetPropsToNarrativeRequest(props: WithCom
  * @deprecated Use {@link convertChartWidgetPropsToNarrativeParams}. Same function; kept for legacy `getNlgInsightsFromWidget`.
  */
 export declare const convertChartWidgetPropsToUseGetNlgInsightsParams: typeof convertChartWidgetPropsToNarrativeParams;
+/**
+ * Error message for imperative callers (e.g. {@link getNlgInsightsFromWidget}) when chart or pivot
+ * props omit `dataSource` and no `defaultDataSource` is passed.
+ *
+ * @internal
+ */
+export declare const MISSING_DATASOURCE_NLG_ERROR = "dataSource is required. Provide it on the widget props or as defaultDataSource parameter.";
+export type WidgetNarrativeRequestPair = {
+    supported: boolean;
+    narrativeRequest: NarrativeRequest | undefined;
+    /**
+     * Same request with trend/forecast stripped. `undefined` when `ignoreTrendAndForecast` is
+     * already `true` (primary already stripped), when the widget type is unsupported, or when
+     * the fallback conversion itself fails.
+     */
+    narrativeFallbackRequest: NarrativeRequest | undefined;
+    /**
+     * When `supported` is `false`, `true` means chart/pivot had no resolved data source (props and
+     * `defaultDataSource` were both unset); conversion was skipped.
+     */
+    missingDataSource?: boolean;
+};
+/**
+ * Builds a primary narrative request and, when useful, a fallback request with trend/forecast
+ * stripped — both from the same widget props in a single call.
+ *
+ * @param props - Chart or pivot widget props
+ * @param defaultDataSource - Used when `props.dataSource` is undefined
+ * @param verbosity - Optional verbosity for narrative text
+ * @param ignoreTrendAndForecast - When `true`, the primary request already omits trend/forecast
+ *   and no fallback is needed
+ * @returns `{ supported, narrativeRequest, narrativeFallbackRequest }`. `supported` is `false`
+ *   when the widget type is unsupported, when no data source can be resolved for chart/pivot, or
+ *   when the primary conversion fails.
+ * @example Chart or pivot widget props
+ * ```ts
+ * const { supported, narrativeRequest, narrativeFallbackRequest } =
+ *   buildWidgetNarrativeRequests(
+ *     widgetProps, // `WithCommonWidgetProps<ChartWidgetProps, 'chart'>` or pivot equivalent
+ *     defaultDataSource,
+ *     'High',
+ *     false,
+ *   );
+ * ```
+ * On success, `supported` is `true` and `narrativeRequest` / `narrativeFallbackRequest` hold the
+ * primary and trend-stripped NLG payloads; otherwise `supported` is `false` and requests are
+ * `undefined` (and `missingDataSource` may be set when no source could be resolved).
+ * @internal
+ */
+export declare function buildWidgetNarrativeRequests(props: WidgetProps, defaultDataSource?: DataSource, verbosity?: 'Low' | 'High', ignoreTrendAndForecast?: boolean): WidgetNarrativeRequestPair;

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

@@ -5,9 +5,9 @@ import { type WidgetNarrativeQueryState } from './use-widget-narrative-state.js'
  * Options for {@link useGetWidgetNarrative}.
  *
  * @remarks
- * Narration endpoints and flags default from `app.settings` on {@link useSisenseContext} when
- * `isUnifiedNarrationEnabled` / `isSisenseAiEnabled` are omitted. Optional overrides match the
- * imperative `getNlgInsightsFromWidget` helper for per-call behavior.
+ * Narration endpoint selection defaults from `app.settings.narrative.canGenerateNarrativeViaAI`
+ * on {@link useSisenseContext} when `canGenerateNarrativeViaAI` is omitted. Optional overrides
+ * match the imperative `getNlgInsightsFromWidget` helper for per-call behavior.
  * @sisenseInternal
  */
 export type UseGetWidgetNarrativeOptions = WidgetNarrativeOptions & {

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

@@ -23,7 +23,7 @@ export type UseWidgetNarrativeStateResult = WidgetNarrativeQueryState & {
     /**
      * Mirrors the `enabled` param. When `false`, the narrative is opted out: `data` is cleared (no
      * cached fallback), `narrativeRequest` is undefined, and loading/error flags reflect a disabled
-     * query rather than “no insights.”
+     * query rather than "no insights."
      */
     enabled: boolean;
     /** Present when `supported` and `enabled`; used by {@link WidgetNarrative} for feedback payload only. */
@@ -36,4 +36,4 @@ export type UseWidgetNarrativeStateResult = WidgetNarrativeQueryState & {
  *
  * @internal
  */
-export declare function useWidgetNarrativeState({ widgetProps, defaultDataSource, verbosity, enabled, ignoreTrendAndForecast, isUnifiedNarrationEnabled: optionsUnified, isSisenseAiEnabled: optionsSisenseAi, }: UseWidgetNarrativeStateParams): UseWidgetNarrativeStateResult;
+export declare function useWidgetNarrativeState({ widgetProps, defaultDataSource, verbosity, enabled, ignoreTrendAndForecast, canGenerateNarrativeViaAI: optionsCanGenerateNarrativeViaAI, }: UseWidgetNarrativeStateParams): UseWidgetNarrativeStateResult;

package/dist/packages/sdk-ui/src/domains/query-execution/core/date-formats/simple-date-format-replacers.d.ts

@@ -1,4 +1,17 @@
 import type { DateFormat } from './apply-date-format.js';
 export declare function newDateFormatWithUnicodeMillisecondsMasks(oldFormat: DateFormat): DateFormat;
 export declare function newDateFormatWithExpandedAMPM(oldFormat: DateFormat, date: Date, timeZone: string): DateFormat;
+/**
+ * Escapes Latin letter sequences that are not recognized Fusion date format tokens
+ * by wrapping them in single quotes so that `date-fns` treats them as literal text.
+ *
+ * Handles cases like `WEEK-ww` where `WEEK-` is a literal text prefix, but `W`, `E`,
+ * and `K` would otherwise be misinterpreted as `date-fns` format tokens, causing a
+ * RangeError.
+ *
+ * Adjacent non-token sequences (separated only by non-letter characters) are merged
+ * into a single quoted region to avoid `''` being interpreted as an escaped single
+ * quote by `date-fns`.
+ */
+export declare function newDateFormatWithEscapedNonTokenChars(format: DateFormat): DateFormat;
 export declare function newDateFormatWithExpandedTimezoneOffset(oldFormat: DateFormat, date: Date, timeZone: string, locale: Locale): DateFormat;

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

@@ -9,8 +9,8 @@ import { ExecutePivotQueryParams, PivotQueryState } from '../../types';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=queries%2Fuse-execute-pivot-query&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

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

@@ -10,8 +10,8 @@ import { ExecuteQueryParams, ExecuteQueryResult } from '../../types';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=queries%2Fuse-execute-query-sorting&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

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

@@ -10,8 +10,8 @@ import { AreaChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Farea-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

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

@@ -11,8 +11,8 @@ import { AreamapChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fmap-area&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

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

@@ -10,8 +10,8 @@ import { BarChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fbar-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

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

@@ -10,8 +10,8 @@ import { BoxplotChartProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fboxplot-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

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

@@ -9,8 +9,8 @@ import { ChartProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts/chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

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

@@ -1,5 +1,5 @@
 import leaflet, { type FitBoundsOptions } from 'leaflet';
-import { CompleteThemeSettings } from '../../../../../../../index';
+import { CompleteThemeSettings } from '../../../../../../../types.js';
 type FitBoundsAnimationOptions = Pick<FitBoundsOptions, 'animate' | 'duration'>;
 export declare function prepareFitBoundsAnimationOptions(themeSettings: CompleteThemeSettings): FitBoundsAnimationOptions;
 export declare function fitMapToBounds(map: leaflet.Map, markers: leaflet.CircleMarker[], options?: FitBoundsOptions): void;

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

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

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

@@ -1,5 +1,5 @@
 import { XAxisOrientation } from '../../../../../../../../../domains/visualizations/core/chart-options-processor/cartesian/utils/axis/axis-builders.js';
-import { AxisSettings } from '../../../../../../../../../domains/visualizations/core/chart-options-processor/translations/axis-section.js';
+import { type AxisSettings } from '../../../../../../../../../domains/visualizations/core/chart-options-processor/translations/axis-section.js';
 import { BuildContext } from '../../../types.js';
 import { CartesianChartTypes } from '../../types.js';
 export declare const getCartesianXAxis: (ctx: BuildContext<CartesianChartTypes>, orientation: XAxisOrientation) => AxisSettings[];

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

@@ -1,7 +1,9 @@
 import { DataSource } from '@sisense/sdk-data';
+import { type ChartDataOptionsInternal } from '../../../../domains/visualizations/core/chart-data-options/types.js';
 import { ChartData } from '../../../../domains/visualizations/core/chart-data/types';
 import { DesignOptions } from '../../../../domains/visualizations/core/chart-options-processor/translations/types';
-import { ChartDataOptionsInternal, ChartProps, ChartType } from '../../../..';
+import { type ChartProps } from '../../../../props.js';
+import { type ChartType } from '../../../../types.js';
 /**
  * Props object to be passed to the chart renderer.
  *

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

@@ -12,8 +12,8 @@ import { ColumnChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fcolumn-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *