@jackens/nnn 2024.3.8 → 2024.3.31

package/nnn.d.ts

@@ -1,8 +1,3 @@
-/**
- * A helper that checks equality of the given arguments.
- */
-export declare const eq: (x: any, y: any) => boolean;
-
 /**
  * The type of arguments of the `escapeValues` and `escape` helpers.
  */
@@ -11,12 +6,12 @@ export type EscapeMap = Map<any, (value?: any) => string>;
 /**
  * A generic helper for escaping `values` by given `escapeMap`.
  */
-export declare const escapeValues: (escapeMap: EscapeMap, values: any[]) => string[];
+export declare const escapeValues: (escapeMap: EscapeMap, values: Partial<Array<any>>) => Partial<Array<string>>;
 
 /**
  * A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
  */
-export declare const escape: (escapeMap: EscapeMap, template: TemplateStringsArray, ...values: any[]) => string;
+export declare const escape: (escapeMap: EscapeMap, template: TemplateStringsArray, ...values: Partial<Array<any>>) => string;
 
 /**
  * A helper that implements typographic corrections specific to Polish typography.
@@ -49,9 +44,9 @@ export type HArgs = [string | Node, ...HArgs1[]];
  * - All other arguments of type `HArgs` are passed to `h` and the results are appended to the element being created or modified.
  */
 export declare const h: {
-    <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];
-    <N extends Node>(node: N, ...args1: HArgs1[]): N;
-    (tagOrNode: string | Node, ...args1: HArgs1[]): Node;
+    <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: Partial<Array<HArgs1>>): HTMLElementTagNameMap[T];
+    <N extends Node>(node: N, ...args1: Partial<Array<HArgs1>>): N;
+    (tagOrNode: string | Node, ...args1: Partial<Array<HArgs1>>): Node;
 };
 
 /**
@@ -70,15 +65,15 @@ export declare const h: {
  * - All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or modified.
  */
 export declare const s: {
-    <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];
-    <N extends Node>(node: N, ...args1: HArgs1[]): N;
-    (tagOrNode: string | Node, ...args1: HArgs1[]): Node;
+    <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: Partial<Array<HArgs1>>): SVGElementTagNameMap[T];
+    <N extends Node>(node: N, ...args1: Partial<Array<HArgs1>>): N;
+    (tagOrNode: string | Node, ...args1: Partial<Array<HArgs1>>): Node;
 };
 
 /**
  * A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
  */
-export declare const svgUse: (id: string, ...args: HArgs1[]) => SVGSVGElement;
+export declare const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SVGSVGElement;
 
 /**
  * A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
@@ -89,6 +84,7 @@ export declare const has: (key: any, ref: any) => boolean;
  * A helper that checks if the given argument is of a certain type.
  */
 export declare const is: {
+    (type: ArrayConstructor, arg: any): arg is Partial<Array<any>>;
     (type: BigIntConstructor, arg: any): arg is bigint;
     (type: BooleanConstructor, arg: any): arg is boolean;
     (type: NumberConstructor, arg: any): arg is number;
@@ -96,7 +92,7 @@ export declare const is: {
     (type: StringConstructor, arg: any): arg is string;
     (type: SymbolConstructor, arg: any): arg is symbol;
     (type: undefined, arg: any): arg is undefined | null;
-    <T extends abstract new (...args: any[]) => any>(type: T, arg: any): arg is InstanceType<T>;
+    <T extends abstract new (...args: Partial<Array<any>>) => any>(type: T, arg: any): arg is InstanceType<T>;
 };
 
 /**
@@ -159,12 +155,12 @@ export declare const nanolightJs: (code: string) => HArgs1[];
 /**
  * A helper that implements TypeScript’s `Pick` utility type.
  */
-export declare const pick: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: any[]) => Pick<T, K[number]>;
+export declare const pick: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: Partial<Array<any>>) => Pick<T, K[number]>;
 
 /**
  * A helper that implements TypeScript’s `Omit` utility type.
  */
-export declare const omit: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: any[]) => Omit<T, K[number]>;
+export declare const omit: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: Partial<Array<any>>) => Omit<T, K[number]>;
 
 /**
  * A helper for choosing the correct singular and plural.
@@ -181,7 +177,7 @@ export declare const pro: (ref: any) => any;
  *
  * It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
  */
