@sisense/sdk-ui 2.28.0 → 2.29.0

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

@@ -1,7 +1,8 @@
 import type { PivotGrandTotals } from '@sisense/sdk-data';
+import type { BoxWhiskerType } from '../../../../../domains/visualizations/core/chart-data-options/types.js';
 import { AppSettings } from '../../../../../infra/app/settings/settings.js';
-import type { AreamapType, AreaStyleOptions, AxisLabel, CompleteThemeSettingsInternal, DataLimits, FunnelStyleOptions, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, ScattermapStyleOptions, ScatterStyleOptions, SeriesLabels, StackableStyleOptions, SunburstStyleOptions, TableStyleOptions, TreemapStyleOptions, WidgetStyleOptions } from '../../../../../types.js';
-import type { AxisStyle, CartesianWidgetStyle, FunnelWidgetStyle, PivotWidgetStyle, PolarWidgetStyle, ScattermapWidgetStyle, ScatterWidgetStyle, SunburstWidgetStyle, TableWidgetStyle, TreemapWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
+import type { AreamapType, AreaStyleOptions, AxisLabel, BoxplotStyleOptions, CalendarHeatmapStyleOptions, CompleteThemeSettingsInternal, DataLimits, FunnelStyleOptions, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, ScattermapStyleOptions, ScatterStyleOptions, SeriesLabels, StackableStyleOptions, SunburstStyleOptions, TableStyleOptions, TreemapStyleOptions, WidgetStyleOptions } from '../../../../../types.js';
+import type { AxisStyle, BoxplotWidgetStyle, CalendarHeatmapWidgetStyle, CartesianWidgetStyle, FunnelWidgetStyle, PivotWidgetStyle, PolarWidgetStyle, ScattermapWidgetStyle, ScatterWidgetStyle, SunburstWidgetStyle, TableWidgetStyle, TreemapWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
 /**
  * Maps SDK legend options to Fusion DTO legend style.
  *
@@ -211,6 +212,44 @@ export declare function toScattermapWidgetStyle(styleOptions: ScattermapStyleOpt
  * @internal
  */
 export declare function toAreamapSubtype(mapType?: AreamapType): 'areamap/world' | 'areamap/usa';
+/**
+ * Converts boxplot style options to Fusion BoxplotWidgetStyle DTO.
+ * Inverse of `extractBoxplotChartStyleOptions`.
+ *
+ * The whisker algorithm (`boxType`) and `outliersEnabled` flag live on
+ * {@link BoxplotChartDataOptions} in the WidgetModel rather than on `styleOptions`,
+ * so they are passed in separately. `boxType` defaults to `'iqr'` — the same default
+ * the boxplot translator falls back to when no whisker flag is selected.
+ *
+ * @param styleOptions - Boxplot style options from WidgetModel.styleOptions
+ * @param boxType - Whisker algorithm from WidgetModel.dataOptions.boxType
+ * @param outliersEnabled - Whether to render boxplot outliers
+ * @returns Fusion BoxplotWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toBoxplotWidgetStyle(styleOptions: BoxplotStyleOptions, boxType?: BoxWhiskerType, outliersEnabled?: boolean): BoxplotWidgetStyle;
+/**
+ * Converts calendar-heatmap style options to Fusion CalendarHeatmapWidgetStyle DTO.
+ * Inverse of {@link extractCalendarHeatmapChartStyleOptions}.
+ *
+ * Only the fields the inverse extractor reads are round-trippable. Cosmetic fields
+ * that the extractor synthesizes from {@link CALENDAR_HEATMAP_DEFAULTS}
+ * (`monthLabels.enabled`, `weekends.cellColor`, `weekends.hideValues`,
+ * `pagination.enabled`) are not written back because the Fusion DTO has no fields
+ * for them.
+ *
+ * The CSDK `subtype` (`'calendar-heatmap/split' | 'calendar-heatmap/continuous'`)
+ * is NOT the DTO `subtype` — the DTO uses `'heatmap'` and encodes view as the
+ * `'view/weekly'` / `'view/monthly'` style flags.
+ *
+ * `pagination.startMonth` is emitted as `{year, month}` because Fusion's startMonth
+ * object form is the canonical write shape; the string form is read-only legacy input.
+ *
+ * @param styleOptions - Calendar heatmap style options from WidgetModel.styleOptions
+ * @returns Fusion CalendarHeatmapWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toCalendarHeatmapWidgetStyle(styleOptions: CalendarHeatmapStyleOptions): CalendarHeatmapWidgetStyle;
 /**
  * Converts table style options to Fusion TableWidgetStyle DTO.
  * Used when serializing a table widget back to WidgetDto.

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

@@ -77,6 +77,12 @@ export interface WidgetDto {
         supportsHierarchies?: boolean;
         imageColumns?: number[];
     };
+    /**
+     * Custom-widget-specific runtime options bag, persisted across reloads for
+     * custom (plugin) widgets. Round-trips opaquely between the Fusion DTO and the
+     * CSDK widget model's `customOptions`.
+     */
+    customOptions?: Record<string, unknown>;
     source?: any;
     owner?: string;
     userId?: string;

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-track-widget-init.d.ts

@@ -0,0 +1,44 @@
+import type { WidgetType } from '../components/widget/types';
+/**
+ * Fully resolved options for {@link useTrackWidgetInit}. The caller (a leaf widget) is
+ * responsible for deriving each field from its own props so the hook stays free of
+ * widget-shape concerns and runtime type casts.
+ *
+ * @internal
+ */
+export type UseTrackWidgetInitOptions = {
+    /** Widget type (chart / pivot / text / custom). */
+    widgetType: WidgetType;
+    /** Resolved widget kind — chart subtype, plugin name, or fixed string for pivot/text. */
+    widgetName: string;
+    /** Widget title entered by the designer, or `null` if absent. */
+    widgetTitle: string | null;
+    /** Stable unique widget identifier — the widget id/OID when available, otherwise a content hash. */
+    entityId: string;
+    /**
+     * When `false`, the event is suppressed. Pass the caller's render preconditions here
+     * (e.g. `!!(chartType && dataOptions)` for `ChartWidget`) so we do not count mounts
+     * whose render body early-returns `null`. The event fires once when this flips to `true`.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+};
+/**
+ * Fires the `sdkWidgetInit` tracking event exactly once per widget mount.
+ *
+ * Behavioral note: unlike `useTrackComponentInit`, this hook intentionally
+ * IGNORES `TrackingContextProvider`'s skip-nested signal. Widgets rendered inside
+ * a tracked parent (e.g. a `<Dashboard>`) must still emit `sdkWidgetInit`, since
+ * the event must count every widget render regardless of nesting.
+ *
+ * The payload includes envelope overrides (`eventType: 'action'`,
+ * `featureName: 'composesdk'`, `entityType: 'widget'`) that override the defaults
+ * set by `trackProductEvent`, as required by the data-tracking spec.
+ *
+ * `widgetTitle` is emitted as `null` rather than `undefined` when absent, matching the
+ * spec's "null or [empty]" wire convention.
+ *
+ * @internal
+ */
+export declare const useTrackWidgetInit: (options: UseTrackWidgetInitOptions) => void;

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

@@ -12,3 +12,32 @@ export declare enum WidgetSpaceAround {
     'Small' = "5px"
 }
 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/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/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
      */

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

@@ -8,9 +8,7 @@ import { FeatureMap } from './types/features.js';
  * it still surfaces via the index signature on {@link AiFeatureFlags}.
  */
 type KnownAiFeatureFlags = {
-    completionV2: boolean;
     naturalResponseEnabled: boolean;
-    nlqV3Enabled: boolean;
     queryDefinition: boolean;
 };
 /**
@@ -27,7 +25,7 @@ export type AiFeatureFlags = KnownAiFeatureFlags & {
 /**
  * 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: AiFeatureFlags;
@@ -38,10 +36,6 @@ type AiSettingsSlice = {
      */
     featureModelType?: string;
     quotaNotification: boolean;
-    aiStudio: {
-        realtime: boolean;
-        usageDisplay: boolean;
-    };
 };
 /**
  * Application settings

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/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>;

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

@@ -0,0 +1,26 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { ApiContract, ApiField, Module } from './types.js';
+type ProviderComponent = ComponentType<{
+    children: ReactNode;
+}>;
+/**
+ * API declaration for the `core` module.
+ */
+export interface CoreModuleApiDefinition {
+    /** Root-level React providers mounted by `SisenseContextProvider`. */
+    providers: ApiField<ProviderComponent[], ProviderComponent[]>;
+}
+/**
+ * API contract for contributing to the `core` module.
+ */
+export type CoreModuleApi = ApiContract<CoreModuleApiDefinition>;
+export declare const CORE_MODULE_NAME = "core";
+/**
+ * The `core` module.
+ * Always registered automatically by `ModuleProvider`; consumers do not need to list it in the `modules` prop.
+ *
+ * Owns the `providers` registry — other modules contribute root-level React
+ * providers there, which `CoreModuleProvidersTree` mounts inside `SisenseContextProvider`.
+ */
+export declare const CoreModule: Module<CoreModuleApiDefinition>;
+export {};

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

@@ -0,0 +1,3 @@
+export type { Module, ModuleRequirement } from './types.js';
+export { useModuleApiRegistry } from './modules-context.js';
+export { ModuleProvider, type ModuleProviderProps } from './module-provider.js';

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

@@ -0,0 +1,17 @@
+import { type FunctionComponent, type PropsWithChildren } from 'react';
+import type { Module } from './types.js';
+/**
+ * Props for `ModuleProvider`.
+ */
+export interface ModuleProviderProps {
+    /**
+     * Modules to register.
+     *
+     * `CoreModule` is registered automatically; consumers do not need to list it.
+     */
+    modules?: ReadonlyArray<Module>;
+}
+/**
+ * Registers the given modules and makes the API registry available to the children.
+ */
+export declare const ModuleProvider: FunctionComponent<PropsWithChildren<ModuleProviderProps>>;

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

@@ -0,0 +1,20 @@
+/// <reference types="react" />
+import type { ModulesApiRegistry } from './build-module-registry.js';
+import type { Module, RegistryOf } from './types.js';
+/**
+ * Modules API registry context.
+ */
+export declare const ModulesContext: import("react").Context<ModulesApiRegistry | null>;
+/**
+ * Gives access to the API registry for a given module and field.
+ *
+ * @example
+ * ```ts
+ * const chartBuilders = useModuleApiRegistry(VisualizationsModule, 'chartBuilders');
+ * ```
+ * @throws if used outside a `ModuleProvider`.
+ * @throws if `module` was not registered in the enclosing provider.
+ *
+ * @alpha
+ */
+export declare const useModuleApiRegistry: <TSchema, K extends keyof TSchema & string>(module: Module<TSchema>, field: K) => RegistryOf<TSchema, K>;