@sisense/sdk-ui 2.21.0 → 2.23.0

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

@@ -120,7 +120,25 @@ type DimensionalModelingFeature = {
 };
 type CloudCDNFeature = Feature<'cloudCDN'>;
 type OnboardingFeature = Feature<'onboarding'>;
-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)[];
+type AiAssistantFeature = Feature<'aiAssistant', {
+    unified?: boolean;
+    nlqV3Enabled?: boolean;
+    isNlqV3Enabled?: boolean;
+    naturalResponseEnabled?: boolean;
+    sharedFormulasEnabled?: boolean;
+    aiAccessControl?: string;
+    quotaNotification?: boolean;
+    featureModelType?: string;
+}>;
+type AiStudioFeature = Feature<'aiStudio', {
+    realtime?: boolean;
+    usageDisplay?: boolean;
+    isRealtimeEnabled?: boolean;
+    isUsageDisplayEnabled?: boolean;
+}>;
+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 FeatureByKey<K extends string> = Extract<Features[number], {
     key: K;
 }>;

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

@@ -0,0 +1,236 @@
+import { DataSource } from '@sisense/sdk-data';
+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 { DateConfig, LoadingIndicatorConfig, TranslationConfig } from '../../types';
+import { AppSettings } from './settings/settings';
+/**
+ * Application configuration
+ */
+export type AppConfig = {
+    /**
+     * A [date-fns Locale](https://date-fns.org/v2.30.0/docs/Locale)
+     */
+    locale?: Locale;
+    /**
+     * Translation Configuration
+     */
+    translationConfig?: TranslationConfig;
+    /**
+     * Date Configurations
+     */
+    dateConfig?: DateConfig;
+    /**
+     * Loading Indicator Configurations
+     */
+    loadingIndicatorConfig?: LoadingIndicatorConfig;
+    /**
+     * Query Cache Configurations.
+     *
+     * See [Client query caching guide](/guides/sdk/guides/client-query-caching.html) for more details.
+     *
+     * @beta
+     */
+    queryCacheConfig?: {
+        /**
+         * Whether to enable client-side query caching.
+         *
+         * If not specified, the default value is `false`
+         */
+        enabled?: boolean;
+    };
+    /**
+     * Query limit (max rows count that will be fetched in query)
+     *
+     * @default 20000
+     */
+    queryLimit?: number;
+    /**
+     * Accessibility configuration. Set the `accessibilityConfig.enabled` property to `true` to enable accessibility features for charts built with Highcharts.
+     *
+     * Once the accessibility configuration in enabled, you can use the default descriptions or choose to create custom configurations for the descriptions of a chart, its axes, its series, and values description formatting. To create custom configurations, use the `highchartsOptions` object that is passed to the {@link BeforeRenderHandler} of the chart's `onBeforeRender` callback. Modify the object using the accessibility options as described in the [Accessibility module documentation](https://www.highcharts.com/docs/accessibility/accessibility-module).
+     *
+     * Note that enabling accessibility also causes markers to appear in charts even if they are disabled using the chart's `styleOptions`.
+     *
+     * This feature is in alpha.
+     */
+    accessibilityConfig?: {
+        /**
+         * Whether to enable accessibility features
+         *
+         * If not specified, the default value is `false`
+         */
+        enabled?: boolean;
+    };
+    /**
+     * Configuration of the tabber widgets feature
+     *
+     * Only tabber widgets that are configured using the Fusion UI as documented [here](https://docs.sisense.com/main/SisenseLinux/tabber.htm#Creating) are supported.
+     */
+    tabberConfig?: {
+        /**
+         * Whether to enable tabber widget support
+         *
+         * If not specified, the default value is `true`
+         *
+         * @deprecated Tabber widgets are now supported by default and this property is no longer needed.
+         */
+        enabled?: boolean;
+    };
+    /**
+     * Configuration of the component that is rendered in case of an error
+     */
+    errorBoundaryConfig?: {
+        /**
+         * Whether to show error text without hovering over the error icon
+         *
+         * If not specified, the default value is `false`
+         */
+        alwaysShowErrorText?: boolean;
+    };
+    /**
+     * API Telemetry headers to attach to every request made by the SDK.
+     * Attached only when the API Telemetry feature flag is enabled.
+     *
+     * Support only headers with the prefix 'x-sisense-'.
+     *
+     * @example
+     * ```tsx
+     * appConfig={{
+     *   apiTelemetryHeaders: {
+     *     'x-sisense-embed': 'iframe',
+     *   },
+     * }}
+     * ```
+     * @sisenseInternal
+     */
+    apiTelemetryHeaders?: Record<string, string>;
+    /**
+     * Tracking configuration
+     */
+    trackingConfig?: {
+        /**
+         * Whether to enable or disable tracking in development or test environment.
+         *
+         * If not specified, the default value is `true`
+         *
+         * In production, tracking is always enabled.
+         *
+         * @internal
+         */
+        enabled?: boolean;
+        /**
+         * Callback to be invoked when tracking event occurs
+         */
+        onTrackingEvent?: (payload: TrackingEventDetails) => void;
+    };
+    /**
+     * Configuration of the Jump To Dashboard feature
+     *
+     * This feature is currently in Beta.
+     *
+     * **Note:** Only widgets that are configured using the Fusion UI as documented
+     * [here](https://docs.sisense.com/main/SisenseLinux/jump-to-dashboard.htm?tocpath=Add-ons%7C_____2#ConfiguringJTDPerWidget)
+     * are supported in Compose SDK.
+     *
+     * Widgets that are configured using an older version of Jump To Dashboard, or via scripts, are not supported.
+     *
+     * Known limitations:
+     * - Jump To Dashboard is not currently supported for Pivot widgets.
+     * - Target dashboards are always opened in a popup window, options to open in new tab and new window are not supported.
+     * - Show 'Header' and 'Dashboards panel' options are not supported (only relevant to Fusion).
+     * - 'Reset filters after JTD' is not supported, since changes are never saved to the target dashboard using Compose SDK.
+     *
+     * The following Jump To Dashboard configuration is supported:
+     *   - Target dashboard set by Id, with configurable display title
+     *   - 'Popup window' display type ('Allow Resize' not supported)
+     *   - Display filter panel on the target dashboard (true/false)
+     *   - Navigation setting (Click / Right click)
+     *     - Note: 'Keep changes made by user' is not supported, since changes are never saved to the target dashboard using Compose SDK.
+     *   - Apply filters to the target dashboard (select)
+     *   - Merge target dashboard filters (true/false)
+     *
+     */
+    jumpToDashboardConfig?: {
+        /**
+         * Whether to enable or disable the Jump To Dashboard feature
+         *
+         * If not specified, the default value is `true`
+         */
+        enabled?: boolean;
+    };
+    /**
+     * Global configuration for some specific aspects of data visualizations.
+     */
+    chartConfig?: {
+        /** `Table` and `PivotTable` configuration */
+        tabular?: {
+            /** Configuration for HTML content in `Table` and `PivotTable` */
+            htmlContent?: {
+                /**
+                 * If true, the contents of table and pivot table cells are rendered as HTML instead of text.
+                 *
+                 * **Note**: The {@link StyledColumn.isHtml} property of columns in `dataOptions` are of higher precedence, and will therefore override this setting.
+                 * @default true
+                 * */
+                enabled?: boolean;
+                /**
+                 * Enables sanitization of HTML content before rendering to prevent XSS attacks.
+                 * @default true
+                 * */
+                sanitizeContents?: boolean;
+            };
+            /**
+             * Boolean flag whether to always show the results per page select
+             *
+             * If `true`, the results per page select will be shown even if there is only one page of results.
+             * Currently only supported for `PivotTable`.
+             *
+             * @default false
+             */
+            alwaysShowResultsPerPage?: boolean;
+        };
+    };
+};
+/**
+ * Stands for a Sisense Client Application which connects to a Sisense Environment
+ *
+ * @internal
+ */
+export interface ClientApplication {
+    /**
+     * Gets the underlying HTTP Client
+     */
+    readonly httpClient: HttpClient;
+    /**
+     * Gets the underlying Pivot Query Client
+     */
+    readonly pivotQueryClient: PivotQueryClient;
+    /**
+     * Gets the underlying Query Client
+     */
+    readonly queryClient: QueryClient;
+    /**
+     * Gets the default data source being used as default for child components with no explicitly defined data source
+     */
+    readonly defaultDataSource?: DataSource;
+    /**
+     * Gets the application settings
+     */
+    settings: AppSettings;
+    /**
+     * Gets the module to control query cache
+     */
+    queryCache: {
+        /**
+         * Clears the query cache
+         */
+        clear: () => void;
+    };
+}
+export type SystemSettings = {
+    tracking?: {
+        apiTelemetry?: boolean;
+    };
+};

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

