@jackens/nnn 2023.8.25 → 2023.8.27-18

package/nnn.d.ts

@@ -1,15 +1,3 @@
-/**
- * The type of arguments of the `css` helper.
- */
-export type CNode = {
-  [attributeOrSelector: string]: string | number | CNode;
-};
-
-/**
- * The type of arguments of the `css` helper.
- */
-export type CRoot = Record<string, CNode>;
-
 /**
  * The type of arguments of the `escapeValues` and `escape` helpers.
  */
@@ -24,17 +12,16 @@ export type HArgs = [
 ];
 
 /**
- * A simple CSS-in-JS helper.
- *
- * The `root` parameter provides a hierarchical description of CSS rules.
- *
- * - Keys of sub-objects whose values are NOT objects are treated as CSS attribute, and values are treated as values of those CSS attributes; the concatenation of keys of all parent objects is a CSS rule.
- * - All keys ignore the part starting with a splitter (default: `$$`) sign until the end of the key (e.g. `src$$1` → `src`, `@font-face$$1` → `@font-face`).
- * - In keys specifying CSS attribute, all uppercase letters are replaced by lowercase letters with an additional `-` character preceding them (e.g. `fontFamily` → `font-family`).
- * - Commas in keys that makes a CSS rule cause it to “split” and create separate rules for each part (e.g. `{div:{margin:1,'.a,.b,.c':{margin:2}}}` → `div{margin:1}div.a,div.b,div.c{margin:2}`).
- * - Top-level keys that begin with `@` are not concatenated with sub-object keys.
+ * The type of arguments of the `jcss` helper.
  */
-export function css(root: CRoot, splitter?: string): string;
+export type JcssNode = {
+  [attributeOrSelector: string]: string | number | JcssNode;
+};
+
+/**
+ * The type of arguments of the `jcss` helper.
+ */
+export type JcssRoot = Record<string, JcssNode>;
 
 /**
  * A helper for creating a chart based on a table (conf. <https://jackens.github.io/nnn/chartable/>).
@@ -76,6 +63,13 @@ export function chartable(options?: {
   zxY?: number[][];
 }): SVGSVGElement;
 
+/**
+ * A helper that returns information about the JavaScript engine.
+ *
+ * It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
+ */
+export function engineInfo(): [string, string, string[]][];
+
 /**
  * A helper that checks equality of the given arguments.
  */
@@ -136,6 +130,36 @@ export function is(type: SymbolConstructor, arg: any): arg is symbol;
 export function is(type: undefined, arg: any): arg is null | undefined;
 export function is<T extends abstract new (...args: any[]) => any>(type: T, arg: any): arg is InstanceType<T>;
 
+/**
+ * A simple CSS-in-JS helper.
+ *
+ * The `root` parameter provides a hierarchical description of CSS rules.
+ *
+ * - Keys of sub-objects whose values are NOT objects are treated as CSS attribute, and values are treated as values of those CSS attributes; the concatenation of keys of all parent objects is a CSS rule.
+ * - All keys ignore the part starting with a splitter (default: `$$`) sign until the end of the key (e.g. `src$$1` → `src`, `@font-face$$1` → `@font-face`).
+ * - In keys specifying CSS attribute, all uppercase letters are replaced by lowercase letters with an additional `-` character preceding them (e.g. `fontFamily` → `font-family`).
+ * - Commas in keys that makes a CSS rule cause it to “split” and create separate rules for each part (e.g. `{div:{margin:1,'.a,.b,.c':{margin:2}}}` → `div{margin:1}div.a,div.b,div.c{margin:2}`).
+ * - Top-level keys that begin with `@` are not concatenated with sub-object keys.
+ */
+export function jcss(root: JcssRoot, splitter?: string): string;
+
+/**
+ * `JSON.parse` with “JavaScript turned on”.
+ *
+ * Objects having *exactly* one property which is present in the `handlers` map, i.e. objects of the form:
+ *
+ * ```js
+ * { "«handlerName»": [«params»] }
+ * ```
+ *
+ * are replaced by the result of call
+ *
+ * ```js
+ * handlers['«handlerName»'](...«params»)
+ * ```
+ */
+export function jsOnParse(handlers: Record<string, Function>, text: string): any;
+
 /**
  * Language translations helper.
  */

