@rimbu/deep 0.9.1 → 0.10.1

package/dist/main/patch.js

@@ -1,136 +1,155 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Patch = exports.patch = void 0;
+exports.patch = exports.patchNested = exports.Patch = void 0;
 var tslib_1 = require("tslib");
 var base_1 = require("@rimbu/base");
-var internal_1 = require("./internal");
-/**
- * Returns an updated version of given `value`, without modifying the value, where the contents
- * are updated according to the given `patches` Patch array.
- * @typeparam T - the type of the value to patch
- * @param value - the value to update
- * @param patches - one or more `Patch` objects indicating modifications to the value
- * @example
- * ```ts
- * patch({ g: { h: 5 }})({ g: { h: 6 }})          // => { g: { h: 6 }}
- * patch({ g: { h: 5 }})({ g: { h: v => v + 1 }}) // => { g: { h: 6 }}
- * patch({ g: { h: 5 }})({ g: { h: 1 }}, { g: { h: v => v + 1 }})
- * // => { g: { h: 2 }}
- * patch({ a: 1, b: 3 })({ a: (v, p) => v * p.b, (v, p) => v + p.a })
- * // => { a: 3, b: 4 }
- * ```
- */
-function patch(value) {
-    return function () {
-        var e_1, _a;
-        var patches = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            patches[_i] = arguments[_i];
-        }
-        var result = value;
-        try {
-            for (var patches_1 = (0, tslib_1.__values)(patches), patches_1_1 = patches_1.next(); !patches_1_1.done; patches_1_1 = patches_1.next()) {
-                var p = patches_1_1.value;
-                result = patchSingle(result, p, result, result);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (patches_1_1 && !patches_1_1.done && (_a = patches_1.return)) _a.call(patches_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        return result;
-    };
-}
-exports.patch = patch;
 var Patch;
 (function (Patch) {
-    Patch.MAP = Symbol('Patch.ALL');
     /**
-     * Returns a function that patches a given object of type `T` with the given `patches`
-     * Patch array.
-     * @typeparam T - the value type to operate on
-     * @typeparam T2 - the type the Patch is done for, should be equal to T
-     * @param patches - the patches to apply to a given object
+     * Returns a function that patches a given `value` with the given `patchItems`.
+     * @typeparam T - the patch value type
+     * @typeparam Q - the input value type
+     * @param patchItems - a number of `Patch` objects that patch a given value of type T.
      * @example
      * ```ts
-     * const r = Patch.create<{ a: number, b: number }>({ b: v => v + 1 })({ a: 1, b: 2})
-     * console.log(r)
-     * // => { a: 1, b: 3 }
+     * const items = [{ a: 1, b: 'a' }, { a: 2, b: 'b' }]
+     * items.map(Patch.create({ a: v => v + 1 }))
+     * // => [{ a: 2, b: 'a' }, { a: 3, b: 'b' }]
      * ```
      */
     function create() {
-        var patches = [];
+        var patchItems = [];
         for (var _i = 0; _i < arguments.length; _i++) {
-            patches[_i] = arguments[_i];
+            patchItems[_i] = arguments[_i];
         }
-        return function (value) {
-            return patch(value).apply(void 0, (0, tslib_1.__spreadArray)([], (0, tslib_1.__read)(patches), false));
-        };
+        return function (value) { return patch.apply(void 0, tslib_1.__spreadArray([value], tslib_1.__read(patchItems), false)); };
     }
     Patch.create = create;
 })(Patch = exports.Patch || (exports.Patch = {}));
-function patchSingle(value, patcher, parent, root) {
-    if (typeof patcher === 'function') {
-        return patcher(value, parent, root);
+var NestedObj = /** @class */ (function () {
+    function NestedObj(patchDataItems) {
+        this.patchDataItems = patchDataItems;
+    }
+    return NestedObj;
+}());
+/**
+ * Returns a nested patch object based on the given `patchDataItems` that work on a subpart
+ * of a larger object to be patched.
+ * @typeparam T - the input value type
+ * @typeparam R - the root object type
+ * @typeparam Q - the patch type
+ * @param patchDataItems - a number of `Patch` objects to be applied to the subpart of the object
+ * @example
+ * ```ts
+ * patch({ a: 1, b: { c: true, d: 'a' } }, { b: patchNested({ d: 'b' }) })
+ * // => { a: 1, b: { c: true, d: 'b' } }
+ * ```
+ */
+function patchNested() {
+    var patchDataItems = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        patchDataItems[_i] = arguments[_i];
+    }
+    return new NestedObj(patchDataItems);
+}
+exports.patchNested = patchNested;
+/**
+ * Returns an immutably updated version of the given `value` where the given `patchItems` have been
+ * applied to the result.
+ * @param value - the input value to patch
+ * @param patchItems - the `Patch` objects to apply to the input value
+ * @example
+ * ```ts
+ * const input = { a: 1, b: { c: true, d: 'a' } }
+ * patch(input, { a: 2 })  // => { a: 2, b: { c: true, d: 'a' } }
+ * patch(input: ($) => ({ b: $({ c: v => !v }) }) )
+ * // => { a: 1, b: { c: false, d: 'a' } }
+ * patch(input: ($) => ({ a: v => v + 1, b: $({ d: 'q' }) }) )
+ * // => { a: 2, b: { c: true, d: 'q' } }
+ * ```
+ */
+function patch(value) {
+    var patchItems = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        patchItems[_i - 1] = arguments[_i];
     }
-    if (null === value || undefined === value || typeof value !== 'object') {
-        if (typeof patcher !== 'object' || null === patcher)
-            return patcher;
-        if (internal_1.Literal.isLiteral(patcher)) {
-            return internal_1.Literal.getValue(patcher);
+    var newValue = (0, base_1.isPlainObj)(value) ? tslib_1.__assign({}, value) : value;
+    var changedRef = { changed: false };
+    var result = processPatch(newValue, newValue, patchItems, changedRef);
+    if (changedRef.changed)
+        return result;
+    return value;
+}
+exports.patch = patch;
+function processPatch(value, root, patchDataItems, changedRef) {
+    var i = -1;
+    var len = patchDataItems.length;
+    while (++i < len) {
+        var patchItem = patchDataItems[i];
+        if (patchItem instanceof Function) {
+            var item = patchItem(patchNested);
+            if (item instanceof NestedObj) {
+                processPatch(value, root, item.patchDataItems, changedRef);
+            }
+            else {
+                processPatchObj(value, root, item, changedRef);
+            }
+        }
+        else {
+            processPatchObj(value, root, patchItem, changedRef);
         }
+    }
+    return value;
+}
+function processPatchObj(value, root, patchData, changedRef) {
+    if (undefined === value || null === value) {
         return value;
     }
-    if (Array.isArray(patcher)) {
-        base_1.RimbuError.throwInvalidStateError();
+    if (!(0, base_1.isPlainObj)(patchData)) {
+        base_1.RimbuError.throwInvalidUsageError('patch: received patch object should be a plain object');
     }
-    if (typeof patcher !== 'object')
-        return patcher;
-    if (null === patcher)
-        return null;
-    if (internal_1.Literal.isLiteral(patcher)) {
-        return internal_1.Literal.getValue(patcher);
+    if (!(0, base_1.isPlainObj)(value)) {
+        base_1.RimbuError.throwInvalidUsageError('patch: received source object should be a plain object');
     }
-    var valueIsArray = Array.isArray(value);
-    if (!valueIsArray && !internal_1.Literal.isPlainObject(value))
-        return patcher;
-    if (valueIsArray && Patch.MAP in patcher) {
-        var arr = value;
-        var itemPatch = patcher[Patch.MAP];
-        var result = undefined;
-        for (var i = 0; i < arr.length; i++) {
-            var currentItem = arr[i];
-            var newItem = patchSingle(currentItem, itemPatch, value, root);
-            if (!Object.is(newItem, currentItem)) {
-                if (undefined === result) {
-                    result = arr.slice();
-                }
-                result[i] = newItem;
-            }
+    for (var key in patchData) {
+        var target = value[key];
+        // prevent prototype pollution
+        if (key === '__proto__' ||
+            (key === 'constructor' && target instanceof Function)) {
+            base_1.RimbuError.throwInvalidUsageError("patch: received patch object key '".concat(key, "' which is not allowed to prevent prototype pollution"));
         }
-        return (result !== null && result !== void 0 ? result : arr);
-    }
-    var clone = valueIsArray ? (0, tslib_1.__spreadArray)([], (0, tslib_1.__read)(value), false) : (0, tslib_1.__assign)({}, value);
-    var changed = false;
-    for (var key in patcher) {
-        var patchKey = patcher[key];
-        if (!(key in clone) && typeof patchKey === 'function')
-            continue;
-        var oldValue = clone[key];
-        if (undefined === patchKey) {
-            base_1.RimbuError.throwInvalidUsageError('Do not use undefined directly in patch objects, but use Literal.of(undefined) instead due to type limitations.');
+        var update = patchData[key];
+        if (!(key in value) && update instanceof Function) {
+            base_1.RimbuError.throwInvalidUsageError("patch: received update function object key ".concat(key, " but the key was not present in the source object. Either explicitely set the value in the source to undefined or use a direct value."));
+        }
+        if (undefined === update) {
+            base_1.RimbuError.throwInvalidUsageError("patch: received 'undefined' as patch value. Due to type system issues we cannot prevent this through typing, but please use '() => undefined'  or '() => yourVar' instead. This value will be ignored for safety.");
         }
-        var newValue = patchSingle(oldValue, patchKey, value, root);
-        if (oldValue !== newValue) {
-            changed = true;
-            clone[key] = newValue;
+        var newValue = void 0;
+        if (update instanceof Function) {
+            newValue = processPatchObjItem(target, root, update(target, value, root), changedRef);
+        }
+        else {
+            newValue = processPatchObjItem(target, root, update, changedRef);
+        }
+        if (!Object.is(newValue, target)) {
+            value[key] = newValue;
+            changedRef.changed = true;
         }
     }
-    if (changed)
-        return clone;
     return value;
 }
+function processPatchObjItem(value, root, patchResult, superChangedRef) {
+    if (patchResult instanceof NestedObj) {
+        var newValue = (0, base_1.isPlainObj)(value) ? tslib_1.__assign({}, value) : value;
+        var changedRef = { changed: false };
+        var result = processPatch(newValue, root, patchResult.patchDataItems, changedRef);
+        if (changedRef.changed) {
+            superChangedRef.changed = true;
+            return result;
+        }
+        return value;
+    }
+    return patchResult;
+}
 //# sourceMappingURL=patch.js.map

package/dist/main/patch.js.map

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

package/dist/main/path.js

@@ -13,18 +13,18 @@ var Path;
      * @param path - the path into the object
      * @example
      * ```ts
-     * console.log(Path.getValue({ a: { b: { c: 5 } } }), 'a.b')
+     * console.log(Path.get({ a: { b: { c: 5 } } }), 'a.b')
      * // => { c: 5 }
-     * console.log(Path.getValue({ a: { b: { c: 5 } } }), 'a.b.c')
+     * console.log(Path.get({ a: { b: { c: 5 } } }), 'a.b.c')
      * // => 5
      * ```
      */
-    function getValue(source, path) {
+    function get(source, path) {
         var e_1, _a;
         var items = path.split('.');
         var result = source;
         try {
-            for (var items_1 = (0, tslib_1.__values)(items), items_1_1 = items_1.next(); !items_1_1.done; items_1_1 = items_1.next()) {
+            for (var items_1 = tslib_1.__values(items), items_1_1 = items_1.next(); !items_1_1.done; items_1_1 = items_1.next()) {
                 var item = items_1_1.value;
                 result = result[item];
             }
@@ -38,7 +38,7 @@ var Path;
         }
         return result;
     }
-    Path.getValue = getValue;
+    Path.get = get;
     /**
      * Sets the value at the given path in the source to the given value.
      * @param source - the object to update
@@ -46,20 +46,22 @@ var Path;
      * @param value - the new value to set at the given position
      * @example
      * ```ts
-     * console.log(Path.setValue({ a: { b: { c: 5  } } }))
+     * console.log(Path.update({ a: { b: { c: 5 } } }, 'a.b.c', v => v + 5)
+     * // => { a: { b: { c: 6 } } }
      * ```
      */
-    function setValue(source, path, value) {
+    function update(source, path, value) {
         var e_2, _a;
         var items = path.split('.');
         var last = items.pop();
-        var result = (0, tslib_1.__assign)({}, source);
-        var current = result;
+        var root = {};
+        var current = root;
         try {
-            for (var items_2 = (0, tslib_1.__values)(items), items_2_1 = items_2.next(); !items_2_1.done; items_2_1 = items_2.next()) {
+            for (var items_2 = tslib_1.__values(items), items_2_1 = items_2.next(); !items_2_1.done; items_2_1 = items_2.next()) {
                 var item = items_2_1.value;
-                current[item] = (0, tslib_1.__assign)({}, current[item]);
-                current = current[item];
+                var next = {};
+                current[item] = (0, internal_1.patchNested)(next);
+                current = next;
             }
         }
         catch (e_2_1) { e_2 = { error: e_2_1 }; }
@@ -69,36 +71,9 @@ var Path;
             }
             finally { if (e_2) throw e_2.error; }
         }
-        var oldValue = current[last];
-        if (Object.is(oldValue, value))
-            return source;
         current[last] = value;
-        return result;
-    }
-    Path.setValue = setValue;
-    /**
-     * Patches the value at the given path in the source to the given value using the given
-     * `patches`.
-     * @param source - the object to update
-     * @param path - the path in the object to update
-     * @param patches - one or more patches to update the value at the given path
-     * @example
-     * ```ts
-     * console.log(Path.setValue({ a: { b: { c: 5 } } }, 'a.b.c', 8)
-     * // => { a: { b: { c: 8 } } }
-     * ```
-     */
-    function patchValue(source, path) {
-        var patches = [];
-        for (var _i = 2; _i < arguments.length; _i++) {
-            patches[_i - 2] = arguments[_i];
-        }
-        var value = Path.getValue(source, path);
-        var newValue = (0, internal_1.patch)(value).apply(void 0, (0, tslib_1.__spreadArray)([], (0, tslib_1.__read)(patches), false));
-        if (Object.is(value, newValue))
-            return source;
-        return Path.setValue(source, path, newValue);
+        return (0, internal_1.patch)(source, root);
     }
-    Path.patchValue = patchValue;
+    Path.update = update;
 })(Path = exports.Path || (exports.Path = {}));
 //# sourceMappingURL=path.js.map

package/dist/main/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/path.ts"],"names":[],"mappings":";;;;AAAA,uCAAmD;AAcnD,IAAiB,IAAI,CAiHpB;AAjHD,WAAiB,IAAI;IAwBnB;;;;;;;;;;;;;OAaG;IACH,SAAgB,QAAQ,CACtB,MAAS,EACT,IAAO;;QAEP,IAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,MAAM,GAAQ,MAAM,CAAC;;YAEzB,KAAmB,IAAA,UAAA,sBAAA,KAAK,CAAA,4BAAA,+CAAE;gBAArB,IAAM,IAAI,kBAAA;gBACb,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;aACvB;;;;;;;;;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAbe,aAAQ,WAavB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,QAAQ,CACtB,MAAS,EACT,IAAO,EACP,KAAwB;;QAExB,IAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAE1B,IAAM,MAAM,6BAAQ,MAAM,CAAE,CAAC;QAE7B,IAAI,OAAO,GAAQ,MAAM,CAAC;;YAE1B,KAAmB,IAAA,UAAA,sBAAA,KAAK,CAAA,4BAAA,+CAAE;gBAArB,IAAM,IAAI,kBAAA;gBACb,OAAO,CAAC,IAAI,CAAC,6BAAQ,OAAO,CAAC,IAAI,CAAC,CAAE,CAAC;gBACrC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;aACzB;;;;;;;;;QAED,IAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAE9C,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAEtB,OAAO,MAAM,CAAC;IAChB,CAAC;IAxBe,aAAQ,WAwBvB,CAAA;IAED;;;;;;;;;;;OAWG;IACH,SAAgB,UAAU,CACxB,MAAS,EACT,IAAO;QACP,iBAA0C;aAA1C,UAA0C,EAA1C,qBAA0C,EAA1C,IAA0C;YAA1C,gCAA0C;;QAE1C,IAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAM,QAAQ,GAAG,IAAA,gBAAK,EAAC,KAAK,CAAC,kEAAI,OAAO,UAAC,CAAC;QAE1C,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,MAAM,CAAC;QAE9C,OAAO,IAAI,CAAC,QAAQ,CAAW,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IAXe,eAAU,aAWzB,CAAA;AACH,CAAC,EAjHgB,IAAI,GAAJ,YAAI,KAAJ,YAAI,QAiHpB"}
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/path.ts"],"names":[],"mappings":";;;;AAGA,uCAAgD;AAchD,IAAiB,IAAI,CAsFpB;AAtFD,WAAiB,IAAI;IAwBnB;;;;;;;;;;;;;OAaG;IACH,SAAgB,GAAG,CACjB,MAAuB,EACvB,IAAO;;QAEP,IAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,MAAM,GAAQ,MAAM,CAAC;;YAEzB,KAAmB,IAAA,UAAA,iBAAA,KAAK,CAAA,4BAAA,+CAAE;gBAArB,IAAM,IAAI,kBAAA;gBACb,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;aACvB;;;;;;;;;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAbe,QAAG,MAalB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,MAAM,CACpB,MAAuB,EACvB,IAAO,EACP,KAAgC;;QAEhC,IAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAE1B,IAAM,IAAI,GAAwB,EAAE,CAAC;QAErC,IAAI,OAAO,GAAG,IAAI,CAAC;;YAEnB,KAAmB,IAAA,UAAA,iBAAA,KAAK,CAAA,4BAAA,+CAAE;gBAArB,IAAM,IAAI,kBAAA;gBACb,IAAM,IAAI,GAAG,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAA,sBAAW,EAAC,IAAI,CAAC,CAAC;gBAClC,OAAO,GAAG,IAAI,CAAC;aAChB;;;;;;;;;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAEtB,OAAO,IAAA,gBAAK,EAAI,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IArBe,WAAM,SAqBrB,CAAA;AACH,CAAC,EAtFgB,IAAI,GAAJ,YAAI,KAAJ,YAAI,QAsFpB"}

package/dist/main/protected.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Protected = void 0;
+/**
+ * Returns the same value wrapped in the `Protected` type.
+ * @param value - the value to wrap
+ * @note does not perform any runtime protection, it is only a utility to easily add the `Protected`
+ * type to a value
+ * @example
+ * ```ts
+ * const obj = Protected({ a: 1, b: { c: true, d: [1] } })
+ * obj.a = 2        // compiler error: a is readonly
+ * obj.b.c = false  // compiler error: c is readonly
+ * obj.b.d.push(2)  // compiler error: d is a readonly array
+ * (obj as any).b.d.push(2)  // will actually mutate the object
+ * ```
+
+ * '
+ */
+function Protected(value) {
+    return value;
+}
+exports.Protected = Protected;
+//# sourceMappingURL=protected.js.map

package/dist/main/protected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected.js","sourceRoot":"","sources":["../../src/protected.ts"],"names":[],"mappings":";;;AA2BA;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,SAAS,CAAI,KAAQ;IACnC,OAAO,KAAY,CAAC;AACtB,CAAC;AAFD,8BAEC"}

package/dist/main/tuple.js

@@ -112,7 +112,7 @@ var Tuple;
         for (var _i = 1; _i < arguments.length; _i++) {
             values[_i - 1] = arguments[_i];
         }
-        return (0, tslib_1.__spreadArray)((0, tslib_1.__spreadArray)([], (0, tslib_1.__read)(tuple), false), (0, tslib_1.__read)(values), false);
+        return tslib_1.__spreadArray(tslib_1.__spreadArray([], tslib_1.__read(tuple), false), tslib_1.__read(values), false);
     }
     Tuple.append = append;
     /**

package/dist/main/tuple.js.map

@@ -1 +1 @@
-{"version":3,"file":"tuple.js","sourceRoot":"","sources":["../../src/tuple.ts"],"names":[],"mappings":";;;;AAAA,oCAAkC;AAQlC,IAAiB,KAAK,CAgLrB;AAhLD,WAAiB,KAAK;IAWpB;;;;;;;;OAQG;IACH,SAAgB,EAAE;QAAiC,gBAAY;aAAZ,UAAY,EAAZ,qBAAY,EAAZ,IAAY;YAAZ,2BAAY;;QAC7D,OAAO,MAAa,CAAC;IACvB,CAAC;IAFe,QAAE,KAEjB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,QAAQ,CACtB,KAAQ,EACR,KAAQ;QAER,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IALe,cAAQ,WAKvB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,KAAK,CAAyB,KAAQ;QACpD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAFe,WAAK,QAEpB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,MAAM,CAAyB,KAAQ;QACrD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAFe,YAAM,SAErB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,IAAI,CAClB,KAAyB;QAEzB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAQ,CAAC;IACxC,CAAC;IAJe,UAAI,OAInB,CAAA;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,QAAQ,CACtB,KAAQ,EACR,KAAQ,EACR,OAAqB;QAErB,OAAO,UAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAe,EAAE,OAAO,CAAM,CAAC;IAC1D,CAAC;IANe,cAAQ,WAMvB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,MAAM,CAGpB,KAAQ;QAAE,gBAAY;aAAZ,UAAY,EAAZ,qBAAY,EAAZ,IAAY;YAAZ,+BAAY;;QACtB,qFAAW,KAAK,+BAAK,MAAM,UAAE;IAC/B,CAAC;IALe,YAAM,SAKrB,CAAA;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,MAAM,CACpB,MAAU,EACV,MAAU;QAEV,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAQ,CAAC;IACtC,CAAC;IALe,YAAM,SAKrB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,IAAI,CAClB,KAA+B;QAE/B,OAAO,UAAG,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC;IAChC,CAAC;IAJe,UAAI,OAInB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,IAAI,CAClB,KAA+B;QAE/B,OAAO,UAAG,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC;IAChC,CAAC;IAJe,UAAI,OAInB,CAAA;AACH,CAAC,EAhLgB,KAAK,GAAL,aAAK,KAAL,aAAK,QAgLrB"}
+{"version":3,"file":"tuple.js","sourceRoot":"","sources":["../../src/tuple.ts"],"names":[],"mappings":";;;;AAAA,oCAAkC;AAQlC,IAAiB,KAAK,CAgLrB;AAhLD,WAAiB,KAAK;IAWpB;;;;;;;;OAQG;IACH,SAAgB,EAAE;QAAiC,gBAAY;aAAZ,UAAY,EAAZ,qBAAY,EAAZ,IAAY;YAAZ,2BAAY;;QAC7D,OAAO,MAAa,CAAC;IACvB,CAAC;IAFe,QAAE,KAEjB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,QAAQ,CACtB,KAAQ,EACR,KAAQ;QAER,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IALe,cAAQ,WAKvB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,KAAK,CAAyB,KAAQ;QACpD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAFe,WAAK,QAEpB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,MAAM,CAAyB,KAAQ;QACrD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAFe,YAAM,SAErB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,IAAI,CAClB,KAAyB;QAEzB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAQ,CAAC;IACxC,CAAC;IAJe,UAAI,OAInB,CAAA;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,QAAQ,CACtB,KAAQ,EACR,KAAQ,EACR,OAAqB;QAErB,OAAO,UAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAe,EAAE,OAAO,CAAM,CAAC;IAC1D,CAAC;IANe,cAAQ,WAMvB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,MAAM,CAGpB,KAAQ;QAAE,gBAAY;aAAZ,UAAY,EAAZ,qBAAY,EAAZ,IAAY;YAAZ,+BAAY;;QACtB,sEAAW,KAAK,0BAAK,MAAM,UAAE;IAC/B,CAAC;IALe,YAAM,SAKrB,CAAA;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,MAAM,CACpB,MAAU,EACV,MAAU;QAEV,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAQ,CAAC;IACtC,CAAC;IALe,YAAM,SAKrB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,IAAI,CAClB,KAA+B;QAE/B,OAAO,UAAG,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC;IAChC,CAAC;IAJe,UAAI,OAInB,CAAA;IAED;;;;;;;;;OASG;IACH,SAAgB,IAAI,CAClB,KAA+B;QAE/B,OAAO,UAAG,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC;IAChC,CAAC;IAJe,UAAI,OAInB,CAAA;AACH,CAAC,EAhLgB,KAAK,GAAL,aAAK,KAAL,aAAK,QAgLrB"}

package/dist/module/index.js

@@ -1,9 +1,10 @@
 /**
  * @packageDocumentation
  *
- * The `@rimbu/deep` package provides utilities to patch and match plain JavaScript objects..<br/>
+ * The `@rimbu/deep` package provides utilities to patch and match plain JavaScript objects.<br/>
  * <br/>
  * See the [Rimbu docs Deep overview page](/docs/deep/overview) for more information.
  */
-export * from './internal';
+export { patch, patchNested, Patch, match, Match, Path, Protected, } from './internal';
+export { Tuple } from './tuple';
 //# sourceMappingURL=index.js.map

package/dist/module/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,EACL,WAAW,EACX,KAAK,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/module/internal.js

@@ -1,7 +1,5 @@
-export * from './tuple';
-export * from './literal';
-export * from './immutable';
+export * from './protected';
 export * from './match';
-export * from './path';
 export * from './patch';
+export * from './path';
 //# sourceMappingURL=internal.js.map

package/dist/module/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAE5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}