npm - @jackens/nnn - Versions diffs - 2024.7.13 → 2024.7.14 - Mend

@jackens/nnn 2024.7.13 → 2024.7.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/nnn.d.ts CHANGED Viewed

@@ -1,3 +1,32 @@
+/**
+ * The type of arguments of the `c` helper.
+ */
+export type CNode = {
+    [attributeOrSelector: string]: string | number | CNode | undefined;
+};
+/**
+ * The type of arguments of the `c` helper.
+ */
+export type CRoot = Partial<Record<PropertyKey, CNode>>;
+/**
+ * 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}`).
+ * - Top-level keys that begin with `@` are not concatenated with sub-object keys.
+ */
+export declare const c: (root: CRoot, splitter?: string) => string;
 /**
  * A tiny helper for CSV parsing.
  *
@@ -41,19 +70,21 @@ 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`.
+ *   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];
@@ -62,19 +93,21 @@ 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`.
+ *   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];
@@ -107,31 +140,6 @@ export declare const is: {
     <T extends abstract new (...args: Partial<Array<any>>) => unknown>(type: T, arg: unknown): arg is InstanceType<T>;
 };
-/**
- * The type of arguments of the `jc` helper.
- */
-export type JcNode = {
-    [attributeOrSelector: string]: string | number | JcNode | undefined;
-};
-/**
- * The type of arguments of the `jc` helper.
- */
-export type JcRoot = Partial<Record<PropertyKey, JcNode>>;
-/**
- * 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}`).
- * - Top-level keys that begin with `@` are not concatenated with sub-object keys.
- */
-export declare const jc: (root: JcRoot, splitter?: string) => string;
 /**
  * `JSON.parse` with “JavaScript turned on”.
  *
@@ -180,7 +188,8 @@ export declare const omit: <T extends Partial<Record<PropertyKey, unknown>>, K e
 export declare const plUral: (singular: string, plural2: string, plural5: string, value: number) => string;
 /**
- * A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
+ * A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty
+ * object.
  */
 export declare const pro: (ref: unknown) => any;

package/nnn.js CHANGED Viewed

