@jackens/nnn 2024.2.19 → 2024.2.24

package/jsOnParse.js

@@ -1,85 +0,0 @@
-import { has } from './has.js'
-import { is } from './is.js'
-
-/**
- * `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 const jsOnParse = (
-  /** @type {Partial<Record<PropertyKey, 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])) {
-      // @ts-expect-error
-      return handlers[key](...value[key])
-    }
-  }
-
-  return value
-})
-
-export const tests = {
-  jsOnParse: (/** @type {import('chai').expect} */ expect) => {
-    const handlers = {
-      $hello: (/** @type {string} */ name) => `Hello ${name}!`,
-      $foo: () => 'bar'
-    }
-    const actual = jsOnParse(handlers, `[
-      {
-        "$hello": ["World"]
-      },
-      {
-        "nested": {
-          "$hello": ["nested World"]
-        },
-        "one": 1,
-        "two": 2
-      },
-      {
-        "$foo": []
-      },
-      {
-        "$foo": ["The parent object does not have exactly one property!"],
-        "one": 1,
-        "two": 2
-      }
-    ]`)
-    const expected = [
-      '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(actual).to.deep.equal(expected)
-  }
-}

package/locale.d.ts

@@ -1,8 +0,0 @@
-/**
- * Language translations helper.
- */
-export function locale(map: Partial<Record<PropertyKey, Partial<Record<PropertyKey, string>>>>, defaultVersion: string): (text: string, version?: string) => string;
-
-export namespace tests {
-    function locale(expect: Chai.ExpectStatic): void;
-}

package/locale.js

@@ -1,39 +0,0 @@
-import { is } from './is.js'
-
-/**
- * Language translations helper.
- */
-export const locale = (
-  /** @type {Partial<Record<PropertyKey, Partial<Record<PropertyKey, string>>>>} */ map,
-  /** @type {string} */ defaultVersion
-) => (
-  /** @type {string} */ text,
-  /** @type {string} */ version = defaultVersion
-) => {
-  const textV = map?.[version]?.[text]
-  const textD = map?.[defaultVersion]?.[text]
-
-  return is(String, textV) ? textV : is(String, textD) ? textD : text
-}
-
-export const tests = {
-  locale: (/** @type {import('chai').expect} */ expect) => {
-    const _ = locale({
-      default: { Password: 'Hasło' },
-      button: { Login: 'Zaloguj' }
-    }, 'default')
-
-    expect(_('Login')).to.deep.equal('Login')
-    expect(_('Password')).to.deep.equal('Hasło')
-
-    expect(_('Undefined text')).to.deep.equal('Undefined text')
-
-    expect(_('Login', 'button')).to.deep.equal('Zaloguj')
-
-    expect(_('Password', 'undefined_version')).to.deep.equal('Hasło')
-    expect(_('Undefined text', 'undefined_version')).to.deep.equal('Undefined text')
-
-    expect(_('toString')).to.deep.equal('toString')
-    expect(_('toString', 'undefined_version')).to.deep.equal('toString')
-  }
-}

package/nanolight.d.ts

@@ -1,6 +0,0 @@
-/**
- * A generic helper for syntax highlighting (see also `nanolightJs`).
- */
-export function nanolight(pattern: RegExp, highlighters: ((chunk: string, index: number) => import('./h.js').HArgs1)[], code: string): import("./h.js").HArgs1[];
-
-export const tests: {};

package/nanolight.js

@@ -1,21 +0,0 @@
-/**
- * A generic helper for syntax highlighting (see also `nanolightJs`).
- */
-export const nanolight = (
-  /** @type {RegExp} */ pattern,
-  /** @type {((chunk: string, index: number) => import('./h.js').HArgs1)[]} */ highlighters,
-  /** @type {string} */ code
-) => {
-  const /** @type {import('./h.js').HArgs1[]} */ result = []
-
-  code.split(pattern).forEach((chunk, index) => {
-    if (chunk != null && chunk !== '') {
-      index %= highlighters.length
-      result.push(highlighters[index](chunk, index))
-    }
-  })
-
-  return result
-}
-
-export const tests = {}

