drizzle-cube 0.5.7 → 0.6.0

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

@@ -0,0 +1,32 @@
+import { AxisFormatConfig } from '../types';
+/**
+ * Get the currency code for a given locale.
+ * Maps common locales to their default currency.
+ */
+export declare function getCurrencyCodeForLocale(locale: string): string;
+/**
+ * Abbreviation result: the (possibly scaled) display value and its suffix.
+ */
+export interface AbbreviatedValue {
+    displayValue: number;
+    abbreviationSuffix: string;
+}
+/**
+ * Scale a number to a K/M/B abbreviation when `abbreviate` is enabled.
+ */
+export declare function abbreviateValue(num: number, abbreviate: boolean): AbbreviatedValue;
+/**
+ * Resolved formatting parameters shared by the per-unit formatters.
+ */
+export interface AxisFormatParams {
+    displayValue: number;
+    abbreviate: boolean;
+    abbreviationSuffix: string;
+    decimals: number;
+    locale: string;
+    config: AxisFormatConfig;
+}
+/**
+ * Format an abbreviated/scaled value according to its configured unit type.
+ */
+export declare function formatByUnit(params: AxisFormatParams): string;

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

@@ -1,4 +1,4 @@
-import { CubeQuery, CubeMeta, CubeMetaHierarchy, TimeGranularity, DashboardFilter } from '../types';
+import { CubeQuery, CubeMeta, CubeMetaHierarchy, TimeGranularity, DashboardFilter, DashboardFilterMapping } from '../types';
 import { DrillOption, DrillResult, ChartDataPointClickEvent } from '../types/drill';
 /**
  * Check if a dimension is a time dimension based on metadata
@@ -34,7 +34,7 @@ export declare function findHierarchyForDimension(dimensionName: string, metadat
 /**
  * Build drill options for a clicked data point
  */
-export declare function buildDrillOptions(event: ChartDataPointClickEvent, query: CubeQuery, metadata: CubeMeta | null, dashboardFilters?: DashboardFilter[], dashboardFilterMapping?: string[]): DrillOption[];
+export declare function buildDrillOptions(event: ChartDataPointClickEvent, query: CubeQuery, metadata: CubeMeta | null, dashboardFilters?: DashboardFilter[], dashboardFilterMapping?: DashboardFilterMapping): DrillOption[];
 /**
  * Build a drill query based on the selected option
  */

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

@@ -1,4 +1,28 @@
-import { Filter, DashboardFilter, CubeMeta, DashboardConfig } from '../types';
+import { Filter, DashboardFilter, DashboardFilterMapping, DashboardFilterMappingEntry, CubeMeta, DashboardConfig } from '../types';
+/**
+ * Normalize a portlet filter mapping to entry objects.
+ * Plain string entries (the legacy format) become { filterId } with no override.
+ */
+export declare function normalizeFilterMapping(mapping: DashboardFilterMapping | undefined): DashboardFilterMappingEntry[];
+/**
+ * Serialize mapping entries for storage.
+ * Entries without a member override collapse back to plain strings so saved
+ * configs only change shape when an override is actually used.
+ */
+export declare function serializeFilterMapping(entries: DashboardFilterMappingEntry[]): DashboardFilterMapping;
+/**
+ * Check whether a mapping (either format) includes a given dashboard filter
+ */
+export declare function mappingIncludesFilter(mapping: DashboardFilterMapping | undefined, filterId: string): boolean;
+/**
+ * Get the per-portlet member override for a dashboard filter, if any
+ */
+export declare function getMappingMemberOverride(mapping: DashboardFilterMapping | undefined, filterId: string): string | undefined;
+/**
+ * Clone a filter with its member rewritten to the override field.
+ * Only SimpleFilters can be rewritten; GroupFilters pass through unchanged.
+ */
+export declare function applyMemberOverride(filter: Filter, member?: string): Filter;
 /**
  * Check if a filter should be included in the query (has valid values or doesn't require values)
  * @param filter - The filter to check
@@ -8,11 +32,15 @@ export declare function shouldIncludeFilter(filter: Filter): boolean;
 /**
  * Get dashboard filters that should be applied to a portlet based on its mapping configuration
  *
+ * Mapping entries may carry a per-portlet member override, in which case the
+ * filter is applied with its member rewritten to the override field (operator
+ * and values stay shared across all portlets).
+ *
  * @param dashboardFilters - All available dashboard filters
- * @param filterMapping - Array of filter IDs that apply to this portlet
+ * @param filterMapping - The portlet's filter mapping (filter IDs or entries with member overrides)
  * @returns Array of filters that should be applied to the portlet
  */
