react-semaphor 0.0.72 → 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,6 +60,7 @@ declare type Actions = {
     getDashboard: () => TDashboard | undefined;
     getSelectedSheet: () => TSheet | undefined;
     getSelectedSheetCards: () => TCard[] | undefined;
+    getCard: (cardId: string) => TCard | undefined;
     getSelectedCard: () => TCard | undefined;
     getSelectedSheetLayout: () => ReactGridLayout.Layout[] | undefined;
 };
@@ -112,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;
@@ -127,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';
@@ -231,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 = {
@@ -282,6 +305,7 @@ export declare type TCard = {
     sql?: string;
     data?: any[];
     cfg?: any;
+    childCards?: any[];
     customCfg?: any;
     preferences?: TCardPreferences;
     lastSelectedDatabase?: string;
@@ -309,7 +333,9 @@ export declare type TCardPreferences = {
     };
 };
 
-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;
@@ -318,6 +344,7 @@ export declare type TDashboard = {
     sheets?: TSheet[];
     style?: TStyle;
     filters?: TFilter[];
+    customCards?: CustomCard[];
 };
 
 declare type TDataColumn = {
@@ -370,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?: {
@@ -433,6 +488,7 @@ 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;
@@ -505,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;
@@ -517,6 +579,7 @@ 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;
@@ -595,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;
@@ -639,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;
@@ -698,6 +765,7 @@ 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;
@@ -784,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 { }