@goast/core 0.0.1

package/dist/lib/utils/schema.utils.js

@@ -0,0 +1,50 @@
+import { isOpenApiObjectProperty } from '../internal-utils';
+export function resolveAnyOfAndAllOf(schema, ignoreNonObjectParts) {
+    if (!ignoreNonObjectParts && (hasInvalidSubSchema(schema.anyOf) || hasInvalidSubSchema(schema.allOf))) {
+        return undefined;
+    }
+    const required = new Set(schema.required);
+    const properties = new Map();
+    collectSubSchemaProperties(schema.allOf, properties, required, false);
+    collectSubSchemaProperties(schema.anyOf, properties, required, true);
+    if (properties.size === 0) {
+        return undefined;
+    }
+    return Object.assign(Object.assign({}, schema), { kind: 'object', type: 'object', anyOf: [], allOf: [], properties: properties, required: required, additionalProperties: false });
+}
+function collectSubSchemaProperties(subSchemas, properties, required, optional) {
+    for (const subSchema of subSchemas) {
+        if (subSchema.kind === 'object') {
+            for (const prop of subSchema.properties.values()) {
+                if (!properties.has(prop.name)) {
+                    properties.set(prop.name, prop);
+                }
+            }
+            if (!optional) {
+                for (const prop of subSchema.required) {
+                    required.add(prop);
+                }
+            }
+        }
+        if (subSchema.kind === 'object' || subSchema.kind === 'combined') {
+            collectSubSchemaProperties(subSchema.allOf, properties, required, optional);
+            collectSubSchemaProperties(subSchema.anyOf, properties, required, true);
+        }
+    }
+}
+function hasInvalidSubSchema(subSchemas) {
+    return subSchemas.some((x) => x.kind !== 'object' && (x.kind !== 'combined' || (!hasInvalidSubSchema(x.allOf) && !hasInvalidSubSchema(x.anyOf))));
+}
+/**
+ * Retrieves the first schema reference and the reference chain of a given schema that
+ * defines some schema properties. (e.g. schemas with just "$ref" are skipped)
+ * @param schema The schema to retrieve the reference from.
+ * @param propertiesToIgnore The properties to ignore when checking for a schema definition.
+ */
+export function getSchemaReference(schema, propertiesToIgnore) {
+    if (!schema.$ref)
+        return schema;
+    const hasPropertiesDefined = Object.keys(schema.$src.originalComponent).some((key) => isOpenApiObjectProperty(key) && !propertiesToIgnore.includes(key));
+    return hasPropertiesDefined ? schema : getSchemaReference(schema.$ref, propertiesToIgnore);
+}
+//# sourceMappingURL=schema.utils.js.map

package/dist/lib/utils/schema.utils.js.map

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

package/dist/lib/utils/source-builder.cjs