-export declare function getApplicableDashboardFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: string[] | undefined): Filter[];
+export declare function getApplicableDashboardFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined): Filter[];
 /**
  * Filter format for merge operation:
  * - 'server': Returns {and: [...]} or {or: [...]} format (for API queries)
@@ -48,7 +76,7 @@ export declare function validateFilterForCube(filter: Filter, cubeMeta: CubeMeta
  * @param cubeMeta - Cube metadata for validation
  * @returns Object with validation result and list of invalid filter IDs
  */
-export declare function validatePortletFilterMapping(dashboardFilters: DashboardFilter[] | undefined, filterMapping: string[] | undefined, cubeMeta: CubeMeta | null): {
+export declare function validatePortletFilterMapping(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined, cubeMeta: CubeMeta | null): {
     isValid: boolean;
     invalidFilterIds: string[];
     missingFilterIds: string[];
@@ -81,5 +109,5 @@ type TimeDimension = {
  * @param portletTimeDimensions - The portlet's existing timeDimensions array
  * @returns Updated timeDimensions array with date ranges applied
  */
-export declare function applyUniversalTimeFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: string[] | undefined, portletTimeDimensions: TimeDimension[] | undefined): TimeDimension[] | undefined;
+export declare function applyUniversalTimeFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: DashboardFilterMapping | undefined, portletTimeDimensions: TimeDimension[] | undefined): TimeDimension[] | undefined;
 export {};

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

@@ -0,0 +1,27 @@
+import { CubeMeta, CubeMetaDimension, PortletConfig } from '../types';
+/**
+ * Compute the set of cubes reachable from the given start cubes via join
+ * relationships. Relationships are treated as undirected, mirroring the
+ * server's bidirectional join resolution. Start cubes are included.
+ */
+export declare function getReachableCubes(meta: CubeMeta | null, startCubes: string[]): Set<string>;
+/**
+ * Get the cube names referenced by a portlet's query (measures, dimensions,
+ * timeDimensions) across single-query, multi-query, and funnel shapes.
+ */
+export declare function getPortletQueryCubes(portlet: PortletConfig): string[];
+export interface ReachableDimensionGroup {
+    cubeName: string;
+    cubeTitle: string;
+    dimensions: CubeMetaDimension[];
+}
+/**
+ * Get the dimensions a dashboard filter can be remapped to for a portlet:
+ * dimensions of join-reachable cubes, grouped by cube. When `sameTypeAs` is a
+ * known dimension, options are restricted to dimensions of the same type
+ * (operator and values are shared across portlets, so the target field must
+ * be type-compatible).
+ */
+export declare function getReachableDimensionOptions(meta: CubeMeta | null, portlet: PortletConfig, options?: {
+    sameTypeAs?: string;
+}): ReachableDimensionGroup[];

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

@@ -0,0 +1,32 @@
+/**
+ * Helpers for `formatTimeValue` — parsing timestamp strings and formatting
+ * them by known or inferred granularity. Split out of chartUtils to keep
+ * each unit small.
+ */
+/**
+ * Components of a parsed UTC timestamp used for granularity formatting.
+ */
+export interface TimestampParts {
+    date: Date;
+    year: number;
+    month: string;
+    day: string;
+    hours: number;
+    minutes: number;
+}
+/**
+ * Parse a timestamp string (ISO or PostgreSQL format) into UTC parts.
+ * Returns null if the string isn't a recognizable timestamp or is invalid.
+ */
+export declare function parseTimestampParts(str: string): TimestampParts | null;
+/**
+ * Format parsed timestamp parts using an explicit granularity.
+ * Returns null for an unknown granularity so the caller can fall back to the
+ * heuristic formatter.
+ */
+export declare function formatByGranularity(parts: TimestampParts, granularity: string): string | null;
+/**
+ * Infer a display string for parsed timestamp parts when no explicit
+ * granularity is known, based on which time components are non-zero.
+ */
+export declare function formatByHeuristic(parts: TimestampParts): string;

package/dist/client/utils.js

@@ -1,6 +1,6 @@
-import { B as e, G as t, H as n, a as r, i, n as a, r as o, z as s } from "./chunks/chart-data-table-Cm5jrpaw.js";
-import { C as c, D as l, E as u, O as d, S as f, T as p, a as m, b as h, i as g, n as _, o as v, r as y, s as b, v as x, w as S, x as C, y as w } from "./chunks/chart-activity-grid-CiHrLH6Y.js";
-import { a as T, c as E, d as D, f as O, i as k, l as A, m as j, n as M, o as N, p as P, r as F, s as I, t as L, u as R } from "./chunks/utils-kqa-JIMg.js";
-import { a as z, i as B, n as V, r as H } from "./chunks/chart-kpi-delta-CxOYD2f1.js";
-import { a as U, c as W, d as G, i as K, l as q, o as J, r as Y, s as X, u as Z } from "./chunks/chart-line-r4iWevKZ.js";
-export { _ as CHART_COLORS, y as CHART_COLORS_GRADIENT, g as CHART_MARGINS, m as NEGATIVE_COLOR, v as POSITIVE_COLOR, b as RESPONSIVE_CHART_MARGINS, n as captureThumbnail, x as createAxisTickFormatter, L as createDashboardLayout, M as createSamplePortlet, s as exportPortletToXlsx, V as filterIncompletePeriod, F as findNextPosition, w as formatAxisValue, k as formatChartData, h as formatNumericValue, Y as formatPeriodDayIndex, C as formatTimeValue, K as generatePeriodShortLabel, T as generatePortletId, N as generateResponsiveLayouts, E as getAllMeasureIcons, f as getFieldGranularity, c as getFieldLabel, A as getMeasureIcon, a as getMeasureType, o as getOrderedColumnsFromQuery, H as getPeriodEndDate, U as getPeriodIndices, J as getPeriodLabels, X as getPriorPeriodStrokeDashArray, B as getQueryGranularity, R as getSyntaxHighlighter, i as hasTimeDimensionForPivot, D as highlightCodeBlock, O as highlightCodeBlocks, W as isComparisonData, e as isExportAvailable, z as isLastPeriodComplete, q as isPriorPeriodSeries, P as isSyntaxHighlightingAvailable, t as isThumbnailCaptureAvailable, S as isValidNumericValue, j as loadSyntaxHighlighter, p as parseNumericValue, r as pivotTableData, u as transformChartData, l as transformChartDataWithSeries, Z as transformForOverlayMode, G as transformForSeparateMode, d as transformSeriesKeysWithLabels, I as validateCubeQuery };
+import { A as e, I as t, N as n, a as r, i, j as a, o, r as s } from "./chunks/chart-data-table-CKauQXme.js";
+import { A as c, C as l, D as u, E as d, M as f, N as p, O as m, T as h, c as g, d as _, f as v, j as y, k as b, l as x, s as S, u as C, w } from "./chunks/chart-activity-grid-DX0SJbxs.js";
+import { A as T, D as E, E as D, M as O, N as k, O as A, P as j, j as M, k as N } from "./chunks/chart-area-of01_62R.js";
+import { a as P, c as F, d as I, f as L, i as R, l as z, m as B, n as V, o as H, p as U, r as W, s as G, t as K, u as q } from "./chunks/utils-3P6z1vz5.js";
+import { g as J, h as Y, m as X, p as Z } from "./chunks/chart-kpi-delta-Dn-jjO-2.js";
+export { S as CHART_COLORS, g as CHART_COLORS_GRADIENT, x as CHART_MARGINS, C as NEGATIVE_COLOR, _ as POSITIVE_COLOR, v as RESPONSIVE_CHART_MARGINS, n as captureThumbnail, l as createAxisTickFormatter, K as createDashboardLayout, V as createSamplePortlet, e as exportPortletToXlsx, Z as filterIncompletePeriod, W as findNextPosition, w as formatAxisValue, R as formatChartData, h as formatNumericValue, D as formatPeriodDayIndex, d as formatTimeValue, E as generatePeriodShortLabel, P as generatePortletId, H as generateResponsiveLayouts, F as getAllMeasureIcons, u as getFieldGranularity, m as getFieldLabel, z as getMeasureIcon, s as getMeasureType, i as getOrderedColumnsFromQuery, X as getPeriodEndDate, A as getPeriodIndices, N as getPeriodLabels, T as getPriorPeriodStrokeDashArray, Y as getQueryGranularity, q as getSyntaxHighlighter, r as hasTimeDimensionForPivot, I as highlightCodeBlock, L as highlightCodeBlocks, M as isComparisonData, a as isExportAvailable, J as isLastPeriodComplete, O as isPriorPeriodSeries, U as isSyntaxHighlightingAvailable, t as isThumbnailCaptureAvailable, b as isValidNumericValue, B as loadSyntaxHighlighter, c as parseNumericValue, o as pivotTableData, y as transformChartData, f as transformChartDataWithSeries, k as transformForOverlayMode, j as transformForSeparateMode, p as transformSeriesKeysWithLabels, G as validateCubeQuery };