@magemetrics/ai 0.3.2 → 0.4.0

package/dist/react/index.d.ts

@@ -1,6 +1,7 @@
 import { AuthState } from '@magemetrics/core';
 import { CreateFlowParam } from '@magemetrics/core';
 import { default as default_2 } from 'react';
+import { Dispatch } from 'react';
 import { FetchNextPageOptions } from '@tanstack/react-query';
 import { ForwardRefExoticComponent } from 'react';
 import { GenerateInsightParam } from '@magemetrics/core';
@@ -8,8 +9,11 @@ import { InfiniteData } from '@tanstack/react-query';
 import { InfiniteQueryObserverResult } from '@tanstack/react-query';
 import { MageMetricsClient } from '@magemetrics/core';
 import { MageMetricsClientConfig } from '@magemetrics/core';
+import { OnChangeFn } from '@tanstack/react-table';
 import { PropsWithChildren } from 'react';
 import { RefAttributes } from 'react';
+import { SetStateAction } from 'react';
+import { SortingState as SortingState_2 } from '@tanstack/react-table';
 import { UseMutateAsyncFunction } from '@tanstack/react-query';
 import { UseMutateFunction } from '@tanstack/react-query';
 import { UseMutationOptions } from '@tanstack/react-query';
@@ -77,9 +81,18 @@ declare interface ConversationContentProps {
 
 export { CreateFlowParam }
 
-/** This component is not bounded in height and must be wrapped in a container to properly work */
+/**
+ * This component is not bounded in height and must be wrapped in a container to properly work
+ * @param props - props
+ * @param props.reportId - The ID of the report to display
+ * @param props.initialState - The initial state of data table
+ * @param props.onStateChange - Callback function to handle state changes
+ * @returns JSX.Element
+ */
 export declare const DataReport: React.FC<{
     reportId: number;
+    initialState?: DataTableState;
+    onStateChange?: (state: DataTableState) => void;
 }>;
 
 export declare interface DataReportMessageProps {
@@ -101,9 +114,19 @@ export declare interface DataReportMessageProps {
 
 export declare const DataTable: React.FC<DataReportMessageProps>;
 
+declare type DataTableState = {
+    pageIndex: number;
+    pageSize: number;
+    sorting: SortingState;
+    filters: TableFilters;
+};
+
 declare type DisplayControlProps = {
+    /** Whether to display the recommendations section when the input is active */
     showRecommendations?: boolean;
+    /** Whether to display recent chats when the input is active */
     showRecentChats?: boolean;
+    /** Whether to display a backdrop overlay when the input is active */
     showBackdrop?: boolean;
 };
 
@@ -113,6 +136,10 @@ declare type DomWrapperProps = {
     display?: string;
 };
 
+export declare const DownloadDataReportButton: React.FC<{
+    reportId: number;
+}>;
+
 declare type ExportReportDataParams = {
     reportId: number;
     filename?: string;
@@ -129,19 +156,9 @@ declare type ExtractInsightResponse = z.infer<typeof ExtractInsightResponseSchem
 declare const ExtractInsightResponseSchema: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text">;
     insight: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    type: "text";
-    insight: string;
-}, {
-    type: "text";
-    insight: string;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"missing">;
-}, "strip", z.ZodTypeAny, {
-    type: "missing";
-}, {
-    type: "missing";
-}>]>;
+}, z.core.$strip>]>;
 
 /**
  * This module handles the formatting and normalization of table cell values for display and sorting.
@@ -175,229 +192,75 @@ declare type FrontendReport = z.infer<typeof FrontendReportSchema>;
 declare type FrontendReportColumns = z.infer<typeof FrontendReportColumnsSchema>;
 
 declare const FrontendReportColumnsSchema: z.ZodArray<z.ZodObject<{
-    name: z.ZodString;
-    data_type: z.ZodString;
-} & {
     dataType: z.ZodString;
     renderType: z.ZodOptional<z.ZodString>;
     unit: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    data_type: string;
-    dataType: string;
-    unit?: string | undefined;
-    renderType?: string | undefined;
-}, {
-    name: string;
-    data_type: string;
-    dataType: string;
-    unit?: string | undefined;
-    renderType?: string | undefined;
-}>, "many">;
+    name: z.ZodString;
+    data_type: z.ZodString;
+}, z.core.$strip>>;
 
 declare type FrontendReportExplainability = z.infer<typeof FrontendReportExplainabilitySchema>;
 
-declare const FrontendReportExplainabilitySchema: z.ZodObject<Omit<{
+declare const FrontendReportExplainabilitySchema: z.ZodObject<{
+    flow_data_id: z.ZodNumber;
     sql_explanation: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         chunk_title: z.ZodString;
         chunk_explanation: z.ZodString;
         lines: z.ZodArray<z.ZodObject<{
             sql: z.ZodString;
             explanation: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            explanation: string;
-            sql: string;
-        }, {
-            explanation: string;
-            sql: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        chunk_title: string;
-        chunk_explanation: string;
-        lines: {
-            explanation: string;
-            sql: string;
-        }[];
-    }, {
-        chunk_title: string;
-        chunk_explanation: string;
-        lines: {
-            explanation: string;
-            sql: string;
-        }[];
-    }>, "many">>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
     business_explanation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         summary: z.ZodString;
-        implementation: z.ZodArray<z.ZodString, "many">;
+        implementation: z.ZodArray<z.ZodString>;
         assumptions: z.ZodArray<z.ZodObject<{
-            type: z.ZodEnum<["grain", "completeness", "transformation", "relationship", "other"]>;
+            type: z.ZodEnum<{
+                grain: "grain";
+                completeness: "completeness";
+                transformation: "transformation";
+                relationship: "relationship";
+                other: "other";
+            }>;
             details: z.ZodString;
             explanation: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            explanation: string;
-            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
-            details: string;
-        }, {
-            explanation: string;
-            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
-            details: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        implementation: string[];
-        summary: string;
-        assumptions: {
-            explanation: string;
-            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
-            details: string;
-        }[];
-    }, {
-        implementation: string[];
-        summary: string;
-        assumptions: {
-            explanation: string;
-            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
-            details: string;
-        }[];
-    }>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     columns_lineage: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
         nodes: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
-            type: z.ZodEnum<["entity", "attribute", "filter", "process", "combine", "result"]>;
+            type: z.ZodEnum<{
+                result: "result";
+                filter: "filter";
+                entity: "entity";
+                attribute: "attribute";
+                process: "process";
+                combine: "combine";
+            }>;
             explanation: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            explanation: string;
-            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
-            id: string;
-        }, {
-            explanation: string;
-            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
-            id: string;
-        }>, "many">;
+        }, z.core.$strip>>;
         edges: z.ZodArray<z.ZodObject<{
             source: z.ZodString;
             target: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            source: string;
-            target: string;
-        }, {
-            source: string;
-            target: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        nodes: {
-            explanation: string;
-            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
-            id: string;
-        }[];
-        edges: {
-            source: string;
-            target: string;
-        }[];
-    }, {
-        nodes: {
-            explanation: string;
-            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
-            id: string;
-        }[];
-        edges: {
-            source: string;
-            target: string;
-        }[];
-    }>>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
     confidence_score: z.ZodNumber;
     confidence_score_reason: z.ZodString;
     assumptions_score: z.ZodOptional<z.ZodNumber>;
     assumptions_score_reason: z.ZodOptional<z.ZodString>;
     friendliness_score: z.ZodOptional<z.ZodNumber>;
     friendliness_score_reason: z.ZodOptional<z.ZodString>;
-    id: z.ZodNumber;
-    flow_data_id: z.ZodNumber;
-    created_at: z.ZodString;
-}, "id" | "created_at">, "strip", z.ZodTypeAny, {
-    flow_data_id: number;
-    confidence_score: number;
-    confidence_score_reason: string;
-    sql_explanation?: {
-        chunk_title: string;
-        chunk_explanation: string;
-        lines: {
-            explanation: string;
-            sql: string;
-        }[];
-    }[] | null | undefined;
-    business_explanation?: {
-        implementation: string[];
-        summary: string;
-        assumptions: {
-            explanation: string;
-            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
-            details: string;
-        }[];
-    } | null | undefined;
-    columns_lineage?: Record<string, {
-        nodes: {
-            explanation: string;
-            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
-            id: string;
-        }[];
-        edges: {
-            source: string;
-            target: string;
-        }[];
-    }> | null | undefined;
-    assumptions_score?: number | undefined;
-    assumptions_score_reason?: string | undefined;
-    friendliness_score?: number | undefined;
-    friendliness_score_reason?: string | undefined;
-}, {
-    flow_data_id: number;
-    confidence_score: number;
-    confidence_score_reason: string;
-    sql_explanation?: {
-        chunk_title: string;
-        chunk_explanation: string;
-        lines: {
-            explanation: string;
-            sql: string;
-        }[];
-    }[] | null | undefined;
-    business_explanation?: {
-        implementation: string[];
-        summary: string;
-        assumptions: {
-            explanation: string;
-            type: "grain" | "completeness" | "transformation" | "relationship" | "other";
-            details: string;
-        }[];
-    } | null | undefined;
-    columns_lineage?: Record<string, {
-        nodes: {
-            explanation: string;
-            type: "filter" | "result" | "entity" | "attribute" | "process" | "combine";
-            id: string;
-        }[];
-        edges: {
-            source: string;
-            target: string;
-        }[];
-    }> | null | undefined;
-    assumptions_score?: number | undefined;
-    assumptions_score_reason?: string | undefined;
-    friendliness_score?: number | undefined;
-    friendliness_score_reason?: string | undefined;
-}>;
+}, z.core.$strip>;
 
-declare const FrontendReportSchema: z.ZodObject<Omit<{
-    created_at: z.ZodString;
-    flow_id: z.ZodString;
-    id: z.ZodNumber;
-    is_sample: z.ZodBoolean;
-    schema: z.ZodString;
-    sql: z.ZodString;
-    table: z.ZodString;
+declare const FrontendReportSchema: z.ZodObject<{
+    status: z.ZodNullable<z.ZodString>;
     title: z.ZodString;
+    id: z.ZodNumber;
     request: z.ZodNullable<z.ZodString>;
-    data_sample: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    created_at: z.ZodString;
+    is_removed: z.ZodBoolean;
+    flow_id: z.ZodString;
+    bookmarked: z.ZodBoolean;
     data_summary: z.ZodObject<{
         columns: z.ZodRecord<z.ZodString, z.ZodObject<{
             position: z.ZodOptional<z.ZodNumber>;
@@ -405,118 +268,18 @@ declare const FrontendReportSchema: z.ZodObject<Omit<{
             null_count: z.ZodNullable<z.ZodNumber>;
             unique_count: z.ZodNullable<z.ZodNumber>;
             unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">>>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        columns: z.ZodRecord<z.ZodString, z.ZodObject<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">>>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        columns: z.ZodRecord<z.ZodString, z.ZodObject<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">>>;
-    }, z.ZodTypeAny, "passthrough">>;
-    bookmarked: z.ZodBoolean;
-    status: z.ZodNullable<z.ZodString>;
-    is_removed: z.ZodBoolean;
-}, "schema" | "sql" | "table" | "data_sample" | "is_sample">, "strip", z.ZodTypeAny, {
-    title: string;
-    status: string | null;
-    id: number;
-    request: string | null;
-    created_at: string;
-    is_removed: boolean;
-    flow_id: string;
-    bookmarked: boolean;
-    data_summary: {
-        columns: Record<string, z.objectOutputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">>;
-    } & {
-        [k: string]: unknown;
-    };
-}, {
-    title: string;
-    status: string | null;
-    id: number;
-    request: string | null;
-    created_at: string;
-    is_removed: boolean;
-    flow_id: string;
-    bookmarked: boolean;
-    data_summary: {
-        columns: Record<string, z.objectInputType<{
-            position: z.ZodOptional<z.ZodNumber>;
-            data_type: z.ZodString;
-            null_count: z.ZodNullable<z.ZodNumber>;
-            unique_count: z.ZodNullable<z.ZodNumber>;
-            unique_percentage: z.ZodNullable<z.ZodNumber>;
-        }, z.ZodTypeAny, "passthrough">>;
-    } & {
-        [k: string]: unknown;
-    };
-}>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
 
 declare type FrontendVisualization = z.output<typeof FrontendVisualizationSchema>;
 
-declare const FrontendVisualizationSchema: z.ZodObject<Omit<{
+declare const FrontendVisualizationSchema: z.ZodObject<{
     id: z.ZodNumber;
-    flow_data_id: z.ZodNumber;
     created_at: z.ZodString;
-    sql: z.ZodString;
+    flow_data_id: z.ZodNumber;
     bookmarked: z.ZodBoolean;
-    data_sample: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-    is_sample: z.ZodBoolean;
-    data_summary: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-} & {
-    configuration: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
         config_version: z.ZodLiteral<2>;
         xAxisLabel: z.ZodString;
         yAxisLabel: z.ZodString;
@@ -525,46 +288,14 @@ declare const FrontendVisualizationSchema: z.ZodObject<Omit<{
         valueColumn: z.ZodString;
         title: z.ZodString;
         type: z.ZodLiteral<"bar">;
-    }, "strip", z.ZodTypeAny, {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        secondaryCategoryColumn?: string | undefined;
-    }, {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        secondaryCategoryColumn?: string | undefined;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         xAxisColumn: z.ZodString;
-        valueColumns: z.ZodArray<z.ZodString, "many">;
-        yAxisLabels: z.ZodArray<z.ZodString, "many">;
+        valueColumns: z.ZodArray<z.ZodString>;
+        yAxisLabels: z.ZodArray<z.ZodString>;
         title: z.ZodString;
         type: z.ZodLiteral<"line/area">;
         config_version: z.ZodLiteral<2>;
-    }, "strip", z.ZodTypeAny, {
-        type: "line/area";
-        title: string;
-        valueColumns: string[];
-        config_version: 2;
-        xAxisColumn: string;
-        yAxisLabels: string[];
-    }, {
-        type: "line/area";
-        title: string;
-        valueColumns: string[];
-        config_version: 2;
-        xAxisColumn: string;
-        yAxisLabels: string[];
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         config_version: z.ZodLiteral<2>;
         valueColumn: z.ZodString;
         xAxisColumn: z.ZodString;
@@ -573,25 +304,7 @@ declare const FrontendVisualizationSchema: z.ZodObject<Omit<{
         categoryColumn: z.ZodString;
         title: z.ZodString;
         type: z.ZodLiteral<"line/area-categorical">;
-    }, "strip", z.ZodTypeAny, {
-        type: "line/area-categorical";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        xAxisColumn: string;
-    }, {
-        type: "line/area-categorical";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        xAxisColumn: string;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         config_version: z.ZodLiteral<2>;
         xAxisLabel: z.ZodString;
         yAxisLabel: z.ZodString;
@@ -599,132 +312,14 @@ declare const FrontendVisualizationSchema: z.ZodObject<Omit<{
         yAxisValueColumn: z.ZodString;
         title: z.ZodString;
         type: z.ZodLiteral<"scatter">;
-    }, "strip", z.ZodTypeAny, {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        xAxisValueColumn: string;
-        yAxisValueColumn: string;
-    }, {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        xAxisValueColumn: string;
-        yAxisValueColumn: string;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         config_version: z.ZodLiteral<2>;
         categoryColumn: z.ZodString;
         valueColumn: z.ZodString;
         title: z.ZodString;
         type: z.ZodLiteral<"pie">;
-    }, "strip", z.ZodTypeAny, {
-        type: "pie";
-        title: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-    }, {
-        type: "pie";
-        title: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-    }>]>;
-}, "sql" | "data_sample" | "is_sample" | "data_summary">, "strip", z.ZodTypeAny, {
-    id: number;
-    created_at: string;
-    flow_data_id: number;
-    bookmarked: boolean;
-    configuration: {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        secondaryCategoryColumn?: string | undefined;
-    } | {
-        type: "line/area";
-        title: string;
-        valueColumns: string[];
-        config_version: 2;
-        xAxisColumn: string;
-        yAxisLabels: string[];
-    } | {
-        type: "line/area-categorical";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        xAxisColumn: string;
-    } | {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        xAxisValueColumn: string;
-        yAxisValueColumn: string;
-    } | {
-        type: "pie";
-        title: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-    };
-}, {
-    id: number;
-    created_at: string;
-    flow_data_id: number;
-    bookmarked: boolean;
-    configuration: {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        secondaryCategoryColumn?: string | undefined;
-    } | {
-        type: "line/area";
-        title: string;
-        valueColumns: string[];
-        config_version: 2;
-        xAxisColumn: string;
-        yAxisLabels: string[];
-    } | {
-        type: "line/area-categorical";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-        xAxisColumn: string;
-    } | {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        config_version: 2;
-        xAxisValueColumn: string;
-        yAxisValueColumn: string;
-    } | {
-        type: "pie";
-        title: string;
-        config_version: 2;
-        categoryColumn: string;
-        valueColumn: string;
-    };
-}>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>;
 
 export { GenerateInsightParam }
 
@@ -742,7 +337,7 @@ declare type InfiniteDataTableUIProps = {
     totalRows: number;
 };
 
-export declare const logout: () => Promise<void>;
+export declare const logout: () => void;
 
 export { MageMetricsClient }
 
@@ -774,32 +369,84 @@ declare type MageMetricsPublicContextProviderProps = PropsWithChildren<Pick<Mage
 export declare const ManagedModal: React.FC<ManagedModalProps>;
 
 declare interface ManagedModalProps extends 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;
+    /** 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;
 }
 
 declare interface ModalProps {
+    /** CSS display property for the wrapper element */
     display?: string;
