@jackens/nnn 2024.2.26 → 2024.3.2-18

package/nnn.d.ts

@@ -127,16 +127,16 @@ export declare const is: {
 };
 
 /**
- * The type of arguments of the `jcss` helper.
+ * The type of arguments of the `jc` helper.
  */
-export type JcssNode = {
-    [attributeOrSelector: string]: string | number | JcssNode | undefined;
+export type JcNode = {
+    [attributeOrSelector: string]: string | number | JcNode | undefined;
 };
 
 /**
- * The type of arguments of the `jcss` helper.
+ * The type of arguments of the `jc` helper.
  */
-export type JcssRoot = Partial<Record<PropertyKey, JcssNode>>;
+export type JcRoot = Partial<Record<PropertyKey, JcNode>>;
 
 /**
  * A simple CSS-in-JS helper.
@@ -149,7 +149,7 @@ export type JcssRoot = Partial<Record<PropertyKey, JcssNode>>;
  * - 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 jcss: (root: JcssRoot, splitter?: string) => string;
+export declare const jc: (root: JcRoot, splitter?: string) => string;
 
 /**
  * `JSON.parse` with “JavaScript turned on”.

package/nnn.js

@@ -215,11 +215,8 @@ var eq = (x, y) => {
 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/has.ts
-var has = (key, ref) => (is(String, key) || is(Number, key) || is(Symbol, key)) && Object.hasOwnProperty.call(ref ?? Object, key);
-
 // src/nnn/fixTypography.ts
-var TAGS_TO_SKIP = { IFRAME: 1, NOSCRIPT: 1, PRE: 1, SCRIPT: 1, STYLE: 1, TEXTAREA: 1 };
+var TAGS_TO_SKIP = ["IFRAME", "NOSCRIPT", "PRE", "SCRIPT", "STYLE", "TEXTAREA"];
 var fixTypography = (node) => {
   const queue = [node];
   while (queue.length > 0) {
@@ -228,7 +225,7 @@ var fixTypography = (node) => {
       node0.childNodes.forEach((childNode) => {
         if (childNode instanceof Text) {
           queue.push(childNode);
-        } else if (childNode instanceof Element && !has(childNode.tagName, TAGS_TO_SKIP)) {
+        } else if (childNode instanceof Element && !TAGS_TO_SKIP.includes(childNode.tagName)) {
           queue.push(childNode);
         }
       });
@@ -250,8 +247,11 @@ var fixTypography = (node) => {
   }
 };
 
-// src/nnn/jcss.ts
-var _jcss = (node, prefix, result, split) => {
+// 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() ?? [];
@@ -285,7 +285,7 @@ var _jcss = (node, prefix, result, split) => {
     }
   }
 };
-var jcss = (root, splitter = "$$") => {
+var jc = (root, splitter = "$$") => {
   const split = (text) => text.split(splitter)[0];
   const chunks = [];
   for (const key in root) {
@@ -293,10 +293,10 @@ var jcss = (root, splitter = "$$") => {
     if (value != null) {
       if (key[0] === "@") {
         chunks.push(split(key) + "{");
-        _jcss(value, "", chunks, split);
+        _jc(value, "", chunks, split);
         chunks.push("}");
       } else {
-        _jcss(value, split(key), chunks, split);
+        _jc(value, split(key), chunks, split);
       }
     }
   }
@@ -340,7 +340,7 @@ var nanolight = (pattern, highlighters, code) => {
 };
 
 // src/nnn/nanolightJs.ts
-var nanolightJs = nanolight.bind(0, /('.*?'|".*?"|`[\s\S]*?`)|(\/\/.*?\n|\/\*[\s\S]*?\*\/)|(any|bigint|break|boolean|case|catch|const|continue|debugger|default|delete|do|else|eval|export|extends|false|finally|for|from|function|goto|if|import|in|instanceof|is|keyof|let|NaN|new|number|null|package|return|string|super|switch|symbol|this|throw|true|try|type|typeof|undefined|unknown|var|void|while|with|yield)(?!\w)|([<>=.?:&|!^~*/%+-])|(0x[\dabcdef]+|0o[01234567]+|0b[01]+|\d+(?:\.[\d_]+)?(?:e[+-]?[\d_]+)?)|([$\w]+)(?=\()|([$\wąćęłńóśżźĄĆĘŁŃÓŚŻŹ]+)/, [
+var nanolightJs = nanolight.bind(0, /('.*?'|".*?"|`[\s\S]*?`)|(\/\/.*?\n|\/\*[\s\S]*?\*\/)|(any|bigint|break|boolean|case|catch|class|const|continue|debugger|default|delete|do|else|eval|export|extends|false|finally|for|from|function|goto|if|import|in|instanceof|is|keyof|let|NaN|new|number|null|package|return|string|super|switch|symbol|this|throw|true|try|type|typeof|undefined|unknown|var|void|while|with|yield)(?!\w)|([<>=.?:&|!^~*/%+-])|(0x[\dabcdef]+|0o[01234567]+|0b[01]+|\d+(?:\.[\d_]+)?(?:e[+-]?[\d_]+)?)|([$\w]+)(?=\()|([$\wąćęłńóśżźĄĆĘŁŃÓŚŻŹ]+)/, [
   (chunk) => chunk,
   (chunk) => ["span", { class: "string" }, chunk],
   (chunk) => ["span", { class: "comment" }, chunk],
@@ -408,7 +408,7 @@ export {
   nanolight,
   locale,
   jsOnParse,
-  jcss,
+  jc,
   is,
   has,
   h,

package/package.json

@@ -42,5 +42,5 @@
   "types": "nnn.d.ts",
   "name": "@jackens/nnn",
   "type": "module",
-  "version": "2024.2.26"
+  "version": "2024.3.2-18"
 }

package/readme.md

@@ -2,7 +2,15 @@
 
 Jackens’ JavaScript helpers.
 
-<sub>Version: <code class="version">2024.2.26</code></sub>
+<sub>Version: <code class="version">2024.3.2-18</code></sub>
+
+## Examples
+
+- [Chartable Demo](https://jackens.github.io/nnn/chartable/)
+- [Chessboard Demo](https://jackens.github.io/nnn/chessboard/)
+- [Documentation](https://jackens.github.io/nnn/doc/)
+- [Gant Chart Demo](https://jackens.github.io/nnn/gantt/)
+- [Responsive Web Design Demo](https://jackens.github.io/nnn/rwd/)
 
 ## Installation
 
@@ -35,8 +43,8 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - `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.
-- `JcssNode`: The type of arguments of the `jcss` helper.
-- `JcssRoot`: The type of arguments of the `jcss` helper.
+- `JcNode`: The type of arguments of the `jc` helper.
+- `JcRoot`: The type of arguments of the `jc` helper.
 - `chartable`: A helper for creating a chart based on a table (conf. <https://jackens.github.io/nnn/chartable/>).
 - `eq`: A helper that checks equality of the given arguments.
 - `escape`: A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
@@ -45,7 +53,7 @@ import { «something» } from './node_modules/@jackens/nnn/nnn.js'
 - `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.
-- `jcss`: A simple CSS-in-JS helper.
+- `jc`: A simple 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`).
@@ -82,23 +90,23 @@ type HArgs1 = Partial<Record<PropertyKey, any>> | null | undefined | Node | stri
 
 The type of arguments of the `h` and `s` helpers.
 
-### JcssNode
+### JcNode
 
 ```ts
-type JcssNode = {
-    [attributeOrSelector: string]: string | number | JcssNode | undefined;
+type JcNode = {
+    [attributeOrSelector: string]: string | number | JcNode | undefined;
 };
 ```
 
-The type of arguments of the `jcss` helper.
+The type of arguments of the `jc` helper.
 
-### JcssRoot
+### JcRoot
 
 ```ts
-type JcssRoot = Partial<Record<PropertyKey, JcssNode>>;
+type JcRoot = Partial<Record<PropertyKey, JcNode>>;
 ```
 
-The type of arguments of the `jcss` helper.
+The type of arguments of the `jc` helper.
 
 ### chartable
 
@@ -432,10 +440,23 @@ expect(is(Object, fakeFooBar)).toBeTrue()
 expect(iz(Object, fakeFooBar)).toBeFalse()
 ```
 
-### jcss
+```js
+const num = 42
+const str = '42'
+
+expect(is(Number, num)).toBeTrue()
+
+try {
+  num.constructor = str.constructor
+} catch { /* empty */ }
+
+expect(is(Number, num)).toBeTrue()
+```
+
+### jc
 
 ```ts
-const jcss: (root: JcssRoot, splitter?: string) => string;
+const jc: (root: JcRoot, splitter?: string) => string;
 ```
 
 A simple CSS-in-JS helper.
@@ -451,7 +472,7 @@ The `root` parameter provides a hierarchical description of CSS rules.
 #### Usage Examples
 
 ```js
-const actual = jcss({
+const actual = jc({
   a: {
     color: 'red',
     margin: 1,
@@ -477,7 +498,7 @@ expect(actual).toStrictEqual(expected)
 ```
 
 ```js
-const actual = jcss({
+const actual = jc({
   a: {
     '.b': {
       color: 'red',
@@ -505,7 +526,7 @@ expect(actual).toStrictEqual(expected)
 ```
 
 ```js
-const actual = jcss({
+const actual = jc({
   '@font-face$$1': {
     fontFamily: 'Jackens',
     src$$1: 'url(otf/jackens.otf)',
@@ -580,7 +601,7 @@ expect(actual).toStrictEqual(expected)
 ```
 
 ```js
-const actual = jcss({
+const actual = jc({
   a: {
     '.b,.c': {
       margin: 1,
@@ -603,7 +624,7 @@ expect(actual).toStrictEqual(expected)
 ```
 
 ```js
-const actual = jcss({
+const actual = jc({
   '.b,.c': {
     margin: 1,
     '.d': {
@@ -624,7 +645,7 @@ expect(actual).toStrictEqual(expected)
 ```
 
 ```js
-const actual = jcss({
+const actual = jc({
   '.a,.b': {
     margin: 1,
     '.c,.d': {
@@ -762,8 +783,15 @@ A helper for highlighting JavaScript.
 ```js
 const codeJs = 'const answerToLifeTheUniverseAndEverything = 42'
 
-expect(h('pre', ['code', ...nanolightJs(codeJs)]).outerHTML).toStrictEqual(
-  '<pre><code><span class="keyword">const</span> <span class="literal">answerToLifeTheUniverseAndEverything</span> <span class="operator">=</span> <span class="number">42</span></code></pre>')
+expect(nanolightJs(codeJs)).toStrictEqual([
+  ['span', { class: 'keyword' }, 'const'],
+  ' ',
+  ['span', { class: 'literal' }, 'answerToLifeTheUniverseAndEverything'],
+  ' ',
+  ['span', { class: 'operator' }, '='],
+  ' ',
+  ['span', { class: 'number' }, '42']
+])
 ```
 
 ### omit