@jackens/nnn 2024.7.14 → 2024.8.6

package/nnn.d.ts

@@ -15,14 +15,10 @@ export type CRoot = Partial<Record<PropertyKey, CNode>>;
  *
  * 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}`).
+ * - 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 declare const c: (root: CRoot, splitter?: string) => string;
@@ -70,21 +66,15 @@ export type HArgs1 = Partial<Record<PropertyKey, unknown>> | null | undefined |
 export type HArgs = [string | Node, ...HArgs1[]];
 
 /**
- * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying
- * `HTMLElement`s (see also `s`).
+ * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
  *
  * - The first argument of type `string` specifies the tag of the element to be created.
  * - The first argument of type `Node` specifies the element to be modified.
- * - All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties.
- *   Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or
- *   modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by
- *   `setAttribute`. An attribute equal to `false` causes the attribute to be removed by `removeAttribute`.
+ * - All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttribute`. An attribute equal to `false` causes the attribute to be removed by `removeAttribute`.
  * - All other arguments of type `null` or `undefined` are simply ignored.
  * - All other arguments of type `Node` are appended to the element being created or modified.
- * - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being
- *   created or modified.
- * - All other arguments of type `HArgs` are passed to `h` and the results are appended to the element being created or
- *   modified.
+ * - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
+ * - All other arguments of type `HArgs` are passed to `h` and the results are appended to the element being created or modified.
  */
 export declare const h: {
     <T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: Partial<Array<HArgs1>>): HTMLElementTagNameMap[T];
