@ts-fns/stdlib 0.1.0 → 0.2.0

package/dist/object/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["purry","purry","purry","purry","purry","purry","purry","purry","purry","purry"],"sources":["../../src/object/_globalAliases.ts","../../src/object/clone.ts","../../src/object/evolve.ts","../../src/object/forEach.ts","../../src/object/groupBy.ts","../../src/object/indexBy.ts","../../src/object/map.ts","../../src/object/merge.ts","../../src/object/omit.ts","../../src/object/pick.ts","../../src/object/set.ts","../../src/object/upsert.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/prefer-destructuring */\nexport const { fromEntries, hasOwn, is, keys, values } = Object;\n\n/**\n * @category Object\n * @function\n * @example\n * ```ts\n * entries({ a: 1, b: 2 }); // [['a', 1], ['b', 2]]\n * ```\n */\nexport const entries = Object.entries;\n","/**\n * Alias of structuredClone without the optional second argument\n */\nexport function clone<T>(data: T): T {\n  return globalThis.structuredClone(data);\n}\n","import type { Simplify } from 'type-fest';\n\nimport { purry } from '../function';\n\ntype Evolved<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }> = {\n  [K in keyof Obj]: Obj extends Record<K, infer T>\n    ? Evolver extends Record<K, (value: Obj[K]) => infer R>\n      ? R extends T\n        ? T\n        : unknown\n      : never\n    : never;\n};\n\nfunction evolveImplementation<\n  Obj extends object,\n  Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown },\n>(obj: Obj, evolver: Evolver): Simplify<Evolved<Obj, Evolver>> {\n  const evolved = (Object.entries(evolver) as [keyof Obj, (value: unknown) => unknown][]).reduce<\n    Partial<Record<keyof Obj, any>>\n  >((acc, [k, fn]) => {\n    // key must exist on obj, otherwise no value\n    if (Object.hasOwn(obj, k)) {\n      acc[k] = fn(obj[k]);\n    }\n    return acc;\n  }, {});\n\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n  return { ...obj, ...evolved } as any;\n}\n\nexport function evolve<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }>(\n  evolver: Evolver,\n): (obj: Obj) => Simplify<Evolved<Obj, Evolver>>;\nexport function evolve<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }>(\n  obj: Obj,\n  evolver: Evolver,\n): Simplify<Evolved<Obj, Evolver>>;\nexport function evolve(...args: unknown[]): unknown {\n  return purry(evolveImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction forEachImplementation<T>(\n  data: Record<string, T>,\n  callbackfn: (value: T, key: string) => void,\n): Record<string, T> {\n  for (const [k, v] of Object.entries(data)) {\n    callbackfn(v, k);\n  }\n  return data;\n}\n\nexport function forEach<T>(callbackfn: (value: T, key: string) => void): (data: Record<string, T>) => Record<string, T>;\nexport function forEach<T>(data: Record<string, T>, callbackfn: (value: T, key: string) => void): Record<string, T>;\nexport function forEach(...args: readonly unknown[]): unknown {\n  return purry(forEachImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction groupByImplementation<T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => string,\n): Partial<Record<string, T[]>> {\n  return Object.groupBy(items, keySelector);\n}\n\nexport function groupBy<T>(\n  keySelector: (item: T, index: number) => string,\n): (items: Iterable<T>) => Partial<Record<string, T[]>>;\nexport function groupBy<T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => string,\n): Partial<Record<string, T[]>>;\nexport function groupBy(...args: readonly unknown[]): unknown {\n  return purry(groupByImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction indexByImplementation<T>(\n  data: Iterable<T>,\n  keySelector: (item: T, index: number) => string,\n): Record<string, T> {\n  const asArray = [...data];\n  const len = asArray.length;\n  const rtnObj: Record<string, T> = {};\n  for (let i = 0; i < len; i += 1) {\n    const value = asArray[i]!;\n    rtnObj[keySelector(value, i)] = value;\n  }\n  return rtnObj;\n}\n\nexport function indexBy<T>(keySelector: (item: T, index: number) => string): (data: Iterable<T>) => Record<string, T>;\nexport function indexBy<T>(data: Iterable<T>, keySelector: (item: T, index: number) => string): Record<string, T>;\nexport function indexBy(...args: readonly unknown[]): unknown {\n  return purry(indexByImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction mapImplementation<T, U>(data: Record<string, T>, callbackfn: (value: T, key: string) => U): Record<string, U> {\n  const entries = Object.entries(data);\n  const len = entries.length;\n  const newObj: Record<string, U> = {};\n  for (let i = 0; i < len; i += 1) {\n    const [k, v] = entries[i]!;\n    newObj[k] = callbackfn(v, k);\n  }\n  return newObj;\n}\n\nexport function map<T, U>(callbackfn: (value: T, key: string) => U): (data: Record<string, T>) => Record<string, U>;\nexport function map<T, U>(data: Record<string, T>, callbackfn: (value: T, key: string) => U): Record<string, U>;\nexport function map(...args: readonly unknown[]): unknown {\n  return purry(mapImplementation, args);\n}\n","import type { Merge } from 'type-fest';\n\nimport { purry } from '../function';\n\nfunction mergeImplementation<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Obj, Other> {\n  return { ...left, ...right } as unknown as Merge<Obj, Other>;\n}\n\nexport function merge<Obj extends object, Other extends object>(right: Other): (left: Obj) => Merge<Obj, Other>;\nexport function merge<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Obj, Other>;\nexport function merge(...args: unknown[]): unknown {\n  return purry(mergeImplementation, args);\n}\n\nfunction mergeLeftImplementation<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Other, Obj> {\n  return { ...right, ...left } as unknown as Merge<Other, Obj>;\n}\n\nexport function mergeLeft<Obj extends object, Other extends object>(right: Other): (left: Obj) => Merge<Other, Obj>;\nexport function mergeLeft<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Other, Obj>;\nexport function mergeLeft(...args: unknown[]): unknown {\n  return purry(mergeLeftImplementation, args);\n}\n\nmerge.left = mergeLeft;\n","import { purry } from '../function/purry';\n\nfunction omitImplementation(data: Record<string, unknown>, keys: Iterable<string>): Record<string, unknown> {\n  const keysSet = new Set(keys);\n\n  const newObj: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (!keysSet.has(key)) {\n      newObj[key] = value;\n    }\n  }\n\n  return newObj;\n}\n\nexport function omit<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  keys: Iterable<Key>,\n): (data: Obj) => Omit<Obj, Key>;\nexport function omit<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  data: Obj,\n  keys: Iterable<Key>,\n): Omit<Obj, Key>;\nexport function omit(...args: readonly unknown[]): unknown {\n  return purry(omitImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction pickImplementation(data: Record<string, unknown>, keys: Iterable<string>): Record<string, unknown> {\n  const keysSet = new Set(keys);\n\n  const newObj: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (keysSet.has(key)) {\n      newObj[key] = value;\n    }\n  }\n\n  return newObj;\n}\n\nexport function pick<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  keys: Iterable<Key>,\n): (data: Obj) => Pick<Obj, Key>;\nexport function pick<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  data: Obj,\n  keys: Iterable<Key>,\n): Pick<Obj, Key>;\nexport function pick(...args: readonly unknown[]): unknown {\n  return purry(pickImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nexport function setImplementation<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, value: Obj[Key]): Obj {\n  return { ...obj, [key]: value };\n}\n\nexport function set<Obj extends object, Key extends keyof Obj>(key: Key, value: Obj[Key]): (obj: Obj) => Obj;\nexport function set<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, value: Obj[Key]): Obj;\nexport function set(...args: readonly unknown[]): unknown {\n  return purry(setImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction upsertImplementation<T>(\n  data: Record<string, T>,\n  key: string,\n  fn: (value: T | null | undefined) => T,\n): Record<string, T> {\n  if (!(key in data)) {\n    const updatedValue = fn(undefined);\n    return { ...data, [key]: updatedValue };\n  }\n\n  const value = data[key];\n\n  // this checks for both `undefined` and `null`\n  if (value == null) {\n    const updatedValue = fn(null);\n    return { ...data, [key]: updatedValue };\n  }\n\n  const updatedValue = fn(value);\n  return { ...data, [key]: updatedValue };\n}\n\n/**\n * Upsert is meant to be used on `Record<K, V>` types that have unknown keys that may or may not exists\n * The callback function is unique in that it will return `V | null | undefined`\n * * `V` is returned if the key is present and a value exists\n * * `null` is returned if the key is present, but is set to `null` or `undefined`\n * * `undefined` is returned if the key is not present\n */\nexport function upsert<T>(\n  key: string,\n  fn: (value: T | null | undefined) => T,\n): (data: Record<string, T>) => Record<string, T>;\nexport function upsert<T>(\n  data: Record<string, T>,\n  key: string,\n  fn: (value: T | null | undefined) => T,\n): Record<string, T>;\nexport function upsert(...args: readonly unknown[]): unknown {\n  return purry(upsertImplementation, args);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["purry","purry","purry","purry","purry","purry","purry","purry","purry","purry","purry"],"sources":["../../src/object/_globalAliases.ts","../../src/object/clone.ts","../../src/object/evolve.ts","../../src/object/forEach.ts","../../src/object/groupBy.ts","../../src/object/indexBy.ts","../../src/object/map.ts","../../src/object/merge.ts","../../src/object/mergeDeep.ts","../../src/object/omit.ts","../../src/object/pick.ts","../../src/object/set.ts","../../src/object/upsert.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/prefer-destructuring */\n\n/**\n * Creates an object from an iterable of key-value pairs.\n * @function\n *\n * @example\n * ```ts\n * fromEntries([['a', 1], ['b', 2]]); // { a: 1, b: 2 }\n * ```\n */\nexport const fromEntries = Object.fromEntries;\n\n/**\n * Checks whether an object has the specified property as its own property.\n * @function\n *\n * @example\n * ```ts\n * hasOwn({ a: 1 }, 'a'); // true\n * hasOwn({ a: 1 }, 'toString'); // false\n * ```\n */\nexport const hasOwn = Object.hasOwn;\n\n/**\n * Determines whether two values are the same value.\n * @function\n *\n * @example\n * ```ts\n * is(NaN, NaN); // true\n * is(0, -0); // false\n * ```\n */\nexport const is = Object.is;\n\n/**\n * Returns an array of an object's own enumerable string-keyed property names.\n * @function\n *\n * @example\n * ```ts\n * keys({ a: 1, b: 2 }); // ['a', 'b']\n * ```\n */\nexport const keys = Object.keys;\n\n/**\n * Returns an array of an object's own enumerable property values.\n * @function\n *\n * @example\n * ```ts\n * values({ a: 1, b: 2 }); // [1, 2]\n * ```\n */\nexport const values = Object.values;\n\n/**\n * Returns an array of an object's own enumerable string-keyed property key-value pairs.\n * @function\n *\n * @example\n * ```ts\n * entries({ a: 1, b: 2 }); // [['a', 1], ['b', 2]]\n * ```\n */\nexport const entries = Object.entries;\n","/**\n * Creates a deep clone of a value using `structuredClone`.\n *\n * @example\n * ```ts\n * clone({ a: 1, b: { c: 2 } }); // { a: 1, b: { c: 2 } }\n * ```\n */\nexport function clone<T>(data: T): T {\n  return globalThis.structuredClone(data);\n}\n","import type { Simplify } from 'type-fest';\n\nimport { purry } from '../function';\n\ntype Evolved<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }> = {\n  [K in keyof Obj]: Obj extends Record<K, infer T>\n    ? Evolver extends Record<K, (value: Obj[K]) => infer R>\n      ? R extends T\n        ? T\n        : unknown\n      : never\n    : never;\n};\n\nfunction evolveImplementation<\n  Obj extends object,\n  Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown },\n>(obj: Obj, evolver: Evolver): Simplify<Evolved<Obj, Evolver>> {\n  const evolved = (Object.entries(evolver) as [keyof Obj, (value: unknown) => unknown][]).reduce<\n    Partial<Record<keyof Obj, any>>\n  >((acc, [k, fn]) => {\n    // key must exist on obj, otherwise no value\n    if (Object.hasOwn(obj, k)) {\n      acc[k] = fn(obj[k]);\n    }\n    return acc;\n  }, {});\n\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n  return { ...obj, ...evolved } as any;\n}\n\n/**\n * Transforms selected properties of an object using per-key functions.\n * Only keys present on the object are evolved.\n *\n * @example\n * ```ts\n * evolve({ count: n => n + 1 })({ count: 1, name: 'Ada' }); // { count: 2, name: 'Ada' }\n * evolve({ count: 1, name: 'Ada' }, { count: n => n + 1 }); // { count: 2, name: 'Ada' }\n * ```\n */\nexport function evolve<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }>(\n  evolver: Evolver,\n): (obj: Obj) => Simplify<Evolved<Obj, Evolver>>;\nexport function evolve<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }>(\n  obj: Obj,\n  evolver: Evolver,\n): Simplify<Evolved<Obj, Evolver>>;\nexport function evolve(...args: unknown[]): unknown {\n  return purry(evolveImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction forEachImplementation<T>(\n  data: Record<string, T>,\n  callbackfn: (value: T, key: string) => void,\n): Record<string, T> {\n  for (const [k, v] of Object.entries(data)) {\n    callbackfn(v, k);\n  }\n  return data;\n}\n\n/**\n * Iterates over an object's own enumerable properties, invoking a callback for each entry.\n * Returns the original object.\n *\n * @example\n * ```ts\n * forEach((v, k) => console.log(k, v))({ a: 1, b: 2 });\n * forEach({ a: 1, b: 2 }, (v, k) => console.log(k, v));\n * ```\n */\nexport function forEach<T>(callbackfn: (value: T, key: string) => void): (data: Record<string, T>) => Record<string, T>;\nexport function forEach<T>(data: Record<string, T>, callbackfn: (value: T, key: string) => void): Record<string, T>;\nexport function forEach(...args: readonly unknown[]): unknown {\n  return purry(forEachImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction groupByImplementation<T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => string,\n): Partial<Record<string, T[]>> {\n  return Object.groupBy(items, keySelector);\n}\n\n/**\n * Groups iterable items into arrays keyed by a selector function.\n *\n * @example\n * ```ts\n * groupBy(x => String(x.length), ['a', 'bb', 'ccc']); // { '1': ['a'], '2': ['bb'], '3': ['ccc'] }\n * groupBy(x => String(x.length))(['a', 'bb', 'ccc']); // { '1': ['a'], '2': ['bb'], '3': ['ccc'] }\n * ```\n */\nexport function groupBy<T>(\n  keySelector: (item: T, index: number) => string,\n): (items: Iterable<T>) => Partial<Record<string, T[]>>;\nexport function groupBy<T>(\n  items: Iterable<T>,\n  keySelector: (item: T, index: number) => string,\n): Partial<Record<string, T[]>>;\nexport function groupBy(...args: readonly unknown[]): unknown {\n  return purry(groupByImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction indexByImplementation<T>(\n  data: Iterable<T>,\n  keySelector: (item: T, index: number) => string,\n): Record<string, T> {\n  const asArray = [...data];\n  const len = asArray.length;\n  const rtnObj: Record<string, T> = {};\n  for (let i = 0; i < len; i += 1) {\n    const value = asArray[i]!;\n    rtnObj[keySelector(value, i)] = value;\n  }\n  return rtnObj;\n}\n\n/**\n * Indexes iterable items into an object keyed by a selector function.\n * Later items overwrite earlier ones that share the same key.\n *\n * @example\n * ```ts\n * indexBy(x => x.id, [{ id: 'a', v: 1 }, { id: 'b', v: 2 }]); // { a: { id: 'a', v: 1 }, b: { id: 'b', v: 2 } }\n * indexBy(x => x.id)([{ id: 'a', v: 1 }]); // { a: { id: 'a', v: 1 } }\n * ```\n */\nexport function indexBy<T>(keySelector: (item: T, index: number) => string): (data: Iterable<T>) => Record<string, T>;\nexport function indexBy<T>(data: Iterable<T>, keySelector: (item: T, index: number) => string): Record<string, T>;\nexport function indexBy(...args: readonly unknown[]): unknown {\n  return purry(indexByImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction mapImplementation<T, U>(data: Record<string, T>, callbackfn: (value: T, key: string) => U): Record<string, U> {\n  const entries = Object.entries(data);\n  const len = entries.length;\n  const newObj: Record<string, U> = {};\n  for (let i = 0; i < len; i += 1) {\n    const [k, v] = entries[i]!;\n    newObj[k] = callbackfn(v, k);\n  }\n  return newObj;\n}\n\n/**\n * Maps over an object's own enumerable properties, transforming each value.\n *\n * @example\n * ```ts\n * map((v, k) => v * 2, { a: 1, b: 2 }); // { a: 2, b: 4 }\n * map(v => v * 2)({ a: 1, b: 2 }); // { a: 2, b: 4 }\n * ```\n */\nexport function map<T, U>(callbackfn: (value: T, key: string) => U): (data: Record<string, T>) => Record<string, U>;\nexport function map<T, U>(data: Record<string, T>, callbackfn: (value: T, key: string) => U): Record<string, U>;\nexport function map(...args: readonly unknown[]): unknown {\n  return purry(mapImplementation, args);\n}\n","import type { Merge } from 'type-fest';\n\nimport { purry } from '../function';\n\nfunction mergeImplementation<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Obj, Other> {\n  return { ...left, ...right } as unknown as Merge<Obj, Other>;\n}\n\n/**\n * Merges two objects, with properties from the right object taking precedence.\n *\n * @example\n * ```ts\n * merge({ a: 1 }, { b: 2 }); // { a: 1, b: 2 }\n * merge({ b: 3 })({ a: 1, b: 2 }); // { a: 1, b: 3 }\n * ```\n */\nexport function merge<Obj extends object, Other extends object>(right: Other): (left: Obj) => Merge<Obj, Other>;\nexport function merge<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Obj, Other>;\nexport function merge(...args: unknown[]): unknown {\n  return purry(mergeImplementation, args);\n}\n\nfunction mergeLeftImplementation<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Other, Obj> {\n  return { ...right, ...left } as unknown as Merge<Other, Obj>;\n}\n\nexport function mergeLeft<Obj extends object, Other extends object>(right: Other): (left: Obj) => Merge<Other, Obj>;\nexport function mergeLeft<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Other, Obj>;\nexport function mergeLeft(...args: unknown[]): unknown {\n  return purry(mergeLeftImplementation, args);\n}\n\n/**\n * Like `merge`, but gives precedence to properties from the left object.\n *\n * @example\n * ```ts\n * merge.left({ a: 1 }, { b: 2 }); // { a: 1, b: 2 }\n * merge.left({ b: 3 })({ a: 1, b: 2 }); // { a: 1, b: 3 }\n * ```\n */\nmerge.left = mergeLeft;\n","import type { MergeDeep } from 'type-fest';\n\nimport { purry } from '../function';\n\n// TODO: move this somewhere common\nfunction isObjectType(data: unknown): data is object {\n  return typeof data === 'object' && data !== null;\n}\n\nfunction mergeDeepImplementation<Left extends object, Right extends object>(\n  left: Left,\n  right: Right,\n): MergeDeep<Left, Right> {\n  // start in the reverse direction so the keys in other that don't exist on obj are there to start with\n  const nextObj = { ...right, ...left } as Record<string, unknown>;\n\n  // then go through all the keys in obj\n  for (const key of Object.keys(left)) {\n    // skipping in no present on other\n    // eslint-disable-next-line no-continue\n    if (!Object.hasOwn(right, key)) continue;\n\n    // apply recursively if both objects\n    // @ts-expect-error\n    const leftVal: unknown = left[key];\n    // @ts-expect-error\n    const rightVal: unknown = right[key];\n\n    // but not if either is an array\n    if (isObjectType(leftVal) && isObjectType(rightVal) && !Array.isArray(leftVal) && !Array.isArray(rightVal)) {\n      nextObj[key] = mergeDeepImplementation(leftVal, rightVal);\n    } else {\n      // @ts-expect-error\n      nextObj[key] = right[key];\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n  return nextObj as any;\n}\n\n/**\n * Recursively merges two objects, with properties from the right object taking precedence.\n *\n * @example\n * ```ts\n * mergeDeep({ a: { x: 1 } }, { a: { y: 2 }, b: 3 }); // { a: { x: 1, y: 2 }, b: 3 }\n * mergeDeep({ b: 3 })({ a: { x: 1 }, b: { y: 2 } }); // { a: { x: 1 }, b: 3 }\n * ```\n */\nexport function mergeDeep<Left extends object, Right extends object>(\n  right: Right,\n): (left: Left) => MergeDeep<Left, Right>;\nexport function mergeDeep<Left extends object, Right extends object>(left: Left, right: Right): MergeDeep<Left, Right>;\nexport function mergeDeep(...args: unknown[]): unknown {\n  return purry(mergeDeepImplementation, args);\n}\n\nfunction mergeDeepLeftImplementation<Left extends object, Right extends object>(\n  left: Left,\n  right: Right,\n): MergeDeep<Right, Left> {\n  return mergeDeepImplementation(right, left);\n}\n\nfunction mergeDeepLeft<Left extends object, Right extends object>(right: Right): (left: Left) => MergeDeep<Right, Left>;\nfunction mergeDeepLeft<Left extends object, Right extends object>(left: Left, right: Right): MergeDeep<Right, Left>;\nfunction mergeDeepLeft(...args: unknown[]): unknown {\n  return purry(mergeDeepLeftImplementation, args);\n}\n\n/**\n * Like `mergeDeep`, but gives precedence to properties from the left object.\n *\n * @example\n * ```ts\n * mergeDeep.left({ a: { x: 1 } }, { a: { y: 2 }, b: 3 }); // { a: { x: 1, y: 2 }, b: 3 }\n * mergeDeep.left({ b: 3 })({ a: { x: 1 }, b: { y: 2 } }); // { a: { x: 1 }, b: 3 }\n * ```\n */\nmergeDeep.left = mergeDeepLeft;\n","import { purry } from '../function/purry';\n\nfunction omitImplementation(data: Record<string, unknown>, keys: Iterable<string>): Record<string, unknown> {\n  const keysSet = new Set(keys);\n\n  const newObj: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (!keysSet.has(key)) {\n      newObj[key] = value;\n    }\n  }\n\n  return newObj;\n}\n\n/**\n * Creates a new object without the specified keys.\n *\n * @example\n * ```ts\n * omit(['b'], { a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }\n * omit(['b'])({ a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }\n * ```\n */\nexport function omit<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  keys: Iterable<Key>,\n): (data: Obj) => Omit<Obj, Key>;\nexport function omit<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  data: Obj,\n  keys: Iterable<Key>,\n): Omit<Obj, Key>;\nexport function omit(...args: readonly unknown[]): unknown {\n  return purry(omitImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction pickImplementation(data: Record<string, unknown>, keys: Iterable<string>): Record<string, unknown> {\n  const keysSet = new Set(keys);\n\n  const newObj: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (keysSet.has(key)) {\n      newObj[key] = value;\n    }\n  }\n\n  return newObj;\n}\n\n/**\n * Creates a new object containing only the specified keys.\n *\n * @example\n * ```ts\n * pick(['a', 'c'], { a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }\n * pick(['a', 'c'])({ a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }\n * ```\n */\nexport function pick<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  keys: Iterable<Key>,\n): (data: Obj) => Pick<Obj, Key>;\nexport function pick<Obj extends Record<string, unknown>, Key extends keyof Obj>(\n  data: Obj,\n  keys: Iterable<Key>,\n): Pick<Obj, Key>;\nexport function pick(...args: readonly unknown[]): unknown {\n  return purry(pickImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nexport function setImplementation<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, value: Obj[Key]): Obj {\n  return { ...obj, [key]: value };\n}\n\n/**\n * Returns a new object with a single property updated.\n *\n * @example\n * ```ts\n * set('b', 2, { a: 1 }); // { a: 1, b: 2 }\n * set('b', 2)({ a: 1 }); // { a: 1, b: 2 }\n * ```\n */\nexport function set<Obj extends object, Key extends keyof Obj>(key: Key, value: Obj[Key]): (obj: Obj) => Obj;\nexport function set<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, value: Obj[Key]): Obj;\nexport function set(...args: readonly unknown[]): unknown {\n  return purry(setImplementation, args);\n}\n","import { purry } from '../function/purry';\n\nfunction upsertImplementation<T>(\n  data: Record<string, T>,\n  key: string,\n  fn: (value: T | null | undefined) => T,\n): Record<string, T> {\n  if (!(key in data)) {\n    const updatedValue = fn(undefined);\n    return { ...data, [key]: updatedValue };\n  }\n\n  const value = data[key];\n\n  // this checks for both `undefined` and `null`\n  if (value == null) {\n    const updatedValue = fn(null);\n    return { ...data, [key]: updatedValue };\n  }\n\n  const updatedValue = fn(value);\n  return { ...data, [key]: updatedValue };\n}\n\n/**\n * Updates or inserts a value in a record.\n * The callback receives the current value, `null` when the key exists but is nullish, or `undefined` when the key is absent.\n *\n * @example\n * ```ts\n * upsert('a', v => (v ?? 0) + 1, { a: 1 }); // { a: 2 }\n * upsert('b', () => 0)({ a: 1 }); // { a: 1, b: 0 }\n * ```\n */\nexport function upsert<T>(\n  key: string,\n  fn: (value: T | null | undefined) => T,\n): (data: Record<string, T>) => Record<string, T>;\nexport function upsert<T>(\n  data: Record<string, T>,\n  key: string,\n  fn: (value: T | null | undefined) => T,\n): Record<string, T>;\nexport function upsert(...args: readonly unknown[]): unknown {\n  return purry(upsertImplementation, args);\n}\n"],"mappings":"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"}

package/dist/object/index.d.cts

@@ -1,24 +1,76 @@
 import { r as NotFoundError } from "../errors-CJsLpYo9.cjs";
-import { Merge, Simplify } from "type-fest";
+import { Merge, MergeDeep, Simplify } from "type-fest";
 
 //#region src/object/_globalAliases.d.ts
+/**
+ * Creates an object from an iterable of key-value pairs.
+ * @function
+ *
+ * @example
+ * ```ts
+ * fromEntries([['a', 1], ['b', 2]]); // { a: 1, b: 2 }
+ * ```
+ */
 declare const fromEntries: {
-    <T = any>(entries: Iterable<readonly [PropertyKey, T]>): {
-      [k: string]: T;
-    };
-    (entries: Iterable<readonly any[]>): any;
-  }, hasOwn: (o: object, v: PropertyKey) => boolean, is: (value1: any, value2: any) => boolean, keys: {
-    (o: object): string[];
-    (o: {}): string[];
-  }, values: {
-    <T>(o: {
-      [s: string]: T;
-    } | ArrayLike<T>): T[];
-    (o: {}): any[];
+  <T = any>(entries: Iterable<readonly [PropertyKey, T]>): {
+    [k: string]: T;
   };
+  (entries: Iterable<readonly any[]>): any;
+};
+/**
+ * Checks whether an object has the specified property as its own property.
+ * @function
+ *
+ * @example
+ * ```ts
+ * hasOwn({ a: 1 }, 'a'); // true
+ * hasOwn({ a: 1 }, 'toString'); // false
+ * ```
+ */
+declare const hasOwn: (o: object, v: PropertyKey) => boolean;
+/**
+ * Determines whether two values are the same value.
+ * @function
+ *
+ * @example
+ * ```ts
+ * is(NaN, NaN); // true
+ * is(0, -0); // false
+ * ```
+ */
+declare const is: (value1: any, value2: any) => boolean;
+/**
+ * Returns an array of an object's own enumerable string-keyed property names.
+ * @function
+ *
+ * @example
+ * ```ts
+ * keys({ a: 1, b: 2 }); // ['a', 'b']
+ * ```
+ */
+declare const keys: {
+  (o: object): string[];
+  (o: {}): string[];
+};
+/**
+ * Returns an array of an object's own enumerable property values.
+ * @function
+ *
+ * @example
+ * ```ts
+ * values({ a: 1, b: 2 }); // [1, 2]
+ * ```
+ */
+declare const values: {
+  <T>(o: {
+    [s: string]: T;
+  } | ArrayLike<T>): T[];
+  (o: {}): any[];
+};
 /**
- * @category Object
+ * Returns an array of an object's own enumerable string-keyed property key-value pairs.
  * @function
+ *
  * @example
  * ```ts
  * entries({ a: 1, b: 2 }); // [['a', 1], ['b', 2]]
@@ -33,30 +85,53 @@ declare const entries: {
 //#endregion
 //#region src/object/clone.d.ts
 /**
- * Alias of structuredClone without the optional second argument
+ * Creates a deep clone of a value using `structuredClone`.
+ *
+ * @example
+ * ```ts
+ * clone({ a: 1, b: { c: 2 } }); // { a: 1, b: { c: 2 } }
+ * ```
  */
 declare function clone<T>(data: T): T;
 //#endregion
 //#region src/object/evolve.d.ts
 type Evolved<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }> = { [K in keyof Obj]: Obj extends Record<K, infer T> ? Evolver extends Record<K, (value: Obj[K]) => infer R> ? R extends T ? T : unknown : never : never };
+/**
+ * Transforms selected properties of an object using per-key functions.
+ * Only keys present on the object are evolved.
+ *
+ * @example
+ * ```ts
+ * evolve({ count: n => n + 1 })({ count: 1, name: 'Ada' }); // { count: 2, name: 'Ada' }
+ * evolve({ count: 1, name: 'Ada' }, { count: n => n + 1 }); // { count: 2, name: 'Ada' }
+ * ```
+ */
 declare function evolve<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }>(evolver: Evolver): (obj: Obj) => Simplify<Evolved<Obj, Evolver>>;
 declare function evolve<Obj extends object, Evolver extends { [K in keyof Partial<Obj>]: (value: Obj[K]) => unknown }>(obj: Obj, evolver: Evolver): Simplify<Evolved<Obj, Evolver>>;
 //#endregion
 //#region src/object/forEach.d.ts
+/**
+ * Iterates over an object's own enumerable properties, invoking a callback for each entry.
+ * Returns the original object.
+ *
+ * @example
+ * ```ts
+ * forEach((v, k) => console.log(k, v))({ a: 1, b: 2 });
+ * forEach({ a: 1, b: 2 }, (v, k) => console.log(k, v));
+ * ```
+ */
 declare function forEach<T>(callbackfn: (value: T, key: string) => void): (data: Record<string, T>) => Record<string, T>;
 declare function forEach<T>(data: Record<string, T>, callbackfn: (value: T, key: string) => void): Record<string, T>;
 //#endregion
 //#region src/object/get.d.ts
 /**
- * Get a property from an object by key.
- *
- * @category Object
- * @param key - The key to get the property from.
- * @param obj - The object to get the property from.
+ * Gets a property from an object by key.
+ * Returns a not-found error when the property is missing or nullish.
  *
  * @example
  * ```ts
  * get('name', { name: 'John' }); // 'John'
+ * get('age')({ name: 'John' }); // NotFoundError
  * ```
  */
 declare function get<Obj extends object, Key extends keyof Obj>(key: Key): (obj: Obj) => NonNullable<Obj[Key]> | NotFoundError;
@@ -70,18 +145,55 @@ declare function getAssert<Obj extends object, Key extends keyof Obj>(key: Key):
 declare function getAssert<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key): NonNullable<Obj[Key]>;
 //#endregion
 //#region src/object/groupBy.d.ts
