@jackens/nnn 2023.8.27 → 2023.9.18

package/nnn.d.ts

@@ -181,6 +181,13 @@ export function nanolightJs(codeJs: string): HArgs[1][];
  */
 export function plUral(singular: string, plural2: string, plural5: string, value: number): string;
 
+/**
+ * A helper that provides information about the given `refs`.
+ *
+ * It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
+ */
+export function refsInfo(...refs: any[]): [string, string, string[]][];
+
 /**
  * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
  *
@@ -214,4 +221,4 @@ export function set(value: any, ref: any, ...keys: (string | number | symbol)[])
 export function uuid1(options?: {
   date?: Date;
   node?: string;
-}): string;
+}): string;

package/nnn.js

@@ -260,11 +260,11 @@ export const escape = (
 ) => String.raw(template, ...escapeValues(escapeMap, values))
 
 export const escapeValues = (
-  /** @type {EscapeMap}  */ escapeMap,
-  /** @type {any[]}      */ values
+  /** @type {EscapeMap} */ escapeMap,
+  /** @type {any[]}     */ values
 ) => values.map(value => (escapeMap.get(value?.constructor) ?? escapeMap.get(undefined))?.(value) ?? '')
 
-const TAGS_TO_SKIP = { IFRAME: 1, NOSCRIPT: 1, PRE: 1, SCRIPT: 1, STYLE: 1, TEXTAREA: 1 }
+const _TAGS_TO_SKIP = { IFRAME: 1, NOSCRIPT: 1, PRE: 1, SCRIPT: 1, STYLE: 1, TEXTAREA: 1 }
 
 export const fixTypography = (/** @type {Node} */ node) => {
   const /** @type {Node[]} */ queue = [node]
@@ -278,7 +278,7 @@ export const fixTypography = (/** @type {Node} */ node) => {
 
         if (childNode instanceof Text) {
           queue.push(childNode)
-        } else if (childNode instanceof Element && !has(childNode.tagName, TAGS_TO_SKIP)) {
+        } else if (childNode instanceof Element && !has(childNode.tagName, _TAGS_TO_SKIP)) {
           queue.push(childNode)
         }
       }
@@ -322,7 +322,7 @@ export const get = (
   return ref
 }
 
-const /** @type {Record<string, string>} */ NS = {
+const /** @type {Record<string, string>} */ _NS = {
   xlink: 'http://www.w3.org/1999/xlink'
 }
 
@@ -379,7 +379,7 @@ const _h = (/** @type {string?=} */ namespaceURI) => {
             const indexOfColon = name.indexOf(':')
 
             if (indexOfColon >= 0) {
-              const /** @type {string=} */ ns = NS[name.slice(0, indexOfColon)]
+              const /** @type {string=} */ ns = _NS[name.slice(0, indexOfColon)]
 
               if (ns != null) {
                 const basename = name.slice(indexOfColon + 1)
@@ -617,6 +617,23 @@ export const plUral = (
         : plural5
 }
 
+export const refsInfo = (/** @type {any[]} */ ...refs) => {
+  const /** @type {Set<Function>} */ fns = new Set()
+
+  refs.forEach(ref => {
+    while (is(Function, ref) && !fns.has(ref) && ref.toString?.()?.includes?.('[native code]')) {
+      fns.add(ref)
+      ref = Object.getPrototypeOf(ref)
+    }
+  })
+
+  return Array.from(fns.values()).map(/** @returns {[string, string, string[]]} */ fn => [
+    fn.name,
+    Object.getPrototypeOf(fn)?.name ?? '',
+    Object.getOwnPropertyNames(fn.prototype ?? Object.create(null)).sort()
+  ]).sort((a, b) => -(a[0] < b[0]))
+}
+
 export const s = _h('http://www.w3.org/2000/svg')
 
 export const set = (

package/package.json

@@ -40,5 +40,5 @@
   "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2023.8.27"
+  "version": "2023.9.18"
 }