@magemetrics/ai 0.11.1 → 0.11.4

package/dist/react/index.d.ts

@@ -214,6 +214,15 @@ declare type ConfigurableChatComponentProps = {
     appearance?: AppearanceConfig;
 };
 
+/** Context usage — the modal reuses an ancestor `MageMetricsContextProvider`. */
+declare type ContextManagedModalProps = ManagedModalInnerProps & {
+    apiKey?: never;
+    externalJwt?: never;
+    apiUrl?: never;
+    components?: never;
+    applicationName?: never;
+};
+
 /** @deprecated This type is no longer used and will be removed in a future version. */
 declare type ControlledModalProps = {
     visible: boolean;
@@ -333,8 +342,8 @@ declare const FrontendReportSchema: z.ZodObject<{
             avg_length: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$loose>>;
     }, z.core.$loose>;
-    is_removed: z.ZodBoolean;
     flow_id: z.ZodString;
+    is_removed: z.ZodBoolean;
     is_materialized: z.ZodNullable<z.ZodBoolean>;
     last_materialized_at: z.ZodNullable<z.ZodString>;
     materialized_error_message: z.ZodNullable<z.ZodString>;
@@ -390,7 +399,6 @@ declare const FrontendVisualizationSchema: z.ZodObject<{
         type: z.ZodLiteral<"pie">;
     }, z.core.$strip>], "type">;
     created_at: z.ZodString;
-    flow_data_id: z.ZodNumber;
     flow_data: z.ZodOptional<z.ZodObject<{
         is_materialized: z.ZodNullable<z.ZodBoolean>;
         last_materialized_at: z.ZodNullable<z.ZodString>;
@@ -401,6 +409,7 @@ declare const FrontendVisualizationSchema: z.ZodObject<{
             running: "running";
         }>>;
     }, z.core.$strip>>;
