@jackens/nnn 2025.6.20 → 2025.9.3

package/nnn.d.ts

@@ -23,11 +23,7 @@ export declare const c: (root: C_Root, splitter?: string) => string;
 /**
  * A tiny helper for parsing CSV.
  */
-export declare const csv_parse_raw: (csv: string, separator?: string) => string[][];
-/**
- * A tiny helper for parsing CSV.
- */
-export declare const csv_parse: (csv: string, separator?: string) => Record<PropertyKey, string>[];
+export declare const csv_parse: (csv: string, separator?: string) => string[][];
 /**
  * The type of arguments of the `escape_values` and `escape` helpers.
  */
@@ -96,18 +92,27 @@ export declare const has_own: (ref: unknown, key: unknown) => boolean;
  * A helper that checks if the given argument is of type `any[]`.
  */
 export declare const is_array: (arg: any) => arg is any[];
+declare const FINITE_NUMBER: unique symbol;
+type Finite_Number = number & {
+    readonly [FINITE_NUMBER]: true;
+};
+/**
+ * A helper that checks if the given argument is of type `number` but not `±Infinity` nor `NaN`.
+ */
+export declare const is_finite_number: ((arg: unknown) => arg is Finite_Number);
 /**
  * A helper that checks if the given argument is of type `number`.
  */
-export declare const is_number: (arg: any) => arg is number;
+export declare const is_number: (arg: unknown) => arg is number;
 /**
  * A helper that checks if the given argument is of type `Record<PropertyKey, unknown>`.
  */
-export declare const is_record: (arg: any) => arg is Record<PropertyKey, unknown>;
+export declare const is_record: (arg: unknown) => arg is Record<PropertyKey, unknown>;
 /**
  * A helper that checks if the given argument is of type `string`.
  */