+    /** Control modal visibility and close behavior externally */
     modal?: ControlledModalProps;
+    /** Configuration options for the start modal (chat launcher, recommendations, etc.) */
     startOptions?: StartOptions;
 }
 
+export declare const PaginatedDataTableUI: React.FC<PaginatedDataTableUIProps>;
+
+declare type PaginatedDataTableUIProps = {
+    reportId: number;
+    data: Record<string, unknown>[];
+    columns: FrontendReportColumns;
+    explainability: FrontendReportExplainability | null | undefined;
+    isFetching: boolean;
+    totalRows?: number;
+    pageIndex: number;
+    pageSize: number;
+    totalPages?: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    onNextPage: () => void;
+    onPreviousPage: () => void;
+    goToPage: (page: number) => void;
+    sorting: SortingState;
+    onSortingChange: OnChangeFn<SortingState>;
+    filters: TableFilters;
+    onFiltersChange: (filters: TableFilters) => void;
+    onCalculatedPageSize?: (pageSize: number) => void;
+    onStateChange?: (state: {
+        pageIndex: number;
+        pageSize: number;
+        sorting: SortingState;
+        filters: TableFilters;
+    }) => void;
+    emptyState?: React.ReactNode;
+};
+
 declare type PersistenceOptions = "queryParam" | "none";
 
 export declare const PublicCanvas: React.FC<React.ComponentProps<typeof PublicCanvasPanel>>;
 
