react-semaphor 0.0.71 → 0.0.73

package/dist/react-semaphor.d.ts

@@ -1,12 +1,21 @@
+/// <reference types="react" />
 /// <reference types="react-grid-layout" />
 
+import { BubbleDataPoint } from 'chart.js';
+import { Chart as Chart_2 } from 'chart.js';
+import { ChartConfiguration } from 'chart.js';
+import { ChartTypeRegistry } from 'chart.js';
+import { Draft } from 'immer';
+import { FC } from 'react';
 import { FontSpec } from 'chart.js';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { Layout } from 'react-grid-layout';
+import { Point } from 'chart.js';
 import { StoreApi } from 'zustand';
 import { UseBoundStore } from 'zustand';
 
 declare type Actions = {
+    setCustomCards: (customCards: CustomCard[]) => void;
     setAuthToken: (authToken: AuthToken) => void;
     setThemeStyle: (themeStyle: StyleProps) => void;
     setIsEditorSaveEvent: (isEditorSaveEvent: boolean) => void;
@@ -51,12 +60,14 @@ declare type Actions = {
     getDashboard: () => TDashboard | undefined;
     getSelectedSheet: () => TSheet | undefined;
     getSelectedSheetCards: () => TCard[] | undefined;
+    getCard: (cardId: string) => TCard | undefined;
     getSelectedCard: () => TCard | undefined;
     getSelectedSheetLayout: () => ReactGridLayout.Layout[] | undefined;
 };
 
 declare type Actions_2 = {
     setCardRefreshInterval: (refreshInterval: string) => void;
+    setNumberFormat: (format: string, currency: string, locale: string, suffix: string) => void;
     setIsShowingVisual: (isShowingVisual: boolean) => void;
     setRunSql: (runSql: boolean) => void;
     setCardPreferences: (preferences: TCardPreferences) => void;
@@ -111,6 +122,13 @@ export declare type Bookmark = {
 
 export declare function cleanCard(card: TCard): TCard;
 
+export declare type CustomCard = {
+    cardId: string;
+    component: React.FC<{
+        card: TCard;
+    }>;
+};
+
 export declare function Dashboard(props: DashboardProps): JSX_2.Element;
 
 export declare function DashboardPlus({ showControls, showFooter, ...rest }: DashboardPlusProps): JSX_2.Element;
@@ -126,12 +144,17 @@ export declare type DashboardProps = {
     style?: TStyle;
     currentTheme?: 'light' | 'dark' | 'system';
     version?: string;
+    customCards?: CustomCard[];
     onEvent?: (event: TEvent) => void;
     onSave?: (dashboard: TDashboard) => void;
     LoadingComponent?: (props: LoadingProps) => React.ReactNode;
     ErrorComponent?: (props: ErrorProps) => React.ReactNode;
 };
 
+export declare function DashboardProvider({ children }: {
+    children: React.ReactNode;
+}): JSX_2.Element;
+
 declare type DashboardStore = {
     authToken?: AuthToken;
     theme?: 'light' | 'dark' | 'system';
@@ -230,6 +253,7 @@ export declare function getDashbaordStateWithoutData(dashboardState: TDashboard)
     description?: string | undefined;
     style?: TStyle | undefined;
     filters?: TFilter[] | undefined;
+    customCards?: CustomCard[] | undefined;
 };
 
 export declare type LoadingProps = {
@@ -281,6 +305,7 @@ export declare type TCard = {
     sql?: string;
     data?: any[];
     cfg?: any;
+    childCards?: any[];
     customCfg?: any;
     preferences?: TCardPreferences;
     lastSelectedDatabase?: string;
@@ -299,9 +324,18 @@ export declare type TCardContext = {
 export declare type TCardPreferences = {
     filterOnClick?: boolean;
     filterOnClickField?: string;
+    formatNumber?: {
+        format?: string;
+        currency?: string;
+        locale?: string;
+        suffix?: string;
+        enabled?: boolean | string;
+    };
 };
 
-declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'table' | 'kpi';
+declare type TChartConfiguration = ChartConfiguration;
+
+declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'table' | 'kpi' | 'custom';
 
 export declare type TDashboard = {
     id: string;
@@ -310,6 +344,7 @@ export declare type TDashboard = {
     sheets?: TSheet[];
     style?: TStyle;
     filters?: TFilter[];
+    customCards?: CustomCard[];
 };
 
 declare type TDataColumn = {
@@ -362,6 +397,34 @@ export declare function useActions(): {
     setOnRemoveCard: (onRemoveCard: (card: TCard, sheetId: string) => void) => void;
 };
 
+export declare function useCard(cardId: string): {
+    data: any;
+    isError: boolean;
+    isLoading: boolean;
+    isFetching: boolean;
+    visualKey: number;
+    handleDatapointClick: (chart: Chart_2<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint | null)[], unknown>, datasetIndex: number, clickIndex: number, value: number) => void;
+    cfg: TChartConfiguration | undefined;
+};
+
+export declare function useDashboard({ id, version, authToken, customStyle, currentTheme, onSave, onEvent, customCards, }: UseDashboardProps): {
+    isLoading: boolean;
+    isError: boolean;
+};
+
+export declare const useDashboardActions: () => Actions;
+
+declare type UseDashboardProps = {
+    id: string;
+    version?: string;
+    authToken: AuthToken | undefined;
+    customStyle?: TStyle;
+    currentTheme?: 'light' | 'dark' | 'system';
+    onSave?: (dashboard: TDashboard) => void;
+    onEvent?: (event: TEvent) => void;
+    customCards?: CustomCard[];
+};
+
 export declare const useDashboardStore: UseBoundStore<Omit<StoreApi<DashboardStore>, "setState"> & {
     setState(nextStateOrUpdater: DashboardStore | Partial<DashboardStore> | ((state: {
         authToken?: {
@@ -425,10 +488,18 @@ export declare const useDashboardStore: UseBoundStore<Omit<StoreApi<DashboardSto
                     sql?: string | undefined;
                     data?: any[] | undefined;
                     cfg?: any;
+                    childCards?: any[] | undefined;
                     customCfg?: any;
                     preferences?: {
                         filterOnClick?: boolean | undefined;
                         filterOnClickField?: string | undefined;
+                        formatNumber?: {
+                            format?: string | undefined;
+                            currency?: string | undefined;
+                            locale?: string | undefined;
+                            suffix?: string | undefined;
+                            enabled?: string | boolean | undefined;
+                        } | undefined;
                     } | undefined;
                     lastSelectedDatabase?: string | undefined;
                     lastSelectedSchema?: string | undefined;
@@ -490,6 +561,12 @@ export declare const useDashboardStore: UseBoundStore<Omit<StoreApi<DashboardSto
                 database: string;
                 sql: string;
             }[] | undefined;
+            customCards?: {
+                cardId: string;
+                component: FC<{
+                    card: TCard;
+                }>;
+            }[] | undefined;
         };
         selectedSheetId?: string | null | undefined;
         selectedCardId?: string | null | undefined;
@@ -502,10 +579,18 @@ export declare const useDashboardStore: UseBoundStore<Omit<StoreApi<DashboardSto
             sql?: string | undefined;
             data?: any[] | undefined;
             cfg?: any;
+            childCards?: any[] | undefined;
             customCfg?: any;
             preferences?: {
                 filterOnClick?: boolean | undefined;
                 filterOnClickField?: string | undefined;
+                formatNumber?: {
+                    format?: string | undefined;
+                    currency?: string | undefined;
+                    locale?: string | undefined;
+                    suffix?: string | undefined;
+                    enabled?: string | boolean | undefined;
+                } | undefined;
             } | undefined;
             lastSelectedDatabase?: string | undefined;
             lastSelectedSchema?: string | undefined;
@@ -573,6 +658,7 @@ export declare const useDashboardStore: UseBoundStore<Omit<StoreApi<DashboardSto
         onUpdateCard?: ((card: TCard, sheetId: string) => void) | undefined;
         onRemoveCard?: ((card: TCard, sheetId: string) => void) | undefined;
         actions: {
+            setCustomCards: (customCards: CustomCard[]) => void;
             setAuthToken: (authToken: AuthToken) => void;
             setThemeStyle: (themeStyle: StyleProps) => void;
             setIsEditorSaveEvent: (isEditorSaveEvent: boolean) => void;
@@ -617,12 +703,15 @@ export declare const useDashboardStore: UseBoundStore<Omit<StoreApi<DashboardSto
             getDashboard: () => TDashboard | undefined;
             getSelectedSheet: () => TSheet | undefined;
             getSelectedSheetCards: () => TCard[] | undefined;
+            getCard: (cardId: string) => TCard | undefined;
             getSelectedCard: () => TCard | undefined;
             getSelectedSheetLayout: () => ReactGridLayout.Layout[] | undefined;
         };
     }) => void), shouldReplace?: boolean | undefined): void;
 }>;
 
+export declare const useEditorActions: () => Actions_2;
+
 export declare const useEditorStore: UseBoundStore<Omit<StoreApi<EditorStore>, "setState"> & {
     setState(nextStateOrUpdater: EditorStore | Partial<EditorStore> | ((state: {
         isShowingVisual: boolean;
@@ -630,6 +719,7 @@ export declare const useEditorStore: UseBoundStore<Omit<StoreApi<EditorStore>, "
         isSqlRunning: boolean;
         actions: {
             setCardRefreshInterval: (refreshInterval: string) => void;
+            setNumberFormat: (format: string, currency: string, locale: string, suffix: string) => void;
             setIsShowingVisual: (isShowingVisual: boolean) => void;
             setRunSql: (runSql: boolean) => void;
             setCardPreferences: (preferences: TCardPreferences) => void;
@@ -675,10 +765,18 @@ export declare const useEditorStore: UseBoundStore<Omit<StoreApi<EditorStore>, "
             sql?: string | undefined;
             data?: any[] | undefined;
             cfg?: any;
+            childCards?: any[] | undefined;
             customCfg?: any;
             preferences?: {
                 filterOnClick?: boolean | undefined;
                 filterOnClickField?: string | undefined;
+                formatNumber?: {
+                    format?: string | undefined;
+                    currency?: string | undefined;
+                    locale?: string | undefined;
+                    suffix?: string | undefined;
+                    enabled?: string | boolean | undefined;
+                } | undefined;
             } | undefined;
             lastSelectedDatabase?: string | undefined;
             lastSelectedSchema?: string | undefined;
@@ -754,4 +852,8 @@ export declare const useEditorStore: UseBoundStore<Omit<StoreApi<EditorStore>, "
     }) => void), shouldReplace?: boolean | undefined): void;
 }>;
 
+export declare type WritableDraft<T> = {
+    -readonly [K in keyof T]: Draft<T[K]>;
+};
+
 export { }