@jackens/nnn 2025.2.2 → 2025.3.5

package/nnn.d.ts

@@ -105,19 +105,21 @@ export declare const svgUse: (id: string, ...args: Partial<Array<HArgs1>>) => SV
  */
 export declare const hasOwn: (ref: unknown, key: unknown) => boolean;
 /**
- * A helper that checks if the given argument is of a certain type.
- */
-export declare const is: {
-    (type: ArrayConstructor, arg: unknown): arg is Partial<Array<unknown>>;
-    (type: BigIntConstructor, arg: unknown): arg is bigint;
-    (type: BooleanConstructor, arg: unknown): arg is boolean;
-    (type: NumberConstructor, arg: unknown): arg is number;
-    (type: ObjectConstructor, arg: unknown): arg is Partial<Record<PropertyKey, unknown>>;
-    (type: StringConstructor, arg: unknown): arg is string;
-    (type: SymbolConstructor, arg: unknown): arg is symbol;
-    (type: undefined, arg: unknown): arg is undefined | null;
-    <T extends abstract new (...args: Partial<Array<any>>) => unknown>(type: T, arg: unknown): arg is InstanceType<T>;
-};
+ * A helper that checks if the given argument is of type `any[]`.
+ */
+export declare const isArray: (arg: any) => arg is any[];
+/**
+ * A helper that checks if the given argument is of type `number`.
+ */
+export declare const isNumber: (arg: any) => arg is number;
+/**
+ * A helper that checks if the given argument is of type `Partial<Record<PropertyKey, unknown>>`.
+ */
+export declare const isRecord: (arg: any) => arg is Partial<Record<PropertyKey, unknown>>;
+/**
+ * A helper that checks if the given argument is of type `string`.
+ */
+export declare const isString: (arg: any) => arg is string;
 /**
  * `JSON.parse` with “JavaScript turned on”.
  *
@@ -163,18 +165,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

@@ -1,5 +1,8 @@
 // src/nnn/is.ts
-var is = (type, arg) => arg?.constructor === type;
+var isArray = Array.isArray;
+var isNumber = (arg) => typeof arg === "number";
+var isRecord = (arg) => typeof arg === "object" && arg != null && !isArray(arg);
+var isString = (arg) => typeof arg === "string";
 
 // src/nnn/c.ts
 var _c = (node, prefix, result, split) => {
@@ -9,7 +12,7 @@ var _c = (node, prefix, result, split) => {
     if (style0 == null || prefix0 == null) {
       continue;
     }
-    if (is(Array, style0)) {
+    if (isArray(style0)) {
       result.push(prefix0, prefix0 !== "" ? "{" : "", style0.join(";"), prefix0 !== "" ? "}" : "");
     } else {
       const todo = [];
@@ -17,7 +20,7 @@ var _c = (node, prefix, result, split) => {
       let attributesPushed = false;
       for (const key in style0) {
         const value = style0[key];
-        if (is(String, value) || is(Number, value)) {
+        if (isString(value) || isNumber(value)) {
           if (!attributesPushed) {
             attributesPushed = true;
             attributes = [];
@@ -77,21 +80,19 @@ var NS = {
 var _h = (namespaceURI) => {
   const createElement = namespaceURI == null ? (tag) => document.createElement(tag) : (tag) => document.createElementNS(namespaceURI, tag);
   const h = (tagOrNode, ...args) => {
-    const node = is(String, tagOrNode) ? createElement(tagOrNode) : tagOrNode;
+    const node = isString(tagOrNode) ? createElement(tagOrNode) : tagOrNode;
     args.forEach((arg) => {
       let child = null;
       if (arg instanceof Node) {
         child = arg;
-      } else if (is(String, arg) || is(Number, arg)) {
-        child = document.createTextNode(arg);
-      } else if (is(Array, arg)) {
+      } else if (isArray(arg)) {
         child = h(...arg);
-      } else if (arg != null) {
+      } else if (isRecord(arg)) {
         for (const name in arg) {
           const value = arg[name];
           if (name[0] === "$") {
             const name1 = name.slice(1);
-            if (is(Object, value)) {
+            if (isRecord(value)) {
               node[name1] = node[name1] ?? {};
               Object.assign(node[name1], value);
             } else {
@@ -108,7 +109,7 @@ var _h = (namespaceURI) => {
                 } else if (value === false) {
                   node.removeAttributeNS(ns, basename);
                 } else {
-                  node.setAttributeNS(ns, basename, is(String, value) ? value : "" + value);
+                  node.setAttributeNS(ns, basename, value);
                 }
               }
             } else {
@@ -117,11 +118,13 @@ var _h = (namespaceURI) => {
               } else if (value === false) {
                 node.removeAttribute(name);
               } else {
-                node.setAttribute(name, is(String, value) ? value : "" + value);
+                node.setAttribute(name, "" + value);
               }
             }
           }
         }
+      } else if (arg != null) {
+        child = document.createTextNode(arg);
       }
       if (child != null) {
         node.appendChild(child);
@@ -170,7 +173,7 @@ var fixTypography = (node) => {
 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)) {
+  if (isRecord(value)) {
     let isSecondKey = false;
     for (key in value) {
       if (isSecondKey) {
@@ -180,7 +183,7 @@ var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
     }
     const handler = handlers[key];
     const params = value[key];
-    if (handler instanceof Function && is(Array, params)) {
+    if (handler instanceof Function && isArray(params)) {
       return handler(...params);
     }
   }
@@ -190,7 +193,7 @@ var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
 var locale = (map, defaultVersion) => (text, version = defaultVersion) => {
   const textV = map?.[version]?.[text];
   const textD = map?.[defaultVersion]?.[text];
-  return is(String, textV) ? textV : is(String, textD) ? textD : text;
+  return isString(textV) ? textV : isString(textD) ? textD : text;
 };
 // src/nnn/nanolight.ts
 var nanolight = (pattern, highlighters, code) => {
@@ -229,31 +232,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 +244,6 @@ export {
   uuid1,
   svgUse,
   s,
-  refsInfo,
   pro,
   plUral,
   pick,
@@ -271,7 +252,10 @@ export {
   nanolight,
   locale,
   jsOnParse,
-  is,
+  isString,
+  isRecord,
+  isNumber,
+  isArray,
   hasOwn,
   h,
   fixTypography,

package/package.json

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

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2025.2.2</code></sub>
+<sub>Version: <code class="version">2025.3.5</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.2/nnn.js'
+import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.3.5/nnn.js'
 ```
 
 ## Exports
@@ -54,7 +54,10 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.2/nnn.js'
 - `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`).
 - `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.
+- `isArray`: A helper that checks if the given argument is of type `any[]`.
+- `isNumber`: A helper that checks if the given argument is of type `number`.
+- `isRecord`: A helper that checks if the given argument is of type `Partial<Record<PropertyKey, unknown>>`.
+- `isString`: A helper that checks if the given argument is of type `string`.
 - `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
 - `locale`: Language translations helper.
 - `nanolight`: A generic helper for syntax highlighting (see also `nanolightJs`).
@@ -63,7 +66,6 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2025.2.2/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).
@@ -566,86 +568,38 @@ expect(() => 'key' in undefined).to.throw
 expect(hasOwn(undefined, 'key')).to.be.false
 ```
 
-### is
+### isArray
 
 ```ts
-const is: {
-    (type: ArrayConstructor, arg: unknown): arg is Partial<Array<unknown>>;
-    (type: BigIntConstructor, arg: unknown): arg is bigint;
-    (type: BooleanConstructor, arg: unknown): arg is boolean;
-    (type: NumberConstructor, arg: unknown): arg is number;
-    (type: ObjectConstructor, arg: unknown): arg is Partial<Record<PropertyKey, unknown>>;
-    (type: StringConstructor, arg: unknown): arg is string;
-    (type: SymbolConstructor, arg: unknown): arg is symbol;
-    (type: undefined, arg: unknown): arg is undefined | null;
-    <T extends abstract new (...args: Partial<Array<any>>) => unknown>(type: T, arg: unknown): arg is InstanceType<T>;
-};
+const isArray: (arg: any) => arg is any[];
 ```
 
-A helper that checks if the given argument is of a certain type.
+A helper that checks if the given argument is of type `any[]`.
 
-#### Usage Examples
+### isNumber
 
-```js
-expect(is(Number, 42)).to.be.true
-expect(is(Number, Number(42))).to.be.true
-expect(is(Number, new Number(42))).to.be.true
-expect(is(Number, NaN)).to.be.true
-
-expect(is(String, '42')).to.be.true
-expect(is(String, String('42'))).to.be.true
-expect(is(String, new String('42'))).to.be.true
-
-expect(is(Symbol, Symbol('42'))).to.be.true
-expect(is(Symbol, Object(Symbol('42')))).to.be.true
-
-expect(is(undefined, undefined)).to.be.true
-expect(is(undefined, null)).to.be.true
-
-expect(is(Object, {})).to.be.true
-expect(is(Array, [])).to.be.true
-expect(is(RegExp, /42/)).to.be.true
-expect(is(Date, new Date(42))).to.be.true
-expect(is(Set, new Set(['42', 42]))).to.be.true
-expect(is(Map, new Map([[{ j: 42 }, { J: '42' }], [{ c: 42 }, { C: '42' }]]))).to.be.true
+```ts
+const isNumber: (arg: any) => arg is number;
 ```
 
-```js
-const iz = (/** @type {unknown} */ type, /** @type {unknown} */ arg) =>
-  ({}).toString.call(arg).slice(8, -1) === type?.name
-
-class FooBar { }
-
-expect(is(FooBar, new FooBar())).to.be.true
-expect(iz(FooBar, new FooBar())).to.be.false
-
-expect(is(Object, new FooBar())).to.be.false
-expect(iz(Object, new FooBar())).to.be.true
-
-const fakeFooBar = {}
+A helper that checks if the given argument is of type `number`.
 
-fakeFooBar[Symbol.toStringTag] = FooBar.name
+### isRecord
 
-expect(is(FooBar, fakeFooBar)).to.be.false
-expect(iz(FooBar, fakeFooBar)).to.be.true
-
-expect(is(Object, fakeFooBar)).to.be.true
-expect(iz(Object, fakeFooBar)).to.be.false
+```ts
+const isRecord: (arg: any) => arg is Partial<Record<PropertyKey, unknown>>;
 ```
 
-```js
-const num = 42
-const str = '42'
+A helper that checks if the given argument is of type `Partial<Record<PropertyKey, unknown>>`.
 
-expect(is(Number, num)).to.be.true
+### isString
 
-try {
-  num.constructor = str.constructor
-} catch { /* empty */ }
-
-expect(is(Number, num)).to.be.true
+```ts
+const isString: (arg: any) => arg is string;
 ```
 
+A helper that checks if the given argument is of type `string`.
+
 ### jsOnParse
 
 ```ts
@@ -872,49 +826,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
@@ -946,10 +857,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).
@@ -973,12 +881,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\>