@quillsql/react 2.16.45 → 2.16.46

package/dist/index.cjs

@@ -15083,7 +15083,7 @@ function getDateString(value, dateRange, dateBucket, databaseType) {
   });
 }
 function isDateField(fieldType) {
-  return fieldType === "date" || fieldType === "datetime" || fieldType === "timestamp" || fieldType === "timestamptz" || fieldType === "MMM_yyyy" || fieldType === "MMM_dd" || fieldType === "MMM_dd_yyyy" || fieldType === "MMM_dd_hh:mm_ap_pm" || fieldType === "hh_ap_pm";
+  return fieldType === "date" || fieldType === "datetime" || fieldType === "timestamp" || fieldType === "timestamptz" || fieldType === "yyyy" || fieldType === "MMM_yyyy" || fieldType === "MMM_dd" || fieldType === "MMM_dd_yyyy" || fieldType === "MMM_dd_hh:mm_ap_pm" || fieldType === "hh_ap_pm";
 }
 var import_date_fns5;
 var init_dates = __esm({
@@ -19928,6 +19928,27 @@ function parseData(rows, queryType) {
       return rows;
   }
 }
+function isQuillFetchDebugEnabled() {
+  if (typeof globalThis !== "undefined") {
+    for (const debugFlag of QUILL_FETCH_DEBUG_FLAGS) {
+      if (globalThis?.[debugFlag] === true) {
+        return true;
+      }
+    }
+  }
+  if (typeof process !== "undefined" && typeof process.env !== "undefined") {
+    const envCandidates = [
+      process?.env?.QUILL_DEBUG_USEFORM_HYDRATION,
+      process?.env?.QUILL_DEBUG_USEFORM_FILTERS,
+      process?.env?.QUILL_DEBUG_DATA_FETCHER
+    ];
+    return envCandidates.some((candidate) => {
+      const normalized = String(candidate ?? "").trim().toLowerCase();
+      return normalized === "1" || normalized === "true";
+    });
+  }
+  return false;
+}
 async function testSqlViewState(client, referencedTables, getToken) {
   let errorMessage = null;
   await Promise.all(
@@ -20413,7 +20434,7 @@ async function fetchRelevantInfoFromState(reportBuilderState, tables, columns, a
     return { error: error.message };
   }
 }
-var quillFetch, parseFetchResponse;
+var QUILL_FETCH_DEBUG_FLAGS, quillFetchDebugSeq, logQuillFetchDebug, quillFetch, parseFetchResponse;
 var init_dataFetcher = __esm({
   "src/utils/dataFetcher.tsx"() {
     "use strict";
@@ -20422,6 +20443,16 @@ var init_dataFetcher = __esm({
     init_tableProcessing();
     init_dates();
     init_changelogNotify();
+    QUILL_FETCH_DEBUG_FLAGS = [
+      "__QUILL_DEBUG_USEFORM_HYDRATION__",
+      "__QUILL_DEBUG_USEFORM_FILTERS__",
+      "__QUILL_DEBUG_DATA_FETCHER__"
+    ];
+    quillFetchDebugSeq = 0;
+    logQuillFetchDebug = (label, payload) => {
+      if (!isQuillFetchDebugEnabled()) return;
+      console.log(`[quillFetch-debug] ${label}`, payload);
+    };
     quillFetch = async ({
       client,
       task,
@@ -20432,7 +20463,24 @@ var init_dataFetcher = __esm({
       urlParameters,
       getToken
     }) => {
+      const debugSeq = ++quillFetchDebugSeq;
+      const debugStart = Date.now();
+      logQuillFetchDebug("request", {
+        seq: debugSeq,
+        task,
+        reportId: metadata?.reportId,
+        dashboardItemId: metadata?.dashboardItemId,
+        hasPivot: Boolean(metadata?.pivot),
+        hasReportBuilderState: Boolean(metadata?.reportBuilderState),
+        filtersLength: Array.isArray(metadata?.filters) ? metadata.filters.length : void 0
+      });
       const token = await getToken();
+      logQuillFetchDebug("token-acquired", {
+        seq: debugSeq,
+        task,
+        ms: Date.now() - debugStart,
+        hasToken: Boolean(token)
+      });
       const queryString = urlParameters ?? `task=${task}`;
       const endpoint = client.queryEndpoint ? `${client.queryEndpoint}?${queryString}` : `${QUILL_SERVER}${QUILL_QUERY_ENDPOINT}?${queryString}`;
       try {
@@ -20464,6 +20512,17 @@ var init_dataFetcher = __esm({
         if (task !== "fetch-changelog-list" && Array.isArray(normalizedData?.changelogs)) {
           notifyChangelogs(normalizedData.changelogs);
         }
+        logQuillFetchDebug("response", {
+          seq: debugSeq,
+          task,
+          ms: Date.now() - debugStart,
+          status: result.status,
+          error: result.error,
+          dataError: normalizedData?.error,
+          queryResultRowCounts: Array.isArray(result.queries?.queryResults) ? result.queries.queryResults.map(
+            (qr) => Array.isArray(qr?.rows) ? qr.rows.length : null
+          ) : void 0
+        });
         return {
           data: normalizedData,
           queries: result.queries,
@@ -20472,8 +20531,19 @@ var init_dataFetcher = __esm({
         };
       } catch (e) {
         if (e instanceof Error && e.name === "AbortError") {
+          logQuillFetchDebug("aborted", {
+            seq: debugSeq,
+            task,
+            ms: Date.now() - debugStart
+          });
           throw e;
         }
+        logQuillFetchDebug("threw", {
+          seq: debugSeq,
+          task,
+          ms: Date.now() - debugStart,
+          message: e instanceof Error ? e.message : String(e)
+        });
         if (task !== "set-section-order") {
           console.error("Failed to fetch:", e);
         }
@@ -21498,6 +21568,7 @@ var numberFormatOptions = [
   "percentage"
 ];
 var dateFormatOptions = [
+  "yyyy",
   "MMM_yyyy",
   "MMM_dd",
   "MMM_dd_yyyy",
@@ -21515,6 +21586,7 @@ var NUMBER_OPTIONS = [
   { value: "percent", label: "percentage" }
 ];
 var DATE_OPTIONS = [
+  { value: "yyyy", label: "year" },
   { value: "MMM_yyyy", label: "month" },
   { value: "MMM_dd", label: "day" },
   { value: "MMM_dd_yyyy", label: "day and year" },
@@ -21902,6 +21974,7 @@ function buildPivotOnlyReportFromResponse({
       rows: rawPivotRows,
       fields: rawPivotFields,
       pivot: effectivePivot,
+      ...effectivePivot.dateBucket ? { dateBucket: effectivePivot.dateBucket } : {},
       client,
       rowCount: typeof response?.rowCount === "number" ? response.rowCount : void 0
     });
@@ -58804,7 +58877,9 @@ var filterTreeToQueryEntry = (node) => {
   };
 };
 var queryRuleToInternalFilter = (rule, fieldConfigByName) => {
-  const config = fieldConfigByName[rule.field];
+  const ruleTableName = String(rule.table ?? "").trim();
+  const tableQualifiedConfig = ruleTableName && rule.field && !rule.field.includes(".") ? fieldConfigByName[`${ruleTableName}.${rule.field}`] : void 0;
+  const config = tableQualifiedConfig ?? fieldConfigByName[rule.field];
   if (!config?.fieldType) {
     throw new Error(
       `Missing field type config for "${rule.field}". Add it to fieldConfigByName.`
@@ -60643,6 +60718,16 @@ function isPivotTableDateBucketRowAxis(chart, xAxisField) {
   if (!rowField || xf !== rowField) return false;
   return isDateType(String(chart.pivot.rowFieldType ?? ""));
 }
+var RESOLVABLE_X_AXIS_DATE_BUCKETS = /* @__PURE__ */ new Set(["year", "month", "day"]);
+function resolvePivotDateBucketXAxisFormat(chart, xAxisField) {
+  if (String(chart?.chartType ?? "").toLowerCase() === "table") return null;
+  const dateBucket = String(chart?.pivot?.dateBucket ?? "").trim().toLowerCase();
+  if (!RESOLVABLE_X_AXIS_DATE_BUCKETS.has(dateBucket)) return null;
+  const rowField = String(chart?.pivot?.rowField ?? "").trim();
+  if (!rowField || String(xAxisField ?? "").trim() !== rowField) return null;
+  if (!isDateType(String(chart?.pivot?.rowFieldType ?? ""))) return null;
+  return getDateFormatFromBucket(dateBucket);
+}
 function chartDetailRowsMissingPivotRowBucket(chart) {
   if (!chart?.pivot) return false;
   const rowField = String(chart.pivot.rowField ?? "").trim();
@@ -60863,6 +60948,9 @@ function normalizePivotChartForDisplay(chart) {
     withResolvedXAxis.pivot?.rowFieldType ?? ""
   ).trim();
   const pivotDateRowMonthLabelRe = /^[A-Z][a-z]{2} \d{4}$/;
+  const pivotDisplayDateFormat = getDateFormatFromBucket(
+    String(withResolvedXAxis.pivot?.dateBucket ?? "").trim()
+  );
   let displayRows = Array.isArray(
     withResolvedXAxis.rows
   ) ? withResolvedXAxis.rows : [];
@@ -60881,7 +60969,7 @@ function normalizePivotChartForDisplay(chart) {
       }
       const formatted = quillFormat({
         value: raw,
-        format: "MMM_yyyy"
+        format: pivotDisplayDateFormat
       });
       if (!formatted || !String(formatted).trim()) {
         return row;
@@ -64598,6 +64686,19 @@ function useReport(reportIdArg, options = {}) {
         resolveCache.set(fieldName, resolved);
         return resolved;
       }
+      if (isUseFormFiltersDebugEnabled()) {
+        console.error(
+          "[useForm-debug] normalizeQueryBuilderFieldNameForConfig ambiguous",
+          {
+            fieldName,
+            candidateKeys: candidates.map(([key]) => key),
+            preferredTableNames: Array.from(preferredTableNames),
+            primaryTableName,
+            effectiveReportBuilderTableNames,
+            baseReportBuilderTableNames
+          }
+        );
+      }
       return fieldName;
     };
   }, [
@@ -64617,7 +64718,9 @@ function useReport(reportIdArg, options = {}) {
         }
         if (entry && typeof entry === "object" && "field" in entry) {
           const previousFieldName = String(entry.field ?? "").trim();
-          const nextFieldName = normalizeQueryBuilderFieldNameForConfig(previousFieldName);
+          const ruleTableName = String(entry.table ?? "").trim();
+          const tableQualifiedKey = ruleTableName && previousFieldName && !previousFieldName.includes(".") ? `${ruleTableName}.${previousFieldName}` : "";
+          const nextFieldName = tableQualifiedKey && queryBuilderFieldConfigByName[tableQualifiedKey] ? tableQualifiedKey : normalizeQueryBuilderFieldNameForConfig(previousFieldName);
           if (!nextFieldName || nextFieldName === previousFieldName) {
             return entry;
           }
@@ -64639,7 +64742,7 @@ function useReport(reportIdArg, options = {}) {
       }
       return normalizeGroup(group);
     };
-  }, [normalizeQueryBuilderFieldNameForConfig]);
+  }, [normalizeQueryBuilderFieldNameForConfig, queryBuilderFieldConfigByName]);
   const refreshSelectionTables = (0, import_react62.useMemo)(() => {
     return [
       getPivotGroupOptionTable(groupRowsBy),
@@ -65981,6 +66084,15 @@ function useReport(reportIdArg, options = {}) {
       chartAxisOptionByField.get(resolvedXAxisField)?.format ?? chartAxesBaseChart.xAxisFormat ?? resolvedYAxisFields[0]?.format,
       "string"
     );
+    if (defaultFormat === "string") {
+      const bucketFormat = resolvePivotDateBucketXAxisFormat(
+        chartAxesBaseChart,
+        resolvedXAxisField
+      );
+      if (bucketFormat) {
+        defaultFormat = bucketFormat;
+      }
+    }
     if (isPivotTableDateBucketRowAxis(chartAxesBaseChart, resolvedXAxisField) && chartAxisEdits.xAxisFormat === void 0) {
       defaultFormat = "string";
     }
@@ -67475,6 +67587,17 @@ function useReport(reportIdArg, options = {}) {
         });
       }
     } catch (error) {
+      if (isUseFormFiltersDebugEnabled()) {
+        console.error("[useForm-debug] setFilters swallowed error", {
+          error: error instanceof Error ? error.message : String(error),
+          requestedRules: (nextFilters?.rules ?? []).map((rule) => ({
+            table: rule?.table,
+            field: rule?.field,
+            operator: rule?.operator
+          })),
+          fieldConfigKeys: Object.keys(queryBuilderFieldConfigByName ?? {})
+        });
+      }
     }
   };
   const filterDraft = useReportFilterDraft({

package/dist/index.js

@@ -15131,7 +15131,7 @@ function getDateString(value, dateRange, dateBucket, databaseType) {
   });
 }
 function isDateField(fieldType) {
-  return fieldType === "date" || fieldType === "datetime" || fieldType === "timestamp" || fieldType === "timestamptz" || fieldType === "MMM_yyyy" || fieldType === "MMM_dd" || fieldType === "MMM_dd_yyyy" || fieldType === "MMM_dd_hh:mm_ap_pm" || fieldType === "hh_ap_pm";
+  return fieldType === "date" || fieldType === "datetime" || fieldType === "timestamp" || fieldType === "timestamptz" || fieldType === "yyyy" || fieldType === "MMM_yyyy" || fieldType === "MMM_dd" || fieldType === "MMM_dd_yyyy" || fieldType === "MMM_dd_hh:mm_ap_pm" || fieldType === "hh_ap_pm";
 }
 var init_dates = __esm({
   "src/utils/dates.ts"() {
@@ -19973,6 +19973,27 @@ function parseData(rows, queryType) {
       return rows;
   }
 }
+function isQuillFetchDebugEnabled() {
+  if (typeof globalThis !== "undefined") {
+    for (const debugFlag of QUILL_FETCH_DEBUG_FLAGS) {
+      if (globalThis?.[debugFlag] === true) {
+        return true;
+      }
+    }
+  }
+  if (typeof process !== "undefined" && typeof process.env !== "undefined") {
+    const envCandidates = [
+      process?.env?.QUILL_DEBUG_USEFORM_HYDRATION,
+      process?.env?.QUILL_DEBUG_USEFORM_FILTERS,
+      process?.env?.QUILL_DEBUG_DATA_FETCHER
+    ];
+    return envCandidates.some((candidate) => {
+      const normalized = String(candidate ?? "").trim().toLowerCase();
+      return normalized === "1" || normalized === "true";
+    });
+  }
+  return false;
+}
 async function testSqlViewState(client, referencedTables, getToken) {
   let errorMessage = null;
   await Promise.all(
@@ -20458,7 +20479,7 @@ async function fetchRelevantInfoFromState(reportBuilderState, tables, columns, a
     return { error: error.message };
   }
 }
-var quillFetch, parseFetchResponse;
+var QUILL_FETCH_DEBUG_FLAGS, quillFetchDebugSeq, logQuillFetchDebug, quillFetch, parseFetchResponse;
 var init_dataFetcher = __esm({
   "src/utils/dataFetcher.tsx"() {
     "use strict";
@@ -20467,6 +20488,16 @@ var init_dataFetcher = __esm({
     init_tableProcessing();
     init_dates();
     init_changelogNotify();
+    QUILL_FETCH_DEBUG_FLAGS = [
+      "__QUILL_DEBUG_USEFORM_HYDRATION__",
+      "__QUILL_DEBUG_USEFORM_FILTERS__",
+      "__QUILL_DEBUG_DATA_FETCHER__"
+    ];
+    quillFetchDebugSeq = 0;
+    logQuillFetchDebug = (label, payload) => {
+      if (!isQuillFetchDebugEnabled()) return;
+      console.log(`[quillFetch-debug] ${label}`, payload);
+    };
     quillFetch = async ({
       client,
       task,
@@ -20477,7 +20508,24 @@ var init_dataFetcher = __esm({
       urlParameters,
       getToken
     }) => {
+      const debugSeq = ++quillFetchDebugSeq;
+      const debugStart = Date.now();
+      logQuillFetchDebug("request", {
+        seq: debugSeq,
+        task,
+        reportId: metadata?.reportId,
+        dashboardItemId: metadata?.dashboardItemId,
+        hasPivot: Boolean(metadata?.pivot),
+        hasReportBuilderState: Boolean(metadata?.reportBuilderState),
+        filtersLength: Array.isArray(metadata?.filters) ? metadata.filters.length : void 0
+      });
       const token = await getToken();
+      logQuillFetchDebug("token-acquired", {
+        seq: debugSeq,
+        task,
+        ms: Date.now() - debugStart,
+        hasToken: Boolean(token)
+      });
       const queryString = urlParameters ?? `task=${task}`;
       const endpoint = client.queryEndpoint ? `${client.queryEndpoint}?${queryString}` : `${QUILL_SERVER}${QUILL_QUERY_ENDPOINT}?${queryString}`;
       try {
@@ -20509,6 +20557,17 @@ var init_dataFetcher = __esm({
         if (task !== "fetch-changelog-list" && Array.isArray(normalizedData?.changelogs)) {
           notifyChangelogs(normalizedData.changelogs);
         }
+        logQuillFetchDebug("response", {
+          seq: debugSeq,
+          task,
+          ms: Date.now() - debugStart,
+          status: result.status,
+          error: result.error,
+          dataError: normalizedData?.error,
+          queryResultRowCounts: Array.isArray(result.queries?.queryResults) ? result.queries.queryResults.map(
+            (qr) => Array.isArray(qr?.rows) ? qr.rows.length : null
+          ) : void 0
+        });
         return {
           data: normalizedData,
           queries: result.queries,
@@ -20517,8 +20576,19 @@ var init_dataFetcher = __esm({
         };
       } catch (e) {
         if (e instanceof Error && e.name === "AbortError") {
+          logQuillFetchDebug("aborted", {
+            seq: debugSeq,
+            task,
+            ms: Date.now() - debugStart
+          });
           throw e;
         }
+        logQuillFetchDebug("threw", {
+          seq: debugSeq,
+          task,
+          ms: Date.now() - debugStart,
+          message: e instanceof Error ? e.message : String(e)
+        });
         if (task !== "set-section-order") {
           console.error("Failed to fetch:", e);
         }
@@ -21496,6 +21566,7 @@ var numberFormatOptions = [
   "percentage"
 ];
 var dateFormatOptions = [
+  "yyyy",
   "MMM_yyyy",
   "MMM_dd",
   "MMM_dd_yyyy",
@@ -21513,6 +21584,7 @@ var NUMBER_OPTIONS = [
   { value: "percent", label: "percentage" }
 ];
 var DATE_OPTIONS = [
+  { value: "yyyy", label: "year" },
   { value: "MMM_yyyy", label: "month" },
   { value: "MMM_dd", label: "day" },
   { value: "MMM_dd_yyyy", label: "day and year" },
@@ -21900,6 +21972,7 @@ function buildPivotOnlyReportFromResponse({
       rows: rawPivotRows,
       fields: rawPivotFields,
       pivot: effectivePivot,
+      ...effectivePivot.dateBucket ? { dateBucket: effectivePivot.dateBucket } : {},
       client,
       rowCount: typeof response?.rowCount === "number" ? response.rowCount : void 0
     });
@@ -59012,7 +59085,9 @@ var filterTreeToQueryEntry = (node) => {
   };
 };
 var queryRuleToInternalFilter = (rule, fieldConfigByName) => {
-  const config = fieldConfigByName[rule.field];
+  const ruleTableName = String(rule.table ?? "").trim();
+  const tableQualifiedConfig = ruleTableName && rule.field && !rule.field.includes(".") ? fieldConfigByName[`${ruleTableName}.${rule.field}`] : void 0;
+  const config = tableQualifiedConfig ?? fieldConfigByName[rule.field];
   if (!config?.fieldType) {
     throw new Error(
       `Missing field type config for "${rule.field}". Add it to fieldConfigByName.`
@@ -60851,6 +60926,16 @@ function isPivotTableDateBucketRowAxis(chart, xAxisField) {
   if (!rowField || xf !== rowField) return false;
   return isDateType(String(chart.pivot.rowFieldType ?? ""));
 }
+var RESOLVABLE_X_AXIS_DATE_BUCKETS = /* @__PURE__ */ new Set(["year", "month", "day"]);
+function resolvePivotDateBucketXAxisFormat(chart, xAxisField) {
+  if (String(chart?.chartType ?? "").toLowerCase() === "table") return null;
+  const dateBucket = String(chart?.pivot?.dateBucket ?? "").trim().toLowerCase();
+  if (!RESOLVABLE_X_AXIS_DATE_BUCKETS.has(dateBucket)) return null;
+  const rowField = String(chart?.pivot?.rowField ?? "").trim();
+  if (!rowField || String(xAxisField ?? "").trim() !== rowField) return null;
+  if (!isDateType(String(chart?.pivot?.rowFieldType ?? ""))) return null;
+  return getDateFormatFromBucket(dateBucket);
+}
 function chartDetailRowsMissingPivotRowBucket(chart) {
   if (!chart?.pivot) return false;
   const rowField = String(chart.pivot.rowField ?? "").trim();
@@ -61071,6 +61156,9 @@ function normalizePivotChartForDisplay(chart) {
     withResolvedXAxis.pivot?.rowFieldType ?? ""
   ).trim();
   const pivotDateRowMonthLabelRe = /^[A-Z][a-z]{2} \d{4}$/;
+  const pivotDisplayDateFormat = getDateFormatFromBucket(
+    String(withResolvedXAxis.pivot?.dateBucket ?? "").trim()
+  );
   let displayRows = Array.isArray(
     withResolvedXAxis.rows
   ) ? withResolvedXAxis.rows : [];
@@ -61089,7 +61177,7 @@ function normalizePivotChartForDisplay(chart) {
       }
       const formatted = quillFormat({
         value: raw,
-        format: "MMM_yyyy"
+        format: pivotDisplayDateFormat
       });
       if (!formatted || !String(formatted).trim()) {
         return row;
@@ -64806,6 +64894,19 @@ function useReport(reportIdArg, options = {}) {
         resolveCache.set(fieldName, resolved);
         return resolved;
       }
+      if (isUseFormFiltersDebugEnabled()) {
+        console.error(
+          "[useForm-debug] normalizeQueryBuilderFieldNameForConfig ambiguous",
+          {
+            fieldName,
+            candidateKeys: candidates.map(([key]) => key),
+            preferredTableNames: Array.from(preferredTableNames),
+            primaryTableName,
+            effectiveReportBuilderTableNames,
+            baseReportBuilderTableNames
+          }
+        );
+      }
       return fieldName;
     };
   }, [
@@ -64825,7 +64926,9 @@ function useReport(reportIdArg, options = {}) {
         }
         if (entry && typeof entry === "object" && "field" in entry) {
           const previousFieldName = String(entry.field ?? "").trim();
-          const nextFieldName = normalizeQueryBuilderFieldNameForConfig(previousFieldName);
+          const ruleTableName = String(entry.table ?? "").trim();
+          const tableQualifiedKey = ruleTableName && previousFieldName && !previousFieldName.includes(".") ? `${ruleTableName}.${previousFieldName}` : "";
+          const nextFieldName = tableQualifiedKey && queryBuilderFieldConfigByName[tableQualifiedKey] ? tableQualifiedKey : normalizeQueryBuilderFieldNameForConfig(previousFieldName);
           if (!nextFieldName || nextFieldName === previousFieldName) {
             return entry;
           }
@@ -64847,7 +64950,7 @@ function useReport(reportIdArg, options = {}) {
       }
       return normalizeGroup(group);
     };
-  }, [normalizeQueryBuilderFieldNameForConfig]);
+  }, [normalizeQueryBuilderFieldNameForConfig, queryBuilderFieldConfigByName]);
   const refreshSelectionTables = useMemo33(() => {
     return [
       getPivotGroupOptionTable(groupRowsBy),
@@ -66189,6 +66292,15 @@ function useReport(reportIdArg, options = {}) {
       chartAxisOptionByField.get(resolvedXAxisField)?.format ?? chartAxesBaseChart.xAxisFormat ?? resolvedYAxisFields[0]?.format,
       "string"
     );
+    if (defaultFormat === "string") {
+      const bucketFormat = resolvePivotDateBucketXAxisFormat(
+        chartAxesBaseChart,
+        resolvedXAxisField
+      );
+      if (bucketFormat) {
+        defaultFormat = bucketFormat;
+      }
+    }
     if (isPivotTableDateBucketRowAxis(chartAxesBaseChart, resolvedXAxisField) && chartAxisEdits.xAxisFormat === void 0) {
       defaultFormat = "string";
     }
@@ -67683,6 +67795,17 @@ function useReport(reportIdArg, options = {}) {
         });
       }
     } catch (error) {
+      if (isUseFormFiltersDebugEnabled()) {
+        console.error("[useForm-debug] setFilters swallowed error", {
+          error: error instanceof Error ? error.message : String(error),
+          requestedRules: (nextFilters?.rules ?? []).map((rule) => ({
+            table: rule?.table,
+            field: rule?.field,
+            operator: rule?.operator
+          })),
+          fieldConfigKeys: Object.keys(queryBuilderFieldConfigByName ?? {})
+        });
+      }
     }
   };
   const filterDraft = useReportFilterDraft({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillsql/react",
-  "version": "2.16.45",
+  "version": "2.16.46",
   "type": "module",
   "exports": {
     ".": {