+/**
+ * Groups iterable items into arrays keyed by a selector function.
+ *
+ * @example
+ * ```ts
+ * groupBy(x => String(x.length), ['a', 'bb', 'ccc']); // { '1': ['a'], '2': ['bb'], '3': ['ccc'] }
+ * groupBy(x => String(x.length))(['a', 'bb', 'ccc']); // { '1': ['a'], '2': ['bb'], '3': ['ccc'] }
+ * ```
+ */
 declare function groupBy<T>(keySelector: (item: T, index: number) => string): (items: Iterable<T>) => Partial<Record<string, T[]>>;
 declare function groupBy<T>(items: Iterable<T>, keySelector: (item: T, index: number) => string): Partial<Record<string, T[]>>;
 //#endregion
 //#region src/object/indexBy.d.ts
+/**
+ * Indexes iterable items into an object keyed by a selector function.
+ * Later items overwrite earlier ones that share the same key.
+ *
+ * @example
+ * ```ts
+ * indexBy(x => x.id, [{ id: 'a', v: 1 }, { id: 'b', v: 2 }]); // { a: { id: 'a', v: 1 }, b: { id: 'b', v: 2 } }
+ * indexBy(x => x.id)([{ id: 'a', v: 1 }]); // { a: { id: 'a', v: 1 } }
+ * ```
+ */
 declare function indexBy<T>(keySelector: (item: T, index: number) => string): (data: Iterable<T>) => Record<string, T>;
 declare function indexBy<T>(data: Iterable<T>, keySelector: (item: T, index: number) => string): Record<string, T>;
 //#endregion
 //#region src/object/map.d.ts