@@ -0,0 +1,5 @@
+export { PluginProvider } from './plugin-provider';
+export type { PluginProviderProps } from './plugin-provider';
+export { PluginContext } from './plugin-context';
+export type { PluginContextValue } from './plugin-context';
+export type { Plugin, PluginValidationResult } from './types';

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

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+import { Plugin } from './types';
+/**
+ * Context for accessing registered plugins
+ */
+export interface PluginContextValue {
+    /**
+     * Array of validated and loaded plugins
+     */
+    plugins: readonly Plugin[];
+}
+/**
+ * React context for plugin management
+ */
+export declare const PluginContext: import("react").Context<PluginContextValue>;

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

@@ -0,0 +1,21 @@
+import { type ReactNode } from 'react';
+import { Plugin } from './types';
+/**
+ * Props for PluginProvider component
+ *
+ * @internal
+ */
+export interface PluginProviderProps {
+    /**
+     * Array of plugins to register
+     */
+    plugins: Plugin[];
+    /**
+     * Child components
+     */
+    children: ReactNode;
+}
+/**
+ * Plugin Provider component that validates and provides access to plugins
+ */
+export declare const PluginProvider: React.FC<PluginProviderProps>;

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

@@ -0,0 +1,50 @@
+/**
+ * Plugin with metadata information
+ *
+ * @internal
+ */
+export interface Plugin {
+    /**
+     * Unique name identifier for the plugin
+     */
+    name: string;
+    /**
+     * Semantic version of the plugin
+     */
+    version: string;
+    /**
+     * Required SDK API version range using simplified semver with standard AND/OR logic.
+     * - **OR**: `||` separates alternative ranges (version must match at least one).
+     * - **AND**: space-separated comparators (version must match all in that group).
+     *
+     * Supported comparators: `^x.y.z`, `~x.y.z`, `x.y.z`, `>=x.y.z`, `>x.y.z`, `<=x.y.z`, `<x.y.z`
+     *
+     * @example "^2.9.0" — any 2.x from 2.9.0 up (same major)
+     * @example "2.20.0" — exact version only
+     * @example "~2.9.0" — 2.9.x only (same major and minor)
+     * @example ">=2.0.0" — minimum version
+     * @example "^2.0.0 || ^3.0.0" — 2.x from 2.0.0 or 3.x from 3.0.0 (OR)
+     * @example ">1.2.3 <=2.3.1" — between 1.2.3 and 2.3.1 inclusive (AND)
+     * @example ">1.2.3 <=2.3.1 || ^3.0.0" — that range or any 3.x (AND + OR)
+     */
+    requiredApiVersion: string;
+}
+/**
+ * Result of plugin validation
+ *
+ * @internal
+ */
+export interface PluginValidationResult {
+    /**
+     * The validated plugin
+     */
+    plugin: Plugin;
+    /**
+     * Whether the plugin is valid and should be loaded
+     */
+    isValid: boolean;
+    /**
+     * Reason for invalidation if isValid is false
+     */
+    reason?: string;
+}