package/nanolightJs.d.ts

@@ -1,8 +0,0 @@
-/**
- * A helper for highlighting JavaScript.
- */
-export const nanolightJs: (code?: string | undefined) => import("./h.js").HArgs1[];
-
-export namespace tests {
-    function nanolightJs(expect: Chai.ExpectStatic): void;
-}

package/nanolightJs.js

@@ -1,29 +0,0 @@
-import { h } from './h.js'
-import { nanolight } from './nanolight.js'
-
-/**
- * A helper for highlighting JavaScript.
- */
-// @ts-expect-error
-export const 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ąćęłńóśżźĄĆĘŁŃÓŚŻŹ]+)/,
-  [
-    chunk => chunk,
-    chunk => ['span', { class: 'string' }, chunk],
-    chunk => ['span', { class: 'comment' }, chunk],
-    chunk => ['span', { class: 'keyword' }, chunk],
-    chunk => ['span', { class: 'operator' }, chunk],
-    chunk => ['span', { class: 'number' }, chunk],
-    chunk => ['span', { class: 'function' }, chunk],
-    chunk => ['span', { class: 'literal' }, chunk]
-  ]
-)
-
-export const tests = {
-  nanolightJs: (/** @type {import('chai').expect} */ expect) => {
-    const codeJs = 'const answerToLifeTheUniverseAndEverything = 42'
-
-    expect(h('pre', ['code', ...nanolightJs(codeJs)]).outerHTML).to.deep.equal(
-      '<pre><code><span class="keyword">const</span> <span class="literal">answerToLifeTheUniverseAndEverything</span> <span class="operator">=</span> <span class="number">42</span></code></pre>')
-  }
-}

package/pick.d.ts

@@ -1,14 +0,0 @@
-/**
- * A helper that implements TypeScript’s `Omit` utility type.
- */
-export const omit: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: T, keys: K) => Omit<T, K[number]>;
-
-/**
- * A helper that implements TypeScript’s `Pick` utility type.
- */
-export const pick: <T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: T, keys: K) => Pick<T, K[number]>;
-
-export namespace tests {
-    function pick(expect: Chai.ExpectStatic): void;
-    function omit(expect: Chai.ExpectStatic): void;
-}

package/pick.js

@@ -1,31 +0,0 @@
-/**
- * A helper that implements TypeScript’s `Pick` utility type.
- *
- * @type {<T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: T, keys: K) => Pick<T, K[number]>}
- */
-export const pick = (/** @type {Partial<Record<PropertyKey, any>>} */ obj, /** @type {any[]} */ keys) =>
-  // @ts-expect-error
-  Object.fromEntries(Object.entries(obj).filter(([key]) => keys.includes(key)))
-
-/**
- * A helper that implements TypeScript’s `Omit` utility type.
- *
- * @type {<T extends Partial<Record<PropertyKey, any>>, K extends (keyof T)[]>(obj: T, keys: K) => Omit<T, K[number]>}
- */
-export const omit = (/** @type {Partial<Record<PropertyKey, any>>} */ obj, /** @type {any[]} */ keys) =>
-  // @ts-expect-error
-  Object.fromEntries(Object.entries(obj).filter(([key]) => !keys.includes(key)))
-
-export const tests = {
-  pick: (/** @type {import('chai').expect} */ expect) => {
-    const obj = { a: 42, b: '42', c: 17 }
-
-    expect(pick(obj, ['a', 'b'])).to.deep.equal({ a: 42, b: '42' })
-  },
-
-  omit: (/** @type {import('chai').expect} */ expect) => {
-    const obj = { a: 42, b: '42', c: 17 }
-
-    expect(omit(obj, ['c'])).to.deep.equal({ a: 42, b: '42' })
-  }
-}

package/plUral.d.ts

@@ -1,8 +0,0 @@
-/**
- * A helper for choosing the correct singular and plural.
- */
-export function plUral(singular: string, plural2: string, plural5: string, value: number): string;
-
-export namespace tests {
-    function plUral(expect: Chai.ExpectStatic): void;
-}

package/plUral.js