+/**
+ * Maps over an object's own enumerable properties, transforming each value.
+ *
+ * @example
+ * ```ts
+ * map((v, k) => v * 2, { a: 1, b: 2 }); // { a: 2, b: 4 }
+ * map(v => v * 2)({ a: 1, b: 2 }); // { a: 2, b: 4 }
+ * ```
+ */
 declare function map<T, U>(callbackfn: (value: T, key: string) => U): (data: Record<string, T>) => Record<string, U>;
 declare function map<T, U>(data: Record<string, T>, callbackfn: (value: T, key: string) => U): Record<string, U>;
 //#endregion
 //#region src/object/merge.d.ts
+/**
+ * Merges two objects, with properties from the right object taking precedence.
+ *
+ * @example
+ * ```ts
+ * merge({ a: 1 }, { b: 2 }); // { a: 1, b: 2 }
+ * merge({ b: 3 })({ a: 1, b: 2 }); // { a: 1, b: 3 }
+ * ```
+ */
 declare function merge<Obj extends object, Other extends object>(right: Other): (left: Obj) => Merge<Obj, Other>;
 declare function merge<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Obj, Other>;
 declare namespace merge {
@@ -90,29 +202,77 @@ declare namespace merge {
 declare function mergeLeft<Obj extends object, Other extends object>(right: Other): (left: Obj) => Merge<Other, Obj>;
 declare function mergeLeft<Obj extends object, Other extends object>(left: Obj, right: Other): Merge<Other, Obj>;
 //#endregion
+//#region src/object/mergeDeep.d.ts
+/**
+ * Recursively merges two objects, with properties from the right object taking precedence.
+ *
+ * @example
+ * ```ts
+ * mergeDeep({ a: { x: 1 } }, { a: { y: 2 }, b: 3 }); // { a: { x: 1, y: 2 }, b: 3 }
+ * mergeDeep({ b: 3 })({ a: { x: 1 }, b: { y: 2 } }); // { a: { x: 1 }, b: 3 }
+ * ```
+ */
+declare function mergeDeep<Left extends object, Right extends object>(right: Right): (left: Left) => MergeDeep<Left, Right>;
+declare function mergeDeep<Left extends object, Right extends object>(left: Left, right: Right): MergeDeep<Left, Right>;
+declare namespace mergeDeep {
+  var left: typeof mergeDeepLeft;
+}
+declare function mergeDeepLeft<Left extends object, Right extends object>(right: Right): (left: Left) => MergeDeep<Right, Left>;
+declare function mergeDeepLeft<Left extends object, Right extends object>(left: Left, right: Right): MergeDeep<Right, Left>;
+//#endregion
 //#region src/object/omit.d.ts
+/**
+ * Creates a new object without the specified keys.
+ *
+ * @example
+ * ```ts
+ * omit(['b'], { a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }
+ * omit(['b'])({ a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }
+ * ```
+ */
 declare function omit<Obj extends Record<string, unknown>, Key extends keyof Obj>(keys: Iterable<Key>): (data: Obj) => Omit<Obj, Key>;
 declare function omit<Obj extends Record<string, unknown>, Key extends keyof Obj>(data: Obj, keys: Iterable<Key>): Omit<Obj, Key>;
 //#endregion
 //#region src/object/pick.d.ts
+/**
+ * Creates a new object containing only the specified keys.
+ *
+ * @example
+ * ```ts
+ * pick(['a', 'c'], { a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }
+ * pick(['a', 'c'])({ a: 1, b: 2, c: 3 }); // { a: 1, c: 3 }
+ * ```
+ */
 declare function pick<Obj extends Record<string, unknown>, Key extends keyof Obj>(keys: Iterable<Key>): (data: Obj) => Pick<Obj, Key>;
 declare function pick<Obj extends Record<string, unknown>, Key extends keyof Obj>(data: Obj, keys: Iterable<Key>): Pick<Obj, Key>;
 //#endregion
 //#region src/object/set.d.ts
 declare function setImplementation<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, value: Obj[Key]): Obj;
+/**
+ * Returns a new object with a single property updated.
+ *
+ * @example
+ * ```ts
+ * set('b', 2, { a: 1 }); // { a: 1, b: 2 }
+ * set('b', 2)({ a: 1 }); // { a: 1, b: 2 }
+ * ```
+ */
 declare function set<Obj extends object, Key extends keyof Obj>(key: Key, value: Obj[Key]): (obj: Obj) => Obj;
 declare function set<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, value: Obj[Key]): Obj;
 //#endregion
 //#region src/object/upsert.d.ts
 /**
- * Upsert is meant to be used on `Record<K, V>` types that have unknown keys that may or may not exists
- * The callback function is unique in that it will return `V | null | undefined`
- * * `V` is returned if the key is present and a value exists
- * * `null` is returned if the key is present, but is set to `null` or `undefined`
- * * `undefined` is returned if the key is not present
+ * Updates or inserts a value in a record.
+ * The callback receives the current value, `null` when the key exists but is nullish, or `undefined` when the key is absent.
+ *
+ * @example
+ * ```ts
+ * upsert('a', v => (v ?? 0) + 1, { a: 1 }); // { a: 2 }
+ * upsert('b', () => 0)({ a: 1 }); // { a: 1, b: 0 }
+ * ```
  */
 declare function upsert<T>(key: string, fn: (value: T | null | undefined) => T): (data: Record<string, T>) => Record<string, T>;
 declare function upsert<T>(data: Record<string, T>, key: string, fn: (value: T | null | undefined) => T): Record<string, T>;
 //#endregion