@@ -1,3 +1,59 @@
+// src/nnn/is.ts
+var is = (type, arg) => arg?.constructor === type;
+// src/nnn/c.ts
+var _c = (node, prefix, result, split) => {
+  const queue = [[node, prefix]];
+  while (queue.length > 0) {
+    const [style0, prefix0] = queue.shift() ?? [];
+    if (style0 == null || prefix0 == null) {
+      continue;
+    }
+    if (is(Array, style0)) {
+      result.push(prefix0, prefix0 !== "" ? "{" : "", style0.join(";"), prefix0 !== "" ? "}" : "");
+    } else {
+      const todo = [];
+      let attributes = [];
+      let attributesPushed = false;
+      for (const key in style0) {
+        const value = style0[key];
+        if (is(String, value) || is(Number, value)) {
+          if (!attributesPushed) {
+            attributesPushed = true;
+            attributes = [];
+            todo.push([attributes, prefix0]);
+          }
+          attributes.push(`${split(key).replace(/([A-Z])/g, (_, letter) => "-" + letter.toLowerCase())}:${value}`);
+        } else if (value != null) {
+          attributesPushed = false;
+          const prefixN = [];
+          const keyChunks = key.split(",");
+          prefix0.split(",").forEach((prefixChunk) => keyChunks.forEach((keyChunk) => prefixN.push(prefixChunk + keyChunk)));
+          todo.push([value, prefixN.join(",")]);
+        }
+      }
+      queue.unshift(...todo);
+    }
+  }
+};
+var c = (root, splitter = "$$") => {
+  const split = (text) => text.split(splitter)[0];
+  const chunks = [];
+  for (const key in root) {
+    const value = root[key];
+    if (value != null) {
+      if (key[0] === "@") {
+        chunks.push(split(key) + "{");
+        _c(value, "", chunks, split);
+        chunks.push("}");
+      } else {
+        _c(value, split(key), chunks, split);
+      }
+    }
+  }
+  return chunks.join("");
+};
 // src/nnn/csvParse.ts
 var csvParse = (text, { header = true, separator = "," } = {}) => {
   const regExp = new RegExp(`${separator}|(?<!")\\s*"((?:[^"]|"")*)"\\s*(?!")`, "g");
@@ -16,9 +72,6 @@ var csvParse = (text, { header = true, separator = "," } = {}) => {
 var escapeValues = (escapeMap, values) => values.map((value) => (escapeMap.get(value?.constructor) ?? escapeMap.get(undefined))?.(value) ?? "");
 var escape = (escapeMap, template, ...values) => String.raw(template, ...escapeValues(escapeMap, values));
-// src/nnn/is.ts
-var is = (type, arg) => arg?.constructor === type;
 // src/nnn/h.ts
 var NS = {
   xlink: "http://www.w3.org/1999/xlink"
@@ -119,59 +172,6 @@ var fixTypography = (node) => {
 // src/nnn/has.ts
 var has = (key, ref) => (is(String, key) || is(Number, key) || is(Symbol, key)) && Object.hasOwnProperty.call(ref ?? Object, key);
-// src/nnn/jc.ts
-var _jc = (node, prefix, result, split) => {
-  const queue = [[node, prefix]];
-  while (queue.length > 0) {
-    const [style0, prefix0] = queue.shift() ?? [];
-    if (style0 == null || prefix0 == null) {
-      continue;
-    }
-    if (is(Array, style0)) {
-      result.push(prefix0, prefix0 !== "" ? "{" : "", style0.join(";"), prefix0 !== "" ? "}" : "");
-    } else {
-      const todo = [];
-      let attributes = [];
-      let attributesPushed = false;
-      for (const key in style0) {
-        const value = style0[key];
-        if (is(String, value) || is(Number, value)) {
-          if (!attributesPushed) {
-            attributesPushed = true;
-            attributes = [];
-            todo.push([attributes, prefix0]);
-          }
-          attributes.push(`${split(key).replace(/([A-Z])/g, (_, letter) => "-" + letter.toLowerCase())}:${value}`);
-        } else if (value != null) {
-          attributesPushed = false;
-          const prefixN = [];
-          const keyChunks = key.split(",");
-          prefix0.split(",").forEach((prefixChunk) => keyChunks.forEach((keyChunk) => prefixN.push(prefixChunk + keyChunk)));
-          todo.push([value, prefixN.join(",")]);
-        }
-      }
-      queue.unshift(...todo);
-    }
-  }
-};
-var jc = (root, splitter = "$$") => {
-  const split = (text) => text.split(splitter)[0];
-  const chunks = [];
-  for (const key in root) {
-    const value = root[key];
-    if (value != null) {
-      if (key[0] === "@") {
-        chunks.push(split(key) + "{");
-        _jc(value, "", chunks, split);
-        chunks.push("}");
-      } else {
-        _jc(value, split(key), chunks, split);
-      }
-    }
-  }
-  return chunks.join("");
-};
 // src/nnn/jsOnParse.ts
 var jsOnParse = (handlers, text) => JSON.parse(text, (key, value) => {
   if (is(Object, value)) {
@@ -280,12 +280,12 @@ export {
   nanolight,
   locale,
   jsOnParse,
-  jc,
   is,
   has,
   h,
   fixTypography,
   escapeValues,
   escape,
-  csvParse
+  csvParse,
+  c
 };

package/package.json CHANGED Viewed

@@ -3,6 +3,7 @@
   "description": "Jackens’ JavaScript helpers.",
   "homepage": "https://jackens.github.io/nnn/doc/",
   "keywords": [
+    "c",
     "CSS-in-JS",
     "CSV",
     "csvParse",
@@ -14,7 +15,6 @@
     "HyperScript",
     "in",
     "is",
-    "jc",
     "JS-to-CSS",
     "JSON",
     "jsOnParse",
@@ -36,5 +36,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2024.7.13"
+  "version": "2024.7.14"
 }

package/readme.md CHANGED Viewed

@@ -2,7 +2,7 @@
 Jackens’ JavaScript helpers.
-<sub>Version: <code class="version">2024.7.13</code></sub>
+<sub>Version: <code class="version">2024.7.14</code></sub>
 ## Installation
@@ -31,24 +31,24 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 or:
 ```js
-import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.7.13/nnn.js'
+import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.7.14/nnn.js'
 ```
 ## Exports
+- `CNode`: The type of arguments of the `c` helper.
+- `CRoot`: The type of arguments of the `c` helper.
 - `EscapeMap`: The type of arguments of the `escapeValues` and `escape` helpers.
 - `HArgs`: The type of arguments of the `h` and `s` helpers.
 - `HArgs1`: The type of arguments of the `h` and `s` helpers.
-- `JcNode`: The type of arguments of the `jc` helper.
-- `JcRoot`: The type of arguments of the `jc` helper.
+- `c`: A simple JS-to-CSS (aka CSS-in-JS) helper.
 - `csvParse`: A tiny helper for CSV parsing.
 - `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 `HTMLElement`s (see also `s`).
+- `h`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying
 - `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.
-- `jc`: A simple JS-to-CSS (aka CSS-in-JS) helper.
 - `jsOnParse`: `JSON.parse` with “JavaScript turned on”.
 - `locale`: Language translations helper.
 - `nanolight`: A generic helper for syntax highlighting (see also `nanolightJs`).
@@ -56,12 +56,30 @@ import { «something» } from 'https://unpkg.com/@jackens/nnn@2024.7.13/nnn.js'
 - `omit`: A helper that implements TypeScript’s `Omit` utility type.
 - `pick`: A helper that implements TypeScript’s `Pick` utility type.
 - `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 object.
+- `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 `SVGElement`s (see also `h`).
+- `s`: A lightweight [HyperScript](https://github.com/hyperhype/hyperscript)-style helper for creating and modifying
 - `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).
+### CNode
+```ts
+type CNode = {
+    [attributeOrSelector: string]: string | number | CNode | undefined;
+};
+```
+The type of arguments of the `c` helper.
+### CRoot
+```ts
+type CRoot = Partial<Record<PropertyKey, CNode>>;
+```
+The type of arguments of the `c` helper.
 ### EscapeMap
 ```ts
@@ -86,23 +104,221 @@ type HArgs1 = Partial<Record<PropertyKey, unknown>> | null | undefined | Node |
 The type of arguments of the `h` and `s` helpers.
-### JcNode
+### c
 ```ts
-type JcNode = {
-    [attributeOrSelector: string]: string | number | JcNode | undefined;
-};
+const c: (root: CRoot, splitter?: string) => string;
 ```
-The type of arguments of the `jc` helper.
+A simple JS-to-CSS (aka CSS-in-JS) helper.
+The `root` parameter provides a hierarchical description of CSS rules.
-### JcRoot
+- 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.
-```ts
-type JcRoot = Partial<Record<PropertyKey, JcNode>>;
+#### Usage Examples
+```js
+const actual = c({
+  a: {
+    color: 'red',
+    margin: 1,
+    '.c': { margin: 2, padding: 2 },
+    padding: 1
+  }
+})
+const expected = `
+a{
+  color:red;
+  margin:1
+}
+a.c{
+  margin:2;
+  padding:2
+}
+a{
+  padding:1
+}`.replace(/\n\s*/g, '')
+expect(actual).to.deep.equal(expected)
+```
+```js
+const actual = c({
+  a: {
+    '.b': {
+      color: 'red',
+      margin: 1,
+      '.c': { margin: 2, padding: 2 },
+      padding: 1
+    }
+  }
+})
+const expected = `
+a.b{
+  color:red;
+  margin:1
+}
+a.b.c{
+  margin:2;
+  padding:2
+}
+a.b{
+  padding:1
+}`.replace(/\n\s*/g, '')
+expect(actual).to.deep.equal(expected)
+```
+```js
+const actual = c({
+  '@font-face$$1': {
+    fontFamily: 'Jackens',
+    src$$1: 'url(otf/jackens.otf)',
+    src$$2: "url(otf/jackens.otf) format('opentype')," +
+      "url(svg/jackens.svg) format('svg')",
+    fontWeight: 'normal',
+    fontStyle: 'normal'
+  },
+  '@font-face$$2': {
+    fontFamily: 'C64',
+    src: 'url(fonts/C64_Pro_Mono-STYLE.woff)'
+  },
+  '@keyframes spin': {
+    '0%': { transform: 'rotate(0deg)' },
+    '100%': { transform: 'rotate(360deg)' }
+  },
+  div: {
+    border: 'solid red 1px',
+    '.c1': { 'background-color': '#000' },
+    ' .c1': { backgroundColor: 'black' },
+    '.c2': { backgroundColor: 'rgb(0,0,0)' }
+  },
+  '@media(min-width:200px)': {
+    div: { margin: 0, padding: 0 },
+    span: { color: '#000' }
+  }
+})
+const expected = `
+@font-face{
+  font-family:Jackens;
+  src:url(otf/jackens.otf);
+  src:url(otf/jackens.otf) format('opentype'),url(svg/jackens.svg) format('svg');
+  font-weight:normal;
+  font-style:normal
+}
+@font-face{
+  font-family:C64;
+  src:url(fonts/C64_Pro_Mono-STYLE.woff)
+}
+@keyframes spin{
+  0%{
+    transform:rotate(0deg)
+  }
+  100%{
+    transform:rotate(360deg)
+  }
+}
+div{
+  border:solid red 1px
+}
+div.c1{
+  background-color:#000
+}
+div .c1{
+  background-color:black
+}
+div.c2{
+  background-color:rgb(0,0,0)
+}
+@media(min-width:200px){
+  div{
+    margin:0;
+    padding:0
+  }
+  span{
+    color:#000
+  }
+}`.replace(/\n\s*/g, '')
+expect(actual).to.deep.equal(expected)
 ```
-The type of arguments of the `jc` helper.
+```js
+const actual = c({
+  a: {
+    '.b,.c': {
+      margin: 1,
+      '.d': {
+        margin: 2
+      }
+    }
+  }
+})
+const expected = `
+a.b,a.c{
+  margin:1
+}
+a.b.d,a.c.d{
+  margin:2
+}`.replace(/\n\s*/g, '')
+expect(actual).to.deep.equal(expected)
+```
+```js
+const actual = c({
+  '.b,.c': {
+    margin: 1,
+    '.d': {
+      margin: 2
+    }
+  }
+})
+const expected = `
+.b,.c{
+  margin:1
+}
+.b.d,.c.d{
+  margin:2
+}`.replace(/\n\s*/g, '')
+expect(actual).to.deep.equal(expected)
+```
+```js
+const actual = c({
+  '.a,.b': {
+    margin: 1,
+    '.c,.d': {
+      margin: 2
+    }
+  }
+})
+const expected = `
+.a,.b{
+  margin:1
+}
+.a.c,.a.d,.b.c,.b.d{
+  margin:2
+}`.replace(/\n\s*/g, '')
+expect(actual).to.deep.equal(expected)
+```
 ### csvParse
@@ -220,19 +436,21 @@ 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`.
+  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
@@ -419,218 +637,6 @@ try {
 expect(is(Number, num)).to.be.true
 ```
-### jc
-```ts
-const jc: (root: JcRoot, splitter?: string) => string;
-```
-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}`).
-- Top-level keys that begin with `@` are not concatenated with sub-object keys.
-#### Usage Examples
-```js
-const actual = jc({
-  a: {
-    color: 'red',
-    margin: 1,
-    '.c': { margin: 2, padding: 2 },
-    padding: 1
-  }
-})
-const expected = `
-a{
-  color:red;
-  margin:1
-}
-a.c{
-  margin:2;
-  padding:2
-}
-a{
-  padding:1
-}`.replace(/\n\s*/g, '')
-expect(actual).to.deep.equal(expected)
-```
-```js
-const actual = jc({
-  a: {
-    '.b': {
-      color: 'red',
-      margin: 1,
-      '.c': { margin: 2, padding: 2 },
-      padding: 1
-    }
-  }
-})
-const expected = `
-a.b{
-  color:red;
-  margin:1
-}
-a.b.c{
-  margin:2;
-  padding:2
-}
-a.b{
-  padding:1
-}`.replace(/\n\s*/g, '')
-expect(actual).to.deep.equal(expected)
-```
-```js
-const actual = jc({
-  '@font-face$$1': {
-    fontFamily: 'Jackens',
-    src$$1: 'url(otf/jackens.otf)',
-    src$$2: "url(otf/jackens.otf) format('opentype')," +
-      "url(svg/jackens.svg) format('svg')",
-    fontWeight: 'normal',
-    fontStyle: 'normal'
-  },
-  '@font-face$$2': {
-    fontFamily: 'C64',
-    src: 'url(fonts/C64_Pro_Mono-STYLE.woff)'
-  },
-  '@keyframes spin': {
-    '0%': { transform: 'rotate(0deg)' },
-    '100%': { transform: 'rotate(360deg)' }
-  },
-  div: {
-    border: 'solid red 1px',
-    '.c1': { 'background-color': '#000' },
-    ' .c1': { backgroundColor: 'black' },
-    '.c2': { backgroundColor: 'rgb(0,0,0)' }
-  },
-  '@media(min-width:200px)': {
-    div: { margin: 0, padding: 0 },
-    span: { color: '#000' }
-  }
-})
-const expected = `
-@font-face{
-  font-family:Jackens;
-  src:url(otf/jackens.otf);
-  src:url(otf/jackens.otf) format('opentype'),url(svg/jackens.svg) format('svg');
-  font-weight:normal;
-  font-style:normal
-}
-@font-face{
-  font-family:C64;
-  src:url(fonts/C64_Pro_Mono-STYLE.woff)
-}
-@keyframes spin{
-  0%{
-    transform:rotate(0deg)
-  }
-  100%{
-    transform:rotate(360deg)
-  }
-}
-div{
-  border:solid red 1px
-}
-div.c1{
-  background-color:#000
-}
-div .c1{
-  background-color:black
-}
-div.c2{
-  background-color:rgb(0,0,0)
-}
-@media(min-width:200px){
-  div{
-    margin:0;
-    padding:0
-  }
-  span{
-    color:#000
-  }
-}`.replace(/\n\s*/g, '')
-expect(actual).to.deep.equal(expected)
-```
-```js
-const actual = jc({
-  a: {
-    '.b,.c': {
-      margin: 1,
-      '.d': {
-        margin: 2
-      }
-    }
-  }
-})
-const expected = `
-a.b,a.c{
-  margin:1
-}
-a.b.d,a.c.d{
-  margin:2
-}`.replace(/\n\s*/g, '')
-expect(actual).to.deep.equal(expected)
-```
-```js
-const actual = jc({
-  '.b,.c': {
-    margin: 1,
-    '.d': {
-      margin: 2
-    }
-  }
-})
-const expected = `
-.b,.c{
-  margin:1
-}
-.b.d,.c.d{
-  margin:2
-}`.replace(/\n\s*/g, '')
-expect(actual).to.deep.equal(expected)
-```
-```js
-const actual = jc({
-  '.a,.b': {
-    margin: 1,
-    '.c,.d': {
-      margin: 2
-    }
-  }
-})
-const expected = `
-.a,.b{
-  margin:1
-}
-.a.c,.a.d,.b.c,.b.d{
-  margin:2
-}`.replace(/\n\s*/g, '')
-expect(actual).to.deep.equal(expected)
-```
 ### jsOnParse
 ```ts
@@ -824,7 +830,8 @@ expect(car(42)).to.deep.equal('cars')
 const pro: (ref: unknown) => any;
 ```
-A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
+A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty
+object.
 #### Usage Examples
@@ -909,19 +916,21 @@ 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`.
+  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