@thi.ng/strings 3.8.13 → 3.9.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-12-27T14:11:37Z
+- **Last updated**: 2025-01-21T11:16:50Z
 - **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

@@ -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

@@ -3,9 +3,6 @@ const lower = (x) => x.toLowerCase();
 const capitalize = (x) => x.length ? x[0].toUpperCase() + x.substring(1) : x;
 const kebab = (x, delim = "-") => lower(
   x.replace(
-    // TC39
-    // /(?<=[a-z0-9\u00e0-\u00fd])(?=[A-Z\u00c0-\u00dd])/g,
-    // (_, i) => (i ? delim : "")
     /([a-z0-9\u00e0-\u00fd])([A-Z\u00c0-\u00dd])/g,
     (_, a, b) => a + delim + b
   )
@@ -13,11 +10,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.13",
+  "version": "3.9.1",
   "description": "Various string formatting & utility functions",
   "type": "module",
   "module": "./index.js",
@@ -40,10 +40,10 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.15",
-    "@thi.ng/errors": "^2.5.21",
-    "@thi.ng/hex": "^2.3.59",
-    "@thi.ng/memoize": "^4.0.5"
+    "@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.1",
@@ -212,5 +212,5 @@
   "thi.ng": {
     "year": 2015
   },
-  "gitHead": "48bf4c22bf23f88ac99f435106af2214f79a0be1\n"
+  "gitHead": "56e7a1724e7b0cb5c41119f60320b6ff0e8a3c1c\n"
 }