-export { clone, entries, evolve, forEach, fromEntries, get, getAssert, groupBy, hasOwn, indexBy, is, keys, map, merge, mergeLeft, omit, pick, set, setImplementation, upsert, values };
+export { clone, entries, evolve, forEach, fromEntries, get, groupBy, hasOwn, indexBy, is, keys, map, merge, mergeDeep, mergeLeft, omit, pick, set, setImplementation, upsert, values };
 //# sourceMappingURL=index.d.cts.map

package/dist/object/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/object/_globalAliases.ts","../../src/object/clone.ts","../../src/object/evolve.ts","../../src/object/forEach.ts","../../src/object/get.ts","../../src/object/groupBy.ts","../../src/object/indexBy.ts","../../src/object/map.ts","../../src/object/merge.ts","../../src/object/omit.ts","../../src/object/pick.ts","../../src/object/set.ts","../../src/object/upsert.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/object/_globalAliases.ts","../../src/object/clone.ts","../../src/object/evolve.ts","../../src/object/forEach.ts","../../src/object/get.ts","../../src/object/groupBy.ts","../../src/object/indexBy.ts","../../src/object/map.ts","../../src/object/merge.ts","../../src/object/mergeDeep.ts","../../src/object/omit.ts","../../src/object/pick.ts","../../src/object/set.ts","../../src/object/upsert.ts"],"mappings":"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"}