cafe-utility 10.13.0 → 10.14.0

package/index.d.ts

@@ -33,7 +33,7 @@ declare function ensureDeep(object: CafeObject, path: string, value: unknown): u
 declare function deleteDeep(object: CafeObject, path: string): void;
 declare function replaceDeep(object: CafeObject, path: string, value: unknown): unknown;
 declare function getFirstDeep(object: CafeObject, paths: string[], fallbackToAnyKey?: boolean): unknown;
-declare function forever(callable: (() => Promise<void>) | (() => void), millis: number): Promise<never>;
+declare function forever(callable: (() => Promise<void>) | (() => void), millis: number, log?: (message: string, metadata: object) => void): Promise<never>;
 declare function asMegabytes(number: number): number;
 declare function convertBytes(bytes: number): string;
 declare function hexToRgb(hex: string): [number, number, number];
@@ -157,6 +157,11 @@ interface BlockExtractionOptions {
 }
 declare function extractBlock(string: string, options: BlockExtractionOptions): string | null;
 declare function extractAllBlocks(string: string, options: BlockExtractionOptions): string[];
+declare type StringSegment = {
+    symbol: string | null;
+    string: string;
+};
+declare function segmentizeString(string: string, symbol: string): StringSegment[];
 declare function parseHtmlAttributes(string: string): Record<string, string>;
 declare function readNextWord(string: string, index: number, allowedCharacters?: string[]): string;
 declare function resolveVariables(string: string, variables: Record<string, string>, prefix?: string, separator?: string): string;
@@ -604,6 +609,7 @@ export declare const Strings: {
     describeMarkdown: typeof describeMarkdown;
     isBalanced: typeof isBalanced;
     textToFormat: typeof textToFormat;
+    segmentize: typeof segmentizeString;
 };
 export declare const Assertions: {
     asEqual: typeof asEqual;

package/index.js

@@ -282,12 +282,14 @@ function getFirstDeep(object, paths, fallbackToAnyKey) {
     return null
 }
 
-async function forever(callable, millis) {
+async function forever(callable, millis, log) {
     while (true) {
         try {
             await callable()
         } catch (error) {
-            console.error('Error in forever:', error)
+            if (log) {
+                log('Error in forever', error)
+            }
         }
         await sleepMillis(millis)
     }
@@ -1104,6 +1106,29 @@ function extractAllBlocks(string, options) {
     }
 }
 
+function segmentizeString(string, symbol) {
+    const segments = []
+    let index = 0
+    while (index < string.length) {
+        const start = string.indexOf(symbol, index)
+        if (start === -1) {
+            segments.push({ string: string.slice(index), symbol: null })
+            break
+        }
+        const end = string.indexOf(symbol, start + symbol.length)
+        if (start > index && end !== -1) {
+            segments.push({ string: string.slice(index, start), symbol: null })
+        }
+        if (end === -1) {
+            segments.push({ string: string.slice(index), symbol: null })
+            break
+        }
+        segments.push({ string: string.slice(start + symbol.length, end), symbol })
+        index = end + symbol.length
+    }
+    return segments
+}
+
 function parseHtmlAttributes(string) {
     const attributes = {}
     const matches = string.match(/([a-z\-]+)="([^"]+)"/g)
@@ -2828,7 +2853,8 @@ exports.Strings = {
     replaceBetweenStrings,
     describeMarkdown,
     isBalanced,
-    textToFormat
+    textToFormat,
+    segmentize: segmentizeString
 }
 
 exports.Assertions = {

package/package.json

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