@thi.ng/strings 3.9.3 → 3.9.5

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-01-23T13:39:11Z
+- **Last updated**: 2025-02-13T16:03:11Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -7,7 +7,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 200 standalone projects, maintained as part
+> This is one of 201 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/entities.d.ts

@@ -1,6 +1,7 @@
 /**
  * @remarks
  * References:
+ *
  * - https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
  * - https://www.w3.org/TR/xml-entity-names/byalpha.html
  */

package/escape.d.ts

@@ -5,7 +5,8 @@ export declare const ESCAPES_REV: Record<number, string>;
  * backslash escape sequences.
  *
  * @remarks
- * - Well-known low-ASCII control chars will be escaped using simple `\`, e.g.
+ *
+ * - Well-known low-ASCII control chars will be escaped using backslash, e.g.
  *   0x0a => `\n`
  * - Non-BMP chars will be escaped using `\Uxxxxxxxx`
  * - Chars outside 0x20 - 0x7e range will be escaped using `\uxxxxx`

package/hollerith.d.ts

@@ -4,6 +4,7 @@ import type { Stringer } from "./api.js";
  *
  * @remarks
  * References:
+ *
  * - https://en.wikipedia.org/wiki/Hollerith_constant
  * - https://en.wikipedia.org/wiki/IGES#File_format
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/strings",
-  "version": "3.9.3",
+  "version": "3.9.5",
   "description": "Various string formatting & utility functions",
   "type": "module",
   "module": "./index.js",
@@ -33,21 +33,20 @@
     "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "bun ../../tools/src/clean-package.ts",
     "doc": "typedoc --options ../../typedoc.json --out doc src/index.ts",
-    "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
     "doc:readme": "bun ../../tools/src/module-stats.ts && bun ../../tools/src/readme.ts",
     "pub": "yarn npm publish --access public",
     "test": "bun test",
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.18",
-    "@thi.ng/errors": "^2.5.24",
-    "@thi.ng/hex": "^2.3.62",
-    "@thi.ng/memoize": "^4.0.8"
+    "@thi.ng/api": "^8.11.20",
+    "@thi.ng/errors": "^2.5.26",
+    "@thi.ng/hex": "^2.3.64",
+    "@thi.ng/memoize": "^4.0.10"
   },
   "devDependencies": {
-    "esbuild": "^0.24.2",
-    "typedoc": "^0.27.6",
+    "esbuild": "^0.25.0",
+    "typedoc": "^0.27.7",
     "typescript": "^5.7.3"
   },
   "keywords": [
@@ -211,5 +210,5 @@
   "thi.ng": {
     "year": 2015
   },
-  "gitHead": "b92b48abda9941d608be8a2e1c83447e679a6f79\n"
+  "gitHead": "9a0b33253fef092aaf301decf6ecd54317874d4c\n"
 }

package/range.d.ts

@@ -1,5 +1,5 @@
 /**
- * Yields iterator of characters [`from`..`to`] (inclusive). Uses
+ * Yields iterator of characters in the closed `[from,to]` interval. Uses
  * reverse ordering if `to` < `from`.
  *
  * @param from -

package/utf8.d.ts

@@ -6,7 +6,7 @@
 export declare const utf8Length: (str: string) => number;
 /**
  * Non-transducer version of
- * [`utf8Decode()`](https://docs.thi.ng/umbrella/transducers-binary/functions/utf8Decode.html).
+ * [`utf8Decode`](https://docs.thi.ng/umbrella/transducers-binary/functions/utf8Decode.html).
  * Decodes `num` bytes from `start` index in given byte buffer. In Firefox this
  * is much faster than using the `TextDecoder` API.
  *
@@ -17,7 +17,7 @@ export declare const utf8Length: (str: string) => number;
 export declare const utf8Decode: (buf: Uint8Array, start: number, num: number) => string;
 /**
  * Non-transducer version of
- * [`utf8Encode()`](https://docs.thi.ng/umbrella/transducers-binary/functions/utf8Encode.html).
+ * [`utf8Encode`](https://docs.thi.ng/umbrella/transducers-binary/functions/utf8Encode.html).
  *
  * @remarks
  * If `capacity` is given, initializes the byte array to that size (and assumes
@@ -27,6 +27,7 @@ export declare const utf8Decode: (buf: Uint8Array, start: number, num: number) =
  * `4 * src.length`.
  *
  * Based on:
+ *
  * - https://github.com/thi-ng/umbrella/blob/main/packages/transducers-binary/src/utf8.ts
  * - https://gist.github.com/pascaldekloe/62546103a1576803dade9269ccf76330
  *

package/uuid.d.ts

@@ -1,12 +1,12 @@
 /**
- * Same as [`uuid()`](https://docs.thi.ng/umbrella/hex/functions/uuid.html).
+ * Same as [`uuid`](https://docs.thi.ng/umbrella/hex/functions/uuid.html).
  * Returns UUID formatted string of given byte array from optional start index
  * `i` (default: 0). Array must have min. length
  * 16.
  *
  * @remarks
- * Use [`uuid()`](https://docs.thi.ng/umbrella/uuid/functions/uuid.html) to
- * also generate an UUID from scratch (rather than just format one).
+ * Use [`uuid`](https://docs.thi.ng/umbrella/uuid/functions/uuid.html) to also
+ * generate an UUID from scratch (rather than just format one).
  *
  * @param id -
  * @param i -

package/vector.d.ts

@@ -3,11 +3,11 @@ 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.
  *
- * @size - vector size (optimized for size 1-4)
- * @prec - precision (see {@link float}) or existing number formatter
- * @delim - delimiter (default: `,`)
- * @pre - prefix (default: `[`)
- * @post - prefix (default: `]`)
+ * @param size - vector size (optimized for size 1-4)
+ * @param prec - precision (see {@link float}) or existing number formatter
+ * @param delim - delimiter (default: `,`)
+ * @param pre - prefix (default: `[`)
+ * @param post - prefix (default: `]`)
  */
 export declare const vector: (size: number, prec?: number | Stringer<number>, delim?: string, pre?: string, post?: string) => Stringer<ArrayLike<number>>;
 //# sourceMappingURL=vector.d.ts.map

package/word-wrap.d.ts

@@ -24,7 +24,7 @@ export declare const SPLIT_ANSI: IWordSplit;
  * {@link Line} objects, which can simply be `.join("\n")`ed to convert back
  * into text.
  *
- * @see {@link wordWrap} for main user facing alternative.
+ * See {@link wordWrap} for main user facing alternative.
  *
  * @param line -
  * @param opts -
@@ -38,7 +38,7 @@ export declare const wordWrapLine: (line: string, opts: Partial<WordWrapOpts>, a
  * {@link Line} objects, which can simply be `.join("\n")`ed to convert back
  * into text.
  *
- * @see {@link wordWrap} for main user facing alternative.
+ * See {@link wordWrap} for main user facing alternative.
  *
  * @param lines -
  * @param opts -