+    flow_data_id: z.ZodNumber;
 }, z.core.$strip>;
 
 declare const InputContainer: default_2.FC<{
@@ -450,23 +459,18 @@ declare type MageMetricsPublicContextProviderProps = PropsWithChildren<Pick<Mage
 
 export declare const ManagedModal: React.FC<ManagedModalProps>;
 
-declare type ManagedModalBaseProps = ModalProps & {
-    /** API key for authenticating with the MageMetrics service */
-    apiKey: string;
-    /** External JWT token for user authentication */
-    externalJwt: string;
-    /** Base URL for the MageMetrics API */
-    apiUrl: string;
+/**
+ * Props shared by both standalone and context-aware usage of `ManagedModal`.
+ * These are the props that `ManagedModalInner` actually consumes — they have
+ * nothing to do with provider initialisation.
+ */
+declare type ManagedModalInnerProps = ModalProps & {
     /** Whether to disable canvas functionality in conversations */
     disableCanvas?: boolean;
     /** Whether to render data freshness info in the conversation header */
     showDataFreshness?: boolean;
     /** Where to persist modal state (localStorage, queryParam, or none) */
     persist?: PersistenceOptions;
-    /** Custom component overrides for extending functionality */
-    components?: Components;
-    /** Application name to associate with flows created through this modal */
-    applicationName?: string;
     /**
      * Appearance configuration for customizing the visual style.
      * Includes brand colors and modal-specific styling options.
@@ -479,10 +483,7 @@ declare type ManagedModalBaseProps = ModalProps & {
     };
 };
 
-/**
- * Props for ManagedModal component.
- */
-declare type ManagedModalProps = ManagedModalBaseProps;
+declare type ManagedModalProps = StandaloneManagedModalProps | ContextManagedModalProps;
 
 declare const MessagesContainer: default_2.FC;
 
@@ -610,6 +611,32 @@ export declare const StandaloneDataTable: React.FC<{
     onStateChange?: (state: DataTableState) => void;
 }>;
 
+/**
+ * Props for ManagedModal component.
+ *
+ * When rendered inside a `MageMetricsContextProvider`, the modal reuses the
+ * parent context instead of creating a duplicate. In that case `apiKey`,
+ * `externalJwt`, `apiUrl`, `components`, and `applicationName` must **not**
+ * be passed (they are inherited from the parent provider).
+ *
+ * When rendered standalone (no parent context), `apiKey`, `externalJwt`, and
+ * `apiUrl` are **required**, and `components`/`applicationName` may optionally
+ * be provided.
+ */
+/** Standalone usage — the modal creates its own `MageMetricsContextProvider`. */
+declare type StandaloneManagedModalProps = ManagedModalInnerProps & {
+    /** API key for authenticating with the MageMetrics service */
+    apiKey: string;
+    /** External JWT token for user authentication */
+    externalJwt: string;
+    /** Base URL for the MageMetrics API */
+    apiUrl: string;
+    /** Custom component overrides for extending functionality */
+    components?: Components;
+    /** Application name to associate with flows created through this modal */
+    applicationName?: string;
+};
+
 declare type StartOptions = DisplayControlProps & {
     /** Label text displayed above the chat launcher input */
     label?: string;
@@ -792,7 +819,7 @@ export declare const useCreateFlow: (options?: UseMutationOptions<{
 };
 
 export declare const useDataReportColumnValue: (reportId: number, filters: ReportDataFilters) => UseQueryResult<    {
-[key: string]: unknown;
+[x: string]: unknown;
 }[], Error>;
 
 export declare const useDataTableContext: () => {
@@ -823,26 +850,26 @@ export declare const useDataTableContext: () => {
                 avg_length?: number | null | undefined;
             }>;
         };
-        is_removed: boolean;
         flow_id: string;
+        is_removed: boolean;
         is_materialized: boolean | null;
         last_materialized_at: string | null;
         materialized_error_message: string | null;
         materialized_status: "completed" | "running" | "failed" | null;
     };
     fetchNextPage: (options?: FetchNextPageOptions) => Promise<InfiniteQueryObserverResult<InfiniteData<    {
-    [key: string]: unknown;
+    [x: string]: unknown;
     }[], unknown>, Error>>;
     pages: {
-        [key: string]: unknown;
+        [x: string]: unknown;
     }[][] | undefined;
     columns: {
         name: string;
         data_type: string;
         dataType: string;
-        renderType?: string;
-        unit?: string;
-        canonicalDataType?: "numeric" | "boolean" | "datetime" | "text" | "array" | "json" | "other";
+        renderType?: string | undefined;
+        unit?: string | undefined;
+        canonicalDataType?: "numeric" | "boolean" | "datetime" | "text" | "array" | "json" | "other" | undefined;
     }[] | undefined;
     isPendingColumns: boolean;
     hasMoreData: boolean;
@@ -951,29 +978,27 @@ export declare const useReport: (reportId: number) => {
         title: string;
         request: string | null;
         data_summary: {
+            [x: string]: unknown;
             columns: {
-                [key: string]: {
-                    position?: number;
+                [x: string]: {
+                    [x: string]: unknown;
+                    position?: number | undefined;
                     data_type: string;
                     null_count: number | null;
                     unique_count: number | null;
                     unique_percentage: number | null;
-                    min_value?: number | null;
-                    max_value?: number | null;
-                    avg_value?: number | null;
-                    median_value?: number | null;
-                    std_value?: number | null;
-                    min_date?: string | null;
-                    max_date?: string | null;
-                    min_length?: number | null;
-                    max_length?: number | null;
-                    avg_length?: number | null;
-                } & {
-                    [key: string]: unknown;
+                    min_value?: number | null | undefined;
+                    max_value?: number | null | undefined;
+                    avg_value?: number | null | undefined;
+                    median_value?: number | null | undefined;
+                    std_value?: number | null | undefined;
+                    min_date?: string | null | undefined;
+                    max_date?: string | null | undefined;
+                    min_length?: number | null | undefined;
+                    max_length?: number | null | undefined;
+                    avg_length?: number | null | undefined;
                 };
             };
-        } & {
-            [key: string]: unknown;
         };
         status: string | null;
         is_removed: boolean;
@@ -993,29 +1018,27 @@ export declare const useReport: (reportId: number) => {
     title: string;
     request: string | null;
     data_summary: {
+    [x: string]: unknown;
     columns: {
-    [key: string]: {
-    position?: number;
+    [x: string]: {
+    [x: string]: unknown;
+    position?: number | undefined;
     data_type: string;
     null_count: number | null;
     unique_count: number | null;
     unique_percentage: number | null;
-    min_value?: number | null;
-    max_value?: number | null;
-    avg_value?: number | null;
-    median_value?: number | null;
-    std_value?: number | null;
-    min_date?: string | null;
-    max_date?: string | null;
-    min_length?: number | null;
-    max_length?: number | null;
-    avg_length?: number | null;
-    } & {
-    [key: string]: unknown;
+    min_value?: number | null | undefined;
+    max_value?: number | null | undefined;
+    avg_value?: number | null | undefined;
+    median_value?: number | null | undefined;
+    std_value?: number | null | undefined;
+    min_date?: string | null | undefined;
+    max_date?: string | null | undefined;
+    min_length?: number | null | undefined;
+    max_length?: number | null | undefined;
+    avg_length?: number | null | undefined;
     };
     };
-    } & {
-    [key: string]: unknown;
     };
     status: string | null;
     is_removed: boolean;
@@ -1068,7 +1091,6 @@ declare const V1FrontendVisualizationSchema: z.ZodObject<{
         type: z.ZodLiteral<"pie">;
     }, z.core.$strip>], "type">;
     created_at: z.ZodString;
-    flow_data_id: z.ZodNumber;
     flow_data: z.ZodOptional<z.ZodObject<{
         is_materialized: z.ZodNullable<z.ZodBoolean>;
         last_materialized_at: z.ZodNullable<z.ZodString>;
@@ -1079,6 +1101,7 @@ declare const V1FrontendVisualizationSchema: z.ZodObject<{
             running: "running";
         }>>;
     }, z.core.$strip>>;
+    flow_data_id: z.ZodNumber;
 }, z.core.$strip>;
 
 export declare const Visualization: ForwardRefExoticComponent<    {
@@ -1087,22 +1110,13 @@ withTitle: boolean;
 exportingEnabled?: boolean;
 } & RefAttributes<HTMLDivElement>>;
 
-export declare type WebComponentManagedModalProps = ManagedModalProps & {
+export declare type WebComponentManagedModalProps = StandaloneManagedModalProps & {
     enableCsvDownload: boolean;
 };
 
 export { }
 
 
-declare module "react" {
-    namespace JSX {
-        interface IntrinsicElements {
-            "magemetrics-ai": WebComponentManagedModalProps;
-        }
-    }
-}
-
-
 declare module "react" {
     namespace JSX {
         interface IntrinsicElements {