@unikue/ts-lang-utils 1.0.0

package/dist/esm/util/StringUtils/endsWithAnyIgnoreCase.js

@@ -0,0 +1,9 @@
+import { endsWithIgnoreCase } from "./endsWithIgnoreCase";
+export function endsWithAnyIgnoreCase(text, suffixes) {
+  if (!text || !suffixes || !suffixes.length) {
+    return false;
+  }
+  return suffixes.some(function (suffix) {
+    return endsWithIgnoreCase(text, suffix);
+  });
+}

package/dist/esm/util/StringUtils/endsWithIgnoreCase.d.ts

@@ -0,0 +1 @@
+export declare function endsWithIgnoreCase(text?: string | null, suffix?: string | null): boolean;

package/dist/esm/util/StringUtils/endsWithIgnoreCase.js

@@ -0,0 +1,9 @@
+export function endsWithIgnoreCase(text, suffix) {
+  if (!text || !suffix) {
+    return text === suffix;
+  }
+  if (text.length < suffix.length) {
+    return false;
+  }
+  return text.toLowerCase().endsWith(suffix.toLowerCase());
+}

package/dist/esm/util/StringUtils/equals.d.ts

@@ -0,0 +1 @@
+export declare function equals(text?: string | null, comparison?: string | null): boolean;

package/dist/esm/util/StringUtils/equals.js

@@ -0,0 +1,9 @@
+export function equals(text, comparison) {
+  if (text === comparison) {
+    return true;
+  }
+  if (!text || !comparison || (text === null || text === void 0 ? void 0 : text.length) !== (comparison === null || comparison === void 0 ? void 0 : comparison.length)) {
+    return false;
+  }
+  return text === comparison;
+}

package/dist/esm/util/StringUtils/equalsAny.d.ts

@@ -0,0 +1 @@
+export declare function equalsAny(text?: string | null, comparisons?: Array<string | null | undefined>): boolean;

package/dist/esm/util/StringUtils/equalsAny.js

@@ -0,0 +1,4 @@
+import { includes } from "../ArrayUtils/includes";
+export function equalsAny(text, comparisons) {
+  return includes(comparisons, text);
+}

package/dist/esm/util/StringUtils/equalsAnyIgnoreCase.d.ts

@@ -0,0 +1 @@
+export declare function equalsAnyIgnoreCase(text?: string | null, comparisons?: Array<string | null | undefined>): boolean;

package/dist/esm/util/StringUtils/equalsAnyIgnoreCase.js

@@ -0,0 +1,9 @@
+import { equalsIgnoreCase } from "./equalsIgnoreCase";
+export function equalsAnyIgnoreCase(text, comparisons) {
+  if (!text || !comparisons || !comparisons.length) {
+    return false;
+  }
+  return comparisons.some(function (comparison) {
+    return equalsIgnoreCase(text, comparison);
+  });
+}

package/dist/esm/util/StringUtils/equalsIgnoreCase.d.ts

@@ -0,0 +1 @@
+export declare function equalsIgnoreCase(text?: string | null, comparison?: string | null): boolean;

package/dist/esm/util/StringUtils/equalsIgnoreCase.js

@@ -0,0 +1,9 @@
+export function equalsIgnoreCase(text, comparison) {
+  if (text === comparison) {
+    return true;
+  }
+  if (!text || !comparison || (text === null || text === void 0 ? void 0 : text.length) !== (comparison === null || comparison === void 0 ? void 0 : comparison.length)) {
+    return false;
+  }
+  return (text === null || text === void 0 ? void 0 : text.toUpperCase()) === (comparison === null || comparison === void 0 ? void 0 : comparison.toUpperCase());
+}

package/dist/esm/util/StringUtils/escapeHtml.d.ts

@@ -0,0 +1 @@
+export declare function escapeHtml(text?: string | null): string | null | undefined;

package/dist/esm/util/StringUtils/escapeHtml.js

@@ -0,0 +1,15 @@
+export function escapeHtml(text) {
+  if (!text) {
+    return text;
+  }
+  var map = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#039;'
+  };
+  return text.replace(/[&<>"']/g, function (item) {
+    return map[item];
+  });
+}

