@goast/core 0.4.0-beta4 → 0.4.1

package/esm/src/utils/string-builder/string-builder.js

@@ -0,0 +1,149 @@
+import { isNullish } from '../common.utils.js';
+import { defaultStringBuilderOptions } from './options.js';
+export const AdditionalAppendsSymbol = Symbol('AdditionalAppends');
+/**
+ * Represents a mutable string of characters.
+ */
+export class StringBuilder {
+    [AdditionalAppendsSymbol](_) {
+        throw new Error('This method should never be called.');
+    }
+    get options() {
+        return this._options;
+    }
+    /**
+     * Initializes a new instance of the StringBuilder class.
+     * @param options The options.
+     */
+    constructor(options) {
+        Object.defineProperty(this, "_options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "str", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ''
+        });
+        this._options = { ...defaultStringBuilderOptions, ...options };
+    }
+    /**
+     * 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, options) {
+        const builder = new StringBuilder(options);
+        builder.append(str);
+        return builder;
+    }
+    /**
+     * 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, options) {
+        const builder = new StringBuilder(options);
+        builder.append(buildAction);
+        return builder.toString();
+    }
+    appendSingle(value) {
+        if (isNullish(value))
+            return;
+        if (Array.isArray(value)) {
+            for (const part of value) {
+                this.appendSingle(part);
+            }
+        }
+        else if (typeof value === 'string') {
+            this.str += value;
+        }
+        else if (typeof value === 'number' || typeof value === 'boolean') {
+            this.str += value.toString();
+        }
+        else if (typeof value === 'function') {
+            value(this);
+        }
+        else if (typeof value === 'object' &&
+            value !== null &&
+            '__type' in value &&
+            value.__type === 'append-value-group') {
+            let isFirst = true;
+            for (const part of value.values) {
+                if (!isFirst && value.separator) {
+                    this.append(value.separator);
+                }
+                this.appendSingle(part);
+                isFirst = false;
+            }
+        }
+    }
+    /**
+     * 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) {
+        for (const part of value) {
+            this.appendSingle(part);
+        }
+        return this;
+    }
+    /**
+     * Appends one or more strings to the end of the current StringBuilder, followed by a line terminator.
+     * @param value
+     * @returns
+     */
+    appendLine(...value) {
+        return this.append(...value, '\n');
+    }
+    /**
+     * 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) {
+        for (const part of value.reverse()) {
+            if (isNullish(part))
+                continue;
+            if (typeof part === 'function') {
+                const builder = new StringBuilder(this.options);
+                part(builder);
+                this.str = builder.str + this.str;
+            }
+            else if (typeof part === 'string') {
+                this.str = part + this.str;
+            }
+            else {
+                this.str = part.toString() + this.str;
+            }
+        }
+        return 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) {
+        return this.prepend(...value, '\n');
+    }
+    /**
+     * Converts the value of this instance to a string.
+     * @returns A string whose value is the same as this instance.
+     */
+    toString() {
+        return this.str.replace(/\r?\n/g, this._options.newLine);
+    }
+    /**
+     * Removes all characters from the current StringBuilder.
+     */
+    clear() {
+        this.str = '';
+    }
+}

package/esm/src/utils/string-builder/string-builder.test.d.ts

@@ -0,0 +1,2 @@
+import "../../../_dnt.test_polyfills.js";
+//# sourceMappingURL=string-builder.test.d.ts.map

package/esm/src/utils/string-builder/string-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-builder.test.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/string-builder/string-builder.test.ts"],"names":[],"mappings":"AAAA,OAAO,iCAAiC,CAAC"}

package/esm/src/utils/string-builder/string-builder.test.js

