@jackens/nnn 2025.2.4 → 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”.
  *

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) => {
@@ -249,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.4"
+  "version": "2025.3.5"
 }

package/readme.md

@@ -2,7 +2,7 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2025.2.4</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.4/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.4/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`).
@@ -565,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.
-
-#### Usage Examples
-
-```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
+A helper that checks if the given argument is of type `any[]`.
 
-expect(is(undefined, undefined)).to.be.true
-expect(is(undefined, null)).to.be.true
+### isNumber
 
-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 { }
+A helper that checks if the given argument is of type `number`.
 
-expect(is(FooBar, new FooBar())).to.be.true
-expect(iz(FooBar, new FooBar())).to.be.false
+### isRecord
 
-expect(is(Object, new FooBar())).to.be.false
-expect(iz(Object, new FooBar())).to.be.true
-
-const fakeFooBar = {}
-
-fakeFooBar[Symbol.toStringTag] = FooBar.name
-
-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'
-
-expect(is(Number, num)).to.be.true
+A helper that checks if the given argument is of type `Partial<Record<PropertyKey, unknown>>`.
 
-try {
-  num.constructor = str.constructor
-} catch { /* empty */ }
+### isString
 
-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