package/dist/esm/util/StringUtils/filterIgnoreBlank.d.ts

@@ -0,0 +1 @@
+export declare function filterIgnoreBlank(texts?: Array<string | null | undefined>): string[] | undefined;

package/dist/esm/util/StringUtils/filterIgnoreBlank.js

@@ -0,0 +1,10 @@
+import { isNotBlank } from "./isNotBlank";
+export function filterIgnoreBlank(texts) {
+  if (!texts || !texts.length) {
+    return undefined;
+  }
+  var result = texts.filter(function (item) {
+    return isNotBlank(item);
+  });
+  return !result || !result.length ? undefined : result;
+}

package/dist/esm/util/StringUtils/filterIgnoreEmpty.d.ts

@@ -0,0 +1 @@
+export declare function filterIgnoreEmpty(texts?: Array<string | null | undefined>): string[] | undefined;

package/dist/esm/util/StringUtils/filterIgnoreEmpty.js

@@ -0,0 +1,10 @@
+import { isNotEmpty } from "./isNotEmpty";
+export function filterIgnoreEmpty(texts) {
+  if (!texts || !texts.length) {
+    return undefined;
+  }
+  var result = texts.filter(function (item) {
+    return isNotEmpty(item);
+  });
+  return !result || !result.length ? undefined : result;
+}

package/dist/esm/util/StringUtils/formatBrace.d.ts

@@ -0,0 +1 @@
+export declare function formatBrace(text?: string | null, ...params: any[]): string | null | undefined;

package/dist/esm/util/StringUtils/formatBrace.js

@@ -0,0 +1,15 @@
+import { toString } from "../ObjectUtils/toString";
+export function formatBrace(text) {
+  for (var _len = arguments.length, params = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    params[_key - 1] = arguments[_key];
+  }
+  if (!text || text.length <= 2 || !params || !params.length) {
+    return text;
+  }
+  var result = text;
+  for (var _i = 0, _params = params; _i < _params.length; _i++) {
+    var param = _params[_i];
+    result = result.replace('{}', toString(param, ''));
+  }
+  return result;
+}

package/dist/esm/util/StringUtils/formatPercent.d.ts

@@ -0,0 +1 @@
+export declare function formatPercent(text?: string | null, ...params: any[]): string | null | undefined;

package/dist/esm/util/StringUtils/formatPercent.js

@@ -0,0 +1,89 @@
+import { minLength } from "../ArrayUtils/minLength";
+import { isPlain } from "../ObjectUtils/isPlain";
+import { toString } from "../ObjectUtils/toString";
+export function formatPercent(text) {
+  for (var _len = arguments.length, params = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    params[_key - 1] = arguments[_key];
+  }
+  if (!text || text.length <= 2 || !params || !params.length) {
+    return text;
+  }
+  var matches = text.match(/%[bcdfjosxX]/g) || [];
+  var count = minLength(matches, params);
+  if (count === 0) {
+    return text;
+  }
+  var result = text;
+  for (var i = 0; i < count; i++) {
+    var param = params[i];
+    var pattern = matches[i].substring(1);
+    switch (pattern) {
+      case 'b':
+      case 'c':
+      case 'd':
+      case 'o':
+      case 'x':
+      case 'X':
+        try {
+          var value = undefined;
+          if (typeof param === 'string') {
+            value = Number.parseInt(param);
+          } else if (param instanceof String) {
+            value = Number.parseInt(param.toString());
+          } else if (typeof param === 'number') {
+            value = param;
+          }
+          if (value) {
+            if (pattern === 'b') {
+              result = result.replace("%".concat(pattern), value.toString(2));
+            } else if (pattern === 'c') {
+              result = result.replace("%".concat(pattern), String.fromCharCode(value));
+            } else if (pattern === 'd') {
+              result = result.replace("%".concat(pattern), value.toString(10));
+            } else if (pattern === 'o') {
+              result = result.replace("%".concat(pattern), '0' + value.toString(8));
+            } else if (pattern === 'x') {
+              result = result.replace("%".concat(pattern), '0x' + value.toString(16));
+            } else if (pattern === 'X') {
+              result = result.replace("%".concat(pattern), '0x' + value.toString(16).toUpperCase());
+            }
+          }
+        } catch (_unused) {
+          throw new TypeError("Invalid parameter type of '".concat(param, "', index ").concat(i));
+        }
+        break;
+      case 'f':
+        try {
+          var _value = undefined;
+          if (typeof param === 'string') {
+            _value = Number.parseFloat(param);
+          } else if (param instanceof String) {
+            _value = Number.parseFloat(param.toString());
+          } else if (typeof param === 'number') {
+            _value = param;
+          }
+          if (_value) {
+            result = result.replace("%".concat(pattern), '0x' + _value.toString());
+          }
+        } catch (_unused2) {
+          throw new TypeError("Invalid parameter type of '".concat(param, "', index ").concat(i));
+        }
+        break;
+      case 'j':
+        if (param === undefined || param === null) {
+          result = result.replace("%".concat(pattern), '');
+          break;
+        } else if (isPlain(param)) {
+          result = result.replace("%".concat(pattern), JSON.stringify(param));
+          break;
+        }
+        throw new TypeError("Invalid parameter type of '".concat(param, "', index ").concat(i));
+      case 's':
+        result = result.replace("%".concat(pattern), toString(param, ''));
+        break;
+      default:
+        break;
+    }
+  }
+  return result;
+}

