@quillsql/react 2.16.49 → 2.16.50

package/dist/index.d.cts

@@ -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,6 +2764,11 @@ type QueryBuilderOperatorOption = {
     label: string;
     arity?: 'unary' | 'binary' | number;
 };
+/**
+ * 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 queryBuilderFiltersForEditor: (group: QueryBuilderRuleGroup) => QueryBuilderRuleGroup;
 
 /**
  * Pagination types and pure helpers for `useReport`, mirroring the
@@ -2844,6 +2878,21 @@ type ColumnActions = {
         format: string;
     }>) => void;
 };
+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;
     label: string;
@@ -2918,35 +2967,21 @@ type UseFormQueryBuilderProps = {
         fieldData?: Partial<UseFormQueryBuilderField>;
     }) => QueryBuilderFieldValueOption[];
 };
-/** Maps table column format dropdown values to persisted report column `format` (used by `columnActions.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;
@@ -2991,7 +3026,11 @@ interface SetReportBuilderInput {
     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.
@@ -3182,34 +3221,13 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
     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;
@@ -3221,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;
@@ -3246,6 +3258,12 @@ 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;
@@ -3257,7 +3275,7 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
     tableColumnOptions: ColumnSelectionOption[];
     setReport: (nextState: SetReportBuilderInput) => void;
     saveChanges: UseReportSaveChangesFn;
-    setFilters: (nextFilters: QueryBuilderRuleGroup) => void;
+    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;
@@ -3296,10 +3314,15 @@ declare function countFilterRules(value: unknown): number;
  */
 declare const defaultFilterRuleValueForOperator: (operator: unknown) => unknown;
 type FilterDraftQueryBuilderProps = UseFormQueryBuilderProps & {
-    /** Committed-or-draft tree react-querybuilder hydrates from on mount (uncontrolled mode). */
-    defaultQuery: QueryBuilderRuleGroup;
+    /**
+     * 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;
@@ -3347,9 +3370,34 @@ declare function useReportQueryBuilder(args: {
     reportId?: string;
     filters: QueryBuilderRuleGroup | null | undefined;
     queryBuilderProps: UseFormQueryBuilderProps;
-    onApply: (next: QueryBuilderRuleGroup) => void;
+    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[];
@@ -3812,8 +3860,8 @@ type ClientFeatures = {
 };
 type QuillProviderClient = {
     name: string;
-    clientId: string;
-    publicKey: string;
+    id?: string;
+    clientId?: string;
     queryEndpoint: string;
     streamEndpoint?: string;
     queryHeaders?: HeadersInit;
@@ -3854,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;
@@ -4404,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 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 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 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, SINGLE_TENANT, SQLEditor, type SQLEditorProps, SaveReport, SchemaListComponent, type SelectColumnComponentProps, type SelectComponentProps, 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 UseFormAxisConfig, type UseFormQueryBuilderField, type UseFormQueryBuilderProps, type UseReportFilterDraft, type UseReportQueryBuilder, areQueryBuilderFilterDraftsDirty, 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, useReportQueryBuilder, 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 };

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,6 +2764,11 @@ type QueryBuilderOperatorOption = {
     label: string;
     arity?: 'unary' | 'binary' | number;
 };
+/**
+ * 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 queryBuilderFiltersForEditor: (group: QueryBuilderRuleGroup) => QueryBuilderRuleGroup;
 
 /**
  * Pagination types and pure helpers for `useReport`, mirroring the
@@ -2844,6 +2878,21 @@ type ColumnActions = {
         format: string;
     }>) => void;
 };
+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;
     label: string;
@@ -2918,35 +2967,21 @@ type UseFormQueryBuilderProps = {
         fieldData?: Partial<UseFormQueryBuilderField>;
     }) => QueryBuilderFieldValueOption[];
 };
-/** Maps table column format dropdown values to persisted report column `format` (used by `columnActions.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;
@@ -2991,7 +3026,11 @@ interface SetReportBuilderInput {
     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.
@@ -3182,34 +3221,13 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
     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;
@@ -3221,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;
@@ -3246,6 +3258,12 @@ 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;
@@ -3257,7 +3275,7 @@ declare function useReport(reportIdArg?: string, options?: UseReportOptions): {
     tableColumnOptions: ColumnSelectionOption[];
     setReport: (nextState: SetReportBuilderInput) => void;
     saveChanges: UseReportSaveChangesFn;
-    setFilters: (nextFilters: QueryBuilderRuleGroup) => void;
+    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;
@@ -3296,10 +3314,15 @@ declare function countFilterRules(value: unknown): number;
  */
 declare const defaultFilterRuleValueForOperator: (operator: unknown) => unknown;
 type FilterDraftQueryBuilderProps = UseFormQueryBuilderProps & {
-    /** Committed-or-draft tree react-querybuilder hydrates from on mount (uncontrolled mode). */
-    defaultQuery: QueryBuilderRuleGroup;
+    /**
+     * 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;
@@ -3347,9 +3370,34 @@ declare function useReportQueryBuilder(args: {
     reportId?: string;
     filters: QueryBuilderRuleGroup | null | undefined;
     queryBuilderProps: UseFormQueryBuilderProps;
-    onApply: (next: QueryBuilderRuleGroup) => void;
+    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[];
@@ -3812,8 +3860,8 @@ type ClientFeatures = {
 };
 type QuillProviderClient = {
     name: string;
-    clientId: string;
-    publicKey: string;
+    id?: string;
+    clientId?: string;
     queryEndpoint: string;
     streamEndpoint?: string;
     queryHeaders?: HeadersInit;
@@ -3854,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;
@@ -4404,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 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 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 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, SINGLE_TENANT, SQLEditor, type SQLEditorProps, SaveReport, SchemaListComponent, type SelectColumnComponentProps, type SelectComponentProps, 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 UseFormAxisConfig, type UseFormQueryBuilderField, type UseFormQueryBuilderProps, type UseReportFilterDraft, type UseReportQueryBuilder, areQueryBuilderFilterDraftsDirty, 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, useReportQueryBuilder, 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 };