@futdevpro/fsm-dynamo 1.20.8 → 1.20.10

package/src/_collections/utils/string.util.spec.ts

@@ -1,975 +0,0 @@
-
-import { DyFM_String } from './string.util';
-
-describe('| DyFM_String', () => {
-  describe('| breakTrim', () => {
-    it('| should remove spaces from the start and end of the string', () => {
-      const result = 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 = 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 = 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 = 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 = 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 = DyFM_String.breakTrim('hello world');
-      expect(result).toBe('hello world');
-    });
-
-    it('| should handle an empty string input', () => {
-      const result = DyFM_String.breakTrim('');
-      expect(result).toBe('');
-    });
-  });
-
-  describe('| nestedBracketSplit', () => {
-    it('| should handle simple bracket extraction with replacement', () => {
-      const input = 'hello (world) test';
-      const result = 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 = 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 = 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 = 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 = 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 = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
-      expect(result).toEqual(['hello world test']);
-    });
-
-    it('| should handle empty string', () => {
-      const input = '';
-      const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
-      expect(result).toEqual(['']);
-    });
-
-    it('| should handle unmatched opening bracket', () => {
-      const input = 'hello (world test';
-      const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
-      expect(result).toEqual(['hello (world test']);
-    });
-
-    it('| should handle unmatched closing bracket', () => {
-      const input = 'hello world) test';
-      const result = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
-      expect(result).toEqual(['plain text with no brackets']);
-    });
-
-    it('| should handle empty string', () => {
-      const input = '';
-      const result = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = 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 = DyFM_String.anyNameToShortCode('John Doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should convert camelCase name to short code', () => {
-      const result = DyFM_String.anyNameToShortCode('JohnDoe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should convert underscore-separated name to short code', () => {
-      const result = DyFM_String.anyNameToShortCode('John_Doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should convert camelCase starting with lowercase to short code', () => {
-      const result = DyFM_String.anyNameToShortCode('johnDoe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should convert lowercase underscore-separated name to short code', () => {
-      const result = DyFM_String.anyNameToShortCode('john_doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should convert hyphen-separated name to short code', () => {
-      const result = DyFM_String.anyNameToShortCode('john-doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle single word name', () => {
-      const result = DyFM_String.anyNameToShortCode('John');
-      expect(result).toBe('J');
-    });
-
-    it('| should handle single lowercase word', () => {
-      const result = DyFM_String.anyNameToShortCode('john');
-      expect(result).toBe('J');
-    });
-
-    it('| should handle three words', () => {
-      const result = DyFM_String.anyNameToShortCode('John Michael Doe');
-      expect(result).toBe('JMD');
-    });
-
-    it('| should handle mixed separators', () => {
-      const result = DyFM_String.anyNameToShortCode('John_Michael-Doe');
-      expect(result).toBe('JMD');
-    });
-
-    it('| should handle camelCase with multiple words', () => {
-      const result = DyFM_String.anyNameToShortCode('JohnMichaelDoe');
-      expect(result).toBe('JMD');
-    });
-
-    it('| should handle mixed camelCase and separators', () => {
-      const result = DyFM_String.anyNameToShortCode('JohnMichael_Doe');
-      expect(result).toBe('JMD');
-    });
-
-    it('| should handle name with multiple spaces', () => {
-      const result = DyFM_String.anyNameToShortCode('John   Doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle name with multiple underscores', () => {
-      const result = DyFM_String.anyNameToShortCode('John___Doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle name with multiple hyphens', () => {
-      const result = DyFM_String.anyNameToShortCode('John---Doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle name with mixed separators and spaces', () => {
-      const result = DyFM_String.anyNameToShortCode('John _- Doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle empty string', () => {
-      const result = DyFM_String.anyNameToShortCode('');
-      expect(result).toBe('');
-    });
-
-    it('| should handle string with only spaces', () => {
-      const result = DyFM_String.anyNameToShortCode('   ');
-      expect(result).toBe('');
-    });
-
-    it('| should handle string with only separators', () => {
-      const result = DyFM_String.anyNameToShortCode('___---');
-      expect(result).toBe('');
-    });
-
-    it('| should handle name with leading and trailing spaces', () => {
-      const result = DyFM_String.anyNameToShortCode('  John Doe  ');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle name with leading and trailing separators', () => {
-      const result = DyFM_String.anyNameToShortCode('_John_Doe_');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle all uppercase name', () => {
-      const result = DyFM_String.anyNameToShortCode('JOHN DOE');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle all uppercase camelCase', () => {
-      const result = DyFM_String.anyNameToShortCode('JOHNDOE');
-      expect(result).toBe('J');
-    });
-
-    it('| should handle name with numbers', () => {
-      const result = DyFM_String.anyNameToShortCode('John2 Doe3');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle name starting with number', () => {
-      const result = DyFM_String.anyNameToShortCode('2John Doe');
-      expect(result).toBe('JD');
-    });
-
-    it('| should handle complex camelCase with numbers', () => {
-      const result = DyFM_String.anyNameToShortCode('john2Doe3Smith');
-      expect(result).toBe('JDS');
-    });
-
-    it('| should handle single character', () => {
-      const result = DyFM_String.anyNameToShortCode('J');
-      expect(result).toBe('J');
-    });
-
-    it('| should handle name with special characters', () => {
-      const result = DyFM_String.anyNameToShortCode('John@Doe#Smith');
-      expect(result).toBe('JDS');
-    });
-
-    it('| should handle very long camelCase name', () => {
-      const result = DyFM_String.anyNameToShortCode('ThisIsAVeryLongCamelCaseName');
-      expect(result).toBe('TIAVLCCN');
-    });
-
-    it('| should handle name with consecutive uppercase letters', () => {
-      const result = DyFM_String.anyNameToShortCode('XMLParser');
-      expect(result).toBe('XP');
-    });
-
-    it('| should handle name with acronym at start', () => {
-      const result = DyFM_String.anyNameToShortCode('HTMLDocument');
-      expect(result).toBe('HD');
-    });
-
-    it('| should handle name with acronym in middle', () => {
-      const result = DyFM_String.anyNameToShortCode('MyHTMLParser');
-      expect(result).toBe('MHP');
-    });
-  });
-});