@thi.ng/strings 2.1.7 → 3.1.0

package/index.d.ts

@@ -1,35 +1,37 @@
-export * from "./api";
-export * from "./ansi";
-export * from "./case";
-export * from "./center";
-export * from "./cursor";
-export * from "./escape";
-export * from "./float";
-export * from "./format";
-export * from "./groups";
-export * from "./hollerith";
-export * from "./int";
-export * from "./interpolate";
-export * from "./join";
-export * from "./pad-left";
-export * from "./pad-right";
-export * from "./parse";
-export * from "./percent";
-export * from "./radix";
-export * from "./range";
-export * from "./repeat";
-export * from "./ruler";
-export * from "./slugify";
-export * from "./splice";
-export * from "./split";
-export * from "./stringify";
-export * from "./tabs";
-export * from "./trim";
-export * from "./truncate";
-export * from "./truncate-left";
-export * from "./units";
-export * from "./uuid";
-export * from "./vector";
-export * from "./wrap";
-export * from "./word-wrap";
+export * from "./api.js";
+export * from "./ansi.js";
+export * from "./case.js";
+export * from "./center.js";
+export * from "./cursor.js";
+export * from "./entities.js";
+export * from "./escape.js";
+export * from "./float.js";
+export * from "./format.js";
+export * from "./groups.js";
+export * from "./hollerith.js";
+export * from "./initials.js";
+export * from "./int.js";
+export * from "./interpolate.js";
+export * from "./join.js";
+export * from "./pad-left.js";
+export * from "./pad-right.js";
+export * from "./parse.js";
+export * from "./percent.js";
+export * from "./radix.js";
+export * from "./range.js";
+export * from "./repeat.js";
+export * from "./ruler.js";
+export * from "./slugify.js";
+export * from "./splice.js";
+export * from "./split.js";
+export * from "./stringify.js";
+export * from "./tabs.js";
+export * from "./trim.js";
+export * from "./truncate.js";
+export * from "./truncate-left.js";
+export * from "./units.js";
+export * from "./uuid.js";
+export * from "./vector.js";
+export * from "./wrap.js";
+export * from "./word-wrap.js";
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,34 +1,36 @@
-export * from "./api";
-export * from "./ansi";
-export * from "./case";
-export * from "./center";
-export * from "./cursor";
-export * from "./escape";
-export * from "./float";
-export * from "./format";
-export * from "./groups";
-export * from "./hollerith";
-export * from "./int";
-export * from "./interpolate";
-export * from "./join";
-export * from "./pad-left";
-export * from "./pad-right";
-export * from "./parse";
-export * from "./percent";
-export * from "./radix";
-export * from "./range";
-export * from "./repeat";
-export * from "./ruler";
-export * from "./slugify";
-export * from "./splice";
-export * from "./split";
-export * from "./stringify";
-export * from "./tabs";
-export * from "./trim";
-export * from "./truncate";
-export * from "./truncate-left";
-export * from "./units";
-export * from "./uuid";
-export * from "./vector";
-export * from "./wrap";
-export * from "./word-wrap";
+export * from "./api.js";
+export * from "./ansi.js";
+export * from "./case.js";
+export * from "./center.js";
+export * from "./cursor.js";
+export * from "./entities.js";
+export * from "./escape.js";
+export * from "./float.js";
+export * from "./format.js";
+export * from "./groups.js";
+export * from "./hollerith.js";
+export * from "./initials.js";
+export * from "./int.js";
+export * from "./interpolate.js";
+export * from "./join.js";
+export * from "./pad-left.js";
+export * from "./pad-right.js";
+export * from "./parse.js";
+export * from "./percent.js";
+export * from "./radix.js";
+export * from "./range.js";
+export * from "./repeat.js";
+export * from "./ruler.js";
+export * from "./slugify.js";
+export * from "./splice.js";
+export * from "./split.js";
+export * from "./stringify.js";
+export * from "./tabs.js";
+export * from "./trim.js";
+export * from "./truncate.js";
+export * from "./truncate-left.js";
+export * from "./units.js";
+export * from "./uuid.js";
+export * from "./vector.js";
+export * from "./wrap.js";
+export * from "./word-wrap.js";

package/initials.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 declare const initials: (parts: string[], mode?: "u" | "l" | null) => string;
+//# sourceMappingURL=initials.d.ts.map

package/initials.js