package/dist/packages/sdk-ui/src/infra/contexts/plugin-provider/validate-plugins.d.ts

@@ -0,0 +1,9 @@
+import { Plugin } from './types';
+/**
+ * Validates and returns only valid plugins.
+ *
+ * @param plugins - Array of plugins to validate
+ * @param sdkVersion - Current SDK version
+ * @returns Array of valid plugins
+ */
+export declare const getValidPlugins: (plugins: Plugin[], sdkVersion: string) => Plugin[];

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

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 import { TrackingEventDetails } from '@sisense/sdk-tracking';
 import { SisenseContextProviderProps } from '../../..';
-import { ClientApplication } from '../../app/client-application';
+import { type ClientApplication } from '../../app/types';
 export type SisenseContextPayload = {
     isInitialized: boolean;
     app?: ClientApplication;

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

@@ -8,7 +8,8 @@ export declare const ThemeContext: import("react").Context<{
  * Hook to get the current theme settings.
  *
  * @returns The current theme settings
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare const useThemeContext: () => {
     themeSettings: CompleteThemeSettings;

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

@@ -16,6 +16,6 @@ export type TrackingDecoratorConfig = {
 /**
  * Adds tracking to the component
  *
- * @internal
+ * @sisenseInternal
  */
 export declare const withTracking: ComponentDecorator<TrackingDecoratorConfig>;

package/dist/packages/sdk-ui/src/infra/decorators/hook-decorators/with-tracking.d.ts

@@ -1,4 +1,4 @@
-import { ClientApplication } from '../../app/client-application';
+import { ClientApplication } from '../../app/types';
 export type HookDecorator<DecoratorConfig> = (decoratorConfig: DecoratorConfig) => <HookArgs extends any[], HookResult>(hook: (...args: HookArgs) => HookResult) => (...args: HookArgs) => HookResult;
 /**
  * Tracks the hook event and sends it to the server.

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/de-de.d.ts

@@ -214,12 +214,14 @@ declare const _default: {
             };
         };
         widgetHeader: {
+            addTitle: string;
             info: {
                 details: string;
                 tooltip: string;
             };
             menu: {
                 deleteWidget: string;
+                renameWidget: string;
                 distributeEqualWidth: string;
             };
         };
@@ -270,6 +272,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -350,6 +358,9 @@ declare const _default: {
             configureFilter: string;
             noResults: string;
             searchPlaceholder: string;
+            more: string;
+            filter: string;
+            addMeasure: string;
         };
         pivotTable: {
             grandTotal: string;
@@ -389,6 +400,26 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
+        measures: {
+            countShort: string;
+            countDistinct: string;
+            count: string;
+            average: string;
+            sum: string;
+            min: string;
+            max: string;
+            stdev: string;
+            median: string;
+            variance: string;
+        };
     };
 }[];
 export default _default;

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/en-us.d.ts

@@ -214,12 +214,14 @@ declare const _default: {
             };
         };
         widgetHeader: {
+            addTitle: string;
             info: {
                 details: string;
                 tooltip: string;
             };
             menu: {
                 deleteWidget: string;
+                renameWidget: string;
                 distributeEqualWidth: string;
             };
         };
@@ -270,6 +272,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -350,6 +358,9 @@ declare const _default: {
             configureFilter: string;
             noResults: string;
             searchPlaceholder: string;
+            more: string;
+            filter: string;
+            addMeasure: string;
         };
         pivotTable: {
             grandTotal: string;
@@ -389,6 +400,26 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
+        measures: {
+            countShort: string;
+            countDistinct: string;
+            count: string;
+            average: string;
+            sum: string;
+            min: string;
+            max: string;
+            stdev: string;
+            median: string;
+            variance: string;
+        };
     };
 }[];
 export default _default;

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/es-ar.d.ts

@@ -214,12 +214,14 @@ declare const _default: {
             };
         };
         widgetHeader: {
+            addTitle: string;
             info: {
                 details: string;
                 tooltip: string;
             };
             menu: {
                 deleteWidget: string;
+                renameWidget: string;
                 distributeEqualWidth: string;
             };
         };
@@ -270,6 +272,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -350,6 +358,9 @@ declare const _default: {
             configureFilter: string;
             noResults: string;
             searchPlaceholder: string;
+            more: string;
+            filter: string;
+            addMeasure: string;
         };
         pivotTable: {
             grandTotal: string;
@@ -389,6 +400,26 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
+        measures: {
+            countShort: string;
+            countDistinct: string;
+            count: string;
+            average: string;
+            sum: string;
+            min: string;
+            max: string;
+            stdev: string;
+            median: string;
+            variance: string;
+        };
     };
 }[];
 export default _default;

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/es-es.d.ts

@@ -214,12 +214,14 @@ declare const _default: {
             };
         };
         widgetHeader: {
+            addTitle: string;
             info: {
                 details: string;
                 tooltip: string;
             };
             menu: {
                 deleteWidget: string;
+                renameWidget: string;
                 distributeEqualWidth: string;
             };
         };
@@ -270,6 +272,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -350,6 +358,9 @@ declare const _default: {
             configureFilter: string;
             noResults: string;
             searchPlaceholder: string;
+            more: string;
+            filter: string;
+            addMeasure: string;
         };
         pivotTable: {
             grandTotal: string;
@@ -389,6 +400,26 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
+        measures: {
+            countShort: string;
+            countDistinct: string;
+            count: string;
+            average: string;
+            sum: string;
+            min: string;
+            max: string;
+            stdev: string;
+            median: string;
+            variance: string;
+        };
     };
 }[];
 export default _default;