@jackens/nnn 2024.2.20 → 2024.2.24

package/chartable.d.ts

@@ -1,33 +0,0 @@
-/**
- * A helper for creating a chart based on a table (conf. <https://jackens.github.io/nnn/chartable/>).
- *
- * Options:
- * - `table`: `HTMLTableElement` to extract data, data series labels and X axis labels
- * - `headerColumn`: flag indicating that `table` has a header column with X axis labels
- * - `xGap`: X axis spacing
- * - `xLabelsMinHeight`: minimal height of X axis labels
- * - `xLabelsRotate`: flag to rotate X axis labels
- * - `xReverse`: flag to reverse all data series
- * - `yGap`: Y axis spacing
- * - `yLabelsLeftMinWidth`: minimal width of Y axis left labels
- * - `yLabelsRightMinWidth`: minimal width of Y axis right labels
- * - `yMax`: number of Y axis lines
- * - `zLabelsMinWidth`: minimal width of data series labels
- * - `zyMappings`: mappings per data series
- */
-export function chartable({ table, headerColumn, xGap, xLabelsMinHeight, xLabelsRotate, xReverse, yGap, yLabelsLeftMinWidth, yLabelsRightMinWidth, yMax, zLabelsMinWidth, zyMappings }: {
-    table: HTMLTableElement;
-    headerColumn?: boolean | undefined;
-    xGap?: number | undefined;
-    xLabelsMinHeight?: number | undefined;
-    xLabelsRotate?: boolean | undefined;
-    xReverse?: boolean | undefined;
-    yGap?: number | undefined;
-    yLabelsLeftMinWidth?: number | undefined;
-    yLabelsRightMinWidth?: number | undefined;
-    yMax?: number | undefined;
-    zLabelsMinWidth?: number | undefined;
-    zyMappings?: [(label: string) => number, (value: number) => string][] | undefined;
-}): SVGSVGElement;
-
-export const tests: {};

package/chartable.js