@@ -1,39 +0,0 @@
-/**
- * A helper for choosing the correct singular and plural.
- */
-export const plUral = (
-  /** @type {string} */ singular,
-  /** @type {string} */ plural2,
-  /** @type {string} */ plural5,
-  /** @type {number} */ value
-) => {
-  const absValue = Math.abs(value)
-  const absValueMod10 = absValue % 10
-
-  return value === 1
-    ? singular
-    : (absValueMod10 === 2 || absValueMod10 === 3 || absValueMod10 === 4) &&
-      absValue !== 12 && absValue !== 13 && absValue !== 14
-        ? plural2
-        : plural5
-}
-
-export const tests = {
-  plUral: (/** @type {import('chai').expect} */ expect) => {
-    // @ts-expect-error
-    const auto = plUral.bind(null, 'auto', 'auta', 'aut')
-
-    expect(auto(0)).to.deep.equal('aut')
-    expect(auto(1)).to.deep.equal('auto')
-    expect(auto(17)).to.deep.equal('aut')
-    expect(auto(42)).to.deep.equal('auta')
-
-    // @ts-expect-error
-    const car = plUral.bind(null, 'car', 'cars', 'cars')
-
-    expect(car(0)).to.deep.equal('cars')
-    expect(car(1)).to.deep.equal('car')
-    expect(car(17)).to.deep.equal('cars')
-    expect(car(42)).to.deep.equal('cars')
-  }
-}

package/pro.d.ts

@@ -1,8 +0,0 @@
-/**
- * A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
- */
-export function pro(ref: any): any;
-
-export namespace tests {
-    function pro(expect: Chai.ExpectStatic): void;
-}

package/pro.js

@@ -1,39 +0,0 @@
-/**
- * A helper that protects calls to nested properties by a `Proxy` that initializes non-existent values with an empty object.
- */
-// @ts-expect-error
-export const pro = (/** @type {any} */ ref) => new Proxy(ref, {
-  get (target, key) {
-    return pro(target[key] = target[key] ?? {})
-  }
-})
-
-export const tests = {
-  pro: (/** @type {import('chai').expect} */ expect) => {
-    const ref = {}
-
-    pro(ref).one.two[3][4] = 1234
-
-    expect(ref).to.deep.equal({ one: { two: { 3: { 4: 1234 } } } })
-
-    pro(ref).one.two.tree = 123
-
-    expect(ref).to.deep.equal({ one: { two: { 3: { 4: 1234 }, tree: 123 } } })
-
-    pro(ref).one.two = undefined
-
-    expect(ref).to.deep.equal({ one: { two: undefined } })
-
-    delete pro(ref).one.two
-
-    expect(ref).to.deep.equal({ one: {} })
-
-    pro(ref).one.two.three.four
-
-    expect(ref).to.deep.equal({ one: { two: { three: { four: {} } } } })
-
-    pro(ref).one.two.three.four = 1234
-
-    expect(ref).to.deep.equal({ one: { two: { three: { four: 1234 } } } })
-  }
-}

package/refsInfo.d.ts

@@ -1,11 +0,0 @@
-/**
- * A helper that provides information about the given `refs`.
- *
- * It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
- */
-export function refsInfo(...refs: any[]): [string, string, string[]][];
-
-export const tests: {
-    refsInfo: (expect: Chai.ExpectStatic) => void;
-    'refsInfo: browserFingerprint': (expect: Chai.ExpectStatic) => void;
-};

package/refsInfo.js

