@jdsalasc/solvejs-list 1.4.1 → 1.5.2

package/README.md

@@ -13,9 +13,14 @@ Zero-dependency array/list utilities for JavaScript and TypeScript.
 - `intersection`, `difference`
 - `sortBy`
 
-## When to use this package
-
-Use it when you repeatedly write list transformation logic and want consistent, tested helpers for grouping, deduplication, and sorting.
+## When to use this package
+
+Use it when you repeatedly write list transformation logic and want consistent, tested helpers for grouping, deduplication, and sorting.
+
+## Limitations and Constraints
+
+- Sorting/grouping semantics rely on mapper outputs and do not infer locale-aware collation.
+- Large-list performance depends on data shape and key cardinality; benchmark with production-like payloads.
 
 ## Install
 
@@ -31,5 +36,9 @@ import { uniqueBy, groupBy, sortBy } from "@jdsalasc/solvejs-list";
 const rows = [{ id: "a", team: "x", score: 2 }, { id: "a", team: "x", score: 2 }, { id: "b", team: "y", score: 1 }];
 const uniqueRows = uniqueBy(rows, (r) => r.id);
 const byTeam = groupBy(uniqueRows, (r) => r.team);
-sortBy(byTeam.x, (r) => r.score, "desc");
-```
+sortBy(byTeam.x, (r) => r.score, "desc");
+```
+
+## Scale note
+
+For high-volume pipelines (`10k`/`100k` rows), run `npm run benchmark` from the monorepo to profile `uniqueBy`, `groupBy`, and `sortBy` with your real data shape.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jdsalasc/solvejs-list",
-  "version": "1.4.1",
+  "version": "1.5.2",
   "description": "Zero-dependency JavaScript/TypeScript list utilities for production: uniqueBy, groupBy, keyBy, partition, intersection, difference, chunk, and sortBy.",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
     "build:cjs": "tsc -p tsconfig.cjs.json && node ./scripts/rename-cjs.mjs",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "test": "npm run build && node --test test/*.test.mjs",
-    "lint": "node -e \"console.log('No lint configured for @jdsalasc/solvejs-list')\""
+    "lint": "tsc -p tsconfig.esm.json --noEmit"
   },
   "publishConfig": {
     "access": "public"