package/dist/esm/util/StringUtils/formatPlaceholder.d.ts

@@ -0,0 +1,3 @@
+export declare function formatPlaceholder(text?: string | null, params?: {
+    [key: string]: any;
+}): string | null | undefined;

package/dist/esm/util/StringUtils/formatPlaceholder.js

@@ -0,0 +1,12 @@
+export function formatPlaceholder(text, params) {
+  if (!text || text.length <= 2 || !params) {
+    return text;
+  }
+  var result = text;
+  for (var param in params) {
+    var regex = new RegExp("\\{".concat(param, "\\}"), 'g');
+    var value = params[param];
+    result = result.replace(regex, value ? value.toString() : '');
+  }
+  return result;
+}

package/dist/esm/util/StringUtils/fromChars.d.ts

@@ -0,0 +1 @@
+export declare function fromChars(texts?: Array<string | null | undefined>): string | undefined;

package/dist/esm/util/StringUtils/fromChars.js

@@ -0,0 +1,3 @@
+export function fromChars(texts) {
+  return !texts ? undefined : texts.join('');
+}

package/dist/esm/util/StringUtils/getLength.d.ts

@@ -0,0 +1 @@
+export declare function getLength(source?: string | number | null): number;

package/dist/esm/util/StringUtils/getLength.js

@@ -0,0 +1,9 @@
+export function getLength(source) {
+  if (source === undefined || source === null) {
+    return 0;
+  }
+  if (typeof source === 'number') {
+    return source.toString().length;
+  }
+  return source.length;
+}

package/dist/esm/util/StringUtils/includes.d.ts

@@ -0,0 +1 @@
+export declare function includes(text?: string | null, comparison?: string | null): boolean;

package/dist/esm/util/StringUtils/includes.js

@@ -0,0 +1,3 @@
+export function includes(text, comparison) {
+  return text === comparison || !!text && !!comparison && text.includes(comparison);
+}

package/dist/esm/util/StringUtils/includesAny.d.ts

@@ -0,0 +1 @@
+export declare function includesAny(text?: string | null, comparisons?: Array<string | null | undefined>): boolean;

package/dist/esm/util/StringUtils/includesAny.js

@@ -0,0 +1,9 @@
+import { includes } from "./includes";
+export function includesAny(text, comparisons) {
+  if (!text || !comparisons) {
+    return false;
+  }
+  return comparisons === null || comparisons === void 0 ? void 0 : comparisons.some(function (comparison) {
+    return includes(text, comparison);
+  });
+}

package/dist/esm/util/StringUtils/includesAnyIgnoreCase.d.ts

@@ -0,0 +1 @@
+export declare function includesAnyIgnoreCase(text?: string | null, comparisons?: Array<string | null | undefined>): boolean;

