@futdevpro/fsm-dynamo 1.16.38 → 1.16.39

package/build/_collections/utils/string.util.spec.js

@@ -0,0 +1,860 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const string_util_1 = require("./string.util");
+describe('| DyFM_String', () => {
+    describe('| breakTrim', () => {
+        it('| should remove spaces from the start and end of the string', () => {
+            const result = string_util_1.DyFM_String.breakTrim('  hello world  ');
+            expect(result).toBe('hello world');
+        });
+        it('| should remove newline characters from the start and end of the string', () => {
+            const result = string_util_1.DyFM_String.breakTrim('\nhello world\n');
+            expect(result).toBe('hello world');
+        });
+        it('| should remove carriage return characters from the start and end of the string', () => {
+            const result = string_util_1.DyFM_String.breakTrim('\rhello world\r');
+            expect(result).toBe('hello world');
+        });
+        it('| should remove all types of line breaks from the start and end of the string', () => {
+            const result = string_util_1.DyFM_String.breakTrim('\r\nhello world\r\n');
+            expect(result).toBe('hello world');
+        });
+        it('| should return an empty string if the input is only spaces and line breaks', () => {
+            const result = string_util_1.DyFM_String.breakTrim(' \r\n ');
+            expect(result).toBe('');
+        });
+        it('| should not alter a string that has no spaces or line breaks at the start or end', () => {
+            const result = string_util_1.DyFM_String.breakTrim('hello world');
+            expect(result).toBe('hello world');
+        });
+        it('| should handle an empty string input', () => {
+            const result = string_util_1.DyFM_String.breakTrim('');
+            expect(result).toBe('');
+        });
+    });
+    describe('| nestedBracketSplit', () => {
+        it('| should handle simple bracket extraction with replacement', () => {
+            const input = 'hello (world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
+            expect(result).toEqual(['hello ... test', 'world']);
+        });
+        it('| should handle multiple brackets at the same level', () => {
+            const input = 'start (first) middle (second) end';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
+            expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
+        });
+        it('| should handle nested brackets according to the example', () => {
+            const input = 'asdasd (and other things) around (and layered things (and more layers) around) around';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 2, '...');
+            expect(result).toEqual([
+                'asdasd ... around ... around',
+                'and other things',
+                'and layered things ... around',
+                'and more layers'
+            ]);
+        });
+        it('| should respect maxDepth parameter', () => {
+            const input = 'text (level1 (level2 (level3) level2) level1) text';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 1, '...');
+            expect(result).toEqual([
+                'text ... text',
+                'level1 (level2 (level3) level2) level1'
+            ]);
+        });
+        it('| should handle empty replacement string', () => {
+            const input = 'hello (world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
+            expect(result).toEqual(['hello  test', 'world']);
+        });
+        it('| should handle string with no brackets', () => {
+            const input = 'hello world test';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
+            expect(result).toEqual(['hello world test']);
+        });
+        it('| should handle empty string', () => {
+            const input = '';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
+            expect(result).toEqual(['']);
+        });
+        it('| should handle unmatched opening bracket', () => {
+            const input = 'hello (world test';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
+            expect(result).toEqual(['hello (world test']);
+        });
+        it('| should handle unmatched closing bracket', () => {
+            const input = 'hello world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
+            expect(result).toEqual(['hello world) test']);
+        });
+        it('| should handle custom bracket characters', () => {
+            const input = 'start [first] middle [second] end';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '[', ']', 10, '...');
+            expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
+        });
+        it('| should handle multi-character brackets', () => {
+            const input = 'start {{first}} middle {{second}} end';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '{{', '}}', 10, '...');
+            expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
+        });
+        it('| should handle deeply nested brackets with maxDepth', () => {
+            const input = 'text (a (b (c (d) c) b) a) text';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 3, '...');
+            expect(result).toEqual([
+                'text ... text',
+                'a ... a',
+                'b ... b',
+                'c (d) c'
+            ]);
+        });
+        it('| should handle same character for opening and closing bracket', () => {
+            const input = "start 'first quote' middle 'second quote' end";
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
+            expect(result).toEqual(["start ... middle ... end", 'first quote', 'second quote']);
+        });
+        it('| should handle nested same character brackets', () => {
+            const input = "text 'outer 'inner' outer' text";
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, "'", "'", 2, '...');
+            expect(result).toEqual([
+                'text ... text',
+                'outer ... outer',
+                'inner'
+            ]);
+        });
+        it('| should handle multiple levels of same character brackets', () => {
+            const input = "start 'level1 'level2 'level3' level2' level1' end";
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, "'", "'", 3, '...');
+            expect(result).toEqual([
+                'start ... end',
+                'level1 ... level1',
+                'level2 ... level2',
+                'level3'
+            ]);
+        });
+        it('| should handle empty content between same character brackets', () => {
+            const input = "text '' more text";
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
+            expect(result).toEqual(['text ... more text', '']);
+        });
+        it('| should handle single same character bracket (unmatched)', () => {
+            const input = "text 'unmatched quote";
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
+            expect(result).toEqual(["text 'unmatched quote"]);
+        });
+        it('| should handle alternating same character brackets', () => {
+            const input = "text 'first' normal 'second' normal 'third' text";
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
+            expect(result).toEqual(['text ... normal ... normal ... text', 'first', 'second', 'third']);
+        });
+        it('| should respect maxDepth with same character brackets', () => {
+            const input = "text 'a 'b 'c' b' a' text";
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, "'", "'", 1, '...');
+            expect(result).toEqual([
+                'text ... text',
+                "a 'b 'c' b' a"
+            ]);
+        });
+    });
+    describe('| nestedBracketSplit - replaceContents variations', () => {
+        it('| should handle empty replaceContents (no replacement)', () => {
+            const input = 'hello (world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
+            expect(result).toEqual(['hello  test', 'world']);
+        });
+        it('| should handle undefined replaceContents (no replacement)', () => {
+            const input = 'hello (world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10);
+            expect(result).toEqual(['hello (world) test', 'world']);
+        });
+        it('| should handle multiple brackets with empty replaceContents', () => {
+            const input = 'start (first) middle (second) end';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
+            expect(result).toEqual(['start  middle  end', 'first', 'second']);
+        });
+        it('| should handle nested brackets with empty replaceContents', () => {
+            const input = 'text (outer (inner) outer) text';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 2, '');
+            expect(result).toEqual(['text  text', 'outer  outer', 'inner']);
+        });
+    });
+    describe('| nestedBracketSplitDetailed', () => {
+        it('| should return detailed information for simple nested brackets', () => {
+            const input = 'hello (world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '...');
+            expect(result).toEqual([
+                { content: 'hello ... test', level: 0, brackets: null },
+                { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should handle nested brackets with detailed level information', () => {
+            const input = 'asdasd (and other things) around (and layered things (and more layers) around) around';
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '...');
+            expect(result).toEqual([
+                { content: 'asdasd ... around ... around', level: 0, brackets: null },
+                { content: 'and other things', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'and layered things ... around', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'and more layers', level: 2, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should handle same character brackets with detailed info', () => {
+            const input = "text 'quoted content' end";
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, "'", "'", 10, '...');
+            expect(result).toEqual([
+                { content: 'text ... end', level: 0, brackets: null },
+                { content: 'quoted content', level: 1, brackets: { opening: "'", closing: "'" } }
+            ]);
+        });
+        it('| should respect maxDepth with detailed levels', () => {
+            const input = 'text (a (b (c) b) a) text';
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '...');
+            expect(result).toEqual([
+                { content: 'text ... text', level: 0, brackets: null },
+                { content: 'a ... a', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'b (c) b', level: 2, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should handle no brackets case', () => {
+            const input = 'plain text with no brackets';
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '...');
+            expect(result).toEqual([
+                { content: 'plain text with no brackets', level: 0, brackets: null }
+            ]);
+        });
+        it('| should handle empty replaceContents (no replacement)', () => {
+            const input = 'hello (world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '');
+            expect(result).toEqual([
+                { content: 'hello  test', level: 0, brackets: null },
+                { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should handle undefined replaceContents (no replacement)', () => {
+            const input = 'hello (world) test';
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10);
+            expect(result).toEqual([
+                { content: 'hello (world) test', level: 0, brackets: null },
+                { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should handle nested brackets with empty replaceContents', () => {
+            const input = 'text (outer (inner) outer) text';
+            const result = string_util_1.DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '');
+            expect(result).toEqual([
+                { content: 'text  text', level: 0, brackets: null },
+                { content: 'outer  outer', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'inner', level: 2, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+    });
+    describe('| multiBracketSplit', () => {
+        const standardBrackets = [
+            { opening: '(', closing: ')' },
+            { opening: '[', closing: ']' },
+            { opening: '{', closing: '}' }
+        ];
+        it('| should handle multiple bracket types at the same level', () => {
+            const input = 'text (round) and [square] with {curly} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                'text ... and ... with ... brackets',
+                'round',
+                'square',
+                'curly'
+            ]);
+        });
+        it('| should handle mixed nested brackets according to the example', () => {
+            const input = 'text (round) and [square] with {curly (nested)} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 2, '...');
+            expect(result).toEqual([
+                'text ... and ... with ... brackets',
+                'round',
+                'square',
+                'curly ...',
+                'nested'
+            ]);
+        });
+        it('| should handle deeply nested mixed brackets', () => {
+            const input = 'start {outer [middle (inner) middle] outer} end';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 3, '...');
+            expect(result).toEqual([
+                'start ... end',
+                'outer ... outer',
+                'middle ... middle',
+                'inner'
+            ]);
+        });
+        it('| should respect maxDepth with mixed brackets', () => {
+            const input = 'text {a [b (c) b] a} text';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 1, '...');
+            expect(result).toEqual([
+                'text ... text',
+                'a [b (c) b] a'
+            ]);
+        });
+        it('| should handle empty bracket contents', () => {
+            const input = 'text () and [] with {} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                'text ... and ... with ... brackets',
+                '',
+                '',
+                ''
+            ]);
+        });
+        it('| should handle unmatched brackets gracefully', () => {
+            const input = 'text (unmatched and [incomplete';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
+            expect(result).toEqual(['text (unmatched and [incomplete']);
+        });
+        it('| should handle same character brackets in the array', () => {
+            const quoteBrackets = [
+                { opening: "'", closing: "'" },
+                { opening: '"', closing: '"' }
+            ];
+            const input = "text 'single quoted' and \"double quoted\" content";
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, quoteBrackets, 10, '...');
+            expect(result).toEqual([
+                'text ... and ... content',
+                'single quoted',
+                'double quoted'
+            ]);
+        });
+        it('| should handle multi-character brackets', () => {
+            const customBrackets = [
+                { opening: '{{', closing: '}}' },
+                { opening: '[[', closing: ']]' },
+                { opening: '()', closing: ')(' }
+            ];
+            const input = 'text {{double curly}} and [[double square]] with ()reversed)( brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, customBrackets, 10, '...');
+            expect(result).toEqual([
+                'text ... and ... with ... brackets',
+                'double curly',
+                'double square',
+                'reversed'
+            ]);
+        });
+        it('| should handle complex nesting with different bracket types', () => {
+            const input = 'start (round [square {curly [inner]} square] round) end';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 4, '...');
+            expect(result).toEqual([
+                'start ... end',
+                'round ... round',
+                'square ... square',
+                'curly ...',
+                'inner'
+            ]);
+        });
+        it('| should handle no brackets', () => {
+            const input = 'plain text with no brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
+            expect(result).toEqual(['plain text with no brackets']);
+        });
+        it('| should handle empty string', () => {
+            const input = '';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
+            expect(result).toEqual(['']);
+        });
+        it('| should handle empty brackets array', () => {
+            const input = 'text (with) brackets [but] no {bracket} definitions';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, [], 10, '...');
+            expect(result).toEqual(['text (with) brackets [but] no {bracket} definitions']);
+        });
+        it('| should handle overlapping bracket patterns', () => {
+            const overlappingBrackets = [
+                { opening: '(', closing: ')' },
+                { opening: '((', closing: '))' }
+            ];
+            const input = 'text ((double)) and (single) brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, overlappingBrackets, 10, '...');
+            expect(result).toEqual([
+                'text ... and ... brackets',
+                'double',
+                'single'
+            ]);
+        });
+        it('| should handle brackets with same opening but different closing', () => {
+            const mixedBrackets = [
+                { opening: '<', closing: '>' },
+                { opening: '<', closing: '/>' }
+            ];
+            const input = 'text <tag/> and <content> here';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, mixedBrackets, 10, '...');
+            expect(result).toEqual([
+                'text ... and ... here',
+                'tag',
+                'content'
+            ]);
+        });
+        it('| should maintain proper bracket matching with mixed types', () => {
+            const input = 'text (round [square) wrong] correct';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                'text ... wrong] correct',
+                'round [square'
+            ]);
+        });
+    });
+    describe('| multiBracketSplit - replaceContents variations', () => {
+        const standardBrackets = [
+            { opening: '(', closing: ')' },
+            { opening: '[', closing: ']' },
+            { opening: '{', closing: '}' }
+        ];
+        it('| should handle empty replaceContents (no replacement)', () => {
+            const input = 'text (round) and [square] with {curly} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10, '');
+            expect(result).toEqual([
+                'text  and  with  brackets',
+                'round',
+                'square',
+                'curly'
+            ]);
+        });
+        it('| should handle undefined replaceContents (no replacement)', () => {
+            const input = 'text (round) and [square] with {curly} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 10);
+            expect(result).toEqual([
+                'text (round) and [square] with {curly} brackets',
+                'round',
+                'square',
+                'curly'
+            ]);
+        });
+        it('| should handle nested brackets with empty replaceContents', () => {
+            const input = 'text (round) and [square] with {curly (nested)} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplit(input, standardBrackets, 2, '');
+            expect(result).toEqual([
+                'text  and  with  brackets',
+                'round',
+                'square',
+                'curly ',
+                'nested'
+            ]);
+        });
+    });
+    describe('| multiBracketSplitDetailed', () => {
+        const standardBrackets = [
+            { opening: '(', closing: ')' },
+            { opening: '[', closing: ']' },
+            { opening: '{', closing: '}' }
+        ];
+        it('| should return detailed information for simple bracket extraction', () => {
+            const input = 'text (round) end';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: 'text ... end', level: 0, brackets: null },
+                { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should handle multiple bracket types with detailed info', () => {
+            const input = 'text (round) and [square] with {curly} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
+                { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } },
+                { content: 'curly', level: 1, brackets: { opening: '{', closing: '}' } }
+            ]);
+        });
+        it('| should handle nested brackets with detailed level information', () => {
+            const input = 'text (round) and [square] with {curly (nested)} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '...');
+            expect(result).toEqual([
+                { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
+                { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } },
+                { content: 'curly ...', level: 1, brackets: { opening: '{', closing: '}' } },
+                { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should handle deeply nested brackets with correct levels', () => {
+            const input = 'start {outer [middle (inner) middle] outer} end';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 3, '...');
+            expect(result).toEqual([
+                { content: 'start ... end', level: 0, brackets: null },
+                { content: 'outer ... outer', level: 1, brackets: { opening: '{', closing: '}' } },
+                { content: 'middle ... middle', level: 2, brackets: { opening: '[', closing: ']' } },
+                { content: 'inner', level: 3, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+        it('| should respect maxDepth and show correct levels', () => {
+            const input = 'text {a [b (c) b] a} text';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '...');
+            expect(result).toEqual([
+                { content: 'text ... text', level: 0, brackets: null },
+                { content: 'a ... a', level: 1, brackets: { opening: '{', closing: '}' } },
+                { content: 'b (c) b', level: 2, brackets: { opening: '[', closing: ']' } }
+            ]);
+        });
+        it('| should handle empty brackets with detailed info', () => {
+            const input = 'text () and [] with {} brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
+                { content: '', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: '', level: 1, brackets: { opening: '[', closing: ']' } },
+                { content: '', level: 1, brackets: { opening: '{', closing: '}' } }
+            ]);
+        });
+        it('| should handle custom bracket types with detailed info', () => {
+            const customBrackets = [
+                { opening: '{{', closing: '}}' },
+                { opening: '[[', closing: ']]' }
+            ];
+            const input = 'text {{double curly}} and [[double square]] content';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, customBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: 'text ... and ... content', level: 0, brackets: null },
+                { content: 'double curly', level: 1, brackets: { opening: '{{', closing: '}}' } },
+                { content: 'double square', level: 1, brackets: { opening: '[[', closing: ']]' } }
+            ]);
+        });
+        it('| should handle same character brackets with detailed info', () => {
+            const quoteBrackets = [
+                { opening: "'", closing: "'" },
+                { opening: '"', closing: '"' }
+            ];
+            const input = "text 'single quoted' and \"double quoted\" content";
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, quoteBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: 'text ... and ... content', level: 0, brackets: null },
+                { content: 'single quoted', level: 1, brackets: { opening: "'", closing: "'" } },
+                { content: 'double quoted', level: 1, brackets: { opening: '"', closing: '"' } }
+            ]);
+        });
+        it('| should handle no brackets case', () => {
+            const input = 'plain text with no brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: 'plain text with no brackets', level: 0, brackets: null }
+            ]);
+        });
+        it('| should handle empty brackets array', () => {
+            const input = 'text (with) brackets [but] no {bracket} definitions';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, [], 10, '...');
+            expect(result).toEqual([
+                { content: 'text (with) brackets [but] no {bracket} definitions', level: 0, brackets: null }
+            ]);
+        });
+        it('| should handle empty string', () => {
+            const input = '';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: '', level: 0, brackets: null }
+            ]);
+        });
+        it('| should show bracket type for each extracted content', () => {
+            const mixedBrackets = [
+                { opening: '<', closing: '>' },
+                { opening: '(', closing: ')' },
+                { opening: '[', closing: ']' }
+            ];
+            const input = 'start <tag> middle (paren) end [array] finish';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, mixedBrackets, 10, '...');
+            expect(result).toEqual([
+                { content: 'start ... middle ... end ... finish', level: 0, brackets: null },
+                { content: 'tag', level: 1, brackets: { opening: '<', closing: '>' } },
+                { content: 'paren', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'array', level: 1, brackets: { opening: '[', closing: ']' } }
+            ]);
+        });
+        it('| should handle complex nested scenario with multiple bracket types', () => {
+            const input = 'text (a [b {c (d) c} b] a) text';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 4, '...');
+            expect(result).toEqual([
+                { content: 'text ... text', level: 0, brackets: null },
+                { content: 'a ... a', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'b ... b', level: 2, brackets: { opening: '[', closing: ']' } },
+                { content: 'c ... c', level: 3, brackets: { opening: '{', closing: '}' } },
+                { content: 'd', level: 4, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+    });
+    describe('| multiBracketSplitDetailed - replaceContents variations', () => {
+        const standardBrackets = [
+            { opening: '(', closing: ')' },
+            { opening: '[', closing: ']' },
+            { opening: '{', closing: '}' }
+        ];
+        it('| should handle empty replaceContents (no replacement)', () => {
+            const input = 'text (round) and [square] brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '');
+            expect(result).toEqual([
+                { content: 'text  and  brackets', level: 0, brackets: null },
+                { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }
+            ]);
+        });
+        it('| should handle undefined replaceContents (no replacement)', () => {
+            const input = 'text (round) and [square] brackets';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10);
+            expect(result).toEqual([
+                { content: 'text (round) and [square] brackets', level: 0, brackets: null },
+                { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }
+            ]);
+        });
+        it('| should handle nested brackets with empty replaceContents', () => {
+            const input = 'text {curly (nested) content} end';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '');
+            expect(result).toEqual([
+                { content: 'text  end', level: 0, brackets: null },
+                { content: 'curly  content', level: 1, brackets: { opening: '{', closing: '}' } },
+                { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } }
+            ]);
+        });
+    });
+    // JSON and code fence extraction tests
+    describe('| JSON and code fence extraction', () => {
+        it('| should extract from plain JSON object with nested object', () => {
+            const brackets = [
+                { opening: '{', closing: '}' }
+            ];
+            const input = 'before {"name":"John","age":30,"nested":{"flag":true}} after';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
+            expect(result).toEqual([
+                { content: 'before ... after', level: 0, brackets: null },
+                { content: '"name":"John","age":30,"nested":...', level: 1, brackets: { opening: '{', closing: '}' } },
+                { content: '"flag":true', level: 2, brackets: { opening: '{', closing: '}' } }
+            ]);
+        });
+        it('| should extract JSON inside code fence json``` ... ```', () => {
+            const brackets = [
+                { opening: 'json```', closing: '```' },
+                { opening: '{', closing: '}' }
+            ];
+            const input = 'pre json```{"x":1,"y":{"z":2}}``` post';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
+            expect(result).toEqual([
+                { content: 'pre ... post', level: 0, brackets: null },
+                { content: '...', level: 1, brackets: { opening: 'json```', closing: '```' } },
+                { content: '"x":1,"y":...', level: 2, brackets: { opening: '{', closing: '}' } },
+                { content: '"z":2', level: 3, brackets: { opening: '{', closing: '}' } }
+            ]);
+        });
+        it('| should handle deeply nested JSON object within a property', () => {
+            const brackets = [
+                { opening: '{', closing: '}' }
+            ];
+            const input = 'wrap {"outer":{"mid":{"inner":42}}} done';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
+            expect(result).toEqual([
+                { content: 'wrap ... done', level: 0, brackets: null },
+                { content: '"outer":...', level: 1, brackets: { opening: '{', closing: '}' } },
+                { content: '"mid":...', level: 2, brackets: { opening: '{', closing: '}' } },
+                { content: '"inner":42', level: 3, brackets: { opening: '{', closing: '}' } }
+            ]);
+        });
+        it('| should process when a JSON string value contains code fence pattern json``` ... ```', () => {
+            const brackets = [
+                { opening: 'json```', closing: '```' },
+                { opening: '{', closing: '}' }
+            ];
+            const input = 'before {"note":"see json```X``` inside","data":{"raw":"json```Y```"}} after';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
+            expect(result).toEqual([
+                { content: 'before ... after', level: 0, brackets: null },
+                { content: '"note":"see ... inside","data":...', level: 1, brackets: { opening: '{', closing: '}' } },
+                { content: 'X', level: 2, brackets: { opening: 'json```', closing: '```' } },
+                { content: '"raw":"..."', level: 2, brackets: { opening: '{', closing: '}' } },
+                { content: 'Y', level: 3, brackets: { opening: 'json```', closing: '```' } }
+            ]);
+        });
+    });
+    // Script/method extraction tests
+    describe('| script/method extraction', () => {
+        it('| should extract simple method arguments with parentheses', () => {
+            const input = 'prefix doSomething(arg1, arg2) suffix';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 2, '...');
+            expect(result).toEqual([
+                'prefix doSomething... suffix',
+                'arg1, arg2'
+            ]);
+        });
+        it('| should handle nested method calls', () => {
+            const input = 'call outer(inner(a, b), c)';
+            const result = string_util_1.DyFM_String.nestedBracketSplit(input, '(', ')', 3, '...');
+            expect(result).toEqual([
+                'call outer...',
+                'inner..., c',
+                'a, b'
+            ]);
+        });
+        it('| should extract quoted args inside a method call', () => {
+            const brackets = [
+                { opening: '(', closing: ')' },
+                { opening: '"', closing: '"' }
+            ];
+            const input = 'run fn("a, b", 3) end';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
+            expect(result).toEqual([
+                { content: 'run fn... end', level: 0, brackets: null },
+                { content: '..., 3', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'a, b', level: 2, brackets: { opening: '"', closing: '"' } }
+            ]);
+        });
+        it('| should handle JSON literal and inner helper call as arguments', () => {
+            const brackets = [
+                { opening: '(', closing: ')' },
+                { opening: '{', closing: '}' },
+                { opening: '"', closing: '"' }
+            ];
+            const input = 'call api({id:1, meta:{ok:true}}, helper("x")) done';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
+            expect(result).toEqual([
+                { content: 'call api... done', level: 0, brackets: null },
+                { content: '..., helper...', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'id:1, meta:...', level: 2, brackets: { opening: '{', closing: '}' } },
+                { content: '...', level: 2, brackets: { opening: '(', closing: ')' } },
+                { content: 'ok:true', level: 3, brackets: { opening: '{', closing: '}' } },
+                { content: 'x', level: 3, brackets: { opening: '"', closing: '"' } }
+            ]);
+        });
+        it('| should process code fence marker inside a quoted argument', () => {
+            const brackets = [
+                { opening: '(', closing: ')' },
+                { opening: 'json```', closing: '```' },
+                { opening: '"', closing: '"' }
+            ];
+            const input = 'run method("see json```{a:1}``` here", 0)';
+            const result = string_util_1.DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
+            expect(result).toEqual([
+                { content: 'run method...', level: 0, brackets: null },
+                { content: '..., 0', level: 1, brackets: { opening: '(', closing: ')' } },
+                { content: 'see ... here', level: 2, brackets: { opening: '"', closing: '"' } },
+                { content: '{a:1}', level: 3, brackets: { opening: 'json```', closing: '```' } }
+            ]);
+        });
+    });
+    describe('| anyNameToShortCode', () => {
+        it('| should convert space-separated name to short code', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John Doe');
+            expect(result).toBe('JD');
+        });
+        it('| should convert camelCase name to short code', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('JohnDoe');
+            expect(result).toBe('JD');
+        });
+        it('| should convert underscore-separated name to short code', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John_Doe');
+            expect(result).toBe('JD');
+        });
+        it('| should convert camelCase starting with lowercase to short code', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('johnDoe');
+            expect(result).toBe('JD');
+        });
+        it('| should convert lowercase underscore-separated name to short code', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('john_doe');
+            expect(result).toBe('JD');
+        });
+        it('| should convert hyphen-separated name to short code', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('john-doe');
+            expect(result).toBe('JD');
+        });
+        it('| should handle single word name', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John');
+            expect(result).toBe('J');
+        });
+        it('| should handle single lowercase word', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('john');
+            expect(result).toBe('J');
+        });
+        it('| should handle three words', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John Michael Doe');
+            expect(result).toBe('JMD');
+        });
+        it('| should handle mixed separators', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John_Michael-Doe');
+            expect(result).toBe('JMD');
+        });
+        it('| should handle camelCase with multiple words', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('JohnMichaelDoe');
+            expect(result).toBe('JMD');
+        });
+        it('| should handle mixed camelCase and separators', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('JohnMichael_Doe');
+            expect(result).toBe('JMD');
+        });
+        it('| should handle name with multiple spaces', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John   Doe');
+            expect(result).toBe('JD');
+        });
+        it('| should handle name with multiple underscores', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John___Doe');
+            expect(result).toBe('JD');
+        });
+        it('| should handle name with multiple hyphens', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John---Doe');
+            expect(result).toBe('JD');
+        });
+        it('| should handle name with mixed separators and spaces', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John _- Doe');
+            expect(result).toBe('JD');
+        });
+        it('| should handle empty string', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('');
+            expect(result).toBe('');
+        });
+        it('| should handle string with only spaces', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('   ');
+            expect(result).toBe('');
+        });
+        it('| should handle string with only separators', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('___---');
+            expect(result).toBe('');
+        });
+        it('| should handle name with leading and trailing spaces', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('  John Doe  ');
+            expect(result).toBe('JD');
+        });
+        it('| should handle name with leading and trailing separators', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('_John_Doe_');
+            expect(result).toBe('JD');
+        });
+        it('| should handle all uppercase name', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('JOHN DOE');
+            expect(result).toBe('JD');
+        });
+        it('| should handle all uppercase camelCase', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('JOHNDOE');
+            expect(result).toBe('J');
+        });
+        it('| should handle name with numbers', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John2 Doe3');
+            expect(result).toBe('JD');
+        });
+        it('| should handle name starting with number', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('2John Doe');
+            expect(result).toBe('JD');
+        });
+        it('| should handle complex camelCase with numbers', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('john2Doe3Smith');
+            expect(result).toBe('JDS');
+        });
+        it('| should handle single character', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('J');
+            expect(result).toBe('J');
+        });
+        it('| should handle name with special characters', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('John@Doe#Smith');
+            expect(result).toBe('JDS');
+        });
+        it('| should handle very long camelCase name', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('ThisIsAVeryLongCamelCaseName');
+            expect(result).toBe('TIAVLCCN');
+        });
+        it('| should handle name with consecutive uppercase letters', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('XMLParser');
+            expect(result).toBe('XP');
+        });
+        it('| should handle name with acronym at start', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('HTMLDocument');
+            expect(result).toBe('HD');
+        });
+        it('| should handle name with acronym in middle', () => {
+            const result = string_util_1.DyFM_String.anyNameToShortCode('MyHTMLParser');
+            expect(result).toBe('MHP');
+        });
+    });
+});
+//# sourceMappingURL=string.util.spec.js.map