@naturalcycles/js-lib 14.271.2 → 14.272.0

package/dist/string/string.util.d.ts

@@ -1,9 +1,18 @@
 /**
  * Converts the first character of string to upper case and the remaining to lower case.
+ * Returns a type-safe capitalized string.
  */
-export declare function _capitalize(s?: string): string;
-export declare function _upperFirst(s?: string): string;
-export declare function _lowerFirst(s: string): string;
+export declare function _capitalize(s?: string): Capitalize<string>;
+/**
+ * Convert a string to a type-safe uppercase string.
+ */
+export declare function _toUpperCase(s: string): Uppercase<string>;
+/**
+ * Convert a string to a type-safe lowercase string.
+ */
+export declare function _toLowercase(s: string): Lowercase<string>;
+export declare function _upperFirst(s?: string): Capitalize<string>;
+export declare function _lowerFirst(s: string): Uncapitalize<string>;
 /**
  * Like String.split(), but with limit, returning the tail together with last element.
  *

package/dist/string/string.util.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._capitalize = _capitalize;
+exports._toUpperCase = _toUpperCase;
+exports._toLowercase = _toLowercase;
 exports._upperFirst = _upperFirst;
 exports._lowerFirst = _lowerFirst;
 exports._split = _split;
@@ -15,15 +17,28 @@ exports._substringBetweenLast = _substringBetweenLast;
 exports._nl2br = _nl2br;
 /**
  * Converts the first character of string to upper case and the remaining to lower case.
+ * Returns a type-safe capitalized string.
  */
 function _capitalize(s = '') {
-    return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase();
+    return (s.charAt(0).toUpperCase() + s.slice(1).toLowerCase());
+}
+/**
+ * Convert a string to a type-safe uppercase string.
+ */
+function _toUpperCase(s) {
+    return s.toUpperCase();
+}
+/**
+ * Convert a string to a type-safe lowercase string.
+ */
+function _toLowercase(s) {
+    return s.toLowerCase();
 }
 function _upperFirst(s = '') {
-    return s.charAt(0).toUpperCase() + s.slice(1);
+    return (s.charAt(0).toUpperCase() + s.slice(1));
 }
 function _lowerFirst(s) {
-    return s.charAt(0).toLowerCase() + s.slice(1);
+    return (s.charAt(0).toLowerCase() + s.slice(1));
 }
 /**
  * Like String.split(), but with limit, returning the tail together with last element.

package/dist-esm/string/string.util.js

@@ -1,14 +1,27 @@
 /**
  * Converts the first character of string to upper case and the remaining to lower case.
+ * Returns a type-safe capitalized string.
  */
 export function _capitalize(s = '') {
-    return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase();
+    return (s.charAt(0).toUpperCase() + s.slice(1).toLowerCase());
+}
+/**
+ * Convert a string to a type-safe uppercase string.
+ */
+export function _toUpperCase(s) {
+    return s.toUpperCase();
+}
+/**
+ * Convert a string to a type-safe lowercase string.
+ */
+export function _toLowercase(s) {
+    return s.toLowerCase();
 }
 export function _upperFirst(s = '') {
-    return s.charAt(0).toUpperCase() + s.slice(1);
+    return (s.charAt(0).toUpperCase() + s.slice(1));
 }
 export function _lowerFirst(s) {
-    return s.charAt(0).toLowerCase() + s.slice(1);
+    return (s.charAt(0).toLowerCase() + s.slice(1));
 }
 /**
  * Like String.split(), but with limit, returning the tail together with last element.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.271.2",
+  "version": "14.272.0",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build-esm-cjs",

package/src/string/string.util.ts

@@ -1,16 +1,31 @@
 /**
  * Converts the first character of string to upper case and the remaining to lower case.
+ * Returns a type-safe capitalized string.
  */
-export function _capitalize(s = ''): string {
-  return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase()
+export function _capitalize(s = ''): Capitalize<string> {
+  return (s.charAt(0).toUpperCase() + s.slice(1).toLowerCase()) as Capitalize<string>
 }
 
-export function _upperFirst(s = ''): string {
-  return s.charAt(0).toUpperCase() + s.slice(1)
+/**
+ * Convert a string to a type-safe uppercase string.
+ */
+export function _toUpperCase(s: string): Uppercase<string> {
+  return s.toUpperCase() as Uppercase<string>
+}
+
+/**
+ * Convert a string to a type-safe lowercase string.
+ */
+export function _toLowercase(s: string): Lowercase<string> {
+  return s.toLowerCase() as Lowercase<string>
+}
+
+export function _upperFirst(s = ''): Capitalize<string> {
+  return (s.charAt(0).toUpperCase() + s.slice(1)) as Capitalize<string>
 }
 
-export function _lowerFirst(s: string): string {
-  return s.charAt(0).toLowerCase() + s.slice(1)
+export function _lowerFirst(s: string): Uncapitalize<string> {
+  return (s.charAt(0).toLowerCase() + s.slice(1)) as Uncapitalize<string>
 }
 
 /**