@sisense/sdk-ui 2.21.0 → 2.22.0

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -270,6 +270,12 @@ declare const _default: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -389,6 +395,14 @@ declare const _default: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 }[];
 export default _default;

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

@@ -267,6 +267,12 @@ export declare const translation: {
             unknownResponse: string;
             invalidInput: string;
             noAvailableDataTopics: string;
+            failedToFetchCreditBalance: string;
+        };
+        quota: {
+            exceededErrorTitle: string;
+            exceededErrorDescription: string;
+            warningDescription: string;
         };
     };
     attribute: {
@@ -386,6 +392,14 @@ export declare const translation: {
             nextGroup: string;
         };
     };
+    filterTile: {
+        menu: {
+            lock: string;
+            unlock: string;
+            lockGroup: string;
+            unlockGroup: string;
+        };
+    };
 };
 /**
  * A reference type containing all currently used translation keys.

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

@@ -277,6 +277,12 @@ export declare const resources: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -396,6 +402,14 @@ export declare const resources: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
     'en-US': {
         errors: {
@@ -666,6 +680,12 @@ export declare const resources: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -785,5 +805,13 @@ export declare const resources: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
     };
 };

package/dist/packages/sdk-ui/src/modules/ai/api/chat-rest-api.d.ts

@@ -6,7 +6,8 @@ export declare class ChatRestApi {
     private readonly volatile;
     private httpClient;
     private readonly isUnifiedNarrationEnabled;
-    constructor(httpClient: HttpClient, volatile?: boolean, isUnifiedNarrationEnabled?: boolean);
+    private readonly isSisenseAiEnabled;
+    constructor(httpClient: HttpClient, volatile?: boolean, isUnifiedNarrationEnabled?: boolean, isSisenseAiEnabled?: boolean);
     getChatContexts: () => Promise<ChatContext[]>;
     private getNlgInsights;
     private getQueryRecommendations;

package/dist/packages/sdk-ui/src/modules/ai/api/narration-endpoints.d.ts

@@ -1,7 +1,7 @@
 import type { HttpClient } from '@sisense/sdk-rest-client';
 import type { GetNlgInsightsRequest, GetNlgInsightsResponse } from './types.js';
 /** Unified narrative endpoint. Try first; fall back to legacy on 404. */
-export declare const UNIFIED_NARRATION_ENDPOINT = "api/v2/ai/widget/narrative";
+export declare const UNIFIED_NARRATION_ENDPOINT = "api/v2/ai/narrative";
 /** Legacy endpoint (used when unified narrative returns 404). */
 export declare const LEGACY_NARRATION_ENDPOINT = "api/v2/ai/nlg/queryResult";
 /**
@@ -10,6 +10,7 @@ export declare const LEGACY_NARRATION_ENDPOINT = "api/v2/ai/nlg/queryResult";
  */
 export type GetNarrationsOptions = {
     isUnifiedNarrationEnabled?: boolean;
+    isSisenseAiEnabled?: boolean;
 };
 /**
  * Fetches narrations. Single place for endpoint logic: isUnifiedNarrationEnabled === false → legacy only;

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

@@ -12,6 +12,7 @@ export interface GetNlgInsightsFromWidgetOptions {
     verbosity?: 'Low' | 'High';
     /** When false, legacy narration endpoint only; when true or undefined, try unified then fallback. From props.isUnifiedNarrationEnabled. */
     isUnifiedNarrationEnabled?: boolean;
+    isSisenseAiEnabled?: boolean;
 }
 /**
  * Pure function that fetches NLG insights from WidgetProps.

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

@@ -9,7 +9,7 @@ import { HighchartsOptions } from './domains/visualizations/core/chart-options-p
 import type { ChartWidgetProps } from './domains/widgets/components/chart-widget/types';
 import { FiltersMergeStrategy } from './domains/widgets/components/widget-by-id/types';
 import { AppConfig } from './infra/app/client-application';
-import { HookEnableParam } from './shared/hooks/types';
+import type { Plugin } from './infra/contexts/plugin-provider/types';
 import { AreamapDataPoint, AreamapStyleOptions, AreaRangeStyleOptions, AreaStyleOptions, BoxplotDataPoint, BoxplotStyleOptions, CalendarHeatmapDataPoint, CalendarHeatmapStyleOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ChartDataOptions, ChartDataPoints, ChartStyleOptions, ChartType, CustomDrilldownResult, DataPoint, DrilldownOptions, DrilldownSelection, FunnelStyleOptions, IndicatorDataPoint, IndicatorRenderOptions, IndicatorStyleOptions, LineStyleOptions, MenuAlignment, MenuItemSection, MenuPosition, PieStyleOptions, PivotTableDataPoint, PivotTableDrilldownOptions, PivotTableStyleOptions, PolarStyleOptions, RegularChartStyleOptions, RegularChartType, ScatterDataPoint, ScattermapDataPoint, ScattermapStyleOptions, ScatterStyleOptions, StackableStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, TableStyleOptions, TabularChartStyleOptions, TextWidgetDataPoint, ThemeConfig, ThemeOid, ThemeSettings, TreemapStyleOptions, WidgetByIdStyleOptions } from './types';
 export type { TabberButtonsWidgetProps } from './domains/widgets/components/tabber-buttons-widget/types';
 export type { WidgetProps, WidgetType, WithCommonWidgetProps, } from './domains/widgets/components/widget/types';
@@ -137,6 +137,18 @@ export interface SisenseContextProviderProps {
      * @internal
      */
     disableFusionPalette?: boolean;
