drizzle-cube 0.2.12 → 0.2.14

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

@@ -1,11 +1,25 @@
 import { Filter, DashboardFilter, CubeMeta, DashboardConfig } from '../types';
+/**
+ * Memoization infrastructure to prevent creating new array references
+ * when filter data is semantically identical
+ */
+export declare const EMPTY_FILTERS: Filter[];
 /**
  * Get dashboard filters that should be applied to a portlet based on its mapping configuration
+ * MEMOIZED: Returns stable array reference when inputs are semantically identical
  * @param dashboardFilters - All available dashboard filters
  * @param filterMapping - Array of filter IDs that apply to this portlet
  * @returns Array of filters that should be applied to the portlet
  */
 export declare function getApplicableDashboardFilters(dashboardFilters: DashboardFilter[] | undefined, filterMapping: string[] | undefined): Filter[];
+/**
+ * Merge dashboard filters with portlet filters using AND logic
+ * Dashboard filters are combined with portlet filters so both sets of filters apply
+ * MEMOIZED: Returns stable array reference when inputs are semantically identical
+ * @param dashboardFilters - Filters from dashboard-level configuration
+ * @param portletFilters - Filters from portlet query
+ * @returns Merged filter array with AND logic
+ */
 export declare function mergeDashboardAndPortletFilters(dashboardFilters: Filter[], portletFilters: Filter[] | undefined): Filter[] | undefined;
 /**
  * Check if a filter field exists in the cube metadata
@@ -49,6 +63,7 @@ type TimeDimension = {
 /**
  * Apply universal time filters to a portlet's timeDimensions
  * Universal time filters apply their dateRange to ALL time dimensions in the portlet
+ * MEMOIZED: Returns stable array reference when inputs are semantically identical
  *
  * @param dashboardFilters - All dashboard filters
  * @param filterMapping - Filter IDs that apply to this portlet