@sisense/sdk-ui 2.27.0 → 2.29.0

package/dist/packages/sdk-ui/src/domains/widgets/hooks/widget-entity-id.d.ts

@@ -0,0 +1,30 @@
+import { type DataSource } from '@sisense/sdk-data';
+import type { ChartDataOptions, PivotTableDataOptions } from '../../../domains/visualizations/core/chart-data-options/types';
+import type { GenericDataOptions } from '../../../types';
+import type { WidgetType } from '../components/widget/types';
+/** Union of every widget's `dataOptions` shape (chart, pivot, custom). */
+type WidgetDataOptions = ChartDataOptions | PivotTableDataOptions | GenericDataOptions;
+/**
+ * Resolves a stable, unique `entityId` for a widget tracking event.
+ *
+ * Prefers the widget's own `id` (the Fusion widget OID when loaded via `WidgetById` /
+ * `DashboardById`, or the user-supplied id when composed). When no id is available — e.g. a
+ * standalone `<ChartWidget>` — it falls back to a deterministic hash of the widget's identity:
+ * its type, name, title, the column names of its `dataOptions`, and its data source. Two
+ * structurally identical standalone widgets therefore resolve to the same id, which is the
+ * desired behavior for adoption tracking. The fallback is prefixed with `hash:` so downstream
+ * consumers can tell a generated identifier apart from a real widget id/OID.
+ *
+ * Typed with a generic + intersection so callers pass their concrete widget prop type while the
+ * optional `id` / `dataOptions` / `dataSource` are read uniformly (e.g. `TextWidgetProps` declares
+ * none of them).
+ *
+ * @internal
+ */
+export declare const getWidgetEntityId: <P extends object>(props: P & {
+    id?: string | undefined;
+    title?: string | undefined;
+    dataOptions?: WidgetDataOptions | undefined;
+    dataSource?: DataSource | undefined;
+}, widgetType: WidgetType, widgetName: string) => string;
+export {};

package/dist/packages/sdk-ui/src/domains/widgets/hooks/widget-tracking-adapters.d.ts