+    /**
+     * Array of plugins to register.
+     *
+     * Plugins should satisfy the following conditions:
+     * - Name uniqueness (duplicates are skipped with a warning)
+     * - Version compatibility with the current SDK version
+     *
+     * @category Sisense App
+     *
+     * @internal
+     */
+    plugins?: Plugin[];
 }
 /**
  * Props for {@link ExecuteQuery} component.
@@ -1377,25 +1389,6 @@ export interface DrilldownWidgetProps {
      */
     children: (customDrilldownResult: CustomDrilldownResult) => ReactNode;
 }
-/**
- * Params of the {@link useGetSharedFormula} hook
- *
- * Can consist either of an oid or a name/dataSource pair
- */
-export interface UseGetSharedFormulaParams extends HookEnableParam {
-    /**
-     * Formula identifier
-     */
-    oid?: string;
-    /**
-     * Formula name
-     */
-    name?: string;
-    /**
-     * Data source - e.g. `Sample ECommerce`
-     */
-    dataSource?: DataSource;
-}
 /**
  * Props of the {@link CalendarHeatmapChart} component.
  */

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

@@ -19,6 +19,7 @@ export { processDrilldownSelections } from '../domains/drilldown/hooks/use-drill
 export { CommonWidget, type CommonWidgetProps } from '../domains/widgets/components/common-widget';
 export { TableWidget, type TableWidgetProps } from '../domains/widgets/components/table-widget';
 export * from '../infra/contexts/custom-widgets-provider/custom-widgets-provider-adapter';
+export { useGetSharedFormulaInternal } from '../domains/formulas/use-get-shared-formula';
 export { translateColumnToAttribute } from '../domains/visualizations/core/chart-data-options/utils';
 export { isSameAttribute } from '../shared/utils/filters';
 export { isChartWidgetProps, isPivotTableWidgetProps, isTextWidgetProps, isCustomWidgetProps, } from '../domains/widgets/components/widget-by-id/utils';

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

@@ -50,11 +50,11 @@ export { TabberButtonsWidget } from '../domains/widgets/components/tabber-button
 export { DrilldownBreadcrumbs } from '../domains/drilldown/components/drilldown-breadcrumbs';
 export * from '../infra/contexts/custom-widgets-provider/types';
 export { useCustomWidgets } from '../infra/contexts/custom-widgets-provider';
-export { useGetDashboardModel, useGetDashboardModels, useDashboardModel, 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 DashboardId, type WidgetsOptions, type CommonFiltersOptions, type CommonFiltersApplyMode, type FiltersIgnoringRules, UseDashboardModelActionType, } from '../domains/dashboarding/dashboard-model';
+export { useGetDashboardModel, useGetDashboardModels, useDashboardModel, 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 DashboardId, type WidgetsOptions, type SpecificWidgetOptions, type CommonFiltersOptions, type CommonFiltersApplyMode, type FiltersIgnoringRules, UseDashboardModelActionType, } from '../domains/dashboarding/dashboard-model';
 export { useGetWidgetModel, type WidgetModel, type WidgetDataOptions, type WidgetModelState, type WidgetModelLoadingState, type WidgetModelErrorState, type WidgetModelSuccessState, type GetWidgetModelParams, } from '../domains/widgets/widget-model';
 export { useGetHierarchyModels, type HierarchyModel, type Hierarchy, type HierarchyId, type GetHierarchyModelsParams, type HierarchyModelsState, type HierarchyModelsLoadingState, type HierarchyModelsErrorState, type HierarchyModelsSuccessState, } from '../domains/drilldown/hierarchy-model';
 export * from '../domains/filters';
