@sisense/sdk-ui 2.30.0 → 2.31.0

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': {

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 { ChartType, DrilldownOptions, PivotTableDrilldownOptions, WidgetAiOptions, WidgetStyleOptions } from '../../../types';
-import type { WidgetType } from '../components/widget/types';
+import { EmptyObject } from '../../../shared/utils/utility-types';
+import { ChartType, DrilldownOptions, PivotTableDrilldownOptions, WidgetStyleOptions } from '../../../types';
+import type { WidgetConfig, WidgetType } from '../components/widget/types';
 /**
  * Widget data options.
  */
@@ -50,10 +50,9 @@ export interface WidgetModel {
      */
     styleOptions: WidgetStyleOptions;
     /**
-     * Configuration for AI-powered widget features such as automated narrative generation
-     * @alpha
+     * Widget configuration.
      */
-    aiOptions?: WidgetAiOptions;
+    config?: WidgetConfig;
     /**
      * Custom widget options. Only present for custom widgets.
      *

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

@@ -162,9 +162,6 @@ export type AppConfig = {
     };
     /**
      * Configuration of the Narrative feature for widgets
-     * Temporary feature flag to explicitly enable narrative on widgets
-     * (avoid narratives appearing in fusion dashboards/widgets before this feature is released)
-     * @sisenseInternal
      */
     narrativeConfig?: {
         /**
@@ -174,9 +171,11 @@ export type AppConfig = {
          *
          * When `false`, the Widget Narrative feature is disabled.
          *
-         * @default false
+         * Note: The Widget Narrative feature requires Sisense Intelligence Narratives to be enabled on the connected Sisense Fusion environment.
+         *
+         * @default true
          */
-        widgetNarrativeEnabled?: boolean;
+        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;

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

@@ -221,13 +221,16 @@ export interface CustomVisualizationProps<DataOptions = GenericDataOptions, Styl
     /** Highlight filters for interactive highlighting */
     highlights?: Filter[];
     /**
-     * Arbitrary plugin-specific options that is not data- or style-related.
+     * Arbitrary plugin-specific runtime state that is not data- or style-related
+     * (for example the current page of a table or a selected tab). Persisted back
+     * to the Sisense instance when the widget lives inside a Dashboard component,
+     * so it survives page reloads.
      *
-     * @sisenseInternal
+     * @beta
      */
     customOptions?: CustomOptions;
     /**
-     * Emit a partial state update to be persisted through the dashboard
+     * Emits a partial state update to be persisted through the dashboard
      * persistence layer. Injected by the dashboard when the widget lives inside a
      * Dashboard component; `undefined` in standalone use or read-only mode — always
      * call it with optional chaining.
@@ -237,7 +240,7 @@ export interface CustomVisualizationProps<DataOptions = GenericDataOptions, Styl
      * onChange?.({ customOptions: { lastPage: 3 } });
      * ```
      *
-     * @sisenseInternal
+     * @beta
      */
     onChange?: (update: VisualizationStateUpdate<StyleOptions, CustomOptions>) => void;
 }
@@ -254,7 +257,10 @@ export interface CustomVisualizationProps<DataOptions = GenericDataOptions, Styl
  * replaced wholesale (last-write-wins). Keys cannot be deleted via merge —
  * overwrite with an explicit value (e.g. `null`) instead.
  *
- * @sisenseInternal
+ * @typeParam StyleOptions - The shape of style options for the custom visualization.
+ * @typeParam CustomOptions - The shape of arbitrary plugin-specific runtime state.
+ * @group Plugin System
+ * @beta
  */
 export type VisualizationStateUpdate<StyleOptions = CustomVisualizationStyleOptions, CustomOptions = Record<string, unknown>> = {
     styleOptions?: DeepPartial<StyleOptions>;

package/dist/packages/sdk-ui/src/modules/ai/get-nlg-insights-from-widget.d.ts

@@ -6,8 +6,8 @@ import { WidgetProps } from '../../domains/widgets/components/widget/types';
  * This function converts WidgetProps to the required API format and makes an HTTP request
  * to get natural language insights about the chart or pivot data.
  *
- * @param props - WidgetProps containing chart or pivot configuration (`aiOptions.narrative`
- *   drives {@link WidgetNarrativeOptions})
+ * @param props - WidgetProps containing chart or pivot configuration (`config.narrative`
+ *   drives {@link WidgetNarrativeConfig})
  * @param httpClient - HttpClient instance for making API requests
  * @returns Promise that resolves to the NLG insights answer string
  * @throws Error if dataSource cannot be resolved or if API response is invalid

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/custom-formula/validate-custom-formula.d.ts

@@ -40,6 +40,17 @@ export interface FormulaParenCall {
  * @internal Exported for unit tests
  */
 export declare function extractParenFunctionCalls(formula: string): FormulaParenCall[];
+/**
+ * Extracts the raw argument strings from each call to the named function in a formula.
+ * Skips calls inside quoted strings; unparseable calls (unbalanced parentheses) are omitted.
+ *
+ * @param formula - The formula string to scan for function calls
+ * @param funcName - The function name to match (case-insensitive)
+ * @returns An array of argument lists, one inner array per matched call, or an empty array when no calls are found
+ *
+ * @internal
+ */
+export declare function extractFunctionArgs(formula: string, funcName: string): string[][];
 /**
  * Validates that all bracket references in a custom formula exist in the provided context
  * and provides helpful error messages for debugging.

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/datetime-filter-processors.d.ts

@@ -0,0 +1,6 @@
+import { FunctionContext, ProcessedArg } from '../../types.js';
+export declare function processDatetimeMembersFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeRangeFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeFromFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeToFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
+export declare function processDatetimeRelativeFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/measure-processors.d.ts

@@ -0,0 +1,16 @@
+import { FunctionContext, ProcessedArg } from '../../types.js';
+/**
+ * Validates that the first argument is a numeric attribute.
+ * Used by: sum, average, avg, stdev, variance, median
+ *
+ * SUM, AVG, STDEV, VAR, MEDIAN require numeric columns; applying them to text or datetime
+ * attributes causes the BE translation engine to throw (AGGREGATION_OVER_NON_NUMERIC_FIELD guard).
+ *
+ * @param processedArgs - Processed arguments where args[0] is the attribute
+ * @param context - Processing context with error prefix and other metadata
+ * @returns Same `processedArgs` reference when validation succeeds
+ * @throws Error with descriptive message if validation fails
+ *
+ * @internal
+ */
+export declare function processNumericMeasure(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/utils/schema-index.d.ts

@@ -47,6 +47,10 @@ export declare function parseDimensionalName(dimensionalName: string, schemaInde
 export interface CreateAttributeFromNameOptions {
     /** When the dimensional name has no date level, use this level for datetime columns (e.g. from xdiff function). */
     inferredDateLevel?: string;
+    /** When true, datetime/date/time columns must include an explicit level suffix (or inferredDateLevel). */
+    requireExplicitDateLevel?: boolean;
 }
+/** Options for NLQ paths where a date level must be present in the dimensional name. */
+export declare const REQUIRE_EXPLICIT_DATE_LEVEL: CreateAttributeFromNameOptions;
 export declare function createAttributeFromName(attributeName: string, dataSource: JaqlDataSourceForDto, schemaIndex: SchemaIndex, options?: CreateAttributeFromNameOptions): import("@sisense/sdk-data").Attribute | import("@sisense/sdk-data").LevelAttribute;
 export declare function createDateDimensionFromName(dateDimensionName: string, dataSource: JaqlDataSourceForDto, schemaIndex: SchemaIndex): DateDimension;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/datetime-member-validation.d.ts

@@ -0,0 +1,2 @@
+export declare function validateDatetimeMemberStrings(members: unknown[], granularity: string, pathPrefix: string): void;
+export declare function validateNoDuplicateMembers(members: string[], pathPrefix: string): void;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/datetime-range-validation.d.ts

@@ -0,0 +1,2 @@
+export declare function validateDatetimeRange(granularity: string, from: Date | string | undefined, to: Date | string | undefined, pathPrefix: string): void;
+export declare function normalizeDatetimeRangeBound(bound: Date | string, granularity: string): string;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/datetime-relative-validation.d.ts

@@ -0,0 +1 @@
+export declare function validateDatetimeRelativeFilter(granularity: string, offset: number, count: number, anchor: Date | string | undefined, pathPrefix: string): void;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/datetime-validation-utils.d.ts

@@ -0,0 +1,40 @@
+import { Attribute } from '@sisense/sdk-data';
+/** Period granularities that accept calendar-date bounds in JAQL (matches sdk-data DateLevels.dateOnly). */
+export declare const PERIOD_DATE_LEVELS: readonly string[];
+/** Relative date filters supported on the Sisense backend for period levels. */
+export declare const RELATIVE_DATE_LEVELS: readonly string[];
+/** Sisense default first day of week (system.firstday), used when normalizing week members. */
+export declare const DEFAULT_WEEK_STARTS_ON = 1;
+/**
+ * Checks if a string is a valid ISO date or datetime (YYYY-MM-DD…).
+ */
+export declare function isValidIsoDateString(value: string): boolean;
+/**
+ * Checks if a string is a compact YYYYWW week key (e.g. `202500`), not a valid ISO datetime.
+ */
+export declare function isCompactYearWeekKey(value: string): boolean;
+/**
+ * Checks if a string is exactly a four-digit calendar year (e.g. `2024`).
+ */
+export declare function isFourDigitYear(value: string): boolean;
+/**
+ * Checks if a datetime string ends with `T23:59:59`, which is an invalid exclusive upper bound.
+ */
+export declare function hasExclusiveEndOfDayAntiPattern(value: string): boolean;
+/**
+ * Normalizes a date range bound to its string form for validation and comparison.
+ */
+export declare function toDateBoundString(bound: Date | string): string;
+/**
+ * Strips the time component from an ISO datetime, returning the calendar date portion only.
+ */
+export declare function stripClockFromIsoDateTime(bound: string): string;
+/**
+ * Returns a human-readable hint describing valid member formats for the given date granularity.
+ */
+export declare function formatExpectedMemberHint(granularity: string): string;
+/**
+ * Returns the user-facing table.column name for a date level attribute (e.g. `Commerce.Date`),
+ * derived from composeCode rather than the internal JAQL expression.
+ */
+export declare function getDateColumnDisplayName(attribute: Attribute): string;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/flatten-filters.d.ts

@@ -0,0 +1,5 @@
+import { Filter, FilterRelations } from '@sisense/sdk-data';
+/**
+ * Collects all leaf {@link Filter} instances from a filter list or relations tree.
+ */
+export declare function flattenFilters(filters: Filter[] | FilterRelations | null | undefined): Filter[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/normalize-member-for-granularity.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Normalizes a datetime filter member to the start of its calendar period,
+ * matching Sisense backend member encoding.
+ */
+export declare function normalizeMemberForGranularity(member: string, granularity: string): string;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/validation/query-datetime-validation.d.ts

@@ -0,0 +1,7 @@
+import { Attribute, Filter } from '@sisense/sdk-data';
+import { NlqTranslationError } from '../../../types.js';
+export declare function validateQueryDatetimeConsistency(input: {
+    dimensions: Attribute[];
+    filters: Filter[] | import('@sisense/sdk-data').FilterRelations | null | undefined;
+    highlights: Filter[] | null | undefined;
+}): NlqTranslationError[];

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

@@ -114,7 +114,7 @@ export type UiFramework = 'react' | 'vue' | 'angular';
  *
  * @internal
  */
-export type CodeTemplateKey = 'baseChartTmpl' | 'chartTmpl' | 'chartWidgetTmpl' | 'chartWidgetPropsTmpl' | 'widgetByIdTmpl' | 'executeQueryByWidgetIdTmpl' | 'executeQueryTmpl' | 'executePivotQueryTmpl' | 'pivotTableWidgetTmpl' | 'pivotTableWidgetPropsTmpl' | 'dashboardByIdTmpl' | 'dashboardTmpl';
+export type CodeTemplateKey = 'baseChartTmpl' | 'chartTmpl' | 'chartWidgetTmpl' | 'chartWidgetPropsTmpl' | 'widgetByIdTmpl' | 'executeQueryByWidgetIdTmpl' | 'executeQueryTmpl' | 'executePivotQueryTmpl' | 'pivotTableWidgetTmpl' | 'pivotTableWidgetPropsTmpl' | 'customWidgetTmpl' | 'dashboardByIdTmpl' | 'dashboardTmpl';
 /**
  * Code Templates
  *
@@ -235,6 +235,21 @@ export type ChartWidgetCodeProps = Stringify<ChartWidgetProps> & ExtraWidgetCode
  * @internal
  */
 export type PivotTableWidgetCodeProps = Stringify<PivotTableWidgetProps> & ExtraWidgetCodeProps;
+/**
+ * Custom Widget Code Props
+ *
+ * @internal
+ */
+export type CustomWidgetCodeProps = {
+    customWidgetTypeString: string;
+    titleString: string;
+    dataSourceString: string;
+    dataOptionsString: string;
+    filtersString: string;
+    extraImportsString: string;
+    styleOptionsString: string;
+    customOptionsString: string;
+};
 /**
  * Template Key by Widget Type
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/widget/to-widget-code.d.ts

@@ -1,5 +1,5 @@
 import { WidgetProps } from '../../../domains/widgets/components/widget/types';
 import { ByIdWidgetCodeParams, ClientSideWidgetCodeParams, TemplateKeyMapByWidgetType, UiFramework } from '../types.js';
-export declare const toWidgetCodeById: ({ dashboardOid, widgetOid, uiFramework, chartType, includeChart, }: ByIdWidgetCodeParams) => string;
+export declare const toWidgetCodeById: ({ dashboardOid, widgetOid, uiFramework, includeChart, }: ByIdWidgetCodeParams) => string;
 export declare const getWidgetCode: (widgetProps: WidgetProps, uiFramework: UiFramework, templateKeyMap: TemplateKeyMapByWidgetType, removeDefaultProps?: boolean) => string;
 export declare const toWidgetCodeClientSide: ({ widgetProps, uiFramework, removeDefaultProps, }: ClientSideWidgetCodeParams) => string;

package/dist/packages/sdk-ui/src/props.d.ts

@@ -173,7 +173,7 @@ export interface SisenseContextProviderProps {
      *
      * @category Sisense App
      *
-     * @alpha
+     * @beta
      */
     modules?: Module[];
 }
@@ -856,7 +856,6 @@ export interface FunnelChartProps extends BaseChartProps, HighchartsBasedChartEv
 /**
  * Props of the {@link SankeyChart} component.
  *
- * @group Charts
  * @beta
  *
  * @example

package/dist/packages/sdk-ui/src/public-api/alpha.d.ts

@@ -5,13 +5,9 @@
  * Not recommended for production use.
  */
 export { useDashboardTheme } from '../domains/dashboarding/use-dashboard-theme.js';
-export type { ThemeConfig, WidgetNarrativeDisplayLocation, WidgetNarrativeOptions, CompleteWidgetNarrativeOptions, WidgetAiOptions, } from '../types';
-export { DashboardHeaderTargets, type DashboardHeaderTarget, } from '../domains/dashboarding/components/dashboard-header-targets.js';
-export type { DashboardHeaderConfig, DashboardHeaderItem, DashboardHeaderItemComponent, DashboardHeaderItemComponentProps, DashboardHeaderItemPosition, DashboardHeaderItemSize, DashboardHeaderItemsTransform, DashboardResolvedHeaderItem, } from '../domains/dashboarding/components/dashboard-header-config.js';
+export type { ThemeConfig } from '../types';
 export { type TranslationDictionary, PACKAGE_NAMESPACE as translationNamespace, } from '../infra/translation/resources';
 export { CascadingFilterTile, type CascadingFilterTileProps, } from '../domains/filters/components/cascading-filter-tile';
 export { CustomFilterTile, type CustomFilterTileProps, } from '../domains/filters/components/custom-filter-tile';
-export { useSyncedState, type UseSyncedStateOptions } from '../shared/hooks/use-synced-state';
 export { isIndicatorRenderOptions, isHighchartsOptions, type HighchartsOptions, type CalendarHeatmapChartEventProps, } from '../props';
-export type { Module, ModuleRequirement } from '../infra/modules/types.js';
 export { useModuleApiRegistry } from '../infra/modules/modules-context.js';

package/dist/packages/sdk-ui/src/public-api/beta.d.ts

@@ -5,8 +5,10 @@
  * Not recommended for production use.
  */
 export { useQueryCache } from '../domains/query-execution/hooks/use-query-cache/use-query-cache';
+export type { Module, ModuleRequirement } from '../infra/modules/types.js';
 export type { Plugin, BasePluginInfo } from '../infra/plugins/types.js';
-export type { WidgetPlugin, CustomVisualization, CustomVisualizationProps, CustomVisualizationStyleOptions, CustomVisualizationEventProps, CustomVisualizationDataPoint, CustomVisualizationDataPointEventHandler, CustomVisualizationDataPointContextMenuHandler, CustomVisualizationDataPointsEventHandler, DesignPanelProps, DesignPanel, } from '../infra/plugins/widget-plugins/types.js';
+export type { WidgetPlugin, CustomVisualization, CustomVisualizationProps, CustomVisualizationStyleOptions, CustomVisualizationEventProps, CustomVisualizationDataPoint, CustomVisualizationDataPointEventHandler, CustomVisualizationDataPointContextMenuHandler, CustomVisualizationDataPointsEventHandler, VisualizationStateUpdate, DesignPanelProps, DesignPanel, } from '../infra/plugins/widget-plugins/types.js';
+export { useSyncedState, type UseSyncedStateOptions } from '../shared/hooks/use-synced-state';
 export { SankeyChart } from '../domains/visualizations/components/sankey-chart';
 export type { SankeyChartProps } from '../props';
 export type { SankeyChartDataOptions } from '../domains/visualizations/core/chart-data-options/types';

package/dist/packages/sdk-ui/src/public-api/public.d.ts

@@ -24,6 +24,8 @@ export { AreamapChart } from '../domains/visualizations/components/areamap-chart
 export { AreaRangeChart } from '../domains/visualizations/components/area-range-chart';
 export { CalendarHeatmapChart } from '../domains/visualizations/components/calendar-heatmap-chart';
 export { DashboardById, Dashboard, useComposedDashboard, type ComposableDashboardProps, type UseComposedDashboardOptions, type ComposedDashboardResult, type DashboardByIdProps, type DashboardProps, type DashboardLayoutOptions, type DashboardStyleOptions, type DashboardConfig, type DashboardByIdConfig, type WidgetsPanelConfig, type EditModeConfig, type DashboardFiltersPanelConfig, type TabbersConfig, type TabberConfig, type TabberTabConfig, type DashboardChangeEvent, type DashboardFiltersUpdatedEvent, type DashboardFiltersPanelCollapseChangedEvent, type DashboardWidgetsPanelLayoutUpdatedEvent, type DashboardWidgetsPanelIsEditingChangedEvent, type DashboardWidgetsDeletedEvent, } from '../domains/dashboarding';
+export { DashboardHeaderTargets, type DashboardHeaderTarget, } from '../domains/dashboarding/components/dashboard-header/dashboard-header-targets';
+export type { DashboardHeaderConfig, DashboardHeaderItem, DashboardHeaderItemComponent, DashboardHeaderItemComponentProps, DashboardHeaderItemPosition, DashboardHeaderItemSize, DashboardHeaderItemsTransform, DashboardResolvedHeaderItem, } from '../domains/dashboarding/components/dashboard-header/dashboard-header-config';
 /**
  * Jump To Dashboard (JTD) configuration types
  *
@@ -43,9 +45,10 @@ export { DrilldownWidget } from '../domains/drilldown/components/drilldown-widge
 export { ChartWidget, type ChartWidgetProps } from '../domains/widgets/components/chart-widget';
 export { PivotTableWidget, type PivotTableWidgetProps, } from '../domains/widgets/components/pivot-table-widget';
 export { type TextWidgetProps } from '../domains/widgets/components/text-widget';
-export { Widget, type WidgetProps, type WidgetType, type WithCommonWidgetProps, } from '../domains/widgets/components/widget';
+export { Widget, type WidgetProps, type WidgetConfig, type WidgetType, type WithCommonWidgetProps, } from '../domains/widgets/components/widget';
 export { type CustomWidgetProps } from '../domains/widgets/components/custom-widget';
 export { DrilldownBreadcrumbs } from '../domains/drilldown/components/drilldown-breadcrumbs';
+export type { WidgetNarrativeConfig, WidgetNarrativeDisplayLocation, } from '../domains/narrative/core/widget-narrative-config';
 export type { CustomWidgetComponentProps, CustomWidgetComponent, } from '../infra/contexts/custom-widgets-provider/types';
 export { useCustomWidgets, type UseCustomWidgetsResult, } from '../infra/contexts/custom-widgets-provider';
 export { useGetDashboardModel, useGetDashboardModels, type DashboardModel, type GetDashboardModelParams, type GetDashboardModelsParams, type DashboardModelState, type DashboardModelLoadingState, type DashboardModelSuccessState, type DashboardModelErrorState, type DashboardModelsState, type DashboardModelsLoadingState, type DashboardModelsSuccessState, type DashboardModelsErrorState, type GetDashboardModelOptions, type GetDashboardModelsOptions, type WidgetsPanelColumnLayout, type WidgetsPanelLayout, type WidgetsPanelColumn, type WidgetsPanelRow, type WidgetsPanelCell, type WidgetId, type WidgetsOptions, type SpecificWidgetOptions, type CommonFiltersOptions, type CommonFiltersApplyMode, type FiltersIgnoringRules, } from '../domains/dashboarding/dashboard-model';

package/dist/packages/sdk-ui/src/public-api/sisense-internal.d.ts

@@ -19,7 +19,6 @@ export { QuotaNotification } from '../shared/components/quota-notification/quota
 export type { QuotaNotificationProps } from '../shared/components/quota-notification/quota-notification.js';
 export { useQuotaNotification } from '../shared/hooks/use-quota-notification.js';
 export type { QuotaNotificationOptions, QuotaApiResponse, QuotaState, } from '../shared/hooks/use-quota-notification.js';
-export type { VisualizationStateUpdate } from '../infra/plugins/widget-plugins/types.js';
 export { LoadingIndicator } from '../shared/components/loading-indicator.js';
 export { DataSchemaBrowser } from '../domains/data-browser/data-schema-browser/data-schema-browser.js';
 export { type NarrativeQueryParams } from '../domains/narrative/core/build-narrative-request.js';