cafe-utility 6.6.0 → 6.8.0

package/index.d.ts

@@ -128,6 +128,7 @@ declare function decapitalize(string: string): string;
 declare function isLetter(character: string): boolean;
 declare function isDigit(character: string): boolean;
 declare function isLetterOrDigit(character: string): boolean;
+declare function isValidObjectPathCharacter(character: string): boolean;
 declare function insertString(string: string, index: number, length: number, before: string, after: string): string;
 declare function linesMatchOrdered(lines: string[], expectedLines: string[]): boolean;
 declare function csvEscape(string: string): string;
@@ -143,6 +144,8 @@ interface BlockExtractionOptions {
 declare function extractBlock(string: string, options: BlockExtractionOptions): string | null;
 declare function extractAllBlocks(string: string, options: BlockExtractionOptions): string[];
 declare function parseHtmlAttributes(string: string): Record<string, string>;
+declare function resolveHtmlAttribute(string: string, key: string, value: string, prefix?: string): string;
+declare function replaceUnresolvedHtmlAttributesWithDefaults(string: string, prefix?: string, separator?: string): string;
 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>;
@@ -489,9 +492,12 @@ export declare const Strings: {
     extractAllBlocks: typeof extractAllBlocks;
     indexOfEarliest: typeof indexOfEarliest;
     parseHtmlAttributes: typeof parseHtmlAttributes;
+    resolveHtmlAttribute: typeof resolveHtmlAttribute;
+    replaceUnresolvedHtmlAttributesWithDefaults: typeof replaceUnresolvedHtmlAttributesWithDefaults;
     isLetter: typeof isLetter;
     isDigit: typeof isDigit;
     isLetterOrDigit: typeof isLetterOrDigit;
+    isValidObjectPathCharacter: typeof isValidObjectPathCharacter;
     insert: typeof insertString;
     linesMatchOrdered: typeof linesMatchOrdered;
     represent: typeof represent;

package/index.js

@@ -872,6 +872,12 @@ function isLetterOrDigit(character) {
     return isLetter(character) || isDigit(character)
 }
 
+function isValidObjectPathCharacter(character) {
+    return (
+        isLetterOrDigit(character) || character === '.' || character === '[' || character === ']' || character === '_'
+    )
+}
+
 function insertString(string, index, length, before, after) {
     return string.slice(0, index) + before + string.slice(index, index + length) + after + string.slice(index + length)
 }
@@ -970,6 +976,25 @@ function parseHtmlAttributes(string) {
     return attributes
 }
 
+function resolveHtmlAttribute(string, key, value, prefix = '$') {
+    const blocks = extractAllBlocks(string, { opening: `="${prefix}${key}`, closing: '"' })
+    const set = new Set(blocks)
+    for (const block of set) {
+        string = string.replace(block, `="${value}"`)
+    }
+    return string
+}
+
+function replaceUnresolvedHtmlAttributesWithDefaults(string, prefix = '$', separator = ':') {
+    const blocks = extractAllBlocks(string, { opening: `="${prefix}`, closing: '"' }).filter(x => x.includes(separator))
+    for (const block of blocks) {
+        let [_, value] = block.split(separator)
+        value = value.slice(0, value.length - 1)
+        string = string.replace(block, `="${value}"`)
+    }
+    return string
+}
+
 function parseCsv(string, delimiter = ',', quote = '"') {
     const items = []
     let buffer = ''
@@ -2190,9 +2215,12 @@ exports.Strings = {
     extractAllBlocks,
     indexOfEarliest,
     parseHtmlAttributes,
+    resolveHtmlAttribute,
+    replaceUnresolvedHtmlAttributesWithDefaults,
     isLetter,
     isDigit,
     isLetterOrDigit,
+    isValidObjectPathCharacter,
     insert: insertString,
     linesMatchOrdered,
     represent

package/package.json

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