@@ -93,21 +83,15 @@ export declare const h: {
 };
 
 /**
- * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying
- * `SVGElement`s (see also `h`).
+ * A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
  *
  * - The first argument of type `string` specifies the tag of the element to be created.
  * - The first argument of type `Node` specifies the element to be modified.
- * - All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties.
- *   Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or
- *   modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by
- *   `setAttributeNS`. An attribute equal to `false` causes the attribute to be removed by `removeAttributeNS`.
+ * - All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttributeNS`. An attribute equal to `false` causes the attribute to be removed by `removeAttributeNS`.
  * - All other arguments of type `null` or `undefined` are simply ignored.
  * - All other arguments of type `Node` are appended to the element being created or modified.
- * - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being
- *   created or modified.
- * - All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or
- *   modified.
+ * - All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
+ * - All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or modified.
  */
 export declare const s: {
     <T extends keyof SVGElementTagNameMap>(tag: T, ...args1: Partial<Array<HArgs1>>): SVGElementTagNameMap[T];
@@ -168,17 +152,17 @@ export declare const locale: (map: Partial<Record<PropertyKey, Partial<Record<Pr
 export declare const nanolight: (pattern: RegExp, highlighters: Partial<Array<(chunk: string, index: number) => HArgs1>>, code: string) => HArgs1[];
 
 /**
- * A helper for highlighting JavaScript.
+ * A helper for highlighting JavaScript (see also `nanolight`).
  */
 export declare const nanolightJs: (code: string) => HArgs1[];
 
 /**
- * A helper that implements TypeScript’s `Pick` utility type.
+ * A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
  */
 export declare const pick: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Pick<T, K[number]>;
 
 /**
- * A helper that implements TypeScript’s `Omit` utility type.
+ * A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
  */
 export declare const omit: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Omit<T, K[number]>;
 
@@ -203,8 +187,7 @@ export declare const refsInfo: (...refs: Partial<Array<unknown>>) => Partial<Arr
 /**
  * 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.
+ * - 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;

package/nnn.js

@@ -184,7 +184,7 @@ var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
     }
     const handler = handlers[key];
     const params = value[key];
-    if (is(Function, handler) && is(Array, params)) {
+    if (handler instanceof Function && is(Array, params)) {
       return handler(...params);
     }
   }
@@ -244,9 +244,12 @@ var pro = (ref) => new Proxy(ref, {
 var refsInfo = (...refs) => {
   const fns = new Set;
   refs.forEach((ref) => {
-    while (is(Function, ref) && !fns.has(ref) && `${ref}`.includes("[native code]")) {
-      fns.add(ref);
-      ref = Object.getPrototypeOf(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) => [

package/package.json

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

package/readme.md

@@ -2,7 +2,13 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2024.7.14</code></sub>
+<sub>Version: <code class="version">2024.8.6</code></sub>
+
+* [Documentation](https://jackens.github.io/nnn/doc/)
+* [Tests](https://jackens.github.io/nnn/test/)
+* [Chessboard Demo](https://jackens.github.io/nnn/chessboard/)
+* [Gantt Chart Demo](https://jackens.github.io/nnn/gantt/)
+* [Responsive Web Design Demo](https://jackens.github.io/nnn/rwd/)
 
 ## Installation
 
@@ -31,7 +37,7 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 or:
 
 ```js
-import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.7.14/nnn.js'
+import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.8.6/nnn.js'
 ```
 
 ## Exports
@@ -46,19 +52,19 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.7.14/nnn.js'
 - `escape`: A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
 - `escapeValues`: A generic helper for escaping `values` by given `escapeMap`.
 - `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
+- `h`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
 - `has`: 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.
 - `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
 - `locale`: Language translations helper.
 - `nanolight`: A generic helper for syntax highlighting (see also `nanolightJs`).
-- `nanolightJs`: A helper for highlighting JavaScript.
-- `omit`: A helper that implements TypeScript’s `Omit` utility type.
-- `pick`: A helper that implements TypeScript’s `Pick` utility type.
+- `nanolightJs`: A helper for highlighting JavaScript (see also `nanolight`).
+- `omit`: A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
+- `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
+- `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).
 
@@ -114,14 +120,10 @@ A simple JS-to-CSS (aka 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}`).
+- 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.
 
 #### Usage Examples
@@ -436,21 +438,15 @@ const h: {
 };
 ```
 
-A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying
-`HTMLElement`s (see also `s`).
+A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `HTMLElement`s (see also `s`).
 
 - The first argument of type `string` specifies the tag of the element to be created.
 - The first argument of type `Node` specifies the element to be modified.
-- All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties.
-  Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or
-  modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by
-  `setAttribute`. An attribute equal to `false` causes the attribute to be removed by `removeAttribute`.
+- All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttribute`. An attribute equal to `false` causes the attribute to be removed by `removeAttribute`.
 - All other arguments of type `null` or `undefined` are simply ignored.
 - All other arguments of type `Node` are appended to the element being created or modified.
-- All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being
-  created or modified.
-- All other arguments of type `HArgs` are passed to `h` and the results are appended to the element being created or
-  modified.
+- All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
+- All other arguments of type `HArgs` are passed to `h` and the results are appended to the element being created or modified.
 
 #### Usage Examples
 
@@ -748,7 +744,7 @@ A generic helper for syntax highlighting (see also `nanolightJs`).
 const nanolightJs: (code: string) => HArgs1[];
 ```
 
-A helper for highlighting JavaScript.
+A helper for highlighting JavaScript (see also `nanolight`).
 
 #### Usage Examples
 
@@ -772,7 +768,7 @@ expect(nanolightJs(codeJs)).to.deep.equal([
 const omit: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Omit<T, K[number]>;
 ```
 
-A helper that implements TypeScript’s `Omit` utility type.
+A helper that implements TypeScript’s `Omit` utility type (see also `pick`).
 
 #### Usage Examples
 
@@ -788,7 +784,7 @@ expect(omit(obj, ['c'])).to.deep.equal({ a: 42, b: '42' })
 const pick: <T extends Partial<Record<PropertyKey, unknown>>, K extends Array<keyof T>>(obj: Partial<Record<PropertyKey, unknown>>, keys: Partial<Array<unknown>>) => Pick<T, K[number]>;
 ```
 
-A helper that implements TypeScript’s `Pick` utility type.
+A helper that implements TypeScript’s `Pick` utility type (see also `omit`).
 
 #### Usage Examples
 
@@ -916,21 +912,15 @@ const s: {
 };
 ```
 
-A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying
-`SVGElement`s (see also `h`).
+A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying `SVGElement`s (see also `h`).
 
 - The first argument of type `string` specifies the tag of the element to be created.
 - The first argument of type `Node` specifies the element to be modified.
-- All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties.
-  Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or
-  modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by
-  `setAttributeNS`. An attribute equal to `false` causes the attribute to be removed by `removeAttributeNS`.
+- All other arguments of type `Partial<Record<PropertyKey, unknown>>` are mappings of attributes and properties. Keys starting with `$` specify *properties* (without the leading `$`) to be set on the element being created or modified. (Note that `$` is not a valid attribute name character.) All other keys specify *attributes* to be set by `setAttributeNS`. An attribute equal to `false` causes the attribute to be removed by `removeAttributeNS`.
 - All other arguments of type `null` or `undefined` are simply ignored.
 - All other arguments of type `Node` are appended to the element being created or modified.
-- All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being
-  created or modified.
-- All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or
-  modified.
+- All other arguments of type `string`/`number` are converted to `Text` nodes and appended to the element being created or modified.
+- All other arguments of type `HArgs` are passed to `s` and the results are appended to the element being created or modified.
 
 ### svgUse
 
@@ -951,8 +941,7 @@ const uuid1: ({ date, node }?: {
 
 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.
+- The optional `node` parameter should have the format `/^[0123456789abcdef]+$/`. Its value will be trimmed to last 12 characters and left padded with zeros.
 
 #### Usage Examples