@dcupl/common 2.0.0-beta.0 → 2.0.0-beta.10

package/dist/esm/analytics.controller.d.ts

@@ -1,4 +1,4 @@
-import { DcuplUpdateType } from './changeDetection';
+import { DcuplUpdateType } from './changeDetection.js';
 export type AnalyticsEntryType = 'resource' | 'mark' | 'measure' | 'data' | 'sdk_action';
 export type AnalyticsEntryBase<Value = any> = {
     name: string;

package/dist/esm/changeDetection.d.ts

@@ -1,5 +1,5 @@
-import { CallbackFunction, DcuplInitOptions } from './types';
-import { AnalyticsController } from './analytics.controller';
+import { CallbackFunction, DcuplInitOptions } from './types/index.js';
+import { AnalyticsController } from './analytics.controller.js';
 export type DcuplUpdateScope = 'all' | 'global' | 'list' | 'list$';
 export type DcuplUpdateTrigger = 'user' | 'loader';
 export type DcuplUpdateType = 'data_change' | 'dcupl_destroyed' | 'dcupl_handle_datacontainer' | 'dcupl_initialized' | 'dcupl_updated_manually' | 'dcupl_partial_update' | 'filter_many' | 'filter_one' | 'fn_aggregate' | 'fn_facets' | 'fn_groupBy' | 'fn_metadata' | 'fn_pivot' | 'fn_suggest' | 'list_created' | 'list_destroyed' | 'list_updated' | 'loader_added' | 'loader_config_fetched' | 'loader_data_fetched' | 'loader_models_fetched' | 'loader_scripts_fetched' | 'loader_processed' | 'loader_removed' | 'model_add' | 'query_apply_options' | 'query_apply' | 'query_execute' | 'query_get' | 'query_has' | 'query_many' | 'query_one' | 'query_remove' | 'query_reset' | 'result_updated' | 'view_add';

package/dist/esm/computeSuggestions.d.ts

@@ -1,3 +1,3 @@
-import { ListItem, Suggestion, SuggestionOptions, InverseIndexValuesMap } from './types';
-import { QueryManager } from '.';
+import { ListItem, Suggestion, SuggestionOptions, InverseIndexValuesMap } from './types/index.js';
+import { QueryManager } from './index.js';
 export declare function computeSuggestions<ListType extends ListItem = ListItem>(data: Map<string, ListType>, index: InverseIndexValuesMap, options: SuggestionOptions, queryManager: QueryManager): Suggestion[];

package/dist/esm/deep-query.service.d.ts

@@ -1,4 +1,4 @@
-import { QueryAttributeEntry } from './query-builder';
+import { QueryAttributeEntry } from './query-builder.js';
 /**
  * Result of path validation
  */
@@ -131,3 +131,28 @@ export declare class DeepQueryService {
  * Singleton instance for global use
  */
 export declare const deepQueryService: DeepQueryService;
+/**
+ * Extract all values from an object using a path that may contain [*] wildcards.
+ *
+ * This function handles patterns like:
+ * - `articleIds[*].vendorId.location` - expands [*] to iterate over array elements
+ * - `a[*].b[*].c` - supports nested wildcards (cross-product)
+ * - `simple.path` - falls back to lodash get for non-wildcard paths
+ *
+ * @param item - The object to extract values from
+ * @param path - The path string, possibly containing [*] wildcards
+ * @returns Array of all values found at the path
+ *
+ * @example
+ * ```typescript
+ * const order = {
+ *   articleIds: [
+ *     { vendorId: { location: 'Berlin' } },
+ *     { vendorId: { location: 'Vienna' } }
+ *   ]
+ * };
+ * getDeepPathValues(order, 'articleIds[*].vendorId.location');
+ * // Returns: ['Berlin', 'Vienna']
+ * ```
+ */
+export declare function getDeepPathValues(item: any, path: string): any[];

package/dist/esm/getAggregation.d.ts

@@ -1,3 +1,3 @@
-import { Aggregation, AggregationDistinctValue, AggregationOptions, InverseIndexValuesMap, ListItem } from './types';
+import { Aggregation, AggregationDistinctValue, AggregationOptions, InverseIndexValuesMap, ListItem } from './types/index.js';
 export declare const getAggregation: (options: AggregationOptions, relevantData: Map<string, ListItem>, indexMap: InverseIndexValuesMap, attribute: string) => Aggregation;
 export declare const getDistinct: (options: AggregationOptions, data: Map<string, ListItem>, indexMap: InverseIndexValuesMap) => AggregationDistinctValue[];

package/dist/esm/getFacets.d.ts

@@ -1,3 +1,26 @@
-import { ListItem, DcuplFilterOptions, InverseIndexReferenceMap, DcuplGlobalQueryOptions, DcuplFacet } from './types';
-import { QueryManager } from './queryData';
-export declare function getFacets<ListType extends ListItem = ListItem>(modelData: Map<string, ListType>, remoteModelData: Map<string, ListType>, options: DcuplFilterOptions, query: DcuplGlobalQueryOptions<any>, attribute: string, modelIndexMap: InverseIndexReferenceMap, queryManager: QueryManager): DcuplFacet[];
+import { ListItem, DcuplFilterOptions, InverseIndexReferenceMap, DcuplGlobalQueryOptions, DcuplFacet } from './types/index.js';
+import { QueryManager } from './queryData.js';
+/**
+ * Build facet entries for `attribute`.
+ *
+ * Pipeline order — IMPORTANT, do not shuffle:
+ *
+ *   Fast path (options.sort omitted, default):
+ *     1. walk validFacetKeys in insertion order
+ *     2. for each key: compute entry (binary size if calculateFacets is false)
+ *     3. skip if excludeZeros && size === 0 (does NOT advance count)
+ *     4. early-return when filterItemEntries.length === count
+ *     5. push and continue
+ *
+ *   Sort path (options.sort set):
+ *     1. walk ALL validFacetKeys (ignore count for early-return)
+ *     2. for each key: compute entry with FULL size (override calculateFacets: false)
+ *     3. push every entry
+ *     4. drop zeros if excludeZeros
+ *     5. sort by chosen mode (size sorts tie-break on value asc, undefined last)
+ *     6. truncate to count
+ *
+ * The sort path is opt-in because it forfeits both early-return optimizations.
+ * Most call sites only need a partial answer and stay on the fast path.
+ */
+export declare function getFacets<ListType extends ListItem = ListItem>(modelData: Map<string, ListType>, remoteModelData: Map<string, ListType> | undefined, options: DcuplFilterOptions, query: DcuplGlobalQueryOptions<any>, attribute: string, modelIndexMap: InverseIndexReferenceMap, queryManager: QueryManager): DcuplFacet[];

package/dist/esm/helper.d.ts

@@ -1,4 +1,4 @@
-import { DateFilterOptions, NumberFilterOptions } from './types';
+import { DateFilterOptions, NumberFilterOptions } from './types/index.js';
 export declare const getFilterEntryId: (filterItemId: string, value?: string) => string;
 export declare const getNumberConstraintUid: (options: NumberFilterOptions) => string;
 export declare const getDateConstraintUid: (options: DateFilterOptions) => string;

package/dist/esm/index.d.ts

@@ -1,22 +1,23 @@
-export * from './analytics.controller';
-export * from './attribute-dependency-graph';
-export * from './cache.controller';
-export * from './changeDetection';
-export * from './computeSuggestions';
-export * from './date-utils';
-export * from './deep-query.service';
-export * from './dependency-graph';
-export * from './getAggregation';
-export * from './getFacets';
-export * from './helper';
-export * from './indices.controller';
-export * from './logger';
-export * from './performance';
-export * from './pivot';
-export * from './property-parser';
-export * from './query-builder';
-export * from './query.helper';
-export * from './queryData';
-export * from './script.controller';
-export * from './template-parser';
-export * from './types';
+export * from './analytics.controller.js';
+export * from './attribute-dependency-graph.js';
+export * from './cache.controller.js';
+export * from './changeDetection.js';
+export * from './computeSuggestions.js';
+export * from './date-utils.js';
+export * from './deep-query.service.js';
+export * from './dependency-graph.js';
+export * from './getAggregation.js';
+export * from './getFacets.js';
+export * from './helper.js';
+export * from './indices.controller.js';
+export * from './logger/index.js';
+export * from './performance.js';
+export * from './pivot.js';
+export * from './property-parser.js';
+export * from './query-builder.js';
+export * from './query.helper.js';
+export * from './queryData.js';
+export * from './resource-id.js';
+export * from './script.controller.js';
+export * from './template-parser.js';
+export * from './types/index.js';