@thi.ng/strings 3.7.2 → 3.7.4

package/escape.js

@@ -1,65 +1,42 @@
 import { U16, U32 } from "./radix.js";
-export const ESCAPES = {
-    0: "\0",
-    b: "\b",
-    t: "\t",
-    r: "\r",
-    v: "\v",
-    f: "\f",
-    n: "\n",
-    "'": "'",
-    '"': '"',
-    "\\": "\\",
+const ESCAPES = {
+  0: "\0",
+  b: "\b",
+  t: "	",
+  r: "\r",
+  v: "\v",
+  f: "\f",
+  n: "\n",
+  "'": "'",
+  '"': '"',
+  "\\": "\\"
 };
-export const ESCAPES_REV = {
-    0: "0",
-    8: "b",
-    9: "t",
-    10: "n",
-    11: "v",
-    12: "f",
-    13: "r",
-    33: "'",
-    34: '"',
-    92: "\\",
+const ESCAPES_REV = {
+  0: "0",
+  8: "b",
+  9: "t",
+  10: "n",
+  11: "v",
+  12: "f",
+  13: "r",
+  33: "'",
+  34: '"',
+  92: "\\"
+};
+const escape = (src) => src.replace(
+  /[\0\b\t\n\v\f\r'"\\]/g,
+  (x) => `\\${ESCAPES_REV[x.charCodeAt(0)]}`
+).replace(/[\ud800-\udfff]{2}/g, (x) => `\\U${U32(x.codePointAt(0))}`).replace(/[^\u0020-\u007e]/g, (x) => `\\u${U16(x.charCodeAt(0))}`);
+const unescape = (src) => src.replace(
+  /\\u([0-9a-fA-F]{4})/g,
+  (_, id) => String.fromCharCode(parseInt(id, 16))
+).replace(
+  /\\U([0-9a-fA-F]{8})/g,
+  (_, id) => String.fromCodePoint(parseInt(id, 16))
+).replace(/\\([0btnvfr'"\\])/g, (_, id) => ESCAPES[id]);
+export {
+  ESCAPES,
+  ESCAPES_REV,
+  escape,
+  unescape
 };
-/**
- * Escapes all non-ASCII characters (and well-known 0x0x control chars) using
- * backslash escape sequences.
- *
- * @remarks
- * - Well-known low-ASCII control chars will be escaped using simple `\`, e.g.
- *   0x0a => `\n`
- * - Non-BMP chars will be escaped using `\Uxxxxxxxx`
- * - Chars outside 0x20 - 0x7e range will be escaped using `\uxxxxx`
- *
- * @param src -
- */
-export const escape = (src) => src
-    .replace(/[\0\b\t\n\v\f\r'"\\]/g, (x) => `\\${ESCAPES_REV[x.charCodeAt(0)]}`)
-    .replace(/[\ud800-\udfff]{2}/g, (x) => `\\U${U32(x.codePointAt(0))}`)
-    .replace(/[^\u0020-\u007e]/g, (x) => `\\u${U16(x.charCodeAt(0))}`);
-/**
- * Replaces `\uxxxx` UTF-16 escapes, full `\Uxxxxxxxx` UTF-32 codepoint escapes
- * and other well-known backslash escape sequences (see {@link ESCAPES}) with
- * the characters they represent.
- *
- * @remarks
- * Any unknown named escape sequences (e.g. `\1`) will remain as is.
- *
- * - https://en.wikipedia.org/wiki/UTF-16#Code_points_from_U+010000_to_U+10FFFF
- * - https://www.unicode.org/charts/
- * - https://www.branah.com/unicode-converter
- *
- * @example
- * ```ts
- * unescape("\\ud83d\\ude0e \\U0001f60e")
- * // '😎'
- * ```
- *
- * @param src -
- */
-export const unescape = (src) => src
-    .replace(/\\u([0-9a-fA-F]{4})/g, (_, id) => String.fromCharCode(parseInt(id, 16)))
-    .replace(/\\U([0-9a-fA-F]{8})/g, (_, id) => String.fromCodePoint(parseInt(id, 16)))
-    .replace(/\\([0btnvfr'"\\])/g, (_, id) => ESCAPES[id]);

package/float.js

@@ -1,48 +1,29 @@
 import { memoizeJ } from "@thi.ng/memoize/memoizej";
 import { padLeft } from "./pad-left.js";
-/**
- * Returns {@link Stringer} which formats numbers to given precision. If
- * `special` is true, then exceptional handling for:
- *
- * - NaN => "NaN"
- * - Infinity => "+/-∞"
- *
- * @param len - number of fractional digits
- * @param special - true, if special handling for NaN/Infinity values
- */
-export const float = memoizeJ((prec, special = false) => special
-    ? (x) => nanOrInf(x) || x.toFixed(prec)
-    : (x) => x.toFixed(prec));
-/**
- * Similar to `float`, returns {@link Stringer} which formats numbers to given
- * character width & precision. Uses scientific notation if needed.
- *
- * Default precision: 3 fractional digits
- */
-export const floatFixedWidth = memoizeJ((width, prec = 3) => {
-    const l = width - prec - 1;
-    const pl = Math.pow(10, l);
-    const pln = -Math.pow(10, l - 1);
-    const pr = Math.pow(10, -(prec - 1));
-    const pad = padLeft(width);
-    return (x) => {
-        const ax = Math.abs(x);
-        return pad(nanOrInf(x) ||
-            (x === 0
-                ? "0"
-                : ax < pr || ax >= pl
-                    ? exp(x, width)
-                    : x.toFixed(prec - (x < pln ? 1 : 0))));
-    };
+const float = memoizeJ(
+  (prec, special = false) => special ? (x) => nanOrInf(x) || x.toFixed(prec) : (x) => x.toFixed(prec)
+);
+const floatFixedWidth = memoizeJ((width, prec = 3) => {
+  const l = width - prec - 1;
+  const pl = Math.pow(10, l);
+  const pln = -Math.pow(10, l - 1);
+  const pr = Math.pow(10, -(prec - 1));
+  const pad = padLeft(width);
+  return (x) => {
+    const ax = Math.abs(x);
+    return pad(
+      nanOrInf(x) || (x === 0 ? "0" : ax < pr || ax >= pl ? exp(x, width) : x.toFixed(prec - (x < pln ? 1 : 0)))
+    );
+  };
 });
-const exp = (x, w) => x.toExponential(Math.max(w -
-    4 -
-    (Math.log(Math.abs(x)) / Math.LN10 >= 10 ? 2 : 1) -
-    (x < 0 ? 1 : 0), 0));
-const nanOrInf = (x) => isNaN(x)
-    ? "NaN"
-    : x === Infinity
-        ? "+∞"
-        : x === -Infinity
-            ? "-∞"
-            : undefined;
+const exp = (x, w) => x.toExponential(
+  Math.max(
+    w - 4 - (Math.log(Math.abs(x)) / Math.LN10 >= 10 ? 2 : 1) - (x < 0 ? 1 : 0),
+    0
+  )
+);
+const nanOrInf = (x) => isNaN(x) ? "NaN" : x === Infinity ? "+\u221E" : x === -Infinity ? "-\u221E" : void 0;
+export {
+  float,
+  floatFixedWidth
+};

package/format.js

@@ -1,28 +1,20 @@
-export const format = (fmt, ...args) => {
-    const acc = [];
-    for (let i = 0, j = 0, n = fmt.length; i < n; i++) {
-        const f = fmt[i];
-        const t = typeof f;
-        acc.push(t === "function" ? f(args[j++]) : t === "object" ? f[args[j++]] : f);
-    }
-    return acc.join("");
+const format = (fmt, ...args) => {
+  const acc = [];
+  for (let i = 0, j = 0, n = fmt.length; i < n; i++) {
+    const f = fmt[i];
+    const t = typeof f;
+    acc.push(
+      t === "function" ? f(args[j++]) : t === "object" ? f[args[j++]] : f
+    );
+  }
+  return acc.join("");
+};
+const defFormat = (fmt) => (...args) => format(fmt, ...args);
+const ignore = (_) => "";
+const str = (x) => String(x);
+export {
+  defFormat,
+  format,
+  ignore,
+  str
 };
-/**
- * HOF version of {@link format}.
- *
- * @param fmt -
- */
-export const defFormat = (fmt) => (...args) => format(fmt, ...args);
-/**
- * Helper for {@link format} which ignores argument and always returns
- * an empty string.
- *
- * @param _ -
- */
-export const ignore = (_) => "";
-/**
- * Helper for {@link format} which coerces `x` to a string.
- *
- * @param x -
- */
-export const str = (x) => String(x);

package/groups.js

@@ -1,59 +1,48 @@
 import { charRange } from "./range.js";
 const defGroup = (...xs) => {
-    const acc = {};
-    for (let range of xs) {
-        for (let c of range) {
-            acc[c] = true;
-        }
+  const acc = {};
+  for (let range of xs) {
+    for (let c of range) {
+      acc[c] = true;
     }
-    return Object.freeze(acc);
+  }
+  return Object.freeze(acc);
 };
-/**
- * Object with whitespace characters as keys and their values set to
- * true. All others undefined.
- */
-export const WS = Object.freeze({
-    "\t": true,
-    "\n": true,
-    "\v": true,
-    "\f": true,
-    "\r": true,
-    " ": true,
+const WS = Object.freeze({
+  "	": true,
+  "\n": true,
+  "\v": true,
+  "\f": true,
+  "\r": true,
+  " ": true
 });
-/**
- * Object with 0-9 characters as keys and their values set to true. All
- * others undefined.
- */
-export const DIGITS = defGroup(charRange("0", "9"));
-/**
- * Object with hex digit characters (upper & lower case versions) as
- * keys and their values set to true. All others undefined.
- */
-export const HEX = defGroup(charRange("0", "9"), charRange("A", "F"), charRange("a", "f"));
-/**
- * Object with ASCII lowercase characters as keys and their values set
- * to true. All others undefined.
- */
-export const LOWER = defGroup(charRange("a", "z"));
-/**
- * Object with ASCII uppercase characters as keys and their values set
- * to true. All others undefined.
- */
-export const UPPER = defGroup(charRange("A", "Z"));
-/**
- * Combination of {@link UPPER} and {@link LOWER}.
- */
-export const ALPHA = Object.freeze({ ...UPPER, ...LOWER });
-/**
- * Combination of {@link ALPHA} and {@link DIGITS} and '_'.
- */
-export const ALPHA_NUM = Object.freeze({
-    ...ALPHA,
-    ...DIGITS,
-    _: true,
+const DIGITS = defGroup(charRange("0", "9"));
+const HEX = defGroup(
+  charRange("0", "9"),
+  charRange("A", "F"),
+  charRange("a", "f")
+);
+const LOWER = defGroup(charRange("a", "z"));
+const UPPER = defGroup(charRange("A", "Z"));
+const ALPHA = Object.freeze({ ...UPPER, ...LOWER });
+const ALPHA_NUM = Object.freeze({
+  ...ALPHA,
+  ...DIGITS,
+  _: true
 });
-/**
- * Object with ASCII punctuation characters as keys and their values set
- * to true. All others undefined.
- */
-export const PUNCTUATION = defGroup(charRange("!", "/"), charRange(":", "@"), charRange("[", "`"), charRange("{", "~"));
+const PUNCTUATION = defGroup(
+  charRange("!", "/"),
+  charRange(":", "@"),
+  charRange("[", "`"),
+  charRange("{", "~")
+);
+export {
+  ALPHA,
+  ALPHA_NUM,
+  DIGITS,
+  HEX,
+  LOWER,
+  PUNCTUATION,
+  UPPER,
+  WS
+};

package/hollerith.js

@@ -1,16 +1,4 @@
-/**
- * Formats given value `x` as Fortran style Hollerith string.
- *
- * @example
- * ```ts
- * hstr("abc")  // "3Habc"
- * hstr(123.45) // "6H123.45"
- * hstr("")     // "0H"
- * hstr(null)   // ""
- * ```
- *
- * https://en.wikipedia.org/wiki/Hollerith_constant
- *
- * @param x -
- */
-export const hstr = (x) => x != null ? ((x = x.toString()), `${x.length}H${x}`) : "";
+const hstr = (x) => x != null ? (x = x.toString(), `${x.length}H${x}`) : "";
+export {
+  hstr
+};

package/initials.js

@@ -1,28 +1,7 @@
-/**
- * Takes an array of string parts and returns a new string of each part's
- * initial character. The `mode` arg can be used to customize result casing
- * (default: uppercase). If `mode` is null, the original casing will be kept.
- *
- * @example
- * ```ts
- * initials(["alicia", "bella", "carerra"]);
- * // "ABC"
- *
- * initials("shader-ast-GLSL".split("-"))
- * // "SAG"
- *
- * initials("Ludwig van Beethoven".split(" "), null)
- * // "LvB"
- * ```
- *
- * @param parts -
- * @param mode -
- */
-export const initials = (parts, mode = "u") => {
-    const res = parts.map((x) => x[0]).join("");
-    return mode === "u"
-        ? res.toUpperCase()
-        : mode === "l"
-            ? res.toLowerCase()
-            : res;
+const initials = (parts, mode = "u") => {
+  const res = parts.map((x) => x[0]).join("");
+  return mode === "u" ? res.toUpperCase() : mode === "l" ? res.toLowerCase() : res;
+};
+export {
+  initials
 };

package/int.js

@@ -1,3 +1,9 @@
 import { memoizeJ } from "@thi.ng/memoize/memoizej";
-export const int = (x) => String(Math.trunc(x));
-export const intLocale = memoizeJ((locale) => (x) => Math.trunc(x).toLocaleString(locale));
+const int = (x) => String(Math.trunc(x));
+const intLocale = memoizeJ(
+  (locale) => (x) => Math.trunc(x).toLocaleString(locale)
+);
+export {
+  int,
+  intLocale
+};

package/interpolate.js

@@ -1,39 +1,12 @@
 import { illegalArgs } from "@thi.ng/errors/illegal-arguments";
 const TPL = /\{(\d+)\}/g;
 const TPL_K = /\{([a-z0-9_.-]+)\}/gi;
-/**
- * Takes a string template with embedded `{number}` style terms and any
- * number of args. Replaces numbered terms with their respective args
- * given.
- *
- * @example
- * ```ts
- * interpolate("let {0}: {2} = {1};", "a", 42, "number")
- * // "let a: number = 42;"
- * ```
- *
- * @param src -
- * @param args -
- */
-export const interpolate = (src, ...args) => args.length > 0
-    ? src.replace(TPL, (_, id) => String(args[parseInt(id, 10)]))
-    : src;
-/**
- * Similar to {@link interpolate}, but uses alphanumeric placeholders in the
- * template string and an object of values for the stated keys.
- *
- * @example
- * ```ts
- * interpolateKeys(
- *   "let {id}: {type} = {val};",
- *   { id: "a", type: "number", val: 42 }
- * )
- * // "let a: number = 42;"
- * ```
- *
- * @param src -
- * @param keys -
- */
-export const interpolateKeys = (src, keys) => src.replace(TPL_K, (_, id) => keys[id] != undefined
-    ? String(keys[id])
-    : illegalArgs(`missing key: ${id}`));
+const interpolate = (src, ...args) => args.length > 0 ? src.replace(TPL, (_, id) => String(args[parseInt(id, 10)])) : src;
+const interpolateKeys = (src, keys) => src.replace(
+  TPL_K,
+  (_, id) => keys[id] != void 0 ? String(keys[id]) : illegalArgs(`missing key: ${id}`)
+);
+export {
+  interpolate,
+  interpolateKeys
+};

package/join.js

@@ -1,22 +1,7 @@
 import { memoize1 } from "@thi.ng/memoize/memoize1";
-/**
- * Higher-order version of `Array.join()`. Takes separator string `sep`
- * and returns function which accepts an array and joins all elements w/
- * separator into a result string.
- *
- * @example
- * ```ts
- * const slashes = join("/");
- *
- * slashes([1, 2, 3]);
- * // "1/2/3"
- *
- * const formatOBJFace = partial(
- *   format, ["f ", slashes, " ", slashes, " ", slashes]
- * );
- *
- * formatOBJFace([1, 2], [3, 4], [5, 6]);
- * // "f 1/2 3/4 5/6"
- * ```
- */
-export const join = memoize1((sep) => (x) => x.join(sep));
+const join = memoize1(
+  (sep) => (x) => x.join(sep)
+);
+export {
+  join
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/strings",
-  "version": "3.7.2",
+  "version": "3.7.4",
   "description": "Various string formatting & utility functions",
   "type": "module",
   "module": "./index.js",
@@ -24,7 +24,9 @@
   "author": "Karsten Schmidt (https://thi.ng)",
   "license": "Apache-2.0",
   "scripts": {
-    "build": "yarn clean && tsc --declaration",
+    "build": "yarn build:esbuild && yarn build:decl",
+    "build:decl": "tsc --declaration --emitDeclarationOnly",
+    "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "rimraf --glob '*.js' '*.d.ts' '*.map' doc",
     "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
@@ -33,13 +35,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.11",
-    "@thi.ng/errors": "^2.4.5",
-    "@thi.ng/hex": "^2.3.23",
-    "@thi.ng/memoize": "^3.1.45"
+    "@thi.ng/api": "^8.9.13",
+    "@thi.ng/errors": "^2.4.7",
+    "@thi.ng/hex": "^2.3.25",
+    "@thi.ng/memoize": "^3.1.47"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.38.3",
+    "esbuild": "^0.19.8",
     "rimraf": "^5.0.5",
     "tools": "^0.0.1",
     "typedoc": "^0.25.4",
@@ -73,7 +76,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=12.7"
+    "node": ">=18"
   },
   "files": [
     "./*.js",
@@ -201,5 +204,5 @@
   "thi.ng": {
     "year": 2015
   },
-  "gitHead": "25f2ac8ff795a432a930119661b364d4d93b59a0\n"
+  "gitHead": "25a42a81fac8603a1e440a7aa8bc343276211ff4\n"
 }

package/pad-left.js

@@ -1,28 +1,21 @@
 import { memoizeJ } from "@thi.ng/memoize/memoizej";
 import { repeat } from "./repeat.js";
-/**
- * @param n - target length
- * @param ch - pad character(s)
- */
-export const padLeft = memoizeJ((n, ch = " ") => {
-    const buf = repeat(String(ch), n);
-    return (x, len) => {
-        if (x == null)
-            return buf;
-        x = x.toString();
-        len = len !== undefined ? len : x.length;
-        return len < n ? buf.substring(len) + x : x;
-    };
+const padLeft = memoizeJ((n, ch = " ") => {
+  const buf = repeat(String(ch), n);
+  return (x, len) => {
+    if (x == null)
+      return buf;
+    x = x.toString();
+    len = len !== void 0 ? len : x.length;
+    return len < n ? buf.substring(len) + x : x;
+  };
 });
-/**
- * Zero-padded 2 digit formatter.
- */
-export const Z2 = padLeft(2, "0");
-/**
- * Zero-padded 3 digit formatter.
- */
-export const Z3 = padLeft(3, "0");
-/**
- * Zero-padded 4 digit formatter.
- */
-export const Z4 = padLeft(4, "0");
+const Z2 = padLeft(2, "0");
+const Z3 = padLeft(3, "0");
+const Z4 = padLeft(4, "0");
+export {
+  Z2,
+  Z3,
+  Z4,
+  padLeft
+};

package/pad-right.js

@@ -1,16 +1,15 @@
 import { memoizeJ } from "@thi.ng/memoize/memoizej";
 import { repeat } from "./repeat.js";
-/**
- * @param n - target length
- * @param ch - pad character(s)
- */
-export const padRight = memoizeJ((n, ch = " ") => {
-    const buf = repeat(String(ch), n);
-    return (x, len) => {
-        if (x == null)
-            return buf;
-        x = x.toString();
-        len = len !== undefined ? len : x.length;
-        return len < n ? x + buf.substring(len) : x;
-    };
+const padRight = memoizeJ((n, ch = " ") => {
+  const buf = repeat(String(ch), n);
+  return (x, len) => {
+    if (x == null)
+      return buf;
+    x = x.toString();
+    len = len !== void 0 ? len : x.length;
+    return len < n ? x + buf.substring(len) : x;
+  };
 });
+export {
+  padRight
+};

package/parse.js

@@ -1,8 +1,12 @@
-export const maybeParseInt = (x, defaultVal = 0, radix = 10) => {
-    const n = parseInt(x, radix);
-    return isNaN(n) ? defaultVal : n;
+const maybeParseInt = (x, defaultVal = 0, radix = 10) => {
+  const n = parseInt(x, radix);
+  return isNaN(n) ? defaultVal : n;
 };
-export const maybeParseFloat = (x, defaultVal = 0) => {
-    const n = parseFloat(x);
-    return isNaN(n) ? defaultVal : n;
+const maybeParseFloat = (x, defaultVal = 0) => {
+  const n = parseFloat(x);
+  return isNaN(n) ? defaultVal : n;
+};
+export {
+  maybeParseFloat,
+  maybeParseInt
 };

package/percent.js

@@ -1,7 +1,4 @@
-/**
- * Returns {@link Stringer} which formats given fractions as percentage (e.g.
- * `0.1234 => 12.34%`).
- *
- * @param prec - number of fractional digits (default: 0)
- */
-export const percent = (prec = 0) => (x) => (x * 100).toFixed(prec) + "%";
+const percent = (prec = 0) => (x) => (x * 100).toFixed(prec) + "%";
+export {
+  percent
+};