@thi.ng/csv 2.3.135 → 2.4.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-07-10T14:20:23Z
+- **Last updated**: 2025-07-13T21:35:34Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [2.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/csv@2.4.0) (2025-07-12)
+
+#### 🚀 Features
+
+- add `json()` higher-order cell transform ([d8a95dd](https://github.com/thi-ng/umbrella/commit/d8a95dd))
+
 ### [2.3.87](https://github.com/thi-ng/umbrella/tree/@thi.ng/csv@2.3.87) (2024-06-21)
 
 #### ♻️ Refactoring

package/README.md

@@ -87,7 +87,7 @@ For Node.js REPL:
 const csv = await import("@thi.ng/csv");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 1.53 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 1.56 KB
 
 ## Dependencies
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/csv",
-  "version": "2.3.135",
+  "version": "2.4.1",
   "description": "Customizable, transducer-based CSV parser/object mapper and transformer",
   "type": "module",
   "module": "./index.js",
@@ -42,7 +42,7 @@
     "@thi.ng/api": "^8.11.30",
     "@thi.ng/checks": "^3.7.10",
     "@thi.ng/strings": "^3.9.16",
-    "@thi.ng/transducers": "^9.5.1"
+    "@thi.ng/transducers": "^9.6.0"
   },
   "devDependencies": {
     "esbuild": "^0.25.6",
@@ -87,5 +87,5 @@
   "thi.ng": {
     "year": 2014
   },
-  "gitHead": "56d8f088389b22192a06e9a395b5eecebf47697a\n"
+  "gitHead": "a81765bd79046980463c56a8bd187f9aaa88dd65\n"
 }

package/transforms.d.ts

@@ -12,6 +12,13 @@ export declare const upper: CellTransform;
  * @param x -
  */
 export declare const lower: CellTransform;
+/**
+ * Higher-order cell parse value transform. Attempts to parse given input as
+ * JSON and returns it. Returns configured `defaultVal` in case of parse error.
+ *
+ * @param defaultVal
+ */
+export declare const json: (defaultVal?: any) => CellTransform;
 /**
  * Higher-order cell parse value transform. Attempts to parse cell values as
  * floating point number or returns `defaultVal` if not possible.

package/transforms.js

@@ -3,6 +3,13 @@ import { maybeParseFloat, maybeParseInt } from "@thi.ng/strings/parse";
 import { percent as $percent } from "@thi.ng/strings/percent";
 const upper = (x) => x.toUpperCase();
 const lower = (x) => x.toLowerCase();
+const json = (defaultVal) => (x) => {
+  try {
+    return JSON.parse(x);
+  } catch (e) {
+    return defaultVal;
+  }
+};
 const float = (defaultVal = 0) => (x) => maybeParseFloat(x, defaultVal);
 const int = (defaultVal = 0) => (x) => maybeParseInt(x, defaultVal, 10);
 const hex = (defaultVal = 0) => (x) => maybeParseInt(x, defaultVal, 16);
@@ -31,6 +38,7 @@ export {
   formatPercent,
   hex,
   int,
+  json,
   lower,
   oneOf,
   percent,