-/** This component is not bounded in height and must be wrapped in a container to properly work */
-export declare const PublicCanvasDataReport: React.FC<{
+declare const PublicCanvasPanel: default_2.FC<{
     canvasId: string;
-    reportId: number;
 }>;
 
-declare const PublicCanvasPanel: default_2.FC<{
+/**
+ * This component is not bounded in height and must be wrapped in a container to properly work
+ * @param props - props
+ * @param props.canvasId - The ID of the canvas to display
+ * @param props.reportId - The ID of the report to display
+ * @param props.initialState - The initial state of data table
+ * @param props.onStateChange - Callback function to handle state changes
+ * @returns JSX.Element
+ */
+export declare const PublicDataReport: React.FC<{
     canvasId: string;
+    reportId: number;
+    initialState?: DataTableState;
+    onStateChange?: (state: DataTableState) => void;
 }>;
 
 declare type ReportDataFilters = {
@@ -818,13 +465,19 @@ declare type StandaloneConversationModalProps = {
     opened: boolean;
     flowId: string;
     disableCanvas?: boolean;
+    showDataFreshness?: boolean;
     onOpenChange?: (open: boolean) => void;
 };
 
 declare type StartOptions = DisplayControlProps & {
+    /** Label text displayed above the chat launcher input */
     label?: string;
+    /** Label text displayed above the recommendations section */
     recommendationsLabel?: string;
+    /** Placeholder text for the chat launcher input field */
     placeholder?: string;
+    /** Whether the chat launcher input should auto-focus on mount */
+    autoFocus?: boolean;
 };
 
 declare type TableFilters = Record<string, string | number>;
@@ -957,11 +610,15 @@ export declare const useDataReport: (reportId: FrontendReport["id"]) => {
     }[] | undefined;
     isPendingColumns: boolean;
     isPendingData: boolean;
-    fetchNextPage: (options?: FetchNextPageOptions) => Promise<InfiniteQueryObserverResult<InfiniteData<Record<string, unknown>[], unknown>, Error>>;
+    fetchNextPage: (options?: FetchNextPageOptions) => Promise<InfiniteQueryObserverResult<InfiniteData<    {
+    [key: string]: unknown;
+    }[], unknown>, Error>>;
     isFetching: boolean;
     isFetchingNextPage: boolean;
     hasNextPage: boolean;
-    allData: Record<string, unknown>[];
+    allData: {
+        [key: string]: unknown;
+    }[];
     explainability: {
         sql_explanation?: {
             chunk_title: string;
@@ -1002,10 +659,14 @@ export declare const useDataReport: (reportId: FrontendReport["id"]) => {
         flow_data_id: number;
     } | null | undefined;
     totalRows: number;
-    infiniteData: InfiniteData<Record<string, unknown>[], unknown> | undefined;
+    infiniteData: InfiniteData<    {
+    [key: string]: unknown;
+    }[], unknown> | undefined;
 };
 
-export declare const useDataReportColumnValue: (reportId: number, filters: ReportDataFilters) => UseQueryResult<Record<string, unknown>[], Error>;
+export declare const useDataReportColumnValue: (reportId: number, filters: ReportDataFilters) => UseQueryResult<    {
+[key: string]: unknown;
+}[], Error>;
 
 export declare const useDownloadReportData: (options?: UseMutationOptions<ExportReportDataResult, Error, ExportReportDataParams>) => {
     download: UseMutateFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
@@ -1250,6 +911,79 @@ export declare const useMageMetricsClient: () => MageMetricsClient;
 
 export declare const useMageMetricsReady: () => false | MageMetricsClient;
 
+export declare const usePaginatedDataReport: (reportId: FrontendReport["id"], options?: {
+    pageSize?: number;
+    initialPageIndex?: number;
+    initialSorting?: SortingState_2;
+    initialFilters?: TableFilters;
+}) => {
+    columns: {
+        name: string;
+        data_type: string;
+        dataType: string;
+        renderType?: string;
+        unit?: string;
+    }[] | undefined;
+    isPendingColumns: boolean;
+    isPendingData: boolean;
+    isFetching: boolean;
+    data: {
+        [key: string]: unknown;
+    }[];
+    explainability: {
+        sql_explanation?: {
+            chunk_title: string;
+            chunk_explanation: string;
+            lines: {
+                sql: string;
+                explanation: string;
+            }[];
+        }[] | null;
+        business_explanation?: {
+            summary: string;
+            implementation: string[];
+            assumptions: {
+                type: "grain" | "completeness" | "transformation" | "relationship" | "other";
+                details: string;
+                explanation: string;
+            }[];
+        } | null;
+        columns_lineage?: {
+            [key: string]: {
+                nodes: {
+                    id: string;
+                    type: "entity" | "attribute" | "filter" | "process" | "combine" | "result";
+                    explanation: string;
+                }[];
+                edges: {
+                    source: string;
+                    target: string;
+                }[];
+            };
+        } | null;
+        confidence_score: number;
+        confidence_score_reason: string;
+        assumptions_score?: number;
+        assumptions_score_reason?: string;
+        friendliness_score?: number;
+        friendliness_score_reason?: string;
+        flow_data_id: number;
+    } | null | undefined;
+    totalRows: number | undefined;
+    pageIndex: number;
+    pageSize: number;
+    totalPages: number | undefined;
+    nextPage: () => void;
+    previousPage: () => void;
+    goToPage: (page: number) => void;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    sorting: SortingState_2;
+    setSorting: Dispatch<SetStateAction<SortingState_2>>;
+    filters: TableFilters;
+    setFilters: (newFilters: TableFilters) => void;
+};
+
 export declare const useRecentFlows: (limit?: number) => UseQueryResult<    {
 id: string;
 request: string;
@@ -1259,194 +993,50 @@ user_id: string | null;
 
 declare type V1FrontendVisualization = z.output<typeof V1FrontendVisualizationSchema>;
 
-declare const V1FrontendVisualizationSchema: z.ZodObject<Omit<{
+declare const V1FrontendVisualizationSchema: z.ZodObject<{
     id: z.ZodNumber;
-    flow_data_id: z.ZodNumber;
     created_at: z.ZodString;
-    sql: z.ZodString;
+    flow_data_id: z.ZodNumber;
     bookmarked: z.ZodBoolean;
-    data_sample: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-    is_sample: z.ZodBoolean;
-    data_summary: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-} & {
-    configuration: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
         xAxisLabel: z.ZodString;
         yAxisLabel: z.ZodString;
         xAxisDataKey: z.ZodOptional<z.ZodString>;
         yAxisDataKey: z.ZodOptional<z.ZodString>;
         dimensionDataKey: z.ZodOptional<z.ZodString>;
-        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
         title: z.ZodString;
         type: z.ZodLiteral<"bar">;
-    }, "strip", z.ZodTypeAny, {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    }, {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         xAxisLabel: z.ZodString;
         yAxisLabel: z.ZodString;
         xAxisDataKey: z.ZodOptional<z.ZodString>;
         yAxisDataKey: z.ZodOptional<z.ZodString>;
         dimensionDataKey: z.ZodOptional<z.ZodString>;
-        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
         title: z.ZodString;
         type: z.ZodLiteral<"line/area">;
-    }, "strip", z.ZodTypeAny, {
-        type: "line/area";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    }, {
-        type: "line/area";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         xAxisLabel: z.ZodString;
         yAxisLabel: z.ZodString;
         xAxisDataKey: z.ZodOptional<z.ZodString>;
         yAxisDataKey: z.ZodOptional<z.ZodString>;
         dimensionDataKey: z.ZodOptional<z.ZodString>;
-        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        valueColumns: z.ZodOptional<z.ZodArray<z.ZodString>>;
         title: z.ZodString;
         type: z.ZodLiteral<"scatter">;
-    }, "strip", z.ZodTypeAny, {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    }, {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         nameKey: z.ZodString;
         dataKey: z.ZodString;
         title: z.ZodString;
         type: z.ZodLiteral<"pie">;
-    }, "strip", z.ZodTypeAny, {
-        type: "pie";
-        title: string;
-        nameKey: string;
-        dataKey: string;
-    }, {
-        type: "pie";
-        title: string;
-        nameKey: string;
-        dataKey: string;
-    }>]>;
-}, "sql" | "data_sample" | "is_sample" | "data_summary">, "strip", z.ZodTypeAny, {
-    id: number;
-    created_at: string;
-    flow_data_id: number;
-    bookmarked: boolean;
-    configuration: {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    } | {
-        type: "line/area";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    } | {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    } | {
-        type: "pie";
-        title: string;
-        nameKey: string;
-        dataKey: string;
-    };
-}, {
-    id: number;
-    created_at: string;
-    flow_data_id: number;
-    bookmarked: boolean;
-    configuration: {
-        type: "bar";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    } | {
-        type: "line/area";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    } | {
-        type: "scatter";
-        title: string;
-        xAxisLabel: string;
-        yAxisLabel: string;
-        valueColumns?: string[] | undefined;
-        xAxisDataKey?: string | undefined;
-        yAxisDataKey?: string | undefined;
-        dimensionDataKey?: string | undefined;
-    } | {
-        type: "pie";
-        title: string;
-        nameKey: string;
-        dataKey: string;
-    };
-}>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>;
 
 export declare const Visualization: ForwardRefExoticComponent<    {
 visualizationId: number;
 withTitle: boolean;
+exportingEnabled?: boolean;
 } & RefAttributes<HTMLDivElement>>;
 
 export { }
@@ -1455,7 +1045,7 @@ export { }
 declare module "react" {
     namespace JSX {
         interface IntrinsicElements {
-            "magemetrics-ai": ManagedModalProps;
+            "magemetrics-ai": WebComponentManagedModalProps;
         }
     }
 }
@@ -1464,7 +1054,7 @@ declare module "react" {
 declare module "react" {
     namespace JSX {
         interface IntrinsicElements {
-            "magemetrics-ai": ManagedModalProps;
+            "magemetrics-ai": WebComponentManagedModalProps;
         }
     }
 }