drizzle-cube 0.10.0 → 0.11.0

package/dist/client/providers.js

@@ -1,3 +1,3 @@
 import { n as e, t } from "./chunks/providers-DwQCKdGW.js";
-import { U as n, c as r, s as i } from "./chunks/chart-data-table-BdMo3zVh.js";
+import { U as n, c as r, s as i } from "./chunks/chart-data-table-Cxd0cdAl.js";
 export { i as CubeProvider, t as ScrollContainerProvider, n as createCubeClient, r as useCubeContext, e as useScrollContainer };

package/dist/client/schema.js

@@ -1,2 +1,2 @@
-import { t as e } from "./chunks/schema-visualization-BbvL74Sf.js";
+import { t as e } from "./chunks/schema-visualization-MlRrcJQH.js";
 export { e as SchemaVisualization };

package/dist/client/types.d.ts

@@ -19,6 +19,8 @@ export interface CubeMetaDimension {
     type: string;
     /** Supported granularities for time dimensions (for time-based drill-down) */
     granularities?: TimeGranularity[];
+    /** The cube time dimension's gap-filling default, when it declares one */
+    fillMissingDates?: boolean;
 }
 export interface CubeMetaField {
     name: string;
@@ -146,6 +148,7 @@ export interface ChartDisplayConfig {
     stacked?: boolean;
     stackType?: 'none' | 'normal' | 'percent';
     connectNulls?: boolean;
+    fillMissingDates?: boolean | 'auto';
     showSummary?: boolean;
     showPoints?: boolean;
     showAllXLabels?: boolean;

package/dist/client/utils/filterUtils.d.ts

@@ -43,6 +43,21 @@ export declare function shouldIncludeFilter(filter: Filter): boolean;
  * @returns Array of filters that should be applied to the portlet
  */
 export declare function getApplicableDashboardFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): Filter[];
+/**
+ * Whether a dashboard filter is applied to a portlet as a regular filter.
+ *
+ * Non-universal filters always are. A universal time filter normally reaches a
+ * portlet through its timeDimensions, but when the portlet's mapping pins it to
+ * a field (a member override) it becomes a plain inDateRange filter on that
+ * field - which is how a KPI or breakdown without time dimensions is narrowed
+ * by the dashboard date control.
+ */
+export declare function isAppliedAsRegularFilter(dashboardFilter: DashboardFilter, filterMapping: DashboardFilterMapping | undefined): boolean;
+/**
+ * Dashboard filters that reach a portlet through its `filters` (as opposed to
+ * universal time filters applied to its timeDimensions).
+ */
+export declare function getRegularDashboardFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): DashboardFilter[] | undefined;
 /**
  * Filter format for merge operation:
  * - 'server': Returns {and: [...]} or {or: [...]} format (for API queries)
@@ -94,6 +109,21 @@ type TimeDimension = {
     granularity?: string;
     dateRange?: string[] | string;
 };
+/**
+ * Universal time filters mapped to a portlet that apply through its
+ * timeDimensions - i.e. mapped without a member override.
+ */
+export declare function getTimeDimensionUniversalFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): DashboardFilter[];
+/**
+ * Universal time filters mapped to a portlet that cannot narrow it: they apply
+ * only through timeDimensions, but some query in the portlet has none. Such a
+ * portlet would otherwise silently render all-time values while the dashboard
+ * date control shows a narrower range.
+ *
+ * Only plain and multi-query portlets are checked; funnel, flow and retention
+ * queries handle dashboard time filters separately.
+ */
+export declare function getUnreachableUniversalTimeFilters(query: string, dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): DashboardFilter[];
 /**
  * Apply universal time filters to a portlet's timeDimensions
  * Universal time filters apply their dateRange to ALL time dimensions in the portlet

package/dist/client/utils/gapFilling.d.ts

@@ -0,0 +1,52 @@
+import { CubeResultSet } from '../types.js';
+/** A chart's gap-filling preference. */
+export interface ChartGapFillOptions {
+    /** `true`/`false` force filling on/off; `'auto'` or unset defers to the query and cube. */
+    fillMissingDates?: boolean | 'auto';
+}
+/** A time dimension of the query a result came from. */
+export interface ChartGapFillTimeDimension {
+    dimension: string;
+    granularity?: string;
+    dateRange?: string | string[];
+    fillMissingDates?: boolean;
+    compareDateRange?: readonly unknown[];
+}
+/** The parts of a query chart gap filling reads. */
+export interface ChartGapFillQuery {
+    measures?: readonly string[];
+    dimensions?: readonly string[];
+    timeDimensions?: readonly ChartGapFillTimeDimension[];
+    filters?: readonly ChartGapFillFilter[];
+    fillMissingDatesValue?: number | null;
+    ungrouped?: boolean;
+}
+interface ChartGapFillFilter {
+    member?: string;
+    operator?: string;
+    values?: readonly unknown[];
+    dateRange?: string | string[];
+    and?: readonly ChartGapFillFilter[];
+    or?: readonly ChartGapFillFilter[];
+}
+interface TimeDimensionAnnotation {
+    fillMissingDates?: boolean;
+}
+/**
+ * Fill missing time buckets in result rows for a chart.
+ *
+ * Comparison (`compareDateRange`) dimensions are left alone — the server fills
+ * each period already and the rows carry period metadata. Ungrouped queries are
+ * never filled.
+ */
+export declare function fillChartRows(rows: Record<string, unknown>[], query: ChartGapFillQuery, annotation: {
+    timeDimensions?: Record<string, TimeDimensionAnnotation>;
+} | undefined, options?: ChartGapFillOptions): Record<string, unknown>[];
+/**
+ * Wrap a result set so its rows are gap-filled for a chart. The underlying
+ * result set (and the query cache holding it) stays raw, so changing the chart
+ * setting never refetches. Returns the result set unchanged when it does not
+ * carry the query it came from.
+ */
+export declare function withChartGapFilling(resultSet: CubeResultSet, options?: ChartGapFillOptions): CubeResultSet;
+export {};