@@ -1,195 +0,0 @@
-import { h, s } from './h.js'
-
-const COLORS = ['#e22', '#e73', '#fc3', '#ad4', '#4d9', '#3be', '#45d', '#c3e']
-const PADDING = 15
-
-const _svg = s('svg', { viewBox: '0 0 0 0', width: 0, height: 0 })
-
-h(document.body, ['div', { $style: { width: 0, height: 0 } }, _svg])
-
-const toFixed2 = (/** @type {number} */ value) => value.toFixed(2)
-
-/**
- * A helper for creating a chart based on a table (conf. <https://jackens.github.io/nnn/chartable/>).
- *
- * Options:
- * - `table`: `HTMLTableElement` to extract data, data series labels and X axis labels
- * - `headerColumn`: flag indicating that `table` has a header column with X axis labels
- * - `xGap`: X axis spacing
- * - `xLabelsMinHeight`: minimal height of X axis labels
- * - `xLabelsRotate`: flag to rotate X axis labels
- * - `xReverse`: flag to reverse all data series
- * - `yGap`: Y axis spacing
- * - `yLabelsLeftMinWidth`: minimal width of Y axis left labels
- * - `yLabelsRightMinWidth`: minimal width of Y axis right labels
- * - `yMax`: number of Y axis lines
- * - `zLabelsMinWidth`: minimal width of data series labels
- * - `zyMappings`: mappings per data series
- *
- * @param {{
- *   table: HTMLTableElement;
- *   headerColumn?: boolean;
- *   xGap?: number;
- *   xLabelsMinHeight?: number;
- *   xLabelsRotate?: boolean;
- *   xReverse?: boolean;
- *   yGap?: number;
- *   yLabelsLeftMinWidth?: number;
- *   yLabelsRightMinWidth?: number;
- *   yMax?: number;
- *   zLabelsMinWidth?: number;
- *   zyMappings?: [(label: string) => number, (value: number) => string][];
- * }} options
- */
-export const chartable = ({
-  table,
-  headerColumn = false,
-  xGap = 70,
-  xLabelsMinHeight = 0,
-  xLabelsRotate = false,
-  xReverse = false,
-  yGap = 30,
-  yLabelsLeftMinWidth = 100,
-  yLabelsRightMinWidth = 100,
-  yMax = 10,
-  zLabelsMinWidth = 0,
-  zyMappings = []
-}) => {
-  const /** @type {number[][]} */ zxValues = []
-  const /** @type {string[]}   */ xLabels = []
-  const /** @type {string[]}   */ zLabels = []
-
-  table.querySelectorAll('tr').forEach((row, r) =>
-    // @ts-expect-error
-    row.querySelectorAll('td,th').forEach((/** @type {HTMLTableCellElement} */ col, c) => {
-      const x = r - 1
-      const z = c - +headerColumn
-      const value = col.innerText
-
-      if (x >= 0 && z >= 0) {
-        zxValues[z] = zxValues[z] ?? []
-        zxValues[z][x] = (zyMappings?.[z]?.[0] ?? parseFloat)(value)
-      } else if (x >= 0 && z < 0) {
-        xLabels[x] = value
-      } else if (x < 0 && z >= 0) {
-        zLabels[z] = value
-      }
-    }))
-
-  if (xReverse) {
-    xLabels.reverse()
-    zxValues.forEach(xValues => xValues.reverse())
-  }
-
-  const xMax = zxValues[0].length
-  const xPx = Array.from({ length: xMax }, (_, x) => x * xGap)
-  const yPx = Array.from({ length: yMax }, (_, y) => y * yGap)
-
-  const width = xGap * (xMax - 1)
-  const height = yGap * (yMax - 1)
-
-  const gGraph = s('g',
-    ...yPx.map(px => ['line', { x1: 0, x2: width, y1: px, y2: px, stroke: '#8888' }]),
-    ...xPx.map(px => ['line', { x1: px, x2: px, y1: 0, y2: height, stroke: '#8888' }]))
-  const gXLabels = s('g')
-  const gYLabelsL = zxValues.map(_ => s('g'))
-  const gYLabelsR = zxValues.map(_ => s('g'))
-  const gZColors = s('g')
-  const /** @type {SVGTextElement[]} */ gZLabels = []
-
-  const onclick = (/** @type {number} */ z) => {
-    gYLabelsL.forEach((g, z2) => s(g, { $style: { display: z2 === z ? 'block' : 'none' } }))
-    gYLabelsR.forEach((g, z2) => s(g, { $style: { display: z2 === z ? 'block' : 'none' } }))
-    gZLabels.forEach((text, z2) => s(text, { $style: { fontWeight: z2 === z ? 'bold' : 'normal', cursor: 'pointer' } }))
-  }
-
-  zxValues.forEach((values, z) => {
-    const fill = COLORS[z % COLORS.length]
-    const minValue = Math.min(...values.filter(value => !isNaN(value)))
-    const maxValue = Math.max(...values.filter(value => !isNaN(value)))
-
-    yPx.forEach((yp, y) => {
-      const value = (zyMappings?.[z]?.[1] ?? toFixed2)(maxValue - (maxValue - minValue) / yMax * (y + 1))
-      const textL = s('text', { x: 0, y: yp, 'text-anchor': 'end', 'alignment-baseline': 'middle' }, value)
-      const textR = s('text', { x: 0, y: yp, 'text-anchor': 'start', 'alignment-baseline': 'middle' }, value)
-
-      s(_svg, textL, textR)
-
-      yLabelsLeftMinWidth = Math.max(yLabelsLeftMinWidth, textL.getBBox().width)
-      yLabelsRightMinWidth = Math.max(yLabelsRightMinWidth, textR.getBBox().width)
-
-      s(gYLabelsL[z], textL)
-      s(gYLabelsR[z], textR)
-    })
-
-    const text = s('text', {
-      x: 0,
-      y: yGap * z,
-      'text-anchor': 'start',
-      'alignment-baseline': 'middle',
-      $onclick: () => onclick(z),
-      $style: { fontWeight: 'bold' }
-    },
-    zLabels[z])
-
-    s(_svg, text)
-
-    zLabelsMinWidth = Math.max(zLabelsMinWidth, text.getBBox().width)
-
-    gZLabels[z] = text
-
-    s(gZColors, ['circle', { cx: 0, cy: yGap * z, r: 5, fill }])
-
-    const valuesPx = values.map(value => isNaN(value) ? value : height * (maxValue - value) / (maxValue - minValue))
-
-    xPx.forEach((px, x) => {
-      if (!isNaN(valuesPx[x])) {
-        s(gGraph, ['g', ['circle', { cx: px, cy: valuesPx[x], r: 5, fill }]])
-
-        if (!isNaN(valuesPx[x - 1])) {
-          s(gGraph, ['line', { x1: px, x2: xPx[x - 1], y1: valuesPx[x], y2: valuesPx[x - 1], stroke: fill }])
-        }
-      }
-    })
-  })
-
-  if (xLabels.length > 0) {
-    xPx.forEach((xp, x) => {
-      const text = s('text',
-        xLabelsRotate
-          ? { x: 0, y: -xp, 'text-anchor': 'start', 'alignment-baseline': 'middle', transform: 'rotate(90)' }
-          : { x: xp, y: PADDING, 'text-anchor': 'middle', 'alignment-baseline': 'middle' },
-        xLabels[x])
-
-      s(_svg, text)
-
-      xLabelsMinHeight = Math.max(xLabelsMinHeight, xLabelsRotate ? text.getBBox().width : text.getBBox().height)
-
-      s(gXLabels, text)
-    })
-  }
-
-  const svgW = width + yLabelsLeftMinWidth + yLabelsRightMinWidth + zLabelsMinWidth + 4 * PADDING
-  const svgH = height + xLabelsMinHeight + (xLabels.length > 0 ? 3 : 2) * PADDING
-
-  s(gGraph, { transform: `translate(${yLabelsLeftMinWidth + PADDING} ${PADDING})` })
-
-  gYLabelsL.forEach(g => s(g, { transform: `translate(${yLabelsLeftMinWidth} ${PADDING})` }))
-  gYLabelsR.forEach(g => s(g, { transform: `translate(${width + yLabelsLeftMinWidth + 2 * PADDING} ${PADDING})` }))
-
-  s(gZColors, { transform: `translate(${width + yLabelsLeftMinWidth + yLabelsRightMinWidth + 3 * PADDING} ${PADDING})` })
-  s(gXLabels, { transform: `translate(${yLabelsLeftMinWidth + PADDING} ${height + 2 * PADDING})` })
-
-  onclick(0)
-
-  return s('svg',
-    { viewBox: `0 0 ${svgW} ${svgH}`, width: `${svgW}px`, height: `${svgH}px`, class: 'chartable' },
-    gGraph,
-    gXLabels,
-    ...gYLabelsL,
-    ...gYLabelsR,
-    gZColors,
-    ['g', { transform: `translate(${width + yLabelsLeftMinWidth + yLabelsRightMinWidth + 4 * PADDING} ${PADDING})` }, ...gZLabels])
-}
-
-export const tests = {}

