@qrvey/filters 0.0.28 → 0.0.30

package/CHANGELOG.md

@@ -4,8 +4,21 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v0.0.30](https://bitbucket.org/qrvey/qrvey_filters/compare/v0.0.30..v0.0.29)
+
+- fix: added new config to order the given filters manually [`#7`](https://bitbucket.org/qrvey/qrvey_filters/pull-requests/7)
+
+#### [v0.0.29](https://bitbucket.org/qrvey/qrvey_filters/compare/v0.0.29..v0.0.28)
+
+> 7 February 2025
+
+- fix: adjusted addFilter module to change the operator based on the new criteria [`#6`](https://bitbucket.org/qrvey/qrvey_filters/pull-requests/6)
+- chore :upgraded Qrvey Utils to latest version [`87be141`](https://bitbucket.org/qrvey/qrvey_filters/commits/87be141d628b77607b0daa50e5e5d371a0892650)
+
 #### [v0.0.28](https://bitbucket.org/qrvey/qrvey_filters/compare/v0.0.28..v0.0.27)
 
+> 10 January 2025
+
 - chore: update qrvey utils to latest version [`#5`](https://bitbucket.org/qrvey/qrvey_filters/pull-requests/5)
 
 #### [v0.0.27](https://bitbucket.org/qrvey/qrvey_filters/compare/v0.0.27..v0.0.23)

package/dist/cjs/classes/FilterBuilder.d.ts

@@ -1,5 +1,5 @@
 import { IFilterBuilderAdd, IFilterBuilderAddValue, IFilterBuilderDelete, IFilterBuilderDeleteValue, IFilterBuilderEdit, IFilterBuilderEditValue, IFilterBuilderMerge, IFilterBuilderMergeValue, IFilterBuilderMultipleReturn, IFilterBuilderSet, IFilterBuilderSingleReturn } from "../models/filter-builder.models";
-import { IFilterBuilderEditSettings, IFilterParamSettings } from "../resources/filter-functions.resources";
+import { IFilterAddSettings, IFilterBuilderEditSettings, IFilterCreateSettings, IFilterMergeSettings, IFilterParamSettings, IFilterReplaceParamSettings } from "../resources/filter-functions.resources";
 import { IFilterValue } from "../resources/filter-values.resources";
 import { IFilter } from "../resources/filters.resources";
 /**
@@ -25,19 +25,23 @@ export declare class FilterBuilder implements IFilterBuilderAdd, IFilterBuilderA
      * Adds various filter into the collection.
      * Inserts them next to the last similar filter
      * @param newFilters the filter to add
-     * @param automaticId flag to generate a new filter ID based on the filter info
+     * @param inIndexes collection of indexes to add the new filters
+     * @param settings the settings object to setup this function
      * @returns the new collection of filters
      */
-    addMutiple(newFilters: IFilter[], automaticId?: boolean): IFilterBuilderMultipleReturn;
+    addMultiple(newFilters: IFilter[], inIndexes?: number[], settings?: IFilterAddSettings): IFilterBuilderMultipleReturn;
     /**
      * Adds one filter into the collection.
      * - Inserts it next to the last similar filter
+     * - If the new one is match with the last similar filter, the operator will change to OR
      * - If the id is not provided, a new one is created.
+     * - If the inIndex nunber is provided, this will be the index where the filter is inserted
      * @param filter the filter to add
-     * @param automaticId flag to generate a new filter ID based on the filter info
+     * @param inIndex the index to add the new filter
+     * @param settings settings object to setup this function
      * @returns the new collection of filters
      */
-    addSingle(filter: IFilter, automaticId?: boolean): IFilterBuilderSingleReturn;
+    addSingle(filter: IFilter, inIndex?: number, settings?: IFilterAddSettings): IFilterBuilderSingleReturn;
     /**
      * Adds one value from filter
      * @param id the ID to search the filter to add value
@@ -69,7 +73,7 @@ export declare class FilterBuilder implements IFilterBuilderAdd, IFilterBuilderA
      * @param ids a collection of ID to search filters to remove
      * @returns the new filter collection
      */
-    deleteMutiple(ids: string[]): IFilterBuilderMultipleReturn;
+    deleteMultiple(ids: string[]): IFilterBuilderMultipleReturn;
     /**
      * Removes one filter from the collection
      * @param id the ID to search the filter to remove
@@ -102,7 +106,7 @@ export declare class FilterBuilder implements IFilterBuilderAdd, IFilterBuilderA
      * @param settings settings object for the function
      * @returns the new filter collection
      */
-    editMutiple(ids: string[], filters: Partial<IFilter>[], settings?: IFilterBuilderEditSettings): IFilterBuilderMultipleReturn;
+    editMultiple(ids: string[], filters: Partial<IFilter>[], settings?: IFilterBuilderEditSettings): IFilterBuilderMultipleReturn;
     /**
      * Edits one filter from the collection
      * @param id the ID to search the filter to edit
@@ -135,15 +139,17 @@ export declare class FilterBuilder implements IFilterBuilderAdd, IFilterBuilderA
     /**
      * Merge the filter into the collection by some filter parameters
      * @param filter the filter to merge
+     * @param settings the settings object to setup this function
      * @returns the new filter collection
      */
-    mergeSingle(filter: IFilter): IFilterBuilderSingleReturn;
+    mergeSingle(filter: IFilter, settings?: IFilterMergeSettings): IFilterBuilderSingleReturn;
     /**
      * Merge the filters into the collection by some filter parameters
      * @param filters the filter collection to merge
+     * @param settings the settings object to setup this function
      * @returns the new filter collection
      */
-    mergeMutiple(filters: IFilter[]): IFilterBuilderMultipleReturn;
+    mergeMultiple(filters: IFilter[], settings?: IFilterMergeSettings): IFilterBuilderMultipleReturn;
     /**
      * Merge values from filter
      * @param id the ID to search the filter to merge values
@@ -159,10 +165,10 @@ export declare class FilterBuilder implements IFilterBuilderAdd, IFilterBuilderA
     /**
      * Builds an filter structure based on given params
      * @param filter the partial filter params
-     * @param automaticId flag to generate a new filter ID based on the filter info
+     * @param settings the settings object to setup this function
      * @returns the complete filter structure
      */
-    static createFilter(filter: Partial<IFilter>, automaticId?: boolean): IFilter;
+    static createFilter(filter: Partial<IFilter>, settings?: IFilterCreateSettings): IFilter;
     /**
      * Sets the given filters by param
      * - Remove the filters by the sucesfull conditions and replace the given ones
@@ -171,7 +177,7 @@ export declare class FilterBuilder implements IFilterBuilderAdd, IFilterBuilderA
      * @param settings settings for this function
      * @returns the new collection of filters
      */
-    replaceByParams(filters: IFilter[], params: Partial<IFilter>, settings?: IFilterParamSettings): IFilterBuilderMultipleReturn;
+    replaceByParams(filters: IFilter[], params: Partial<IFilter>, settings?: IFilterReplaceParamSettings): IFilterBuilderMultipleReturn;
     /**
      * Method to sync the Filter instances
      */

package/dist/cjs/classes/FilterBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBuilder.d.ts","sourceRoot":"","sources":["../../../src/classes/FilterBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FilterBuilder.d.ts","sourceRoot":"","sources":["../../../src/classes/FilterBuilder.ts"],"names":[],"mappings":"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"}

package/dist/cjs/classes/FilterBuilder.js

@@ -4,9 +4,11 @@ exports.FilterBuilder = void 0;
 const utils_1 = require("@qrvey/utils");
 const FilterSearcher_1 = require("./FilterSearcher");
 const FilterValidation_1 = require("./FilterValidation");
+const FilterValues_1 = require("./FilterValues");
 const filter_settings_helpers_1 = require("../helpers/filter-settings.helpers");
 const getFilterId_1 = require("../helpers/getFilterId");
 const getFilterType_1 = require("../helpers/getFilterType");
+const filter_operators_resources_1 = require("../resources/filter-operators.resources");
 const filters_resources_1 = require("../resources/filters.resources");
 /**
  * Class to build new filters and manipulate ones.
@@ -35,17 +37,18 @@ class FilterBuilder {
      * Adds various filter into the collection.
      * Inserts them next to the last similar filter
      * @param newFilters the filter to add
-     * @param automaticId flag to generate a new filter ID based on the filter info
+     * @param inIndexes collection of indexes to add the new filters
+     * @param settings the settings object to setup this function
      * @returns the new collection of filters
      */
-    addMutiple(newFilters, automaticId = true) {
+    addMultiple(newFilters, inIndexes, settings) {
         if ((0, utils_1.isEmpty)(newFilters))
             return { resulting: this.filters };
         const filters = (0, utils_1.objectCopy)(this.filters);
         const affected = [];
         try {
-            newFilters.forEach((newFilter) => {
-                const affectedFilter = this.addSingle(newFilter, automaticId);
+            newFilters.forEach((newFilter, index) => {
+                const affectedFilter = this.addSingle(newFilter, inIndexes?.[index], settings);
                 affected.push(affectedFilter.affected);
             });
         }
@@ -63,26 +66,35 @@ class FilterBuilder {
     /**
      * Adds one filter into the collection.
      * - Inserts it next to the last similar filter
+     * - If the new one is match with the last similar filter, the operator will change to OR
      * - If the id is not provided, a new one is created.
+     * - If the inIndex nunber is provided, this will be the index where the filter is inserted
      * @param filter the filter to add
-     * @param automaticId flag to generate a new filter ID based on the filter info
+     * @param inIndex the index to add the new filter
+     * @param settings settings object to setup this function
      * @returns the new collection of filters
      */
-    addSingle(filter, automaticId = true) {
+    addSingle(filter, inIndex, settings) {
         if ((0, utils_1.isEmpty)(filter))
             return { resulting: this.filters };
         if (FilterValidation_1.FilterValidation.isDuplicated(this.filters, filter))
             return { resulting: this.filters };
         const original = { ...filter };
         const newFilter = { ...filter };
-        if ((0, utils_1.isEmpty)(filter.id) || automaticId)
+        const newSettings = (0, filter_settings_helpers_1.getFilterAddSettings)(settings);
+        const newInIndex = (0, utils_1.isNaNV2)(inIndex) ? -1 : inIndex;
+        if ((0, utils_1.isEmpty)(filter.id) || newSettings.automaticId)
             newFilter.id = (0, getFilterId_1.getFilterId)(newFilter);
-        const lastIndex = (0, utils_1.getLastIndexFromArray)(this.filters, (aFilter) => aFilter.columnId === newFilter.columnId &&
-            aFilter.datasetId === newFilter.datasetId &&
-            aFilter.scope === newFilter.scope &&
-            aFilter.scopeId === newFilter.scopeId);
+        const lastIndex = newInIndex === -1
+            ? (0, utils_1.getLastIndexFromArray)(this.filters, (aFilter) => aFilter.columnId === newFilter.columnId &&
+                aFilter.datasetId === newFilter.datasetId &&
+                aFilter.scope === newFilter.scope &&
+                aFilter.scopeId === newFilter.scopeId)
+            : newInIndex - 1;
         if (lastIndex > -1) {
             this.filters.splice(lastIndex + 1, 0, newFilter);
+            if (newSettings.automaticOperator)
+                this.filters[lastIndex].operator = filter_operators_resources_1.FILTER_OPERATOR.OR;
         }
         else {
             this.filters.push(newFilter);
@@ -171,7 +183,7 @@ class FilterBuilder {
      * @param ids a collection of ID to search filters to remove
      * @returns the new filter collection
      */
-    deleteMutiple(ids) {
+    deleteMultiple(ids) {
         if (!Array.isArray(ids))
             return { resulting: this.filters };
         const filters = (0, utils_1.objectCopy)(this.filters);
@@ -280,7 +292,7 @@ class FilterBuilder {
      * @param settings settings object for the function
      * @returns the new filter collection
      */
-    editMutiple(ids, filters, settings) {
+    editMultiple(ids, filters, settings) {
         if (!Array.isArray(ids) ||
             !Array.isArray(filters) ||
             ids.length !== filters.length)
@@ -395,9 +407,10 @@ class FilterBuilder {
     /**
      * Merge the filter into the collection by some filter parameters
      * @param filter the filter to merge
+     * @param settings the settings object to setup this function
      * @returns the new filter collection
      */
-    mergeSingle(filter) {
+    mergeSingle(filter, settings) {
         if ((0, utils_1.isEmpty)(filter))
             return { resulting: this.filters };
         const filterIndex = this.searchEngine.findIndexByParams({
@@ -416,7 +429,7 @@ class FilterBuilder {
             affected = affectedMergeFilter;
         }
         else {
-            const { affected: affectedAddSingle } = this.addSingle(filter);
+            const { affected: affectedAddSingle } = this.addSingle(filter, undefined, settings);
             affected = affectedAddSingle;
         }
         return {
@@ -428,16 +441,17 @@ class FilterBuilder {
     /**
      * Merge the filters into the collection by some filter parameters
      * @param filters the filter collection to merge
+     * @param settings the settings object to setup this function
      * @returns the new filter collection
      */
-    mergeMutiple(filters) {
+    mergeMultiple(filters, settings) {
         if (!Array.isArray(filters) || (0, utils_1.isEmpty)(filters))
             return { resulting: this.filters };
         const originalFilters = (0, utils_1.objectCopy)(this.filters);
         const mergedFilters = [];
         try {
             filters.forEach((filter) => {
-                const mergedFilter = this.mergeSingle(filter);
+                const mergedFilter = this.mergeSingle(filter, settings);
                 mergedFilters.push(mergedFilter.affected);
             });
         }
@@ -504,10 +518,11 @@ class FilterBuilder {
     /**
      * Builds an filter structure based on given params
      * @param filter the partial filter params
-     * @param automaticId flag to generate a new filter ID based on the filter info
+     * @param settings the settings object to setup this function
      * @returns the complete filter structure
      */
-    static createFilter(filter, automaticId = true) {
+    static createFilter(filter, settings) {
+        const newSettings = (0, filter_settings_helpers_1.getFilterCreateSettings)(settings);
         const newFilter = {
             ...filters_resources_1.DEFAULT_FILTER,
             aggregateType: filter.aggregateType ?? filters_resources_1.DEFAULT_FILTER.aggregateType,
@@ -530,8 +545,12 @@ class FilterBuilder {
             selectAll: filter.selectAll ?? filters_resources_1.DEFAULT_FILTER.selectAll,
             values: filter.values || filters_resources_1.DEFAULT_FILTER.values,
         };
-        if ((0, utils_1.isEmpty)(filter.id) || automaticId)
+        if ((0, utils_1.isEmpty)(filter.id) || newSettings.automaticId)
             newFilter.id = (0, getFilterId_1.getFilterId)(newFilter);
+        if (!(0, utils_1.isEmpty)(newSettings.rawValues)) {
+            const filterType = (0, getFilterType_1.getFilterType)(newFilter.columnType, newFilter.validator);
+            newFilter.values = FilterValues_1.FilterValues.getFilterValues(filterType, newSettings.rawValues);
+        }
         return newFilter;
     }
     /**
@@ -544,8 +563,15 @@ class FilterBuilder {
      */
     replaceByParams(filters, params, settings) {
         const original = (0, utils_1.objectCopy)(this.filters);
-        this.filters = this.searchEngine.excludeByParams(params, settings);
-        const resulting = this.addMutiple(filters);
+        const newSettings = (0, filter_settings_helpers_1.getReplaceByParamsSettings)(settings);
+        let filterIndexes = undefined;
+        if (newSettings.addingInSameIndex) {
+            filterIndexes = this.searchEngine.filterIndexesByParams(params, settings);
+            if ((0, utils_1.isEmpty)(filterIndexes))
+                filterIndexes = undefined;
+        }
+        this.filters = this.searchEngine.excludeByParams(params, newSettings);
+        const resulting = this.addMultiple(filters, filterIndexes, newSettings);
         this.sync();
         return {
             resulting: this.filters,

package/dist/cjs/classes/FilterSearcher.d.ts

@@ -31,7 +31,7 @@ export declare class FilterSearcher implements IFilterSearcherParams {
      */
     filterByParams(params: Partial<IFilter>, settings?: IFilterParamSettings): IFilter[];
     /**
-     * Searchs filters by the given params and returns the inexes
+     * Searchs filters by the given params and returns the indexes
      * @param params params to search the filters
      * @param settings settings for this function
      * @returns the new collection of filters

package/dist/cjs/classes/FilterSearcher.js

@@ -47,7 +47,7 @@ class FilterSearcher {
         return this.filters.filter((filter) => (0, resolveFilterConditions_1.resolveFilterConditions)(filter, params, completeSettings));
     }
     /**
-     * Searchs filters by the given params and returns the inexes
+     * Searchs filters by the given params and returns the indexes
      * @param params params to search the filters
      * @param settings settings for this function
      * @returns the new collection of filters

package/dist/cjs/classes/FilterValues.d.ts

@@ -0,0 +1,33 @@
+import { IFilterInputValue, IFilterInputValueRange, IFilterInputValueRegular, IFilterInputValueRelativeDate, IFilterValueRange, IFilterValueRegular, IFilterValueRelativeDate } from "../resources/filter-values.resources";
+import { IFilterType } from "../resources/filters.resources";
+/**
+ * Class to manipulate filter values and input values
+ */
+export declare class FilterValues {
+    /**
+     * Gets the Filter Values based on Regular Input values
+     * @param values the regular input values
+     * @returns the Filter Regular Values
+     */
+    static getFilterRegularValues(values?: IFilterInputValueRegular[]): IFilterValueRegular[];
+    /**
+     * Gets the Filter Values based on Range Input values
+     * @param values the range input values
+     * @returns the Filter Range Values
+     */
+    static getFilterRangeValues(values?: IFilterInputValueRange[]): IFilterValueRange[];
+    /**
+     * Gets the Filter Values based on Relative Input values
+     * @param values the relative range input value
+     * @returns the Filter Relative Value
+     */
+    static getFilterRelativeValues(values?: IFilterInputValueRelativeDate[]): IFilterValueRelativeDate[];
+    /**
+     * Gets the Filter Values based on the flter type
+     * @param filterType the filter type
+     * @param values the input values
+     * @returns the Filter Values
+     */
+    static getFilterValues(filterType: IFilterType, values?: IFilterInputValue[]): IFilterValueRegular[];
+}
+//# sourceMappingURL=FilterValues.d.ts.map

package/dist/cjs/classes/FilterValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterValues.d.ts","sourceRoot":"","sources":["../../../src/classes/FilterValues.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAe,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;OAIG;WACW,sBAAsB,CAClC,MAAM,GAAE,wBAAwB,EAAO,GACtC,mBAAmB,EAAE;IAQxB;;;;OAIG;WACW,oBAAoB,CAChC,MAAM,GAAE,sBAAsB,EAAO,GACpC,iBAAiB,EAAE;IAStB;;;;OAIG;WACW,uBAAuB,CACnC,MAAM,GAAE,6BAA6B,EAAO,GAC3C,wBAAwB,EAAE;IAQ7B;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CACpB,UAAU,EAAE,WAAW,EACvB,MAAM,GAAE,iBAAiB,EAAO,GAC/B,mBAAmB,EAAE;CAkBzB"}

package/dist/cjs/classes/FilterValues.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterValues = void 0;
+const filters_resources_1 = require("../resources/filters.resources");
+/**
+ * Class to manipulate filter values and input values
+ */
+class FilterValues {
+    /**
+     * Gets the Filter Values based on Regular Input values
+     * @param values the regular input values
+     * @returns the Filter Regular Values
+     */
+    static getFilterRegularValues(values = []) {
+        return values.map((value) => ({
+            displayed: true,
+            enabled: true,
+            value: `${value}`,
+        }));
+    }
+    /**
+     * Gets the Filter Values based on Range Input values
+     * @param values the range input values
+     * @returns the Filter Range Values
+     */
+    static getFilterRangeValues(values = []) {
+        return values.map((value) => ({
+            displayed: true,
+            enabled: true,
+            max: value.max,
+            min: value.min,
+        }));
+    }
+    /**
+     * Gets the Filter Values based on Relative Input values
+     * @param values the relative range input value
+     * @returns the Filter Relative Value
+     */
+    static getFilterRelativeValues(values = []) {
+        return values.map((value) => ({
+            displayed: true,
+            enabled: true,
+            ...value,
+        }));
+    }
+    /**
+     * Gets the Filter Values based on the flter type
+     * @param filterType the filter type
+     * @param values the input values
+     * @returns the Filter Values
+     */
+    static getFilterValues(filterType, values = []) {
+        switch (filterType) {
+            case filters_resources_1.FILTER_TYPE.REGULAR:
+                return FilterValues.getFilterRegularValues(values);
+            case filters_resources_1.FILTER_TYPE.RANGE:
+                return FilterValues.getFilterRangeValues(values);
+            case filters_resources_1.FILTER_TYPE.RELATIVE:
+                return FilterValues.getFilterRelativeValues(values);
+            case filters_resources_1.FILTER_TYPE.NULL:
+                return [];
+            default:
+                return [];
+        }
+    }
+}
+exports.FilterValues = FilterValues;

package/dist/cjs/classes/index.d.ts

@@ -3,4 +3,5 @@ export * from "./FilterBuilder";
 export * from "./FilterManager";
 export * from "./FilterResources";
 export * from "./FilterSearcher";
+export * from "./FilterValues";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/classes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/classes/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/classes/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/cjs/classes/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./FilterBuilder"), exports);
 __exportStar(require("./FilterManager"), exports);
 __exportStar(require("./FilterResources"), exports);
 __exportStar(require("./FilterSearcher"), exports);
+__exportStar(require("./FilterValues"), exports);

package/dist/cjs/helpers/filter-settings.helpers.d.ts

@@ -1,23 +1,42 @@
-import { IFilterBuilderEditSettings, IFilterGroupingInfoListByColumnSettings, IFilterParamSettings } from "../resources/filter-functions.resources";
+import { IFilterAddSettings, IFilterBuilderEditSettings, IFilterCreateSettings, IFilterGroupingInfoListByColumnSettings, IFilterParamSettings, IFilterReplaceParamSettings } from "../resources/filter-functions.resources";
 /**
- * Gets a complete settings for the param settings
+ * Gets a complete settings for the edit filters settings
  * - Fills the missing properties with default ones
  * @param settings the settings
  * @returns the complete settings
  */
-export declare function getParamFiltersSettings(settings?: IFilterParamSettings): IFilterParamSettings;
+export declare function getEditFiltersSettings(settings?: IFilterBuilderEditSettings): IFilterBuilderEditSettings;
 /**
- * Gets a complete settings for the edit filters settings
+ * Gets a complete settings for the filter-create settings
+ * @param settings the filter-create settings
+ * @returns the complete filter-create settings
+ */
+export declare function getFilterAddSettings(settings?: IFilterAddSettings): IFilterAddSettings;
+/**
+ * Gets a complete settings for the filter-create settings
+ * @param settings the filter-create settings
+ * @returns the complete filter-create settings
+ */
+export declare function getFilterCreateSettings(settings?: IFilterCreateSettings): IFilterCreateSettings;
+/**
+ * Gets a complete settings for the info grouping by column settings
  * - Fills the missing properties with default ones
  * @param settings the settings
  * @returns the complete settings
  */
-export declare function getEditFiltersSettings(settings?: IFilterBuilderEditSettings): IFilterBuilderEditSettings;
+export declare function getInfoGroupingsByColumnTypeSettings(settings?: IFilterGroupingInfoListByColumnSettings): IFilterGroupingInfoListByColumnSettings;
 /**
- * Gets a complete settings for the info grouping by column settings
+ * Gets a complete settings for the param settings
  * - Fills the missing properties with default ones
  * @param settings the settings
  * @returns the complete settings
  */
-export declare function getInfoGroupingsByColumnTypeSettings(settings?: IFilterGroupingInfoListByColumnSettings): IFilterGroupingInfoListByColumnSettings;
+export declare function getParamFiltersSettings(settings?: IFilterParamSettings): IFilterParamSettings;
+/**
+ * Gets a complete settings for the replaceByParams settings
+ * - Fills the missing properties with default ones
+ * @param settings the settings
+ * @returns the complete settings
+ */
+export declare function getReplaceByParamsSettings(settings?: IFilterReplaceParamSettings): IFilterReplaceParamSettings;
 //# sourceMappingURL=filter-settings.helpers.d.ts.map

package/dist/cjs/helpers/filter-settings.helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-settings.helpers.d.ts","sourceRoot":"","sources":["../../../src/helpers/filter-settings.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,0BAA0B,EAC1B,uCAAuC,EACvC,oBAAoB,EACrB,MAAM,yCAAyC,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,oBAAoB,CAYtB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,0BAA0B,GACpC,0BAA0B,CAQ5B;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,CAAC,EAAE,uCAAuC,GACjD,uCAAuC,CAkBzC"}
+{"version":3,"file":"filter-settings.helpers.d.ts","sourceRoot":"","sources":["../../../src/helpers/filter-settings.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,uCAAuC,EACvC,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,yCAAyC,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,0BAA0B,GACpC,0BAA0B,CAQ5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,kBAAkB,CAQpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,qBAAqB,CAMvB;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,CAAC,EAAE,uCAAuC,GACjD,uCAAuC,CAkBzC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,oBAAoB,CAYtB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,CAAC,EAAE,2BAA2B,GACrC,2BAA2B,CAM7B"}

package/dist/cjs/helpers/filter-settings.helpers.js

@@ -1,24 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getInfoGroupingsByColumnTypeSettings = exports.getEditFiltersSettings = exports.getParamFiltersSettings = void 0;
+exports.getReplaceByParamsSettings = exports.getParamFiltersSettings = exports.getInfoGroupingsByColumnTypeSettings = exports.getFilterCreateSettings = exports.getFilterAddSettings = exports.getEditFiltersSettings = void 0;
 const filter_functions_resources_1 = require("../resources/filter-functions.resources");
-/**
- * Gets a complete settings for the param settings
- * - Fills the missing properties with default ones
- * @param settings the settings
- * @returns the complete settings
- */
-function getParamFiltersSettings(settings) {
-    return {
-        letPassUndefinedParams: settings?.letPassUndefinedParams ??
-            filter_functions_resources_1.DEFAULT_FILTERS_PARAM_SETTINGS.letPassUndefinedParams,
-        letPassUndefinedProperties: settings?.letPassUndefinedProperties ??
-            filter_functions_resources_1.DEFAULT_FILTERS_PARAM_SETTINGS.letPassUndefinedProperties,
-        removeEmptyArrays: settings?.removeEmptyArrays ??
-            filter_functions_resources_1.DEFAULT_FILTERS_PARAM_SETTINGS.removeEmptyArrays,
-    };
-}
-exports.getParamFiltersSettings = getParamFiltersSettings;
 /**
  * Gets a complete settings for the edit filters settings
  * - Fills the missing properties with default ones
@@ -33,6 +16,31 @@ function getEditFiltersSettings(settings) {
     };
 }
 exports.getEditFiltersSettings = getEditFiltersSettings;
+/**
+ * Gets a complete settings for the filter-create settings
+ * @param settings the filter-create settings
+ * @returns the complete filter-create settings
+ */
+function getFilterAddSettings(settings) {
+    return {
+        automaticId: settings?.automaticId ?? filter_functions_resources_1.DEFAULT_FILTER_ADD_SETTINGS.automaticId,
+        automaticOperator: settings?.automaticOperator ??
+            filter_functions_resources_1.DEFAULT_FILTER_ADD_SETTINGS.automaticOperator,
+    };
+}
+exports.getFilterAddSettings = getFilterAddSettings;
+/**
+ * Gets a complete settings for the filter-create settings
+ * @param settings the filter-create settings
+ * @returns the complete filter-create settings
+ */
+function getFilterCreateSettings(settings) {
+    return {
+        automaticId: settings?.automaticId ?? filter_functions_resources_1.DEFAULT_FILTER_CREATE_SETTINGS.automaticId,
+        rawValues: settings?.rawValues ?? filter_functions_resources_1.DEFAULT_FILTER_CREATE_SETTINGS.rawValues,
+    };
+}
+exports.getFilterCreateSettings = getFilterCreateSettings;
 /**
  * Gets a complete settings for the info grouping by column settings
  * - Fills the missing properties with default ones
@@ -54,3 +62,34 @@ function getInfoGroupingsByColumnTypeSettings(settings) {
     };
 }
 exports.getInfoGroupingsByColumnTypeSettings = getInfoGroupingsByColumnTypeSettings;
+/**
+ * Gets a complete settings for the param settings
+ * - Fills the missing properties with default ones
+ * @param settings the settings
+ * @returns the complete settings
+ */
+function getParamFiltersSettings(settings) {
+    return {
+        letPassUndefinedParams: settings?.letPassUndefinedParams ??
+            filter_functions_resources_1.DEFAULT_FILTERS_PARAM_SETTINGS.letPassUndefinedParams,
+        letPassUndefinedProperties: settings?.letPassUndefinedProperties ??
+            filter_functions_resources_1.DEFAULT_FILTERS_PARAM_SETTINGS.letPassUndefinedProperties,
+        removeEmptyArrays: settings?.removeEmptyArrays ??
+            filter_functions_resources_1.DEFAULT_FILTERS_PARAM_SETTINGS.removeEmptyArrays,
+    };
+}
+exports.getParamFiltersSettings = getParamFiltersSettings;
+/**
+ * Gets a complete settings for the replaceByParams settings
+ * - Fills the missing properties with default ones
+ * @param settings the settings
+ * @returns the complete settings
+ */
+function getReplaceByParamsSettings(settings) {
+    return {
+        ...settings,
+        automaticOperator: settings?.automaticOperator ?? false,
+        addingInSameIndex: settings?.addingInSameIndex ?? false,
+    };
+}
+exports.getReplaceByParamsSettings = getReplaceByParamsSettings;