@quillsql/react 2.16.48 → 2.16.50

package/dist/index.d.ts

@@ -357,6 +357,9 @@ interface InternalDateCustomFilter extends BaseFilter {
         startDate: string;
         endDate: string;
     };
+    /** Present when created via UI `inBucket`; used to reproject public `filters`. */
+    dateBucket?: 'day' | 'week' | 'month' | 'year';
+    fromInBucket?: boolean;
 }
 interface InternalDateComparisonFilter extends BaseFilter {
     filterType: InternalFilterType.DateComparisonFilter;
@@ -561,7 +564,31 @@ interface BasePivot {
     rowLimit?: number;
     columnValues?: string[];
     dateBucket?: 'day' | 'week' | 'month' | 'year';
+    /**
+     * Display-only drilldown pick list for the row dimension.
+     * Attached on `useReport().chart.pivot` only — not sent to the engine.
+     */
+    rowFilter?: PivotDimensionFilter | null;
+    /**
+     * Display-only drilldown pick list for the column dimension.
+     * Attached on `useReport().chart.pivot` only — not sent to the engine.
+     */
+    columnFilter?: PivotDimensionFilter | null;
 }
+/** Pick list + suggested operator for a pivot row/column drilldown control. */
+type PivotDimensionFilter = {
+    field: string;
+    label: string;
+    fieldType: 'string' | 'date';
+    operator: 'in' | 'inBucket';
+    options: {
+        label: string;
+        value: string;
+    }[];
+    dateBucket?: 'day' | 'week' | 'month' | 'year';
+    /** Current selection from committed filters; null means “All”. */
+    value: string | null;
+};
 type PivotAggregation = {
     aggregationType: AggregationType;
     valueField?: string;
@@ -1606,6 +1633,7 @@ interface ChartDisplayProps extends WithConfig {
         direction: string;
     }) => void;
     onClickChartElement?: (data: any) => void;
+    onClickLegendElement?: (data: any) => void;
     scrollable?: boolean;
     overrideTheme?: QuillTheme;
     referenceLines?: {
@@ -1618,7 +1646,7 @@ interface ChartDisplayProps extends WithConfig {
     /** 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;
+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, onClickLegendElement, overrideTheme, referenceLines, showLegend, tableRowsLoading, tableChartWrapperBorders, }: ChartDisplayProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Props for the Quill Table component.
@@ -2692,6 +2720,7 @@ declare function ChartEditor({ isOpen, reportId, isAdmin, chartBuilderTitle, cha
 interface StaticChartBaseProps {
     reportId: string;
     onClickChartElement?: (data: any) => void;
+    onClickLegendElement?: (data: any) => void;
     showLegend?: boolean;
 }
 type StaticChartProps = (StaticChartBaseProps & {
@@ -2735,50 +2764,11 @@ type QueryBuilderOperatorOption = {
     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.
+ * Expand UI `inBucket` leaf rules to `between` for react-querybuilder editors.
+ * Custom UIs keep `inBucket` on `useReport().filters`; the draft boundary uses this.
  */
-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;
-};
+declare const queryBuilderFiltersForEditor: (group: QueryBuilderRuleGroup) => QueryBuilderRuleGroup;
 
 /**
  * Pagination types and pure helpers for `useReport`, mirroring the
@@ -2801,6 +2791,7 @@ type SelectOption = {
     label: string;
     value: string;
 };
+type PivotDateBucket = NonNullable<Pivot['dateBucket']>;
 type UseFormTableRow = Record<string, unknown>;
 type UseFormTableColumn = {
     label: string;
@@ -2858,26 +2849,13 @@ type ColumnSelectionOption = {
 type UseFormDisplayColumn = ReportBuilderColumn & {
     format?: string;
 };
-type SetReportBuilderColumnInput = Partial<UseFormDisplayColumn> & {
+type ReportColumnInput = 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;
+type ReportColumnValue = {
+    value: string;
     label: string;
-    visible: true;
     /** Axis format preset label (matches `tableFormatOptions` / chart axis). */
     format: string;
     /**
@@ -2885,16 +2863,10 @@ type TableColumnListItem = {
      */
     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[];
+/** Optional rich column operations. The primary form value is `columns`. */
+type ColumnActions = {
+    /** Replace the selected columns with fully configured column values. */
+    replace: (columns: ReportColumnInput[]) => void;
     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;
@@ -2905,21 +2877,21 @@ type TableColumnsController = {
         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 ReportXAxisValue = {
+    field: string;
+    label: string;
+    /** Format preset label matching `xAxisFormatOptions`. */
+    format: string;
+};
+type ReportYAxisFieldValue = {
+    field: string;
+    label: string;
+    /** Format preset label matching `yAxisFormatOptions`. */
+    format: string;
+};
+type ReportYAxisValue = {
+    fields: ReportYAxisFieldValue[];
 };
 type ChartAxisFieldOption = {
     value: string;
@@ -2957,19 +2929,6 @@ type ChartAxesController = {
         }>) => 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;
     valueFieldType: string;
@@ -2979,12 +2938,6 @@ type AggregationStateItem = Partial<{
     /** 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;
@@ -3009,40 +2962,26 @@ type UseFormQueryBuilderProps = {
     }) => 'text' | 'number' | 'date' | 'checkbox';
     getValueEditorType: (field: string, operator: string, misc?: {
         fieldData?: Partial<UseFormQueryBuilderField>;
-    }) => 'multiselect' | undefined;
+    }) => 'multiselect' | 'select' | 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;
-        }>;
+/** Framework-agnostic filter value pick lists from `useReport` (string uniques + pivot date buckets). */
+type FilterFieldOptions = {
+    field: string;
+    fieldType: 'string' | 'date';
+    operator: 'in' | 'inBucket';
+    options: {
         label: string;
-        show: boolean;
-        min: string;
-        max: string;
-        fontSize: number;
-    };
-    legend: {
-        show: boolean;
-    };
+        value: string;
+    }[];
+    dateBucket?: PivotDateBucket;
 };
+/** Next filters, or a React-style updater from the current committed filters. */
+type SetFiltersInput = QueryBuilderRuleGroup | ((prev: QueryBuilderRuleGroup) => QueryBuilderRuleGroup);
+/** Maps table column format dropdown values to persisted report column `format` (used by `columnActions.update`). */
+declare function tableColumnFormatFromUiSelection(raw: string): string;
 type SetReportChartAxesInput = {
     xAxis?: Partial<{
         field: string;
@@ -3059,24 +2998,39 @@ type SetReportChartAxesInput = {
     };
 };
 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;
+    /** Complete selected column list in display order. */
+    columns?: ReportColumnValue[];
     filters?: Filter[];
     groupRowsBy?: string;
     groupColumnsBy?: string;
-    aggregations?: AggregationStateItem[] | string | {
-        index: number;
-        value: string;
-    };
+    /**
+     * Pivot date grouping granularity. Pass an empty string to restore automatic
+     * bucketing based on the active date range.
+     */
+    dateBucket?: PivotDateBucket | '';
+    /**
+     * Encoded values as returned from `useReport().aggregations`
+     * (`'sum:transactions::amount'`, `'count:transactions'`, `''` = placeholder
+     * slot; bare `'sum:amount'` accepted, resolving the table from the schema),
+     * structured items, or a single encoded value.
+     *
+     * Prefer the full `string[]` form so UIs can batch with other `setReport`
+     * fields (e.g. drilldowns):
+     * - change: `aggregations.map((a, i) => (i === index ? next : a))`
+     * - add: `[...aggregations, '']`
+     * - remove: `aggregations.filter((_, i) => i !== index)`
+     */
+    aggregations?: string[] | AggregationStateItem[] | 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). */
+    /** Update the X-axis value returned by `useReport`. */
+    xAxis?: SetReportChartAxesInput['xAxis'];
+    /** Replace the Y-axis value returned by `useReport`. */
+    yAxis?: SetReportChartAxesInput['yAxis'];
+    /** @deprecated Prefer the top-level `xAxis` and `yAxis` inputs. */
     chartAxes?: SetReportChartAxesInput;
     /**
      * Schema table names for datasource / multi-table picker UIs.
@@ -3144,29 +3098,6 @@ type UseReportSaveChangesFn = () => Promise<unknown>;
  *   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;
@@ -3256,28 +3187,18 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
      * returned from `create-report` after the first datasource selection.
      */
     reportId: string | undefined;
-    datasources: {
-        id: string;
-        label: string;
-    }[];
-    datasourceOptions: {
-        id: string;
-        label: string;
-    }[];
+    datasources: string[];
+    datasourceOptions: SelectOption[];
     groupRowsBy: string | undefined;
     groupRowsByOptions: SelectOption[];
     groupColumnsBy: string | undefined;
     groupColumnsByOptions: SelectOption[];
-    aggregations: Partial<{
-        valueField: string;
-        valueFieldType: string;
-        valueField2?: string;
-        valueField2Type?: string;
-        aggregationType: AggregationType;
-        /** Resolved datasource table for `valueField` (mirrors `aggregationTablesByIndex`). */
-        valueFieldTable?: string;
-    }>[];
-    aggregationOptions: AggregationOption[];
+    dateBucket: PivotDateBucket | undefined;
+    dateBucketOptions: SelectOption[];
+    /** Encoded selection per aggregation slot (`'sum:transactions::amount'`, `'count:transactions'`, `''` = placeholder). Update via `setReport({ aggregations: nextStringArray })`. */
+    aggregations: string[];
+    /** Flat aggregation pick list shared by all slots; always contains every non-empty `aggregations` entry. */
+    aggregationOptions: SelectOption[];
     aggregationDescriptionOptions: {
         label: string;
         value: string;
@@ -3292,40 +3213,21 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
         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;
+    /** Selected tabular columns in display order. */
+    columns: ReportColumnValue[];
+    /** Pivot table columns only allow label and format changes. */
+    columnStructureEditsLocked: boolean;
+    /** Optional rich operations; simple selection updates use `setReport({ columns })`. */
+    columnActions: ColumnActions;
     /** 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;
-    };
+    xAxis: ReportXAxisValue;
     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;
-    };
+    yAxis: ReportYAxisValue;
     yAxisOptions: {
         value: string;
         label: string;
@@ -3337,12 +3239,6 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
     /** 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;
@@ -3362,6 +3258,27 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
     hasTableDrivenColumnOrder: boolean;
     filters: QueryBuilderRuleGroup;
     filterQueryBuilderProps: UseFormQueryBuilderProps;
+    /**
+     * Filter value pick lists for custom UIs (string unique values + pivot date
+     * buckets). Same string data as `filterQueryBuilderProps.getValues`; not
+     * wired into react-querybuilder unless you use it yourself.
+     */
+    filterOptions: FilterFieldOptions[];
+    /** 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[];
+    setReport: (nextState: SetReportBuilderInput) => void;
+    saveChanges: UseReportSaveChangesFn;
+    setFilters: (nextFilters: SetFiltersInput) => 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. */
@@ -3390,6 +3307,97 @@ declare function areQueryBuilderFilterDraftsDirty(draft: unknown, committed: unk
 /** Number of leaf filter rules (excludes empty groups). */
 declare function countFilterRules(value: unknown): 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;
+type FilterDraftQueryBuilderProps = UseFormQueryBuilderProps & {
+    /**
+     * Committed-or-draft tree react-querybuilder hydrates from on mount
+     * (uncontrolled mode). Omitted when the draft is empty so
+     * `addRuleToNewGroups` can seed the root rule on mount.
+     */
+    defaultQuery?: QueryBuilderRuleGroup;
+    onQueryChange: (next: unknown) => void;
+    addRuleToNewGroups: true;
+    getDefaultField: (fields: UseFormQueryBuilderField[]) => string;
+    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 (applying would change the report). */
+    hasUnappliedFilterChanges: boolean;
+    /** Apply the draft via `setFilters` (report/chart refresh follows). */
+    applyFilterDraft: () => void;
+    /** Drop the draft and rehydrate the builder from committed filters. */
+    resetFilterDraft: () => void;
+};
+
+type UseReportQueryBuilder = {
+    /** Pass as `key` to `react-querybuilder`'s `QueryBuilder`. */
+    key: string;
+    /** Spread onto `react-querybuilder`'s `QueryBuilder`. */
+    props: FilterDraftQueryBuilderProps;
+    /** The editor differs from the filters currently applied to the report. */
+    hasUnappliedChanges: boolean;
+    /** Apply the draft through the supplied full-tree filter setter. */
+    apply: () => void;
+    /** Discard the draft and remount from the committed filters. */
+    discard: () => void;
+    /** @deprecated Use `discard`. */
+    reset: () => void;
+};
+/**
+ * React Query Builder adapter for `useReport`.
+ *
+ * `useReport` owns the committed filter tree, field/operator metadata, unique
+ * values, and the `setFilters` conversion/refresh path. This hook only owns the
+ * uncontrolled Query Builder draft lifecycle.
+ */
+declare function useReportQueryBuilder(args: {
+    reportId?: string;
+    filters: QueryBuilderRuleGroup | null | undefined;
+    queryBuilderProps: UseFormQueryBuilderProps;
+    onApply: (next: QueryBuilderRuleGroup | ((prev: QueryBuilderRuleGroup) => QueryBuilderRuleGroup)) => void;
+}): UseReportQueryBuilder;
+
+type BarChartInteraction = {
+    interactionType: 'bar' | 'bucket';
+    /** Display label on the axis (pretty date bucket, category text, etc.). */
+    activeLabel: unknown;
+    /**
+     * Value for `chart.pivot.rowFilter` — same as `rowFilter.options[].value`.
+     * For date buckets this is the ISO bucket start, not the pretty label.
+     */
+    rowValue: string | null;
+    /**
+     * Value for `chart.pivot.columnFilter` when a specific series/bar was clicked.
+     * Same as `columnFilter.options[].value`. Absent on bucket-only clicks.
+     */
+    columnValue?: string;
+    /** @deprecated Prefer `columnValue`. */
+    activeDataKey?: string;
+    activeValue?: unknown;
+    activePayload: any[];
+    category: unknown;
+    series?: string;
+    value?: unknown;
+    row: Record<string, any>;
+    index: number;
+};
+
 type ReportDetailTable = {
     columns?: unknown[];
     rows?: unknown[];
@@ -3852,8 +3860,8 @@ type ClientFeatures = {
 };
 type QuillProviderClient = {
     name: string;
-    clientId: string;
-    publicKey: string;
+    id?: string;
+    clientId?: string;
     queryEndpoint: string;
     streamEndpoint?: string;
     queryHeaders?: HeadersInit;
@@ -3894,7 +3902,7 @@ type QuillTenant = {
 };
 
 interface QuillFetchOptions {
-    client: Pick<QuillProviderClient, 'clientId' | 'queryEndpoint' | 'queryHeaders' | 'withCredentials'>;
+    client: Pick<QuillProviderClient, 'id' | 'clientId' | 'queryEndpoint' | 'queryHeaders' | 'withCredentials'>;
     task: string;
     method?: string;
     metadata: any;
@@ -4444,4 +4452,4 @@ interface ReportTableProps {
 }
 declare const ReportTable: ({ reportBuilder, TableComponent, }: ReportTableProps) => react_jsx_runtime.JSX.Element;
 
-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, DEFAULT_PAGE_SIZE, DEFAULT_USE_REPORT_ROWS_PER_REQUEST, 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 OnChangeFn, type Option, type PaginationState, 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, type ReportDetailTable, 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 Updater, 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 };
+export { ALL_TENANTS, AddColumns, AddFilters, AddLimit, AddPivot, AddSort, type AxisFormat$1 as AxisFormat, type BarChartInteraction, 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 ColumnActions, type ColumnSelectionOption, type ContainerComponentProps, DEFAULT_PAGE_SIZE, DEFAULT_USE_REPORT_ROWS_PER_REQUEST, 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 FilterFieldOptions, type FilterPopoverComponentProps, FilterType, type HeaderComponentProps, type HeaderProps, type InternalDashboardDateFilter, type InternalDashboardTenantFilter, type InternalFilter, type LabelComponentProps, type LimitPopoverComponentProps, type ModalComponentProps, NullOperator, NumberOperator, type OnChangeFn, type Option, type PaginationState, type Pivot, type PivotAggregation, type PivotDateBucket, type PivotDimensionFilter, 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, type ReportColumnInput, type ReportColumnValue, ReportDetail, type ReportDetailProps, type ReportDetailTable, ReportTable, type ReportXAxisValue, type ReportYAxisFieldValue, type ReportYAxisValue, SINGLE_TENANT, SQLEditor, type SQLEditorProps, SaveReport, SchemaListComponent, type SelectColumnComponentProps, type SelectComponentProps, type SetFiltersInput, type SetReportBuilderInput, type SetReportChartAxesInput, type SidebarComponentProps, type SidebarHeadingComponentProps, type SortPopoverComponentProps, StaticChart, type StaticChartProps, StringOperator, Table, type TableComponentProps, type TableProps, type TabsComponentProps, type TextComponentProps, type TextInputComponentProps, ThemeContext, type Updater, type UseDashboardReload, type UseFormQueryBuilderField, type UseFormQueryBuilderProps, type UseReportFilterDraft, type UseReportQueryBuilder, areQueryBuilderFilterDraftsDirty, countFilterRules, defaultFilterRuleValueForOperator, downloadCSV, quillFormat as format, isQueryBuilderDisplayGroup, isQueryBuilderDisplayRule, normalizeRelativeDateRules, prepareQueryBuilderFiltersForSet, queryBuilderFiltersForEditor, quillFetch, stripQueryBuilderTransientFields, tableColumnFormatFromUiSelection, useAllReports, useAskQuill, useChangelogRefresh, useDashboard, useDashboardInternal, useDashboardReport, useDashboardReports, useDashboards, useExport, useMemoizedRows, useQuill, useReport, useReportBuilder, useReportQueryBuilder, useReports, useTenants, useVirtualTables };