@cellaware/utils 7.2.3 → 7.2.5

package/dist/util.d.ts

@@ -10,3 +10,19 @@ export declare function getCurrentDayInMonth(timeZone?: string): number;
 export declare function getDaysInYear(timeZone?: string): 366 | 365;
 export declare function getCurrentMonth(timeZone?: string): number;
 export declare function getCurrentYear(timeZone?: string): number;
+/**
+ * NOTE: `stopIdx` represents last character index of word
+ *      ex: ABC -> `startIdx`: 0 `stopIdx`: 2
+ */
+export interface QueryRegexMatch {
+    word: string;
+    startIdx: number;
+    stopIdx: number;
+}
+/**
+ * Will only return matches that **are not** contained in single quotes,
+ * double quotes, single line, or multiline comments.
+ */
+export declare function getQueryMatches(query: string, regex: RegExp): QueryRegexMatch[];
+export declare function removeQueryMatches(query: string, matches: QueryRegexMatch[]): string;
+export declare function replaceQueryMatches(query: string, matches: QueryRegexMatch[], replacement: string): string;

package/dist/util.js

@@ -1,3 +1,4 @@
+// Miscellaneous  --------------------------------------------------------------------------
 export async function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
@@ -22,6 +23,7 @@ export function removePrefixIndicators(input, prefixes) {
     }
     return output;
 }
+// Dates  --------------------------------------------------------------------------
 export function initDate(timeZone) {
     const date = new Date();
     if (!!timeZone) {
@@ -70,3 +72,141 @@ export function getCurrentYear(timeZone) {
     let date = initDate(timeZone);
     return date.getFullYear();
 }
+/**
+ * Will only return matches that **are not** contained in single quotes,
+ * double quotes, single line, or multiline comments.
+ */
+export function getQueryMatches(query, regex) {
+    let matches = [];
+    // Find quote ranges first.
+    let singleQuoteRanges = [];
+    {
+        let open = false;
+        let startIdx = -1;
+        for (let i = 0; i < query.length; i++) {
+            if (query[i] === "'") {
+                if (open) {
+                    singleQuoteRanges.push({ startIdx, stopIdx: i });
+                }
+                else {
+                    startIdx = i;
+                }
+                open = !open;
+            }
+        }
+    }
+    let doubleQuoteRanges = [];
+    {
+        let open = false;
+        let startIdx = -1;
+        for (let i = 0; i < query.length; i++) {
+            if (query[i] === '"') {
+                if (open) {
+                    doubleQuoteRanges.push({ startIdx, stopIdx: i });
+                }
+                else {
+                    startIdx = i;
+                }
+                open = !open;
+            }
+        }
+    }
+    let singleLineCommentRanges = [];
+    {
+        let open = false;
+        let startIdx = -1;
+        for (let i = 0; i < query.length; i++) {
+            if (!open && query[i] === '-' && (i < query.length - 1 && query[i + 1] === '-')) {
+                open = true;
+                startIdx = i;
+            }
+            else if (open && (query[i] === '\n' || query[i] === '\r')) {
+                open = false;
+                singleLineCommentRanges.push({ startIdx, stopIdx: i });
+            }
+        }
+    }
+    let multilineCommentRanges = [];
+    {
+        let open = false;
+        let startIdx = -1;
+        for (let i = 0; i < query.length; i++) {
+            if (!open && query[i] === '/' && (i < query.length - 1 && query[i + 1] === '*')) {
+                open = true;
+                startIdx = i;
+            }
+            else if (open && query[i] === '/' && (i > 0 && query[i - 1] === '*')) {
+                open = false;
+                multilineCommentRanges.push({ startIdx, stopIdx: i });
+            }
+        }
+    }
+    // Now find matches and filter out the ones that are contained in quotes.
+    {
+        let match;
+        while ((match = regex.exec(query)) != null) {
+            let startIdx = match.index;
+            let stopIdx = match.index + match[0].length - 1;
+            let contained = false;
+            for (const quoteRange of singleQuoteRanges) {
+                if (quoteRange.startIdx <= startIdx && quoteRange.stopIdx >= stopIdx) {
+                    contained = true;
+                    break;
+                }
+            }
+            if (!contained) {
+                for (const quoteRange of doubleQuoteRanges) {
+                    if (quoteRange.startIdx <= startIdx && quoteRange.stopIdx >= stopIdx) {
+                        contained = true;
+                        break;
+                    }
+                }
+            }
+            if (!contained) {
+                for (const singleLineCommentRange of singleLineCommentRanges) {
+                    if (singleLineCommentRange.startIdx <= startIdx && singleLineCommentRange.stopIdx >= stopIdx) {
+                        contained = true;
+                        break;
+                    }
+                }
+            }
+            if (!contained) {
+                for (const multilineCommentRange of multilineCommentRanges) {
+                    if (multilineCommentRange.startIdx <= startIdx && multilineCommentRange.stopIdx >= stopIdx) {
+                        contained = true;
+                        break;
+                    }
+                }
+            }
+            if (!contained) {
+                matches.push({ word: match[0], startIdx, stopIdx });
+            }
+        }
+    }
+    return matches;
+}
+export function removeQueryMatches(query, matches) {
+    let adjQuery = query;
+    let offset = 0;
+    for (const match of matches) {
+        const start = match.startIdx - offset;
+        const stop = match.stopIdx + 1 - offset;
+        adjQuery = adjQuery.substring(0, start) + adjQuery.substring(stop);
+        offset += match.word.length;
+    }
+    return adjQuery;
+}
+export function replaceQueryMatches(query, matches, replacement) {
+    let adjQuery = query;
+    let offset = 0;
+    for (const match of matches) {
+        const start = match.startIdx - offset;
+        const stop = match.stopIdx + 1 - offset;
+        adjQuery =
+            adjQuery.substring(0, start) +
+                replacement +
+                adjQuery.substring(stop);
+        offset += (match.word.length - replacement.length);
+    }
+    return adjQuery;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cellaware/utils",
-    "version": "7.2.3",
+    "version": "7.2.5",
     "description": "Cellaware Utilities for Node.js",
     "author": "Cellaware Technologies",
     "type": "module",