package/eq.d.ts

@@ -1,8 +0,0 @@
-/**
- * A helper that checks equality of the given arguments.
- */
-export function eq(x: any, y: any): boolean;
-
-export namespace tests {
-    function eq(expect: Chai.ExpectStatic): void;
-}

package/eq.js

@@ -1,83 +0,0 @@
-/**
- * A helper that checks equality of the given arguments.
- */
-export const eq = /** @return {boolean} */ (/** @type {any} */ x, /** @type {any} */ y) => {
-  if (x === y) {
-    return true
-  }
-
-  const xConstructor = x?.constructor
-
-  if (xConstructor === y?.constructor) {
-    if (xConstructor === Number) {
-      return (isNaN(x) && isNaN(y)) || +x === +y
-    }
-
-    if (xConstructor === Date) {
-      return +x === +y
-    }
-
-    if (xConstructor === String || xConstructor === RegExp) {
-      return '' + x === '' + y
-    }
-
-    if (xConstructor === Array) {
-      return x.length === y.length &&
-        x.every((/** @type {any} */ item, /** @type {number} */ index) => eq(item, y[index]))
-    }
-
-    if (xConstructor === Object) {
-      const keysOfX = Object.keys(x)
-      return keysOfX.length === Object.keys(y).length && keysOfX.every(key => eq(x[key], y[key]))
-    }
-
-    if (xConstructor === Set || xConstructor === Map) {
-      if (x.size !== y.size) {
-        return false
-      }
-      const xa = [...x]
-      const ya = [...y]
-      return xa.every(xv => ya.find(yv => eq(xv, yv)))
-    }
-  }
-
-  return false
-}
-
-export const tests = {
-  eq: (/** @type {import('chai').expect} */ expect) => {
-    expect(eq(true, true)).to.be.true
-    expect(eq(NaN, NaN)).to.be.true
-    expect(eq(null, undefined)).to.be.false
-    expect(eq(42, 42)).to.be.true
-    // eslint-disable-next-line no-new-wrappers
-    expect(eq(42, new Number(42))).to.be.true
-    expect(eq(42, Number(42))).to.be.true
-    // eslint-disable-next-line no-new-wrappers
-    expect(eq(new Number(42), Number(42))).to.be.true
-    expect(eq(42, '42')).to.be.false
-    expect(eq('42', '42')).to.be.true
-    // eslint-disable-next-line no-new-wrappers
-    expect(eq('42', new String('42'))).to.be.true
-    expect(eq('42', String('42'))).to.be.true
-    // eslint-disable-next-line no-new-wrappers
-    expect(eq(String('42'), new String('42'))).to.be.true
-    expect(eq(/42/, /42/)).to.be.true
-    expect(eq(/42/, /42/g)).to.be.false
-    expect(eq(new Date(42), new Date(42))).to.be.true
-    expect(eq(new Date(), new Date(42))).to.be.false
-    expect(eq({ j: '42', c: 42 }, { c: 42, j: '42' })).to.be.true
-    expect(eq([42, '42'], [42, '42'])).to.be.true
-    expect(eq(new Set(['42', 42]), new Set([42, '42']))).to.be.true
-    expect(eq(new Set(['42', 42]), new Set([42]))).to.be.false
-    expect(eq(new Set([42, undefined]), new Set([42]))).to.be.false
-    expect(eq(
-      new Map([[{ j: 42 }, { J: '42' }], [{ c: 42 }, { C: '42' }]]),
-      new Map([[{ c: 42 }, { C: '42' }], [{ j: 42 }, { J: '42' }]])
-    )).to.be.true
-    expect(eq(
-      new Map([[{ j: 42 }, { J: '42' }], [{ c: 42 }, { C: '42' }]]),
-      new Map([[{ j: '42' }, { J: 42 }], [{ c: '42' }, { C: 42 }]])
-    )).to.be.false
-  }
-}

