@rimbu/deep 2.0.0 → 2.0.2

package/dist/cjs/path.cjs

@@ -1,585 +1,126 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/path.mts
-var path_exports = {};
-__export(path_exports, {
-  Path: () => Path,
-  getAt: () => getAt,
-  patchAt: () => patchAt
-});
-module.exports = __toCommonJS(path_exports);
-
-// src/match.mts
-var import_base = require("@rimbu/base");
-function match(source, matcher, failureLog) {
-  return matchEntry(source, source, source, matcher, failureLog);
-}
-function matchEntry(source, parent, root, matcher, failureLog) {
-  if (Object.is(source, matcher)) {
-    return true;
-  }
-  if (matcher === null || matcher === void 0) {
-    failureLog?.push(
-      `value ${JSON.stringify(source)} did not match matcher ${matcher}`
-    );
-    return false;
-  }
-  if (typeof source === "function") {
-    const result = Object.is(source, matcher);
-    if (!result) {
-      failureLog?.push(
-        `both value and matcher are functions, but they do not have the same reference`
-      );
-    }
-    return result;
-  }
-  if (typeof matcher === "function") {
-    const matcherResult = matcher(source, parent, root);
-    if (typeof matcherResult === "boolean") {
-      if (!matcherResult) {
-        failureLog?.push(
-          `function matcher returned false for value ${JSON.stringify(source)}`
-        );
-      }
-      return matcherResult;
-    }
-    return matchEntry(source, parent, root, matcherResult, failureLog);
-  }
-  if ((0, import_base.isPlainObj)(source)) {
-    return matchPlainObj(source, parent, root, matcher, failureLog);
-  }
-  if (Array.isArray(source)) {
-    return matchArr(source, parent, root, matcher, failureLog);
-  }
-  failureLog?.push(
-    `value ${JSON.stringify(
-      source
-    )} does not match given matcher ${JSON.stringify(matcher)}`
-  );
-  return false;
-}
-function matchArr(source, parent, root, matcher, failureLog) {
-  if (Array.isArray(matcher)) {
-    const length = source.length;
-    if (length !== matcher.length) {
-      failureLog?.push(
-        `array lengths are not equal: value length ${source.length} !== matcher length ${matcher.length}`
-      );
-      return false;
-    }
-    let index = -1;
-    while (++index < length) {
-      if (!matchEntry(source[index], source, root, matcher[index], failureLog)) {
-        failureLog?.push(
-          `index ${index} does not match with value ${JSON.stringify(
-            source[index]
-          )} and matcher ${matcher[index]}`
-        );
-        return false;
-      }
-    }
-    return true;
-  }
-  if (typeof matcher === "object" && null !== matcher) {
-    if (`every` in matcher) {
-      return matchCompound(
-        source,
-        parent,
-        root,
-        ["every", ...matcher.every],
-        failureLog
-      );
-    }
-    if (`some` in matcher) {
-      return matchCompound(
-        source,
-        parent,
-        root,
-        ["some", ...matcher.some],
-        failureLog
-      );
-    }
-    if (`none` in matcher) {
-      return matchCompound(
-        source,
-        parent,
-        root,
-        ["none", ...matcher.none],
-        failureLog
-      );
-    }
-    if (`single` in matcher) {
-      return matchCompound(
-        source,
-        parent,
-        root,
-        ["single", ...matcher.single],
-        failureLog
-      );
-    }
-    if (`someItem` in matcher) {
-      return matchTraversal(
-        source,
-        root,
-        "someItem",
-        matcher.someItem,
-        failureLog
-      );
-    }
-    if (`everyItem` in matcher) {
-      return matchTraversal(
-        source,
-        root,
-        "everyItem",
-        matcher.everyItem,
-        failureLog
-      );
-    }
-    if (`noneItem` in matcher) {
-      return matchTraversal(
-        source,
-        root,
-        "noneItem",
-        matcher.noneItem,
-        failureLog
-      );
-    }
-    if (`singleItem` in matcher) {
-      return matchTraversal(
-        source,
-        root,
-        "singleItem",
-        matcher.singleItem,
-        failureLog
-      );
-    }
-  }
-  for (const index in matcher) {
-    const matcherAtIndex = matcher[index];
-    if (!(index in source)) {
-      failureLog?.push(
-        `index ${index} does not exist in source ${JSON.stringify(
-          source
-        )} but should match matcher ${JSON.stringify(matcherAtIndex)}`
-      );
-      return false;
-    }
-    const result = matchEntry(
-      source[index],
-      source,
-      root,
-      matcherAtIndex,
-      failureLog
-    );
-    if (!result) {
-      failureLog?.push(
-        `index ${index} does not match with value ${JSON.stringify(
-          source[index]
-        )} and matcher ${JSON.stringify(matcherAtIndex)}`
-      );
-      return false;
-    }
-  }
-  return true;
-}
-function matchPlainObj(source, parent, root, matcher, failureLog) {
-  if (Array.isArray(matcher)) {
-    return matchCompound(source, parent, root, matcher, failureLog);
-  }
-  for (const key in matcher) {
-    if (!(key in source)) {
-      failureLog?.push(
-        `key ${key} is specified in matcher but not present in value ${JSON.stringify(
-          source
-        )}`
-      );
-      return false;
-    }
-    const result = matchEntry(
-      source[key],
-      source,
-      root,
-      matcher[key],
-      failureLog
-    );
-    if (!result) {
-      failureLog?.push(
-        `key ${key} does not match in value ${JSON.stringify(
-          source[key]
-        )} with matcher ${JSON.stringify(matcher[key])}`
-      );
-      return false;
-    }
-  }
-  return true;
-}
-function matchCompound(source, parent, root, compound, failureLog) {
-  const matchType = compound[0];
-  const length = compound.length;
-  let index = 0;
-  switch (matchType) {
-    case "every": {
-      while (++index < length) {
-        const result = matchEntry(
-          source,
-          parent,
-          root,
-          compound[index],
-          failureLog
-        );
-        if (!result) {
-          failureLog?.push(
-            `in compound "every": match at index ${index} failed`
-          );
-          return false;
-        }
-      }
-      return true;
-    }
-    case "none": {
-      while (++index < length) {
-        const result = matchEntry(
-          source,
-          parent,
-          root,
-          compound[index],
-          failureLog
-        );
-        if (result) {
-          failureLog?.push(
-            `in compound "none": match at index ${index} succeeded`
-          );
-          return false;
-        }
-      }
-      return true;
-    }
-    case "single": {
-      let onePassed = false;
-      while (++index < length) {
-        const result = matchEntry(
-          source,
-          parent,
-          root,
-          compound[index],
-          failureLog
-        );
-        if (result) {
-          if (onePassed) {
-            failureLog?.push(
-              `in compound "single": multiple matches succeeded`
-            );
-            return false;
-          }
-          onePassed = true;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Path = void 0;
+exports.getAt = getAt;
+exports.patchAt = patchAt;
+var tslib_1 = require("tslib");
+var internal_cjs_1 = require("./internal.cjs");
+var Path;
+(function (Path) {
+    /**
+     * Regular expression used to split a path string into tokens.
+     */
+    Path.stringSplitRegex = /\?\.|\.|\[|\]/g;
+    /**
+     * Return the given `path` string split into an array of subpaths.
+     * @param path - the input string path
+     */
+    function stringSplit(path) {
+        return path.split(Path.stringSplitRegex);
+    }
+    Path.stringSplit = stringSplit;
+})(Path || (exports.Path = Path = {}));
+/**
+ * Returns the value resulting from selecting the given `path` in the given `source` object.
+ * It supports optional chaining for nullable values or values that may be undefined, and also
+ * for accessing objects inside an array.
+ * There is currently no support for forcing non-null (the `!` operator).
+ * @typeparam T - the object type to select in
+ * @typeparam P - a Path in object type T
+ * @param source - the object to select in
+ * @param path - the path into the object
+ * @example
+ * ```ts
+ * const value = { a: { b: { c: [{ d: 5 }, { d: 6 }] } } }
+ * Deep.getAt(value, 'a.b');
+ * // => { c: 5 }
+ * Deep.getAt(value, 'a.b.c');
+ * // => [{ d: 5 }, { d: 5 }]
+ * Deep.getAt(value, 'a.b.c[1]');
+ * // => { d: 6 }
+ * Deep.getAt(value, 'a.b.c[1]?.d');
+ * // => 6
+ * ```
+ */
+function getAt(source, path) {
+    var e_1, _a;
+    if (path === '') {
+        // empty path always directly returns source value
+        return source;
+    }
+    var items = Path.stringSplit(path);
+    // start with `source` as result value
+    var result = source;
+    try {
+        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;
+            if (undefined === item || item === '' || item === '[') {
+                // ignore irrelevant items
+                continue;
+            }
+            if (undefined === result || null === result) {
+                // optional chaining assumed and no value available, skip rest of path and return undefined
+                return undefined;
+            }
+            // set current result to subpath value
+            result = result[item];
         }
-      }
-      if (!onePassed) {
-        failureLog?.push(`in compound "single": no matches succeeded`);
-      }
-      return onePassed;
     }
-    case "some": {
-      while (++index < length) {
-        const result = matchEntry(
-          source,
-          parent,
-          root,
-          compound[index],
-          failureLog
-        );
-        if (result) {
-          return true;
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (items_1_1 && !items_1_1.done && (_a = items_1.return)) _a.call(items_1);
         }
-      }
-      failureLog?.push(`in compound "some": no matches succeeded`);
-      return false;
+        finally { if (e_1) throw e_1.error; }
     }
-  }
+    return result;
 }
-function matchTraversal(source, root, matchType, matcher, failureLog) {
-  let index = -1;
-  const length = source.length;
-  switch (matchType) {
-    case "someItem": {
-      while (++index < length) {
-        if (matchEntry(source[index], source, root, matcher, failureLog)) {
-          return true;
+/**
+ * Patches the value at the given path in the source to the given value.
+ * Because the path to update must exist in the `source` object, optional
+ * chaining and array indexing is not allowed.
+ * @param source - the object to update
+ * @param path - the path in the object to update
+ * @param patchItem - the patch for the value at the given path
+ * @example
+ * ```ts
+ * const value = { a: { b: { c: 5 } } };
+ * Deep.patchAt(value, 'a.b.c', v => v + 5);
+ * // => { a: { b: { c: 6 } } }
+ * ```
+ */
+function patchAt(source, path, patchItem) {
+    if (path === '') {
+        return internal_cjs_1.Deep.patch(source, patchItem);
+    }
+    var items = Path.stringSplit(path);
+    // creates a patch object based on the current path
+    function createPatchPart(index, target) {
+        var _a;
+        if (index === items.length) {
+            // processed all items, return the input `patchItem`
+            return patchItem;
         }
-      }
-      failureLog?.push(
-        `in array traversal "someItem": no items matched given matcher`
-      );
-      return false;
-    }
-    case "everyItem": {
-      while (++index < length) {
-        if (!matchEntry(source[index], source, root, matcher, failureLog)) {
-          failureLog?.push(
-            `in array traversal "everyItem": at least one item did not match given matcher`
-          );
-          return false;
+        var item = items[index];
+        if (undefined === item || item === '') {
+            // empty items can be ignored
+            return createPatchPart(index + 1, target);
         }
-      }
-      return true;
-    }
-    case "noneItem": {
-      while (++index < length) {
-        if (matchEntry(source[index], source, root, matcher, failureLog)) {
-          failureLog?.push(
-            `in array traversal "noneItem": at least one item matched given matcher`
-          );
-          return false;
+        if (item === '[') {
+            // next item is array index, set arrayMode to true
+            return createPatchPart(index + 1, target);
         }
-      }
-      return true;
-    }
-    case "singleItem": {
-      let singleMatched = false;
-      while (++index < length) {
-        if (matchEntry(source[index], source, root, matcher, failureLog)) {
-          if (singleMatched) {
-            failureLog?.push(
-              `in array traversal "singleItem": more than one item matched given matcher`
-            );
-            return false;
-          }
-          singleMatched = true;
+        // create object with subPart as property key, and the restuls of processing next parts as value
+        var result = (_a = {},
+            _a[item] = createPatchPart(index + 1, target[item]),
+            _a);
+        if (Array.isArray(target)) {
+            // target in source object is array/tuple, so the patch should be object
+            return result;
         }
-      }
-      if (!singleMatched) {
-        failureLog?.push(
-          `in array traversal "singleItem": no item matched given matcher`
-        );
-        return false;
-      }
-      return true;
-    }
-  }
-}
-
-// src/deep.mts
-var deep_exports = {};
-__export(deep_exports, {
-  getAt: () => getAt,
-  getAtWith: () => getAtWith,
-  match: () => match,
-  matchAt: () => matchAt,
-  matchAtWith: () => matchAtWith,
-  matchWith: () => matchWith,
-  patch: () => patch,
-  patchAt: () => patchAt,
-  patchAtWith: () => patchAtWith,
-  patchWith: () => patchWith,
-  protect: () => protect,
-  select: () => select,
-  selectAt: () => selectAt,
-  selectAtWith: () => selectAtWith,
-  selectWith: () => selectWith,
-  withType: () => withType
-});
-
-// src/patch.mts
-var import_base2 = require("@rimbu/base");
-function patch(value, patchItem) {
-  return patchEntry(value, value, value, patchItem);
-}
-function patchEntry(value, parent, root, patchItem) {
-  if (Object.is(value, patchItem)) {
-    return value;
-  }
-  if (typeof value === "function") {
-    return patchItem;
-  }
-  if (typeof patchItem === "function") {
-    const item = patchItem(value, parent, root);
-    return patchEntry(value, parent, root, item);
-  }
-  if ((0, import_base2.isPlainObj)(value)) {
-    return patchPlainObj(value, root, patchItem);
-  }
-  if (Array.isArray(value)) {
-    return patchArr(value, root, patchItem);
-  }
-  return patchItem;
-}
-function patchPlainObj(value, root, patchItem) {
-  if (!Array.isArray(patchItem)) {
-    return patchItem;
-  }
-  const result = { ...value };
-  let anyChange = false;
-  for (const entry of patchItem) {
-    const currentRoot = value === root ? { ...result } : root;
-    const parent = { ...result };
-    for (const key in entry) {
-      const currentValue = result[key];
-      const newValue = patchEntry(
-        currentValue,
-        parent,
-        currentRoot,
-        entry[key]
-      );
-      if (!Object.is(currentValue, newValue)) {
-        anyChange = true;
-        result[key] = newValue;
-      }
-    }
-  }
-  if (anyChange) {
-    return result;
-  }
-  return value;
-}
-function patchArr(value, root, patchItem) {
-  if (Array.isArray(patchItem)) {
-    return patchItem;
-  }
-  const result = [...value];
-  let anyChange = false;
-  for (const index in patchItem) {
-    const numIndex = index;
-    const currentValue = result[numIndex];
-    const newValue = patchEntry(
-      currentValue,
-      value,
-      root,
-      patchItem[index]
-    );
-    if (!Object.is(newValue, currentValue)) {
-      anyChange = true;
-      result[numIndex] = newValue;
-    }
-  }
-  if (anyChange) {
-    return result;
-  }
-  return value;
-}
-
-// src/selector.mts
-function select(source, selector) {
-  if (typeof selector === "function") {
-    return selector(source);
-  } else if (typeof selector === "string") {
-    return deep_exports.getAt(source, selector);
-  } else if (Array.isArray(selector)) {
-    return selector.map((s) => select(source, s));
-  }
-  const result = {};
-  for (const key in selector) {
-    result[key] = select(source, selector[key]);
-  }
-  return result;
-}
-
-// src/deep.mts
-function protect(source) {
-  return source;
-}
-function getAtWith(path) {
-  return (source) => deep_exports.getAt(source, path);
-}
-function patchWith(patchItem) {
-  return (source) => deep_exports.patch(source, patchItem);
-}
-function patchAtWith(path, patchItem) {
-  return (source) => deep_exports.patchAt(source, path, patchItem);
-}
-function matchWith(matcher) {
-  return (source) => deep_exports.match(source, matcher);
-}
-function matchAt(source, path, matcher) {
-  return deep_exports.match(deep_exports.getAt(source, path), matcher);
-}
-function matchAtWith(path, matcher) {
-  return (source) => deep_exports.matchAt(source, path, matcher);
-}
-function selectWith(selector) {
-  return (source) => deep_exports.select(source, selector);
-}
-function selectAt(source, path, selector) {
-  return deep_exports.select(deep_exports.getAt(source, path), selector);
-}
-function selectAtWith(path, selector) {
-  return (source) => deep_exports.selectAt(source, path, selector);
-}
-function withType() {
-  return deep_exports;
-}
-
-// src/path.mts
-var Path;
-((Path2) => {
-  Path2.stringSplitRegex = /\?\.|\.|\[|\]/g;
-  function stringSplit(path) {
-    return path.split(Path2.stringSplitRegex);
-  }
-  Path2.stringSplit = stringSplit;
-})(Path || (Path = {}));
-function getAt(source, path) {
-  if (path === "") {
-    return source;
-  }
-  const items = Path.stringSplit(path);
-  let result = source;
-  for (const item of items) {
-    if (void 0 === item || item === "" || item === "[") {
-      continue;
-    }
-    if (void 0 === result || null === result) {
-      return void 0;
-    }
-    result = result[item];
-  }
-  return result;
-}
-function patchAt(source, path, patchItem) {
-  if (path === "") {
-    return deep_exports.patch(source, patchItem);
-  }
-  const items = Path.stringSplit(path);
-  function createPatchPart(index, target) {
-    if (index === items.length) {
-      return patchItem;
-    }
-    const item = items[index];
-    if (void 0 === item || item === "") {
-      return createPatchPart(index + 1, target);
-    }
-    if (item === "[") {
-      return createPatchPart(index + 1, target);
-    }
-    const result = {
-      [item]: createPatchPart(index + 1, target[item])
-    };
-    if (Array.isArray(target)) {
-      return result;
+        // target in source is not an array, so it patch should be an array
+        return [result];
     }
-    return [result];
-  }
-  return deep_exports.patch(source, createPatchPart(0, source));
+    return internal_cjs_1.Deep.patch(source, createPatchPart(0, source));
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Path,
-  getAt,
-  patchAt
-});
+//# sourceMappingURL=path.cjs.map