@jackens/nnn 2025.2.1 → 2025.2.4

package/nnn.d.ts

@@ -103,7 +103,7 @@ export declare const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SV
 /**
  * A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
  */
-export declare const has: (key: unknown, ref: unknown) => boolean;
+export declare const hasOwn: (ref: unknown, key: unknown) => boolean;
 /**
  * A helper that checks if the given argument is of a certain type.
  */
@@ -163,18 +163,9 @@ export declare const plUral: (singular: string, plural2: string, plural5: string
  * object.
  */
 export declare const pro: (ref: unknown) => any;
-/**
- * A helper that provides information about the given `refs`.
- *
- * It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
- */
-export declare const refsInfo: (...refs: Partial<Array<unknown>>) => Partial<Array<[string, string, Partial<Array<string>>]>>;
 /**
  * A helper that generates a UUID v1 identifier (with a creation timestamp).
  *
  * - The optional `node` parameter should have the format `/^[0123456789abcdef]+$/`. Its value will be trimmed to last 12 characters and left padded with zeros.
  */
-export declare const uuid1: ({ date, node }?: {
-    date?: Date | undefined;
-    node?: string | undefined;
-}) => string;
+export declare const uuid1: (date?: Date, node?: string) => string;

package/nnn.js

@@ -166,8 +166,8 @@ var fixTypography = (node) => {
     }
   }
 };
-// src/nnn/has.ts
-var has = (key, ref) => ref != null && Object.hasOwnProperty.call(ref, key);
+// src/nnn/hasOwn.ts
+var hasOwn = (ref, key) => ref != null && Object.hasOwn(ref, key);
 // src/nnn/jsOnParse.ts
 var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
   if (is(Object, value)) {
@@ -229,31 +229,10 @@ var pro = (ref) => new Proxy(ref, {
     return pro(target[key] = target[key] ?? {});
   }
 });
-// src/nnn/refsInfo.ts
-var refsInfo = (...refs) => {
-  const fns = new Set;
-  refs.forEach((ref) => {
-    try {
-      while (ref instanceof Function && !fns.has(ref) && `${ref}`.match(/function\s+\w+[\s\S]+\[native code\]/)) {
-        fns.add(ref);
-        ref = Object.getPrototypeOf(ref);
-      }
-    } catch {
-    }
-  });
-  return Array.from(fns.values()).map((fn) => [
-    fn.name,
-    Object.getPrototypeOf(fn)?.name ?? "",
-    Object.getOwnPropertyNames(fn.prototype ?? Object.create(null)).sort()
-  ]).sort((a, b) => -(a[0] < b[0]));
-};
 // src/nnn/uuid1.ts
 var ZEROS = "0".repeat(16);
 var counter = 0;