package/dist/esm/util/StringUtils/includesAnyIgnoreCase.js

@@ -0,0 +1,9 @@
+import { includesIgnoreCase } from "./includesIgnoreCase";
+export function includesAnyIgnoreCase(text, comparisons) {
+  if (!text || !comparisons || !comparisons.length) {
+    return false;
+  }
+  return comparisons === null || comparisons === void 0 ? void 0 : comparisons.some(function (comparison) {
+    return includesIgnoreCase(text, comparison);
+  });
+}

package/dist/esm/util/StringUtils/includesIgnoreCase.d.ts

@@ -0,0 +1 @@
+export declare function includesIgnoreCase(text?: string | null, comparison?: string | null): boolean;

package/dist/esm/util/StringUtils/includesIgnoreCase.js

@@ -0,0 +1,4 @@
+export function includesIgnoreCase(text, comparison) {
+  var _text$toUpperCase;
+  return text === comparison || !!text && !!comparison && (text === null || text === void 0 || (_text$toUpperCase = text.toUpperCase()) === null || _text$toUpperCase === void 0 ? void 0 : _text$toUpperCase.includes(comparison === null || comparison === void 0 ? void 0 : comparison.toUpperCase()));
+}

package/dist/esm/util/StringUtils/index.d.ts

@@ -0,0 +1,89 @@
+export { abbreviate } from './abbreviate';
+export { allBlank } from './allBlank';
+export { allEmpty } from './allEmpty';
+export { allNotBlank } from './allNotBlank';
+export { allNotEmpty } from './allNotEmpty';
+export { anyBlank } from './anyBlank';
+export { anyEmpty } from './anyEmpty';
+export { anyNotBlank } from './anyNotBlank';
+export { anyNotEmpty } from './anyNotEmpty';
+export { appendIfMissing } from './appendIfMissing';
+export { appendIfMissingIgnoreCase } from './appendIfMissingIgnoreCase';
+export { capitalizeFirst } from './capitalizeFirst';
+export { capitalizeFirstLowerTail } from './capitalizeFirstLowerTail';
+export { center } from './center';
+export { defaultIfBlank } from './defaultIfBlank';
+export { defaultIfEmpty } from './defaultIfEmpty';
+export { defaultString } from './defaultString';
+export { endsWith } from './endsWith';
+export { endsWithAny } from './endsWithAny';
+export { endsWithAnyIgnoreCase } from './endsWithAnyIgnoreCase';
+export { endsWithIgnoreCase } from './endsWithIgnoreCase';
+export { equals } from './equals';
+export { equalsAny } from './equalsAny';
+export { equalsAnyIgnoreCase } from './equalsAnyIgnoreCase';
+export { equalsIgnoreCase } from './equalsIgnoreCase';
+export { escapeHtml } from './escapeHtml';
+export { filterIgnoreBlank } from './filterIgnoreBlank';
+export { filterIgnoreEmpty } from './filterIgnoreEmpty';
+export { formatBrace } from './formatBrace';
+export { formatPercent } from './formatPercent';
+export { formatPlaceholder } from './formatPlaceholder';
+export { fromChars } from './fromChars';
+export { getLength } from './getLength';
+export { includes } from './includes';
+export { includesAny } from './includesAny';
+export { includesAnyIgnoreCase } from './includesAnyIgnoreCase';
+export { includesIgnoreCase } from './includesIgnoreCase';
+export { isBlank } from './isBlank';
+export { isEmpty } from './isEmpty';
+export { isNotBlank } from './isNotBlank';
+export { isNotEmpty } from './isNotEmpty';
+export { join } from './join';
+export { joinWith } from './joinWith';
+export { left } from './left';
+export { leftPad } from './leftPad';
+export { prependIfMissing } from './prependIfMissing';
+export { prependIfMissingIgnoreCase } from './prependIfMissingIgnoreCase';
+export { quoteDouble } from './quoteDouble';
+export { quoteSingle } from './quoteSingle';
+export { removeAll } from './removeAll';
+export { removeAllIgnoreCase } from './removeAllIgnoreCase';
+export { removeBlank } from './removeBlank';
+export { removeEnd } from './removeEnd';
+export { removeEndIgnoreCase } from './removeEndIgnoreCase';
+export { removeEquals } from './removeEquals';
+export { removeEqualsIgnoreCase } from './removeEqualsIgnoreCase';
+export { removeFirst } from './removeFirst';
+export { removeFirstIgnoreCase } from './removeFirstIgnoreCase';
+export { removeIncludes } from './removeIncludes';
+export { removeIncludesIgnoreCase } from './removeIncludesIgnoreCase';
+export { removeStart } from './removeStart';
+export { removeStartIgnoreCase } from './removeStartIgnoreCase';
+export { repeat } from './repeat';
+export { replaceAll } from './replaceAll';
+export { replaceAllIgnoreCase } from './replaceAllIgnoreCase';
+export { replaceFirst } from './replaceFirst';
+export { replaceFirstIgnoreCase } from './replaceFirstIgnoreCase';
+export { reverse } from './reverse';
+export { right } from './right';
+export { rightPad } from './rightPad';
+export { split } from './split';
+export { startsWith } from './startsWith';
+export { startsWithAny } from './startsWithAny';
+export { startsWithAnyIgnoreCase } from './startsWithAnyIgnoreCase';
+export { startsWithIgnoreCase } from './startsWithIgnoreCase';
+export { substringAfter } from './substringAfter';
+export { substringAfterAny } from './substringAfterAny';
+export { substringAfterLast } from './substringAfterLast';
+export { substringAfterLastAny } from './substringAfterLastAny';
+export { substringBefore } from './substringBefore';
+export { substringBeforeAny } from './substringBeforeAny';
+export { substringBeforeLast } from './substringBeforeLast';
+export { substringBeforeLastAny } from './substringBeforeLastAny';
+export { toCamelCase } from './toCamelCase';
+export { toChars } from './toChars';
+export { toKebabCase } from './toKebabCase';
+export { trim } from './trim';
+export { unescapeHtml } from './unescapeHtml';
+export { unquote } from './unquote';