package/nnn.js

@@ -1,3 +1,7 @@
+/**
+ * @typedef {Map<any, (value?: any) => string>} EscapeMap
+ */
+
 /**
  * @typedef {[
  *   string | Node,
@@ -7,91 +11,14 @@
 
 /**
  * @typedef {{
- *   [attributeOrSelector: string]: string | number | CNode;
- * }} CNode
- */
-
-/**
- * @typedef {Record<string, CNode>} CRoot
+ *   [attributeOrSelector: string]: string | number | JcssNode;
+ * }} JcssNode
  */
 
 /**
- * @typedef {Map<any, (value?: any) => string>} EscapeMap
+ * @typedef {Record<string, JcssNode>} JcssRoot
  */
 
-const _css = (
-  /** @type {CNode}    */ node,
-  /** @type {string}   */ prefix,
-  /** @type {string[]} */ result,
-  /** @type {(text: string) => string} */ split
-) => {
-  const /** @type {[CNode | string[], string][]} */ queue = [[node, prefix]]
-
-  while (queue.length) {
-    const [style2, prefix2] = queue.shift() ?? []
-
-    if (style2 == null || prefix2 == null) {
-      continue
-    }
-
-    if (is(Array, style2)) {
-      result.push(prefix2, prefix2 !== '' ? '{' : '', style2.join(';'), prefix2 !== '' ? '}' : '')
-    } else {
-      const /** @type {[CNode | string[], string][]} */ todo = []
-      let /** @type {string[]} */ attributes = []
-      let attributesPushed = false
-
-      for (const key in style2) {
-        const value = style2[key]
-
-        if (is(String, value) || is(Number, value)) {
-          if (!attributesPushed) {
-            attributesPushed = true
-            attributes = []
-            todo.push([attributes, prefix2])
-          }
-
-          attributes.push(`${split(key).replace(/([A-Z])/g, (_, letter) => '-' + letter.toLowerCase())}:${value}`)
-        } else {
-          attributesPushed = false
-
-          const /** @type {string[]} */ newPrefix = []
-          const keySplitted = key.split(',')
-
-          for (const prefixItem of prefix2.split(',')) {
-            for (const keyItem of keySplitted) {
-              newPrefix.push(prefixItem + keyItem)
-            }
-          }
-
-          todo.push([value, newPrefix.join(',')])
-        }
-      }
-
-      queue.unshift(...todo)
-    }
-  }
-}
-
-export const css = (/** @type {CRoot} */ root, splitter = '$$') => {
-  const split = (/** @type {string} */ text) => text.split(splitter)[0]
-  const /** @type {string[]} */ result = []
-
-  for (const key in root) {
-    const value = root[key]
-
-    if (key[0] === '@') {
-      result.push(split(key) + '{')
-      _css(value, '', result, split)
-      result.push('}')
-    } else {
-      _css(value, split(key), result, split)
-    }
-  }
-
-  return result.join('')
-}
-
 const _COLORS = ['#e22', '#e73', '#fc3', '#ad4', '#4d9', '#3be', '#45d', '#c3e']
 
 /**
@@ -284,6 +211,33 @@ export const chartable = ({
   )
 }
 
+export const engineInfo = () => {
+  const /** @type {Set<Function>} */ fns = new Set()
+  let ref = window
+
+  while (ref != null) {
+    for (const name of Object.getOwnPropertyNames(ref)) {
+      // @ts-expect-error
+      let fn = ref[name]
+
+      if (is(Function, fn) && fn.toString?.()?.includes?.('[native code]')) {
+        while (fn != null && !fns.has(fn)) {
+          fns.add(fn)
+          fn = Object.getPrototypeOf(fn)
+        }
+      }
+    }
+
+    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 eq = /** @returns {boolean} */ (/** @type {any} */ x, /** @type {any} */ y) => {
   if (x === y) {
     return true
@@ -333,11 +287,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]
@@ -351,7 +305,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)
         }
       }
