cafe-utility 18.2.0 → 18.4.0

package/index.d.ts

@@ -84,6 +84,7 @@ declare function asTime(value: any): string;
 declare function asArray(value: any): unknown[];
 declare function asObject(value: any): Record<string, unknown>;
 declare function asNumericDictionary(value: any): Record<string, number>;
+declare function asUrl(value: any): string;
 declare function isNullable(typeFn: (value: any) => boolean, value: any): boolean;
 declare function asNullable<T>(typeFn: (value: any) => T, value: any): T | null;
 declare function enforceObjectShape(value: Record<string, any>, shape: Record<string, (value: any) => boolean>): boolean;
@@ -199,6 +200,11 @@ declare function hashCode(string: string): number;
 declare function replaceWord(string: string, search: string, replace: string, whitespaceOnly?: boolean): string;
 declare function replacePascalCaseWords(string: string, replacer: (word: string) => string): string;
 declare function stripHtml(string: string): string;
+declare function breakLine(string: string): {
+    line: string;
+    rest: string;
+};
+declare function toLines(string: string, maxWidth: number, characterWidths?: Record<string, number>): string[];
 declare function containsWord(string: string, word: string): boolean;
 declare function containsWords(string: string, words: string[], mode: 'any' | 'all'): boolean;
 declare function parseHtmlAttributes(string: string): Record<string, string>;
@@ -618,6 +624,7 @@ export declare const Types: {
     asArray: typeof asArray;
     asObject: typeof asObject;
     asNumericDictionary: typeof asNumericDictionary;
+    asUrl: typeof asUrl;
     asNullable: typeof asNullable;
     enforceObjectShape: typeof enforceObjectShape;
     enforceArrayShape: typeof enforceArrayShape;
@@ -709,6 +716,8 @@ export declare const Strings: {
     replaceWord: typeof replaceWord;
     replacePascalCaseWords: typeof replacePascalCaseWords;
     stripHtml: typeof stripHtml;
+    breakLine: typeof breakLine;
+    toLines: typeof toLines;
 };
 export declare const Assertions: {
     asEqual: typeof asEqual;

package/index.js

@@ -430,6 +430,13 @@ function asNumericDictionary(n) {
     if (!e.every(isString) || !r.every(isNumber)) throw new TypeError('Expected numeric dictionary, got: ' + n)
     return t
 }
+function isUrl(n) {
+    return isString(n) && n.match(/^https?:\/\/.+/) !== null
+}
+function asUrl(n) {
+    if (!isUrl(n)) throw new TypeError('Expected url, got: ' + n)
+    return n
+}
 function isNullable(n, t) {
     return isUndefined(t) || t === null ? !0 : n(t)
 }
@@ -1053,6 +1060,32 @@ function replacePascalCaseWords(n, t) {
 function stripHtml(n) {
     return n.replace(/<[^>]*>/g, '')
 }
+function breakLine(n) {
+    const t = n.lastIndexOf(' ')
+    if (t === -1) return { line: n, rest: '' }
+    const e = n.slice(0, t),
+        r = n.slice(t + 1)
+    return { line: e, rest: r }
+}
+function toLines(n, t, e = {}) {
+    const r = []
+    let o = '',
+        i = 0
+    for (let s = 0; s < n.length; s++) {
+        const c = n[s],
+            u = e[c] || 1
+        if (((o += c), (i += u), i > t)) {
+            const { line: l, rest: f } = breakLine(o)
+            r.push(l),
+                (o = f),
+                (i = f
+                    .split('')
+                    .map(a => e[a] || 1)
+                    .reduce((a, h) => a + h, 0))
+        }
+    }
+    return o && r.push(o), r
+}
 function containsWord(n, t) {
     return new RegExp(`\\b${t}\\b`).test(n)
 }
@@ -2226,6 +2259,7 @@ function raycastCircle(n, t, e) {
         asArray,
         asObject,
         asNumericDictionary,
+        asUrl,
         asNullable,
         enforceObjectShape,
         enforceArrayShape
@@ -2316,7 +2350,9 @@ function raycastCircle(n, t, e) {
         hashCode,
         replaceWord,
         replacePascalCaseWords,
-        stripHtml
+        stripHtml,
+        breakLine,
+        toLines
     }),
     (exports.Assertions = { asEqual, asTrue, asTruthy, asFalse, asFalsy, asEither }),
     (exports.Cache = { get: getCached }),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cafe-utility",
-    "version": "18.2.0",
+    "version": "18.4.0",
     "description": "",
     "main": "index.js",
     "exports": {