package/dist/esm/util/StringUtils/index.js

@@ -0,0 +1,89 @@
+export { abbreviate } from "./abbreviate";
+export { allBlank } from "./allBlank";
+export { allEmpty } from "./allEmpty";
+export { allNotBlank } from "./allNotBlank";
+export { allNotEmpty } from "./allNotEmpty";
+export { anyBlank } from "./anyBlank";
+export { anyEmpty } from "./anyEmpty";
+export { anyNotBlank } from "./anyNotBlank";
+export { anyNotEmpty } from "./anyNotEmpty";
+export { appendIfMissing } from "./appendIfMissing";
+export { appendIfMissingIgnoreCase } from "./appendIfMissingIgnoreCase";
+export { capitalizeFirst } from "./capitalizeFirst";
+export { capitalizeFirstLowerTail } from "./capitalizeFirstLowerTail";
+export { center } from "./center";
+export { defaultIfBlank } from "./defaultIfBlank";
+export { defaultIfEmpty } from "./defaultIfEmpty";
+export { defaultString } from "./defaultString";
+export { endsWith } from "./endsWith";
+export { endsWithAny } from "./endsWithAny";
+export { endsWithAnyIgnoreCase } from "./endsWithAnyIgnoreCase";
+export { endsWithIgnoreCase } from "./endsWithIgnoreCase";
+export { equals } from "./equals";
+export { equalsAny } from "./equalsAny";
+export { equalsAnyIgnoreCase } from "./equalsAnyIgnoreCase";
+export { equalsIgnoreCase } from "./equalsIgnoreCase";
+export { escapeHtml } from "./escapeHtml";
+export { filterIgnoreBlank } from "./filterIgnoreBlank";
+export { filterIgnoreEmpty } from "./filterIgnoreEmpty";
+export { formatBrace } from "./formatBrace";
+export { formatPercent } from "./formatPercent";
+export { formatPlaceholder } from "./formatPlaceholder";
+export { fromChars } from "./fromChars";
+export { getLength } from "./getLength";
+export { includes } from "./includes";
+export { includesAny } from "./includesAny";
+export { includesAnyIgnoreCase } from "./includesAnyIgnoreCase";
+export { includesIgnoreCase } from "./includesIgnoreCase";
+export { isBlank } from "./isBlank";
+export { isEmpty } from "./isEmpty";
+export { isNotBlank } from "./isNotBlank";
+export { isNotEmpty } from "./isNotEmpty";
+export { join } from "./join";
+export { joinWith } from "./joinWith";
+export { left } from "./left";
+export { leftPad } from "./leftPad";
+export { prependIfMissing } from "./prependIfMissing";
+export { prependIfMissingIgnoreCase } from "./prependIfMissingIgnoreCase";
+export { quoteDouble } from "./quoteDouble";
+export { quoteSingle } from "./quoteSingle";
+export { removeAll } from "./removeAll";
+export { removeAllIgnoreCase } from "./removeAllIgnoreCase";
+export { removeBlank } from "./removeBlank";
+export { removeEnd } from "./removeEnd";
+export { removeEndIgnoreCase } from "./removeEndIgnoreCase";
+export { removeEquals } from "./removeEquals";
+export { removeEqualsIgnoreCase } from "./removeEqualsIgnoreCase";
+export { removeFirst } from "./removeFirst";
+export { removeFirstIgnoreCase } from "./removeFirstIgnoreCase";
+export { removeIncludes } from "./removeIncludes";
+export { removeIncludesIgnoreCase } from "./removeIncludesIgnoreCase";
+export { removeStart } from "./removeStart";
+export { removeStartIgnoreCase } from "./removeStartIgnoreCase";
+export { repeat } from "./repeat";
+export { replaceAll } from "./replaceAll";
+export { replaceAllIgnoreCase } from "./replaceAllIgnoreCase";
+export { replaceFirst } from "./replaceFirst";
+export { replaceFirstIgnoreCase } from "./replaceFirstIgnoreCase";
+export { reverse } from "./reverse";
+export { right } from "./right";
+export { rightPad } from "./rightPad";
+export { split } from "./split";
+export { startsWith } from "./startsWith";
+export { startsWithAny } from "./startsWithAny";
+export { startsWithAnyIgnoreCase } from "./startsWithAnyIgnoreCase";
+export { startsWithIgnoreCase } from "./startsWithIgnoreCase";
+export { substringAfter } from "./substringAfter";
+export { substringAfterAny } from "./substringAfterAny";
+export { substringAfterLast } from "./substringAfterLast";
+export { substringAfterLastAny } from "./substringAfterLastAny";
+export { substringBefore } from "./substringBefore";
+export { substringBeforeAny } from "./substringBeforeAny";
+export { substringBeforeLast } from "./substringBeforeLast";
+export { substringBeforeLastAny } from "./substringBeforeLastAny";
+export { toCamelCase } from "./toCamelCase";
+export { toChars } from "./toChars";
+export { toKebabCase } from "./toKebabCase";
+export { trim } from "./trim";
+export { unescapeHtml } from "./unescapeHtml";
+export { unquote } from "./unquote";

