@quillsql/react 2.16.92 → 2.16.93

package/dist/index.js

@@ -17183,6 +17183,79 @@ var init_paginationProcessing = __esm({
   }
 });
 
+// src/utils/dashboardProfiler.ts
+function profilingEnabled() {
+  if (typeof process !== "undefined" && process.env?.QUILL_DASHBOARD_PROFILE === "true") {
+    return true;
+  }
+  if (typeof window === "undefined") return false;
+  return Boolean(window.__QUILL_DASHBOARD_PROFILE__);
+}
+function profileStore() {
+  if (typeof window !== "undefined") {
+    const profileWindow = window;
+    profileWindow.__QUILL_DASHBOARD_TRACE__ ??= [];
+    return profileWindow.__QUILL_DASHBOARD_TRACE__;
+  }
+  const globalStore = globalThis;
+  globalStore.__QUILL_DASHBOARD_TRACE__ ??= [];
+  return globalStore.__QUILL_DASHBOARD_TRACE__;
+}
+function queryKeyFamily(queryKey) {
+  const head = String(queryKey[0] ?? "");
+  const next = String(queryKey[1] ?? "");
+  if (head === "quill" && next === "dashboard-report") {
+    return "quill/dashboard-report";
+  }
+  if (head === "useReport") {
+    return `useReport/${next || "unknown"}`;
+  }
+  return head || "other";
+}
+function summarizeEngineRequest(input) {
+  const metadata = input.metadata ?? {};
+  return {
+    task: input.task ?? null,
+    shareRequest: Boolean(input.shareRequest),
+    reuseExisting: input.reuseExisting ?? null,
+    settled: input.settled ?? null,
+    reportId: metadata.reportId ?? null,
+    metadataKeys: Object.keys(metadata).sort(),
+    dashboardName: metadata.dashboardName ?? null,
+    dashboardItemId: metadata.dashboardItemId ?? null,
+    useNewNodeSql: metadata.useNewNodeSql ?? null,
+    dateBucket: metadata.dateBucket ?? null,
+    hasPivot: Boolean(metadata.pivot),
+    hasReportBuilderState: Boolean(metadata.reportBuilderState),
+    additionalProcessing: metadata.additionalProcessing ?? null,
+    filterCount: Array.isArray(metadata.filters) ? metadata.filters.length : null
+  };
+}
+function profileDashboard(event, data) {
+  if (!profilingEnabled()) return;
+  const entry = {
+    at: Math.round(performance.now() * 10) / 10,
+    event,
+    data
+  };
+  profileStore().push(entry);
+  if (typeof window !== "undefined") {
+    const profileWindow = window;
+    profileWindow.__QUILL_DASHBOARD_PROFILE__ = true;
+    profileWindow.__QUILL_DUMP_DASHBOARD_PROFILE__ = () => profileWindow.__QUILL_DASHBOARD_TRACE__ ?? [];
+  }
+  if (typeof process !== "undefined" && process.env?.QUILL_DASHBOARD_PROFILE_CONSOLE === "true" && CONSOLE_EVENT_PATTERN.test(event)) {
+    console.log(`[quill-profile] ${event}`, data ?? {});
+  }
+}
+var CONSOLE_EVENT_PATTERN;
+var init_dashboardProfiler = __esm({
+  "src/utils/dashboardProfiler.ts"() {
+    "use strict";
+    CONSOLE_EVENT_PATTERN = /cache|initial-load|use-report-loading|network|unique-values|table-refresh|pivot|shared-request|engine-fetch|generate-pivot/;
+  }
+});
+
 // src/utils/pivotConstructor.ts
 function normalizeLegacyPivotSortFieldValue(sortField) {
   if (sortField === void 0) {
@@ -17295,6 +17368,22 @@ async function generatePivotWithSQL({
     rowLimit: pivot.rowLimit,
     dateBucket: resolvedDateBucket
   };
+  profileDashboard(
+    "generate-pivot-sql",
+    summarizeEngineRequest({
+      task: "pivot-template",
+      shareRequest: false,
+      metadata: {
+        reportId: report?.id,
+        dashboardName,
+        dateBucket: resolvedDateBucket,
+        additionalProcessing,
+        pivot: pivotConfig,
+        reportBuilderState,
+        filters: dashboardFilters
+      }
+    })
+  );
   const resp = await quillFetch({
     client,
     task: "pivot-template",
@@ -17673,6 +17762,7 @@ var init_pivotConstructor = __esm({
     init_columnType();
     init_dataFetcher();
     init_dataProcessing();
+    init_dashboardProfiler();
     init_dates();
     init_textProcessing();
   }
@@ -20094,6 +20184,20 @@ async function getOrFetchSharedRequest({
 }) {
   if (signal?.aborted) throw createAbortError(signal);
   let entry = entries.get(key);
+  const reuseExisting = Boolean(entry);
+  profileDashboard("shared-request", {
+    ...summarizeEngineRequest({
+      task: void 0,
+      shareRequest: true,
+      reuseExisting,
+      settled: entry?.settled,
+      metadata: { reportId }
+    }),
+    reportId: reportId ?? null,
+    reuseExisting,
+    settled: entry?.settled ?? false,
+    keyLength: key.length
+  });
   if (!entry) {
     const controller = new AbortController();
     entry = {
@@ -20169,6 +20273,7 @@ var ORPHAN_GRACE_MS, COMPLETED_TTL_MS, entries;
 var init_reportRequestPool = __esm({
   "src/utils/reportRequestPool.ts"() {
     "use strict";
+    init_dashboardProfiler();
     ORPHAN_GRACE_MS = 100;
     COMPLETED_TTL_MS = 15e3;
     entries = /* @__PURE__ */ new Map();
@@ -20731,6 +20836,7 @@ var init_dataFetcher = __esm({
     init_dates();
     init_changelogNotify();
     init_reportRequestPool();
+    init_dashboardProfiler();
     quillFetch = async ({
       client,
       task,
@@ -20791,6 +20897,14 @@ var init_dataFetcher = __esm({
           return { error: "Failed to fetch data" };
         }
       };
+      profileDashboard(
+        "engine-fetch",
+        summarizeEngineRequest({
+          task,
+          shareRequest,
+          metadata
+        })
+      );
       if (!shareRequest) {
         return execute(abortSignal);
       }
@@ -21362,22 +21476,7 @@ init_dates();
 init_pivotConstructor();
 init_columnProcessing();
 init_paginationProcessing();
-
-// src/utils/dashboardProfiler.ts
-function profileDashboard(event, data) {
-  if (typeof window === "undefined") return;
-  const profileWindow = window;
-  if (!profileWindow.__QUILL_DASHBOARD_PROFILE__) return;
-  const entry = {
-    at: Math.round(performance.now() * 10) / 10,
-    event,
-    data
-  };
-  profileWindow.__QUILL_DASHBOARD_TRACE__ ??= [];
-  profileWindow.__QUILL_DASHBOARD_TRACE__.push(entry);
-}
-
-// src/utils/dashboard.ts
+init_dashboardProfiler();
 var defaultDashboardItem = {
   id: "",
   name: "",
@@ -22790,6 +22889,7 @@ init_tableProcessing();
 init_textProcessing();
 init_valueFormatter();
 init_astFilterProcessing();
+init_dashboardProfiler();
 init_reportBuilder();
 init_astProcessing();
 
@@ -26573,6 +26673,7 @@ function normalizePSTRanges(start, end) {
 
 // src/Context.tsx
 init_changelogNotify();
+init_dashboardProfiler();
 
 // src/reportStore.ts
 import { createContext, useContext, useSyncExternalStore } from "react";
@@ -32354,7 +32455,7 @@ function QuillTable({
     setSortColumn(sort?.field || "");
     setSortDirection(sort?.direction || "desc");
   }, [sort]);
-  const holdFullPageLoader = rows?.length === 0 && isLoading;
+  const holdFullPageLoader = Boolean(isLoading);
   const pageCountUnknown = manualPagination && pageCount === -1;
   const { activeRows, maxPage } = useMemo4(() => {
     const start = currentPage * rowsPerPage;
@@ -37282,6 +37383,7 @@ function getDashboardReportProcessing(report, serverPagination) {
 }
 
 // src/hooks/useDashboard.ts
+init_dashboardProfiler();
 var DEFAULT_DASHBOARD_REPORT_STALE_TIME_MS = 5 * 60 * 1e3;
 var useDashboardConfigInternal = (dashboardName) => {
   const { dashboardConfig, isLoading: dashboardsLoading } = useContext13(
@@ -38391,6 +38493,14 @@ var useDashboard = (dashboardName, config) => {
           additionalProcessing
         );
         const usePivotTask = !cacheEnabled && !!reportInfo.pivot;
+        profileDashboard("dashboard-report-cache-path", {
+          reportId,
+          cacheEnabled,
+          cacheCabCacheable: cacheCab.isCacheable(reportId),
+          usePivotTask,
+          forceCacheToRefresh,
+          hasPivot: Boolean(reportInfo.pivot)
+        });
         const allFilters = dashboardFilters2.concat(customFilters).concat(customReportFiltersArray);
         const applyInMemoryPivotIfNeeded = (report2) => {
           const pivotToApply = reportInfo.pivot ?? report2.pivot;
@@ -38624,7 +38734,9 @@ var useDashboard = (dashboardName, config) => {
                   pivotColumns: pivotData.columns,
                   pivotRowCount: pivotData.rowCount,
                   pivotQuery: pivotData.pivotQuery,
-                  comparisonPivotQuery: pivotData.comparisonPivotQuery
+                  comparisonPivotQuery: pivotData.comparisonPivotQuery,
+                  pivotResultRowField: pivotData.rowField,
+                  pivotResultSourceRowField: reportInfo.pivot?.rowField
                 },
                 error: void 0
               };
@@ -38654,6 +38766,26 @@ var useDashboard = (dashboardName, config) => {
             shareRequest: !forceCacheToRefresh
           });
         };
+        const existingState = queryClient.getQueryState(queryKey);
+        const existingData = queryClient.getQueryData(queryKey);
+        const dataUpdatedAt = existingState?.dataUpdatedAt ?? 0;
+        const ageMs = dataUpdatedAt ? Date.now() - dataUpdatedAt : null;
+        const isStale = dataUpdatedAt === 0 || Date.now() - dataUpdatedAt >= reportStaleTimeMs;
+        profileDashboard("dashboard-report-tanstack-cache", {
+          reportId,
+          keyFamily: "quill/dashboard-report",
+          cacheEnabled,
+          usePivotTask,
+          forceCacheToRefresh,
+          staleTimeMs: reportStaleTimeMs,
+          status: existingState?.status ?? "missing",
+          fetchStatus: existingState?.fetchStatus ?? "idle",
+          hasData: existingData !== void 0,
+          dataUpdatedAt,
+          ageMs,
+          isStale,
+          willReuseTanstack: !forceCacheToRefresh && existingData !== void 0 && !isStale
+        });
         const result = forceCacheToRefresh ? await fetchDashboardReport() : await queryClient.fetchQuery({
           queryKey,
           queryFn: fetchDashboardReport,
@@ -39056,6 +39188,7 @@ var useDashboardReport = (reportId, config) => {
 };
 
 // src/components/Dashboard/DataLoader.tsx
+init_dashboardProfiler();
 import { Fragment as Fragment5, jsx as jsx46 } from "react/jsx-runtime";
 var constructReportFromItem = (item) => {
   return {
@@ -41471,6 +41604,7 @@ function QuillTableDashboardComponent({
 
 // src/Chart.tsx
 init_valueFormatter();
+init_dashboardProfiler();
 import { Fragment as Fragment6, jsx as jsx50, jsxs as jsxs38 } from "react/jsx-runtime";
 function Chart({
   colors,
@@ -45462,6 +45596,7 @@ init_Filter();
 
 // src/StaticChart.tsx
 import { useEffect as useEffect20, useMemo as useMemo21 } from "react";
+init_dashboardProfiler();
 import { jsx as jsx60 } from "react/jsx-runtime";
 var CHART_TYPE_STYLES = {
   metric: { height: "100px", width: "200px" },
@@ -62428,6 +62563,7 @@ function resolveReportFromCacheCab({
 }
 
 // src/hooks/useForm.tsx
+init_dashboardProfiler();
 init_reportRequestPool();
 
 // src/hooks/useForm.queries.ts
@@ -62473,6 +62609,15 @@ function createUseFormInitialLoadQueryKey(input) {
     input.additionalSchemaHash
   ];
 }
+var DASHBOARD_REPORT_STALE_TIME_MS = 5 * 60 * 1e3;
+function findCachedDashboardReportQuery(queryClient, reportId) {
+  const id = String(reportId ?? "").trim();
+  if (!id) return void 0;
+  return queryClient.getQueryCache().findAll({ queryKey: ["quill", "dashboard-report", id] }).find((query) => {
+    const data = query.state.data;
+    return Boolean(data?.report) && !data?.error;
+  });
+}
 function shouldBootstrapUseFormInitialLoad(input) {
   return !input.hasInitialReportBuilderState && input.previouslyBootstrappedIdentity !== input.currentIdentity;
 }
@@ -63455,6 +63600,11 @@ function getPivotTableSlotReportColumn(reportColumns, aggregations, rowField, pi
   }
   return cols[aggIndex + 1];
 }
+function pivotRowKey(chart) {
+  return String(
+    chart?.pivotResultRowField ?? chart?.pivot?.rowField ?? ""
+  ).trim();
+}
 function isPivotTableDateBucketRowAxis(chart, xAxisField) {
   if (!chart?.pivot) return false;
   if (String(chart.chartType ?? "").toLowerCase() !== "table") return false;
@@ -63463,7 +63613,8 @@ function isPivotTableDateBucketRowAxis(chart, xAxisField) {
   }
   const rowField = String(chart.pivot.rowField ?? "").trim();
   const xf = String(xAxisField ?? "").trim();
-  if (!rowField || xf !== rowField) return false;
+  const rowKey = pivotRowKey(chart);
+  if (!rowField || xf !== rowField && xf !== rowKey) return false;
   return isDateType(String(chart.pivot.rowFieldType ?? ""));
 }
 var RESOLVABLE_X_AXIS_DATE_BUCKETS = /* @__PURE__ */ new Set([
@@ -63477,22 +63628,24 @@ function resolvePivotDateBucketXAxisFormat(chart, xAxisField) {
   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;
+  const xf = String(xAxisField ?? "").trim();
+  const rowKey = pivotRowKey(chart);
+  if (!rowField || xf !== rowField && xf !== rowKey) 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();
-  if (!rowField) return false;
+  const rowKey = pivotRowKey(chart);
+  if (!rowKey) return false;
   const rows = chart.rows;
   if (!Array.isArray(rows) || rows.length === 0) return false;
   const first = rows.find(
     (r) => r && typeof r === "object" && Object.keys(r).length > 0
   );
   if (!first) return false;
-  if (!Object.prototype.hasOwnProperty.call(first, rowField)) return true;
-  const v = first[rowField];
+  if (!Object.prototype.hasOwnProperty.call(first, rowKey)) return true;
+  const v = first[rowKey];
   return v === void 0 || v === null;
 }
 function shouldUsePivotRowFieldAsXAxis(chartType, pivotRowField, rowColumnFormat) {
@@ -63528,7 +63681,7 @@ function normalizePivotChartForDisplay(chart, resolveTableLabel) {
   } : chart;
   if (!config) return config;
   if (!config.pivot) return config;
-  const pivotRowFieldEarly = String(config.pivot?.rowField ?? "").trim();
+  const pivotRowFieldEarly = pivotRowKey(config);
   const rowColumn = (config.pivotColumns ?? config.columns ?? []).find(
     (col) => String(col.field ?? "").trim() === pivotRowFieldEarly
   );
@@ -63551,7 +63704,7 @@ function normalizePivotChartForDisplay(chart, resolveTableLabel) {
     (field) => !INTERNAL_PIVOT_ROW_FIELDS.has(field)
   ) : [];
   const pivotValueFields = pivotRowFields.filter(
-    (field) => field !== withResolvedXAxis.pivot?.rowField
+    (field) => field !== pivotRowKey(withResolvedXAxis) && field !== withResolvedXAxis.pivot?.rowField
   );
   const isAggregationOnlyPivot = !String(withResolvedXAxis.pivot?.rowField ?? "").trim() && !String(withResolvedXAxis.pivot?.columnField ?? "").trim();
   const yAxisFormatByField = new Map(
@@ -63668,7 +63821,7 @@ function normalizePivotChartForDisplay(chart, resolveTableLabel) {
   const normalizedPivotColumns = pivotColumnFields.length > 0 ? pivotColumnFields.map((field) => {
     const knownColumn = knownColumnsByField.get(field);
     const yAxis = yAxisFields.find((axis) => axis.field === field);
-    const format9 = yAxis?.format ?? knownColumn?.format ?? (field === withResolvedXAxis.pivot?.rowField ? isMetricOrGauge ? "string" : withResolvedXAxis.xAxisFormat ?? "string" : yAxisFallbackFormat);
+    const format9 = yAxis?.format ?? knownColumn?.format ?? (field === pivotRowKey(withResolvedXAxis) || field === withResolvedXAxis.pivot?.rowField ? isMetricOrGauge ? "string" : withResolvedXAxis.xAxisFormat ?? "string" : yAxisFallbackFormat);
     return {
       field,
       label: yAxis?.label ?? knownColumn?.label ?? field,
@@ -63681,7 +63834,7 @@ function normalizePivotChartForDisplay(chart, resolveTableLabel) {
     const slotCol = getPivotTableSlotReportColumn(
       pivotTableSlotColumns,
       aggregations,
-      withResolvedXAxis.pivot?.rowField,
+      pivotRowKey(withResolvedXAxis) || withResolvedXAxis.pivot?.rowField,
       col.field
     );
     if (!slotCol) return col;
@@ -63703,9 +63856,7 @@ function normalizePivotChartForDisplay(chart, resolveTableLabel) {
   const normalizedXAxisFormat = normalizedXAxisField === withResolvedXAxis.xAxisField ? withResolvedXAxis.xAxisFormat : yAxisFields.find((axis) => axis.field === normalizedXAxisField)?.format ?? pivotTableDisplayColumns.find(
     (column) => column.field === normalizedXAxisField
   )?.format ?? withResolvedXAxis.xAxisFormat;
-  const pivotDisplayRowField = String(
-    withResolvedXAxis.pivot?.rowField ?? ""
-  ).trim();
+  const pivotDisplayRowField = pivotRowKey(withResolvedXAxis);
   const pivotDisplayRowFieldType = String(
     withResolvedXAxis.pivot?.rowFieldType ?? ""
   ).trim();
@@ -66669,19 +66820,30 @@ function useReport(reportIdArg, options = {}) {
         )
       });
       const diagnostics = globalThis.__QUILL_CACHECAB_DIAGNOSTICS__;
+      const durationMs = performance.now() - startedAt;
+      const outcome = resolution.resolved ? "hit" : "fallback";
       if (Array.isArray(diagnostics)) {
         diagnostics.push({
           reportId: effectiveReportId,
           operation,
-          outcome: resolution.resolved ? "hit" : "fallback",
+          outcome,
           reason: resolution.resolved ? "complete" : resolution.reason,
           details: resolution.resolved ? void 0 : resolution.details,
           snapshotReason: snapshot?.reason ?? "cache_miss",
           forcedIncompleteSnapshot: Boolean(snapshot) && !snapshot?.complete && forceIncompleteCacheCabForParity,
           rowCount: snapshot?.rowCount ?? 0,
-          durationMs: performance.now() - startedAt
+          durationMs
         });
       }
+      profileDashboard("use-report-cachecab", {
+        reportId: effectiveReportId,
+        operation,
+        outcome,
+        reason: resolution.resolved ? "complete" : resolution.reason,
+        snapshotReason: snapshot?.reason ?? "cache_miss",
+        rowCount: snapshot?.rowCount ?? 0,
+        durationMs: Math.round(durationMs * 10) / 10
+      });
       return resolution.resolved ? resolution.report : null;
     },
     [
@@ -67255,9 +67417,15 @@ function useReport(reportIdArg, options = {}) {
             if (alias) localValues[alias] = values;
           }
           if (hasEveryColumn) {
+            profileDashboard("use-report-unique-values-cachecab-hit", {
+              reportId: effectiveReportId
+            });
             return { uniqueValuesByColumn: localValues };
           }
         }
+        profileDashboard("use-report-unique-values-network", {
+          reportId: effectiveReportId
+        });
         const tablesForUniqueValues = filterUniqueValuesRequest.reportBuilderState?.tables?.map(
           (table2) => String(table2?.name ?? "").trim()
         ) ?? filterUniqueValuesRequest.stringColumnsByTable.map((column) => String(column.table ?? "").trim()).filter(Boolean);
@@ -67776,6 +67944,29 @@ function useReport(reportIdArg, options = {}) {
   const initialLoadQuery = useQuery({
     queryKey: initialLoadQueryKey,
     queryFn: createUseFormQueryFn(async (signal) => {
+      const tanstackState = queryClient.getQueryState(initialLoadQueryKey);
+      const dashboardReportQueries = queryClient.getQueryCache().getAll().filter(
+        (query) => queryKeyFamily(query.queryKey) === "quill/dashboard-report"
+      );
+      const matchingDashboardReport = dashboardReportQueries.find(
+        (query) => String(query.queryKey[2] ?? "") === String(effectiveReportId)
+      );
+      profileDashboard("use-report-initial-load-queryfn", {
+        reportId: effectiveReportId,
+        reason: "TanStack ran this queryFn, so useReport/initial-load had no fresh cached data",
+        keyFamily: "useReport/initial-load",
+        status: tanstackState?.status ?? "missing",
+        hasData: tanstackState?.data !== void 0,
+        dataUpdatedAt: tanstackState?.dataUpdatedAt ?? 0,
+        staleTime: 0,
+        dashboardReportQueryCount: dashboardReportQueries.length,
+        matchingDashboardReport: matchingDashboardReport ? {
+          hasData: matchingDashboardReport.state.data !== void 0,
+          status: matchingDashboardReport.state.status,
+          staleTime: matchingDashboardReport.options?.staleTime ?? 0,
+          unusedByUseReport: true
+        } : null
+      });
       let cachedReportBuilderState = initialReportBuilderStateForLoad ?? void 0;
       if (!cachedReportBuilderState) {
         const snapshot = await cacheCab.getReportSnapshot(
@@ -67800,6 +67991,9 @@ function useReport(reportIdArg, options = {}) {
         operation: "initial"
       });
       if (cachedReport) {
+        profileDashboard("use-report-initial-load-served-from-cachecab", {
+          reportId: effectiveReportId
+        });
         return { report: cachedReport };
       }
       const allowReportTaskBootstrap = shouldBootstrapUseFormInitialLoad({
@@ -67814,6 +68008,12 @@ function useReport(reportIdArg, options = {}) {
       const formFiltersBelongToLoadTarget = Boolean(loadTargetId) && sourceReportIdentity === loadTargetId;
       const rulesForLoad = useInMemoryEngines || !formFiltersBelongToLoadTarget ? EMPTY_QUERY_FILTERS : queryFilters;
       const shareInitialRequest = sharedInitialRequestUsedForReportIdRef.current !== effectiveReportId;
+      profileDashboard("use-report-initial-load-network", {
+        reportId: effectiveReportId,
+        path: "loadReportForUseForm",
+        hasCachedReportBuilderState: Boolean(cachedReportBuilderState)
+      });
+      const networkStartedAt = performance.now();
       const loadResult = await loadReportForUseForm({
         reportId: effectiveReportId,
         initialReportBuilderState: initialReportBuilderStateForLoad,
@@ -67833,6 +68033,12 @@ function useReport(reportIdArg, options = {}) {
         rowsOnly: isCreatedReportBootstrapLoad,
         abortSignal: signal
       });
+      profileDashboard("use-report-initial-load-network-done", {
+        reportId: effectiveReportId,
+        durationMs: Math.round(performance.now() - networkStartedAt),
+        hasReport: Boolean(loadResult.report),
+        error: loadResult.error ?? null
+      });
       if (loadResult.report && !loadResult.error) {
         if (allowReportTaskBootstrap) {
           bootstrapReportTaskUsedForInitialLoadRef.current = initialLoadIdentityHash;
@@ -67844,7 +68050,17 @@ function useReport(reportIdArg, options = {}) {
       return loadResult;
     }),
     enabled: Boolean(effectiveReportId) && Boolean(client) && !reportOverride,
-    retry: false
+    retry: false,
+    initialData: () => {
+      const cached = findCachedDashboardReportQuery(
+        queryClient,
+        effectiveReportId
+      );
+      const data = cached?.state.data;
+      return data?.report ? { report: data.report, error: data.error } : void 0;
+    },
+    initialDataUpdatedAt: () => findCachedDashboardReportQuery(queryClient, effectiveReportId)?.state.dataUpdatedAt,
+    staleTime: DASHBOARD_REPORT_STALE_TIME_MS
   });
   const reportNameQueryReportId = String(effectiveReportId ?? "").trim();
   const reportNameQuery = useQuery({
@@ -67895,15 +68111,6 @@ function useReport(reportIdArg, options = {}) {
         const shouldPromoteColumnToRowFromPendingFlag = pendingPromoteColumnToRow && !String(prev.groupRowsBy ?? "").trim();
         const sourceReportBuilderTables = (sourceReport.reportBuilderState?.tables ?? []).filter((table2) => Boolean(String(table2?.name ?? "").trim()));
         const sourceReportBuilderTableNames = sourceReportBuilderTables.map((table2) => table2.name).filter((name2) => Boolean(name2));
-        const sourceQueryColumns = normalizeReportBuilderColumns(
-          sourceReport.reportBuilderState?.columns ?? (sourceReport.columns ?? []).map((column) => ({
-            field: column.field,
-            table: column.table ?? resolveColumnTableFromReportMetadata(
-              sourceReport,
-              column.field
-            )
-          }))
-        );
         const nextQueryFilters = prev.queryFilters.rules.length ? prev.queryFilters : rulesFromReport(sourceReport);
         const pivotAggregationsFromSource = Array.isArray(sourceReport.pivot?.aggregations) ? sourceReport.pivot.aggregations : sourceReport.pivot?.aggregationType ? [
           {
@@ -67970,6 +68177,9 @@ function useReport(reportIdArg, options = {}) {
           tables: tableScopeForDisplayColumns,
           schemaTables: schemaForReportBuilderState
         });
+        const sourceQueryColumns = normalizeReportBuilderColumns(
+          sourceReport.reportBuilderState?.columns?.length ? sourceReport.reportBuilderState.columns : sourceDisplayColumnsFromSchema
+        );
         const savedDisplayColumns = normalizeReportBuilderColumns(
           (sourceReport.columns ?? []).map((column) => ({
             ...column,
@@ -68483,13 +68693,12 @@ function useReport(reportIdArg, options = {}) {
       tables: effectiveReportBuilderState.tables,
       schemaTables: schemaForReportBuilderState
     });
-    const columnsToFetch = allColumnsBySelectedTable.length > 0 ? allColumnsBySelectedTable : effectiveReportBuilderState.columns;
-    if (columnsToFetch.length === 0) {
+    if (allColumnsBySelectedTable.length === 0) {
       return void 0;
     }
     return {
       ...effectiveReportBuilderState,
-      columns: columnsToFetch,
+      columns: allColumnsBySelectedTable,
       pivot: null,
       sort: [],
       limit: null
@@ -68532,6 +68741,29 @@ function useReport(reportIdArg, options = {}) {
     refreshDecision.shouldRefresh,
     queryFilters
   ]);
+  const shouldSkipRedundantPivotTableDataQuery = useMemo33(() => {
+    if (!sourceReport || !pivotState) {
+      return false;
+    }
+    if (tableRefreshVersion !== 0 || pivotRefreshVersion !== 0) {
+      return false;
+    }
+    if (!Array.isArray(sourceReport.rows) || sourceReport.rows.length === 0) {
+      return false;
+    }
+    if (refreshDecision.shouldRefresh) {
+      return false;
+    }
+    const sourceRules = sourceReport.reportBuilderState?.rules ?? EMPTY_QUERY_FILTERS;
+    return stableSerializeForQueryKey(queryFilters) === stableSerializeForQueryKey(sourceRules);
+  }, [
+    sourceReport,
+    pivotState,
+    tableRefreshVersion,
+    pivotRefreshVersion,
+    refreshDecision.shouldRefresh,
+    queryFilters
+  ]);
   const shouldForceTableRefreshFromFilters = !useInMemoryEngines && !pivotState;
   const immediateTableRefreshInput = useMemo33(
     () => ({
@@ -68580,8 +68812,14 @@ function useReport(reportIdArg, options = {}) {
         operation: "table"
       });
       if (cachedReport) {
+        profileDashboard("use-report-table-refresh-cachecab-hit", {
+          reportId: effectiveReportId
+        });
         return { report: cachedReport };
       }
+      profileDashboard("use-report-table-refresh-network", {
+        reportId: effectiveReportId
+      });
       return loadViaReportBuilderState({
         reportId: effectiveReportId,
         reportBuilderState: tableRefreshInput.reportBuilderState,
@@ -69195,7 +69433,8 @@ function useReport(reportIdArg, options = {}) {
     sourceReport
   ]);
   const pivotRefreshQueryEnabled = !reportOverride && pendingPivotRefresh && !shouldSkipPivotRefreshForUnchangedPivot && Boolean(sourceReport) && Boolean(client) && Boolean(effectiveReportBuilderState) && Boolean(nextPivot) && sourceReportMatchesEffectiveReportId;
-  const pivotTableDataRefreshQueryEnabled = !reportOverride && Boolean(sourceReport) && Boolean(client) && Boolean(nextPivot) && Boolean(pivotTableDataReportBuilderState) && !pendingPivotRefresh && sourceReportMatchesEffectiveReportId;
+  const initialLoadSettled = Boolean(reportOverride) || !effectiveReportId || Boolean(client) && !initialLoadQuery.isPending && !initialLoadQuery.isFetching;
+  const pivotTableDataRefreshQueryEnabled = !reportOverride && Boolean(sourceReport) && Boolean(client) && Boolean(nextPivot) && Boolean(pivotTableDataReportBuilderState) && !pendingPivotRefresh && sourceReportMatchesEffectiveReportId && initialLoadSettled && !shouldSkipRedundantPivotTableDataQuery;
   const pivotRefreshQuery = useQuery({
     queryKey: createUseFormPivotRefreshQueryKey({
       reportId: effectiveReportId,
@@ -69309,7 +69548,7 @@ function useReport(reportIdArg, options = {}) {
   const paginationRangeStart = pagination.pageIndex * pagination.pageSize;
   const paginationRangeEnd = paginationRangeStart + pagination.pageSize;
   const pageWithinBaseWindow = paginationRangeEnd <= baseWindowRowsLength || trustedSourceRowCount !== void 0 && trustedSourceRowCount <= baseWindowRowsLength;
-  const tablePageQueryEnabled = !pageWithinBaseWindow && !reportOverride && !useInMemoryEngines && Boolean(client) && Boolean(sourceReport) && Boolean(tablePageReportBuilderState) && sourceReportMatchesEffectiveReportId && !pendingPivotRefresh;
+  const tablePageQueryEnabled = !pageWithinBaseWindow && !reportOverride && !useInMemoryEngines && Boolean(client) && Boolean(sourceReport) && Boolean(tablePageReportBuilderState) && sourceReportMatchesEffectiveReportId && !pendingPivotRefresh && initialLoadSettled;
   const tablePageQuery = useQuery({
     queryKey: createUseFormTablePageQueryKey({
       reportId: effectiveReportId,
@@ -69481,21 +69720,17 @@ function useReport(reportIdArg, options = {}) {
     if (!sourceReport) return void 0;
     const rowsForChart = Array.isArray(sourceReport.rows) ? sourceReport.rows : [];
     const chartPivot = pendingPivotChangesDimensions ? sourceReport.pivot ?? null : nextPivot ?? (!chartPivotHydratedFromSourceRef.current ? sourceReport.pivot ?? null : null);
-    const chartPivotForDisplay = chartPivot && sourceReport.pivotResultRowField && sourceReport.pivotResultSourceRowField === chartPivot.rowField ? {
-      ...chartPivot,
-      rowField: sourceReport.pivotResultRowField
-    } : chartPivot;
-    const rowCountForChart = chartPivotForDisplay ? sourceReport.pivotRowCount ?? (Array.isArray(sourceReport.pivotRows) ? sourceReport.pivotRows.length : sourceReport.rowCount) : useInMemoryEngines ? rowsForChart.length : sourceReport.rowCount;
+    const rowCountForChart = chartPivot ? sourceReport.pivotRowCount ?? (Array.isArray(sourceReport.pivotRows) ? sourceReport.pivotRows.length : sourceReport.rowCount) : useInMemoryEngines ? rowsForChart.length : sourceReport.rowCount;
     const referencedTablesForChart = effectiveReportBuilderState?.tables.map((table2) => table2.name).filter((name2) => Boolean(name2));
     const pivotRowsForChart = Array.isArray(sourceReport.pivotRows) ? sourceReport.pivotRows : void 0;
-    const rowCountForChartResolved = chartPivotForDisplay ? Array.isArray(pivotRowsForChart) ? pivotRowsForChart.length : rowCountForChart : rowCountForChart;
+    const rowCountForChartResolved = chartPivot ? Array.isArray(pivotRowsForChart) ? pivotRowsForChart.length : rowCountForChart : rowCountForChart;
     const chartDataPayload = {
       ...sourceReport,
       rows: rowsForChart,
       rowCount: rowCountForChartResolved,
       chartType: chartType ?? sourceReport.chartType,
       reportBuilderState: effectiveReportBuilderState,
-      pivot: chartPivotForDisplay,
+      pivot: chartPivot,
       referencedTables: referencedTablesForChart && referencedTablesForChart.length > 0 ? referencedTablesForChart : sourceReport.referencedTables,
       pivotRows: pivotRowsForChart,
       pivotColumns: sourceReport.pivotColumns,
@@ -69576,7 +69811,7 @@ function useReport(reportIdArg, options = {}) {
   const xAxisOptions = useMemo33(() => {
     if (!chartAxesBaseChart) return chartAxisOptions;
     const pivot = chartAxesBaseChart.pivot;
-    const pivotRowField = String(pivot?.rowField ?? "").trim();
+    const pivotRowField = pivotRowKey(chartAxesBaseChart);
     const chartType2 = String(chartAxesBaseChart.chartType ?? "").toLowerCase();
     if (pivot && pivotRowField) {
       if (["metric", "gauge"].includes(chartType2)) {
@@ -69697,9 +69932,7 @@ function useReport(reportIdArg, options = {}) {
   const resolvedXAxisField = useMemo33(() => {
     if (!chartAxesBaseChart) return "";
     const chartType2 = String(chartAxesBaseChart.chartType ?? "").toLowerCase();
-    const pivotRowField = String(
-      chartAxesBaseChart.pivot?.rowField ?? ""
-    ).trim();
+    const pivotRowField = pivotRowKey(chartAxesBaseChart);
     if (pivotRowField) {
       const rowColumn = (chartAxesBaseChart.pivotColumns ?? chartAxesBaseChart.columns ?? []).find((col) => String(col.field ?? "").trim() === pivotRowField);
       if (shouldUsePivotRowFieldAsXAxis(
@@ -69835,11 +70068,11 @@ function useReport(reportIdArg, options = {}) {
         columns2 = mergePivotTableDisplayColumnLabelsFromYAxis({
           columns: columns2 ?? baseChart.columns,
           yAxisFields: resolvedYAxisFieldsForDisplay,
-          pivotRowField: String(baseChart.pivot.rowField ?? ""),
+          pivotRowField: pivotRowKey(baseChart),
           xAxisLabel: resolvedXAxisLabel
         });
       } else {
-        const pivotRowField = String(baseChart.pivot.rowField ?? "").trim();
+        const pivotRowField = pivotRowKey(baseChart);
         const pivotLabelByField = new Map(
           (baseChart.pivotColumns ?? []).map((column) => [
             String(column.field ?? "").trim(),
@@ -69904,7 +70137,10 @@ function useReport(reportIdArg, options = {}) {
         const key = String(raw);
         const timestamp = new Date(key).getTime();
         if (Number.isNaN(timestamp)) continue;
-        labelsByRaw.set(key, String(record[rowField] ?? key));
+        labelsByRaw.set(
+          key,
+          String(record[pivotRowKey(chart)] ?? record[rowField] ?? key)
+        );
         const cachedMin = pivotDateFilterRangeCacheRef.current.min;
         const cachedMax = pivotDateFilterRangeCacheRef.current.max;
         if (cachedMin == null || timestamp < new Date(cachedMin).getTime()) {
@@ -70205,9 +70441,7 @@ function useReport(reportIdArg, options = {}) {
       sourceReport,
       includeSelectedSchemaFallback: tableColumnsEditedSignature !== null
     });
-    const pivotRowFieldForTable = String(
-      sourceReport?.pivot?.rowField ?? ""
-    ).trim();
+    const pivotRowFieldForTable = pivotRowKey(sourceReport);
     const pivotRowTableUsesAxisFormat = chartAxisEdits.xAxisFormat !== void 0;
     const columns2 = String(chartType ?? "").toLowerCase() === "table" && sourceReport?.pivot && pivotRowFieldForTable && String(resolvedXAxisField ?? "").trim() === pivotRowFieldForTable ? mergedFromReport.map(
       (column) => column.field === pivotRowFieldForTable ? {
@@ -70219,7 +70453,7 @@ function useReport(reportIdArg, options = {}) {
     const pivotLabeledColumns = String(chartType ?? "").toLowerCase() === "table" && sourceReport?.pivot ? mergePivotTableDisplayColumnLabelsFromYAxis({
       columns: columns2,
       yAxisFields: resolvedYAxisFieldsForDisplay,
-      pivotRowField: String(sourceReport.pivot.rowField ?? ""),
+      pivotRowField: pivotRowKey(sourceReport),
       xAxisLabel: resolvedXAxisLabel
     }) ?? columns2 : columns2;
     const tableColumnsWithPivotDisplayLabels = pivotLabeledColumns.map(
@@ -70468,7 +70702,7 @@ function useReport(reportIdArg, options = {}) {
       if (slotFormatting) {
         const aggregations = slotFormatting.aggregations;
         const hasMultiple = aggregations.length > 1;
-        const rowField = String(pivotState?.rowField ?? "").trim();
+        const rowField = pivotRowKey(chart);
         const firstValueColumnFormat = String(
           (chart.columns ?? []).find(
             (c) => String(c.field ?? "").trim() !== rowField
@@ -70504,9 +70738,7 @@ function useReport(reportIdArg, options = {}) {
         }
       }
     }
-    const pivotRowFieldForSettings = String(
-      chart?.pivot?.rowField ?? ""
-    ).trim();
+    const pivotRowFieldForSettings = pivotRowKey(chart);
     const rowAxisLabel = String(resolvedXAxisLabel ?? "").trim();
     for (const columnId of activeTableColumnIds) {
       const option = columnOptionById.get(columnId);
@@ -70566,7 +70798,7 @@ function useReport(reportIdArg, options = {}) {
     tableColumnSettingsCoalesceRef.current = new Map(tableColumnSettingsById);
   }, [tableColumnSettingsById]);
   const tableColumnItems = useMemo33(() => {
-    const pivotRowFieldForFormat = String(chart?.pivot?.rowField ?? "").trim();
+    const pivotRowFieldForFormat = pivotRowKey(chart);
     const pivotRowFieldType = String(chart?.pivot?.rowFieldType ?? "").trim();
     const items = activeTableColumnIds.map((columnId) => {
       const option = columnOptionById.get(columnId);
@@ -70605,7 +70837,7 @@ function useReport(reportIdArg, options = {}) {
     return new Map(tableColumnItems.map((item) => [item.id, item]));
   }, [tableColumnItems]);
   const tableColumnValues = useMemo33(() => {
-    const pivotRowFieldForFormat = String(chart?.pivot?.rowField ?? "").trim();
+    const pivotRowFieldForFormat = pivotRowKey(chart);
     const pivotRowFieldType = String(chart?.pivot?.rowFieldType ?? "").trim();
     return tableColumnItems.map((item) => {
       const coerced = coerceTableColumnFormatToAxisValue(item.format);
@@ -70626,8 +70858,89 @@ function useReport(reportIdArg, options = {}) {
   const initialLoadInProgress = !reportOverride && Boolean(effectiveReportId) && (!client || initialLoadQuery.isPending || initialLoadQuery.isFetching);
   const filterUniqueValuesLoading = filterUniqueValuesEnabled && (filterUniqueValuesQuery.isPending || filterUniqueValuesQuery.isFetching);
   const chartLoading = initialLoadInProgress || pendingPivotRefresh || (Boolean(nextPivot) ? pivotRefreshQuery.isFetching : tableRefreshQuery.isFetching);
-  const tableLoading = initialLoadInProgress || pendingPivotRefresh || tablePageFetching || (Boolean(nextPivot) ? pivotTableDataRefreshQuery.isFetching : tableRefreshQuery.isFetching);
+  const awaitingPivotDetailRows = Boolean(nextPivot || sourceReport?.pivot) && !reportOverride && Boolean(sourceReport) && sourceReportMatchesEffectiveReportId && (!Array.isArray(sourceReport?.rows) || sourceReport.rows.length === 0) && pivotTableDataRefreshQuery.status !== "error";
+  const tableLoading = initialLoadInProgress || pendingPivotRefresh || awaitingPivotDetailRows || tablePageFetching && pagination.pageIndex > 0 || (Boolean(nextPivot) ? pivotTableDataRefreshQuery.isFetching : tableRefreshQuery.isFetching);
   const loading = chartLoading || tableLoading;
+  const lastUseReportLoadingLogRef = useRef24("");
+  useEffect33(() => {
+    const snapshot = {
+      reportId: effectiveReportId,
+      chartLoading,
+      tableLoading,
+      loading,
+      initialLoadInProgress,
+      initialLoad: {
+        status: initialLoadQuery.status,
+        fetchStatus: initialLoadQuery.fetchStatus,
+        isPending: initialLoadQuery.isPending,
+        isFetching: initialLoadQuery.isFetching,
+        hasData: initialLoadQuery.data !== void 0,
+        dataUpdatedAt: initialLoadQuery.dataUpdatedAt,
+        staleTime: 0
+      },
+      pendingPivotRefresh,
+      pivotRefresh: {
+        enabled: pivotRefreshQueryEnabled,
+        isFetching: pivotRefreshQuery.isFetching
+      },
+      tableRefresh: {
+        enabled: tableRefreshQueryEnabled,
+        isFetching: tableRefreshQuery.isFetching
+      },
+      pivotTableData: {
+        enabled: pivotTableDataRefreshQueryEnabled,
+        isFetching: pivotTableDataRefreshQuery.isFetching
+      },
+      tablePage: {
+        enabled: tablePageQueryEnabled,
+        isFetching: tablePageQuery.isFetching
+      },
+      uniqueValues: {
+        enabled: filterUniqueValuesEnabled,
+        isFetching: filterUniqueValuesQuery.isFetching,
+        isPending: filterUniqueValuesQuery.isPending
+      },
+      whyChartLoading: {
+        noClient: !client,
+        initialPending: initialLoadQuery.isPending,
+        initialFetching: initialLoadQuery.isFetching,
+        pendingPivotRefresh,
+        pivotRefreshFetching: Boolean(nextPivot) && pivotRefreshQuery.isFetching,
+        tableRefreshFetching: !nextPivot && tableRefreshQuery.isFetching
+      }
+    };
+    const serialized = JSON.stringify(snapshot);
+    if (serialized === lastUseReportLoadingLogRef.current) return;
+    lastUseReportLoadingLogRef.current = serialized;
+    profileDashboard("use-report-loading", snapshot);
+  }, [
+    client,
+    chartLoading,
+    effectiveReportId,
+    filterUniqueValuesEnabled,
+    filterUniqueValuesQuery.fetchStatus,
+    filterUniqueValuesQuery.isFetching,
+    filterUniqueValuesQuery.isPending,
+    initialLoadInProgress,
+    initialLoadQuery.data,
+    initialLoadQuery.dataUpdatedAt,
+    initialLoadQuery.fetchStatus,
+    initialLoadQuery.isFetching,
+    initialLoadQuery.isPending,
+    initialLoadQuery.status,
+    loading,
+    nextPivot,
+    pendingPivotRefresh,
+    pivotRefreshQuery.isFetching,
+    pivotRefreshQueryEnabled,
+    pivotTableDataRefreshQuery.isFetching,
+    pivotTableDataRefreshQueryEnabled,
+    tableLoading,
+    tablePageQuery.isFetching,
+    tablePageQueryEnabled,
+    tableRefreshQuery.isFetching,
+    tableRefreshQueryEnabled
+  ]);
   const buildSetReportColumnsFromIds = (nextColumnIds, settingsById) => {
     const normalizedNextIds = nextColumnIds.map((columnId) => String(columnId ?? "").trim()).filter(Boolean);
     return normalizedNextIds.map((columnId) => {
@@ -70667,7 +70980,7 @@ function useReport(reportIdArg, options = {}) {
       const option = columnOptionById.get(normalizedId);
       const pivotField = String(option?.field ?? normalizedId).trim();
       const pivotModel = chartAxesBaseChart.pivot;
-      const rowField = String(pivotModel?.rowField ?? "").trim();
+      const rowField = pivotRowKey(chartAxesBaseChart);
       if (!pivotModel) return null;
       const isPivotRowColumn = Boolean(
         pivotField && rowField && pivotField === rowField