@@ -0,0 +1,28 @@
+/**
+ * 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;
+};

package/int.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 export declare const int: Stringer<number>;
 export declare const intLocale: (locale?: string) => Stringer<number>;
 //# sourceMappingURL=int.d.ts.map

package/int.js

@@ -1,3 +1,3 @@
-import { memoizeJ } from "@thi.ng/memoize";
+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));

package/interpolate.js

@@ -1,4 +1,4 @@
-import { illegalArgs } from "@thi.ng/errors";
+import { illegalArgs } from "@thi.ng/errors/illegal-arguments";
 const TPL = /\{(\d+)\}/g;
 const TPL_K = /\{([a-z0-9_.-]+)\}/gi;
 /**

package/join.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Higher-order version of `Array.join()`. Takes separator string `sep`
  * and returns function which accepts an array and joins all elements w/

package/join.js

@@ -1,4 +1,4 @@
-import { memoize1 } from "@thi.ng/memoize";
+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/

package/package.json

@@ -1,11 +1,11 @@
 {
     "name": "@thi.ng/strings",
-    "version": "2.1.7",
+    "version": "3.1.0",
     "description": "Various string formatting & utility functions",
+    "type": "module",
     "module": "./index.js",
-    "main": "./lib/index.js",
-    "umd:main": "./lib/index.umd.js",
     "typings": "./index.d.ts",
+    "sideEffects": false,
     "repository": {
         "type": "git",
         "url": "https://github.com/thi-ng/umbrella.git"
@@ -24,30 +24,24 @@
     "author": "Karsten Schmidt <k+npm@thi.ng>",
     "license": "Apache-2.0",
     "scripts": {
-        "build": "yarn clean && yarn build:es6 && node ../../scripts/bundle-module",
-        "build:release": "yarn clean && yarn build:es6 && node ../../scripts/bundle-module all",
-        "build:es6": "tsc --declaration",
-        "build:test": "rimraf build && tsc -p test/tsconfig.json",
-        "build:check": "tsc --isolatedModules --noEmit",
-        "test": "mocha test",
-        "cover": "nyc mocha test && nyc report --reporter=lcov",
-        "clean": "rimraf *.js *.d.ts *.map .nyc_output build coverage doc lib",
-        "doc:readme": "ts-node -P ../../tools/tsconfig.json ../../tools/src/readme.ts",
-        "doc": "typedoc --excludePrivate --out doc --theme ../../tools/doc/typedoc-theme src/index.ts",
+        "build": "yarn clean && tsc --declaration",
+        "clean": "rimraf *.js *.d.ts *.map doc",
+        "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
         "doc:ae": "mkdir -p .ae/doc .ae/temp && node_modules/.bin/api-extractor run --local --verbose",
-        "pub": "yarn build:release && yarn publish --access public"
+        "doc:readme": "yarn doc:stats && ../../scripts/node-esm ../../tools/src/readme.ts",
+        "doc:stats": "../../scripts/node-esm ../../tools/src/module-stats.ts",
+        "pub": "yarn build && yarn publish --access public",
+        "test": "testament test"
     },
     "dependencies": {
-        "@thi.ng/api": "^7.2.0",
-        "@thi.ng/errors": "^1.3.4",
-        "@thi.ng/hex": "^1.0.4",
-        "@thi.ng/memoize": "^2.1.21"
+        "@thi.ng/api": "^8.0.4",
+        "@thi.ng/errors": "^2.0.4",
+        "@thi.ng/hex": "^2.0.4",
+        "@thi.ng/memoize": "^3.0.4"
+    },
+    "devDependencies": {
+        "@thi.ng/testament": "^0.1.4"
     },
-    "files": [
-        "*.js",
-        "*.d.ts",
-        "lib"
-    ],
     "keywords": [
         "ansi",
         "composition",
@@ -75,9 +69,128 @@
     "publishConfig": {
         "access": "public"
     },
-    "sideEffects": false,
+    "engines": {
+        "node": ">=12.7"
+    },
+    "files": [
+        "*.js",
+        "*.d.ts"
+    ],
+    "exports": {
+        ".": {
+            "import": "./index.js"
+        },
+        "./ansi": {
+            "import": "./ansi.js"
+        },
+        "./api": {
+            "import": "./api.js"
+        },
+        "./case": {
+            "import": "./case.js"
+        },
+        "./center": {
+            "import": "./center.js"
+        },
+        "./cursor": {
+            "import": "./cursor.js"
+        },
+        "./entities": {
+            "import": "./entities.js"
+        },
+        "./escape": {
+            "import": "./escape.js"
+        },
+        "./float": {
+            "import": "./float.js"
+        },
+        "./format": {
+            "import": "./format.js"
+        },
+        "./groups": {
+            "import": "./groups.js"
+        },
+        "./hollerith": {
+            "import": "./hollerith.js"
+        },
+        "./initials": {
+            "import": "./initials.js"
+        },
+        "./int": {
+            "import": "./int.js"
+        },
+        "./interpolate": {
+            "import": "./interpolate.js"
+        },
+        "./join": {
+            "import": "./join.js"
+        },
+        "./pad-left": {
+            "import": "./pad-left.js"
+        },
+        "./pad-right": {
+            "import": "./pad-right.js"
+        },
+        "./parse": {
+            "import": "./parse.js"
+        },
+        "./percent": {
+            "import": "./percent.js"
+        },
+        "./radix": {
+            "import": "./radix.js"
+        },
+        "./range": {
+            "import": "./range.js"
+        },
+        "./repeat": {
+            "import": "./repeat.js"
+        },
+        "./ruler": {
+            "import": "./ruler.js"
+        },
+        "./slugify": {
+            "import": "./slugify.js"
+        },
+        "./splice": {
+            "import": "./splice.js"
+        },
+        "./split": {
+            "import": "./split.js"
+        },
+        "./stringify": {
+            "import": "./stringify.js"
+        },
+        "./tabs": {
+            "import": "./tabs.js"
+        },
+        "./trim": {
+            "import": "./trim.js"
+        },
+        "./truncate-left": {
+            "import": "./truncate-left.js"
+        },
+        "./truncate": {
+            "import": "./truncate.js"
+        },
+        "./units": {
+            "import": "./units.js"
+        },
+        "./uuid": {
+            "import": "./uuid.js"
+        },
+        "./vector": {
+            "import": "./vector.js"
+        },
+        "./word-wrap": {
+            "import": "./word-wrap.js"
+        },
+        "./wrap": {
+            "import": "./wrap.js"
+        }
+    },
     "thi.ng": {
         "year": 2015
     },
-    "gitHead": "d971cb3f9b215a95483f78f1a8614015e331146f"
+    "gitHead": "9ff00a103f76cc4917ef3f244132e218f2300a05"
 }

package/pad-left.js

@@ -1,5 +1,5 @@
-import { memoizeJ } from "@thi.ng/memoize";
-import { repeat } from "./repeat";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
+import { repeat } from "./repeat.js";
 /**
  * @param n - target length
  * @param ch - pad character(s)

package/pad-right.js

@@ -1,5 +1,5 @@
-import { memoizeJ } from "@thi.ng/memoize";
-import { repeat } from "./repeat";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
+import { repeat } from "./repeat.js";
 /**
  * @param n - target length
  * @param ch - pad character(s)

package/percent.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Returns {@link Stringer} which formats given fractions as percentage (e.g.
  * `0.1234 => 12.34%`).

package/radix.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Returns a {@link Stringer} which formats given numbers to `radix`, `len` and
  * with optional prefix (not included in `len`).

package/radix.js

@@ -1,6 +1,6 @@
 import { U16 as $16, U24 as $24, U32 as $32, U64HL, U8 as $8, } from "@thi.ng/hex";
-import { memoizeJ } from "@thi.ng/memoize";
-import { repeat } from "./repeat";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
+import { repeat } from "./repeat.js";
 /**
  * Returns a {@link Stringer} which formats given numbers to `radix`, `len` and
  * with optional prefix (not included in `len`).

package/repeat.js

@@ -1,4 +1,4 @@
-import { memoizeJ } from "@thi.ng/memoize";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
 /**
  * @param ch - character
  * @param n - repeat count

package/ruler.js

@@ -1,4 +1,4 @@
-import { repeat } from "./repeat";
+import { repeat } from "./repeat.js";
 /**
  * Returns a ruler-like string of given `width`, using `a` character for major
  * ticks and `b` for minor ticks.

package/slugify.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Based on:
  * {@link https://medium.com/@matthagemann/the-ultimate-way-to-slugify-a-url-string-in-javascript-b8e4a0d849e1}

package/splice.js

@@ -1,4 +1,4 @@
-import { illegalArgs } from "@thi.ng/errors";
+import { illegalArgs } from "@thi.ng/errors/illegal-arguments";
 /**
  * Forms a new strings which inserts given `insert` string into `src`
  * string at `from` position and appends remaining `src` chars from

package/stringify.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Higher order version of `JSON.stringify()` with the option to treat strings
  * and numbers differently. If `all` is `false` (default), strings and numbers

package/tabs.js

@@ -1,4 +1,4 @@
-import { repeat } from "./repeat";
+import { repeat } from "./repeat.js";
 const nextTab = (x, tabSize) => Math.floor((x + tabSize) / tabSize) * tabSize;
 /**
  * Multi-line version of {@link tabsToSpacesLine}.

package/trim.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Higher order trim function (both sides) with support for user defined
  * trimmable characters (default: whitespace only).

package/trim.js

@@ -1,4 +1,4 @@
-import { memoize1 } from "@thi.ng/memoize";
+import { memoize1 } from "@thi.ng/memoize/memoize1";
 /**
  * Higher order trim function (both sides) with support for user defined
  * trimmable characters (default: whitespace only).

package/truncate-left.d.ts

@@ -1,3 +1,3 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 export declare const truncateLeft: (n: number, prefix?: string) => Stringer<string>;
 //# sourceMappingURL=truncate-left.d.ts.map

package/truncate-left.js

@@ -1,2 +1,4 @@
-import { memoizeJ } from "@thi.ng/memoize";
-export const truncateLeft = memoizeJ((n, prefix = "") => (x) => x.length > n ? prefix + x.substr(x.length - n + prefix.length) : x);
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
+export const truncateLeft = memoizeJ((n, prefix = "") => (x) => x.length > n
+    ? prefix + x.substr(x.length - n + prefix.length)
+    : x);

package/truncate.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 export declare const truncate: (n: number, suffix?: string) => Stringer<string>;
 /**
  * Alias for {@link truncate}

package/truncate.js

@@ -1,4 +1,4 @@
-import { memoizeJ } from "@thi.ng/memoize";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
 export const truncate = memoizeJ((n, suffix = "") => (x) => x.length > n ? x.substr(0, n - suffix.length) + suffix : x);
 /**
  * Alias for {@link truncate}

package/units.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 declare type UnitDefs = [number, string, number?][];
 export declare const units: (exp: UnitDefs, base: string, prec?: number) => Stringer<number>;
 export declare const bits: Stringer<number>;

package/units.js

@@ -1,4 +1,4 @@
-import { memoizeJ } from "@thi.ng/memoize";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
 export const units = memoizeJ((exp, base, prec = 2) => {
     const groups = exp
         .map((x) => [

package/vector.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Higher order formatter for n-D vectors, with each element formatted using
  * `prec` and using optional delimiter and pre/postfixes.

package/vector.js

@@ -1,5 +1,5 @@
-import { memoizeJ } from "@thi.ng/memoize";
-import { float } from "./float";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
+import { float } from "./float.js";
 /**
  * Higher order formatter for n-D vectors, with each element formatted using
  * `prec` and using optional delimiter and pre/postfixes.

package/word-wrap.d.ts

@@ -1,4 +1,4 @@
-import type { IWordSplit, WordWrapOpts } from "./api";
+import type { IWordSplit, WordWrapOpts } from "./api.js";
 /**
  * Internal representation of a single line (for word wrapping purposes). A thin
  * wrapper of individual word and the _logical_ line length (rather than the

package/word-wrap.js

@@ -1,5 +1,5 @@
-import { lengthAnsi } from "./ansi";
-import { split } from "./split";
+import { lengthAnsi } from "./ansi.js";
+import { split } from "./split.js";
 /**
  * Internal representation of a single line (for word wrapping purposes). A thin
  * wrapper of individual word and the _logical_ line length (rather than the
@@ -114,7 +114,13 @@ export const wordWrapLine = (line, opts, acc = []) => {
         acc.push(new Line());
         return acc;
     }
-    const $opts = Object.assign({ width: 80, min: 4, hard: false, splitter: SPLIT_PLAIN }, opts);
+    const $opts = {
+        width: 80,
+        min: 4,
+        hard: false,
+        splitter: SPLIT_PLAIN,
+        ...opts,
+    };
     for (let word of split(line, opts.delimWord || /\s/g)) {
         const curr = acc[acc.length - 1];
         wrapWord(word, $opts, curr && curr.n > 0 ? curr.n + 1 : 0, acc);

package/wrap.d.ts

@@ -1,4 +1,4 @@
-import type { Stringer } from "./api";
+import type { Stringer } from "./api.js";
 /**
  * Returns a {@link Stringer} which wrap inputs with given `pad` string on
  * both sides.

package/wrap.js

@@ -1,4 +1,4 @@
-import { memoizeJ } from "@thi.ng/memoize";
+import { memoizeJ } from "@thi.ng/memoize/memoizej";
 /**
  * Returns a {@link Stringer} which wrap inputs with given `pad` string on
  * both sides.