selectic 3.0.10 → 3.0.15

package/README.md

@@ -2,6 +2,7 @@
 
 > VueJS 3.X + Typescript + JSX + Select
 
+[![npm](https://img.shields.io/npm/v/selectic.svg)](https://www.npmjs.com/package/selectic)
 
 ## Introduction
 

package/dist/selectic.common.js

@@ -38,10 +38,12 @@ styleInject(css_248z);
 /**
  * Clone the object and its inner properties.
  * @param obj The object to be clone.
+ * @param attributes list of attributes to not clone.
  * @param refs internal reference to object to avoid cyclic references
  * @returns a copy of obj
  */
-function deepClone(obj, refs = new WeakMap()) {
+function deepClone(origObject, ignoreAttributes = [], refs = new WeakMap()) {
+    const obj = vue.unref(origObject);
     /* For circular references */
     if (refs.has(obj)) {
         return refs.get(obj);
@@ -54,7 +56,7 @@ function deepClone(obj, refs = new WeakMap()) {
             const ref = [];
             refs.set(obj, ref);
             obj.forEach((val, idx) => {
-                ref[idx] = deepClone(val, refs);
+                ref[idx] = deepClone(val, ignoreAttributes, refs);
             });
             return ref;
         }
@@ -67,7 +69,11 @@ function deepClone(obj, refs = new WeakMap()) {
         const ref = {};
         refs.set(obj, ref);
         for (const [key, val] of Object.entries(obj)) {
-            ref[key] = deepClone(val, refs);
+            if (ignoreAttributes.includes(key)) {
+                ref[key] = val;
+                continue;
+            }
+            ref[key] = deepClone(val, ignoreAttributes, refs);
         }
         return ref;
     }
@@ -294,7 +300,7 @@ class SelecticStore {
         const value = deepClone(this.props.value);
         /* set initial value for non reactive attribute */
         this.cacheRequest = new Map();
-        const stateParam = deepClone(this.props.params);
+        const stateParam = deepClone(this.props.params, ['data']);
         if (stateParam.optionBehavior) {
             this.buildOptionBehavior(stateParam.optionBehavior, stateParam);
             delete stateParam.optionBehavior;
@@ -684,7 +690,7 @@ class SelecticStore {
     }
     /* This method is for the computed property listOptions */
     getListOptions() {
-        const options = deepClone(this.props.options);
+        const options = deepClone(this.props.options, ['data']);
         const listOptions = [];
         if (!Array.isArray(options)) {
             return listOptions;
@@ -721,7 +727,7 @@ class SelecticStore {
     }
     /* This method is for the computed property elementOptions */
     getElementOptions() {
-        const options = deepClone(this.props.childOptions);
+        const options = deepClone(this.props.childOptions, ['data']);
         const childOptions = [];
         if (!Array.isArray(options) || options.length === 0) {
             return childOptions;
@@ -2114,7 +2120,7 @@ let Selectic = class Selectic extends vtyx.Vue {
             }];
     }
     get hasGivenValue() {
-        const value = this.value;
+        const value = vue.unref(this.value);
         return value !== null && value !== undefined;
     }
     get defaultValue() {
@@ -2259,7 +2265,7 @@ let Selectic = class Selectic extends vtyx.Vue {
         this.store.props.selectionIsExcluded = this.selectionIsExcluded;
     }
     onOptionsChange() {
-        this.store.props.options = deepClone(this.options);
+        this.store.props.options = deepClone(this.options, ['data']);
     }
     onTextsChange() {
         const texts = this.texts;
@@ -2434,12 +2440,12 @@ let Selectic = class Selectic extends vtyx.Vue {
         var _a, _b, _c;
         this._elementsListeners = [];
         this.store = new SelecticStore({
-            options: this.options,
-            value: this.value,
+            options: deepClone(this.options, ['data']),
+            value: deepClone(this.value),
             selectionIsExcluded: this.selectionIsExcluded,
             disabled: this.disabled,
             texts: this.texts,
-            groups: this.groups,
+            groups: deepClone(this.groups),
             keepOpenWithOtherSelectic: !!this.params.keepOpenWithOtherSelectic,
             params: {
                 multiple: ((_a = this.multiple) !== null && _a !== void 0 ? _a : false) !== false,
@@ -2606,13 +2612,7 @@ __decorate([
     vtyx.Watch('store.state.internalValue', { deep: true })
 ], Selectic.prototype, "onInternalValueChange", null);
 __decorate([
-    vtyx.Emit('input'),
-    vtyx.Emit('change'),
-    vtyx.Emit('open'),
-    vtyx.Emit('focus'),
-    vtyx.Emit('close'),
-    vtyx.Emit('blur'),
-    vtyx.Emit('item:click')
+    vtyx.Emits(['input', 'change', 'open', 'focus', 'close', 'blur', 'item:click'])
 ], Selectic.prototype, "render", null);
 Selectic = __decorate([
     vtyx.Component

package/dist/selectic.esm.js

@@ -1,5 +1,5 @@
-import { Prop, Watch, Component, Vue, h, Emit } from 'vtyx';
-import { reactive, computed, unref, watch } from 'vue';
+import { Prop, Watch, Component, Vue, h, Emits } from 'vtyx';
+import { unref, reactive, computed, watch } from 'vue';
 
 function styleInject(css, ref) {
   if ( ref === void 0 ) ref = {};
@@ -34,10 +34,12 @@ styleInject(css_248z);
 /**
  * Clone the object and its inner properties.
  * @param obj The object to be clone.
+ * @param attributes list of attributes to not clone.
  * @param refs internal reference to object to avoid cyclic references
  * @returns a copy of obj
  */
-function deepClone(obj, refs = new WeakMap()) {
+function deepClone(origObject, ignoreAttributes = [], refs = new WeakMap()) {
+    const obj = unref(origObject);
     /* For circular references */
     if (refs.has(obj)) {
         return refs.get(obj);
@@ -50,7 +52,7 @@ function deepClone(obj, refs = new WeakMap()) {
             const ref = [];
             refs.set(obj, ref);
             obj.forEach((val, idx) => {
-                ref[idx] = deepClone(val, refs);
+                ref[idx] = deepClone(val, ignoreAttributes, refs);
             });
             return ref;
         }
@@ -63,7 +65,11 @@ function deepClone(obj, refs = new WeakMap()) {
         const ref = {};
         refs.set(obj, ref);
         for (const [key, val] of Object.entries(obj)) {
-            ref[key] = deepClone(val, refs);
+            if (ignoreAttributes.includes(key)) {
+                ref[key] = val;
+                continue;
+            }
+            ref[key] = deepClone(val, ignoreAttributes, refs);
         }
         return ref;
     }
@@ -290,7 +296,7 @@ class SelecticStore {
         const value = deepClone(this.props.value);
         /* set initial value for non reactive attribute */
         this.cacheRequest = new Map();
-        const stateParam = deepClone(this.props.params);
+        const stateParam = deepClone(this.props.params, ['data']);
         if (stateParam.optionBehavior) {
             this.buildOptionBehavior(stateParam.optionBehavior, stateParam);
             delete stateParam.optionBehavior;
@@ -680,7 +686,7 @@ class SelecticStore {
     }
     /* This method is for the computed property listOptions */
     getListOptions() {
-        const options = deepClone(this.props.options);
+        const options = deepClone(this.props.options, ['data']);
         const listOptions = [];
         if (!Array.isArray(options)) {
             return listOptions;
@@ -717,7 +723,7 @@ class SelecticStore {
     }
     /* This method is for the computed property elementOptions */
     getElementOptions() {
-        const options = deepClone(this.props.childOptions);
+        const options = deepClone(this.props.childOptions, ['data']);
         const childOptions = [];
         if (!Array.isArray(options) || options.length === 0) {
             return childOptions;
@@ -2110,7 +2116,7 @@ let Selectic = class Selectic extends Vue {
             }];
     }
     get hasGivenValue() {
-        const value = this.value;
+        const value = unref(this.value);
         return value !== null && value !== undefined;
     }
     get defaultValue() {
@@ -2255,7 +2261,7 @@ let Selectic = class Selectic extends Vue {
         this.store.props.selectionIsExcluded = this.selectionIsExcluded;
     }
     onOptionsChange() {
-        this.store.props.options = deepClone(this.options);
+        this.store.props.options = deepClone(this.options, ['data']);
     }
     onTextsChange() {
         const texts = this.texts;
@@ -2430,12 +2436,12 @@ let Selectic = class Selectic extends Vue {
         var _a, _b, _c;
         this._elementsListeners = [];
         this.store = new SelecticStore({
-            options: this.options,
-            value: this.value,
+            options: deepClone(this.options, ['data']),
+            value: deepClone(this.value),
             selectionIsExcluded: this.selectionIsExcluded,
             disabled: this.disabled,
             texts: this.texts,
-            groups: this.groups,
+            groups: deepClone(this.groups),
             keepOpenWithOtherSelectic: !!this.params.keepOpenWithOtherSelectic,
             params: {
                 multiple: ((_a = this.multiple) !== null && _a !== void 0 ? _a : false) !== false,
@@ -2602,13 +2608,7 @@ __decorate([
     Watch('store.state.internalValue', { deep: true })
 ], Selectic.prototype, "onInternalValueChange", null);
 __decorate([
-    Emit('input'),
-    Emit('change'),
-    Emit('open'),
-    Emit('focus'),
-    Emit('close'),
-    Emit('blur'),
-    Emit('item:click')
+    Emits(['input', 'change', 'open', 'focus', 'close', 'blur', 'item:click'])
 ], Selectic.prototype, "render", null);
 Selectic = __decorate([
     Component

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "selectic",
-    "version": "3.0.10",
+    "version": "3.0.15",
     "description": "Smart Select for VueJS 3.x",
     "main": "dist/selectic.common.js",
     "module": "dist/selectic.esm.js",
@@ -19,7 +19,9 @@
         "select",
         "multiselect",
         "multi-select",
+        "multi-select",
         "dynamic select",
+        "smart select",
         "vue",
         "vue.js",
         "vueJS",
@@ -36,7 +38,7 @@
         "test": "npm run build && tape test/**/*.spec.js"
     },
     "dependencies": {
-        "vtyx": "4.0.3"
+        "vtyx": "4.0.5"
     },
     "devDependencies": {
         "@babel/types": "^7.16.7",

package/rollup.config.js

@@ -30,5 +30,12 @@ export default [{
         'vtyx',
     ],
     context: 'this',
+}, {
+    input: 'lib/tools.js',
+    output: [{
+        file: 'test/dist/tools.js',
+        exports: 'named',
+        format: 'cjs',
+    }],
+    context: 'this',
 }];
-

package/src/Store.tsx

@@ -593,7 +593,7 @@ export default class SelecticStore {
         this.cacheRequest = new Map();
 
         const stateParam: SelecticStoreStateParams | SelecticStoreState =
-            deepClone(this.props.params);
+            deepClone(this.props.params, ['data']);
 
         if (stateParam.optionBehavior) {
             this.buildOptionBehavior(
@@ -1060,7 +1060,7 @@ export default class SelecticStore {
 
     /* This method is for the computed property listOptions */
     private getListOptions(): OptionValue[] {
-        const options = deepClone(this.props.options);
+        const options = deepClone(this.props.options, ['data']);
         const listOptions: OptionValue[] = [];
 
         if (!Array.isArray(options)) {
@@ -1106,7 +1106,7 @@ export default class SelecticStore {
 
     /* This method is for the computed property elementOptions */
     private getElementOptions(): OptionValue[] {
-        const options = deepClone(this.props.childOptions);
+        const options = deepClone(this.props.childOptions, ['data']);
         const childOptions: OptionValue[] = [];
 
         if (!Array.isArray(options) || options.length === 0) {

package/src/index.tsx

@@ -18,7 +18,8 @@
  *   close [component]: triggered when the list closes.
  */
 
-import {Vue, Component, Emit, Prop, Watch, h} from 'vtyx';
+import {Vue, Component, Emits, Prop, Watch, h} from 'vtyx';
+import { unref } from 'vue';
 import './css/selectic.css';
 
 import { deepClone } from './tools';
@@ -373,7 +374,7 @@ export default class Selectic extends Vue<Props> {
     }
 
     get hasGivenValue() {
-        const value = this.value;
+        const value = unref(this.value);
 
         return value !== null && value !== undefined;
     }
@@ -560,7 +561,7 @@ export default class Selectic extends Vue<Props> {
 
     @Watch('options', { deep: true })
     public onOptionsChange() {
-        this.store.props.options = deepClone(this.options);
+        this.store.props.options = deepClone(this.options, ['data']);
     }
 
     @Watch('texts', { deep: true })
@@ -781,12 +782,12 @@ export default class Selectic extends Vue<Props> {
         this._elementsListeners = [];
 
         this.store = new Store({
-            options: this.options,
-            value: this.value,
+            options: deepClone(this.options, ['data']),
+            value: deepClone(this.value),
             selectionIsExcluded: this.selectionIsExcluded,
             disabled: this.disabled,
             texts: this.texts,
-            groups: this.groups,
+            groups: deepClone(this.groups),
             keepOpenWithOtherSelectic: !!this.params.keepOpenWithOtherSelectic,
             params: {
                 multiple: (this.multiple ?? false) !== false,
@@ -859,13 +860,7 @@ export default class Selectic extends Vue<Props> {
 
     /* }}} */
 
-    @Emit('input')
-    @Emit('change')
-    @Emit('open')
-    @Emit('focus')
-    @Emit('close')
-    @Emit('blur')
-    @Emit('item:click')
+    @Emits(['input', 'change', 'open', 'focus', 'close', 'blur', 'item:click'])
     public render() {
         const id = this.id || undefined;
         const store = this.store;

package/src/tools.ts

@@ -1,11 +1,15 @@
+import { unref } from 'vue';
 
 /**
  * Clone the object and its inner properties.
  * @param obj The object to be clone.
+ * @param attributes list of attributes to not clone.
  * @param refs internal reference to object to avoid cyclic references
  * @returns a copy of obj
  */
-export function deepClone<T = any>(obj: T, refs: WeakMap<any, any> = new WeakMap()): T {
+export function deepClone<T = any>(origObject: T, ignoreAttributes: string[] = [], refs: WeakMap<any, any> = new WeakMap()): T {
+    const obj = unref(origObject);
+
     /* For circular references */
     if (refs.has(obj)) {
         return refs.get(obj);
@@ -20,7 +24,7 @@ export function deepClone<T = any>(obj: T, refs: WeakMap<any, any> = new WeakMap
             const ref: any[] = [];
             refs.set(obj, ref);
             obj.forEach((val, idx) => {
-                ref[idx] = deepClone(val, refs);
+                ref[idx] = deepClone(val, ignoreAttributes, refs);
             });
             return ref as unknown as T;
         }
@@ -35,7 +39,12 @@ export function deepClone<T = any>(obj: T, refs: WeakMap<any, any> = new WeakMap
         const ref: any = {};
         refs.set(obj, ref);
         for (const [key, val] of Object.entries(obj)) {
-            ref[key] = deepClone(val, refs);
+            if (ignoreAttributes.includes(key)) {
+                ref[key] = val;
+                continue;
+            }
+
+            ref[key] = deepClone(val, ignoreAttributes, refs);
         }
         return ref as unknown as T;
     }
@@ -44,7 +53,6 @@ export function deepClone<T = any>(obj: T, refs: WeakMap<any, any> = new WeakMap
     return obj;
 }
 
-
 /**
  * Escape search string to consider regexp special characters as they
  * are and not like special characters.

package/test/Store/Store_creation.spec.js

@@ -1,16 +1,3 @@
-/**************************************************************************/
-/*                                                                        */
-/*  Copyright (C) INTERSEC SA                                             */
-/*                                                                        */
-/*  Should you receive a copy of this source code, you must check you     */
-/*  have a proper, written authorization of INTERSEC to hold it. If you   */
-/*  don't have such an authorization, you must DELETE all source code     */
-/*  files in your possession, and inform INTERSEC of the fact you obtain  */
-/*  these files. Should you not comply to these terms, you can be         */
-/*  prosecuted in the extent permitted by applicable law.                 */
-/*                                                                        */
-/**************************************************************************/
-
 const _ = require('../tools.js');
 const {
     getInitialState,
@@ -873,6 +860,44 @@ tape.test('Store creation', (subT) => {
                 t.deepEqual(store.state.internalValue, [2, 'hello', 1, true]);
                 t.end();
             });
+
+            sTest.test('should call getItemsCallback if item is not in options', async (t) => {
+                const spyGetItems = {};
+                const store = new Store({
+                    params: {
+                        multiple: true,
+                        strictValue: false,
+                    },
+                    getItemsCallback: buildGetItemsCb({ spy: spyGetItems}),
+                    options: getOptions(5),
+                    value: [2, 10, 1],
+                });
+
+                await sleep(0);
+                t.true(spyGetItems.nbCall >= 1, 'fetch callback should be called at least once');
+
+                t.deepEqual(store.state.internalValue, [2, 10, 1]);
+
+                const item = store.getItem(10);
+
+                t.deepEqual(item, {
+                    id: 10,
+                    text: 'some text 10',
+                    data: 'data10',
+                    disabled: false,
+                    selected: true,
+                    isGroup: false,
+                });
+
+                const currentOptions = store.state.allOptions;
+                t.is(currentOptions.length, 5, 'should add fetched items');
+
+                const hasItem10 = currentOptions.some((option) => option.id === 10);
+
+                t.false(hasItem10, 'should not add the item');
+
+                t.end();
+            });
         });
 
         st.test('in dynamic mode', (sTest) => {

package/test/Store/commit.spec.js

@@ -1,16 +1,3 @@
-/**************************************************************************/
-/*                                                                        */
-/*  Copyright (C) INTERSEC SA                                             */
-/*                                                                        */
-/*  Should you receive a copy of this source code, you must check you     */
-/*  have a proper, written authorization of INTERSEC to hold it. If you   */
-/*  don't have such an authorization, you must DELETE all source code     */
-/*  files in your possession, and inform INTERSEC of the fact you obtain  */
-/*  these files. Should you not comply to these terms, you can be         */
-/*  prosecuted in the extent permitted by applicable law.                 */
-/*                                                                        */
-/**************************************************************************/
-
 const _ = require('../tools.js');
 const {
     getInitialState,

package/test/Store/getItem.spec.js

@@ -1,16 +1,3 @@
-/**************************************************************************/
-/*                                                                        */
-/*  Copyright (C) INTERSEC SA                                             */
-/*                                                                        */
-/*  Should you receive a copy of this source code, you must check you     */
-/*  have a proper, written authorization of INTERSEC to hold it. If you   */
-/*  don't have such an authorization, you must DELETE all source code     */
-/*  files in your possession, and inform INTERSEC of the fact you obtain  */
-/*  these files. Should you not comply to these terms, you can be         */
-/*  prosecuted in the extent permitted by applicable law.                 */
-/*                                                                        */
-/**************************************************************************/
-
 const _ = require('../tools.js');
 const {
     buildFetchCb,

package/test/Store/getItems.spec.js

@@ -1,16 +1,3 @@
-/**************************************************************************/
-/*                                                                        */
-/*  Copyright (C) INTERSEC SA                                             */
-/*                                                                        */
-/*  Should you receive a copy of this source code, you must check you     */
-/*  have a proper, written authorization of INTERSEC to hold it. If you   */
-/*  don't have such an authorization, you must DELETE all source code     */
-/*  files in your possession, and inform INTERSEC of the fact you obtain  */
-/*  these files. Should you not comply to these terms, you can be         */
-/*  prosecuted in the extent permitted by applicable law.                 */
-/*                                                                        */
-/**************************************************************************/
-
 const _ = require('../tools.js');
 const {
     getOptions,

package/test/Store/selectItem.spec.js

@@ -1,16 +1,3 @@
-/**************************************************************************/
-/*                                                                        */
-/*  Copyright (C) INTERSEC SA                                             */
-/*                                                                        */
-/*  Should you receive a copy of this source code, you must check you     */
-/*  have a proper, written authorization of INTERSEC to hold it. If you   */
-/*  don't have such an authorization, you must DELETE all source code     */
-/*  files in your possession, and inform INTERSEC of the fact you obtain  */
-/*  these files. Should you not comply to these terms, you can be         */
-/*  prosecuted in the extent permitted by applicable law.                 */
-/*                                                                        */
-/**************************************************************************/
-
 const _ = require('../tools.js');
 const {
     getOptions,

package/test/Store/toggleSelectAll.spec.js

@@ -1,16 +1,3 @@
-/**************************************************************************/
-/*                                                                        */
-/*  Copyright (C) INTERSEC SA                                             */
-/*                                                                        */
-/*  Should you receive a copy of this source code, you must check you     */
-/*  have a proper, written authorization of INTERSEC to hold it. If you   */
-/*  don't have such an authorization, you must DELETE all source code     */
-/*  files in your possession, and inform INTERSEC of the fact you obtain  */
-/*  these files. Should you not comply to these terms, you can be         */
-/*  prosecuted in the extent permitted by applicable law.                 */
-/*                                                                        */
-/**************************************************************************/
-
 const _ = require('../tools.js');
 const {
     getOptions,

package/test/Tools/tools.spec.js

@@ -0,0 +1,404 @@
+const tape = require('tape');
+const toolFile = require('../dist/tools.js');
+
+const {
+    assignObject,
+    convertToRegExp,
+    deepClone,
+} = toolFile;
+
+tape.test('assignObject()', (st) => {
+    st.test('behaves like Object.assign', (tst) => {
+        const deep1 = {
+            dp: 1,
+        };
+        const deep2 = {
+            dp: 2,
+            other: 'value',
+        };
+        const obj1 = {
+            a: 1,
+            b: 2,
+            c: false,
+            deep: deep1,
+        };
+        const obj2 = {
+            a: 3,
+            c: true,
+            d: false,
+            deep: deep2,
+            other: {
+                attr: 'str',
+            },
+        };
+
+        const result = assignObject(obj1, obj2);
+
+        tst.is(result, obj1, 'should modify first argument');
+        tst.deepEqual(result, {
+            a: 3,
+            b: 2,
+            c: true,
+            d: false,
+            deep: {
+                dp: 2,
+                other: 'value',
+            },
+            other: {
+                attr: 'str',
+            },
+        }, 'should merge all attributes');
+        tst.is(result.deep, deep2, 'should keep references');
+        tst.deepEqual(obj2, {
+            a: 3,
+            c: true,
+            d: false,
+            deep: deep2,
+            other: {
+                attr: 'str',
+            },
+        }, 'should not change second argument');
+        tst.end();
+    });
+
+    st.test('accept multiple arguments', (tst) => {
+        const obj1 = {
+            a: 1,
+            b: 2,
+        };
+        const obj2 = {
+            a: 2,
+            c: 3,
+        };
+        const obj3 = {
+            a: 3,
+            d: 4,
+        };
+        const obj4 = {
+            a: 4,
+            e: 5,
+        };
+
+        const result = assignObject(obj1, obj2, obj3, obj4);
+
+        tst.is(result, obj1, 'should modify first argument');
+        tst.deepEqual(result, {
+            a: 4,
+            b: 2,
+            c: 3,
+            d: 4,
+            e: 5,
+        }, 'should merge all attributes');
+        tst.deepEqual(obj2, {
+            a: 2,
+            c: 3,
+        }, 'should not change second argument');
+        tst.deepEqual(obj3, {
+            a: 3,
+            d: 4,
+        }, 'should not change third argument');
+        tst.deepEqual(obj4, {
+            a: 4,
+            e: 5,
+        }, 'should not change fourth argument');
+        tst.end();
+    });
+
+    st.test('ignores undefined attributes', (tst) => {
+        const obj1 = {
+            a: 1, // modified by all
+            b: 2, // not modified by all (undefined)
+            c: 3, // obj2: undefined, modified by obj3
+            d: 4, // modified by obj2, obj3: undefined
+            e: 5, // not set by obj2, obj3: undefined
+            f: 6, // not set by all
+        };
+        const obj2 = {
+            a: 'a',
+            b: undefined,
+            c: undefined,
+            d: 'd',
+        };
+        const obj3 = {
+            a: 2,
+            b: undefined,
+            c: 'c',
+            d: undefined,
+            e: undefined,
+        };
+
+        const result = assignObject(obj1, obj2, obj3);
+
+        tst.is(result, obj1, 'should modify first argument');
+        tst.deepEqual(result, {
+            a: 2,
+            b: 2,
+            c: 'c',
+            d: 'd',
+            e: 5,
+            f: 6,
+        }, 'should merge all attributes');
+        tst.deepEqual(obj2, {
+            a: 'a',
+            b: undefined,
+            c: undefined,
+            d: 'd',
+        }, 'should not change second argument');
+        tst.deepEqual(obj3, {
+            a: 2,
+            b: undefined,
+            c: 'c',
+            d: undefined,
+            e: undefined,
+        }, 'should not change third argument');
+        tst.end();
+    });
+});
+
+tape.test('convertToRegExp()', (st) => {
+    st.test('convert wildcard', (tst) => {
+        const str = '*the search*';
+
+        const result = convertToRegExp(str);
+
+        tst.is(result instanceof RegExp, true, 'should create a RegExp');
+
+        const pattern = result.source;
+        const flags = result.flags;
+
+        tst.is(pattern, '.*the search.*', 'should create wildcard sequence');
+        tst.is(flags, 'i', 'should be case insensitive by default');
+
+        tst.end();
+    });
+    st.test('escape special characters', (tst) => {
+        const str = '\\^$.+?(){}[]|';
+
+        const result = convertToRegExp(str);
+
+        tst.is(result instanceof RegExp, true, 'should create a RegExp');
+
+        const pattern = result.source;
+        const flags = result.flags;
+
+        tst.is(pattern, '\\\\\\^\\$\\.\\+\\?\\(\\)\\{\\}\\[\\]\\|', 'should escape special characters');
+        tst.is(flags, 'i', 'should be case insensitive by default');
+
+        tst.end();
+    });
+
+    st.test('allow RegExp flags', (tst) => {
+        const str = 'file*.*';
+
+        const result = convertToRegExp(str, 'gm');
+
+        tst.is(result instanceof RegExp, true, 'should create a RegExp');
+
+        const pattern = result.source;
+        const flags = result.flags;
+
+        tst.is(pattern, 'file.*\\..*', 'should convert special characters');
+        tst.is(flags, 'gm', 'should set flags');
+
+        tst.end();
+    });
+});
+
+tape.test('deepClone()', (st) => {
+    st.test('should copy simple object', (tst) => {
+        const fn = () => {};
+        const objRef = {
+            a: 1,
+            b: 'b',
+            c: false,
+            d: undefined,
+            e: null,
+            f: {},
+            g: fn,
+            spe1: NaN,
+            spe2: Infinity,
+            spe3: '',
+            spe4: [],
+        };
+
+        const result = deepClone(objRef);
+
+        tst.isNot(result, objRef, 'should create a copy');
+        tst.deepEqual(result, objRef, 'should have been similar to original');
+
+        tst.end();
+    });
+
+    st.test('should copy nested object', (tst) => {
+        const fn = () => {};
+        const deep1 = {
+            a: 1,
+            b: 'b',
+            c: false,
+            d: undefined,
+            e: null,
+            f: {},
+            g: fn,
+            spe1: NaN,
+            spe2: Infinity,
+            spe3: '',
+            spe4: [],
+        };
+        const deep2 = {
+            deep: deep1,
+            added: 'a value',
+        };
+        const objRef = {
+            d: deep2,
+        }
+
+        const result = deepClone(objRef);
+
+        tst.isNot(result, objRef, 'should create a copy');
+        tst.deepEqual(result, objRef, 'should have been similar to original');
+        tst.isNot(result.d, deep2, 'should copy nested object');
+        tst.isNot(result.d.deep, deep1, 'should copy deeper nested object');
+
+        tst.end();
+    });
+
+
+    st.test('with arrays', (tst) => {
+        const fn = () => {};
+        const objRef = {
+            a: 1,
+            b: 'b',
+            c: false,
+            d: undefined,
+            e: null,
+            f: {},
+            g: fn,
+            spe1: NaN,
+            spe2: Infinity,
+            spe3: '',
+            spe4: [],
+        };
+        const nestedArray1 = [
+            objRef,
+            { a: 'value' },
+            null,
+            undefined,
+            42,
+            'value',
+        ];
+        const nestedArray2 = [
+            objRef,
+            { a: 'value' },
+            null,
+            undefined,
+            42,
+            'value',
+        ];
+        const arrayRef = [
+            {
+                deep: nestedArray1,
+            },
+            nestedArray2,
+            42, 'value', null, undefined, [[]],
+        ];
+
+        const result = deepClone(arrayRef);
+
+        tst.isNot(result, arrayRef, 'should create a copy');
+        tst.is(Array.isArray(arrayRef), true, 'should create an array');
+        tst.deepEqual(result, arrayRef, 'should have been similar to original');
+        tst.isNot(result[1], nestedArray2, 'should copy nested array');
+        tst.isNot(result[0].deep, nestedArray1, 'should copy deeper nested array');
+        tst.isNot(result[1][0], objRef, 'should copy nested object');
+        tst.isNot(result[0].deep[0], objRef, 'should copy deeper nested object');
+
+        tst.end();
+    });
+
+    st.test('with RegExp', (tst) => {
+        const r1 = /hello?/gi;
+        const r2 = /.* [aA]+?/;
+
+        const result1 = deepClone(r1);
+        const result2 = deepClone({rgx: r2});
+
+        tst.isNot(result1, r1, 'should copy RegExp');
+        tst.is(result1 instanceof RegExp, true, 'should create a RegExp');
+        tst.is(result1.source, 'hello?', 'should copy pattern');
+        tst.is(result1.flags, 'gi', 'should copy flags');
+
+        tst.isNot(result2.rgx, r2, 'should copy the RegExp');
+        tst.is(result2.rgx.source, '.* [aA]+?', 'should copy the attribute pattern');
+        tst.is(result2.rgx.flags, '', 'should copy the attribute flags');
+        tst.end();
+    });
+
+    st.test('with primitives', (tst) => {
+        const result1 = deepClone(1);
+        const result2 = deepClone('a');
+        const result3 = deepClone(false);
+        const result4 = deepClone(null);
+        const result5 = deepClone(undefined);
+
+        tst.is(result1, 1, 'should return number');
+        tst.is(result2, 'a', 'should return string');
+        tst.is(result3, false, 'should return boolean');
+        tst.is(result4, null, 'should return null');
+        tst.is(result5, undefined, 'should return undefined');
+        tst.end();
+    });
+
+    st.test('with circular references', (tst) => {
+        const obj1 = {
+            a: 'a',
+        }
+        const obj2 = {
+            b: 'b',
+        }
+        obj1.child = obj1;
+        obj1.sibling = obj2;
+        obj2.sibling = obj1;
+
+        const ref = [obj1, obj2];
+
+        const result = deepClone(ref);
+
+        tst.isNot(result, ref, 'should create a new object');
+        tst.isNot(result[0], obj1, 'should copy inner objects');
+        tst.is(result[0].child, result[0], 'should keep the circular reference');
+        tst.is(result[1].sibling, result[0], 'should keep similar references');
+        tst.is(result[0].sibling, result[1], 'should keep similar references (2)');
+
+        tst.end();
+    });
+
+    st.test('can ignore some attributes', (tst) => {
+        const noCopy1 = {
+            ref: 1,
+        };
+        const noCopy2 = new Set(['alpha', 'omega']);
+        const noCopy3 = new Map([[1, 'alpha'], [22, 'omega']]);
+        const deep1 = {
+            a: 'alpha',
+            noCopy: noCopy3,
+        };
+        const ref = {
+            id: 'ref',
+            noCopy: noCopy1,
+            nop: noCopy2,
+            not: 42,
+            deep: deep1,
+        };
+
+        const result = deepClone(ref, ['noCopy', 'nothing', 'nop', 'not']);
+
+        tst.isNot(result, ref, 'should create a new object');
+        tst.isNot(result.deep, deep1, 'should create a new object');
+        tst.is(result.noCopy, noCopy1, 'should keep original reference');
+        tst.is(result.nop, noCopy2, 'should keep original reference (2)');
+        tst.is(result.not, 42, 'should keep primitive');
+        tst.is(result.deep.noCopy, noCopy3, 'should keep nested original reference');
+
+        tst.end();
+    });
+});

package/types/tools.d.ts

@@ -1,10 +1,11 @@
 /**
  * Clone the object and its inner properties.
  * @param obj The object to be clone.
+ * @param attributes list of attributes to not clone.
  * @param refs internal reference to object to avoid cyclic references
  * @returns a copy of obj
  */
-export declare function deepClone<T = any>(obj: T, refs?: WeakMap<any, any>): T;
+export declare function deepClone<T = any>(origObject: T, ignoreAttributes?: string[], refs?: WeakMap<any, any>): T;
 /**
  * Escape search string to consider regexp special characters as they
  * are and not like special characters.