@@ -0,0 +1,378 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SourceBuilder = exports.defaultSourceBuilderOptions = void 0;
+const os_1 = require("os");
+const condition_1 = require("./condition");
+const string_utils_1 = require("./string.utils");
+exports.defaultSourceBuilderOptions = {
+    indent: { type: 'spaces', count: 2 },
+    newLine: os_1.EOL,
+    charsTreatedAsEmptyLine: ['{'],
+};
+/**
+ * Represents an in-memory source file.
+ */
+class SourceBuilder extends string_utils_1.StringBuilder {
+    /**
+     * Gets the options used by this instance.
+     */
+    get options() {
+        return this.__options;
+    }
+    /**
+     * Initializes a new instance of the SourceBuilder class.
+     * @param options The options to use for this instance.
+     */
+    constructor(options) {
+        super(options);
+        this._linePrefix = '';
+        this._isLineIndented = false;
+        this._isLastLineEmpty = true;
+        this._isCurrentLineEmpty = true;
+        /**
+         * Gets or sets the current indentation level.
+         */
+        this.currentIndentLevel = 0;
+        this.__options = Object.assign(Object.assign({}, exports.defaultSourceBuilderOptions), options);
+        this._emptyLineCharRegex = new RegExp(`[\\s${this.__options.charsTreatedAsEmptyLine.join('')}]`);
+        this._indentString = this.__options.indent.type === 'tabs' ? '\t' : ' '.repeat(this.__options.indent.count);
+    }
+    /**
+     * 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, options) {
+        const builder = new SourceBuilder(options);
+        builder.append(str);
+        return builder;
+    }
+    /**
+     * 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, options) {
+        const builder = new SourceBuilder(options);
+        buildAction(builder);
+        return builder.toString();
+    }
+    /**
+     * Appends one or more strings to the end of the current SourceBuilder.
+     * @param value The string(s) to append.
+     * @returns The current SourceBuilder.
+     */
+    append(...value) {
+        if (value.length === 0 || !value.some((v) => v && v.length > 0)) {
+            return this;
+        }
+        const str = value.join('');
+        let lineStartIndex = 0;
+        for (let i = 0; i < str.length; i++) {
+            if (str[i] === '\r')
+                continue;
+            if (str[i] === '\n') {
+                let lineLength = i - lineStartIndex;
+                for (let j = i; j > 0 && str[j - 1] === '\r'; j--) {
+                    lineLength--;
+                }
+                if (lineLength > 0) {
+                    if (!this._isLineIndented) {
+                        this.appendIndent();
+                    }
+                    super.append(str.substring(lineStartIndex, i).replace(/\r/g, ''));
+                }
+                this._isLastLineEmpty = this._isCurrentLineEmpty;
+                super.append(this.__options.newLine);
+                this._isCurrentLineEmpty = true;
+                this._isLineIndented = false;
+                lineStartIndex = i + 1;
+            }
+            if (!this._emptyLineCharRegex.test(str[i])) {
+                this._isCurrentLineEmpty = false;
+            }
+        }
+        if (!this._isLineIndented && lineStartIndex < str.length) {
+            this.appendIndent();
+            this._isLineIndented = true;
+        }
+        super.append(str.substring(lineStartIndex).replace(/\r/g, ''));
+        return 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) {
+        return this.append(...value, '\n');
+    }
+    /**
+     * 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, ...value) {
+        return (0, condition_1.evalCondition)(condition) ? this.append(...value) : 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, ...value) {
+        return (0, condition_1.evalCondition)(condition) ? this.appendLine(...value) : 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, ...value) {
+        return this.applyWithLinePrefix(prefix, (builder) => builder.append(...value));
+    }
+    /**
+     * 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, ...value) {
+        return this.applyWithLinePrefix(prefix, (builder) => builder.appendLine(...value));
+    }
+    /**
+     * 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, ...value) {
+        return (0, condition_1.evalCondition)(condition) ? this.prepend(...value) : 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, ...value) {
+        return (0, condition_1.evalCondition)(condition) ? this.prependLine(...value) : this;
+    }
+    /**
+     * Applies the provided builder function to this source builder.
+     * @param builderFn The builder function to apply.
+     * @returns This source builder instance.
+     */
+    apply(builderFn) {
+        builderFn(this);
+        return this;
+    }
+    /**
+     * Applies the provided builder function to this source builder with the specified line prefix.
+     * @param prefix The line prefix to use.
+     * @param builderFn The builder function to apply.
+     * @returns This source builder instance.
+     */
+    applyWithLinePrefix(prefix, builderFn) {
+        const previousLinePrefix = this._linePrefix;
+        this._linePrefix += prefix;
+        try {
+            builderFn(this);
+        }
+        finally {
+            this._linePrefix = previousLinePrefix;
+        }
+        return this;
+    }
+    /**
+     * Ensures that the current line is empty or consists only of whitespace characters.
+     * @returns A reference to this instance.
+     */
+    ensurePreviousLineEmpty() {
+        if (!this._isCurrentLineEmpty) {
+            this.appendLine();
+        }
+        if (!this._isLastLineEmpty) {
+            this.appendLine();
+        }
+        return this;
+    }
+    /**
+     * Ensures that the current line is empty or consists only of whitespace characters.
+     * @returns A reference to this instance.
+     */
+    ensureCurrentLineEmpty() {
+        if (!this._isCurrentLineEmpty) {
+            this.appendLine();
+        }
+        return 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.
+     * @returns A reference to this instance.
+     */
+    applyIf(condition, builderFn) {
+        if ((0, condition_1.evalCondition)(condition)) {
+            builderFn(this);
+        }
+        return this;
+    }
+    /**
+     * Inserts specified content depending on the specified condition.
+     * @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.
+     */
+    applyIfElse(condition, builderFn, elseBuilderFn) {
+        if ((0, condition_1.evalCondition)(condition)) {
+            builderFn(this);
+        }
+        else {
+            elseBuilderFn(this);
+        }
+        return 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.
+     * @param condition The condition to check before adding indentation.
+     * @returns A reference to this instance.
+     */
+    indent(builderFn, condition = true) {
+        const shouldIndent = (0, condition_1.evalCondition)(condition);
+        if (shouldIndent) {
+            this.currentIndentLevel++;
+        }
+        try {
+            builderFn(this);
+        }
+        finally {
+            if (shouldIndent) {
+                this.currentIndentLevel--;
+            }
+        }
+        return this;
+    }
+    /**
+     * Adds parentheses around the specified content and adds one indentation level.
+     * @param brackets The brackets to use.
+     * @param builderFn The function to add content inside parentheses.
+     * @param indent Whether to indent the content inside parentheses. Defaults to `true`.
+     * @returns A reference to this instance.
+     */
+    parenthesize(brackets, builderFn, indent = true) {
+        var _a, _b;
+        this.append((_a = brackets[0]) !== null && _a !== void 0 ? _a : '');
+        this.indent(builderFn, indent);
+        this.append((_b = brackets[1]) !== null && _b !== void 0 ? _b : '');
+        return 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 builderFn The function to add content inside parentheses.
+     * @param indent Whether to indent the content inside parentheses. Defaults to `true`.
+     * @returns A reference to this instance.
+     */
+    parenthesizeIf(condition, brackets, builderFn, indent) {
+        if ((0, condition_1.evalCondition)(condition)) {
+            this.parenthesize(brackets, builderFn, indent !== null && indent !== void 0 ? indent : true);
+        }
+        else {
+            this.indent(builderFn, indent !== null && indent !== void 0 ? indent : false);
+        }
+        return 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.
+     * @returns A reference to this instance.
+     */
+    forEach(items, builderFn) {
+        return this.forEachImpl(items, builderFn);
+    }
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param condition The condition to check before adding content.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachIf(items, condition, builderFn) {
+        return (0, condition_1.evalCondition)(condition) ? this.forEachImpl(items, builderFn) : this;
+    }
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param condition The condition to check before adding content for each item.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachMatching(items, condition, builderFn) {
+        return this.forEachImpl(items, builderFn, undefined, condition);
+    }
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param seperator The seperator to add between items.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachSeparated(items, seperator, builderFn) {
+        return this.forEachImpl(items, builderFn, seperator);
+    }
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param condition The condition to check before adding content for each item.
+     * @param seperator The seperator to add between items.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachMatchingSeparated(items, condition, seperator, builderFn) {
+        return this.forEachImpl(items, builderFn, seperator, condition);
+    }
+    forEachImpl(items, builderFn, seperator, condition = true) {
+        if (condition === false)
+            return this;
+        let previousIndex = -1;
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        let previousItem = undefined;
+        let index = 0;
+        for (const item of items) {
+            if ((0, condition_1.evalCondition)(condition, item)) {
+                if (previousIndex >= 0 && seperator) {
+                    if (typeof seperator === 'string') {
+                        this.append(seperator);
+                    }
+                    else {
+                        seperator(this, previousItem, item, previousIndex, index);
+                    }
+                }
+                builderFn(this, item, index);
+                previousIndex = index;
+                previousItem = item;
+            }
+            index++;
+        }
+        return this;
+    }
+    appendIndent() {
+        super.append(this._indentString.repeat(this.currentIndentLevel));
+        if (this._linePrefix) {
+            super.append(this._linePrefix);
+        }
+    }
+}
+exports.SourceBuilder = SourceBuilder;
+//# sourceMappingURL=source-builder.js.map

package/dist/lib/utils/source-builder.cjs.map

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

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

@@ -0,0 +1,216 @@
+import { Condition } from './condition';
+import { StringBuilder, StringBuilderOptions } from './string.utils';
+import { Nullable } from './type.utils';
+export type IndentOptions = {
+    readonly type: 'tabs';
+} | {
+    readonly type: 'spaces';
+    readonly count: number;
+};
+export type SourceBuilderOptions = StringBuilderOptions & {
+    indent: IndentOptions;
+    charsTreatedAsEmptyLine: string[];
+};
+export declare const defaultSourceBuilderOptions: SourceBuilderOptions;
+type KnownParatheses = '()' | '[]' | '{}' | '<>';
+export type Paratheses = KnownParatheses | Omit<string, KnownParatheses> | [open: Nullable<string>, close: Nullable<string>];
+export type SeparatorBuidlerFn<TBuilder extends SourceBuilder, TItem> = (builder: TBuilder, previousItem: TItem, nextItem: TItem, previousItemIndex: number, nextItemIndex: number) => void;
+export type Separator<TBuilder extends SourceBuilder, TItem> = string | SeparatorBuidlerFn<TBuilder, TItem>;
+/**
+ * Represents an in-memory source file.
+ */
+export declare class SourceBuilder extends StringBuilder {
+    private readonly __options;
+    private readonly _emptyLineCharRegex;
+    private readonly _indentString;
+    private _linePrefix;
+    private _isLineIndented;
+    private _isLastLineEmpty;
+    private _isCurrentLineEmpty;
+    /**
+     * Gets or sets the current indentation level.
+     */
+    currentIndentLevel: number;
+    /**
+     * 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: (builder: SourceBuilder) => void, options?: Partial<SourceBuilderOptions>): string;
+    /**
+     * Appends one or more strings to the end of the current SourceBuilder.
+     * @param value The string(s) to append.
+     * @returns The current SourceBuilder.
+     */
+    append(...value: Nullable<string>[]): 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: Nullable<string>[]): this;
+    /**
+     * 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: Nullable<string>[]): 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: Nullable<string>[]): 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: Nullable<string>[]): 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: Nullable<string>[]): 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: Nullable<string | ((builder: StringBuilder) => void)>[]): 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: Nullable<string | ((builder: StringBuilder) => void)>[]): this;
+    /**
+     * Applies the provided builder function to this source builder.
+     * @param builderFn The builder function to apply.
+     * @returns This source builder instance.
+     */
+    apply(builderFn: (builder: this) => void): this;
+    /**
+     * Applies the provided builder function to this source builder with the specified line prefix.
+     * @param prefix The line prefix to use.
+     * @param builderFn The builder function to apply.
+     * @returns This source builder instance.
+     */
+    applyWithLinePrefix(prefix: string, builderFn: (builder: this) => void): this;
+    /**
+     * Ensures that the current line 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;
+    /**
+     * 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.
+     * @returns A reference to this instance.
+     */
+    applyIf(condition: Condition, builderFn: (builder: this) => void): this;
+    /**
+     * Inserts specified content depending on the specified condition.
+     * @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.
+     */
+    applyIfElse(condition: Condition, builderFn: (builder: this) => void, elseBuilderFn: (builder: this) => void): 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.
+     * @param condition The condition to check before adding indentation.
+     * @returns A reference to this instance.
+     */
+    indent(builderFn: (builder: this) => void, condition?: Condition): this;
+    /**
+     * Adds parentheses around the specified content and adds one indentation level.
+     * @param brackets The brackets to use.
+     * @param builderFn The function to add content inside parentheses.
+     * @param indent Whether to indent the content inside parentheses. Defaults to `true`.
+     * @returns A reference to this instance.
+     */
+    parenthesize(brackets: Paratheses, builderFn: (builder: this) => void, indent?: boolean): 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 builderFn The function to add content inside parentheses.
+     * @param indent Whether to indent the content inside parentheses. Defaults to `true`.
+     * @returns A reference to this instance.
+     */
+    parenthesizeIf(condition: Condition, brackets: Paratheses, builderFn: (builder: this) => void, indent?: boolean): 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.
+     * @returns A reference to this instance.
+     */
+    forEach<T>(items: Iterable<T>, builderFn: (builder: this, item: T, index: number) => void): this;
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param condition The condition to check before adding content.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachIf<T>(items: Iterable<T>, condition: Condition, builderFn: (builder: this, item: T, index: number) => void): this;
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param condition The condition to check before adding content for each item.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachMatching<T>(items: Iterable<T>, condition: Condition<T>, builderFn: (builder: this, item: T, index: number) => void): this;
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param seperator The seperator to add between items.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachSeparated<T>(items: Iterable<T>, seperator: Separator<this, T>, builderFn: (builder: this, item: T, index: number) => void): this;
+    /**
+     * Adds content for each item in the specified array.
+     * @param items The items to add content for.
+     * @param condition The condition to check before adding content for each item.
+     * @param seperator The seperator to add between items.
+     * @param builderFn The function to add content for each item.
+     * @returns A reference to this instance.
+     */
+    forEachMatchingSeparated<T>(items: Iterable<T>, condition: Condition<T>, seperator: Separator<this, T>, builderFn: (builder: this, item: T, index: number) => void): this;
+    private forEachImpl;
+    private appendIndent;
+}
+export {};