-export declare const refsInfo: (...refs: any[]) => [string, string, string[]][];
+export declare const refsInfo: (...refs: Partial<Array<any>>) => [string, string, (string | undefined)[]][];
 
 /**
  * A helper that generates a UUID v1 identifier (with a creation timestamp).

package/nnn.js

@@ -1,38 +1,3 @@
-// src/nnn/eq.ts
-var eq = (x, y) => {
-  if (x === y) {
-    return true;
-  }
-  const xConstructor = x?.constructor;
-  if (xConstructor === y?.constructor) {
-    if (xConstructor === Number) {
-      return isNaN(x) && isNaN(y) || +x === +y;
-    }
-    if (xConstructor === Date) {
-      return +x === +y;
-    }
-    if (xConstructor === String || xConstructor === RegExp) {
-      return "" + x === "" + y;
-    }
-    if (xConstructor === Array) {
-      return x.length === y.length && x.every((item, index) => eq(item, y[index]));
-    }
-    if (xConstructor === Object) {
-      const keysOfX = Object.keys(x);
-      return keysOfX.length === Object.keys(y).length && keysOfX.every((key) => eq(x[key], y[key]));
-    }
-    if (xConstructor === Set || xConstructor === Map) {
-      if (x.size !== y.size) {
-        return false;
-      }
-      const xa = [...x];
-      const ya = [...y];
-      return xa.every((xv) => ya.find((yv) => eq(xv, yv)));
-    }
-  }
-  return false;
-};
-
 // src/nnn/escape.ts
 var escapeValues = (escapeMap, values) => values.map((value) => (escapeMap.get(value?.constructor) ?? escapeMap.get(undefined))?.(value) ?? "");
 var escape = (escapeMap, template, ...values) => String.raw(template, ...escapeValues(escapeMap, values));
@@ -203,8 +168,10 @@ var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
       }
       isSecondKey = true;
     }
-    if (has(key, handlers) && is(Array, value[key])) {
-      return handlers[key](...value[key]);
+    const handler = handlers[key];
+    const params = value[key];
+    if (is(Function, handler) && is(Array, params)) {
+      return handler(...params);
     }
   }
   return value;
@@ -305,6 +272,5 @@ export {
   h,
   fixTypography,
   escapeValues,
-  escape,
-  eq
+  escape
 };

package/package.json

@@ -3,9 +3,6 @@
   "description": "Jackens’ JavaScript helpers.",
   "homepage": "https://jackens.github.io/nnn/doc/",
   "keywords": [
-    "chart",
-    "chartable",
-    "charts",
     "CSS-in-JS",
     "deepEqual",
     "DOM",
@@ -43,5 +40,5 @@
   "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2024.3.8"
+  "version": "2024.3.31"
 }

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2024.3.8</code></sub>
+<sub>Version: <code class="version">2024.3.31</code></sub>
 
 ## Examples
 
@@ -44,7 +44,6 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - `HArgs1`: The type of arguments of the `h` and `s` helpers.
 - `JcNode`: The type of arguments of the `jc` helper.
 - `JcRoot`: The type of arguments of the `jc` helper.
-- `eq`: A helper that checks equality of the given arguments.
 - `escape`: A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
 - `escapeValues`: A generic helper for escaping `values` by given `escapeMap`.
 - `fixTypography`: A helper that implements typographic corrections specific to Polish typography.
@@ -107,52 +106,10 @@ type JcRoot = Partial<Record<PropertyKey, JcNode>>;
 
 The type of arguments of the `jc` helper.
 
-### eq
-
-```ts
-const eq: (x: any, y: any) => boolean;
-```
-
-A helper that checks equality of the given arguments.
-
-#### Usage Examples
-
-```js
-expect(eq(true, true)).toBeTrue()
-expect(eq(NaN, NaN)).toBeTrue()
-expect(eq(null, undefined)).toBeFalse()
-expect(eq(42, 42)).toBeTrue()
-expect(eq(42, new Number(42))).toBeTrue()
-expect(eq(42, Number(42))).toBeTrue()
-expect(eq(new Number(42), Number(42))).toBeTrue()
-expect(eq(42, '42')).toBeFalse()
-expect(eq('42', '42')).toBeTrue()
-expect(eq('42', new String('42'))).toBeTrue()
-expect(eq('42', String('42'))).toBeTrue()
-expect(eq(String('42'), new String('42'))).toBeTrue()
-expect(eq(/42/, /42/)).toBeTrue()
-expect(eq(/42/, /42/g)).toBeFalse()
-expect(eq(new Date(42), new Date(42))).toBeTrue()
-expect(eq(new Date(), new Date(42))).toBeFalse()
-expect(eq({ j: '42', c: 42 }, { c: 42, j: '42' })).toBeTrue()
-expect(eq([42, '42'], [42, '42'])).toBeTrue()
-expect(eq(new Set(['42', 42]), new Set([42, '42']))).toBeTrue()
-expect(eq(new Set(['42', 42]), new Set([42]))).toBeFalse()
-expect(eq(new Set([42, undefined]), new Set([42]))).toBeFalse()
-expect(eq(
-  new Map([[{ j: 42 }, { J: '42' }], [{ c: 42 }, { C: '42' }]]),
-  new Map([[{ c: 42 }, { C: '42' }], [{ j: 42 }, { J: '42' }]])
-)).toBeTrue()
-expect(eq(
-  new Map([[{ j: 42 }, { J: '42' }], [{ c: 42 }, { C: '42' }]]),
-  new Map([[{ j: '42' }, { J: 42 }], [{ c: '42' }, { C: 42 }]])
-)).toBeFalse()
-```
-
 ### escape
 
 ```ts
-const escape: (escapeMap: EscapeMap, template: TemplateStringsArray, ...values: any[]) => string;
+const escape: (escapeMap: EscapeMap, template: TemplateStringsArray, ...values: Partial<Array<any>>) => string;
 ```
 
 A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
@@ -162,7 +119,7 @@ A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings
 ```js
 const escapeMap: EscapeMap = new Map([
   [undefined, () => 'NULL'],
-  [Array, (values: any[]) => escapeValues(escapeMap, values).join(', ')],
+  [Array, (values: Partial<Array<any>>) => escapeValues(escapeMap, values).join(', ')],
   [Boolean, (value: boolean) => `b'${+value}'`],
   [Date, (value: Date) => `'${value.toISOString().replace(/^(.+)T(.+)\..*$/, '$1 $2')}'`],
   [Number, (value: number) => `${value}`],
@@ -187,7 +144,7 @@ expect(actual).toStrictEqual(expected)
 ### escapeValues
 
 ```ts
-const escapeValues: (escapeMap: EscapeMap, values: any[]) => string[];
+const escapeValues: (escapeMap: EscapeMap, values: Partial<Array<any>>) => Partial<Array<string>>;
 ```
 
 A generic helper for escaping `values` by given `escapeMap`.
@@ -216,9 +173,9 @@ expect(p.innerHTML).toStrictEqual(
 
 ```ts
 const h: {
-    <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];
-    <N extends Node>(node: N, ...args1: HArgs1[]): N;
-    (tagOrNode: string | Node, ...args1: HArgs1[]): Node;
+    <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: Partial<Array<HArgs1>>): HTMLElementTagNameMap[T];
+    <N extends Node>(node: N, ...args1: Partial<Array<HArgs1>>): N;
+    (tagOrNode: string | Node, ...args1: Partial<Array<HArgs1>>): Node;
 };
 ```
 
@@ -347,6 +304,7 @@ expect(has('key', null)).toBeFalse()
 
 ```ts
 const is: {
+    (type: ArrayConstructor, arg: any): arg is Partial<Array<any>>;
     (type: BigIntConstructor, arg: any): arg is bigint;
     (type: BooleanConstructor, arg: any): arg is boolean;
     (type: NumberConstructor, arg: any): arg is number;
@@ -354,7 +312,7 @@ const is: {
     (type: StringConstructor, arg: any): arg is string;
     (type: SymbolConstructor, arg: any): arg is symbol;
     (type: undefined, arg: any): arg is undefined | null;
-    <T extends abstract new (...args: any[]) => any>(type: T, arg: any): arg is InstanceType<T>;
+    <T extends abstract new (...args: Partial<Array<any>>) => any>(type: T, arg: any): arg is InstanceType<T>;
 };
 ```
 
@@ -761,7 +719,7 @@ expect(nanolightJs(codeJs)).toStrictEqual([
 ### omit
 
 ```ts
-const omit: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: any[]) => Omit<T, K[number]>;
+const omit: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: Partial<Array<any>>) => Omit<T, K[number]>;
 ```
 
 A helper that implements TypeScript’s `Omit` utility type.
@@ -777,7 +735,7 @@ expect(omit(obj, ['c'])).toStrictEqual({ a: 42, b: '42' })
 ### pick
 
 ```ts
-const pick: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: any[]) => Pick<T, K[number]>;
+const pick: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: Partial<Record<PropertyKey, any>>, keys: Partial<Array<any>>) => Pick<T, K[number]>;
 ```
 
 A helper that implements TypeScript’s `Pick` utility type.
@@ -857,7 +815,7 @@ expect(ref).toStrictEqual({ one: { two: { three: { four: 1234 } } } })
 ### refsInfo
 
 ```ts
-const refsInfo: (...refs: any[]) => [string, string, string[]][];
+const refsInfo: (...refs: Partial<Array<any>>) => [string, string, (string | undefined)[]][];
 ```
 
 A helper that provides information about the given `refs`.
@@ -901,9 +859,9 @@ console.log(browserFingerprint())
 
 ```ts
 const s: {
-    <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];
-    <N extends Node>(node: N, ...args1: HArgs1[]): N;
-    (tagOrNode: string | Node, ...args1: HArgs1[]): Node;
+    <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: Partial<Array<HArgs1>>): SVGElementTagNameMap[T];
+    <N extends Node>(node: N, ...args1: Partial<Array<HArgs1>>): N;
+    (tagOrNode: string | Node, ...args1: Partial<Array<HArgs1>>): Node;
 };
 ```
 
@@ -924,7 +882,7 @@ A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style help
 ### svgUse
 
 ```ts
-const svgUse: (id: string, ...args: HArgs1[]) => SVGSVGElement;
+const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SVGSVGElement;
 ```
 
 A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.