cafe-utility 4.10.0 → 4.11.0

package/index.d.ts

@@ -145,6 +145,14 @@ declare function shrinkTrim(string: string): string;
 declare function capitalize(string: string): string;
 declare function decapitalize(string: string): string;
 declare function csvEscape(string: string): string;
+declare function findWeightedPair(string: string, start?: number, opening?: string, closing?: string): number;
+interface BlockExtractionOptions {
+    start?: number;
+    opening: string;
+    closing: string;
+    exclusive?: boolean;
+}
+declare function extractBlock(string: string, options: BlockExtractionOptions): string | null;
 declare function parseCsv(string: string, delimiter?: string, quote?: string): string[];
 declare function humanizeProgress(state: Progress): string;
 declare function waitFor(predicate: () => Promise<boolean>, waitLength: number, maxWaits: number): Promise<boolean>;
@@ -487,6 +495,8 @@ export declare const Strings: {
     slugToTitle: typeof slugToTitle;
     slugToCamel: typeof slugToCamel;
     joinHumanly: typeof joinHumanly;
+    findWeightedPair: typeof findWeightedPair;
+    extractBlock: typeof extractBlock;
 };
 export declare const Assertions: {
     asEqual: typeof asEqual;

package/index.js

@@ -931,6 +931,33 @@ function csvEscape(string) {
     return string.match(/"|,/) ? `"${string.replace(/"/g, '""')}"` : string
 }
 
+function findWeightedPair(string, start = 0, opening = '{', closing = '}') {
+    let weight = 1
+    for (let i = start; i < string.length; i++) {
+        if (string[i] === opening) {
+            weight++
+        } else if (string[i] === closing) {
+            if (--weight === 0) {
+                return i
+            }
+        }
+    }
+    return -1
+}
+
+function extractBlock(string, options) {
+    const opensAt = string.indexOf(options.opening, options.start || 0)
+    if (opensAt === -1) {
+        return null
+    }
+    const closesAt = findWeightedPair(string, opensAt + 1, options.opening, options.closing)
+    return closesAt === -1
+        ? null
+        : options.exclusive
+        ? string.slice(opensAt + 1, closesAt)
+        : string.slice(opensAt, closesAt + 1)
+}
+
 function parseCsv(string, delimiter = ',', quote = '"') {
     const items = []
     let buffer = ''
@@ -1930,7 +1957,9 @@ exports.Strings = {
     camelToTitle,
     slugToTitle,
     slugToCamel,
-    joinHumanly
+    joinHumanly,
+    findWeightedPair,
+    extractBlock
 }
 
 exports.Assertions = {

package/package.json

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