zcw-shared 1.46.2 → 1.47.0

package/dist/functions/data/string/htmlEscape.d.ts

@@ -0,0 +1,20 @@
+export type EscapeDirection = 'escape' | 'unescape' | 'both';
+export interface EscapeOptions {
+    direction?: EscapeDirection;
+}
+export interface EscapeResult {
+    original: string;
+    escaped: string;
+    unescaped: string;
+    direction: EscapeDirection;
+    hasHtmlChars: boolean;
+    hasHtmlEntities: boolean;
+}
+export declare function escapeHtml(str: string): string;
+export declare function unescapeHtml(str: string): string;
+export declare function htmlEscape(str: string, options?: EscapeOptions, returnDetails?: boolean): string | EscapeResult;
+export declare function needsEscape(str: string): boolean;
+export declare function hasEntities(str: string): boolean;
+export declare function smartEscape(str: string): string;
+export declare function escape(str: string): string;
+export declare function unescape(str: string): string;

package/dist/functions/data/string/htmlEscape.js

@@ -0,0 +1,80 @@
+const HTML_ESCAPES = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;'
+};
+const HTML_UNESCAPES = {
+    '&amp;': '&',
+    '&lt;': '<',
+    '&gt;': '>',
+    '&quot;': '"',
+    '&#39;': "'"
+};
+const HTML_CHARS_REGEX = /[&<>"']/g;
+const HTML_ENTITIES_REGEX = /&(?:amp|lt|gt|quot|#39);/g;
+const HTML_CHARS_TEST_REGEX = /[&<>"']/;
+const HTML_ENTITIES_TEST_REGEX = /&(?:amp|lt|gt|quot|#39);/;
+export function escapeHtml(str) {
+    return str.replace(HTML_CHARS_REGEX, (match) => HTML_ESCAPES[match]);
+}
+export function unescapeHtml(str) {
+    return str.replace(HTML_ENTITIES_REGEX, (match) => HTML_UNESCAPES[match]);
+}
+export function htmlEscape(str, options = {}, returnDetails = false) {
+    const { direction = 'escape' } = options;
+    if (!str) {
+        if (returnDetails) {
+            return {
+                original: str,
+                escaped: str,
+                unescaped: str,
+                direction,
+                hasHtmlChars: false,
+                hasHtmlEntities: false
+            };
+        }
+        return str;
+    }
+    const escaped = escapeHtml(str);
+    const unescaped = unescapeHtml(str);
+    const hasHtmlChars = HTML_CHARS_TEST_REGEX.test(str);
+    const hasHtmlEntities = HTML_ENTITIES_TEST_REGEX.test(str);
+    if (returnDetails) {
+        return {
+            original: str,
+            escaped,
+            unescaped,
+            direction,
+            hasHtmlChars,
+            hasHtmlEntities
+        };
+    }
+    switch (direction) {
+        case 'escape':
+            return escaped;
+        case 'unescape':
+            return unescaped;
+        case 'both':
+            return hasHtmlEntities ? unescaped : escaped;
+        default:
+            throw new Error(`Invalid escape direction: ${direction}`);
+    }
+}
+export function needsEscape(str) {
+    return HTML_CHARS_TEST_REGEX.test(str);
+}
+export function hasEntities(str) {
+    return HTML_ENTITIES_TEST_REGEX.test(str);
+}
+export function smartEscape(str) {
+    return hasEntities(str) ? unescapeHtml(str) : escapeHtml(str);
+}
+export function escape(str) {
+    return escapeHtml(str);
+}
+export function unescape(str) {
+    return unescapeHtml(str);
+}
+//# sourceMappingURL=htmlEscape.js.map

package/dist/functions/data/string/htmlEscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlEscape.js","sourceRoot":"","sources":["../../../../src/functions/data/string/htmlEscape.ts"],"names":[],"mappings":"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"}

package/dist/functions/data/string/levenshtein.d.ts

@@ -0,0 +1 @@
+export declare function levenshtein(str1: string, str2: string): number;

package/dist/functions/data/string/levenshtein.js

@@ -0,0 +1,27 @@
+export function levenshtein(str1, str2) {
+    if (str1 === str2)
+        return 0;
+    if (str1.length === 0)
+        return str2.length;
+    if (str2.length === 0)
+        return str1.length;
+    const matrix = [];
+    for (let i = 0; i <= str2.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= str1.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= str2.length; i++) {
+        for (let j = 1; j <= str1.length; j++) {
+            if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+            }
+        }
+    }
+    return matrix[str2.length][str1.length];
+}
+//# sourceMappingURL=levenshtein.js.map

package/dist/functions/data/string/levenshtein.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein.js","sourceRoot":"","sources":["../../../../src/functions/data/string/levenshtein.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,CAAA;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAA;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAA;IAEzC,MAAM,MAAM,GAAe,EAAE,CAAA;IAG7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;IAGD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YACrC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACrB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EACxB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EACpB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CACrB,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AACzC,CAAC"}

package/dist/functions/data/string/normalize.d.ts

@@ -0,0 +1,8 @@
+export declare function normalize(str: string, options?: {
+    case?: 'lower' | 'upper' | 'title' | 'none';
+    trim?: boolean;
+    removeSpecial?: boolean;
+    removeNumbers?: boolean;
+    removePunctuation?: boolean;
+    normalizeWhitespace?: boolean;
+}): string;

package/dist/functions/data/string/normalize.js

@@ -0,0 +1,37 @@
+export function normalize(str, options = {}) {
+    if (!str || typeof str !== 'string')
+        return str;
+    const { case: caseOption = 'none', trim = true, removeSpecial = false, removeNumbers = false, removePunctuation = false, normalizeWhitespace = true } = options;
+    let result = str;
+    if (removeSpecial) {
+        result = result.replace(/[^\w\s]/g, '');
+    }
+    if (removeNumbers) {
+        result = result.replace(/\d/g, '');
+    }
+    if (removePunctuation) {
+        result = result.replace(/[^\w\s]/g, '');
+    }
+    if (normalizeWhitespace) {
+        result = result.replace(/\s+/g, ' ');
+    }
+    if (trim) {
+        result = result.trim();
+    }
+    switch (caseOption) {
+        case 'lower':
+            result = result.toLowerCase();
+            break;
+        case 'upper':
+            result = result.toUpperCase();
+            break;
+        case 'title':
+            result = result.toLowerCase().replace(/\b\w/g, (char) => char.toUpperCase());
+            break;
+        case 'none':
+        default:
+            break;
+    }
+    return result;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/functions/data/string/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../../src/functions/data/string/normalize.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,UAOI,EAAE;IAEN,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IAE/C,MAAM,EACJ,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,IAAI,GAAG,IAAI,EACX,aAAa,GAAG,KAAK,EACrB,aAAa,GAAG,KAAK,EACrB,iBAAiB,GAAG,KAAK,EACzB,mBAAmB,GAAG,IAAI,EAC3B,GAAG,OAAO,CAAA;IAEX,IAAI,MAAM,GAAG,GAAG,CAAA;IAGhB,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IACzC,CAAC;IAGD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACpC,CAAC;IAGD,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IACzC,CAAC;IAGD,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtC,CAAC;IAGD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAGD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,OAAO;YACV,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;YAC7B,MAAK;QACP,KAAK,OAAO;YACV,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;YAC7B,MAAK;QACP,KAAK,OAAO;YACV,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YAC5E,MAAK;QACP,KAAK,MAAM,CAAC;QACZ;YACE,MAAK;IACT,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/data/string/pad.d.ts

@@ -0,0 +1,13 @@
+export type PadDirection = 'start' | 'end' | 'both';
+export interface PadOptions {
+    direction?: PadDirection;
+    padString?: string;
+}
+export interface PadResult {
+    original: string;
+    padded: string;
+    paddedLength: number;
+    padDirection: PadDirection;
+    padCharacter: string;
+}
+export declare function pad(str: string, targetLength: number, options?: PadOptions, returnDetails?: boolean): string | PadResult;

package/dist/functions/data/string/pad.js

@@ -0,0 +1,50 @@
+export function pad(str, targetLength, options = {}, returnDetails = false) {
+    const { direction = 'end', padString = ' ' } = options;
+    if (str.length >= targetLength) {
+        if (returnDetails) {
+            return {
+                original: str,
+                padded: str,
+                paddedLength: str.length,
+                padDirection: direction,
+                padCharacter: padString
+            };
+        }
+        return str;
+    }
+    const padLength = targetLength - str.length;
+    let padded;
+    switch (direction) {
+        case 'start': {
+            const pad = padString.repeat(Math.ceil(padLength / padString.length)).slice(0, padLength);
+            padded = pad + str;
+            break;
+        }
+        case 'end': {
+            const pad = padString.repeat(Math.ceil(padLength / padString.length)).slice(0, padLength);
+            padded = str + pad;
+            break;
+        }
+        case 'both': {
+            const leftPadLength = Math.floor(padLength / 2);
+            const rightPadLength = padLength - leftPadLength;
+            const leftPad = padString.repeat(Math.ceil(leftPadLength / padString.length)).slice(0, leftPadLength);
+            const rightPad = padString.repeat(Math.ceil(rightPadLength / padString.length)).slice(0, rightPadLength);
+            padded = leftPad + str + rightPad;
+            break;
+        }
+        default:
+            throw new Error(`Invalid pad direction: ${direction}`);
+    }
+    if (returnDetails) {
+        return {
+            original: str,
+            padded,
+            paddedLength: padded.length,
+            padDirection: direction,
+            padCharacter: padString
+        };
+    }
+    return padded;
+}
+//# sourceMappingURL=pad.js.map

package/dist/functions/data/string/pad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pad.js","sourceRoot":"","sources":["../../../../src/functions/data/string/pad.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,GAAG,CACjB,GAAW,EACX,YAAoB,EACpB,UAAsB,EAAE,EACxB,gBAAyB,KAAK;IAE9B,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,OAAO,CAAA;IAGtD,IAAI,GAAG,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO;gBACL,QAAQ,EAAE,GAAG;gBACb,MAAM,EAAE,GAAG;gBACX,YAAY,EAAE,GAAG,CAAC,MAAM;gBACxB,YAAY,EAAE,SAAS;gBACvB,YAAY,EAAE,SAAS;aACxB,CAAA;QACH,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,GAAG,GAAG,CAAC,MAAM,CAAA;IAC3C,IAAI,MAAc,CAAA;IAElB,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;YACzF,MAAM,GAAG,GAAG,GAAG,GAAG,CAAA;YAClB,MAAK;QACP,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;YACzF,MAAM,GAAG,GAAG,GAAG,GAAG,CAAA;YAClB,MAAK;QACP,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAA;YAC/C,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,CAAA;YAEhD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAA;YACrG,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;YAExG,MAAM,GAAG,OAAO,GAAG,GAAG,GAAG,QAAQ,CAAA;YACjC,MAAK;QACP,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,GAAG;YACb,MAAM;YACN,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,YAAY,EAAE,SAAS;YACvB,YAAY,EAAE,SAAS;SACxB,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/data/string/palindrome.d.ts

@@ -0,0 +1,3 @@
+export declare function palindrome(str: string, options?: {
+    strict?: boolean;
+}): boolean;

package/dist/functions/data/string/palindrome.js

@@ -0,0 +1,15 @@
+export function palindrome(str, options = {}) {
+    if (!str || typeof str !== 'string')
+        return true;
+    const { strict = false } = options;
+    if (strict) {
+        return str === str.split('').reverse().join('');
+    }
+    const cleaned = str
+        .toLowerCase()
+        .replace(/[\s\p{P}]/gu, '');
+    if (cleaned.length <= 1)
+        return true;
+    return cleaned === cleaned.split('').reverse().join('');
+}
+//# sourceMappingURL=palindrome.js.map

package/dist/functions/data/string/palindrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palindrome.js","sourceRoot":"","sources":["../../../../src/functions/data/string/palindrome.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,UAEI,EAAE;IAEN,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAEhD,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAElC,IAAI,MAAM,EAAE,CAAC;QAEX,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjD,CAAC;IAGD,MAAM,OAAO,GAAG,GAAG;SAChB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;IAE7B,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAEpC,OAAO,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACzD,CAAC"}

package/dist/functions/data/string/similarity.d.ts

@@ -0,0 +1 @@
+export declare function similarity(str1: string, str2: string): number;

package/dist/functions/data/string/similarity.js

@@ -0,0 +1,13 @@
+import { levenshtein } from './levenshtein';
+export function similarity(str1, str2) {
+    if (str1 === str2)
+        return 1;
+    if (str1.length === 0 && str2.length === 0)
+        return 1;
+    if (str1.length === 0 || str2.length === 0)
+        return 0;
+    const distance = levenshtein(str1, str2);
+    const maxLength = Math.max(str1.length, str2.length);
+    return 1 - distance / maxLength;
+}
+//# sourceMappingURL=similarity.js.map

package/dist/functions/data/string/similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.js","sourceRoot":"","sources":["../../../../src/functions/data/string/similarity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAe3C,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACnD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,CAAA;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAEpD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAEpD,OAAO,CAAC,GAAG,QAAQ,GAAG,SAAS,CAAA;AACjC,CAAC"}

package/dist/functions/data/string/template.d.ts

@@ -0,0 +1,4 @@
+export declare function template(template: string, data: Record<string, any>, options?: {
+    placeholder?: string;
+    defaultValue?: string;
+}): string;

package/dist/functions/data/string/template.js

@@ -0,0 +1,21 @@
+export function template(template, data, options = {}) {
+    if (!template || typeof template !== 'string')
+        return template;
+    const { placeholder = /{{([^}]+)}}/g, defaultValue = '' } = options;
+    return template.replace(placeholder, (match, key) => {
+        const keys = key.trim().split('.');
+        let value = data;
+        for (const k of keys) {
+            if (value == null)
+                return defaultValue;
+            if (k === 'length' && Array.isArray(value)) {
+                value = value.length;
+            }
+            else {
+                value = value[k];
+            }
+        }
+        return value != null ? String(value) : defaultValue;
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/functions/data/string/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/functions/data/string/template.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,QAAQ,CACtB,QAAgB,EAChB,IAAyB,EACzB,UAGI,EAAE;IAEN,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE9D,MAAM,EAAE,WAAW,GAAG,cAAc,EAAE,YAAY,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;IAEnE,OAAO,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,KAAK,GAAQ,IAAI,CAAA;QAErB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,YAAY,CAAA;YAEtC,IAAI,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;YACtB,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAClB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/functions/data/string/testRegex.d.ts

@@ -0,0 +1,20 @@
+export interface VisualizationStep {
+    stepNumber: number;
+    textPos: number;
+    patternPos: number;
+    action: string;
+    status: 'trying' | 'success' | 'fail' | 'backtrack';
+    matched: string;
+    explanation: string;
+    currentChar?: string;
+    currentPattern?: string;
+}
+export interface RegexMatchResult {
+    hasMatch: boolean;
+    matchedText: string;
+    matchIndex: number;
+    matchEndIndex: number;
+    steps: VisualizationStep[];
+    error?: string;
+}
+export declare function testRegex(pattern: string, text: string): RegexMatchResult;

package/dist/functions/data/string/testRegex.js

@@ -0,0 +1,300 @@
+function charMatches(pattern, pos, char) {
+    if (pattern[pos] === '\\' && pos + 1 < pattern.length) {
+        const next = pattern[pos + 1];
+        const escapeMap = {
+            'd': [c => /[0-9]/.test(c), '数字 0-9'],
+            'D': [c => /[^0-9]/.test(c), '非数字'],
+            'w': [c => /[a-zA-Z0-9_]/.test(c), '单词字符 a-zA-Z0-9_'],
+            'W': [c => /[^a-zA-Z0-9_]/.test(c), '非单词字符'],
+            's': [c => /\s/.test(c), '空白字符'],
+            'S': [c => /\S/.test(c), '非空白字符'],
+        };
+        if (escapeMap[next]) {
+            const [matcher, desc] = escapeMap[next];
+            return {
+                matches: matcher(char),
+                patternLen: 2,
+                desc: `\\${next} (${desc})`
+            };
+        }
+        return {
+            matches: char === next,
+            patternLen: 2,
+            desc: `\\${next}`
+        };
+    }
+    if (pattern[pos] === '[') {
+        let end = pos + 1;
+        while (end < pattern.length && pattern[end] !== ']') {
+            if (pattern[end] === '\\')
+                end++;
+            end++;
+        }
+        const charset = pattern.substring(pos, end + 1);
+        const isNegated = pattern[pos + 1] === '^';
+        const chars = charset.substring(isNegated ? 2 : 1, charset.length - 1);
+        let matches = false;
+        for (let i = 0; i < chars.length; i++) {
+            if (chars[i + 1] === '-' && i + 2 < chars.length) {
+                const code = char.charCodeAt(0);
+                if (code >= chars.charCodeAt(i) && code <= chars.charCodeAt(i + 2)) {
+                    matches = true;
+                    break;
+                }
+                i += 2;
+            }
+            else if (chars[i] === char) {
+                matches = true;
+                break;
+            }
+        }
+        return {
+            matches: isNegated ? !matches : matches,
+            patternLen: end - pos + 1,
+            desc: charset
+        };
+    }
+    if (pattern[pos] === '.') {
+        return {
+            matches: char !== '\n',
+            patternLen: 1,
+            desc: '. (任意字符)'
+        };
+    }
+    return {
+        matches: char === pattern[pos],
+        patternLen: 1,
+        desc: `'${pattern[pos]}'`
+    };
+}
+function getQuantifier(pattern, pos) {
+    if (pos >= pattern.length)
+        return null;
+    const char = pattern[pos];
+    if (char === '*')
+        return { min: 0, max: Infinity, len: 1 };
+    if (char === '+')
+        return { min: 1, max: Infinity, len: 1 };
+    if (char === '?')
+        return { min: 0, max: 1, len: 1 };
+    if (char === '{') {
+        let end = pos + 1;
+        while (end < pattern.length && pattern[end] !== '}')
+            end++;
+        const nums = pattern.substring(pos + 1, end).split(',');
+        const min = parseInt(nums[0]);
+        const max = nums[1] ? parseInt(nums[1]) : min;
+        return { min, max, len: end - pos + 1 };
+    }
+    return null;
+}
+function matchRecursive(text, textPos, pattern, patternPos, matched, steps, stepNum, maxSteps) {
+    if (steps.length >= maxSteps)
+        return false;
+    if (patternPos >= pattern.length) {
+        steps.push({
+            stepNumber: stepNum.value++,
+            textPos,
+            patternPos,
+            action: '匹配完成',
+            status: 'success',
+            matched,
+            explanation: `正则表达式已全部匹配完成，匹配结果: "${matched}"`
+        });
+        return true;
+    }
+    const charMatchResult = charMatches(pattern, patternPos, textPos < text.length ? text[textPos] : '');
+    const quantifier = getQuantifier(pattern, patternPos + charMatchResult.patternLen);
+    if (quantifier) {
+        const { min, max, len } = quantifier;
+        const nextPatternPos = patternPos + charMatchResult.patternLen + len;
+        const quantSymbol = pattern.substring(patternPos + charMatchResult.patternLen, nextPatternPos);
+        steps.push({
+            stepNumber: stepNum.value++,
+            textPos,
+            patternPos,
+            action: `处理量词 ${quantSymbol}`,
+            status: 'trying',
+            matched,
+            currentPattern: pattern.substring(patternPos, nextPatternPos),
+            explanation: `模式 ${charMatchResult.desc} 后跟量词 ${quantSymbol}，要求匹配 ${min} 到 ${max === Infinity ? '无限' : max} 次`
+        });
+        let count = 0;
+        let tempTextPos = textPos;
+        const matchedChars = [];
+        while (count < max && tempTextPos < text.length) {
+            const currentChar = text[tempTextPos];
+            const checkResult = charMatches(pattern, patternPos, currentChar);
+            if (checkResult.matches) {
+                matchedChars.push(currentChar);
+                count++;
+                tempTextPos++;
+                steps.push({
+                    stepNumber: stepNum.value++,
+                    textPos: tempTextPos,
+                    patternPos,
+                    action: `量词匹配第 ${count} 次`,
+                    status: 'success',
+                    matched: matched + matchedChars.join(''),
+                    currentChar,
+                    currentPattern: charMatchResult.desc,
+                    explanation: `字符 "${currentChar}" 符合 ${charMatchResult.desc}，量词已匹配 ${count} 次`
+                });
+            }
+            else {
+                break;
+            }
+        }
+        if (count < min) {
+            steps.push({
+                stepNumber: stepNum.value++,
+                textPos,
+                patternPos,
+                action: '量词不满足',
+                status: 'fail',
+                matched,
+                explanation: `量词 ${quantSymbol} 要求至少 ${min} 次，但只匹配了 ${count} 次，回溯`
+            });
+            return false;
+        }
+        for (let tryCount = count; tryCount >= min; tryCount--) {
+            if (tryCount < count) {
+                steps.push({
+                    stepNumber: stepNum.value++,
+                    textPos: textPos + tryCount,
+                    patternPos: nextPatternPos,
+                    action: '回溯',
+                    status: 'backtrack',
+                    matched: matched + matchedChars.slice(0, tryCount).join(''),
+                    explanation: `量词贪婪匹配 ${count} 次后续失败，回溯到 ${tryCount} 次重新尝试`
+                });
+            }
+            const newMatched = matched + matchedChars.slice(0, tryCount).join('');
+            const newTextPos = textPos + tryCount;
+            if (matchRecursive(text, newTextPos, pattern, nextPatternPos, newMatched, steps, stepNum, maxSteps)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    else {
+        if (textPos >= text.length) {
+            steps.push({
+                stepNumber: stepNum.value++,
+                textPos,
+                patternPos,
+                action: '文本结束',
+                status: 'fail',
+                matched,
+                explanation: `文本已结束，但正则还未匹配完，失败`
+            });
+            return false;
+        }
+        const currentChar = text[textPos];
+        steps.push({
+            stepNumber: stepNum.value++,
+            textPos,
+            patternPos,
+            action: '检查字符',
+            status: 'trying',
+            matched,
+            currentChar,
+            currentPattern: charMatchResult.desc,
+            explanation: `在文本位置 ${textPos} 检查字符 "${currentChar}" 是否匹配 ${charMatchResult.desc}`
+        });
+        if (charMatchResult.matches) {
+            steps.push({
+                stepNumber: stepNum.value++,
+                textPos: textPos + 1,
+                patternPos: patternPos + charMatchResult.patternLen,
+                action: '字符匹配',
+                status: 'success',
+                matched: matched + currentChar,
+                currentChar,
+                explanation: `字符 "${currentChar}" 匹配成功`
+            });
+            return matchRecursive(text, textPos + 1, pattern, patternPos + charMatchResult.patternLen, matched + currentChar, steps, stepNum, maxSteps);
+        }
+        else {
+            steps.push({
+                stepNumber: stepNum.value++,
+                textPos,
+                patternPos,
+                action: '字符不匹配',
+                status: 'fail',
+                matched,
+                currentChar,
+                explanation: `字符 "${currentChar}" 不符合 ${charMatchResult.desc}，匹配失败`
+            });
+            return false;
+        }
+    }
+}
+export function testRegex(pattern, text) {
+    const steps = [];
+    const stepNum = { value: 0 };
+    const maxSteps = 200;
+    try {
+        steps.push({
+            stepNumber: stepNum.value++,
+            textPos: 0,
+            patternPos: 0,
+            action: '开始匹配',
+            status: 'trying',
+            matched: '',
+            explanation: `开始在文本 "${text}" 中搜索模式 /${pattern}/`
+        });
+        for (let i = 0; i < text.length; i++) {
+            steps.push({
+                stepNumber: stepNum.value++,
+                textPos: i,
+                patternPos: 0,
+                action: `尝试起始位置 ${i}`,
+                status: 'trying',
+                matched: '',
+                currentChar: text[i],
+                explanation: `从文本位置 ${i} (字符 "${text[i]}") 开始尝试匹配`
+            });
+            if (matchRecursive(text, i, pattern, 0, '', steps, stepNum, maxSteps)) {
+                const lastStep = steps[steps.length - 1];
+                return {
+                    hasMatch: true,
+                    matchedText: lastStep.matched,
+                    matchIndex: i,
+                    matchEndIndex: i + lastStep.matched.length,
+                    steps
+                };
+            }
+            steps.push({
+                stepNumber: stepNum.value++,
+                textPos: i,
+                patternPos: 0,
+                action: '本次尝试失败',
+                status: 'fail',
+                matched: '',
+                explanation: `从位置 ${i} 开始匹配失败，继续尝试下一位置`
+            });
+            if (steps.length >= maxSteps) {
+                break;
+            }
+        }
+        return {
+            hasMatch: false,
+            matchedText: '',
+            matchIndex: -1,
+            matchEndIndex: -1,
+            steps
+        };
+    }
+    catch (error) {
+        return {
+            hasMatch: false,
+            matchedText: '',
+            matchIndex: -1,
+            matchEndIndex: -1,
+            steps,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+//# sourceMappingURL=testRegex.js.map