package/dist/client/utils/index.d.ts

@@ -6,6 +6,7 @@ export * from './periodUtils.js';
 export * from './pivotUtils.js';
 export * from './syntaxHighlighting.js';
 export * from './comparisonUtils.js';
+export * from './gapFilling.js';
 export { captureThumbnail, isThumbnailCaptureAvailable } from './thumbnail.js';
 export { exportPortletToXlsx, isExportAvailable } from './exportXlsx.js';
 export { createDashboardExport, serializeDashboardExport, parseDashboardExport, readDashboardExportFile, downloadDashboardExport, dashboardExportFilename, normalizeDashboardConfigForExport, } from './dashboardExport.js';

package/dist/client/utils/joinReachability.d.ts

@@ -24,4 +24,5 @@ export interface ReachableDimensionGroup {
  */
 export declare function getReachableDimensionOptions(meta: CubeMeta | null, portlet: PortletConfig, options?: {
     sameTypeAs?: string;
+    type?: string;
 }): ReachableDimensionGroup[];

package/dist/client/utils.js

@@ -1,17 +1,18 @@
-import { C as e, L as t, M as n, P as r, a as i, i as ee, j as a, o, r as s } from "./chunks/chart-data-table-BdMo3zVh.js";
+import { C as e, L as t, M as n, P as r, a as i, i as ee, j as a, o, r as s } from "./chunks/chart-data-table-Cxd0cdAl.js";
 import { a as c, c as l, d as u, f as d, i as f, l as p, n as m, o as h, r as g, s as _, t as v, u as y } from "./chunks/dashboardExport-Db3rmUP1.js";
-import { A as b, C as x, D as S, E as C, M as w, N as T, O as E, T as D, c as O, d as te, f as k, j as A, k as j, l as M, s as N, u as P, w as F } from "./chunks/chart-activity-grid-DGazwi4C.js";
-import { B as I, F as L, I as R, L as z, N as B, P as V, R as H, V as U, z as W } from "./chunks/chart-area-zyLGD-ym.js";
-import { _ as G, g as K, h as q, m as J } from "./chunks/chart-kpi-delta-C84P-mwu.js";
-import { a as Y, i as X, n as Z, o as Q, r as ne, s as re, t as ie } from "./chunks/utils-CToHkuhU.js";
+import { A as b, C as x, D as S, E as C, M as w, N as T, O as E, T as D, c as O, d as k, f as A, j, k as M, l as te, s as N, u as P, w as F } from "./chunks/chart-activity-grid-Ly_-2B-f.js";
+import { n as I, t as L } from "./chunks/gapFilling-DKBRHcQL.js";
+import { B as R, F as z, I as B, L as V, N as H, P as U, R as W, V as G, z as K } from "./chunks/chart-area-D3l-71Wy.js";
+import { _ as q, g as J, h as Y, m as X } from "./chunks/chart-kpi-delta-DndbqdZT.js";
+import { a as Z, i as Q, n as ne, o as re, r as ie, s as ae, t as oe } from "./chunks/utils-CToHkuhU.js";
 import "react";
 import { jsx as $ } from "react/jsx-runtime";
 //#region src/client/utils/measureIcons.tsx
-function ae(t, n = "w-4 h-4") {
+function se(t, n = "w-4 h-4") {
 	let r = e(t);
 	return /* @__PURE__ */ $(r, { className: n });
 }
-function oe() {
+function ce() {
 	let t = [
 		"count",
 		"countDistinct",
@@ -31,6 +32,6 @@ function oe() {
 	return n;
 }
 //#endregion
-export { N as CHART_COLORS, O as CHART_COLORS_GRADIENT, M as CHART_MARGINS, P as NEGATIVE_COLOR, te as POSITIVE_COLOR, k as RESPONSIVE_CHART_MARGINS, r as captureThumbnail, x as createAxisTickFormatter, v as createDashboardExport, ie as createDashboardLayout, Z as createSamplePortlet, m as dashboardExportFilename, g as downloadDashboardExport, a as exportPortletToXlsx, J as filterIncompletePeriod, ne as findNextPosition, F as formatAxisValue, X as formatChartData, D as formatNumericValue, B as formatPeriodDayIndex, C as formatTimeValue, V as generatePeriodShortLabel, Y as generatePortletId, Q as generateResponsiveLayouts, oe as getAllMeasureIcons, S as getFieldGranularity, E as getFieldLabel, ae as getMeasureIcon, s as getMeasureType, ee as getOrderedColumnsFromQuery, q as getPeriodEndDate, L as getPeriodIndices, R as getPeriodLabels, z as getPriorPeriodStrokeDashArray, K as getQueryGranularity, l as getSyntaxHighlighter, i as hasTimeDimensionForPivot, p as highlightCodeBlock, y as highlightCodeBlocks, H as isComparisonData, n as isExportAvailable, G as isLastPeriodComplete, W as isPriorPeriodSeries, u as isSyntaxHighlightingAvailable, t as isThumbnailCaptureAvailable, j as isValidNumericValue, d as loadSyntaxHighlighter, f as normalizeDashboardConfigForExport, c as parseDashboardExport, b as parseNumericValue, o as pivotTableData, h as readDashboardExportFile, _ as serializeDashboardExport, A as transformChartData, w as transformChartDataWithSeries, I as transformForOverlayMode, U as transformForSeparateMode, T as transformSeriesKeysWithLabels, re as validateCubeQuery };
+export { N as CHART_COLORS, O as CHART_COLORS_GRADIENT, te as CHART_MARGINS, P as NEGATIVE_COLOR, k as POSITIVE_COLOR, A as RESPONSIVE_CHART_MARGINS, r as captureThumbnail, x as createAxisTickFormatter, v as createDashboardExport, oe as createDashboardLayout, ne as createSamplePortlet, m as dashboardExportFilename, g as downloadDashboardExport, a as exportPortletToXlsx, L as fillChartRows, X as filterIncompletePeriod, ie as findNextPosition, F as formatAxisValue, Q as formatChartData, D as formatNumericValue, H as formatPeriodDayIndex, C as formatTimeValue, U as generatePeriodShortLabel, Z as generatePortletId, re as generateResponsiveLayouts, ce as getAllMeasureIcons, S as getFieldGranularity, E as getFieldLabel, se as getMeasureIcon, s as getMeasureType, ee as getOrderedColumnsFromQuery, Y as getPeriodEndDate, z as getPeriodIndices, B as getPeriodLabels, V as getPriorPeriodStrokeDashArray, J as getQueryGranularity, l as getSyntaxHighlighter, i as hasTimeDimensionForPivot, p as highlightCodeBlock, y as highlightCodeBlocks, W as isComparisonData, n as isExportAvailable, q as isLastPeriodComplete, K as isPriorPeriodSeries, u as isSyntaxHighlightingAvailable, t as isThumbnailCaptureAvailable, M as isValidNumericValue, d as loadSyntaxHighlighter, f as normalizeDashboardConfigForExport, c as parseDashboardExport, b as parseNumericValue, o as pivotTableData, h as readDashboardExportFile, _ as serializeDashboardExport, j as transformChartData, w as transformChartDataWithSeries, R as transformForOverlayMode, G as transformForSeparateMode, T as transformSeriesKeysWithLabels, ae as validateCubeQuery, I as withChartGapFilling };
 
 //# sourceMappingURL=utils.js.map

package/dist/client/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["getMeasureTypeIcon","isThumbnailCaptureAvailable","isExportAvailable","captureThumbnail","hasTimeDimensionForPivot","getOrderedColumnsFromQuery","exportPortletToXlsx","getMeasureType","parseDashboardExport","getSyntaxHighlighter","isSyntaxHighlightingAvailable","loadSyntaxHighlighter","normalizeDashboardConfigForExport","highlightCodeBlock","dashboardExportFilename","readDashboardExportFile","downloadDashboardExport","serializeDashboardExport","createDashboardExport","highlightCodeBlocks","parseNumericValue","createAxisTickFormatter","getFieldGranularity","formatTimeValue","transformChartDataWithSeries","transformSeriesKeysWithLabels","getFieldLabel","formatNumericValue","CHART_COLORS_GRADIENT","POSITIVE_COLOR","RESPONSIVE_CHART_MARGINS","transformChartData","isValidNumericValue","CHART_MARGINS","CHART_COLORS","NEGATIVE_COLOR","formatAxisValue","transformForOverlayMode","getPeriodIndices","getPeriodLabels","getPriorPeriodStrokeDashArray","formatPeriodDayIndex","generatePeriodShortLabel","isComparisonData","transformForSeparateMode","isPriorPeriodSeries","isLastPeriodComplete","getQueryGranularity","getPeriodEndDate","filterIncompletePeriod","generatePortletId","formatChartData","createSamplePortlet","generateResponsiveLayouts","findNextPosition","validateCubeQuery","createDashboardLayout","getMeasureIcon","IconComponent","measureType","getAllMeasureIcons","types","icons","type","pivotTableData"],"sources":["../../src/client/utils/measureIcons.tsx"],"sourcesContent":["import React from 'react'\nimport { getMeasureTypeIcon } from '../icons/index.js'\n\n/**\n * Get the appropriate icon component for a given measure type\n * All icons use amber coloring for consistency\n */\nexport function getMeasureIcon(\n  measureType: string | undefined,\n  className: string = 'w-4 h-4'\n): React.ReactElement {\n  const IconComponent = getMeasureTypeIcon(measureType)\n  return <IconComponent className={className} />\n}\n\n/**\n * Get all available measure type icons\n * Useful for documentation or UI that shows all measure types\n */\nexport function getAllMeasureIcons(): Record<string, React.ReactElement> {\n  const types = ['count', 'countDistinct', 'countDistinctApprox', 'sum', 'avg', 'min', 'max', 'runningTotal', 'calculated', 'number']\n  const icons: Record<string, React.ReactElement> = {}\n\n  for (const type of types) {\n    const IconComponent = getMeasureTypeIcon(type)\n    icons[type] = <IconComponent className=\"dc:w-4 dc:h-4\" />\n  }\n\n  return icons\n}\n"],"mappings":";;;;;;;;;AAOA,SAAgByD,GACd,GACA,IAAoB,WACA;CACpB,IAAMC,IAAgB1D,EAAmB2D,CAAW;CACpD,OAAO,kBAACD,GAAD,EAA0B,aAAY,CAAA;AAC/C;AAMA,SAAgBE,KAAyD;CACvE,IAAMC,IAAQ;EAAC;EAAS;EAAiB;EAAuB;EAAO;EAAO;EAAO;EAAO;EAAgB;EAAc;CAAQ,GAC5HC,IAA4C,CAAC;CAEnD,KAAK,IAAMC,KAAQF,GAAO;EACxB,IAAMH,IAAgB1D,EAAmB+D,CAAI;EAC7C,EAAMA,KAAQ,kBAACL,GAAD,EAAe,WAAU,gBAAiB,CAAA;CAC1D;CAEA,OAAOI;AACT"}
+{"version":3,"file":"utils.js","names":["getMeasureTypeIcon","isThumbnailCaptureAvailable","isExportAvailable","captureThumbnail","hasTimeDimensionForPivot","getOrderedColumnsFromQuery","exportPortletToXlsx","getMeasureType","parseDashboardExport","getSyntaxHighlighter","isSyntaxHighlightingAvailable","loadSyntaxHighlighter","normalizeDashboardConfigForExport","highlightCodeBlock","dashboardExportFilename","readDashboardExportFile","downloadDashboardExport","serializeDashboardExport","createDashboardExport","highlightCodeBlocks","parseNumericValue","createAxisTickFormatter","getFieldGranularity","formatTimeValue","transformChartDataWithSeries","transformSeriesKeysWithLabels","getFieldLabel","formatNumericValue","CHART_COLORS_GRADIENT","POSITIVE_COLOR","RESPONSIVE_CHART_MARGINS","isValidNumericValue","CHART_MARGINS","CHART_COLORS","NEGATIVE_COLOR","formatAxisValue","withChartGapFilling","fillChartRows","transformForOverlayMode","getPeriodIndices","getPeriodLabels","getPriorPeriodStrokeDashArray","formatPeriodDayIndex","generatePeriodShortLabel","isComparisonData","transformForSeparateMode","isPriorPeriodSeries","isLastPeriodComplete","getQueryGranularity","getPeriodEndDate","filterIncompletePeriod","generatePortletId","formatChartData","createSamplePortlet","generateResponsiveLayouts","findNextPosition","validateCubeQuery","createDashboardLayout","getMeasureIcon","IconComponent","measureType","getAllMeasureIcons","types","icons","type","pivotTableData","transformChartData"],"sources":["../../src/client/utils/measureIcons.tsx"],"sourcesContent":["import React from 'react'\nimport { getMeasureTypeIcon } from '../icons/index.js'\n\n/**\n * Get the appropriate icon component for a given measure type\n * All icons use amber coloring for consistency\n */\nexport function getMeasureIcon(\n  measureType: string | undefined,\n  className: string = 'w-4 h-4'\n): React.ReactElement {\n  const IconComponent = getMeasureTypeIcon(measureType)\n  return <IconComponent className={className} />\n}\n\n/**\n * Get all available measure type icons\n * Useful for documentation or UI that shows all measure types\n */\nexport function getAllMeasureIcons(): Record<string, React.ReactElement> {\n  const types = ['count', 'countDistinct', 'countDistinctApprox', 'sum', 'avg', 'min', 'max', 'runningTotal', 'calculated', 'number']\n  const icons: Record<string, React.ReactElement> = {}\n\n  for (const type of types) {\n    const IconComponent = getMeasureTypeIcon(type)\n    icons[type] = <IconComponent className=\"dc:w-4 dc:h-4\" />\n  }\n\n  return icons\n}\n"],"mappings":";;;;;;;;;;AAOA,SAAgB0D,GACd,GACA,IAAoB,WACA;CACpB,IAAMC,IAAgB3D,EAAmB4D,CAAW;CACpD,OAAO,kBAACD,GAAD,EAA0B,aAAY,CAAA;AAC/C;AAMA,SAAgBE,KAAyD;CACvE,IAAMC,IAAQ;EAAC;EAAS;EAAiB;EAAuB;EAAO;EAAO;EAAO;EAAO;EAAgB;EAAc;CAAQ,GAC5HC,IAA4C,CAAC;CAEnD,KAAK,IAAMC,KAAQF,GAAO;EACxB,IAAMH,IAAgB3D,EAAmBgE,CAAI;EAC7C,EAAMA,KAAQ,kBAACL,GAAD,EAAe,WAAU,gBAAiB,CAAA;CAC1D;CAEA,OAAOI;AACT"}