@jackens/nnn 2023.8.26 → 2023.8.27

package/nnn.d.ts

@@ -136,6 +136,23 @@ export function is<T extends abstract new (...args: any[]) => any>(type: T, arg:
  */
 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

@@ -511,6 +511,28 @@ export const jcss = (/** @type {JcssRoot} */ root, splitter = '$$') => {
   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

@@ -12,19 +12,23 @@
     "eq",
     "equal",
     "escape",
-    "gantt",
+    "Gantt",
     "graph",
     "h",
+    "has",
     "highlight",
     "HyperScript",
     "in",
     "is",
     "jcss",
+    "JSON",
+    "jsOnParse",
     "locale",
     "localization",
     "nanolight",
     "nnn",
     "RWD",
+    "SVG",
     "translation",
     "typography",
     "uuid",
@@ -36,5 +40,5 @@
   "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2023.8.26"
+  "version": "2023.8.27"
 }