@jackens/nnn 2026.4.14 → 2026.4.15

package/package.json

@@ -44,5 +44,5 @@
   "name": "@jackens/nnn",
   "type": "module",
   "types": "nnn.d.ts",
-  "version": "2026.4.14"
+  "version": "2026.4.15"
 }

package/readme.md

@@ -1,6 +1,6 @@
 # nnn
 
-A collection of Jackens’ JavaScript helper utilities (version: `2026.4.14`).
+A collection of Jackens’ JavaScript helper utilities (version: `2026.4.15`).
 
 ## Installation
 
@@ -19,30 +19,29 @@ npm i @jackens/nnn
 ```js
 import {
   c,
-csvParse,
-fixPlTypography,
-h,
-hasOwn,
-isArray,
-isFiniteNumber,
-isInteger,
-isNumber,
-isRecord,
-isString,
-jsOnParse,
-monokai,
-nanolightTs,
-newEscape,
-newNounForm,
-newTokenizer,
-omit,
-pick,
-rwd,
-s,
-svgUse,
-uuidV1,
-vivify,
-
+  csvParse,
+  fixPlTypography,
+  h,
+  hasOwn,
+  isArray,
+  isFiniteNumber,
+  isInteger,
+  isNumber,
+  isRecord,
+  isString,
+  jsOnParse,
+  monokai,
+  nanolightTs,
+  newEscape,
+  newNounForm,
+  newTokenizer,
+  omit,
+  pick,
+  rwd,
+  s,
+  svgUse,
+  uuidV1,
+  vivify,
 } from '@jackens/nnn' // or './node_modules/@jackens/nnn/nnn.js'
 ```
 
