@thi.ng/strings 3.8.12 → 3.9.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-12-12T10:11:58Z
+- **Last updated**: 2025-01-04T21:07:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [3.9.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/strings@3.9.0) (2025-01-04)
+
+#### 🚀 Features
+
+- add `pascal()` case conversion ([2c3f4f4](https://github.com/thi-ng/umbrella/commit/2c3f4f4))
+
 ### [3.8.7](https://github.com/thi-ng/umbrella/tree/@thi.ng/strings@3.8.7) (2024-10-31)
 
 #### ♻️ Refactoring

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 199 standalone projects, maintained as part
+> This is one of 200 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -151,7 +151,7 @@ For Node.js REPL:
 const str = await import("@thi.ng/strings");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.52 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 5.51 KB
 
 ## Dependencies
 
@@ -223,4 +223,4 @@ If this project contributes to an academic publication, please cite it as:
 
 ## License
 
-© 2015 - 2024 Karsten Schmidt // Apache License 2.0
+© 2015 - 2025 Karsten Schmidt // Apache License 2.0

package/case.d.ts

@@ -21,13 +21,14 @@ export declare const capitalize: FnS;
  * Converts a CamelCase string into kebab case, with optional custom
  * delimiter (`-` by default).
  *
+ * @remarks
+ * See {@link snake} for alternative.
+ *
  * @example
  * ```ts tangle:../export/kebab.ts
  * import { kebab } from "@thi.ng/strings";
  *
- * console.log(
- *   kebab("FooBar23Baz")
- * );
+ * console.log(kebab("FooBar23Baz"));
  * // "foo-bar23-baz"
  * ```
  *
@@ -38,21 +39,68 @@ export declare const kebab: Stringer<string>;
 /**
  * Short for {@link kebab} using `_` as delimiter.
  *
+ * @remarks
+ * Also see {@link upperSnake} for alternative.
+ *
+ * @example
+ * ```ts tangle:../export/snake.ts
+ * import { snake } from "@thi.ng/strings";
+ *
+ * console.log(snake("FooBar23Baz"));
+ * // "foo_bar23_baz"
+ * ```
+ *
  * @param x -
  */
 export declare const snake: FnS;
 /**
  * Uppercase version of {@link snake}.
  *
+ * @remarks
+ * Also see {@link snake} for alternative.
+ *
  * @param x -
  */
 export declare const upperSnake: FnS;
 /**
- * Converts a kebab-case or snake_case string into CamelCase. Uses `-`
- * as default delimiter.
+ * Converts a kebab-case or snake_case string into camelCase. Uses `-` as
+ * default delimiter.
+ *
+ * @remarks
+ * Alse see {@link pascal} for alternative.
+ *
+ * @example
+ * ```ts tangle:../export/camel.ts
+ * import { camel } from "@thi.ng/strings";
+ *
+ * console.log(camel("foo-bar23-baz"));
+ * // fooBar23Baz
+ *
+ * console.log(camel("FOO_BAR23_BAZ", "_"));
+ * // fooBar23Baz
+ * ```
  *
  * @param x -
  * @param delim -
  */
 export declare const camel: Stringer<string>;
+/**
+ * Converts a kebab-case or snake_case string into PascalCase. Uses `-` as
+ * default delimiter.
+ *
+ * @example
+ * ```ts tangle:../export/pascal.ts
+ * import { pascal } from "@thi.ng/strings";
+ *
+ * console.log(pascal("foo-bar23-baz"));
+ * // FooBar23Baz
+ *
+ * console.log(pascal("FOO_BAR23_BAZ", "_"));
+ * // FooBar23Baz
+ * ```
+ *
+ * @param x
+ * @param delim
+ */
+export declare const pascal: Stringer<string>;
 //# sourceMappingURL=case.d.ts.map

package/case.js

@@ -13,11 +13,13 @@ const kebab = (x, delim = "-") => lower(
 const snake = (x) => kebab(x, "_");
 const upperSnake = (x) => snake(x).toUpperCase();
 const camel = (x, delim = "-") => lower(x).replace(new RegExp(`\\${delim}+(\\w)`, "g"), (_, c) => upper(c));
+const pascal = (x, delim = "-") => capitalize(camel(x, delim));
 export {
   camel,
   capitalize,
   kebab,
   lower,
+  pascal,
   snake,
   upper,
   upperSnake

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/strings",
-  "version": "3.8.12",
+  "version": "3.9.0",
   "description": "Various string formatting & utility functions",
   "type": "module",
   "module": "./index.js",
@@ -19,6 +19,10 @@
     {
       "type": "patreon",
       "url": "https://patreon.com/thing_umbrella"
+    },
+    {
+      "type": "liberapay",
+      "url": "https://liberapay.com/thi.ng"
     }
   ],
   "author": "Karsten Schmidt (https://thi.ng)",
@@ -36,15 +40,15 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.14",
-    "@thi.ng/errors": "^2.5.20",
-    "@thi.ng/hex": "^2.3.58",
-    "@thi.ng/memoize": "^4.0.4"
+    "@thi.ng/api": "^8.11.16",
+    "@thi.ng/errors": "^2.5.22",
+    "@thi.ng/hex": "^2.3.60",
+    "@thi.ng/memoize": "^4.0.6"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.48.0",
-    "esbuild": "^0.24.0",
-    "typedoc": "^0.27.4",
+    "@microsoft/api-extractor": "^7.48.1",
+    "esbuild": "^0.24.2",
+    "typedoc": "^0.27.6",
     "typescript": "^5.7.2"
   },
   "keywords": [
@@ -208,5 +212,5 @@
   "thi.ng": {
     "year": 2015
   },
-  "gitHead": "34ac95538d96f046090fef5fd3a1dc36d54663d5\n"
+  "gitHead": "56c1d57a96565bbcc8c06c73779a619bba0db368\n"
 }