-export * from '../domains/formulas';
+export { useGetSharedFormula, type GetSharedFormulaParams, type UseGetSharedFormulaParams, type SharedFormulaState, type SharedFormulaLoadingState, type SharedFormulaErrorState, type SharedFormulaSuccessState, } from '../domains/formulas';
 export { DataSchemaBrowser } from '../domains/data-browser/data-schema-browser/data-schema-browser';
 export { useGetDataSourceDimensions, useGetDataSourceFields, type GetDataSourceDimensionsParams, type DataSourceDimensionsState, type DataSourceDimensionsLoadingState, type DataSourceDimensionsErrorState, type DataSourceDimensionsSuccessState, } from '../domains/data-browser/data-source-dimensional-model';
 export { ThemeProvider } from '../infra/contexts/theme-provider';

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

@@ -13,3 +13,9 @@ export { trackHook } from '../infra/decorators/hook-decorators';
 export { useThemeContext } from '../infra/contexts/theme-provider';
 export { type DashboardDto } from '../infra/api/types/dashboard-dto';
 export { type WidgetDto } from '../domains/widgets/components/widget-by-id/types';
+export { useAppSettings } from '../shared/hooks/use-app-settings';
+export type { AppSettings } from '../infra/app/settings/settings';
+export { QuotaNotification } from '../shared/components/quota-notification/quota-notification.js';
+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';

package/dist/packages/sdk-ui/src/shared/components/alert/alert.d.ts