@@ -1,57 +0,0 @@
-import { is } from './is.js'
-
-/**
- * A helper that provides information about the given `refs`.
- *
- * It returns an array of triples: `[«name», «prototype-name», «array-of-own-property-names»]`.
- */
-export const refsInfo = (/** @type {any[]} */ ...refs) => {
-  const /** @type {Set<Function>} */ fns = new Set()
-
-  refs.forEach(ref => {
-    while (is(Function, ref) && !fns.has(ref) && `${ref}`.includes('[native code]')) {
-      fns.add(ref)
-      ref = Object.getPrototypeOf(ref)
-    }
-  })
-
-  return Array.from(fns.values()).map(/** @return {[string, string, string[]]} */ fn => [
-    fn.name,
-    Object.getPrototypeOf(fn)?.name ?? '',
-    Object.getOwnPropertyNames(fn.prototype ?? Object.create(null)).sort()
-  ]).sort((a, b) => -(a[0] < b[0]))
-}
-
-export const tests = {
-  refsInfo: (/** @type {import('chai').expect} */ expect) => {
-    const info = refsInfo(Array, Function)
-
-    expect(info.find(([name]) => name === 'Array')?.[2]?.includes('length')).to.be.true
-    expect(info.find(([name]) => name === 'Function')?.[2]?.includes('length')).to.be.true
-  },
-
-  'refsInfo: browserFingerprint': (/** @type {import('chai').expect} */ expect) => {
-    const browserFingerprint = () => {
-      // @ts-expect-error
-      const refs = Object.getOwnPropertyNames(window).map(name => window[name])
-      const info = refsInfo(...refs)
-      const json = JSON.stringify(info)
-      const hash = Array(32).fill(0)
-      let j = 0
-
-      for (let i = 0; i < json.length; i++) {
-        let charCode = json.charCodeAt(i)
-
-        while (charCode > 0) {
-          hash[j] = hash[j] ^ (charCode & 15)
-          charCode >>= 4
-          j = (j + 1) & 31
-        }
-      }
-
-      return hash.map(x => x.toString(16)).join('')
-    }
-
-    console.log(browserFingerprint())
-  }
-}

package/uuid1.d.ts

@@ -1,16 +0,0 @@
-export const tests: {
-    uuid1: (expect: Chai.ExpectStatic) => void;
-    'uuid1: node': (expect: Chai.ExpectStatic) => void;
-    'uuid1: date': (expect: Chai.ExpectStatic) => void;
-};
-
-/**
- * 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.
- */
-export function uuid1({ date, node }?: {
-    date?: Date | undefined;
-    node?: string | undefined;
-}): string;

package/uuid1.js

@@ -1,54 +0,0 @@
-const ZEROS = '0'.repeat(16)
-let counter = 0
-
-/**
- * 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.
- */
-export const uuid1 = ({
-  date = new Date(),
-  node = Math.random().toString(16).slice(2)
-} = {}) => {
-  const time = ZEROS + (10000 * (+date + 12219292800000)).toString(16)
-
-  counter = (counter + 1) & 16383
-
-  return time.slice(-8).concat(
-    '-',
-    time.slice(-12, -8),
-    // @ts-expect-error
-    -1,
-    time.slice(-15, -12),
-    '-',
-    (8 | (counter >> 12)).toString(16),
-    (ZEROS + (counter & 4095).toString(16)).slice(-3),
-    '-',
-    (ZEROS + node).slice(-12))
-}
-
-export const tests = {
-  uuid1: (/** @type {import('chai').expect} */ expect) => {
-    for (let i = 1; i <= 22136; ++i) {
-      const uuid = uuid1()
-
-      i === 1 && expect(uuid.split('-')[3]).to.deep.equal('8001')
-      i === 4095 && expect(uuid.split('-')[3]).to.deep.equal('8fff')
-      i === 4096 && expect(uuid.split('-')[3]).to.deep.equal('9000')
-      i === 9029 && expect(uuid.split('-')[3]).to.deep.equal('a345')
-      i === 13398 && expect(uuid.split('-')[3]).to.deep.equal('b456')
-      i === 16384 && expect(uuid.split('-')[3]).to.deep.equal('8000')
-      i === 17767 && expect(uuid.split('-')[3]).to.deep.equal('8567')
-    }
-  },
-
-  'uuid1: node': (/** @type {import('chai').expect} */ expect) => {
-    expect(uuid1({ node: '000123456789abc' }).split('-')[4]).to.deep.equal('123456789abc')
-    expect(uuid1({ node: '123456789' }).split('-')[4]).to.deep.equal('000123456789')
-  },
-
-  'uuid1: date': (/** @type {import('chai').expect} */ expect) => {
-    expect(uuid1({ date: new Date(323325000000) }).startsWith('c1399400-9a71-11bd')).to.be.true
-  }
-}