package/dist/esm/util/StringUtils/isBlank.d.ts

@@ -0,0 +1 @@
+export declare function isBlank(text?: string | null): boolean;

package/dist/esm/util/StringUtils/isBlank.js

@@ -0,0 +1,3 @@
+export function isBlank(text) {
+  return !text || /^\s*$/.test(text);
+}

package/dist/esm/util/StringUtils/isEmpty.d.ts

@@ -0,0 +1 @@
+export declare function isEmpty(text?: string | null): boolean;

package/dist/esm/util/StringUtils/isEmpty.js

@@ -0,0 +1,3 @@
+export function isEmpty(text) {
+  return !text;
+}

package/dist/esm/util/StringUtils/isNotBlank.d.ts

@@ -0,0 +1 @@
+export declare function isNotBlank(text?: string | null): boolean;

package/dist/esm/util/StringUtils/isNotBlank.js

@@ -0,0 +1,4 @@
+import { isBlank } from "./isBlank";
+export function isNotBlank(text) {
+  return !isBlank(text);
+}

package/dist/esm/util/StringUtils/isNotEmpty.d.ts

@@ -0,0 +1 @@
+export declare function isNotEmpty(text?: string | null): boolean;

package/dist/esm/util/StringUtils/isNotEmpty.js

@@ -0,0 +1,3 @@
+export function isNotEmpty(text) {
+  return !!text;
+}

