@thi.ng/strings 3.7.15 → 3.7.17

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-19T16:07:08Z
+- **Last updated**: 2024-02-25T14:07:53Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -18,7 +18,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 189 standalone projects, maintained as part
+> This is one of 190 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/ansi.d.ts

@@ -3,6 +3,8 @@
  *
  * @example
  * ```ts
+ * import { stripAnsi } from "@thi.ng/strings";
+ *
  * stripAnsi("\x1B[32mhello\x1B[0m \x1B[91mworld\x1B[0m!"");
  * // 'hello world!'
  * ```

package/case.d.ts

@@ -23,6 +23,8 @@ export declare const capitalize: FnS;
  *
  * @example
  * ```ts
+ * import { kebab } from "@thi.ng/strings";
+ *
  * kebab("FooBar23Baz");
  * // "foo-bar23-baz"
  * ```

package/center.d.ts

@@ -11,10 +11,24 @@ import type { Stringer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { center, wrap } from "@thi.ng/strings";
+ *
  * center(20, "<>")(wrap(" ")("thi.ng"))
  * // "<><><> thi.ng <><><>"
  * ```
  *
+ * @example
+ * ```ts
+ * import { comp } from "@thi.ng/compose";
+ * import { center, wrap } from "@thi.ng/strings";
+ *
+ * // compose formatting function
+ * const fmt = comp(center(20,"<>"), wrap(" "));
+ *
+ * fmt("thi.ng")
+ * // "<><><> thi.ng <><><>"
+ * ```
+ *
  * @param lineWidth - target length
  * @param pad - pad character(s)
  */

package/cursor.d.ts

@@ -9,6 +9,8 @@
  *
  * @example
  * ```ts
+ * import { computeCursorPos } from "@thi.ng/strings";
+ *
  * computeCursorPos("thi.ng\numbrella", 10);
  * // [ 2, 4 ]
  *

package/escape.d.ts

@@ -27,6 +27,8 @@ export declare const escape: (src: string) => string;
  *
  * @example
  * ```ts
+ * import { unescape } from "@thi.ng/strings";
+ *
  * unescape("\\ud83d\\ude0e \\U0001f60e")
  * // '😎'
  * ```

package/hollerith.d.ts

@@ -4,6 +4,8 @@ import type { Stringer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { hstr } from "@thi.ng/strings";
+ *
  * hstr("abc")  // "3Habc"
  * hstr(123.45) // "6H123.45"
  * hstr("")     // "0H"

package/join.d.ts

@@ -6,11 +6,15 @@ import type { Stringer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { format, join } from "@thi.ng/strings";
+ * import { partial } from "@thi.ng/compose";
+ *
  * const slashes = join("/");
  *
  * slashes([1, 2, 3]);
  * // "1/2/3"
  *
+ * // pre-compose formatter function w/ partial arguments
  * const formatOBJFace = partial(
  *   format, ["f ", slashes, " ", slashes, " ", slashes]
  * );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/strings",
-  "version": "3.7.15",
+  "version": "3.7.17",
   "description": "Various string formatting & utility functions",
   "type": "module",
   "module": "./index.js",
@@ -35,10 +35,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.24",
-    "@thi.ng/errors": "^2.4.17",
-    "@thi.ng/hex": "^2.3.36",
-    "@thi.ng/memoize": "^3.1.58"
+    "@thi.ng/api": "^8.9.26",
+    "@thi.ng/errors": "^2.4.18",
+    "@thi.ng/hex": "^2.3.37",
+    "@thi.ng/memoize": "^3.1.60"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -203,5 +203,5 @@
   "thi.ng": {
     "year": 2015
   },
-  "gitHead": "2724c87ca41810f2112f9d8c3d6b90dfaeea876b\n"
+  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
 }

package/ruler.d.ts

@@ -4,6 +4,8 @@
  *
  * @example
  * ```ts
+ * import { ruler } from "@thi.ng/strings";
+ *
  * console.log(ruler(40))
  * // |''''|''''|''''|''''|''''|''''|''''|''''
  *
@@ -23,6 +25,8 @@ export declare const ruler: (width: number, major?: number, a?: string, b?: stri
  *
  * @example
  * ```ts
+ * import { grid } from "@thi.ng/strings";
+ *
  * console.log(grid(3, 3, 4, 2));
  * // +---+---+---+
  * // |   |   |   |

package/slugify.d.ts

@@ -5,6 +5,8 @@ import type { Stringer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { slugify } from "@thi.ng/strings";
+ *
  * slugify("Me, myself (& ëye) 😀!")
  * // "me-myself-and-eye"
  * ```
@@ -18,6 +20,8 @@ export declare const slugify: Stringer<string>;
  *
  * @example
  * ```ts
+ * import { slugifyGH } from "@thi.ng/strings";
+ *
  * slugifyGH("Me, myself (& ëye) 😀!")
  * // "me-myself--ëye-"
  * ```

package/tabs.d.ts

@@ -3,6 +3,8 @@
  *
  * @example
  * ```ts
+ * import { tabsToSpaces } from "@thi.ng/strings";
+ *
  * console.log(
  *   tabsToSpaces("0\t1\t2", 10)
  *   + "\n" +

package/trim.d.ts

@@ -5,6 +5,8 @@ import type { Stringer } from "./api.js";
  *
  * @example
  * ```ts
+ * import { trim } from "@thi.ng/strings";
+ *
  * trim()("  Hello   ")
  * // "Hello"
  *