package/escape.d.ts

@@ -1,18 +0,0 @@
-/**
- * The type of arguments of the `escapeValues` and `escape` helpers.
- */
-export type EscapeMap = Map<any, (value?: any) => string>;
-
-/**
- * A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
- */
-export function escape(escapeMap: EscapeMap, template: TemplateStringsArray, ...values: any[]): string;
-
-/**
- * A generic helper for escaping `values` by given `escapeMap`.
- */
-export function escapeValues(escapeMap: EscapeMap, values: any[]): string[];
-
-export namespace tests {
-    function escape(expect: Chai.ExpectStatic): void;
-}

package/escape.js

@@ -1,51 +0,0 @@
-/**
- * The type of arguments of the `escapeValues` and `escape` helpers.
- *
- * @typedef {Map<any, (value?: any) => string>} EscapeMap
- */
-
-/**
- * A generic helper for escaping `values` by given `escapeMap`.
- */
-export const escapeValues = (
-  /** @type {EscapeMap} */ escapeMap,
-  /** @type {any[]}     */ values
-) => values.map(value => (escapeMap.get(value?.constructor) ?? escapeMap.get(undefined))?.(value) ?? '')
-
-/**
- * A generic helper for escaping `values` by given `escapeMap` (in *TemplateStrings* flavor).
- */
-export const escape = (
-  /** @type {EscapeMap}            */ escapeMap,
-  /** @type {TemplateStringsArray} */ template,
-  /** @type {any[]}                */ ...values
-) => String.raw(template, ...escapeValues(escapeMap, values))
-
-export const tests = {
-  escape: (/** @type {import('chai').expect} */ expect) => {
-    // @ts-expect-error
-    const /** @type {EscapeMap} */ escapeMap = new Map([
-      [undefined, () => 'NULL'],
-      [Array, (/** @type {any[]} */ values) => escapeValues(escapeMap, values).join(', ')],
-      [Boolean, (/** @type {boolean} */ value) => `b'${+value}'`],
-      [Date, (/** @type {Date} */ value) => `'${value.toISOString().replace(/^(.+)T(.+)\..*$/, '$1 $2')}'`],
-      [Number, (/** @type {number} */ value) => `${value}`],
-      [String, (/** @type {string} */ value) => `'${value.replace(/'/g, "''")}'`]
-    ])
-
-    // @ts-expect-error
-    const sql = escape.bind(null, escapeMap)
-
-    const actual = sql`
-      SELECT *
-      FROM table_name
-      WHERE column_name IN (${[true, null, undefined, 42, '42', "4'2", /42/, new Date(323325000000)]})`
-
-    const expected = `
-      SELECT *
-      FROM table_name
-      WHERE column_name IN (b'1', NULL, NULL, 42, '42', '4''2', NULL, '1980-03-31 04:30:00')`
-
-    expect(actual).to.deep.equal(expected)
-  }
-}

