@quillsql/react 2.16.29 → 2.16.31

package/dist/index.d.cts

@@ -73,6 +73,8 @@ interface SelectComponentProps {
     isLoading?: boolean;
     hideEmptyOption?: boolean;
     disabled?: boolean;
+    /** Compact trigger (e.g. chat toolbar). */
+    size?: 'default' | 'sm';
 }
 interface MultiSelectComponentProps {
     label?: string;
@@ -516,12 +518,12 @@ type ColorMapType = {
 /**
  * A set of valid format values for the x and y axes of dashboard items.
  */
-type AxisFormat = 'percent' | 'dollar_amount' | 'dollar_cents' | 'whole_number' | 'one_decimal_place' | 'two_decimal_places' | 'percentage' | 'string' | 'yyyy' | 'MMM_dd' | 'MMM_yyyy' | 'MMM_dd_yyyy' | 'hh_ap_pm' | 'MMM_dd-MMM_dd' | 'MMM_dd_hh:mm_ap_pm' | 'wo, yyyy';
+type AxisFormat$1 = 'percent' | 'dollar_amount' | 'dollar_cents' | 'whole_number' | 'one_decimal_place' | 'two_decimal_places' | 'percentage' | 'string' | 'yyyy' | 'MMM_dd' | 'MMM_yyyy' | 'MMM_dd_yyyy' | 'hh_ap_pm' | 'MMM_dd-MMM_dd' | 'MMM_dd_hh:mm_ap_pm' | 'wo, yyyy';
 
 interface Column$1 {
     field: string;
     label: string;
-    format: AxisFormat;
+    format: AxisFormat$1;
     inferFormat?: boolean;
 }
 interface ColumnInternal extends Column$1 {
@@ -546,6 +548,10 @@ interface BasePivot {
     rowFieldType?: string;
     columnField?: string;
     columnFieldType?: string;
+    /** Source table for rowField (multi-table / disambiguation). */
+    rowFieldTable?: string;
+    /** Source table for columnField (multi-table / disambiguation). */
+    columnFieldTable?: string;
     sort?: boolean;
     sortDirection?: 'ASC' | 'DESC';
     sortField?: string;
@@ -555,6 +561,14 @@ interface BasePivot {
     rowLimit?: number;
     columnValues?: string[];
 }
+type PivotAggregation = {
+    aggregationType: AggregationType;
+    valueField?: string;
+    valueFieldType?: string;
+    valueField2?: string;
+    valueField2Type?: string;
+    valueFieldTable?: string;
+};
 interface SingleAggregationPivot extends BasePivot {
     aggregationType: AggregationType;
     valueField?: string;
@@ -569,13 +583,7 @@ interface MultiAggregationPivot extends BasePivot {
     valueField2?: never;
     valueField2Type?: never;
     valueFieldType?: never;
-    aggregations: {
-        valueField?: string;
-        valueFieldType?: string;
-        valueField2?: string;
-        valueField2Type?: string;
-        aggregationType: AggregationType;
-    }[];
+    aggregations: PivotAggregation[];
 }
 type AggregationType = 'sum' | 'average' | 'min' | 'max' | 'count' | 'avg' | 'percentage';
 type PivotData = {
@@ -629,6 +637,28 @@ type ReportBuilderState = {
     limit: ReportBuilderLimit | null;
 };
 
+/**
+ * Represents a table object returned from /schema2/:id
+ */
+type Table$1 = {
+    _id: string;
+    isSelectStar: boolean;
+    displayName: string;
+    name: string;
+    columns: ColumnInternal[];
+    viewQuery: string;
+    customFieldInfo: any;
+    broken?: boolean;
+    error?: string;
+    ownerTenantFields?: string[];
+};
+interface UniqueValuesByTable {
+    [table: string]: UniqueValuesByColumn;
+}
+interface UniqueValuesByColumn {
+    [column: string]: string[];
+}
+
 /**
  * ## QuillReport
  * Represents an individual item on a dashboard.
@@ -669,7 +699,7 @@ interface QuillReport {
     /** The field to use for this report's xAxis. */
     xAxisField: string;
     /** The format for this report's xAxis. */
-    xAxisFormat: AxisFormat;
+    xAxisFormat: AxisFormat$1;
     /** The template flag for a report */
     template?: boolean;
     /**
@@ -681,7 +711,7 @@ interface QuillReport {
         /** The label to use for this yAxis. */
         label: string;
         /** The format of the data in this yAxis. */
-        format: AxisFormat;
+        format: AxisFormat$1;
     }[];
     /**
      * The relative ordering of this report in relation to its siblings. Ordering
@@ -770,15 +800,19 @@ interface QuillReportInternal extends QuillReport {
     flags?: {
         [tenantField: string]: string[] | 'QUILL_ALL_TENANTS';
     };
-    /** Indicates whether this report can be cached. */
-    isCacheable?: boolean;
-    /** Reason why this report query cannot be cached. */
-    isCacheableReason?: string;
     /**
      * ReportBuilderState used for ReportBuilder reports.
      * When present, backend will generate SQL from this state instead of using queryString.
      */
     reportBuilderState?: ReportBuilderState;
+    /** String unique values grouped by table/column, used by filter builders. */
+    uniqueStringsByTable?: UniqueValuesByTable;
+    /** String unique values keyed by column name, used by filter builders. */
+    uniqueStringsByColumn?: UniqueValuesByColumn;
+    /** Legacy alias for unique string values keyed by column name. */
+    columnUniqueValues?: UniqueValuesByColumn;
+    /** Backward-compatible alias for unique string values keyed by column name. */
+    uniqueValues?: UniqueValuesByColumn;
 }
 
 /**
@@ -1083,15 +1117,8 @@ interface DashboardProps {
     name: string;
     onClickReport: (report: QuillReport) => void;
     containerStyle?: CSSProperties;
-    config?: {
-        pageSize?: number;
-        frontendCacheConfig?: {
-            cacheType: 'memory' | 'indexedDB';
-        };
-        disableBackendCache?: boolean;
-    };
 }
-declare function Dashboard({ name, onClickReport, containerStyle, config }: DashboardProps & React.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+declare function Dashboard({ name, onClickReport, containerStyle, }: DashboardProps & React.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
 
 type DashboardConfig = {
     dashboardId: string;
@@ -1223,6 +1250,7 @@ interface BaseQuillProviderProps {
     isAdmin?: boolean;
     getAuthorizationToken?: () => Promise<string>;
     eventTracking?: EventTracking | null;
+    streamEndpoint?: string;
 }
 interface QuillCloudProviderProps extends BaseQuillProviderProps {
     tenants: {
@@ -1311,8 +1339,68 @@ type QuillProviderProps = QuillCloudProviderProps | SelfHostedProviderProps;
  * ### Dashboard API
  * @see https://docs.quillsql.com/components/quill-provider
  */
-declare const QuillProvider: ({ tenants, flags, publicKey, queryEndpoint, queryHeaders, children, theme, withCredentials, isAdmin, getAuthorizationToken, eventTracking, }: QuillProviderProps) => react_jsx_runtime.JSX.Element;
+declare const QuillProvider: ({ tenants, flags, publicKey, queryEndpoint, streamEndpoint, queryHeaders, children, theme, withCredentials, isAdmin, getAuthorizationToken, eventTracking, }: QuillProviderProps) => react_jsx_runtime.JSX.Element;
 
+interface TableComponentProps {
+    rows: object[];
+    rowCount?: number;
+    rowCountIsLoading?: boolean;
+    columns: {
+        label: string;
+        field: string;
+        format?: string;
+    }[];
+    currentPage: number;
+    sort?: {
+        field: string;
+        direction: string;
+    };
+    className?: string;
+    containerStyle?: React$1.CSSProperties;
+    isLoading?: boolean;
+    hideCSVDownloadButton?: boolean;
+    downloadCSV?: () => void;
+    LoadingComponent?: () => React$1.JSX.Element;
+    DownloadCSVButtonComponent?: (props: ButtonComponentProps) => React$1.JSX.Element;
+    rowsPerPage?: number;
+    emptyStateLabel?: string;
+    onPageChange?: (page: number) => void;
+    onSortChange?: (sort: {
+        field: string;
+        direction: string;
+    }) => void;
+    headerBackgroundColor?: string;
+    footerBackgroundColor?: string;
+    borderRadius?: string | number;
+    borderLeft?: string;
+    borderRight?: string;
+    borderTop?: string;
+    borderBottom?: string;
+}
+
+interface BaseChartProps {
+    colors?: string[];
+    containerStyle?: React.CSSProperties;
+    className?: string;
+    isAnimationActive?: boolean;
+    hideXAxis?: boolean;
+    hideYAxis?: boolean;
+    hideCartesianGrid?: boolean;
+    hideDateRangeFilter?: boolean;
+    hideHorizontalCartesianGrid?: boolean;
+    hideVerticalCartesianGrid?: boolean;
+    hideSubsequentXAxisTicks?: boolean;
+    cartesianGridLineStyle?: 'solid' | 'dashed';
+    cartesianGridLineColor?: string;
+    comparisonLineStyle?: 'solid' | 'dashed';
+    mapColorsToFields?: (_report: QuillReport, _theme: QuillTheme) => ColorMapType;
+    LoadingComponent?: () => React.JSX.Element;
+    filters?: InternalFilter[];
+    onClickChartElement?: (data: any) => void;
+}
+interface WithConfig extends BaseChartProps {
+    config?: QuillReport;
+}
 /**
  * Props for the Quill Chart component.
  */
@@ -1485,6 +1573,32 @@ interface ChartProps {
     isAdmin?: boolean;
 }
 declare function Chart({ colors, reportId, className, containerStyle, isAnimationActive, hideXAxis, hideYAxis, hideCartesianGrid, hideHorizontalCartesianGrid, hideVerticalCartesianGrid, hideSubsequentXAxisTicks, cartesianGridLineStyle, cartesianGridLineColor, comparisonLineStyle, hideDateRangeFilter, hideFilters, mapColorsToFields, LoadingComponent, SelectComponent, MultiSelectComponent, DateRangePickerComponent, FilterContainerComponent, TableComponent, MetricComponent, filters, onClickChartElement, dateBucket, propagateChanges, isAdmin, }: ChartProps): react_jsx_runtime.JSX.Element;
+interface ChartDisplayProps extends WithConfig {
+    loading: boolean;
+    ErrorComponent?: ({ errorMessage, }: {
+        errorMessage: string;
+    }) => React.JSX.Element;
+    colorMap?: ColorMapType;
+    reportId?: string;
+    onPageChange?: (page: number) => void;
+    onSortChange?: (sort: {
+        field: string;
+        direction: string;
+    }) => void;
+    onClickChartElement?: (data: any) => void;
+    scrollable?: boolean;
+    overrideTheme?: QuillTheme;
+    referenceLines?: {
+        label: string;
+        query: number[];
+    }[];
+    showLegend?: boolean;
+    tableRowsLoading?: boolean;
+    disableTableSort?: boolean;
+    /** When `chartType` is `table`, applied to QuillTable's outer frame only (not cell lines). */
+    tableChartWrapperBorders?: Pick<TableComponentProps, 'borderRadius' | 'borderLeft' | 'borderRight' | 'borderTop' | 'borderBottom'>;
+}
+declare const ChartDisplay: ({ reportId, config, colors, className, containerStyle, hideXAxis, hideYAxis, hideCartesianGrid, hideDateRangeFilter, hideHorizontalCartesianGrid, hideVerticalCartesianGrid, hideSubsequentXAxisTicks, cartesianGridLineStyle, cartesianGridLineColor, comparisonLineStyle, isAnimationActive, scrollable, loading, ErrorComponent, colorMap, LoadingComponent, onPageChange, onSortChange, onClickChartElement, overrideTheme, referenceLines, showLegend, tableRowsLoading, tableChartWrapperBorders, }: ChartDisplayProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Props for the Quill Table component.
@@ -1552,6 +1666,7 @@ interface TableProps {
     columns?: {
         label: string;
         field: string;
+        format?: string;
     }[];
     /**
      * The placeholder filename to use when downloading this table as a csv file.
@@ -1627,6 +1742,12 @@ interface TableProps {
      * Styles the top-level container of the Table.
      */
     containerStyle?: React$1.CSSProperties;
+    /** Passed through to QuillTable when rendering with `rows` / `columns`. */
+    borderRadius?: string | number;
+    borderLeft?: string;
+    borderRight?: string;
+    borderTop?: string;
+    borderBottom?: string;
     /** An array of dashboard filters that are indicated by the frontend dev. */
     filters?: Filter[];
 }
@@ -1661,7 +1782,7 @@ interface TableProps {
  * ### Table API
  * @see https://docs.quillsql.com/components/table
  */
-declare const Table$1: ({ TableComponent, ...props }: TableProps) => react_jsx_runtime.JSX.Element | null;
+declare const Table: ({ TableComponent, ...props }: TableProps) => react_jsx_runtime.JSX.Element | null;
 
 /**
  * Props for the Quill SQLEditor component.
@@ -2554,6 +2675,577 @@ type StaticChartProps = (StaticChartBaseProps & {
 });
 declare function StaticChart(props: StaticChartProps): react_jsx_runtime.JSX.Element;
 
+interface ChatProps {
+    selectedDashboard?: string | null;
+    ChartViewComponent?: (props: {
+        reportId: string;
+    }) => JSX.Element;
+    /** Called when the agent returns a report id (e.g. from `[RB_TOOL_OUTPUT]`). */
+    onReportId?: (reportId: string) => void;
+    /**
+     * Current report builder state (e.g. return value `reportBuilderState` from `useReport`). Sent as `state` in agent-light
+     * metadata on each message. Omit or pass null when not in the report builder.
+     */
+    reportBuilderState?: ReportBuilderState | null;
+}
+type ChatModelId = 'gemini-2-flash' | 'gemini-2.5-flash' | 'gemini-3-flash-preview' | 'gpt-5.1' | 'opus-4.5' | 'kimi-k2.5';
+declare function Chat({ selectedDashboard, ChartViewComponent, onReportId, reportBuilderState, }: ChatProps): react_jsx_runtime.JSX.Element;
+
+type QueryBuilderCombinator = 'and' | 'or';
+type QueryBuilderRule = {
+    field: string;
+    operator: string;
+    value: unknown;
+};
+type QueryBuilderRuleGroupEntry = QueryBuilderRule | QueryBuilderRuleGroup | QueryBuilderCombinator;
+type QueryBuilderRuleGroup = {
+    combinator?: QueryBuilderCombinator;
+    rules: QueryBuilderRuleGroupEntry[];
+};
+type QueryBuilderFieldType = 'string' | 'number' | 'date' | 'boolean' | 'null';
+type QueryBuilderOperatorOption = {
+    name: string;
+    value: string;
+    label: string;
+    arity?: 'unary' | 'binary' | number;
+};
+
+type SelectOption = {
+    label: string;
+    value: string;
+};
+type UseFormTableRow = Record<string, unknown>;
+type UseFormTableColumn = {
+    label: string;
+    field: string;
+    format: string;
+};
+type UseFormTable = {
+    rows: UseFormTableRow[];
+    columns: UseFormTableColumn[];
+    getColumnFormat: (field: string) => string;
+    formatCellValue: (field: string, value: unknown) => string;
+    getFormattedCellValue: (row: UseFormTableRow, field: string) => string;
+};
+type ColumnSelectionOption = {
+    value: string;
+    label: string;
+    field: string;
+    tableName: string;
+    type: string;
+};
+type UseFormDisplayColumn = ReportBuilderColumn & {
+    format?: string;
+};
+type SetReportBuilderColumnInput = Partial<UseFormDisplayColumn> & {
+    field: string;
+    label?: string;
+};
+type TableColumnsControllerItem = {
+    id: string;
+    label: string;
+    defaultLabel: string;
+    customLabel: string;
+    /** Persisted axis format value (e.g. `whole_number`). */
+    format: string;
+    /** Format preset label (same strings as chart axis / `tableFormatOptions`). */
+    formatLabel: string;
+    field: string;
+    tableName: string;
+};
+type TableColumnListItem = {
+    id: string;
+    label: string;
+    visible: true;
+    /** Axis format preset label (matches `tableFormatOptions` / chart axis). */
+    format: string;
+    /**
+     * When set, overrides the shared `formatOptions` for this row (e.g. pivot date bucket).
+     */
+    formatOptions?: string[];
+};
+/** Selected columns + mutation methods. Pair with `columnOptions` from `useReport` (like `datasources` / `datasourceOptions`). */
+type TableColumnsController = {
+    items: TableColumnsControllerItem[];
+    /** Schema option per column id (`value` === id) — includes `field`, `tableName`, etc. */
+    optionById: ReadonlyMap<string, ColumnSelectionOption>;
+    byId: ReadonlyMap<string, TableColumnsControllerItem>;
+    /** Ready-made rows for table/column-picker UIs (`id`, `label`, `format` display string). */
+    columnList: TableColumnListItem[];
+    /** Build the `columns` array for `setReport({ columns })` from ordered ids. */
+    getSetReportColumns: (ids: string[]) => SetReportBuilderColumnInput[];
+    reorder: (oldIndex: number, newIndex: number) => void;
+    /** Reorder to match a full id list (e.g. after drag-and-drop column list UIs). */
+    reorderFromOrder: (nextIds: string[]) => void;
+    remove: (id: string) => void;
+    toggle: (id: string) => void;
+    update: (id: string, updates: Partial<{
+        fieldId: string;
+        label: string;
+        format: string;
+    }>) => void;
+    /**
+     * Build `setReport({ columns: { patch } })` for a table column sidebar edit;
+     * `setReport` expands it to a full `columns` list and/or `chartAxes`. Returns
+     * null only when `id` is empty.
+     */
+    getColumnSidebarSetReportInput: (id: string, updates: Partial<{
+        fieldId: string;
+        label: string;
+        format: string;
+    }>) => SetReportBuilderInput | null;
+    /**
+     * When true (pivot + chartType table), the list mirrors `chart.columns`; reorder,
+     * add, remove, and field swap are disabled — only label/format apply via chart axes.
+     */
+    structureEditsLocked: boolean;
+};
+type ChartAxisFieldOption = {
+    value: string;
+    label: string;
+    format: AxisFormat;
+};
+type ChartYAxisControllerItem = {
+    id: string;
+    field: string;
+    label: string;
+    format: AxisFormat;
+};
+type ChartAxesController = {
+    xAxis: {
+        field: string;
+        format: AxisFormat;
+        options: ChartAxisFieldOption[];
+        formatOptions: SelectOption[];
+        update: (updates: Partial<{
+            field: string;
+            format: AxisFormat;
+        }>) => void;
+    };
+    yAxis: {
+        items: ChartYAxisControllerItem[];
+        options: ChartAxisFieldOption[];
+        formatOptions: SelectOption[];
+        add: (field?: string) => void;
+        remove: (id: string) => void;
+        reorder: (oldIndex: number, newIndex: number) => void;
+        update: (id: string, updates: Partial<{
+            field: string;
+            label: string;
+            format: AxisFormat;
+        }>) => void;
+    };
+};
+type ColumnSelectorChangeValue = string[];
+/**
+ * Table column sidebar edit under {@link SetReportBuilderInput.columns}: expands
+ * inside `setReport` to a full `columns` array and/or `chartAxes` (pivot table chart).
+ */
+type SetReportTableColumnSidebarPatch = {
+    patch: {
+        id: string;
+        label?: string;
+        format?: string;
+        fieldId?: string;
+    };
+};
+type AggregationStateItem = Partial<{
+    valueField: string;
+    valueField2?: string;
+    aggregationType: AggregationType;
+    /** Resolved datasource table for `valueField` (mirrors `aggregationTablesByIndex`). */
+    valueFieldTable?: string;
+}>;
+type AggregationOption = {
+    key: string;
+    label: string;
+    value: string;
+    options: SelectOption[];
+};
+type AxisFormat = QuillReportInternal['yAxisFields'][number]['format'];
+type QueryBuilderFieldValueOption = {
+    name: string;
+    label: string;
+    value: string;
+};
+type UseFormQueryBuilderField = {
+    name: string;
+    label: string;
+    inputType: string;
+    quillFieldType: QueryBuilderFieldType;
+    values?: QueryBuilderFieldValueOption[];
+};
+type UseFormQueryBuilderProps = {
+    fields: UseFormQueryBuilderField[];
+    listsAsArrays: true;
+    getOperators: (field: string, misc?: {
+        fieldData?: Partial<UseFormQueryBuilderField>;
+    }) => QueryBuilderOperatorOption[];
+    getInputType: (field: string, operator: string, misc?: {
+        fieldData?: Partial<UseFormQueryBuilderField>;
+    }) => 'text' | 'number' | 'date' | 'checkbox';
+    getValueEditorType: (field: string, operator: string, misc?: {
+        fieldData?: Partial<UseFormQueryBuilderField>;
+    }) => 'multiselect' | undefined;
+    getValues: (field: string, operator: string, misc?: {
+        fieldData?: Partial<UseFormQueryBuilderField>;
+    }) => QueryBuilderFieldValueOption[];
+};
+/** Maps table column format dropdown values to persisted report column `format` (matches `setReport({ columns })` / `update`). */
+declare function tableColumnFormatFromUiSelection(raw: string): string;
+/** Shape expected by chart config sidebars that mirror `AxisConfig` (e.g. Quill Chat ConfigForm). */
+type UseFormAxisConfig = {
+    xAxis: {
+        field: string;
+        label: string;
+        format: string;
+        show: boolean;
+        rotation: number;
+        fontSize: number;
+    };
+    yAxis: {
+        fields: Array<{
+            field: string;
+            label: string;
+            format: string;
+            color: string;
+        }>;
+        label: string;
+        show: boolean;
+        min: string;
+        max: string;
+        fontSize: number;
+    };
+    legend: {
+        show: boolean;
+    };
+};
+type SetReportChartAxesInput = {
+    xAxis?: Partial<{
+        field: string;
+        /** Custom X-axis title; empty string clears the override and restores the report/field default. */
+        label: string;
+        format: AxisFormat | string;
+    }>;
+    yAxis?: {
+        fields: Array<{
+            field: string;
+            label?: string;
+            format?: AxisFormat | string;
+        }>;
+    };
+};
+interface SetReportBuilderInput {
+    /**
+     * Column picker ids, a full column list, or `{ patch: { id, … } }` for sidebar
+     * edits (expanded inside `setReport` into a full list and/or `chartAxes`).
+     */
+    columns?: ColumnSelectorChangeValue | SetReportBuilderColumnInput[] | SetReportTableColumnSidebarPatch;
+    filters?: Filter[];
+    groupRowsBy?: string;
+    groupColumnsBy?: string;
+    aggregations?: AggregationStateItem[] | string | {
+        index: number;
+        value: string;
+    };
+    sort?: ReportBuilderSort[] | string;
+    limit?: ReportBuilderLimit | null;
+    chartType?: string;
+    /** When set, updates chart legend visibility (same source as `showLegend` from `useReport`). */
+    showLegend?: boolean;
+    /** When set, merges into chart axis edits (use with returned `xAxis` / `yAxis` / options). */
+    chartAxes?: SetReportChartAxesInput;
+    /**
+     * Schema table names for datasource / multi-table picker UIs.
+     * Empty array clears the override (report base tables apply again).
+     */
+    datasources?: string[];
+}
+interface UseReportOptions {
+    useInMemoryEngines?: boolean;
+    reportOverride?: QuillReportInternal | null;
+    initialReportBuilderState?: ReportBuilderState | null;
+    /**
+     * When the report payload has no `dashboardName` and the client has no
+     * `defaultDashboard`, use this for engine tasks that require a dashboard
+     * (e.g. filter unique values).
+     */
+    destinationDashboardName?: string;
+    /**
+     * When true (default), filter pickers, pivot row/column group-by options,
+     * aggregation field dropdowns, and filter-builder field lists only include
+     * columns from the selected datasource
+     * tables (`setReport({ datasources })` / report base tables)—not other tables that
+     * happen to be FK-joinable but were not selected. When false, behaviour matches
+     * the prior schema-wide option lists when no table scope applies.
+     */
+    restrictFieldOptionsToSelectedDatasources?: boolean;
+}
+/**
+ * `saveChanges` from `useReport`. Always returns a Promise so UIs can `await`
+ * before navigation or feedback. Resolves to `undefined` when persist is skipped
+ * (e.g. missing client, dashboard name, or report state).
+ */
+type UseReportSaveChangesFn = () => Promise<unknown>;
+/**
+ * @param reportIdArg When omitted, the hook can bootstrap a report via `saveReport`
+ *   (`create-report`) on the first `setReport({ datasources })`, after schema is available.
+ *   Use `destinationDashboardName` so the server can resolve a dashboard for create-report.
+ */
+declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
+    chart: {
+        xAxisField: string;
+        xAxisFormat: AxisFormat$1;
+        xAxisLabel: string;
+        yAxisFields: {
+            field: string;
+            label: string;
+            format: AxisFormat$1;
+        }[];
+        columns: Column$1[];
+        pivotQuery?: string;
+        comparisonPivotQuery?: string;
+        itemQuery?: string[];
+        referencedTables?: string[];
+        referencedColumns?: {
+            [table: string]: string[];
+        };
+        error?: string;
+        adminError?: string;
+        triggerReload?: boolean;
+        columnInternal: ColumnInternal[];
+        loadingRows?: boolean;
+        flags?: {
+            [tenantField: string]: string[] | "QUILL_ALL_TENANTS";
+        };
+        reportBuilderState?: ReportBuilderState;
+        uniqueStringsByTable?: UniqueValuesByTable;
+        uniqueStringsByColumn?: UniqueValuesByColumn;
+        columnUniqueValues?: UniqueValuesByColumn;
+        uniqueValues?: UniqueValuesByColumn;
+        id: string;
+        name: string;
+        dashboardName: string;
+        rows: {
+            [key: string]: string;
+        }[];
+        chartType: string;
+        showLegend?: boolean;
+        dateField?: {
+            table: string;
+            field: string;
+        };
+        pivot: Pivot | null;
+        template?: boolean;
+        order: number;
+        compareRows: {
+            [key: string]: string;
+        }[];
+        filtersApplied?: InternalFilter[];
+        pagination?: Pagination;
+        sort?: {
+            field: string;
+            direction: string;
+        };
+        rowCount: number;
+        queryString: string;
+        filterMap?: {
+            [key: string]: {
+                table: string;
+                field: string;
+            };
+        };
+        referenceLines?: {
+            label: string;
+            query: [number, number] | string;
+        }[];
+        referenceLineYValues?: {
+            label: string;
+            query: [number, number];
+        }[];
+        includeCustomFields?: boolean;
+        columnsWithCustomFields?: Column$1[];
+        pivotRows?: {
+            [key: string]: string;
+        }[];
+        pivotColumns?: ColumnInternal[];
+        pivotRowCount?: number;
+    } | undefined;
+    chartLoading: boolean;
+    table: UseFormTable;
+    tableLoading: boolean;
+    loading: boolean;
+    /** Report title: matching `sourceReport.name`, else `report-name` task, else empty. */
+    name: string;
+    /**
+     * Resolved report id: the `reportId` argument when provided, otherwise the id
+     * returned from `create-report` after the first datasource selection.
+     */
+    reportId: string | undefined;
+    datasources: {
+        id: string;
+        label: string;
+    }[];
+    datasourceOptions: {
+        id: string;
+        label: string;
+    }[];
+    groupRowsBy: string | undefined;
+    groupRowsByOptions: SelectOption[];
+    groupColumnsBy: string | undefined;
+    groupColumnsByOptions: SelectOption[];
+    aggregations: Partial<{
+        valueField: string;
+        valueField2?: string;
+        aggregationType: AggregationType;
+        /** Resolved datasource table for `valueField` (mirrors `aggregationTablesByIndex`). */
+        valueFieldTable?: string;
+    }>[];
+    aggregationOptions: AggregationOption[];
+    aggregationDescriptionOptions: {
+        label: string;
+        value: string;
+    }[];
+    sort: string;
+    sortOptions: {
+        label: string;
+        value: string;
+    }[];
+    chartType: string | undefined;
+    chartTypeOptions: {
+        label: string;
+        value: string;
+    }[];
+    /** Encoded field keys for the current column selection (for `setReport({ columns })`, etc.). */
+    columnIds: ColumnSelectorChangeValue;
+    /** Selected columns + `reorder` / `toggle` / `update` / `remove`. */
+    columns: TableColumnsController;
+    /** Schema columns for current datasources — pool for the table column picker. */
+    columnOptions: ColumnSelectionOption[];
+    xAxis: {
+        field: string;
+        format: AxisFormat;
+        options: ChartAxisFieldOption[];
+        formatOptions: SelectOption[];
+        update: (updates: Partial<{
+            field: string;
+            format: AxisFormat;
+        }>) => void;
+    };
+    xAxisOptions: {
+        value: string;
+        label: string;
+        format: string;
+    }[];
+    yAxis: {
+        items: ChartYAxisControllerItem[];
+        options: ChartAxisFieldOption[];
+        formatOptions: SelectOption[];
+        add: (field?: string) => void;
+        remove: (id: string) => void;
+        reorder: (oldIndex: number, newIndex: number) => void;
+        update: (id: string, updates: Partial<{
+            field: string;
+            label: string;
+            format: AxisFormat;
+        }>) => void;
+    };
+    yAxisOptions: {
+        value: string;
+        label: string;
+        format: string;
+    }[];
+    /** Same strings as `axisSelectFormatLabels` (X/Y share chart format presets). */
+    xAxisFormatOptions: string[];
+    yAxisFormatOptions: string[];
+    /** Table column format dropdown labels (same set as chart axis formats). */
+    tableFormatOptions: string[];
+    showLegend: boolean;
+    axisConfig: UseFormAxisConfig;
+    availableFields: {
+        id: string;
+        label: string;
+        type: string;
+    }[];
+    axisSelectFormatLabels: string[];
+    /** @deprecated Prefer top-level `xAxis`, `yAxis`, and `showLegend`. */
+    chartAxes: ChartAxesController;
+    /** @deprecated Prefer top-level `xAxisOptions` / `yAxisOptions`. */
+    chartAxisOptions: {
+        xAxis: {
+            value: string;
+            label: string;
+            format: string;
+        }[];
+        yAxis: {
+            value: string;
+            label: string;
+            format: string;
+        }[];
+    };
+    hasTableDrivenColumnOrder: boolean;
+    filters: QueryBuilderRuleGroup;
+    filterQueryBuilderProps: UseFormQueryBuilderProps;
+    /** True while `report-builder-unique-values` runs for filter value options (not chart/table load). */
+    filterUniqueValuesLoading: boolean;
+    limit: ReportBuilderLimit | null;
+    chartTypes: {
+        label: string;
+        value: string;
+    }[];
+    columnsOptions: ColumnSelectionOption[];
+    tableColumnOptions: ColumnSelectionOption[];
+    tableColumns: TableColumnsController;
+    setReport: (nextState: SetReportBuilderInput) => void;
+    saveChanges: UseReportSaveChangesFn;
+    setFilters: (nextFilters: QueryBuilderRuleGroup) => void;
+    setReportBuilder: (nextState: SetReportBuilderInput) => void;
+    /** Current report-builder slice (tables, columns, filters, pivot, sort); pass to e.g. `Chat` as `reportBuilderState`. */
+    reportBuilderState: ReportBuilderState | undefined;
+};
+
+/** Normalize react-querybuilder filter trees before stack conversion / persistence. */
+type QueryBuilderDisplayRule = {
+    id?: unknown;
+    field?: unknown;
+    operator?: unknown;
+    value?: unknown;
+};
+type QueryBuilderDisplayGroup = {
+    combinator?: unknown;
+    rules: unknown[];
+};
+declare const isQueryBuilderDisplayGroup: (value: unknown) => value is QueryBuilderDisplayGroup;
+declare const isQueryBuilderDisplayRule: (value: unknown) => value is QueryBuilderDisplayRule;
+declare const stripQueryBuilderTransientFields: (value: unknown, seen?: WeakMap<object, unknown>) => unknown;
+/** Merge relative-date rule values against a prior tree (typically last committed filters). */
+declare const normalizeRelativeDateRules: (nextQuery: unknown, previousQuery: unknown) => unknown;
+/** Strip + relative-date normalization used by `useReport` `setFilters` and draft-vs-committed UI. */
+declare function prepareQueryBuilderFiltersForSet(next: unknown, previousCommitted: unknown): unknown;
+/**
+ * Whether a react-querybuilder draft differs from committed filters in a way that matters
+ * for Apply (ignores transient `id` / `path`, etc.).
+ */
+declare function areQueryBuilderFilterDraftsDirty(draft: unknown, committed: unknown): boolean;
+/** Number of leaf filter rules (excludes empty groups). */
+declare function countFilterRules(value: unknown): number;
+
+type ReportDetailProps = {
+    /** Display name from the loaded report (e.g. `useReport` `name`). Rendered above the chart when non-empty. */
+    reportTitle?: string;
+    chart?: any;
+    chartLoading: boolean;
+    table?: {
+        columns?: unknown[];
+        rows?: unknown[];
+    };
+    tableLoading: boolean;
+    showLegend?: boolean;
+    /** Strip QuillTable's outer frame when chart type is `table` (cell borders unchanged). */
+    hideTableChartOuterBorder?: boolean;
+};
+declare function ReportDetail({ reportTitle, chart, chartLoading, table, tableLoading, showLegend, hideTableChartOuterBorder, }: ReportDetailProps): react_jsx_runtime.JSX.Element;
+
 declare const quillFormat: ({ value, format, }: {
     value: any;
     format: string;
@@ -2631,10 +3323,9 @@ declare const useDashboards: () => {
 };
 declare const useDashboard: (dashboardName: string, config?: {
     pageSize?: number;
-    frontendCacheConfig?: {
-        cacheType: "memory" | "indexedDB";
-    };
-    disableBackendCache?: boolean;
+    cacheEnabled?: boolean;
+    cacheType?: "memory" | "idb";
+    showCacheLogs?: boolean;
 }) => {
     isLoading: boolean;
     sections: Record<string, QuillReport[]> | null;
@@ -2666,28 +3357,6 @@ declare const useDashboardReport: (reportId: string, config?: {
     fetchNextPage: () => Promise<void>;
 };
 
-/**
- * Represents a table object returned from /schema2/:id
- */
-type Table = {
-    _id: string;
-    isSelectStar: boolean;
-    displayName: string;
-    name: string;
-    columns: ColumnInternal[];
-    viewQuery: string;
-    customFieldInfo: any;
-    broken?: boolean;
-    error?: string;
-    ownerTenantFields?: string[];
-};
-interface UniqueValuesByTable {
-    [table: string]: UniqueValuesByColumn;
-}
-interface UniqueValuesByColumn {
-    [column: string]: string[];
-}
-
 type ForeignKeyMap = {
     [table: string]: {
         foreignTable: string;
@@ -2777,7 +3446,7 @@ type ReportBuilder = {
         sortField: string;
         sortDirection: 'ASC' | 'DESC';
     } | undefined, fieldKey: 'rowField' | 'columnField' | 'aggregations' | 'rowLimit' | 'sort') => Promise<void>;
-    filteredSchema: Table[];
+    filteredSchema: Table$1[];
     foreignKeyMap: ForeignKeyMap;
     schemaData: any;
     client: any;
@@ -2966,20 +3635,20 @@ type CustomField = {
 };
 
 declare const useVirtualTables: () => {
-    data: Table[];
+    data: Table$1[];
     isLoading: boolean;
     loadingTables: {
         [key: string]: boolean;
     };
     reloadAll: (client: any, caller?: string) => Promise<{
-        schema: Table[];
+        schema: Table$1[];
         customFields: {
             [tableName: string]: CustomField[];
         } | null;
         isSchemaLoading: boolean;
     }>;
-    refreshSome: (client: any, tables: Table[]) => Promise<{
-        schema: Table[];
+    refreshSome: (client: any, tables: Table$1[]) => Promise<{
+        schema: Table$1[];
         customFields: {
             [tableName: string]: CustomField[];
         } | null;
@@ -3045,42 +3714,6 @@ interface LimitPopoverComponentProps {
     disabled?: boolean;
 }
 
-interface TableComponentProps {
-    rows: object[];
-    rowCount?: number;
-    rowCountIsLoading?: boolean;
-    columns: {
-        label: string;
-        field: string;
-    }[];
-    currentPage: number;
-    sort?: {
-        field: string;
-        direction: string;
-    };
-    className?: string;
-    containerStyle?: React$1.CSSProperties;
-    isLoading?: boolean;
-    hideCSVDownloadButton?: boolean;
-    downloadCSV?: () => void;
-    LoadingComponent?: () => React$1.JSX.Element;
-    DownloadCSVButtonComponent?: (props: ButtonComponentProps) => React$1.JSX.Element;
-    rowsPerPage?: number;
-    emptyStateLabel?: string;
-    onPageChange?: (page: number) => void;
-    onSortChange?: (sort: {
-        field: string;
-        direction: string;
-    }) => void;
-    headerBackgroundColor?: string;
-    footerBackgroundColor?: string;
-    borderRadius?: string | number;
-    borderLeft?: string;
-    borderRight?: string;
-    borderTop?: string;
-    borderBottom?: string;
-}
-
 interface DateRangePickerComponentProps {
     preset: string;
     label?: string;
@@ -3553,4 +4186,4 @@ interface ReportTableProps {
 }
 declare const ReportTable: ({ reportBuilder, TableComponent, }: ReportTableProps) => react_jsx_runtime.JSX.Element;
 
-export { ALL_TENANTS, AddColumns, AddFilters, AddLimit, AddPivot, AddSort, type AxisFormat, type ButtonComponentProps, Calculation, Chart, ChartEditor, type ChartEditorProps, type ChartProps, type CheckboxComponentProps, type ColorMapType, type Column$1 as Column, type ContainerComponentProps, Dashboard, type DashboardDateFilter, type DashboardFilter, DashboardFilterType, DashboardLegacy, type DashboardLegacyProps, type DashboardMultiFilter, type DashboardProps, type DashboardSectionComponentProps, type DashboardSingleFilter, type DashboardTenantFilter, DateOperator, type DateRange, type DateRangePickerComponentProps, type DateRangePickerOption, type DeleteButtonComponentProps, type DraggableColumnComponentProps, type EventBreadcrumb, type EventContext, type EventError, type EventMetadata, type EventTracking, type EventUser, type Filter, type FilterPopoverComponentProps, FilterType, type HeaderComponentProps, type HeaderProps, type InternalDashboardDateFilter, type InternalDashboardTenantFilter, type InternalFilter, type LabelComponentProps, type LimitPopoverComponentProps, type ModalComponentProps, NullOperator, NumberOperator, type Option, type Pivot, type PopoverComponentProps, type QuillCustomInterval, type QuillCustomRelativeInterval, type QuillCustomRepeatingInterval, type QuillCustomStaticInterval, type QuillPreviousMonthInterval, type QuillPreviousQuarterInterval, QuillProvider, type QuillProviderProps, type QuillReport, type QuillReportProps, type QuillTheme, type QuillWeekInterval, ReportBuilder$1 as ReportBuilder, type ReportBuilderColumn, type ReportBuilderLimit, type ReportBuilderProps, type ReportBuilderSort, type ReportBuilderState, ReportTable, SINGLE_TENANT, SQLEditor, type SQLEditorProps, SaveReport, SchemaListComponent, type SelectColumnComponentProps, type SelectComponentProps, type SidebarComponentProps, type SidebarHeadingComponentProps, type SortPopoverComponentProps, StaticChart, type StaticChartProps, StringOperator, Table$1 as Table, type TableComponentProps, type TableProps, type TabsComponentProps, type TextComponentProps, type TextInputComponentProps, ThemeContext, downloadCSV, quillFormat as format, useAllReports, useAskQuill, useDashboard, useDashboardInternal, useDashboardReport, useDashboardReports, useDashboards, useExport, useMemoizedRows, useQuill, useReportBuilder, useReports, useTenants, useVirtualTables };
+export { ALL_TENANTS, AddColumns, AddFilters, AddLimit, AddPivot, AddSort, type AxisFormat$1 as AxisFormat, type ButtonComponentProps, Calculation, Chart, ChartDisplay, ChartEditor, type ChartEditorProps, type ChartProps, Chat, type ChatModelId, type ChatProps, type CheckboxComponentProps, type ColorMapType, type Column$1 as Column, type ColumnSelectionOption, type ContainerComponentProps, Dashboard, type DashboardDateFilter, type DashboardFilter, DashboardFilterType, DashboardLegacy, type DashboardLegacyProps, type DashboardMultiFilter, type DashboardProps, type DashboardSectionComponentProps, type DashboardSingleFilter, type DashboardTenantFilter, DateOperator, type DateRange, type DateRangePickerComponentProps, type DateRangePickerOption, type DeleteButtonComponentProps, type DraggableColumnComponentProps, type EventBreadcrumb, type EventContext, type EventError, type EventMetadata, type EventTracking, type EventUser, type Filter, type FilterPopoverComponentProps, FilterType, type HeaderComponentProps, type HeaderProps, type InternalDashboardDateFilter, type InternalDashboardTenantFilter, type InternalFilter, type LabelComponentProps, type LimitPopoverComponentProps, type ModalComponentProps, NullOperator, NumberOperator, type Option, type Pivot, type PivotAggregation, type PopoverComponentProps, type QueryBuilderDisplayGroup, type QueryBuilderDisplayRule, type QuillCustomInterval, type QuillCustomRelativeInterval, type QuillCustomRepeatingInterval, type QuillCustomStaticInterval, type QuillPreviousMonthInterval, type QuillPreviousQuarterInterval, QuillProvider, type QuillProviderProps, type QuillReport, type QuillReportProps, type QuillTheme, type QuillWeekInterval, ReportBuilder$1 as ReportBuilder, type ReportBuilderColumn, type ReportBuilderLimit, type ReportBuilderProps, type ReportBuilderSort, type ReportBuilderState, ReportDetail, type ReportDetailProps, ReportTable, SINGLE_TENANT, SQLEditor, type SQLEditorProps, SaveReport, SchemaListComponent, type SelectColumnComponentProps, type SelectComponentProps, type SetReportBuilderInput, type SetReportChartAxesInput, type SetReportTableColumnSidebarPatch, type SidebarComponentProps, type SidebarHeadingComponentProps, type SortPopoverComponentProps, StaticChart, type StaticChartProps, StringOperator, Table, type TableColumnListItem, type TableColumnsController, type TableColumnsControllerItem, type TableComponentProps, type TableProps, type TabsComponentProps, type TextComponentProps, type TextInputComponentProps, ThemeContext, type UseFormAxisConfig, areQueryBuilderFilterDraftsDirty, countFilterRules, downloadCSV, quillFormat as format, isQueryBuilderDisplayGroup, isQueryBuilderDisplayRule, normalizeRelativeDateRules, prepareQueryBuilderFiltersForSet, stripQueryBuilderTransientFields, tableColumnFormatFromUiSelection, useAllReports, useAskQuill, useDashboard, useDashboardInternal, useDashboardReport, useDashboardReports, useDashboards, useExport, useMemoizedRows, useQuill, useReport, useReportBuilder, useReports, useTenants, useVirtualTables };