@jdsalasc/solvejs-list 1.0.2 → 1.2.0

package/README.md

@@ -1,19 +1,16 @@
 # @jdsalasc/solvejs-list
 
-Array and list utilities for JavaScript and TypeScript.
+Zero-dependency array/list tools for common data transformation workflows.
+
+## Tools Included
+
+- `unique`, `compact`, `chunk`
+- `groupBy`, `keyBy`
+- `partition`, `intersection`
+- `sortBy`
 
 ## Install
 
 ```bash
 npm i @jdsalasc/solvejs-list
 ```
-
-## Example
-
-```ts
-import { unique, chunk, groupBy } from "@jdsalasc/solvejs-list";
-
-unique([1, 1, 2, 3]);
-chunk([1, 2, 3, 4], 2);
-groupBy(["one", "two", "three"], item => item.length);
-```

package/dist/cjs/index.cjs

@@ -4,6 +4,10 @@ exports.unique = unique;
 exports.compact = compact;
 exports.chunk = chunk;
 exports.groupBy = groupBy;
+exports.partition = partition;
+exports.keyBy = keyBy;
+exports.intersection = intersection;
+exports.sortBy = sortBy;
 /**
  * Removes duplicate values preserving first-seen order.
  *
@@ -57,4 +61,67 @@ function groupBy(values, selector) {
         return accumulator;
     }, {});
 }
+/**
+ * Partitions values into two groups based on a predicate.
+ *
+ * @param values - Input collection.
+ * @param predicate - Predicate function.
+ * @returns Tuple with `[matched, unmatched]` values.
+ */
+function partition(values, predicate) {
+    const matched = [];
+    const unmatched = [];
+    for (const value of values) {
+        if (predicate(value)) {
+            matched.push(value);
+        }
+        else {
+            unmatched.push(value);
+        }
+    }
+    return [matched, unmatched];
+}
+/**
+ * Creates an object map from list values keyed by selector output.
+ *
+ * @param values - Input collection.
+ * @param selector - Key selector function.
+ * @returns Object map of values by key.
+ */
+function keyBy(values, selector) {
+    return values.reduce((accumulator, value) => {
+        accumulator[selector(value)] = value;
+        return accumulator;
+    }, {});
+}
+/**
+ * Returns intersection between two arrays preserving order from the first one.
+ *
+ * @param left - Left collection.
+ * @param right - Right collection.
+ * @returns Values found in both collections.
+ */
+function intersection(left, right) {
+    const rightSet = new Set(right);
+    return left.filter((value) => rightSet.has(value));
+}
+/**
+ * Sorts values by selector output.
+ *
+ * @param values - Input collection.
+ * @param selector - Function selecting sortable key.
+ * @param order - Sort order.
+ * @returns New sorted array.
+ */
+function sortBy(values, selector, order = "asc") {
+    const factor = order === "asc" ? 1 : -1;
+    return [...values].sort((a, b) => {
+        const left = selector(a);
+        const right = selector(b);
+        if (left === right) {
+            return 0;
+        }
+        return left > right ? factor : -factor;
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;AAMA,wBAEC;AAQD,0BAEC;AAUD,sBAUC;AASD,0BASC;AAxDD;;;;;GAKG;AACH,SAAgB,MAAM,CAAI,MAAoB;IAC5C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAI,MAA0D;IACnF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAQ,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,KAAK,CAAI,MAAoB,EAAE,IAAY;IACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,OAAO,CAA2B,MAAoB,EAAE,QAAyB;IAC/F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,EAAoB,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -29,3 +29,36 @@ export declare function chunk<T>(values: readonly T[], size: number): T[][];
  * @returns Object whose keys map to grouped arrays.
  */
 export declare function groupBy<T, K extends PropertyKey>(values: readonly T[], selector: (value: T) => K): Record<K, T[]>;
+/**
+ * Partitions values into two groups based on a predicate.
+ *
+ * @param values - Input collection.
+ * @param predicate - Predicate function.
+ * @returns Tuple with `[matched, unmatched]` values.
+ */
+export declare function partition<T>(values: readonly T[], predicate: (value: T) => boolean): [T[], T[]];
+/**
+ * Creates an object map from list values keyed by selector output.
+ *
+ * @param values - Input collection.
+ * @param selector - Key selector function.
+ * @returns Object map of values by key.
+ */
+export declare function keyBy<T, K extends PropertyKey>(values: readonly T[], selector: (value: T) => K): Record<K, T>;
+/**
+ * Returns intersection between two arrays preserving order from the first one.
+ *
+ * @param left - Left collection.
+ * @param right - Right collection.
+ * @returns Values found in both collections.
+ */
+export declare function intersection<T>(left: readonly T[], right: readonly T[]): T[];
+/**
+ * Sorts values by selector output.
+ *
+ * @param values - Input collection.
+ * @param selector - Function selecting sortable key.
+ * @param order - Sort order.
+ * @returns New sorted array.
+ */
+export declare function sortBy<T, K extends number | string>(values: readonly T[], selector: (value: T) => K, order?: "asc" | "desc"): T[];

package/dist/esm/index.js

@@ -51,4 +51,67 @@ export function groupBy(values, selector) {
         return accumulator;
     }, {});
 }
+/**
+ * Partitions values into two groups based on a predicate.
+ *
+ * @param values - Input collection.
+ * @param predicate - Predicate function.
+ * @returns Tuple with `[matched, unmatched]` values.
+ */
+export function partition(values, predicate) {
+    const matched = [];
+    const unmatched = [];
+    for (const value of values) {
+        if (predicate(value)) {
+            matched.push(value);
+        }
+        else {
+            unmatched.push(value);
+        }
+    }
+    return [matched, unmatched];
+}
+/**
+ * Creates an object map from list values keyed by selector output.
+ *
+ * @param values - Input collection.
+ * @param selector - Key selector function.
+ * @returns Object map of values by key.
+ */
+export function keyBy(values, selector) {
+    return values.reduce((accumulator, value) => {
+        accumulator[selector(value)] = value;
+        return accumulator;
+    }, {});
+}
+/**
+ * Returns intersection between two arrays preserving order from the first one.
+ *
+ * @param left - Left collection.
+ * @param right - Right collection.
+ * @returns Values found in both collections.
+ */
+export function intersection(left, right) {
+    const rightSet = new Set(right);
+    return left.filter((value) => rightSet.has(value));
+}
+/**
+ * Sorts values by selector output.
+ *
+ * @param values - Input collection.
+ * @param selector - Function selecting sortable key.
+ * @param order - Sort order.
+ * @returns New sorted array.
+ */
+export function sortBy(values, selector, order = "asc") {
+    const factor = order === "asc" ? 1 : -1;
+    return [...values].sort((a, b) => {
+        const left = selector(a);
+        const right = selector(b);
+        if (left === right) {
+            return 0;
+        }
+        return left > right ? factor : -factor;
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAI,MAAoB;IAC5C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAI,MAA0D;IACnF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAQ,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAI,MAAoB,EAAE,IAAY;IACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAA2B,MAAoB,EAAE,QAAyB;IAC/F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,EAAoB,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jdsalasc/solvejs-list",
-  "version": "1.0.2",
-  "description": "List and array utilities for deduplication, grouping, chunking, and compacting values.",
+  "version": "1.2.0",
+  "description": "Zero-dependency list toolkit for JS/TS: chunk, groupBy, keyBy, partition, intersection, and sortBy.",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -43,10 +43,12 @@
     "node": ">=18"
   },
   "keywords": [
-    "array utilities",
+    "array utils",
+    "list utils",
     "groupby",
-    "chunk array",
-    "deduplicate array",
+    "partition",
+    "intersection",
+    "sortby",
     "solvejs"
   ]
 }