@@ -216,14 +215,16 @@ A CSS string representing the compiled rules.
 #### Usage Examples
 
 ```ts
-const actual1 = c({
-  a: {
-    color: 'red',
-    margin: 1,
-    '.c': { margin: 2, padding: 2 },
-    padding: 1,
+const actual1 = c(
+  {
+    a: {
+      color: 'red',
+      margin: 1,
+      '.c': { margin: 2, padding: 2 },
+      padding: 1,
+    },
   },
-})
+)
 
 const expected1 = `
 a{
@@ -240,16 +241,18 @@ a{
 
 expect(actual1).to.equal(expected1)
 
-const actual2 = c({
-  a: {
-    '.b': {
-      color: 'red',
-      margin: 1,
-      '.c': { margin: 2, padding: 2 },
-      padding: 1,
+const actual2 = c(
+  {
+    a: {
+      '.b': {
+        color: 'red',
+        margin: 1,
+        '.c': { margin: 2, padding: 2 },
+        padding: 1,
+      },
     },
   },
-})
+)
 
 const expected2 = `
 a.b{
@@ -266,34 +269,36 @@ a.b{
 
 expect(actual2).to.equal(expected2)
 
-const actual3 = c({
-  '@font-face$$1': {
-    fontFamily: 'Jackens',
-    src$$1: 'url(otf/jackens.otf)',
-    src$$2: "url(otf/jackens.otf) format('opentype')," +
+const actual3 = 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')",
-    font_weight: 'normal',
-    'font-style': 'normal',
-  },
-  '@font-face$$2': {
-    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',
-    '.c1': { 'background-color': '#000' },
-    ' .c1': { background_color: 'black' },
-    '.c2': { backgroundColor: 'rgb(0,0,0)' },
-  },
-  '@media(min-width:200px)': {
-    div: { margin: 0, padding: 0 },
-    span: { color: '#000' },
+      font_weight: 'normal',
+      'font-style': 'normal',
+    },
+    '@font-face$$2': {
+      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',
+      '.c1': { 'background-color': '#000' },
+      ' .c1': { background_color: 'black' },
+      '.c2': { backgroundColor: 'rgb(0,0,0)' },
+    },
+    '@media(min-width:200px)': {
+      div: { margin: 0, padding: 0 },
+      span: { color: '#000' },
+    },
   },
-})
+)
 
 const expected3 = `
 @font-face{
@@ -339,16 +344,18 @@ div.c2{
 
 expect(actual3).to.equal(expected3)
 
-const actual4 = c({
-  a: {
-    '.b,.c': {
-      margin: 1,
-      '.d': {
-        margin: 2,
+const actual4 = c(
+  {
+    a: {
+      '.b,.c': {
+        margin: 1,
+        '.d': {
+          margin: 2,
+        },
       },
     },
   },
-})
+)
 
 const expected4 = `
 a.b,a.c{
@@ -360,14 +367,16 @@ a.b.d,a.c.d{
 
 expect(actual4).to.equal(expected4)
 
-const actual5 = c({
-  '.b,.c': {
-    margin: 1,
-    '.d': {
-      margin: 2,
+const actual5 = c(
+  {
+    '.b,.c': {
+      margin: 1,
+      '.d': {
+        margin: 2,
+      },
     },
   },
-})
+)
 
 const expected5 = `
 .b,.c{
@@ -379,14 +388,16 @@ const expected5 = `
 
 expect(actual5).to.equal(expected5)
 
-const actual6 = c({
-  '.a,.b': {
-    margin: 1,
-    '.c,.d': {
-      margin: 2,
+const actual6 = c(
+  {
+    '.a,.b': {
+      margin: 1,
+      '.c,.d': {
+        margin: 2,
+      },
     },
   },
-})
+)
 
 const expected6 = `
 .a,.b{
@@ -436,11 +447,13 @@ yyy",zzz
 
 `
 
-expect(csvParse(text)).to.deep.equal([
-  ['aaa\n"aaa"\naaa', 'bbb', 'ccc,ccc'],
-  ['xxx,xxx', 'yyy\nyyy', 'zzz'],
-  [' 42 ', '42', ' 17'],
-])
+expect(csvParse(text)).to.deep.equal(
+  [
+    ['aaa\n"aaa"\naaa', 'bbb', 'ccc,ccc'],
+    ['xxx,xxx', 'yyy\nyyy', 'zzz'],
+    [' 42 ', '42', ' 17'],
+  ],
+)
 ```
 
 ### fixPlTypography
@@ -922,24 +935,26 @@ const actual1 = jsOnParse(handlers, `[
   }
 ]`)
 
-expect(actual1).to.deep.equal([
-  3,
-  'Hello World!',
-  {
-    nested: 'Hello nested World!',
-    one: 1,
-    two: 2,
-  },
-  'bar',
-  {
-    $foo: [
-      'The parent object does not have ' +
-      'exactly one property!',
-    ],
-    one: 1,
-    two: 2,
-  },
-])
+expect(actual1).to.deep.equal(
+  [
+    3,
+    'Hello World!',
+    {
+      nested: 'Hello nested World!',
+      one: 1,
+      two: 2,
+    },
+    'bar',
+    {
+      $foo: [
+        'The parent object does not have ' +
+        'exactly one property!',
+      ],
+      one: 1,
+      two: 2,
+    },
+  ],
+)
 
 const actual2 = jsOnParse(
   { $notFunc: 'handler not being a function' } as any,
@@ -1000,30 +1015,32 @@ const codeJs =
   'const answerToLifeTheUniverseAndEverything = ' +
   "{ 42: 42 }['42'] /* 42 */"
 
-expect(nanolightTs(codeJs)).to.deep.equal([
-  ['span', { class: 'keyword-1' }, 'const'],
-  ' ',
-  ['span',
-    { class: 'identifier-4' },
-    'answerToLifeTheUniverseAndEverything',
+expect(nanolightTs(codeJs)).to.deep.equal(
+  [
+    ['span', { class: 'keyword-1' }, 'const'],
+    ' ',
+    ['span',
+      { class: 'identifier-4' },
+      'answerToLifeTheUniverseAndEverything',
+    ],
+    ' ',
+    ['span', { class: 'operator' }, '='],
+    ' ',
+    ['span', { class: 'punctuation' }, '{'],
+    ' ',
+    ['span', { class: 'number' }, '42'],
+    ['span', { class: 'operator' }, ':'],
+    ' ',
+    ['span', { class: 'number' }, '42'],
+    ' ',
+    ['span', { class: 'punctuation' }, '}'],
+    ['span', { class: 'punctuation' }, '['],
+    ['span', { class: 'string' }, "'42'"],
+    ['span', { class: 'punctuation' }, ']'],
+    ' ',
+    ['span', { class: 'comment' }, '/* 42 */'],
   ],
-  ' ',
-  ['span', { class: 'operator' }, '='],
-  ' ',
-  ['span', { class: 'punctuation' }, '{'],
-  ' ',
-  ['span', { class: 'number' }, '42'],
-  ['span', { class: 'operator' }, ':'],
-  ' ',
-  ['span', { class: 'number' }, '42'],
-  ' ',
-  ['span', { class: 'punctuation' }, '}'],
-  ['span', { class: 'punctuation' }, '['],
-  ['span', { class: 'string' }, "'42'"],
-  ['span', { class: 'punctuation' }, ']'],
-  ' ',
-  ['span', { class: 'comment' }, '/* 42 */'],
-])
+)
 ```
 
 ### newEscape
@@ -1066,23 +1083,27 @@ const sql = newEscape(escapeFn)
 const actual = sql`
   SELECT *
   FROM table_name
-  WHERE column_name IN (${[
-    true,
-    null,
-    undefined,
-    NaN,
-    Infinity,
-    42,
-    '42',
-    "4'2",
-    /42/,
-    new Date(323325000000),
-]})`
+  WHERE column_name IN (
+    ${[
+      true,
+      null,
+      undefined,
+      NaN,
+      Infinity,
+      42,
+      '42',
+      "4'2",
+      /42/,
+      new Date(323325000000),
+    ]}
+  )`
 
 const expected = `
   SELECT *
   FROM table_name
-  WHERE column_name IN (b'1', NULL, NULL, NULL, NULL, 42, '42', '4''2', NULL, '1980-03-31 04:30:00')`
+  WHERE column_name IN (
+    b'1', NULL, NULL, NULL, NULL, 42, '42', '4''2', NULL, '1980-03-31 04:30:00'
+  )`
 
 expect(actual).to.equal(expected)
 ```
@@ -1206,15 +1227,17 @@ const tokenizer1 = newTokenizer(
 )
 const result1 = tokenizer1('if "hello" else "world"')
 
-expect(result1).to.deep.equal([
-  { chunk: 'if', metadata: 'keyword' },
-  { chunk: ' ', metadata: undefined },
-  { chunk: '"hello"', metadata: 'string' },
-  { chunk: ' ', metadata: undefined },
-  { chunk: 'else', metadata: 'keyword' },
-  { chunk: ' ', metadata: undefined },
-  { chunk: '"world"', metadata: 'string' },
-])
+expect(result1).to.deep.equal(
+  [
+    { chunk: 'if', metadata: 'keyword' },
+    { chunk: ' ', metadata: undefined },
+    { chunk: '"hello"', metadata: 'string' },
+    { chunk: ' ', metadata: undefined },
+    { chunk: 'else', metadata: 'keyword' },
+    { chunk: ' ', metadata: undefined },
+    { chunk: '"world"', metadata: 'string' },
+  ],
+)
 
 const tokenizer2 = newTokenizer(
   (chunk, metadata) => `${metadata}:${chunk}`,
@@ -1223,13 +1246,15 @@ const tokenizer2 = newTokenizer(
 )
 const result2 = tokenizer2('aBEGINbENDc')
 
-expect(result2).to.deep.equal([
-  'undefined:a',
-  'tag:BEGIN',
-  'undefined:b',
-  'end:END',
-  'undefined:c',
-])
+expect(result2).to.deep.equal(
+  [
+    'undefined:a',
+    'tag:BEGIN',
+    'undefined:b',
+    'end:END',
+    'undefined:c',
+  ],
+)
 
 const tokenizer3 = newTokenizer(
   (chunk) => chunk,
@@ -1245,10 +1270,12 @@ const tokenizer4 = newTokenizer(
 )
 const result4 = tokenizer4('test here')
 
-expect(result4).to.deep.equal([
-  { chunk: 'test', metadata: 'start' },
-  { chunk: ' here', metadata: undefined },
-])
+expect(result4).to.deep.equal(
+  [
+    { chunk: 'test', metadata: 'start' },
+    { chunk: ' here', metadata: undefined },
+  ],
+)
 
 const tokenizer5 = newTokenizer(
   (chunk, metadata) => metadata,
@@ -1722,48 +1749,58 @@ const ref: any = {}
 
 vivify(ref).one.two[3][4]
 
-expect(ref).to.deep.equal({
-  one: {
-    two: [undefined, undefined, undefined, []],
+expect(ref).to.deep.equal(
+  {
+    one: {
+      two: [undefined, undefined, undefined, []],
+    },
   },
-})
+)
 
 vivify(ref).one.two[3][4] = 5
 
-expect(ref).to.deep.equal({
-  one: {
-    two: [
-      undefined,
-      undefined,
-      undefined,
-      [undefined, undefined, undefined, undefined, 5],
-    ],
+expect(ref).to.deep.equal(
+  {
+    one: {
+      two: [
+        undefined,
+        undefined,
+        undefined,
+        [undefined, undefined, undefined, undefined, 5],
+      ],
+    },
   },
-})
+)
 
 vivify(ref).one.two[3].length = 1
 
-expect(ref).to.deep.equal({
-  one: {
-    two: [undefined, undefined, undefined, [undefined]],
+expect(ref).to.deep.equal(
+  {
+    one: {
+      two: [undefined, undefined, undefined, [undefined]],
+    },
   },
-})
+)
 
 vivify(ref).one.two[3] = 4
 
-expect(ref).to.deep.equal({
-  one: {
-    two: [undefined, undefined, undefined, 4],
+expect(ref).to.deep.equal(
+  {
+    one: {
+      two: [undefined, undefined, undefined, 4],
+    },
   },
-})
+)
 
 expect(vivify(ref).one.two.length).to.equal(4)
 
-expect(ref).to.deep.equal({
-  one: {
-    two: [undefined, undefined, undefined, 4],
+expect(ref).to.deep.equal(
+  {
+    one: {
+      two: [undefined, undefined, undefined, 4],
+    },
   },
-})
+)
 
 vivify(ref).one.two = 3