@@ -0,0 +1,91 @@
+import { ReactNode } from 'react';
+/**
+ * Props for Alert component
+ */
+export interface AlertProps {
+    /**
+     * Variant of the alert
+     */
+    variant?: 'error' | 'warning' | 'info';
+    /**
+     * Title text displayed in the alert
+     */
+    title?: string;
+    /**
+     * Description text displayed in the alert
+     */
+    description?: string;
+    /**
+     * Custom icon to display. If not provided, AlertIcon is used
+     */
+    icon?: ReactNode;
+    /**
+     * Whether the alert can be dismissed
+     */
+    dismissible?: boolean;
+    /**
+     * Callback when alert is dismissed
+     */
+    onDismiss?: () => void;
+    /**
+     * When true and dismissible, clicking anywhere on the alert (not just the close button)
+     * triggers onDismiss. Useful for banner-style alerts.
+     *
+     * @default false
+     */
+    dismissOnClick?: boolean;
+    /**
+     * Additional CSS class name
+     */
+    className?: string;
+}
+/**
+ * Alert component for displaying warnings, errors, and informational messages
+ *
+ * @param props - Alert component props
+ * @returns Alert component
+ * @internal
+ */
+export declare const Alert: ({ variant, title, description, icon, dismissible, onDismiss, dismissOnClick, className, }: AlertProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Props for AlertTitle component
+ */
+export interface AlertTitleProps {
+    /**
+     * Content of the title
+     */
+    children: ReactNode;
+    /**
+     * Additional CSS class name
+     */
+    className?: string;
+}
+/**
+ * Alert title subcomponent
+ *
+ * @param props - AlertTitle props
+ * @returns AlertTitle component
+ * @internal
+ */
+export declare const AlertTitle: ({ children, className }: AlertTitleProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Props for AlertDescription component
+ */
+export interface AlertDescriptionProps {
+    /**
+     * Content of the description
+     */
+    children: ReactNode;
+    /**
+     * Additional CSS class name
+     */
+    className?: string;
+}
+/**
+ * Alert description subcomponent
+ *
+ * @param props - AlertDescription props
+ * @returns AlertDescription component
+ * @internal
+ */
+export declare const AlertDescription: ({ children, className }: AlertDescriptionProps) => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/shared/components/alert/index.d.ts

@@ -0,0 +1,2 @@
+export { Alert, AlertTitle, AlertDescription } from './alert';
+export type { AlertProps, AlertTitleProps, AlertDescriptionProps } from './alert';

package/dist/packages/sdk-ui/src/shared/components/menu/menu-button.d.ts

@@ -3,6 +3,7 @@ type MenuButtonProps = {
     color?: string;
     onClick?: MouseEventHandler<HTMLButtonElement>;
     ariaLabel?: string;
+    size?: number;
 };
-export declare const MenuButton: ({ color, onClick, ariaLabel, ...restProps }: MenuButtonProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MenuButton: ({ color, onClick, ariaLabel, size, ...restProps }: MenuButtonProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/packages/sdk-ui/src/shared/components/quota-notification/quota-notification.d.ts

@@ -0,0 +1,32 @@
+import { type QuotaNotificationOptions } from '../../hooks/use-quota-notification.js';
+/**
+ * Props for QuotaNotification component
+ *
+ * @internal
+ */
+export interface QuotaNotificationProps extends QuotaNotificationOptions {
+    /**
+     * Additional CSS class name
+     */
+    className?: string;
+    /**
+     * Whether the warning banner has been dismissed (controlled from parent)
+     */
+    warningDismissed?: boolean;
+    /**
+     * Callback when warning is dismissed (for controlled usage)
+     */
+    onDismissWarning?: () => void;
+}
+/**
+ * Component that displays credit balance warnings/errors
+ *
+ * Shows an error banner when credit is exceeded (not dismissible).
+ * Shows a warning banner when credit usage >= warningThreshold (dismissible).
+ * Automatically updates via polling every 60 seconds.
+ *
+ * @param props - QuotaNotification props
+ * @returns QuotaNotification component or null
+ * @internal
+ */
+export declare function QuotaNotification({ className, warningDismissed: controlledWarningDismissed, onDismissWarning, enabled, warningThreshold, exceededThreshold, }?: QuotaNotificationProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/packages/sdk-ui/src/shared/hooks/use-app-settings.d.ts

@@ -0,0 +1,11 @@
+import type { AppSettings } from '../../infra/app/settings/settings';
+/**
+ * Hook that returns the full application settings from SisenseContext.
+ *
+ * Use this to access app settings (language, user role, LLM quota settings, etc.)
+ * when customizing components wrapped inside SisenseContextProvider.
+ *
+ * @returns AppSettings when app is initialized, undefined otherwise
+ * @internal
+ */
+export declare const useAppSettings: () => AppSettings | undefined;

package/dist/packages/sdk-ui/src/shared/hooks/use-quota-notification.d.ts

@@ -0,0 +1,54 @@
+export declare const DEFAULT_WARNING_THRESHOLD = 85;
+export declare const DEFAULT_EXCEEDED_THRESHOLD = 100;
+/**
+ * Response from the quota/credit balance API
+ *
+ * @internal
+ */
+export interface QuotaApiResponse {
+    balance: number;
+    initialBalance: number;
+    sequenceNumber: string;
+    date: string;
+}
+/**
+ * Calculated quota state from API response
+ *
+ * @internal
+ */
+export interface QuotaState {
+    initialBalance: number;
+    currentBalance: number;
+    usagePercentage: number;
+    isWarning: boolean;
+    isExceeded: boolean;
+}
+/**
+ * Options for useQuotaNotification
+ *
+ * @internal
+ */
+export interface QuotaNotificationOptions {
+    /** Whether to fetch. When false, skips API calls and polling. Defaults to feature-flag value. */
+    enabled?: boolean;
+    /** Warning threshold percentage. Defaults to 85. */
+    warningThreshold?: number;
+    /** Exceeded threshold percentage. Defaults to 100. */
+    exceededThreshold?: number;
+}
+/**
+ * Hook that fetches and calculates quota notification state with automatic polling.
+ * Respects aiAssistant feature flags (quotaNotification + featureModelType) when enabled is not passed.
+ *
+ * Polls every 60 seconds to keep quota state up-to-date.
+ *
+ * @param options - Quota notification options. When enabled is false, skips fetching and polling.
+ * @returns Quota state, enabled flag, loading status, and error
+ * @internal
+ */
+export declare const useQuotaNotification: (options?: QuotaNotificationOptions) => {
+    enabled: boolean;
+    quotaState: QuotaState | null;
+    isLoading: boolean;
+    error: unknown;
+};

package/dist/packages/sdk-ui/src/shared/hooks/use-quota-warning-dismissed.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook that manages quota warning dismissed state with sessionStorage persistence.
+ * State survives navigation within the same tab but resets when the tab is closed.
+ *
+ * @returns Tuple of [dismissed, setDismissed]
+ * @internal
+ */
+export declare function useQuotaWarningDismissed(): [boolean, (dismissed: boolean) => void];

package/dist/packages/sdk-ui/src/shared/icons/warning-icon.d.ts

@@ -0,0 +1,6 @@
+import { SVGProps } from 'react';
+/**
+ * Quota warning icon - circle with exclamation mark, used for quota warning banner
+ * From Figma design; fill #FFCB05
+ */
+export declare const WarningIcon: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;