@@ -0,0 +1,163 @@
+import "../../../_dnt.test_polyfills.js";
+import { EOL } from 'node:os';
+import { expect } from '../../../deps/jsr.io/@std/expect/1.0.12/mod.js';
+import { describe, it } from '../../../deps/jsr.io/@std/testing/1.0.9/bdd.js';
+import { StringBuilder } from './string-builder.js';
+describe('fromString', () => {
+    it('should create a StringBuilder instance with the given string', () => {
+        const str = 'test string';
+        const sb = StringBuilder.fromString(str);
+        expect(sb.toString()).toEqual(str);
+    });
+    it('should create a StringBuilder instance with the given string and options', () => {
+        const str = 'test string';
+        const options = {
+            newLine: '\r\n',
+        };
+        const sb = StringBuilder.fromString(str, options);
+        expect(sb.toString()).toEqual(str);
+        expect(sb.options).toEqual(expect.objectContaining(options));
+    });
+});
+describe('build', () => {
+    it('should build a string using a StringBuilder build action', () => {
+        const buildAction = (builder) => {
+            builder.append('hello');
+            builder.append('world');
+        };
+        const result = StringBuilder.build(buildAction);
+        expect(result).toEqual('helloworld');
+    });
+    it('should build a string using a StringBuilder build action and options', () => {
+        const buildAction = (builder) => {
+            builder.appendLine('hello');
+            builder.append('world');
+        };
+        const options = {
+            newLine: '\r\n--',
+        };
+        const result = StringBuilder.build(buildAction, options);
+        expect(result).toEqual(`hello${options.newLine}world`);
+    });
+});
+describe('append', () => {
+    it('should append a string to the end of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('hello');
+        expect(sb.toString()).toEqual('hello');
+    });
+    it('should append multiple strings to the end of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('hello', ' ', 'world');
+        expect(sb.toString()).toEqual('hello world');
+    });
+    it('should ignore nullish or empty strings', () => {
+        const sb = new StringBuilder();
+        sb.append('', null, undefined, 'hello');
+        expect(sb.toString()).toEqual('hello');
+    });
+});
+describe('appendLine', () => {
+    it('should append a string followed by a new line to the end of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.appendLine('hello');
+        expect(sb.toString()).toEqual(`hello${EOL}`);
+    });
+    it('should append multiple strings followed by a new line to the end of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.appendLine('hello', 'world');
+        expect(sb.toString()).toEqual(`helloworld${EOL}`);
+    });
+    it('should ignore nullish or empty strings', () => {
+        const sb = new StringBuilder();
+        sb.appendLine('', null, undefined, 'hello');
+        expect(sb.toString()).toEqual(`hello${EOL}`);
+    });
+    it('should append a string followed by a custom new line to the end of the StringBuilder', () => {
+        const options = {
+            newLine: '\r\n--',
+        };
+        const sb = new StringBuilder(options);
+        sb.appendLine('hello');
+        expect(sb.toString()).toEqual(`hello${options.newLine}`);
+    });
+});
+describe('prepend', () => {
+    it('should prepend a string to the beginning of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prepend('hello ');
+        expect(sb.toString()).toEqual('hello world');
+    });
+    it('should prepend multiple strings to the beginning of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prepend('hello ', 'there, ');
+        expect(sb.toString()).toEqual('hello there, world');
+    });
+    it('should ignore nullish or empty strings', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prepend('', null, undefined, 'hello ');
+        expect(sb.toString()).toEqual('hello world');
+    });
+    it('should prepend a string built by another StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prepend((builder) => builder.append('hello '));
+        expect(sb.toString()).toEqual('hello world');
+    });
+    it('should create the StringBuilder for the function with the same options as the current StringBuilder', () => {
+        const options = {
+            newLine: '\r\n--',
+        };
+        const sb = new StringBuilder(options);
+        sb.append('world');
+        sb.prepend((builder) => builder.appendLine('hello '));
+        expect(sb.toString()).toEqual(`hello ${options.newLine}world`);
+    });
+});
+describe('prependLine', () => {
+    it('should prepend a string followed by a new line to the beginning of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prependLine('hello');
+        expect(sb.toString()).toEqual(`hello${EOL}world`);
+    });
+    it('should prepend a string followed by a custom new line to the beginning of the StringBuilder', () => {
+        const options = {
+            newLine: '\r\n--',
+        };
+        const sb = new StringBuilder(options);
+        sb.append('world');
+        sb.prependLine('hello');
+        expect(sb.toString()).toEqual(`hello${options.newLine}world`);
+    });
+    it('should prepend multiple strings followed by a new line to the beginning of the StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prependLine('hello', 'there');
+        expect(sb.toString()).toEqual(`hellothere${EOL}world`);
+    });
+    it('should ignore nullish or empty strings', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prependLine('', null, undefined, 'hello');
+        expect(sb.toString()).toEqual(`hello${EOL}world`);
+    });
+    it('should prepend a string built by another StringBuilder', () => {
+        const sb = new StringBuilder();
+        sb.append('world');
+        sb.prependLine((builder) => builder.append('hello '));
+        expect(sb.toString()).toEqual(`hello ${EOL}world`);
+    });
+    it('should create the StringBuilder for the function with the same options as the current StringBuilder', () => {
+        const options = {
+            newLine: '\r\n--',
+        };
+        const sb = new StringBuilder(options);
+        sb.append('world');
+        sb.prependLine((builder) => builder.appendLine('hello '));
+        expect(sb.toString()).toEqual(`hello ${options.newLine}${options.newLine}world`);
+    });
+});

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/string-builder/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAErH,MAAM,MAAM,gBAAgB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,IACvE,SAAS,GACT,SAAS,CAAC,QAAQ,CAAC,GACnB,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AACpC,MAAM,MAAM,qBAAqB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,IAAI;IAClF,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,IAAI,WAAW,CACnF,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC/E,CAAC;AACF,MAAM,MAAM,gBAAgB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,IAAI;IAC7E,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,eAAe,CAAC,QAAQ,IAAI,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC;AAE/E,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,EAClF,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EACxD,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC3B,qBAAqB,CAAC,QAAQ,CAAC,CAMjC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,EAC7E,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EACnD,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC3B,gBAAgB,CAAC,QAAQ,CAAC,CAM5B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,CAQzE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,EAC/E,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAErC;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,EAC/E,GAAG,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,GACjC,WAAW,CAAC,QAAQ,CAAC,CAEvB"}

package/esm/src/utils/string.utils.d.ts.map

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

package/esm/src/utils/string.utils.test.d.ts

@@ -0,0 +1,2 @@
+import "../../_dnt.test_polyfills.js";
+//# sourceMappingURL=string.utils.test.d.ts.map

package/esm/src/utils/string.utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.test.d.ts","sourceRoot":"","sources":["../../../src/src/utils/string.utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,8BAA8B,CAAC"}