@rimbu/deep 1.1.0 → 2.0.1

package/dist/cjs/selector.cjs

@@ -1,581 +1,40 @@
 "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/selector.mts
-var selector_exports = {};
-__export(selector_exports, {
-  select: () => select
-});
-module.exports = __toCommonJS(selector_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;
-    }
-    return [result];
-  }
-  return deep_exports.patch(source, createPatchPart(0, source));
-}
-
-// 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;
-        }
-      }
-      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;
-        }
-      }
-      failureLog?.push(`in compound "some": no matches succeeded`);
-      return false;
-    }
-  }
-}
-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;
-        }
-      }
-      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;
-        }
-      }
-      return true;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.select = void 0;
+var internal_cjs_1 = require("./internal.cjs");
+/**
+ * Returns the result of applying the given `selector` shape to the given `source` value.
+ * @typeparam T - the patch value type
+ * @typeparam SL - the selector shape type
+ * @param source - the source value to select from
+ * @param selector - a shape indicating the selection from the source values
+ * @example
+ * ```ts
+ * const item = { a: { b:  1, c: 'a' } };
+ * Deep.select(item, { q: 'a.c', y: ['a.b', 'a.c'], z: (v) => v.a.b + 1 });
+ * // => { q: 'a', y: [1, 'a'], z: 2 }
+ * ```
+ */
+function select(source, selector) {
+    if (typeof selector === 'function') {
+        // selector is function, resolve selector function
+        return selector(source);
     }
-    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;
-        }
-      }
-      return true;
+    else if (typeof selector === 'string') {
+        // selector is string path, get the value at the given path
+        return internal_cjs_1.Deep.getAt(source, selector);
     }
-    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;
-        }
-      }
-      if (!singleMatched) {
-        failureLog?.push(
-          `in array traversal "singleItem": no item matched given matcher`
-        );
-        return false;
-      }
-      return true;
+    else if (Array.isArray(selector)) {
+        // selector is tuple, get each tuple item value
+        return selector.map(function (s) { return select(source, s); });
     }
-  }
-}
-
-// 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;
+    // selector is object
+    var result = {};
+    for (var key in selector) {
+        // set each selected object key to the selector value
+        result[key] = select(source, selector[key]);
     }
-  }
-  if (anyChange) {
     return result;
-  }
-  return value;
-}
-
-// 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/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;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  select
-});
+exports.select = select;
+//# sourceMappingURL=selector.cjs.map

package/dist/cjs/selector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.cjs","sourceRoot":"","sources":["../../_cjs_prepare/selector.cts"],"names":[],"mappings":";;;AAEA,+CAAiE;AAkDjE;;;;;;;;;;;;GAYG;AACH,SAAgB,MAAM,CACpB,MAAS,EACT,QAA4B;IAE5B,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,kDAAkD;QAClD,OAAQ,QAAgB,CAAC,MAAsB,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxC,2DAA2D;QAC3D,OAAO,mBAAI,CAAC,KAAK,CAAC,MAAM,EAAE,QAAuB,CAAQ,CAAC;IAC5D,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,+CAA+C;QAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,UAAC,CAAC,IAAK,OAAA,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAjB,CAAiB,CAAQ,CAAC;IACvD,CAAC;IAED,qBAAqB;IAErB,IAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,IAAM,GAAG,IAAI,QAAe,EAAE,CAAC;QAClC,qDAAqD;QACrD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAG,QAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAzBD,wBAyBC"}

package/dist/cjs/selector.d.cts

@@ -0,0 +1,47 @@
+import type { IsAnyFunc, IsArray } from '@rimbu/base';
+import { type Path, type Protected } from './internal.cjs';
+/**
+ * Type defining the allowed selectors on an object of type `T`.
+ * Selectors can be:
+ * - a path string into type `T`.
+ * - a function receiving a `Protected` version of type `T`, and returning an arbitrary value.
+ * - a tuple of `Selectors` for type `T`
+ * - an object where the property values are `Selectors` for type `T`.
+ * @typeparam T - the source value type.
+ */
+export type Selector<T> = Path.Get<T> | ((value: Protected<T>) => any) | readonly Selector<T>[] | {
+    readonly [key: string | symbol]: Selector<T>;
+};
+export declare namespace Selector {
+    /**
+     * Type defining the shape of allowed selectors, used to improve compiler checking.
+     * @typeparam SL - the selector type
+     */
+    type Shape<SL> = IsAnyFunc<SL> extends true ? SL : IsArray<SL> extends true ? readonly [...(SL extends readonly unknown[] ? SL : never)] : SL extends {
+        readonly [key: string | number | symbol]: unknown;
+    } ? {
+        readonly [K in keyof SL]: Selector.Shape<SL[K]>;
+    } : SL;
+    /**
+     * Type defining the result type of applying the SL selector type to the T value type.
+     * @typeparam T - the source value type
+     * @typeparam SL - the selector type
+     */
+    type Result<T, SL> = Selector<T> extends SL ? never : SL extends (...args: any[]) => infer R ? R : SL extends string ? Path.Result<T, SL> : {
+        readonly [K in keyof SL]: Selector.Result<T, SL[K]>;
+    };
+}
+/**
+ * Returns the result of applying the given `selector` shape to the given `source` value.
+ * @typeparam T - the patch value type
+ * @typeparam SL - the selector shape type
+ * @param source - the source value to select from
+ * @param selector - a shape indicating the selection from the source values
+ * @example
+ * ```ts
+ * const item = { a: { b:  1, c: 'a' } };
+ * Deep.select(item, { q: 'a.c', y: ['a.b', 'a.c'], z: (v) => v.a.b + 1 });
+ * // => { q: 'a', y: [1, 'a'], z: 2 }
+ * ```
+ */
+export declare function select<T, SL extends Selector<T>>(source: T, selector: Selector.Shape<SL>): Selector.Result<T, SL>;