@quillsql/react 2.16.38 → 2.16.40

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;
@@ -554,7 +560,16 @@ interface BasePivot {
     triggerButtonText?: string;
     rowLimit?: number;
     columnValues?: string[];
+    dateBucket?: 'day' | 'week' | 'month' | 'year';
 }
+type PivotAggregation = {
+    aggregationType: AggregationType;
+    valueField?: string;
+    valueFieldType?: string;
+    valueField2?: string;
+    valueField2Type?: string;
+    valueFieldTable?: string;
+};
 interface SingleAggregationPivot extends BasePivot {
     aggregationType: AggregationType;
     valueField?: string;
@@ -569,13 +584,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 +638,29 @@ type ReportBuilderState = {
     limit: ReportBuilderLimit | null;
 };
 
+/**
+ * Represents a table object returned from /schema2/:id
+ */
+type Table$1 = {
+    _id: string;
+    isSelectStar: boolean;
+    displayName: string;
+    name: string;
+    description?: 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 +701,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 +713,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
@@ -775,6 +807,14 @@ interface QuillReportInternal extends QuillReport {
      * 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;
 }
 
 /**
@@ -1315,6 +1355,43 @@ type QuillProviderProps = QuillCloudProviderProps | SelfHostedProviderProps;
  */
 declare const QuillProvider: ({ tenants, flags, publicKey, queryEndpoint, streamEndpoint, queryHeaders, children, theme, withCredentials, isAdmin, getAuthorizationToken, eventTracking, onChangelogs, }: 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;
@@ -1512,7 +1589,7 @@ interface ChartProps {
 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 }: {
+    ErrorComponent?: ({ errorMessage, }: {
         errorMessage: string;
     }) => React.JSX.Element;
     colorMap?: ColorMapType;
@@ -1532,8 +1609,10 @@ interface ChartDisplayProps extends WithConfig {
     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, }: ChartDisplayProps) => react_jsx_runtime.JSX.Element;
+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.
@@ -1601,6 +1680,7 @@ interface TableProps {
     columns?: {
         label: string;
         field: string;
+        format?: string;
     }[];
     /**
      * The placeholder filename to use when downloading this table as a csv file.
@@ -1676,6 +1756,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[];
 }
@@ -1710,7 +1796,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.
@@ -2611,26 +2697,303 @@ interface ChatProps {
     agentEndpoint?: string;
     suggestions?: string[];
 }
+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, agentEndpoint, suggestions, }: 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;
+};
+
+/**
+ * Default `value` for a new react-querybuilder rule given a Quill operator.
+ * List operators (`in` / `notIn`) need `[]` so the multiselect editor works
+ * with `listsAsArrays`; everything else starts as an empty string.
+ */
+declare const defaultFilterRuleValueForOperator: (operator: unknown) => unknown;
+/**
+ * One-rule react-querybuilder tree seeded from the first field in the catalog,
+ * using that field's first operator and a matching default value. Used for the
+ * "Add filter" empty state, where react-querybuilder's own "+ Rule" button is
+ * not rendered yet.
+ */
+declare const buildSeededFilterQuery: (queryBuilderProps: Pick<UseFormQueryBuilderProps, "fields" | "getOperators"> | null | undefined) => QueryBuilderRuleGroup;
+type FilterDraftQueryBuilderProps = UseFormQueryBuilderProps & {
+    /** Committed-or-draft tree react-querybuilder hydrates from on mount (uncontrolled mode). */
+    defaultQuery: QueryBuilderRuleGroup;
+    onQueryChange: (next: unknown) => void;
+    addRuleToNewGroups: true;
+    getDefaultValue: (rule: {
+        operator?: unknown;
+    }) => unknown;
+};
+type UseReportFilterDraft = {
+    /**
+     * Pass as `key` on `QueryBuilder` (not inside the spread — React warns on
+     * spread `key`). Changes whenever react-querybuilder must rehydrate from
+     * `defaultQuery`: report switch, committed filters change, field catalog
+     * change, or `resetFilterDraft`.
+     */
+    filterDraftKey: string;
+    /** Spread onto `react-querybuilder`'s `QueryBuilder`: `<QueryBuilder key={filterDraftKey} {...filterDraftQueryBuilderProps} />`. */
+    filterDraftQueryBuilderProps: FilterDraftQueryBuilderProps;
+    /** Draft differs from committed filters (commit would change the report). */
+    isFilterDraftDirty: boolean;
+    /** Draft tree has no rules at all; show an "Add filter" affordance instead of the builder. */
+    isFilterDraftEmpty: boolean;
+    /** Commit the draft via `setFilters` (report/chart refresh follows). */
+    commitFilterDraft: () => void;
+    /** Drop the draft and rehydrate the builder from committed filters. */
+    resetFilterDraft: () => void;
+    /** Seed a first rule (field + operator + default value) and leave the empty state. */
+    seedFilterDraft: () => void;
+};
+
 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;
+    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 {
-    columns?: ColumnSelectorChangeValue | ReportBuilderColumn[];
+    /**
+     * 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;
@@ -2638,25 +3001,171 @@ interface SetReportBuilderInput {
         index: number;
         value: string;
     };
-    sort?: ReportBuilderSort[];
+    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 UseFormOptions {
+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;
 }
-declare function useForm(reportId: string, options?: UseFormOptions): {
-    columns: ColumnSelectorChangeValue;
-    columnsOptions: {
+/**
+ * `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): {
+    /** 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;
+    filterDraftKey: string;
+    filterDraftQueryBuilderProps: FilterDraftQueryBuilderProps;
+    isFilterDraftDirty: boolean;
+    isFilterDraftEmpty: boolean;
+    commitFilterDraft: () => void;
+    resetFilterDraft: () => void;
+    seedFilterDraft: () => void;
+    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;
-        columns: {
-            id: string;
-            name: string;
-            type: 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;
     }[];
-    filters: Filter[];
     groupRowsBy: string | undefined;
     groupRowsByOptions: SelectOption[];
     groupColumnsBy: string | undefined;
@@ -2665,53 +3174,162 @@ declare function useForm(reportId: string, options?: UseFormOptions): {
         valueField: string;
         valueField2?: string;
         aggregationType: AggregationType;
+        /** Resolved datasource table for `valueField` (mirrors `aggregationTablesByIndex`). */
+        valueFieldTable?: string;
     }>[];
+    aggregationOptions: AggregationOption[];
     aggregationDescriptionOptions: {
         label: string;
         value: string;
     }[];
-    aggregationOptions: AggregationOption[];
-    sort: {
+    sort: string;
+    sortOptions: {
         label: string;
         value: string;
     }[];
-    sortOptions: SelectOption[];
-    chartTypes: {
+    chartType: string | undefined;
+    chartTypeOptions: {
         label: string;
         value: string;
     }[];
-    chartTypeOptions: {
+    /** 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;
     }[];
-    chartType: string | undefined;
-    chart: QuillReportInternal | undefined;
-    limit: ReportBuilderLimit | null;
-    setReport: (nextState: SetReportBuilderInput) => void;
+    /** 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;
 };
 
+/** 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;
 }) => string;
 
+/** Refetch dashboard config and filters; optional report upsert/delete and filter overrides. */
+type UseDashboardReload = (overrideDashboardName?: string, fetchFromServer?: boolean, reportAction?: {
+    report: QuillReport | {
+        id: string;
+    };
+    action: 'upsert' | 'delete';
+}, overrideFilters?: {
+    filters: InternalDashboardFilter[];
+    editedFilterLabel?: string;
+    refetchReports?: boolean;
+}, options?: {
+    preserveExistingDateFilter?: boolean;
+}) => Promise<void>;
 declare const useDashboardInternal: (dashboardName: string | null, customFilters?: InternalFilter[]) => {
     data: DashboardConfig | null;
     dashboardFilters: InternalDashboardFilter[] | null;
     isLoading: boolean | undefined;
     isDashboardFilterLoading: (filterName: string) => boolean | undefined;
-    reload: (overrideDashboardName?: string, fetchFromServer?: boolean, reportAction?: {
-        report: QuillReport | {
-            id: string;
-        };
-        action: "upsert" | "delete";
-    }, overrideFilters?: {
-        filters: InternalDashboardFilter[];
-        editedFilterLabel?: string;
-        refetchReports?: boolean;
-    }, options?: {
-        preserveExistingDateFilter?: boolean;
-    }) => Promise<void>;
+    reload: UseDashboardReload;
     setSectionOrder: (sectionOrder: {
         section: string;
         _id?: string;
@@ -2767,6 +3385,12 @@ declare const useDashboards: () => {
     }) => Promise<void>;
     deleteDashboard: (name: string) => Promise<void>;
 };
+/**
+ * `reload` is the same reference as `useDashboardInternal(dashboardName).reload`.
+ * Use after structural changes or report upsert/delete; use `applyFilters` for
+ * filter-value updates; use `forceCacheRefresh` to bypass cached report payloads
+ * when cache is on. Calling `reload` every render adds network load.
+ */
 declare const useDashboard: (dashboardName: string, config?: {
     pageSize?: number;
     cacheEnabled?: boolean;
@@ -2791,6 +3415,7 @@ declare const useDashboard: (dashboardName: string, config?: {
     } | Filter>) => void;
     lastUpdated: number;
     forceCacheRefresh: () => void;
+    reload: UseDashboardReload;
 };
 declare const useDashboardReport: (reportId: string, config?: {
     initialFilters?: Filter[];
@@ -2803,29 +3428,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;
-    description?: 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;
@@ -2878,6 +3480,7 @@ type ReportBuilder = {
         sortField: string;
         sortDirection: 'ASC' | 'DESC';
     } | undefined;
+    pivotDateBucket: 'day' | 'week' | 'month' | 'year' | undefined;
     pivotHint: string;
     pivotError: string;
     createdPivots: Pivot[];
@@ -2905,6 +3508,7 @@ type ReportBuilder = {
         sortField: string;
         sortDirection: 'ASC' | 'DESC';
     } | undefined>>;
+    setPivotDateBucket: React.Dispatch<React.SetStateAction<'day' | 'week' | 'month' | 'year' | undefined>>;
     setPivotError: React.Dispatch<React.SetStateAction<string>>;
     handlePivotChange: (newPivot: Pivot | null, fetchData?: boolean, updateStateStack?: boolean) => void;
     updatePivot: (changeField: string | Partial<{
@@ -2915,7 +3519,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;
@@ -3104,27 +3708,27 @@ 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;
     }>;
     reloadSome: (client: any, tableIds: string[], 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;
@@ -3258,42 +3862,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;
@@ -3766,4 +4334,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, type ChangelogEntry, Chart, ChartDisplay, ChartEditor, type ChartEditorProps, type ChartProps, Chat, type ChatProps, 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 QuillFetchOptions, type QuillPreviousMonthInterval, type QuillPreviousQuarterInterval, QuillProvider, type QuillProviderProps, type QuillReport, type QuillReportProps, type QuillResults, 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, quillFetch, useAllReports, useAskQuill, useChangelogRefresh, useDashboard, useDashboardInternal, useDashboardReport, useDashboardReports, useDashboards, useExport, useForm, useMemoizedRows, useQuill, useReportBuilder, useReports, useTenants, useVirtualTables };
+export { ALL_TENANTS, AddColumns, AddFilters, AddLimit, AddPivot, AddSort, type AxisFormat$1 as AxisFormat, type ButtonComponentProps, Calculation, type ChangelogEntry, 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 FilterDraftQueryBuilderProps, 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 QuillFetchOptions, type QuillPreviousMonthInterval, type QuillPreviousQuarterInterval, QuillProvider, type QuillProviderProps, type QuillReport, type QuillReportProps, type QuillResults, 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 UseDashboardReload, type UseFormAxisConfig, type UseFormQueryBuilderField, type UseFormQueryBuilderProps, type UseReportFilterDraft, areQueryBuilderFilterDraftsDirty, buildSeededFilterQuery, countFilterRules, defaultFilterRuleValueForOperator, downloadCSV, quillFormat as format, isQueryBuilderDisplayGroup, isQueryBuilderDisplayRule, normalizeRelativeDateRules, prepareQueryBuilderFiltersForSet, quillFetch, stripQueryBuilderTransientFields, tableColumnFormatFromUiSelection, useAllReports, useAskQuill, useChangelogRefresh, useDashboard, useDashboardInternal, useDashboardReport, useDashboardReports, useDashboards, useExport, useMemoizedRows, useQuill, useReport, useReportBuilder, useReports, useTenants, useVirtualTables };