@@ -0,0 +1,41 @@
+import type { ChartWidgetProps } from '../../../domains/widgets/components/chart-widget/types';
+import type { CustomWidgetProps } from '../../../domains/widgets/components/custom-widget/types';
+/**
+ * Resolves the `widgetName` tracking field for a chart widget — the visualization subtype
+ * (e.g. `'line'`, `'column'`, `'pie'`, `'streamgraph'`).
+ *
+ * @internal
+ */
+export declare const getChartWidgetName: (props: Pick<ChartWidgetProps, 'chartType'>) => string;
+/**
+ * Resolves the `widgetName` tracking field for a pivot table widget.
+ *
+ * @internal
+ */
+export declare const getPivotWidgetName: () => string;
+/**
+ * Resolves the `widgetName` tracking field for a text widget.
+ *
+ * @internal
+ */
+export declare const getTextWidgetName: () => string;
+/**
+ * Resolves the `widgetName` tracking field for a custom widget — the registered plugin name
+ * (e.g. `'my-org-bullet-chart'`).
+ *
+ * @internal
+ */
+export declare const getCustomWidgetName: (props: Pick<CustomWidgetProps, 'customWidgetType'>) => string;
+/**
+ * Reads the widget's user-facing title from props if present, otherwise `null`.
+ *
+ * Typed with a generic + intersection so callers preserve their concrete widget prop type
+ * (`ChartWidgetProps`, `PivotTableWidgetProps`, …) while making the contract — "I read an
+ * optional `title`" — explicit. The intersection sidesteps the weak-type heuristic that
+ * would otherwise reject `TextWidgetProps`, which declares no `title`.
+ *
+ * @internal
+ */
+export declare const getWidgetTitle: <P extends object>(props: P & {
+    title?: string | undefined;
+}) => string | null;

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

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings, WidgetContainerStyleOptions } from '../../../types';
+import { CompleteThemeSettingsInternal, WidgetContainerStyleOptions } from '../../../types';
 export declare enum WidgetCornerRadius {
     'None' = "",
     'Large' = "30px",
@@ -11,4 +11,33 @@ export declare enum WidgetSpaceAround {
     'Medium' = "10px",
     'Small' = "5px"
 }
-export declare const getShadowValue: (styleOptions: WidgetContainerStyleOptions | undefined, themeSettings: CompleteThemeSettings) => string;
+export declare const getShadowValue: (styleOptions: WidgetContainerStyleOptions | undefined, themeSettings: CompleteThemeSettingsInternal) => string;
+/**
+ * Resolves the effective "space around" value, in pixels, that the widget container applies
+ * as padding on each side. Reads from the widget's style options first, then falls back to
+ * the theme's widget settings.
+ *
+ * @param styleOptions - The widget container style options.
+ * @param themeSettings - The complete theme settings.
+ * @returns The space around value in pixels (0 when unset or "None").
+ * @internal
+ */
+export declare const getSpaceAroundPx: (styleOptions: WidgetContainerStyleOptions | undefined, themeSettings: CompleteThemeSettingsInternal) => number;
+/**
+ * Calculates the total non-content vertical space, in pixels, that the widget container reserves —
+ * the header (when visible) plus the top and bottom "space around" padding.
+ *
+ * Auto-sized widget content must add this overhead to its measured content height so that the
+ * visible content area (after the container subtracts its padding and header) matches the
+ * content's intended height. Without it, the bottom of the content is clipped by the container's
+ * `overflow: hidden`.
+ *
+ * @param options - The overhead height options.
+ * @returns The total overhead height in pixels.
+ * @internal
+ */
+export declare const getWidgetOverheadHeight: ({ styleOptions, themeSettings, hasHeader, }: {
+    styleOptions: WidgetContainerStyleOptions | undefined;
+    themeSettings: CompleteThemeSettingsInternal;
+    hasHeader: boolean;
+}) => number;

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

@@ -1,6 +1,6 @@
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { AppSettings } from '../../../infra/app/settings/settings';
-import { CompleteThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal } from '../../../types';
 import { WidgetModel } from './widget-model';
 /**
  * Retrieves a widget model by its OID.
@@ -13,4 +13,4 @@ import { WidgetModel } from './widget-model';
  * @returns The widget model
  * @internal
  */
-export declare function getWidgetModel(httpClient: HttpClient, dashboardOid: string, widgetOid: string, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): Promise<WidgetModel>;
+export declare function getWidgetModel(httpClient: HttpClient, dashboardOid: string, widgetOid: string, themeSettings?: CompleteThemeSettingsInternal, appSettings?: AppSettings): Promise<WidgetModel>;

package/dist/packages/sdk-ui/src/domains/widgets/widget-model/widget-model-translator/to-widget-dto-panels.d.ts

@@ -1,4 +1,4 @@
-import { AreamapChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, IndicatorChartDataOptions, PivotTableDataOptions, ScatterChartDataOptions, ScattermapChartDataOptions, TableDataOptionsInternal } from '../../../../domains/visualizations/core/chart-data-options/types.js';
+import { AreamapChartDataOptions, BoxplotChartDataOptions, CalendarHeatmapChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, IndicatorChartDataOptions, PivotTableDataOptions, ScatterChartDataOptions, ScattermapChartDataOptions, TableDataOptionsInternal } from '../../../../domains/visualizations/core/chart-data-options/types.js';
 import { Panel } from '../../../../domains/widgets/components/widget-by-id/types.js';
 import type { GenericDataOptions } from '../../../../types.js';
 import { ScattermapStyleOptions } from '../../../../types.js';
@@ -169,6 +169,34 @@ export declare function toScattermapPanels(dataOptions: ScattermapChartDataOptio
  * @internal
  */
 export declare function toAreamapPanels(dataOptions: AreamapChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a boxplot chart widget. Emits `category` (0 or 1 attribute)
+ * and `value` (the single target numeric attribute, treated as an attribute — not a
+ * measure — to match the inverse read in `extractBoxplotChartDataOptions`). The
+ * derived box/whisker measures live on `style.whisker` rather than on panels, so
+ * they are written by {@link toBoxplotWidgetStyle} instead.
+ *
+ * @param dataOptions - Boxplot chart data options from the WidgetModel
+ * @returns Fusion panels in fixed order: category, value
+ * @internal
+ */
+export declare function toBoxplotPanels(dataOptions: BoxplotChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a calendar-heatmap widget. The Fusion `heatmap` manifest declares
+ * `date` (single attribute) and `color` (single measure) panels — both are always emitted,
+ * matching the inverse read in {@link extractCaledarHeatmapChartDataOptions}: an empty
+ * `items: []` array is written when a slot has no column so Fusion's renderer can locate
+ * each declared panel by name.
+ *
+ * Note: the DTO panel name for the measure slot is `color`, not `value` — the SDK's
+ * {@link CalendarHeatmapChartDataOptions.value} is read from / written to the panel named
+ * `color`.
+ *
+ * @param dataOptions - Calendar heatmap chart data options from the WidgetModel
+ * @returns Fusion panels: date, color
+ * @internal
+ */
+export declare function toCalendarHeatmapPanels(dataOptions: CalendarHeatmapChartDataOptions): Panel[];
 /**
  * Builds DTO panels for a plugin / custom widget. Each key in {@link GenericDataOptions}
  * becomes one panel; every Column is normalised then converted to a JAQL panel item via

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

@@ -10,7 +10,7 @@ import { WidgetDto } from '../../../../domains/widgets/components/widget-by-id/t
 import { WidgetProps } from '../../../../domains/widgets/components/widget/types';
 import { AppSettings } from '../../../../infra/app/settings/settings.js';
 import { ChartProps, PivotTableProps, TableProps } from '../../../../props';
-import { CompleteThemeSettings } from '../../../../types.js';
+import { CompleteThemeSettingsInternal } from '../../../../types.js';
 import { WidgetModel } from '../widget-model';
 /**
  * Translates a {@link WidgetModel} to the parameters for executing a query for the widget.
@@ -160,7 +160,7 @@ export declare function toJtdConfig(widgetModel: WidgetModel): JumpToDashboardCo
  * @returns The widget model
  * @internal
  */
-export declare function fromWidgetDto(widgetDto: WidgetDto, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): WidgetModel;
+export declare function fromWidgetDto(widgetDto: WidgetDto, themeSettings?: CompleteThemeSettingsInternal, appSettings?: AppSettings): WidgetModel;
 /**
  * Creates a {@link WidgetModel} from a {@link ChartWidgetProps}.
  *
@@ -212,4 +212,4 @@ export declare function fromWidgetProps(widgetProps: WidgetProps): WidgetModel;
  *
  * @sisenseInternal
  */
-export declare function toWidgetDto(widgetModel: WidgetModel, dataSource?: JaqlDataSourceForDto, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): WidgetDto;
+export declare function toWidgetDto(widgetModel: WidgetModel, dataSource?: JaqlDataSourceForDto, themeSettings?: CompleteThemeSettingsInternal, appSettings?: AppSettings): WidgetDto;

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

@@ -25,6 +25,7 @@ type GetDashboardsOptions = {
 type GetDashboardOptions = {
     fields?: string[];
     sharedMode?: boolean;
+    adminAccess?: boolean;
 };
 export declare class RestApi {
     private httpClient;
@@ -55,7 +56,7 @@ export declare class RestApi {
     /**
      * Get a specific dashboard using the legacy API version
      */
-    getDashboardLegacy: (dashboardOid: string) => Promise<DashboardDto | undefined>;
+    getDashboardLegacy: (dashboardOid: string, options?: GetDashboardOptions) => Promise<DashboardDto | undefined>;
     /**
      * Get all widgets of a specific dashboard
      */
@@ -123,6 +124,13 @@ export declare class RestApi {
         count?: number;
         searchValue?: string;
     }) => Promise<DataSourceField[] | undefined>;
+    /**
+     * Export JAQL query results as an XLSX file (binary response).
+     *
+     * @param body - JSON payload for the JAQL export API
+     * @returns XLSX file as a {@link Blob}
+     */
+    exportJaqlToXlsx: (body: object) => Promise<Blob | undefined>;
 }
 export declare const useRestApi: () => {
     restApi: RestApi | undefined;

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

@@ -2,18 +2,33 @@ import { HttpClient } from '@sisense/sdk-rest-client';
 import { AppConfig, ThemeSettings } from '../../../types';
 import { LegacyDesignSettings } from '../../themes/legacy-design-settings.js';
 import { FeatureMap } from './types/features.js';
+/**
+ * Known AI feature flags exposed on {@link AppSettings} `ai.featureFlags`.
+ * Add a flag here when you want first-class typing/autocomplete for it; otherwise
+ * it still surfaces via the index signature on {@link AiFeatureFlags}.
+ */
+type KnownAiFeatureFlags = {
+    naturalResponseEnabled: boolean;
+    queryDefinition: boolean;
+};
+/**
+ * Loose, forward-compatible shape of `ai.featureFlags`. Known flags are strongly typed
+ * (see {@link KnownAiFeatureFlags}); arbitrary string-keyed flags are type-allowed
+ * for forward compatibility (unknown keys are readable as `boolean | undefined`)
+ * without requiring a CSDK type bump.
+ *
+ * @sisenseInternal
+ */
+export type AiFeatureFlags = KnownAiFeatureFlags & {
+    [flag: string]: boolean | undefined;
+};
 /**
  * AI-related slice derived from globals (`serverFeatures` + deployment props),
  * aligned with admin UI paths such as `ai.featureFlags.*`, `ai.featureModelType`,
- * `ai.quotaNotification`, and `ai.aiStudio.*`.
+ * and `ai.quotaNotification`.
  */
 type AiSettingsSlice = {
-    featureFlags: {
-        completionV2: boolean;
-        naturalResponseEnabled: boolean;
-        nlqV3Enabled: boolean;
-        queryDefinition: boolean;
-    };
+    featureFlags: AiFeatureFlags;
     /**
      * Only when `serverFeatures.aiAssistant` exists.
      * If the block is present but omits this field, defaults to `customer_byok`.
@@ -21,10 +36,6 @@ type AiSettingsSlice = {
      */
     featureModelType?: string;
     quotaNotification: boolean;
-    aiStudio: {
-        realtime: boolean;
-        usageDisplay: boolean;
-    };
 };
 /**
  * Application settings
@@ -112,6 +123,8 @@ type ServerSettings = {
         lastName?: string;
         /** From `api/globals` `user.email`. */
         email?: string;
+        /** From `api/globals` `user.baseRoleName`. */
+        baseRoleName?: string;
     };
     /**
      * Raw Fusion `designSettings` from `api/globals` (before palette / theme conversion).

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

@@ -122,22 +122,14 @@ type CloudCDNFeature = Feature<'cloudCDN'>;
 type OnboardingFeature = Feature<'onboarding'>;
 type AiAssistantFeature = Feature<'aiAssistant', {
     unified?: boolean;
-    nlqV3Enabled?: boolean;
-    isNlqV3Enabled?: boolean;
     naturalResponseEnabled?: boolean;
     queryDefinition?: boolean;
-    completionV2?: boolean;
     sharedFormulasEnabled?: boolean;
     aiAccessControl?: string;
     quotaNotification?: boolean;
     featureModelType?: string;
 }>;
-type AiStudioFeature = Feature<'aiStudio', {
-    realtime?: boolean;
-    usageDisplay?: boolean;
-    isRealtimeEnabled?: boolean;
-    isUsageDisplayEnabled?: boolean;
-}>;
+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)[];

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

@@ -3,6 +3,7 @@ import { PivotQueryClient } from '@sisense/sdk-pivot-query-client';
 import { QueryClient } from '@sisense/sdk-query-client';
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { TrackingEventDetails } from '@sisense/sdk-tracking';
+import type { Locale } from 'date-fns';
 import { DateConfig, LoadingIndicatorConfig, TranslationConfig } from '../../types';
 import { AppSettings } from './settings/settings';
 /**
@@ -190,6 +191,19 @@ export type AppConfig = {
              */
             alwaysShowResultsPerPage?: boolean;
         };
+        /**
+         * Configuration of the default number formatting for visualizations.
+         *
+         * @sisenseInternal
+         */
+        defaultNumberFormatting?: {
+            /**
+             *  If `false`, raw values are displayed without applying the default number formatting configuration.
+             *
+             * @default true
+             */
+            enabled?: boolean;
+        };
     };
 };
 /**

package/dist/packages/sdk-ui/src/infra/contexts/sisense-context/sisense-context-provider.d.ts

@@ -1,4 +1,4 @@
-import { type FunctionComponent, PropsWithChildren } from 'react';
+import { type FunctionComponent, type PropsWithChildren } from 'react';
 import { SisenseContextProviderProps } from '../../../props';
 /**
  * Sisense Context Provider Component allowing you to connect to

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/custom-theme-provider.d.ts

@@ -1,8 +1,8 @@
 import { PropsWithChildren } from 'react';
-import { CompleteThemeSettings, CustomContextProviderProps } from '../../../types';
+import { CompleteThemeSettingsInternal, CustomContextProviderProps } from '../../../types';
 /** @internal */
 export type CustomThemeProviderProps = CustomContextProviderProps<{
-    themeSettings: CompleteThemeSettings;
+    themeSettings: CompleteThemeSettingsInternal;
     skipTracking?: boolean;
 }>;
 /**

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/default-theme-settings.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal } from '../../../types';
 export declare const DEFAULT_DIVIDER_COLOR = "#F2F2F2";
 export declare const DEFAULT_DIVIDER_WIDTH = 4;
 export declare const DEFAULT_DASHBOARD_BORDER_COLOR = "#D5D5D5";
@@ -19,4 +19,4 @@ export declare const DEFAULT_HYPERLINK_HOVER_COLOR = "#1FCCF3";
  * @returns Theme settings object
  * @internal
  */
-export declare const getDefaultThemeSettings: (isDarkMode?: boolean) => CompleteThemeSettings;
+export declare const getDefaultThemeSettings: (isDarkMode?: boolean) => CompleteThemeSettingsInternal;

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/index.d.ts

@@ -1,2 +1,3 @@
 export * from './theme-provider';
 export * from './theme-context';
+export * from './use-theme';

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/theme-context.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
-import { CompleteThemeSettings, ThemeConfig } from '../../../types';
+import { CompleteThemeSettingsInternal, ThemeConfig } from '../../../types';
 export declare const ThemeContext: import("react").Context<{
-    themeSettings: CompleteThemeSettings;
+    themeSettings: CompleteThemeSettingsInternal;
     config?: ThemeConfig | undefined;
 }>;
 /**
@@ -12,6 +12,6 @@ export declare const ThemeContext: import("react").Context<{
  * @sisenseInternal
  */
 export declare const useThemeContext: () => {
-    themeSettings: CompleteThemeSettings;
+    themeSettings: CompleteThemeSettingsInternal;
     config?: ThemeConfig | undefined;
 };

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/types.d.ts

@@ -1,7 +1,7 @@
-import { CompleteThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal } from '../../../types';
 /**
  * Themable interface for styled components that require theme settings.
  */
 export type Themable = {
-    theme: CompleteThemeSettings;
+    theme: CompleteThemeSettingsInternal;
 };

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/use-theme-settings.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings, ThemeOid, ThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal, ThemeOid, ThemeSettings } from '../../../types';
 /**
  * Returns the theme settings for the given theme OID or theme settings and error if it happened.
  *
@@ -9,4 +9,4 @@ import { CompleteThemeSettings, ThemeOid, ThemeSettings } from '../../../types';
  * @param userTheme Theme OID or theme settings object
  * @returns Theme settings and error if it happened
  */
-export declare function useThemeSettings(userTheme?: ThemeOid | ThemeSettings): [CompleteThemeSettings, null] | [null, Error];
+export declare function useThemeSettings(userTheme?: ThemeOid | ThemeSettings): [CompleteThemeSettingsInternal, null] | [null, Error];

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/use-theme.d.ts

@@ -0,0 +1,14 @@
+import { CompleteThemeSettings } from '../../../types';
+/**
+ * Returns the resolved theme from the nearest {@link ThemeProvider}.
+ * Falls back to the default theme when no provider is present.
+ *
+ * @example
+ * ```tsx
+ * const { palette, typography, widget } = useTheme();
+ * ```
+ *
+ * @returns Resolved {@link CompleteThemeSettings}
+ * @group Contexts
+ */
+export declare const useTheme: () => CompleteThemeSettings;

package/dist/packages/sdk-ui/src/infra/formatting/format-data-set.d.ts

@@ -0,0 +1,21 @@
+import { Data, QueryResultData } from '@sisense/sdk-data';
+import { CommonDataOptions } from '../../domains/visualizations/core/chart-data-options/types';
+import { FormatDateOptions } from './format-date';
+/**
+ * Options for {@link formatDataSet}.
+ */
+export type FormatDataSetOptions = FormatDateOptions;
+/**
+ * Formats a data set by applying the number and date formatting declared in `dataOptions` to a data set.
+ * Writes the formatted result into each affected cell's `text` property.
+ *
+ * @example
+ * const formattedData = formatDataSet(data, dataOptions);
+ *
+ * @param data - Query result or user-provided data set.
+ * @param dataOptions - Any chart, pivot, or custom-widget data options.
+ * @param options - Formatting options.
+ * @returns A new data set with formatted `text` values on affected cells.
+ * @group Formatting
+ */
+export declare function formatDataSet<DataSet extends QueryResultData | Data>(data: DataSet, dataOptions: CommonDataOptions, options?: FormatDataSetOptions): DataSet;

package/dist/packages/sdk-ui/src/infra/formatting/format-date.d.ts

@@ -0,0 +1,67 @@
+import type { Locale } from 'date-fns';
+import type { DateConfig } from '../../domains/query-execution/core/date-formats';
+/**
+ * Options for {@link formatDate}.
+ */
+export type FormatDateOptions = {
+    /**
+     * A [date-fns Locale](https://date-fns.org/v2.30.0/docs/Locale) for language-specific formatting.
+     * Defaults to 'en-US'.
+     */
+    locale?: Locale;
+    /**
+     * Fiscal year, timezone, and date-level configuration.
+     */
+    dateConfig?: DateConfig;
+};
+/**
+ * Formats a single date value (Date instance or ISO 8601 string) using the
+ * provided format mask.
+ *
+ * Accepts standard [date-fns format tokens](https://date-fns.org/v2.30.0/docs/format)
+ * plus the SDK's extended Angular-style masks (locale-aware; examples use en-US):
+ *
+ * ```
+ * shortDate   → '3/15/26'                  (M/d/yy)
+ * mediumDate  → 'Mar 15, 2026'             (MMM d, y)
+ * longDate    → 'March 15, 2026'           (MMMM d, y)
+ * fullDate    → 'Sunday, March 15, 2026'   (EEEE, MMMM d, y)
+ * shortTime   → '1:45 PM'                  (h:mm a)
+ * mediumTime  → '1:45:00 PM'               (h:mm:ss a)
+ * short       → '3/15/26 1:45 PM'          (M/d/yy h:mm a)
+ * medium      → 'Mar 15, 2026 1:45:00 PM'  (MMM d, y h:mm:ss a)
+ * ```
+ *
+ * Returns the input unchanged if it matches the reserved "not available" value (`'N\A'`).
+ *
+ * @example
+ * formatDate(new Date('2026-03-15'), 'MM/yyyy');
+ * // returns '03/2026'
+ *
+ * formatDate('2026-03-15T13:45:00Z', 'shortDate');
+ * // returns '3/15/26'  (en-US locale)
+ *
+ * formatDate('2026-03-15T13:45:00Z', 'mediumDate');
+ * // returns 'Mar 15, 2026'
+ *
+ * @param value - Date value to format.
+ * @param format - Format mask string (date-fns tokens or SDK extended masks).
+ * @param options - Optional locale and date configuration.
+ * @returns Formatted date string.
+ * @group Formatting
+ */
+export declare function formatDate(value: Date | string, format: string, options?: FormatDateOptions): string;
+/**
+ * Returns a default date-format mask for a given granularity level from {@link @sisense/sdk-data!DateLevels | `DateLevels`}
+ *
+ * Falls back to default `'fullDate'` for unknown or absent granularities.
+ *
+ * @example
+ * getDefaultDateFormat('months'); // 'MM/yyyy'
+ * getDefaultDateFormat('years');  // 'yyyy'
+ * getDefaultDateFormat('days');   // 'shortDate'
+ * @param granularity - Optional granularity string.
+ * @returns A date-format mask string.
+ * @group Formatting
+ */
+export declare function getDefaultDateFormat(granularity?: string): string;

package/dist/packages/sdk-ui/src/infra/formatting/format-number.d.ts

@@ -0,0 +1,24 @@
+import type { NumberFormatConfig } from '../../types';
+/**
+ * Formats a single numeric value using the provided {@link NumberFormatConfig}.
+ *
+ * Missing config falls back to defaults:
+ * Numbers type, auto decimal scale, thousand separator enabled, all abbreviations (K/M/B/T) enabled.
+ *
+ * Returns an empty string when `value` is `NaN`.
+ *
+ * @example
+ * formatNumber(1234567);
+ * // returns '1.23M'
+ *
+ * formatNumber(0.42, { name: 'Percent', decimalScale: 1 });
+ * // returns '42.0%'
+ *
+ * formatNumber(1500, { name: 'Currency', symbol: '€', prefix: true });
+ * // returns '€1.5K'
+ * @param value - The numeric value to format.
+ * @param config - Formatting configuration.
+ * @returns Formatted string representation of the value.
+ * @group Formatting
+ */
+export declare function formatNumber(value: number, config?: NumberFormatConfig): string;

package/dist/packages/sdk-ui/src/infra/formatting/index.d.ts

@@ -0,0 +1,5 @@
+export { formatNumber } from './format-number';
+export { formatDate, getDefaultDateFormat } from './format-date';
+export { formatDataSet } from './format-data-set';
+export type { FormatDateOptions } from './format-date';
+export type { FormatDataSetOptions } from './format-data-set';

package/dist/packages/sdk-ui/src/infra/modules/build-module-graph.d.ts

@@ -0,0 +1,31 @@
+import type { Module } from './types.js';
+/** Normalised view of a `ModuleRequirement`. */
+interface NormalizedRequirement {
+    name: string;
+    optional: boolean;
+    requiredVersion?: string;
+}
+/** A module after graph resolution, with its normalised requirements attached. */
+export interface ResolvedModule {
+    module: Module;
+    requirements: NormalizedRequirement[];
+    /**
+     * Names of soft requirements that were absent or version-incompatible at boot.
+     * Integrations targeting these names are silently dropped.
+     */
+    missingOptionalTargets: Set<string>;
+}
+/**
+ * Builds the validated, topologically-ordered module graph from the given roots.
+ *
+ * - Recursively expands `includes` and dedupes by `name` (versions must match).
+ * - Validates every hard `requires` target is present and its version satisfies
+ *   any declared `requiredVersion`.
+ * - Drops contributions to soft requirements (`optional: true`) that are missing
+ *   or version-incompatible.
+ * - Validates each integration targets a declared requirement and a known field
+ *   on the target's `api`.
+ * - Returns modules sorted so each appears after its requirements.
+ */
+export declare const buildModuleGraph: (modules: ReadonlyArray<Module>) => ResolvedModule[];
+export {};

package/dist/packages/sdk-ui/src/infra/modules/build-module-registry.d.ts

@@ -0,0 +1,31 @@
+import type { Module } from './types.js';
+/**
+ * Modules API registry.
+ *
+ * Each registry is an opaque value produced by the owning module's
+ * `ApiField.createRegistry` and written to by every contributor's
+ * `ApiField.register`. Keyed by `(moduleName, fieldName)` to keep field names
+ * scoped to their owning module.
+ */
+export interface ModulesApiRegistry {
+    /** Returns the registry for a module's API field, or `undefined` if absent. */
+    get(moduleName: string, fieldName: string): unknown;
+    /** Whether the given module's API field has a registry in this store. */
+    has(moduleName: string, fieldName: string): boolean;
+}
+/** Result of building a module registry from a set of user-provided modules. */
+export interface ModulesRegistry {
+    /** Registered modules array (in topological order) */
+    modules: Module[];
+    /** Modules api registry. */
+    apiRegistry: ModulesApiRegistry;
+}
+/**
+ * Builds a per-`ModuleProvider` registry from the given user-provided modules.
+ *
+ * - Always includes `CoreModule`.
+ * - Builds and validates the module graph (`buildModuleGraph`).
+ * - Creates a fresh registry per API field via `ApiField.createRegistry`.
+ * - Applies every contribution in topological order via `ApiField.register`.
+ */
+export declare const buildModuleRegistry: (modules?: ReadonlyArray<Module>) => ModulesRegistry;

package/dist/packages/sdk-ui/src/infra/modules/core-module-providers-tree.d.ts

@@ -0,0 +1,11 @@
+import { type FunctionComponent, type PropsWithChildren } from 'react';
+/**
+ * Registers providers passed via the `core.providers` API.
+ *
+ * The registry is read from the enclosing `ModuleProvider`, so each
+ * `SisenseContextProvider` instance mounts only the providers contributed by
+ * the modules it registered. Providers are mounted in registration
+ * (topological) order — the first entry is the outermost wrapper.
+ *
+ */
+export declare const CoreModuleProvidersTree: FunctionComponent<PropsWithChildren>;