@thi.ng/csv 2.3.85 → 2.3.87

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-04-23T07:02:17Z
+- **Last updated**: 2024-06-21T19:34:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,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.3.87](https://github.com/thi-ng/umbrella/tree/@thi.ng/csv@2.3.87) (2024-06-21)
+
+#### ♻️ Refactoring
+
+- enforce uniform naming convention of internal functions ([56992b2](https://github.com/thi-ng/umbrella/commit/56992b2))
+
 ### [2.3.81](https://github.com/thi-ng/umbrella/tree/@thi.ng/csv@2.3.81) (2024-04-08)
 
 #### ♻️ Refactoring

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 192 standalone projects, maintained as part
+> This is one of 193 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -20,6 +20,7 @@
   - [Planned features](#planned-features)
 - [Installation](#installation)
 - [Dependencies](#dependencies)
+- [Usage examples](#usage-examples)
 - [API](#api)
 - [Authors](#authors)
 - [License](#license)
@@ -95,6 +96,16 @@ Package sizes (brotli'd, pre-treeshake): ESM: 1.53 KB
 - [@thi.ng/strings](https://github.com/thi-ng/umbrella/tree/develop/packages/strings)
 - [@thi.ng/transducers](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers)
 
+## Usage examples
+
+One project in this repo's
+[/examples](https://github.com/thi-ng/umbrella/tree/develop/examples)
+directory is using this package:
+
+| Screenshot                                                                                                               | Description                        | Live demo                                               | Source                                                                               |
+|:-------------------------------------------------------------------------------------------------------------------------|:-----------------------------------|:--------------------------------------------------------|:-------------------------------------------------------------------------------------|
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/geom-csv-piechart.png" width="240"/> | Piechart visualization of CSV data | [Demo](https://demo.thi.ng/umbrella/geom-csv-piechart/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/geom-csv-piechart) |
+
 ## API
 
 [Generated API docs](https://docs.thi.ng/umbrella/csv/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/csv",
-  "version": "2.3.85",
+  "version": "2.3.87",
   "description": "Customizable, transducer-based CSV parser/object mapper and transformer",
   "type": "module",
   "module": "./index.js",
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "https://github.com/thi-ng/umbrella.git"
   },
-  "homepage": "https://github.com/thi-ng/umbrella/tree/develop/packages/csv#readme",
+  "homepage": "https://thi.ng/csv",
   "funding": [
     {
       "type": "github",
@@ -36,16 +36,16 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.1",
-    "@thi.ng/checks": "^3.6.3",
-    "@thi.ng/strings": "^3.7.32",
-    "@thi.ng/transducers": "^9.0.4"
+    "@thi.ng/api": "^8.11.3",
+    "@thi.ng/checks": "^3.6.5",
+    "@thi.ng/strings": "^3.7.34",
+    "@thi.ng/transducers": "^9.0.6"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.43.0",
-    "esbuild": "^0.20.2",
-    "typedoc": "^0.25.12",
-    "typescript": "^5.4.3"
+    "@microsoft/api-extractor": "^7.47.0",
+    "esbuild": "^0.21.5",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.5.2"
   },
   "keywords": [
     "csv",
@@ -85,5 +85,5 @@
   "thi.ng": {
     "year": 2014
   },
-  "gitHead": "aed3421c21044c005fbcb7cc37965ccf85a870d2\n"
+  "gitHead": "154c95cf9d6bab32174498ec3b5b5d87e42be7f9\n"
 }

package/parse.js

@@ -32,8 +32,8 @@ function parseCSV(opts, src) {
     let isQuoted = false;
     let record = [];
     const init = (header2) => {
-      cols && (index = initIndex(header2, cols));
-      all && (revIndex = initRevIndex(header2));
+      cols && (index = __initIndex(header2, cols));
+      all && (revIndex = __initRevIndex(header2));
       first = false;
     };
     const collectAll = (row) => record.reduce(
@@ -54,22 +54,21 @@ function parseCSV(opts, src) {
       if ((!line.length || line.startsWith(comment)) && !isQuoted)
         return acc;
       if (!first) {
-        isQuoted = parseLine(
+        isQuoted = __parseLine(
           line,
           record,
           isQuoted,
           delim,
           quote
         );
-        if (isQuoted)
-          return acc;
+        if (isQuoted) return acc;
         const row = {};
         all && collectAll(row);
         index && collectIndexed(row);
         record = [];
         return reduce(acc, row);
       } else {
-        isQuoted = parseLine(
+        isQuoted = __parseLine(
           line,
           record,
           isQuoted,
@@ -116,20 +115,19 @@ function parseCSVSimple(opts, src) {
       if ((!line.length || line.startsWith(comment)) && !isQuoted)
         return acc;
       if (!first) {
-        isQuoted = parseLine(
+        isQuoted = __parseLine(
           line,
           record,
           isQuoted,
           delim,
           quote
         );
-        if (isQuoted)
-          return acc;
+        if (isQuoted) return acc;
         const row = cols ? collect() : record;
         record = [];
         return reduce(acc, row);
       } else {
-        isQuoted = parseLine(
+        isQuoted = __parseLine(
           line,
           record,
           isQuoted,
@@ -145,7 +143,7 @@ function parseCSVSimple(opts, src) {
 }
 const parseCSVFromString = (opts, src) => parseCSV(opts, split(src));
 const parseCSVSimpleFromString = (opts, src) => parseCSVSimple(opts, split(src));
-const parseLine = (line, acc, isQuoted, delim, quote) => {
+const __parseLine = (line, acc, isQuoted, delim, quote) => {
   let curr = "";
   let p = "";
   let openQuote = isQuoted;
@@ -162,10 +160,9 @@ const parseLine = (line, acc, isQuoted, delim, quote) => {
         curr += quote;
         p = "";
         continue;
-      } else if (line[i + 1] !== quote)
-        isQuoted = false;
+      } else if (line[i + 1] !== quote) isQuoted = false;
     } else if (!isQuoted && c === delim) {
-      collectCell(acc, curr, openQuote);
+      __collectCell(acc, curr, openQuote);
       openQuote = false;
       curr = "";
     } else if (c !== "\\") {
@@ -173,11 +170,11 @@ const parseLine = (line, acc, isQuoted, delim, quote) => {
     }
     p = c;
   }
-  curr !== "" && collectCell(acc, curr, openQuote);
+  curr !== "" && __collectCell(acc, curr, openQuote);
   return isQuoted;
 };
-const collectCell = (acc, curr, openQuote) => openQuote ? acc[acc.length - 1] += "\n" + curr : acc.push(curr);
-const initIndex = (line, cols) => isArray(cols) ? cols.reduce((acc, spec, i) => {
+const __collectCell = (acc, curr, openQuote) => openQuote ? acc[acc.length - 1] += "\n" + curr : acc.push(curr);
+const __initIndex = (line, cols) => isArray(cols) ? cols.reduce((acc, spec, i) => {
   if (spec) {
     const alias = spec.alias || line[i] || String(i);
     acc[alias] = { i, spec: { alias, ...spec } };
@@ -187,7 +184,7 @@ const initIndex = (line, cols) => isArray(cols) ? cols.reduce((acc, spec, i) =>
   (acc, id, i) => cols[id] ? (acc[id] = { i, spec: cols[id] }, acc) : acc,
   {}
 );
-const initRevIndex = (line) => line.reduce((acc, x, i) => (acc[i] = x, acc), {});
+const __initRevIndex = (line) => line.reduce((acc, x, i) => (acc[i] = x, acc), {});
 export {
   parseCSV,
   parseCSVFromString,

package/transforms.d.ts

@@ -64,11 +64,11 @@ export declare const url: CellTransform;
  * @param defaultVal
  */
 export declare const oneOf: <T>(mappings: IObjectOf<T>, defaultVal: T) => CellTransform;
-export declare const zeroPad: (digits: number) => (x: any, length?: number | undefined) => string;
+export declare const zeroPad: (digits: number) => (x: any, length?: number) => string;
 export declare const formatFloat: (prec?: number) => (x: number) => string;
 /**
  * Higher order cell value formatter. Takes normalized values and formats them
  * as percentage with given `precision` (number of fractional digits).
  */
-export declare const formatPercent: (prec?: number | undefined) => import("@thi.ng/strings").Stringer<number>;
+export declare const formatPercent: (prec?: number) => import("@thi.ng/strings").Stringer<number>;
 //# sourceMappingURL=transforms.d.ts.map

package/transforms.js

@@ -13,8 +13,7 @@ const epoch = (defaultVal = 0) => (x) => {
 };
 const date = (defaultVal) => (x) => {
   const epoch2 = Date.parse(x);
-  if (isNaN(epoch2))
-    return defaultVal;
+  if (isNaN(epoch2)) return defaultVal;
   const res = /* @__PURE__ */ new Date();
   res.setTime(epoch2);
   return res;