-export declare const is_string: (arg: any) => arg is string;
+export declare const is_string: (arg: unknown) => arg is string;
+export {};
 /**
  * `JSON.parse` with “JavaScript turned on”.
  *

package/nnn.js

@@ -1,5 +1,6 @@
 // src/nnn/is.ts
 var is_array = Array.isArray;
+var is_finite_number = Number.isFinite;
 var is_number = (arg) => typeof arg === "number";
 var is_record = (arg) => typeof arg === "object" && arg != null && !is_array(arg);
 var is_string = (arg) => typeof arg === "string";
@@ -57,19 +58,11 @@ var c = (root, splitter = "$$") => {
   return chunks.join("");
 };
 // src/nnn/csv_parse.ts
-var csv_parse_raw = (csv, separator = ",") => {
+var csv_parse = (csv, separator = ",") => {
   const main_pattern = /\n|(?<!")("(?:[^"]|"")*")(?!")/g;
   const line_pattern = new RegExp(`${separator}|(?<!")\\s*"((?:[^"]|"")*)"\\s*(?!")`, "g");
   return csv.replace(/\r/g, "").replace(/\n+$/, "").replace(main_pattern, (_, chunk) => chunk ?? "\r").split("\r").map((line) => line.replace(line_pattern, (_, chunk) => chunk == null ? "\r" : chunk.replace(/""/g, '"')).split("\r"));
 };
-var csv_parse = (csv, separator = ",") => {
-  const rows = csv_parse_raw(csv, separator);
-  const keys = rows.shift();
-  return keys != null ? rows.map((row) => keys.reduce((record, key, index) => {
-    record[key] = row[index];
-    return record;
-  }, {})) : [];
-};
 // src/nnn/escape.ts
 var escape_values = (escape_map, values) => values.map((value) => (escape_map.get(value?.constructor) ?? escape_map.get(undefined))?.(value) ?? "");
 var escape = (escape_map, template, ...values) => String.raw(template, ...escape_values(escape_map, values));
@@ -90,7 +83,7 @@ var _h = (namespace_uri) => {
           if (name[0] === "$") {
             const name1 = name.slice(1);
             if (is_record(value)) {
-              node[name1] = node[name1] ?? {};
+              node[name1] ??= {};
               Object.assign(node[name1], value);
             } else {
               node[name1] = value;
@@ -221,7 +214,7 @@ var pl_ural = (singular, plural_2, plural_5, value) => {
 // src/nnn/pro.ts
 var pro = (ref) => new Proxy(ref, {
   get(target, key) {
-    return pro(target[key] = target[key] ?? {});
+    return pro(target[key] ??= {});
   }
 });
 // src/nnn/uuid_v1.ts
@@ -246,13 +239,13 @@ export {
   is_string,
   is_record,
   is_number,
+  is_finite_number,
   is_array,
   has_own,
   h,
   fix_typography,
   escape_values,
   escape,
-  csv_parse_raw,
   csv_parse,
   c
 };

package/package.json

@@ -15,6 +15,7 @@
     "in",
     "is",
     "is_array",
+    "is_finite_number",
     "is_number",
     "is_record",
     "is_string",
@@ -35,5 +36,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.6.20"
+  "version": "2025.9.3"
 }

package/readme.md

@@ -35,13 +35,13 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - `H_Args_1`: The type of arguments of the `h` and `s` helpers.
 - `c`: A simple JS-to-CSS (aka CSS-in-JS) helper.
 - `csv_parse`: A tiny helper for parsing CSV.
-- `csv_parse_raw`: A tiny helper for parsing CSV.
 - `escape`: A generic helper for escaping `values` by given `escape_map` (in *TemplateStrings* flavor).
 - `escape_values`: A generic helper for escaping `values` by given `escape_map`.
 - `fix_typography`: A helper that implements typographic corrections specific to Polish typography.
 - `h`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
 - `has_own`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
 - `is_array`: A helper that checks if the given argument is of type `any[]`.
+- `is_finite_number`: A helper that checks if the given argument is of type `number` but not `±Infinity` nor `NaN`.
 - `is_number`: A helper that checks if the given argument is of type `number`.
 - `is_record`: A helper that checks if the given argument is of type `Record<PropertyKey, unknown>`.
 - `is_string`: A helper that checks if the given argument is of type `string`.
@@ -313,7 +313,7 @@ expect(actual).to.deep.equal(expected)
 ### csv_parse
 
 ```ts
-const csv_parse: (csv: string, separator?: string) => Record<PropertyKey, string>[];
+const csv_parse: (csv: string, separator?: string) => string[][];
 ```
 
 A tiny helper for parsing CSV.
@@ -329,38 +329,7 @@ yyy",zzz
  42 , "42" , 17
 
 `
-
-expect(csv_parse(text)).to.deep.equal([{
-  'aaa\n"aaa"\naaa': 'xxx,xxx',
-  bbb: 'yyy\nyyy',
-  'ccc,ccc': 'zzz'
-}, {
-  'aaa\n"aaa"\naaa': ' 42 ',
-  bbb: '42',
-  'ccc,ccc': ' 17'
-}])
-```
-
-### csv_parse_raw
-
-```ts
-const csv_parse_raw: (csv: string, separator?: string) => string[][];
-```
-
-A tiny helper for parsing CSV.
-
-#### Usage Examples
-
-```ts
-const text = `"aaa
-""aaa""
-aaa",bbb, "ccc,ccc"
-"xxx,xxx", "yyy
-yyy",zzz
- 42 , "42" , 17
-
-`
-expect(csv_parse_raw(text)).to.deep.equal([
+expect(csv_parse(text)).to.deep.equal([
   ['aaa\n"aaa"\naaa', 'bbb', 'ccc,ccc'],
   ['xxx,xxx', 'yyy\nyyy', 'zzz'],
   [' 42 ', '42', ' 17']
@@ -563,14 +532,26 @@ expect(has_own(undefined, 'key')).to.be.false
 
 ```ts
 const is_array: (arg: any) => arg is any[];
+declare const FINITE_NUMBER: unique symbol;
+type Finite_Number = number & {
+    readonly [FINITE_NUMBER]: true;
+};
 ```
 
 A helper that checks if the given argument is of type `any[]`.
 
+### is_finite_number
+
+```ts
+const is_finite_number: ((arg: unknown) => arg is Finite_Number);
+```
+
+A helper that checks if the given argument is of type `number` but not `±Infinity` nor `NaN`.
+
 ### is_number
 
 ```ts
-const is_number: (arg: any) => arg is number;
+const is_number: (arg: unknown) => arg is number;
 ```
 
 A helper that checks if the given argument is of type `number`.
@@ -578,7 +559,7 @@ A helper that checks if the given argument is of type `number`.
 ### is_record
 
 ```ts
-const is_record: (arg: any) => arg is Record<PropertyKey, unknown>;
+const is_record: (arg: unknown) => arg is Record<PropertyKey, unknown>;
 ```
 
 A helper that checks if the given argument is of type `Record<PropertyKey, unknown>`.
@@ -586,7 +567,8 @@ A helper that checks if the given argument is of type `Record<PropertyKey, unkno
 ### is_string
 
 ```ts
-const is_string: (arg: any) => arg is string;
+const is_string: (arg: unknown) => arg is string;
+export {};
 ```
 
 A helper that checks if the given argument is of type `string`.