package/fixTypography.d.ts

@@ -1,8 +0,0 @@
-/**
- * A helper that implements typographic corrections specific to Polish typography.
- */
-export function fixTypography(node: Node): void;
-
-export namespace tests {
-    function fixTypography(expect: Chai.ExpectStatic): void;
-}

package/fixTypography.js

@@ -1,61 +0,0 @@
-import { h } from './h.js'
-import { has } from './has.js'
-
-const TAGS_TO_SKIP = { IFRAME: 1, NOSCRIPT: 1, PRE: 1, SCRIPT: 1, STYLE: 1, TEXTAREA: 1 }
-
-/**
- * A helper that implements typographic corrections specific to Polish typography.
- */
-export const fixTypography = (/** @type {Node} */ node) => {
-  const /** @type {Node[]} */ queue = [node]
-
-  while (queue.length > 0) {
-    const node0 = queue.shift()
-
-    if (node0 instanceof Element) {
-      node0.childNodes.forEach(childNode => {
-        if (childNode instanceof Text) {
-          queue.push(childNode)
-        } else if (childNode instanceof Element && !has(childNode.tagName, TAGS_TO_SKIP)) {
-          queue.push(childNode)
-        }
-      })
-    } else if (node0 instanceof Text) {
-      const nodeValue = node0.nodeValue?.trim?.()
-
-      if (nodeValue != null) {
-        let /** @type {Node} */ previousNode = node0
-
-        nodeValue.split(/(\s|\(|„)([aiouwz—]\s)/gi).forEach((chunk, i) => {
-          i %= 3
-
-          const currentNode = i === 2
-            ? h('span', { style: 'white-space:nowrap' }, chunk)
-            : i === 1
-              ? document.createTextNode(chunk)
-              : document.createTextNode(chunk.replace(/(\/(?=[^/\s])|\.(?=[^\s]))/g, '$1\u200B'))
-
-          if (node0.parentNode != null) {
-            node0.parentNode.insertBefore(currentNode, previousNode.nextSibling)
-          }
-
-          previousNode = currentNode
-        })
-
-        node0.parentNode?.removeChild(node0)
-      }
-    }
-  }
-}
-
-export const tests = {
-  fixTypography: (/** @type {import('chai').expect} */ expect) => {
-    const p = h('p', 'Pchnąć w tę łódź jeża lub ośm skrzyń fig (zob. https://pl.wikipedia.org/wiki/Pangram).')
-
-    fixTypography(p)
-
-    expect(p.innerHTML).to.deep.equal(
-      'Pchnąć <span style="white-space:nowrap">w </span>tę łódź jeża lub ośm skrzyń fig ' +
-      '(zob. https://\u200Bpl.\u200Bwikipedia.\u200Borg/\u200Bwiki/\u200BPangram).')
-  }
-}

package/h.d.ts

@@ -1,55 +0,0 @@
-/**
- * The type of arguments of the `h` and `s` helpers.
- */
-export type HArgs = [string | Node, ...HArgs1[]];
-
-/**
- * The type of arguments of the `h` and `s` helpers.
- */
-export type HArgs1 = Partial<Record<PropertyKey, any>> | null | undefined | Node | string | number | [string | Node, ...HArgs1[]];
-
-/**
- * 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, any>>` 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.
- */
-export function h<T extends keyof HTMLElementTagNameMap>(tag: T, ...args1: HArgs1[]): HTMLElementTagNameMap[T];
-export function h<N extends Node>(node: N, ...args1: HArgs1[]): N;
-export function h(tagOrNode: string | Node, ...args1: HArgs1[]): Node;
-
-/**
- * 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, any>>` 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.
- */
-export function s<T extends keyof SVGElementTagNameMap>(tag: T, ...args1: HArgs1[]): SVGElementTagNameMap[T];
-export function s<N extends Node>(node: N, ...args1: HArgs1[]): N;
-export function s(tagOrNode: string | Node, ...args1: HArgs1[]): Node;
-
-export const tests: {
-    h: (expect: Chai.ExpectStatic) => void;
-    'h: innerText vs items': (expect: Chai.ExpectStatic) => void;
-    'h: style': (expect: Chai.ExpectStatic) => void;
-    'h: attributes vs properties': (expect: Chai.ExpectStatic) => void;
-    'h: nested properties': (expect: Chai.ExpectStatic) => void;
-};