@goast/core 0.4.0-beta4 → 0.4.0

package/script/src/utils/source-builder.test.js

@@ -0,0 +1,508 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("../../_dnt.test_polyfills.js");
+const node_os_1 = require("node:os");
+const mod_js_1 = require("../../deps/jsr.io/@std/expect/1.0.5/mod.js");
+const bdd_js_1 = require("../../deps/jsr.io/@std/testing/1.0.3/bdd.js");
+const source_builder_js_1 = require("./source-builder.js");
+const utils_js_1 = require("./string-builder/utils.js");
+(0, bdd_js_1.describe)('SourceBuilder', () => {
+    let sb;
+    (0, bdd_js_1.beforeEach)(() => {
+        sb = new source_builder_js_1.SourceBuilder();
+    });
+    (0, bdd_js_1.describe)('constructor', () => {
+        (0, bdd_js_1.it)('should initialize with default options', () => {
+            const options = sb.options;
+            (0, mod_js_1.expect)(options.indent).toEqual({ type: 'spaces', count: 2 });
+            (0, mod_js_1.expect)(options.newLine).toBe(node_os_1.EOL);
+        });
+    });
+    (0, bdd_js_1.describe)('fromString', () => {
+        (0, bdd_js_1.it)('should create a new instance of SourceBuilder with the given string', () => {
+            const str = 'test string';
+            const sb = source_builder_js_1.SourceBuilder.fromString(str);
+            (0, mod_js_1.expect)(sb.toString()).toEqual(str);
+        });
+        (0, bdd_js_1.it)('should create a new instance of SourceBuilder with the given string and options', () => {
+            const str = 'test string';
+            const options = {
+                indent: { type: 'tabs' },
+                newLine: '\n-',
+            };
+            const sb = source_builder_js_1.SourceBuilder.fromString(str, options);
+            (0, mod_js_1.expect)(sb.toString()).toEqual(str);
+            // TODO: Uncomment as soon as @std/expect has new version (https://github.com/denoland/std/pull/6065)
+            // expect(sb.options).toEqual(expect.objectContaining(options));
+        });
+    });
+    (0, bdd_js_1.describe)('build', () => {
+        (0, bdd_js_1.it)('should build a string using a callback function that receives a `SourceBuilder` instance', () => {
+            const buildAction = (builder) => {
+                builder.append('hello');
+                builder.append('world');
+            };
+            const result = source_builder_js_1.SourceBuilder.build(buildAction);
+            (0, mod_js_1.expect)(result).toEqual('helloworld');
+        });
+        (0, bdd_js_1.it)('should build a string using a callback function that receives a `SourceBuilder` instance and options', () => {
+            const buildAction = (builder) => {
+                builder.appendLine('hello');
+                builder.indent((b) => b.append('world'));
+            };
+            const options = {
+                indent: { type: 'spaces', count: 4 },
+                newLine: '\r\n\t',
+            };
+            const result = source_builder_js_1.SourceBuilder.build(buildAction, options);
+            (0, mod_js_1.expect)(result).toEqual(`hello${options.newLine}    world`);
+        });
+    });
+    (0, bdd_js_1.describe)('append', () => {
+        (0, bdd_js_1.it)('should handle consecutive line breaks', () => {
+            sb.append('line1', node_os_1.EOL, node_os_1.EOL, node_os_1.EOL, 'line2');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}${node_os_1.EOL}${node_os_1.EOL}line2`);
+        });
+        (0, bdd_js_1.it)('should handle mixed line breaks', () => {
+            sb.append('line1\r\n', '\n', 'line2\r', '\r', 'line3\n', 'line4');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}${node_os_1.EOL}line2line3${node_os_1.EOL}line4`);
+        });
+        (0, bdd_js_1.it)('should handle strings with special chars', () => {
+            sb.append('line1 {', node_os_1.EOL, 'line2}');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1 {${node_os_1.EOL}line2}`);
+        });
+        (0, bdd_js_1.it)('should handle long strings without line breaks', () => {
+            sb.append('This is a long string without any line breaks.');
+            (0, mod_js_1.expect)(sb.toString()).toBe('This is a long string without any line breaks.');
+        });
+        (0, bdd_js_1.it)('should handle multiple calls', () => {
+            sb.append('line1', node_os_1.EOL);
+            sb.append('line2', node_os_1.EOL);
+            sb.append('line3', node_os_1.EOL);
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}line2${node_os_1.EOL}line3${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should handle empty input', () => {
+            sb.append('', '', '', node_os_1.EOL, '', '');
+            (0, mod_js_1.expect)(sb.toString()).toBe(node_os_1.EOL);
+        });
+        (0, bdd_js_1.it)('should apply the provided builder function to the source builder', () => {
+            const builder = new source_builder_js_1.SourceBuilder().append((b) => b.append('foo'));
+            (0, mod_js_1.expect)(builder.toString()).toBe('foo');
+        });
+    });
+    (0, bdd_js_1.describe)('appendIf', () => {
+        (0, bdd_js_1.it)('should append the string when condition is true', () => {
+            sb.appendIf(true, 'line1', node_os_1.EOL);
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should not append the string when condition is false', () => {
+            sb.appendIf(false, 'line1', node_os_1.EOL);
+            (0, mod_js_1.expect)(sb.toString()).toBe('');
+        });
+        (0, bdd_js_1.it)('should append the string when condition is a function returning true', () => {
+            sb.appendIf(() => true, 'line1', node_os_1.EOL);
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should not append the string when condition is a function returning false', () => {
+            sb.appendIf(() => false, 'line1', node_os_1.EOL);
+            (0, mod_js_1.expect)(sb.toString()).toBe('');
+        });
+    });
+    (0, bdd_js_1.describe)('appendLineIf', () => {
+        (0, bdd_js_1.it)('should append the string when condition is true', () => {
+            sb.appendLineIf(true, 'line1');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should not append the string when condition is false', () => {
+            sb.appendLineIf(false, 'line1');
+            (0, mod_js_1.expect)(sb.toString()).toBe('');
+        });
+        (0, bdd_js_1.it)('should append the string when condition is a function returning true', () => {
+            sb.appendLineIf(() => true, 'line1');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should not append the string when condition is a function returning false', () => {
+            sb.appendLineIf(() => false, 'line1');
+            (0, mod_js_1.expect)(sb.toString()).toBe('');
+        });
+    });
+    (0, bdd_js_1.describe)('prependIf', () => {
+        (0, bdd_js_1.it)('should prepend the specified value if the condition is true', () => {
+            const builder = new source_builder_js_1.SourceBuilder().append('bar').prependIf(true, 'foo');
+            (0, mod_js_1.expect)(builder.toString()).toBe('foobar');
+        });
+        (0, bdd_js_1.it)('should not prepend the specified value if the condition is false', () => {
+            const builder = new source_builder_js_1.SourceBuilder().append('bar').prependIf(false, 'foo');
+            (0, mod_js_1.expect)(builder.toString()).toBe('bar');
+        });
+    });
+    (0, bdd_js_1.describe)('prependLineIf', () => {
+        (0, bdd_js_1.it)('should prepend the specified value with a line terminator if the condition is true', () => {
+            const builder = new source_builder_js_1.SourceBuilder().append('bar').prependLineIf(true, 'foo');
+            (0, mod_js_1.expect)(builder.toString()).toBe(`foo${node_os_1.EOL}bar`);
+        });
+        (0, bdd_js_1.it)('should not prepend the specified value if the condition is false', () => {
+            const builder = new source_builder_js_1.SourceBuilder().append('bar').prependLineIf(false, 'foo');
+            (0, mod_js_1.expect)(builder.toString()).toBe('bar');
+        });
+    });
+    (0, bdd_js_1.describe)('appendWithLinePrefix', () => {
+        (0, bdd_js_1.it)('should append the specified values with the specified line prefix', () => {
+            const builder = new source_builder_js_1.SourceBuilder().appendWithLinePrefix('// ', 'foo', 'bar');
+            (0, mod_js_1.expect)(builder.toString()).toBe('// foobar');
+        });
+        (0, bdd_js_1.it)('should handle null and undefined values', () => {
+            const builder = new source_builder_js_1.SourceBuilder().appendWithLinePrefix('// ', 'foo', null, undefined, 'bar');
+            (0, mod_js_1.expect)(builder.toString()).toBe('// foobar');
+        });
+        (0, bdd_js_1.it)('should apply the provided builder function with the specified line prefix', () => {
+            const builder = new source_builder_js_1.SourceBuilder().appendWithLinePrefix('// ', (b) => {
+                b.appendLine('foo');
+                b.appendLine('bar');
+            });
+            (0, mod_js_1.expect)(builder.toString()).toBe(`// foo${node_os_1.EOL}// bar${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should apply the provided builder function with the specified line prefix and indentation', () => {
+            const builder = new source_builder_js_1.SourceBuilder().indent((b) => b.appendWithLinePrefix('// ', (b) => {
+                b.appendLine('foo');
+                b.appendLine('bar');
+            }));
+            (0, mod_js_1.expect)(builder.toString()).toBe(`  // foo${node_os_1.EOL}  // bar${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should write indents after the prefix', () => {
+            const builder = new source_builder_js_1.SourceBuilder().indent((b) => b.appendWithLinePrefix('// ', (b) => {
+                b.indent((b) => b.appendLine('foo'));
+            }));
+            (0, mod_js_1.expect)(builder.toString()).toBe(`  //   foo${node_os_1.EOL}`);
+        });
+    });
+    (0, bdd_js_1.describe)('appendLineWithLinePrefix', () => {
+        (0, bdd_js_1.it)('should append the specified values as a new line with the specified line prefix', () => {
+            const builder = new source_builder_js_1.SourceBuilder().appendLineWithLinePrefix('// ', 'foo', 'bar');
+            (0, mod_js_1.expect)(builder.toString()).toBe('// foobar' + node_os_1.EOL);
+        });
+        (0, bdd_js_1.it)('should handle null and undefined values', () => {
+            const builder = new source_builder_js_1.SourceBuilder().appendLineWithLinePrefix('// ', 'foo', null, undefined, 'bar');
+            (0, mod_js_1.expect)(builder.toString()).toBe('// foobar' + node_os_1.EOL);
+        });
+    });
+    (0, bdd_js_1.describe)('ensurePreviousLineEmpty', () => {
+        (0, bdd_js_1.it)('should insert one empty line when current line is empty', () => {
+            sb.append('line1', node_os_1.EOL, 'line2', node_os_1.EOL);
+            sb.ensurePreviousLineEmpty();
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}line2${node_os_1.EOL}${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should insert two empty lines when current line is not empty', () => {
+            sb.append('line1', node_os_1.EOL, 'line2');
+            sb.ensurePreviousLineEmpty();
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}line2${node_os_1.EOL}${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should not insert an empty line when already empty', () => {
+            sb.append('line1', node_os_1.EOL, 'line2', node_os_1.EOL, node_os_1.EOL);
+            sb.ensurePreviousLineEmpty();
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}line2${node_os_1.EOL}${node_os_1.EOL}`);
+        });
+    });
+    (0, bdd_js_1.describe)('ensureCurrentLineEmpty', () => {
+        (0, bdd_js_1.it)('should insert an empty line', () => {
+            sb.append('line1', node_os_1.EOL, 'line2');
+            sb.ensureCurrentLineEmpty();
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}line2${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should not insert an empty line when already empty', () => {
+            sb.append('line1', node_os_1.EOL, 'line2', node_os_1.EOL);
+            sb.ensureCurrentLineEmpty();
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}line2${node_os_1.EOL}`);
+        });
+    });
+    (0, bdd_js_1.describe)('pretendPreviousLineEmpty', () => {
+        (0, bdd_js_1.it)('should pretend the previous line is empty', () => {
+            sb.appendLine('line1').append('a').pretendPreviousLineEmpty().ensurePreviousLineEmpty().append('b');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}ab`);
+        });
+    });
+    (0, bdd_js_1.describe)('pretendCurrentLineEmpty', () => {
+        (0, bdd_js_1.it)('should pretend the previous line is empty', () => {
+            sb.append('a').pretendCurrentLineEmpty().ensureCurrentLineEmpty().append('b');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`ab`);
+        });
+    });
+    (0, bdd_js_1.describe)('if', () => {
+        (0, bdd_js_1.it)('should append the content when condition is true', () => {
+            sb.if(true, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should not append the content when condition is false', () => {
+            sb.if(false, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(``);
+        });
+        (0, bdd_js_1.it)('should append the content when condition function returns true', () => {
+            sb.if(() => true, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should not append the content when condition function returns false', () => {
+            sb.if(() => false, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(``);
+        });
+        (0, bdd_js_1.it)('should append the correct content when condition is true', () => {
+            sb.if(true, (x) => x.append('stuff'), (x) => x.append('other stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should append the correct content when condition is false', () => {
+            sb.if(false, (x) => x.append('stuff'), (x) => x.append('other stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`other stuff`);
+        });
+        (0, bdd_js_1.it)('should append the correct content when condition function returns true', () => {
+            sb.if(() => true, (x) => x.append('stuff'), (x) => x.append('other stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should append the correct content when condition function returns false', () => {
+            sb.if(() => false, (x) => x.append('stuff'), (x) => x.append('other stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`other stuff`);
+        });
+    });
+    (0, bdd_js_1.describe)('indent', () => {
+        (0, bdd_js_1.it)('should correctly indent the content (fn)', () => {
+            sb.append('line1', node_os_1.EOL);
+            sb.indent((innerSb) => {
+                innerSb.append('line2', node_os_1.EOL);
+            });
+            sb.append('line3', node_os_1.EOL);
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}  line2${node_os_1.EOL}line3${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should correctly indent the content (string)', () => {
+            sb.append('line1', node_os_1.EOL);
+            sb.indent('line2\n');
+            sb.append('line3', node_os_1.EOL);
+            (0, mod_js_1.expect)(sb.toString()).toBe(`line1${node_os_1.EOL}  line2${node_os_1.EOL}line3${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should correctly handle nested indentation', () => {
+            sb.indent((innerSb1) => {
+                innerSb1.append('line1', node_os_1.EOL);
+                innerSb1.indent((innerSb2) => {
+                    innerSb2.append('line2', node_os_1.EOL);
+                });
+                innerSb1.append('line3', node_os_1.EOL);
+            });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`  line1${node_os_1.EOL}    line2${node_os_1.EOL}  line3${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should correctly handle multiline strings (fn)', () => {
+            sb.indent((innerSb) => {
+                innerSb.append(`line1${node_os_1.EOL}line2`, node_os_1.EOL);
+            });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`  line1${node_os_1.EOL}  line2${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should correctly handle multiline strings (string)', () => {
+            sb.indent('line1\nline2\n');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`  line1${node_os_1.EOL}  line2${node_os_1.EOL}`);
+        });
+        (0, bdd_js_1.it)('should nest indentations', () => {
+            sb.appendLine('(')
+                .indent((b1) => {
+                b1.appendLine('(')
+                    .indent((b2) => {
+                    b2.appendLine('line1');
+                })
+                    .appendLine(')');
+            })
+                .appendLine(')');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}  (${node_os_1.EOL}    line1${node_os_1.EOL}  )${node_os_1.EOL})${node_os_1.EOL}`);
+        });
+    });
+    (0, bdd_js_1.describe)('indentIf', () => {
+        (0, bdd_js_1.it)('should indent when condition is true', () => {
+            sb.indentIf(true, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`  stuff`);
+        });
+        (0, bdd_js_1.it)('should not indent when condition is false', () => {
+            sb.indentIf(false, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should indent when condition function returns true', () => {
+            sb.indentIf(() => true, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`  stuff`);
+        });
+        (0, bdd_js_1.it)('should not indent when condition function returns false', () => {
+            sb.indentIf(() => false, (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+    });
+    (0, bdd_js_1.describe)('parenthesize', () => {
+        (0, bdd_js_1.it)('should parenthesize the content with the given brackets string', () => {
+            sb.parenthesize('{}', (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`{stuff}`);
+        });
+        (0, bdd_js_1.it)('should parenthesize the content with the given brackets array', () => {
+            sb.parenthesize(['{', '}'], (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`{stuff}`);
+        });
+        (0, bdd_js_1.it)('should parenthesize and indent the content (fn)', () => {
+            sb.parenthesize('()', (x) => x.append(`${node_os_1.EOL}stuff${node_os_1.EOL}`));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should parenthesize and indent the content (string)', () => {
+            sb.parenthesize('()', `${node_os_1.EOL}stuff${node_os_1.EOL}`);
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should parenthesize but not indent the content when indent is false', () => {
+            sb.parenthesize('()', (x) => x.append(`${node_os_1.EOL}stuff${node_os_1.EOL}`), { indent: false });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should parenthesize the content with the given brackets string (multiline)', () => {
+            sb.parenthesize('{}', (x) => x.append('stuff'), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`{${node_os_1.EOL}  stuff${node_os_1.EOL}}`);
+        });
+        (0, bdd_js_1.it)('should parenthesize the content with the given brackets array (multiline)', () => {
+            sb.parenthesize(['{', '}'], (x) => x.append('stuff'), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`{${node_os_1.EOL}  stuff${node_os_1.EOL}}`);
+        });
+        (0, bdd_js_1.it)('should parenthesize and indent the content (fn) (multiline)', () => {
+            sb.parenthesize('()', (x) => x.append(`${node_os_1.EOL}stuff${node_os_1.EOL}`), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should parenthesize and indent the content (string) (multiline)', () => {
+            sb.parenthesize('()', `${node_os_1.EOL}stuff${node_os_1.EOL}`, { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should parenthesize but not indent the content when indent is false (multiline)', () => {
+            sb.parenthesize('()', (x) => x.append(`${node_os_1.EOL}stuff${node_os_1.EOL}`), { multiline: true, indent: false });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}${node_os_1.EOL}stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should ignore first ensurePreviousLineEmpty', () => {
+            sb.parenthesize('()', (x) => x.ensurePreviousLineEmpty().append('stuff'), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should not ignore first ensurePreviousLineEmpty if disabled', () => {
+            sb.parenthesize('()', (x) => x.ensurePreviousLineEmpty().append('stuff'), {
+                multiline: true,
+                pretendEmpty: false,
+            });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+    });
+    (0, bdd_js_1.describe)('parenthesizeIf', () => {
+        (0, bdd_js_1.it)('should parenthesize when condition is true (fn)', () => {
+            sb.parenthesizeIf(true, '()', (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(stuff)`);
+        });
+        (0, bdd_js_1.it)('should parenthesize when condition is true (string)', () => {
+            sb.parenthesizeIf(true, '()', 'stuff');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(stuff)`);
+        });
+        (0, bdd_js_1.it)('should not parenthesize when condition is false', () => {
+            sb.parenthesizeIf(false, '()', (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should parenthesize when condition function returns true', () => {
+            sb.parenthesizeIf(() => true, '()', (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(stuff)`);
+        });
+        (0, bdd_js_1.it)('should not parenthesize when condition function returns false', () => {
+            sb.parenthesizeIf(() => false, '()', (x) => x.append('stuff'));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should parenthesize when condition is true (fn) (multiline)', () => {
+            sb.parenthesizeIf(true, '()', (x) => x.append('stuff'), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should parenthesize when condition is true (string) (multiline)', () => {
+            sb.parenthesizeIf(true, '()', 'stuff', { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should not parenthesize when condition is false (multiline)', () => {
+            sb.parenthesizeIf(false, '()', (x) => x.append('stuff'), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+        (0, bdd_js_1.it)('should parenthesize when condition function returns true (multiline)', () => {
+            sb.parenthesizeIf(() => true, '()', (x) => x.append('stuff'), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(${node_os_1.EOL}  stuff${node_os_1.EOL})`);
+        });
+        (0, bdd_js_1.it)('should not parenthesize when condition function returns false (multiline)', () => {
+            sb.parenthesizeIf(() => false, '()', (x) => x.append('stuff'), { multiline: true });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`stuff`);
+        });
+    });
+    (0, bdd_js_1.describe)('forEach', () => {
+        (0, bdd_js_1.it)('should add the content for each item', () => {
+            sb.forEach(['a', 'b', 'c'], (x, item) => x.append(`(${item})`));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(a)(b)(c)`);
+        });
+        (0, bdd_js_1.it)('should add the content for items that match the condition', () => {
+            sb.forEach(['a', 'b', 'c'], (x, item) => x.append(`(${item})`), { condition: (item) => item === 'b' });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(b)`);
+        });
+        (0, bdd_js_1.it)('should add the content for each item with the given string separator', () => {
+            sb.forEach(['a', 'b', 'c'], (x, item) => x.append(`item: ${item}`), { separator: ', ' });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`item: a, item: b, item: c`);
+        });
+        (0, bdd_js_1.it)('should add the content for each item with the given separator builder', () => {
+            sb.forEach(['a', 'b', 'c'], (x, item) => x.append(`item: ${item}`), {
+                separator: (x, p, n, pi, ni) => x.append(`(${p}:${pi}), (${n}:${ni})`),
+            });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`item: a(a:0), (b:1)item: b(b:1), (c:2)item: c`);
+        });
+        (0, bdd_js_1.it)('should add the content for items that match the condition with the given string separator', () => {
+            sb.forEach(['a', 'b', 'c'], (x, item) => x.append(`item: ${item}`), {
+                condition: (item) => item === 'a' || item === 'c',
+                separator: ', ',
+            });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`item: a, item: c`);
+        });
+        (0, bdd_js_1.it)('should add the content for items that match the condition with the given separator builder', () => {
+            sb.forEach(['a', 'b', 'c'], (x, item) => x.append(`item: ${item}`), {
+                condition: (item) => item === 'a' || item === 'c',
+                separator: (x, p, n, pi, ni) => x.append(`(${p}:${pi}), (${n}:${ni})`),
+            });
+            (0, mod_js_1.expect)(sb.toString()).toBe(`item: a(a:0), (c:2)item: c`);
+        });
+    });
+    (0, bdd_js_1.describe)('forEachIf', () => {
+        (0, bdd_js_1.it)('should add the content for each item when condition is true', () => {
+            sb.forEachIf(true, ['a', 'b', 'c'], (x, item) => x.append(`(${item})`));
+            (0, mod_js_1.expect)(sb.toString()).toBe(`(a)(b)(c)`);
+        });
+        (0, bdd_js_1.it)('should not add the content for each item when condition is false', () => {
+            sb.forEachIf(false, ['a', 'b', 'c'], (x, item) => x.append(`(${item})`));
+            (0, mod_js_1.expect)(sb.toString()).toBe(``);
+        });
+    });
+    (0, bdd_js_1.describe)('appendSeparated', () => {
+        (0, bdd_js_1.it)('should add the content for each item with the given string separator', () => {
+            sb.appendSeparated(['a', 'b', 'c'], ', ');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`a, b, c`);
+        });
+    });
+    (0, bdd_js_1.describe)('appendSeparatedIf', () => {
+        (0, bdd_js_1.it)('should add the content for each item with the given string separator when condition is true', () => {
+            sb.appendSeparatedIf(true, ['a', 'b', 'c'], ', ');
+            (0, mod_js_1.expect)(sb.toString()).toBe(`a, b, c`);
+        });
+        (0, bdd_js_1.it)('should not add the content for each item with the given string separator when condition is false', () => {
+            sb.appendSeparatedIf(false, ['a', 'b', 'c'], ', ');
+            (0, mod_js_1.expect)(sb.toString()).toBe(``);
+        });
+    });
+});
+(0, bdd_js_1.describe)('builderTemplate', () => {
+    (0, bdd_js_1.it)('should resolve append values in a template string', () => {
+        const sb = new source_builder_js_1.SourceBuilder();
+        sb.append((0, source_builder_js_1.builderTemplate) `abc${'def'}ghi${123}jkl${(b) => b.append('mno')}pqr${(0, utils_js_1.appendValueGroup)(['stu', 'vxw'])}yz`);
+        (0, mod_js_1.expect)(sb.toString()).toEqual('abcdefghi123jklmnopqrstuvxwyz');
+    });
+    (0, bdd_js_1.it)('should remove indentation based on last line', () => {
+        const sb = new source_builder_js_1.SourceBuilder();
+        sb.append((0, source_builder_js_1.builderTemplate) `${'abc'}
+        ${123}
+         ghi`);
+        (0, mod_js_1.expect)(sb.toString()).toEqual(`abc${node_os_1.EOL}123${node_os_1.EOL}ghi`);
+    });
+    (0, bdd_js_1.describe)('indent', () => {
+        (0, bdd_js_1.it)('should indent the content', () => {
+            const sb = new source_builder_js_1.SourceBuilder();
+            sb.append(source_builder_js_1.builderTemplate.indent `${'abc'}
+          ${123}
+          ghi`);
+            (0, mod_js_1.expect)(sb.toString()).toEqual(`  abc${node_os_1.EOL}  123${node_os_1.EOL}  ghi`);
+        });
+    });
+});

package/script/src/utils/string-builder/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/string-builder/options.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,oBAEzC,CAAC"}

package/script/src/utils/string-builder/string-builder.d.ts

@@ -0,0 +1,73 @@
+import type { Nullable, SingleOrMultiple } from '../type.utils.js';
+import { type StringBuilderOptions } from './options.js';
+export type BuilderFn<TBuilder extends StringBuilder> = (builder: TBuilder) => void;
+export type Primitive = string | number | boolean;
+export type AppendParam<TBuilder extends StringBuilder, TAdditionalAppends> = SingleOrMultiple<Primitive | null | undefined | BuilderFn<TBuilder> | TAdditionalAppends | {
+    __type: 'append-value-group';
+    values: AppendParam<TBuilder, TAdditionalAppends>[];
+    separator: string | null;
+}>;
+export declare const AdditionalAppendsSymbol: unique symbol;
+/**
+ * Represents a mutable string of characters.
+ */
+export declare class StringBuilder<TAdditionalAppends = never> {
+    private readonly _options;
+    protected str: string;
+    [AdditionalAppendsSymbol](_: TAdditionalAppends): void;
+    get options(): StringBuilderOptions;
+    /**
+     * Initializes a new instance of the StringBuilder class.
+     * @param options The options.
+     */
+    constructor(options?: Partial<StringBuilderOptions>);
+    /**
+     * Creates a new StringBuilder instance and appends the specified string to it.
+     * @param str The string to append.
+     * @param options The options.
+     * @returns A new StringBuilder instance.
+     */
+    static fromString(str: string, options?: Partial<StringBuilderOptions>): StringBuilder;
+    /**
+     * Builds a string using a StringBuilder build action.
+     * @param buildAction The build action to perform on the StringBuilder instance.
+     * @param options The options for the StringBuilder instance.
+     * @returns The built string.
+     */
+    static build(buildAction: AppendParam<StringBuilder, never>, options?: Partial<StringBuilderOptions>): string;
+    protected appendSingle(value: AppendParam<this, TAdditionalAppends>): void;
+    /**
+     * Appends one or more strings to the end of the current StringBuilder.
+     * @param value The string(s) to append.
+     * @returns The current StringBuilder.
+     */
+    append(...value: AppendParam<this, TAdditionalAppends>[]): this;
+    /**
+     * Appends one or more strings to the end of the current StringBuilder, followed by a line terminator.
+     * @param value
+     * @returns
+     */
+    appendLine(...value: Nullable<AppendParam<this, TAdditionalAppends>>[]): this;
+    /**
+     * Prepends one or more strings to the beginning of the current StringBuilder.
+     * @param value The string(s) to prepend.
+     * @returns The current StringBuilder.
+     */
+    prepend(...value: AppendParam<StringBuilder, never>[]): this;
+    /**
+     * Prepends one or more strings to the beginning of the current StringBuilder, followed by a line terminator.
+     * @param value The string(s) to prepend.
+     * @returns The current StringBuilder.
+     */
+    prependLine(...value: AppendParam<StringBuilder, never>[]): this;
+    /**
+     * Converts the value of this instance to a string.
+     * @returns A string whose value is the same as this instance.
+     */
+    toString(): string;
+    /**
+     * Removes all characters from the current StringBuilder.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=string-builder.d.ts.map

package/script/src/utils/string-builder/string-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-builder.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/string-builder/string-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEtF,MAAM,MAAM,SAAS,CAAC,QAAQ,SAAS,aAAa,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;AACpF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,MAAM,MAAM,WAAW,CAAC,QAAQ,SAAS,aAAa,EAAE,kBAAkB,IAAI,gBAAgB,CAC1F,SAAS,GACT,IAAI,GACJ,SAAS,GACT,SAAS,CAAC,QAAQ,CAAC,GAEnB,kBAAkB,GAClB;IACA,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,CAAC;IACpD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CACF,CAAC;AAEF,eAAO,MAAM,uBAAuB,eAA8B,CAAC;AAEnE;;GAEG;AACH,qBAAa,aAAa,CAAC,kBAAkB,GAAG,KAAK;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,SAAS,CAAC,GAAG,EAAE,MAAM,CAAM;IAE3B,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAItD,IAAW,OAAO,IAAI,oBAAoB,CAEzC;IAED;;;OAGG;gBACS,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAInD;;;;;OAKG;WACW,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,aAAa;IAM7F;;;;;OAKG;WACW,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAMpH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC;IA6BnE;;;;OAIG;IACI,MAAM,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,GAAG,IAAI;IAOtE;;;;OAIG;IACI,UAAU,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,EAAE,GAAG,IAAI;IAIpF;;;;OAIG;IACI,OAAO,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI;IAgBnE;;;;OAIG;IACI,WAAW,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI;IAIvE;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}