package/dist/esm/util/StringUtils/join.d.ts

@@ -0,0 +1 @@
+export declare function join(element?: any | any[] | readonly any[] | null, separator?: string | null, filter?: (item?: any) => boolean): string | undefined;

package/dist/esm/util/StringUtils/join.js

@@ -0,0 +1,17 @@
+import { defaultString } from "./defaultString";
+export function join(element, separator, filter) {
+  if (element === undefined || element === null) {
+    return undefined;
+  }
+  if (Array.isArray(element)) {
+    if (!element.length) {
+      return undefined;
+    }
+    if (!filter) {
+      return element.join(defaultString(separator));
+    }
+    var alias = element.filter(filter);
+    return !alias || !alias.length ? undefined : alias.join(defaultString(separator));
+  }
+  return !filter ? element.toString() : filter(element) ? element.toString() : undefined;
+}

package/dist/esm/util/StringUtils/joinWith.d.ts

@@ -0,0 +1 @@
+export declare function joinWith(texts?: string | string[] | null, separator?: string | null, filter?: (text?: string) => boolean): string | undefined;

package/dist/esm/util/StringUtils/joinWith.js

@@ -0,0 +1,14 @@
+import { defaultString } from "./defaultString";
+export function joinWith(texts, separator, filter) {
+  if (!texts || Array.isArray(texts) && texts.length === 0) {
+    return undefined;
+  }
+  if (Array.isArray(texts)) {
+    if (!filter) {
+      return texts.join(defaultString(separator));
+    }
+    var array = texts.filter(filter);
+    return !array || array.length === 0 ? undefined : array.join(defaultString(separator));
+  }
+  return !filter ? texts : filter(texts) ? texts : undefined;
+}

package/dist/esm/util/StringUtils/left.d.ts

@@ -0,0 +1 @@
+export declare function left(text?: string | null, length?: number): string | null | undefined;

package/dist/esm/util/StringUtils/left.js

@@ -0,0 +1,9 @@
+export function left(text, length) {
+  if (!text || length === undefined || length < 0) {
+    return text;
+  }
+  if (length === 0) {
+    return '';
+  }
+  return text.substring(0, length);
+}

package/dist/esm/util/StringUtils/leftPad.d.ts

@@ -0,0 +1 @@
+export declare function leftPad(text?: string | null, size?: number, pad?: string | null): string | null | undefined;

package/dist/esm/util/StringUtils/leftPad.js

@@ -0,0 +1,26 @@
+import { defaultIfBlank } from "./defaultIfBlank";
+import { defaultString } from "./defaultString";
+import { getLength } from "./getLength";
+import { repeat } from "./repeat";
+export function leftPad(text, size, pad) {
+  if (size === undefined || size <= 0) {
+    return text;
+  }
+  var textLength = getLength(text);
+  var needLength = size - textLength;
+  if (needLength <= 0) {
+    return text;
+  }
+  var padding = defaultIfBlank(pad, ' ');
+  var padLength = getLength(padding);
+  var quotient = Math.floor(needLength / padLength);
+  var remainder = needLength % padLength;
+  var result = '';
+  if (quotient > 0) {
+    result = result.concat(repeat(padding, quotient));
+  }
+  if (remainder > 0) {
+    result = result.concat(padding.substring(0, remainder));
+  }
+  return result.concat(defaultString(text));
+}

package/dist/esm/util/StringUtils/prependIfMissing.d.ts

@@ -0,0 +1 @@
+export declare function prependIfMissing(text?: string | null, prefix?: string): string | null | undefined;

package/dist/esm/util/StringUtils/prependIfMissing.js

@@ -0,0 +1,4 @@
+import { startsWith } from "./startsWith";
+export function prependIfMissing(text, prefix) {
+  return !text || !prefix || startsWith(text, prefix) ? text : prefix + text;
+}