@goast/core 0.3.8 → 0.4.0-beta1

package/{cjs → script}/lib/utils/schema.utils.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveAnyOfAndAllOf = resolveAnyOfAndAllOf;
 exports.getSchemaReference = getSchemaReference;
-const internal_utils_1 = require("../internal-utils");
+const internal_utils_js_1 = require("../internal-utils.js");
 function resolveAnyOfAndAllOf(schema, ignoreNonObjectParts) {
     if (!ignoreNonObjectParts && (hasInvalidSubSchema(schema.anyOf) || hasInvalidSubSchema(schema.allOf))) {
         return undefined;
@@ -115,6 +115,6 @@ function hasInvalidSubSchema(subSchemas) {
 function getSchemaReference(schema, propertiesToIgnore) {
     if (!schema.$ref)
         return schema;
-    const hasPropertiesDefined = Object.keys(schema.$src.originalComponent).some((key) => (0, internal_utils_1.isOpenApiObjectProperty)(key) && !propertiesToIgnore.includes(key));
+    const hasPropertiesDefined = Object.keys(schema.$src.originalComponent).some((key) => (0, internal_utils_js_1.isOpenApiObjectProperty)(key) && !propertiesToIgnore.includes(key));
     return hasPropertiesDefined ? schema : getSchemaReference(schema.$ref, propertiesToIgnore);
 }

package/script/lib/utils/source-builder.d.ts

@@ -0,0 +1,233 @@
+import { type Condition } from './condition.js';
+import { type AppendParam, type AppendValue, StringBuilder, type StringBuilderOptions } from './string-builder/index.js';
+import type { BuilderFn } from './string-builder/string-builder.js';
+import type { Nullable } from './type.utils.js';
+export type IndentOptions = {
+    readonly type: 'tabs';
+} | {
+    readonly type: 'spaces';
+    readonly count: number;
+};
+/**
+ * Options for the `SourceBuilder` class.
+ */
+export type SourceBuilderOptions = StringBuilderOptions & {
+    /**
+     * The type of indentation to use.
+     * @default { type: 'spaces', count: 2 }
+     */
+    indent: IndentOptions;
+};
+/**
+ * Default options for the `SourceBuilder` class.
+ */
+export declare const defaultSourceBuilderOptions: SourceBuilderOptions;
+type KnownParatheses = '()' | '[]' | '{}' | '<>';
+export type Paratheses<TBuilder extends StringBuilder> = KnownParatheses | Omit<string, KnownParatheses> | [open: Nullable<AppendValue<TBuilder>>, close: Nullable<AppendValue<TBuilder>>];
+export type SeparatorBuidlerFn<TBuilder, TItem> = (builder: TBuilder, previousItem: TItem, nextItem: TItem, previousItemIndex: number, nextItemIndex: number) => void;
+export type Separator<TBuilder, TItem> = string | SeparatorBuidlerFn<TBuilder, TItem>;
+/**
+ * Options for the `parenthesize` methods of the `SourceBuilder`.
+ * @see SourceBuilder.parenthesize
+ * @see SourceBuilder.parenthesizeIf
+ */
+export type ParenthesizeOptions = {
+    /**
+     * Whether to add line breaks after start and before end of the parentheses.
+     * @default false
+     */
+    readonly multiline?: boolean;
+    /**
+     * Whether to indent the content inside parentheses.
+     * @default true
+     */
+    readonly indent?: boolean;
+    /**
+     * Whether to pretend that the current line and the one before is empty or consists only of whitespace characters.
+     * This is useful when the parentheses are used as a block and `ensurePreviousLineEmpty` is used.
+     * @default true
+     */
+    readonly pretendEmpty?: boolean;
+};
+/**
+ * Options for the `forEach` methods of the `SourceBuilder`.
+ * @see SourceBuilder.forEach
+ * @see SourceBuilder.forEachIf
+ */
+export type ForEachOptions<TBuilder, TItem> = {
+    /**
+     * The condition to check before adding content for each item. Defaults to `true`.
+     */
+    readonly condition?: Condition<TItem>;
+    /**
+     * The seperator to add between items. Default to `undefined`.
+     */
+    readonly separator?: Separator<TBuilder, TItem>;
+};
+type SwitchCase<TValue, TBuilder extends StringBuilder> = {
+    case: TValue;
+    value: AppendValue<TBuilder>;
+};
+/**
+ * Represents an in-memory source file.
+ */
+export declare class SourceBuilder<TAdditionalAppends = never> extends StringBuilder<TAdditionalAppends> {
+    private readonly __options;
+    private readonly _indentString;
+    private _isLineIndented;
+    private _isLastLineEmpty;
+    private _isCurrentLineEmpty;
+    private _linePrefixNodes;
+    /**
+     * Gets the options used by this instance.
+     */
+    get options(): SourceBuilderOptions;
+    /**
+     * Initializes a new instance of the SourceBuilder class.
+     * @param options The options to use for this instance.
+     */
+    constructor(options?: Partial<SourceBuilderOptions>);
+    /**
+     * Creates a new instance of the SourceBuilder class from a string.
+     * @param str The string to use as the initial content of the builder.
+     * @param options The options to use for this instance.
+     * @returns A new instance of the SourceBuilder class.
+     */
+    static fromString(str: string, options?: Partial<SourceBuilderOptions>): SourceBuilder;
+    /**
+     * Builds a string using a callback function that receives a `SourceBuilder` instance.
+     * @param buildAction The callback function that receives a `SourceBuilder` instance to build the string.
+     * @param options The options to use for the `SourceBuilder` instance.
+     * @returns The string built by the `SourceBuilder` instance.
+     */
+    static build(buildAction: AppendParam<SourceBuilder, never>, options?: Partial<SourceBuilderOptions>): string;
+    protected appendSingle(value: AppendParam<this, TAdditionalAppends>): void;
+    /**
+     * Appends one or more strings to the end of the current SourceBuilder if the specified condition is true.
+     * @param condition The condition to check before appending the specified value.
+     * @param value The string(s) to append.
+     * @returns The current SourceBuilder.
+     */
+    appendIf(condition: Condition, ...value: AppendParam<this, TAdditionalAppends>[]): this;
+    /**
+     * Appends one or more strings to the end of the current SourceBuilder, followed by a line terminator.
+     * @param value The string(s) to append.
+     * @returns The current SourceBuilder.
+     */
+    appendLine(...value: AppendParam<this, TAdditionalAppends>[]): this;
+    /**
+     * Appends one or more strings to the end of the current SourceBuilder, followed by a line terminator, if the specified condition is true.
+     * @param condition The condition to check before appending the specified value.
+     * @param value The string(s) to append.
+     * @returns The current SourceBuilder.
+     */
+    appendLineIf(condition: Condition, ...value: AppendParam<this, TAdditionalAppends>[]): this;
+    /**
+     * Appends the specified values to this source builder with the specified line prefix.
+     * @param {string} prefix - The line prefix to use.
+     * @param {...(string|null|undefined)} value - The values to append.
+     * @returns {SourceBuilder} This source builder instance.
+     */
+    appendWithLinePrefix(prefix: string, ...value: AppendParam<this, TAdditionalAppends>[]): this;
+    /**
+     * Appends the specified values to this source builder as a new line with the specified line prefix.
+     * @param {string} prefix - The line prefix to use.
+     * @param {...(string|null|undefined)} value - The values to append.
+     * @returns {SourceBuilder} This source builder instance.
+     */
+    appendLineWithLinePrefix(prefix: string, ...value: AppendParam<this, TAdditionalAppends>[]): this;
+    /**
+     * Prepends one or more strings to the beginning of the current SourceBuilder if the specified condition is true.
+     * @param condition The condition to check before prepending the specified value.
+     * @param value The string(s) to prepend.
+     * @returns The current SourceBuilder.
+     */
+    prependIf(condition: Condition, ...value: AppendParam<StringBuilder, never>[]): this;
+    /**
+     * Prepends one or more strings to the beginning of the current SourceBuilder, followed by a line terminator, if the specified condition is true.
+     * @param condition The condition to check before appending the specified value.
+     * @param value The string(s) to prepend.
+     * @returns The current SourceBuilder.
+     */
+    prependLineIf(condition: Condition, ...value: AppendParam<StringBuilder, never>[]): this;
+    /**
+     * Ensures that the current line and the one before is empty or consists only of whitespace characters.
+     * @returns A reference to this instance.
+     */
+    ensurePreviousLineEmpty(): this;
+    /**
+     * Ensures that the current line is empty or consists only of whitespace characters.
+     * @returns A reference to this instance.
+     */
+    ensureCurrentLineEmpty(): this;
+    /**
+     * Pretends that the current line and the one before is empty or consists only of whitespace characters.
+     * @returns A reference to this instance.
+     */
+    pretendPreviousLineEmpty(): this;
+    /**
+     * Pretends that the current line is empty or consists only of whitespace characters.
+     * @returns A reference to this instance.
+     */
+    pretendCurrentLineEmpty(): this;
+    /**
+     * Inserts specified content if the specified condition is true.
+     * @param condition The condition to check before inserting content.
+     * @param builderFn The function to add content if the condition is true.
+     * @param elseBuilderFn The function to add content if the condition is false.
+     * @returns A reference to this instance.
+     */
+    if(condition: Condition, builderFn: AppendParam<this, TAdditionalAppends>, elseBuilderFn?: AppendParam<this, TAdditionalAppends>): this;
+    switch<T extends string | number>(value: T, cases: Record<T, AppendParam<this, TAdditionalAppends>>, defaultBuilderFn?: AppendParam<this, TAdditionalAppends>): this;
+    switch<T>(value: T, cases: SwitchCase<T, this>[], defaultBuilderFn?: AppendParam<this, TAdditionalAppends>, equals?: (a: T, b: T) => boolean): this;
+    /**
+     * Adds one indentation level. If the current line already contains characters, only subsequent lines are affected.
+     * @param builderFn The function to add indented content or the content itself.
+     * @param condition The condition to check before adding indentation.
+     * @returns A reference to this instance.
+     */
+    indent(value: AppendParam<this, TAdditionalAppends>): this;
+    /**
+     * Adds one indentation level if the specified condition is true. If the current line already contains characters, only subsequent lines are affected.
+     * @param builderFn The function to add indented content or the content itself.
+     * @param condition The condition to check before adding indentation.
+     * @returns A reference to this instance.
+     */
+    indentIf(condition: Condition, value: AppendParam<this, TAdditionalAppends>): this;
+    /**
+     * Adds parentheses around the specified content.
+     * @param brackets The brackets to use.
+     * @param value The function to add content inside parentheses or one string that should be parenthesized.
+     * @param options Options for the parentheses.
+     * @returns A reference to this instance.
+     */
+    parenthesize(brackets: Paratheses<this>, value: AppendParam<this, TAdditionalAppends>, options?: ParenthesizeOptions): this;
+    /**
+     * Adds parentheses around the specified content if the specified condition is true.
+     * @param condition The condition to check before adding parentheses.
+     * @param brackets The brackets to use.
+     * @param value The function to add content inside parentheses or one string that should be parenthesized.
+     * @param options Options for the parentheses.
+     * @returns A reference to this instance.
+     */
+    parenthesizeIf(condition: Condition, brackets: Paratheses<this>, value: AppendParam<this, TAdditionalAppends>, options?: ParenthesizeOptions): this;
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param builderFn The function to add content for each item.
+     * @param options The options for the loop.
+     * @returns A reference to this instance.
+     */
+    forEach<T>(items: Iterable<T>, builderFn: (builder: this, item: T, index: number) => void, options?: ForEachOptions<this, T>): this;
+    forEachIf<T>(condition: Condition, items: Iterable<T>, builderFn: (builder: this, item: T, index: number) => void, options?: ForEachOptions<this, T>): this;
+    appendSeparated(items: Iterable<AppendParam<this, TAdditionalAppends>>, separator: string): this;
+    appendSeparatedIf(condition: Condition, items: Iterable<AppendParam<this, TAdditionalAppends>>, separator: string): this;
+    private appendIndent;
+}
+declare function _builderTemplate<T extends SourceBuilder>(template: readonly string[] | ArrayLike<string>, ...substitutions: AppendValue<T>[]): BuilderFn<T>;
+declare const _builderTemplateExtensions: {
+    readonly indent: <T extends SourceBuilder>(template: readonly string[] | ArrayLike<string>, ...substitutions: AppendValue<T>[]) => BuilderFn<T>;
+};
+export declare const builderTemplate: typeof _builderTemplate & typeof _builderTemplateExtensions;
+export {};
+//# sourceMappingURL=source-builder.d.ts.map

package/script/lib/utils/source-builder.d.ts.map

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

package/{cjs → script}/lib/utils/source-builder.js

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.builderTemplate = exports.SourceBuilder = exports.defaultSourceBuilderOptions = void 0;
-const common_utils_1 = require("./common.utils");
-const condition_1 = require("./condition");
-const string_builder_1 = require("./string-builder");
-const string_utils_1 = require("./string.utils");
+const common_utils_js_1 = require("./common.utils.js");
+const condition_js_1 = require("./condition.js");
+const index_js_1 = require("./string-builder/index.js");
+const string_utils_js_1 = require("./string.utils.js");
 /**
  * Default options for the `SourceBuilder` class.
  */
 exports.defaultSourceBuilderOptions = {
-    ...string_builder_1.defaultStringBuilderOptions,
+    ...index_js_1.defaultStringBuilderOptions,
     indent: { type: 'spaces', count: 2 },
 };
 /**
  * Represents an in-memory source file.
  */
-class SourceBuilder extends string_builder_1.StringBuilder {
+class SourceBuilder extends index_js_1.StringBuilder {
     /**
      * Gets the options used by this instance.
      */
@@ -28,10 +28,42 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      */
     constructor(options) {
         super(options);
-        this._isLineIndented = false;
-        this._isLastLineEmpty = true;
-        this._isCurrentLineEmpty = true;
-        this._linePrefixNodes = [];
+        Object.defineProperty(this, "__options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_indentString", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_isLineIndented", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "_isLastLineEmpty", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        Object.defineProperty(this, "_isCurrentLineEmpty", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        Object.defineProperty(this, "_linePrefixNodes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
         this.__options = { ...exports.defaultSourceBuilderOptions, ...options };
         this._indentString = this.__options.indent.type === 'tabs' ? '\t' : ' '.repeat(this.__options.indent.count);
     }
@@ -59,7 +91,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
     }
     appendSingle(value) {
         var _a;
-        if ((0, common_utils_1.isNullish)(value))
+        if ((0, common_utils_js_1.isNullish)(value))
             return;
         if (Array.isArray(value)) {
             for (const part of value) {
@@ -94,13 +126,13 @@ class SourceBuilder extends string_builder_1.StringBuilder {
                     if (!this._isLineIndented) {
                         this.appendIndent();
                     }
-                    this.str += (0, string_utils_1.removeStr)(value.substring(lineStartIndex, i), '\r');
+                    this.str += (0, string_utils_js_1.removeStr)(value.substring(lineStartIndex, i), '\r');
                 }
                 this._isLastLineEmpty = this._isCurrentLineEmpty;
                 if (this._isCurrentLineEmpty && this._linePrefixNodes.some((x) => x.kind !== 'indent')) {
                     this.appendIndent();
                 }
-                this.str = (0, string_utils_1.trimEnd)(this.str, false) + '\n';
+                this.str = (0, string_utils_js_1.trimEnd)(this.str, false) + '\n';
                 this._isLineIndented = false;
                 this._isCurrentLineEmpty = true;
                 lineStartIndex = i + 1;
@@ -113,7 +145,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
             this.appendIndent();
             this._isLineIndented = true;
         }
-        this.str += (0, string_utils_1.removeStr)(value.substring(lineStartIndex), '\r');
+        this.str += (0, string_utils_js_1.removeStr)(value.substring(lineStartIndex), '\r');
     }
     /**
      * Appends one or more strings to the end of the current SourceBuilder if the specified condition is true.
@@ -122,7 +154,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      * @returns The current SourceBuilder.
      */
     appendIf(condition, ...value) {
-        if ((0, condition_1.evalCondition)(condition)) {
+        if ((0, condition_js_1.evalCondition)(condition)) {
             return this.append(...value);
         }
         return this;
@@ -142,7 +174,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      * @returns The current SourceBuilder.
      */
     appendLineIf(condition, ...value) {
-        if ((0, condition_1.evalCondition)(condition)) {
+        if ((0, condition_js_1.evalCondition)(condition)) {
             return this.appendLine(...value);
         }
         return this;
@@ -179,7 +211,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      * @returns The current SourceBuilder.
      */
     prependIf(condition, ...value) {
-        if ((0, condition_1.evalCondition)(condition)) {
+        if ((0, condition_js_1.evalCondition)(condition)) {
             this.prepend(...value);
         }
         return this;
@@ -191,7 +223,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      * @returns The current SourceBuilder.
      */
     prependLineIf(condition, ...value) {
-        if ((0, condition_1.evalCondition)(condition)) {
+        if ((0, condition_js_1.evalCondition)(condition)) {
             this.prependLine(...value);
         }
         return this;
@@ -244,7 +276,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      * @returns A reference to this instance.
      */
     if(condition, builderFn, elseBuilderFn) {
-        return (0, condition_1.evalCondition)(condition) ? this.append(builderFn) : this.append(elseBuilderFn);
+        return (0, condition_js_1.evalCondition)(condition) ? this.append(builderFn) : this.append(elseBuilderFn);
     }
     switch(value, cases, defaultBuilderFn, equals) {
         var _a;
@@ -284,7 +316,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      * @returns A reference to this instance.
      */
     indentIf(condition, value) {
-        return (0, condition_1.evalCondition)(condition) ? this.indent(value) : this.append(value);
+        return (0, condition_js_1.evalCondition)(condition) ? this.indent(value) : this.append(value);
     }
     /**
      * Adds parentheses around the specified content.
@@ -326,7 +358,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
      * @returns A reference to this instance.
      */
     parenthesizeIf(condition, brackets, value, options) {
-        if ((0, condition_1.evalCondition)(condition)) {
+        if ((0, condition_js_1.evalCondition)(condition)) {
             return this.parenthesize(brackets, value, options);
         }
         else if (options === null || options === void 0 ? void 0 : options.indent) {
@@ -354,7 +386,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
         let previousItem = undefined;
         let index = 0;
         for (const item of items) {
-            if ((0, condition_1.evalCondition)(condition, item)) {
+            if ((0, condition_js_1.evalCondition)(condition, item)) {
                 if (previousIndex >= 0 && seperator) {
                     if (typeof seperator === 'string') {
                         this.append(seperator);
@@ -372,7 +404,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
         return this;
     }
     forEachIf(condition, items, builderFn, options) {
-        if ((0, condition_1.evalCondition)(condition)) {
+        if ((0, condition_js_1.evalCondition)(condition)) {
             return this.forEach(items, builderFn, options);
         }
         return this;
@@ -381,7 +413,7 @@ class SourceBuilder extends string_builder_1.StringBuilder {
         return this.forEach(items, (builder, item) => builder.append(item), { separator });
     }
     appendSeparatedIf(condition, items, separator) {
-        if ((0, condition_1.evalCondition)(condition)) {
+        if ((0, condition_js_1.evalCondition)(condition)) {
             return this.appendSeparated(items, separator);
         }
         return this;
@@ -410,8 +442,9 @@ function _builderTemplate(template, ...substitutions) {
         }
     };
 }
-exports.builderTemplate = Object.assign(_builderTemplate, {
+const _builderTemplateExtensions = {
     indent: (template, ...substitutions) => {
         return (b) => b.indent(_builderTemplate(template, ...substitutions));
     },
-});
+};
+exports.builderTemplate = Object.assign(_builderTemplate, _builderTemplateExtensions);

package/script/lib/utils/string-builder/index.d.ts

@@ -0,0 +1,4 @@
+export * from './options.js';
+export { type AppendParam, StringBuilder } from './string-builder.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/script/lib/utils/string-builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/string-builder/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACtE,cAAc,YAAY,CAAC"}

package/script/lib/utils/string-builder/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringBuilder = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./options.js"), exports);
+var string_builder_js_1 = require("./string-builder.js");
+Object.defineProperty(exports, "StringBuilder", { enumerable: true, get: function () { return string_builder_js_1.StringBuilder; } });
+tslib_1.__exportStar(require("./utils.js"), exports);

package/script/lib/utils/string-builder/options.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Options for the `StringBuilder` class.
+ */
+export type StringBuilderOptions = {
+    /**
+     * The string to use for new lines.
+     * @default os.EOL
+     */
+    readonly newLine: string;
+};
+/**
+ * Default options for the `StringBuilder` class.
+ */
+export declare const defaultStringBuilderOptions: StringBuilderOptions;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/lib/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/{cjs → script}/lib/utils/string-builder/options.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultStringBuilderOptions = void 0;
-const os_1 = require("os");
+const node_os_1 = require("node:os");
 /**
  * Default options for the `StringBuilder` class.
  */
 exports.defaultStringBuilderOptions = {
-    newLine: os_1.EOL,
+    newLine: node_os_1.EOL,
 };

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

@@ -0,0 +1,73 @@
+import { type StringBuilderOptions } from './options.js';
+import type { Nullable, SingleOrMultiple } from '../type.utils.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/lib/utils/string-builder/string-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-builder.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/string-builder/string-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEtF,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEnE,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"}

package/{cjs → script}/lib/utils/string-builder/string-builder.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StringBuilder = exports.AdditionalAppendsSymbol = void 0;
-const options_1 = require("./options");
-const common_utils_1 = require("../common.utils");
+const options_js_1 = require("./options.js");
+const common_utils_js_1 = require("../common.utils.js");
 exports.AdditionalAppendsSymbol = Symbol('AdditionalAppends');
 /**
  * Represents a mutable string of characters.
@@ -19,8 +19,19 @@ class StringBuilder {
      * @param options The options.
      */
     constructor(options) {
-        this.str = '';
-        this._options = { ...options_1.defaultStringBuilderOptions, ...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 = { ...options_js_1.defaultStringBuilderOptions, ...options };
     }
     /**
      * Creates a new StringBuilder instance and appends the specified string to it.
@@ -45,7 +56,7 @@ class StringBuilder {
         return builder.toString();
     }
     appendSingle(value) {
-        if ((0, common_utils_1.isNullish)(value))
+        if ((0, common_utils_js_1.isNullish)(value))
             return;
         if (Array.isArray(value)) {
             for (const part of value) {
@@ -101,7 +112,7 @@ class StringBuilder {
      */
     prepend(...value) {
         for (const part of value.reverse()) {
-            if ((0, common_utils_1.isNullish)(part))
+            if ((0, common_utils_js_1.isNullish)(part))
                 continue;
             if (typeof part === 'function') {
                 const builder = new StringBuilder(this.options);