@@ -395,7 +349,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'
 }
 
@@ -452,7 +406,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)
@@ -511,6 +465,101 @@ export const has = (/** @type {any} */ key, /** @type {any} */ ref) =>
  */
 export const is = (/** @type {T} */ type, /** @type {any} */ arg) => arg?.constructor === type
 
+const _jcss = (
+  /** @type {JcssNode} */ node,
+  /** @type {string}   */ prefix,
+  /** @type {string[]} */ result,
+  /** @type {(text: string) => string} */ split
+) => {
+  const /** @type {[JcssNode | string[], string][]} */ queue = [[node, prefix]]
+
+  while (queue.length) {
+    const [style2, prefix2] = queue.shift() ?? []
+
+    if (style2 == null || prefix2 == null) {
+      continue
+    }
+
+    if (is(Array, style2)) {
+      result.push(prefix2, prefix2 !== '' ? '{' : '', style2.join(';'), prefix2 !== '' ? '}' : '')
+    } else {
+      const /** @type {[JcssNode | string[], string][]} */ todo = []
+      let /** @type {string[]} */ attributes = []
+      let attributesPushed = false
+
+      for (const key in style2) {
+        const value = style2[key]
+
+        if (is(String, value) || is(Number, value)) {
+          if (!attributesPushed) {
+            attributesPushed = true
+            attributes = []
+            todo.push([attributes, prefix2])
+          }
+
+          attributes.push(`${split(key).replace(/([A-Z])/g, (_, letter) => '-' + letter.toLowerCase())}:${value}`)
+        } else {
+          attributesPushed = false
+
+          const /** @type {string[]} */ newPrefix = []
+          const keySplitted = key.split(',')
+
+          for (const prefixItem of prefix2.split(',')) {
+            for (const keyItem of keySplitted) {
+              newPrefix.push(prefixItem + keyItem)
+            }
+          }
+
+          todo.push([value, newPrefix.join(',')])
+        }
+      }
+
+      queue.unshift(...todo)
+    }
+  }
+}
+
+export const jcss = (/** @type {JcssRoot} */ root, splitter = '$$') => {
+  const split = (/** @type {string} */ text) => text.split(splitter)[0]
+  const /** @type {string[]} */ result = []
+
+  for (const key in root) {
+    const value = root[key]
+
+    if (key[0] === '@') {
+      result.push(split(key) + '{')
+      _jcss(value, '', result, split)
+      result.push('}')
+    } else {
+      _jcss(value, split(key), result, split)
+    }
+  }
+
+  return result.join('')
+}
+
+export const jsOnParse = (
+  /** @type {Record<string, Function>} */ handlers,
+  /** @type {string}                   */ text
+) => JSON.parse(text, (key, value) => {
+  if (is(Object, value)) {
+    let isSecondKey = false
+
+    for (key in value) {
+      if (isSecondKey) {
+        return value
+      }
+      isSecondKey = true
+    }
+
+    if (has(key, handlers) && is(Array, value[key])) {
+      return handlers[key](...value[key])
+    }
+  }
+
+  return value
+})
+
 const _locale = (
   /** @type {Record<string, Record<string, string | Record<string, string>>>} */ locales,
   /** @type {string} */ language,

package/package.json

@@ -9,19 +9,26 @@
     "CSS-in-JS",
     "deepEqual",
     "DOM",
+    "eq",
     "equal",
     "escape",
+    "Gantt",
     "graph",
     "h",
+    "has",
     "highlight",
     "HyperScript",
     "in",
     "is",
+    "jcss",
+    "JSON",
+    "jsOnParse",
     "locale",
     "localization",
     "nanolight",
     "nnn",
     "RWD",
+    "SVG",
     "translation",
     "typography",
     "uuid",
@@ -33,5 +40,5 @@
   "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2023.8.25"
+  "version": "2023.8.27-18"
 }