-var uuid1 = ({
-  date = new Date,
-  node = Math.random().toString(16).slice(2)
-} = {}) => {
+var uuid1 = (date = new Date, node = Math.random().toString(16).slice(2)) => {
   const time = ZEROS + (1e4 * (+date + 12219292800000)).toString(16);
   counter = counter + 1 & 16383;
   return time.slice(-8).concat("-", time.slice(-12, -8), -1, time.slice(-15, -12), "-", (8 | counter >> 12).toString(16), (ZEROS + (counter & 4095).toString(16)).slice(-3), "-", (ZEROS + node).slice(-12));
@@ -262,7 +241,6 @@ export {
   uuid1,
   svgUse,
   s,
-  refsInfo,
   pro,
   plUral,
   pick,
@@ -272,7 +250,7 @@ export {
   locale,
   jsOnParse,
   is,
-  has,
+  hasOwn,
   h,
   fixTypography,
   escapeValues,

package/package.json

@@ -36,5 +36,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2025.2.1"
+  "version": "2025.2.4"
 }

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2025.2.1</code></sub>
+<sub>Version: <code class="version">2025.2.4</code></sub>
 
 * [Documentation](https://jackens.github.io/nnn/doc/)
 * [Tests](https://jackens.github.io/nnn/test/)
@@ -37,7 +37,7 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 or
 
 ```js
-import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.1/nnn.js'
+import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.4/nnn.js'
 ```
 
 ## Exports
@@ -53,7 +53,7 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.1/nnn.js'
 - `escapeValues`: A generic helper for escaping `values` by given `escapeMap`.
 - `fixTypography`: 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`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
+- `hasOwn`: A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
 - `is`: A helper that checks if the given argument is of a certain type.
 - `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
 - `locale`: Language translations helper.
@@ -63,7 +63,6 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.1/nnn.js'
 - `pick`: A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
 - `plUral`: A helper for choosing the correct singular and plural.
 - `pro`: A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty
-- `refsInfo`: A helper that provides information about the given `refs`.
 - `s`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
 - `svgUse`: A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args)`.
 - `uuid1`: A helper that generates a UUID v1 identifier (with a creation timestamp).
@@ -525,10 +524,10 @@ h(div, { $key: { two: 2 } })
 expect(div.key).to.deep.equal({ one: 1, two: 2 })
 ```
 
-### has
+### hasOwn
 
 ```ts
-const has: (key: unknown, ref: unknown) => boolean;
+const hasOwn: (ref: unknown, key: unknown) => boolean;
 ```
 
 A replacement for the `in` operator (not to be confused with the `for-in` loop) that works properly.
@@ -536,35 +535,34 @@ A replacement for the `in` operator (not to be confused with the `for-in` loop)
 #### Usage Examples
 
 ```js
-const obj = { 'k,e,y': 42, null: 42 }
+const obj = { 42: null, null: 'k,e,y', 'k,e,y': 42 }
 
-expect('k,e,y' in obj).to.be.true
-expect(has('k,e,y', obj)).to.be.true
+expect(42 in obj).to.be.true
+expect(hasOwn(obj, 42)).to.be.true
 
-expect(['k', 'e', 'y'] in obj).to.be.true
-expect(has(['k', 'e', 'y'], obj)).to.be.true
+expect('42' in obj).to.be.true
+expect(hasOwn(obj, '42')).to.be.true
 
 expect('null' in obj).to.be.true
-expect(has('null', obj)).to.be.true
+expect(hasOwn(obj, 'null')).to.be.true
 
 expect(null in obj).to.be.true
-expect(has(null, obj)).to.be.true
+expect(hasOwn(obj, null)).to.be.true
 
-expect('toString' in obj).to.be.true
-expect(has('toString', obj)).to.be.false
-```
+expect('k,e,y' in obj).to.be.true
+expect(hasOwn(obj, 'k,e,y')).to.be.true
 
-```js
-let typeError
+expect(['k', 'e', 'y'] in obj).to.be.true
+expect(hasOwn(obj, ['k', 'e', 'y'])).to.be.true
 
-try {
-  'key' in null
-} catch (error) {
-  typeError = error
-}
+expect('toString' in obj).to.be.true
+expect(hasOwn(obj, 'toString')).to.be.false
 
-expect(typeError instanceof TypeError) // Cannot use 'in' operator to search for 'key' in null
-expect(has('key', null)).to.be.false
+expect(() => 'key' in null).to.throw
+expect(hasOwn(null, 'key')).to.be.false
+
+expect(() => 'key' in undefined).to.throw
+expect(hasOwn(undefined, 'key')).to.be.false
 ```
 
 ### is
@@ -873,49 +871,6 @@ pro(ref).one.two.three.four = 1234
 expect(ref).to.deep.equal({ one: { two: { three: { four: 1234 } } } })
 ```
 
-### refsInfo
-
-```ts
-const refsInfo: (...refs: Partial<Array<unknown>>) => Partial<Array<[string, string, Partial<Array<string>>]>>;
-```
-
-A helper that provides information about the given `refs`.
-
-It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
-
-#### Usage Examples
-
-```js
-const info = refsInfo(Array, Function)
-
-expect(info.find(item => item?.[0] === 'Array')?.[2]?.includes('length')).to.be.true
-expect(info.find(item => item?.[0] === 'Function')?.[2]?.includes('length')).to.be.true
-```
-
-```js
-const browserFingerprint = () => {
-  const refs = Object.getOwnPropertyNames(window).map(name => window[name])
-  const info = refsInfo(...refs)
-  const json = JSON.stringify(info)
-  const hash = Array(32).fill(0)
-  let j = 0
-
-  for (let i = 0; i < json.length; i++) {
-    let charCode = json.charCodeAt(i)
-
-    while (charCode > 0) {
-      hash[j] = hash[j] ^ (charCode & 15)
-      charCode >>= 4
-      j = (j + 1) & 31
-    }
-  }
-
-  return hash.map(x => x.toString(16)).join('')
-}
-
-console.log(browserFingerprint())
-```
-
 ### s
 
 ```ts
@@ -947,10 +902,7 @@ A convenient shortcut for `s('svg', ['use', { 'xlink:href': '#' + id }], ...args
 ### uuid1
 
 ```ts
-const uuid1: ({ date, node }?: {
-    date?: Date | undefined;
-    node?: string | undefined;
-}) => string;
+const uuid1: (date?: Date, node?: string) => string;
 ```
 
 A helper that generates a UUID v1 identifier (with a creation timestamp).
@@ -974,12 +926,12 @@ for (let i = 1; i <= 22136; ++i) {
 ```
 
 ```js
-expect(uuid1({ node: '000123456789abc' }).split('-')[4]).to.deep.equal('123456789abc')
-expect(uuid1({ node: '123456789' }).split('-')[4]).to.deep.equal('000123456789')
+expect(uuid1(new Date(), '000123456789abc').split('-')[4]).to.deep.equal('123456789abc')
+expect(uuid1(new Date(), '123456789').split('-')[4]).to.deep.equal('000123456789')
 ```
 
 ```js
-expect(uuid1({ date: new Date(323325000000) }).startsWith('c1399400-9a71-11bd')).to.be.true
+expect(uuid1(new Date(323325000000)).startsWith('c1399400-9a71-11bd')).to.be.true
 ```
 
 ## Why Partial\<Array\> and Partial\<Record\>