@breadstone-infrastructure/utilities 0.0.12-beta.0

package/IO/Glob.d.ts

@@ -0,0 +1,35 @@
+import fastGlob from 'fast-glob';
+/**
+ * Represents the `IGlobOptions` interface.
+ *
+ * @public
+ */
+export interface IGlobOptions extends fastGlob.Options {
+    expandDirectories?: boolean | ReadonlyArray<string> | {
+        files?: ReadonlyArray<string>;
+        extensions?: ReadonlyArray<string>;
+    };
+}
+/**
+ * The `Glob` class.
+ *
+ * @public
+ */
+export declare class Glob {
+    /**
+     * @public
+     * @static
+     */
+    static match(patterns: string | ReadonlyArray<string>, options?: IGlobOptions): Promise<Array<fastGlob.Entry>>;
+    /**
+     * @public
+     * @static
+     */
+    static matchSync(patterns: string | ReadonlyArray<string>, options?: IGlobOptions): Array<fastGlob.Entry>;
+    /**
+     * @private
+     * @static
+     */
+    private static generateGlobTasks;
+}
+//# sourceMappingURL=Glob.d.ts.map

package/IO/Glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Glob.d.ts","sourceRoot":"","sources":["../../src/IO/Glob.ts"],"names":[],"mappings":"AAGA,OAAO,QAAwB,MAAM,WAAW,CAAC;AAKjD;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ,CAAC,OAAO;IAIlD,iBAAiB,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG;QAClD,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KACtC,CAAC;CAIL;AAED;;;;GAIG;AACH,qBAAa,IAAI;IAIb;;;OAGG;WACiB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IA0B3H;;;OAGG;WACW,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;IAmBhH;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CA4DnC"}

package/IO/Glob.js

@@ -0,0 +1,152 @@
+"use strict";
+// #region Imports
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Glob = void 0;
+const dir_glob_1 = __importDefault(require("dir-glob"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const fs_1 = __importDefault(require("fs"));
+/**
+ * The `Glob` class.
+ *
+ * @public
+ */
+class Glob {
+    // #region Methods
+    /**
+     * @public
+     * @static
+     */
+    static async match(patterns, options) {
+        const globTasks = Glob.generateGlobTasks(patterns, options);
+        const getFilter = async () => (_entry) => false;
+        const getTasks = async () => {
+            const tasks = await Promise.all(globTasks.map(async (task) => {
+                const globs = await getPattern(task, dir_glob_1.default);
+                return Promise.all(globs.map(globToTask(task)));
+            }));
+            return arrayUnion(...tasks);
+        };
+        const [filter, tasks] = await Promise.all([
+            getFilter(),
+            getTasks()
+        ]);
+        const paths = await Promise.all(tasks.map((task) => (0, fast_glob_1.default)(task.pattern, task.options)));
+        const getPathString = (p) => p.stats instanceof fs_1.default.Stats ? p.path : p;
+        return arrayUnion(...paths).filter((x) => !filter(getPathString(x)));
+    }
+    /**
+     * @public
+     * @static
+     */
+    static matchSync(patterns, options) {
+        const globTasks = Glob.generateGlobTasks(patterns, options);
+        const tasks = [];
+        for (const task of globTasks) {
+            const newTask = getPattern(task, dir_glob_1.default.sync).map(globToTaskSync(task));
+            tasks.push(...newTask);
+        }
+        const filter = (_options) => false;
+        let matches = [];
+        for (const task of tasks) {
+            matches = arrayUnion(matches, fast_glob_1.default.sync(task.pattern, task.options));
+        }
+        return matches.filter((x) => !filter(x));
+    }
+    /**
+     * @private
+     * @static
+     */
+    static generateGlobTasks(patterns, taskOptions) {
+        if (taskOptions) {
+            taskOptions = {
+                ...taskOptions,
+                objectMode: true
+            };
+        }
+        patterns = arrayUnion([patterns].flat());
+        if (!patterns.every((pattern) => typeof pattern === 'string')) {
+            throw new TypeError('Patterns must be a string or an array of strings');
+        }
+        if (taskOptions?.cwd) {
+            const stat = fs_1.default.statSync(taskOptions.cwd);
+            if (!stat.isDirectory()) {
+                throw new Error('The `cwd` option must be a path to a directory');
+            }
+        }
+        const globTasks = new Array();
+        taskOptions = {
+            ignore: [],
+            expandDirectories: true,
+            ...taskOptions
+        };
+        for (const [index, pattern] of patterns.entries()) {
+            if (pattern.startsWith('!')) {
+                continue;
+            }
+            const ignore = patterns
+                .slice(index)
+                .filter((x) => x.startsWith('!'))
+                .map((pattern) => pattern.slice(1));
+            const options = {
+                ...taskOptions,
+                ignore: [
+                    ...taskOptions.ignore ?? [],
+                    ...ignore
+                ]
+            };
+            globTasks.push({
+                pattern,
+                options
+            });
+        }
+        return globTasks;
+    }
+}
+exports.Glob = Glob;
+function getPattern(task, fn) {
+    return task.options.expandDirectories
+        ? globDirectories(task, fn)
+        : [task.pattern];
+}
+function globDirectories(task, fn) {
+    let options = {};
+    if (task.options.cwd) {
+        options.cwd = task.options.cwd;
+    }
+    if (Array.isArray(task.options.expandDirectories)) {
+        options = {
+            ...options,
+            files: task.options.expandDirectories
+        };
+    }
+    else if (typeof task.options.expandDirectories === 'object') {
+        options = {
+            ...options,
+            ...task.options.expandDirectories
+        };
+    }
+    return fn(task.pattern, options);
+}
+const globToTask = (task) => async (glob) => {
+    if (task.options.ignore && Array.isArray(task.options.ignore) && task.options.expandDirectories) {
+        task.options.ignore = await (0, dir_glob_1.default)(task.options.ignore);
+    }
+    return {
+        pattern: glob,
+        options: task.options
+    };
+};
+const globToTaskSync = (task) => (glob) => {
+    if (task.options.ignore && Array.isArray(task.options.ignore) && task.options.expandDirectories) {
+        task.options.ignore = dir_glob_1.default.sync(task.options.ignore);
+    }
+    return {
+        pattern: glob,
+        options: task.options
+    };
+};
+const arrayUnion = (...args) => [...new Set(args.flat())];
+//# sourceMappingURL=Glob.js.map

package/IO/Glob.js.map

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

package/IO/Json.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Represents any valid JSON value.
+ */
+export type JSONValue = string | number | boolean | null | JSONArray | JSONObject;
+/**
+ * Represents a JSON object, where keys are strings and values are valid JSON values.
+ */
+export interface JSONObject {
+    [key: string]: JSONValue;
+}
+/**
+ * Represents a JSON array, which contains only valid JSON values.
+ */
+export type JSONArray = Array<JSONValue>;
+/**
+ * The `Json` class for handling JSON data.
+ *
+ * @public
+ */
+export declare class Json {
+    private readonly _entries;
+    /**
+     * Constructs a new instance of the `Json` class.
+     *
+     * @private
+     * @param entries - The entries to initialize the JSON object.
+     */
+    private constructor();
+    /**
+     * Gets the entries of the JSON object.
+     *
+     * @public
+     */
+    get entries(): JSONObject;
+    /**
+     * Parses a JSON string into a `Json` instance.
+     *
+     * @public
+     * @static
+     * @param content - The JSON string to parse.
+     * @returns A `Json` instance representing the parsed data.
+     */
+    static parse(content: string): Json;
+    /**
+     * Creates a new `Json` instance from a JSON object.
+     *
+     * @public
+     * @static
+     * @param obj - The JSON object to create the instance from.
+     * @returns A `Json` instance representing the JSON object.
+     */
+    static from(obj: JSONObject): Json;
+    /**
+     * Converts the `Json` instance back to a JSON string.
+     *
+     * @public
+     * @returns A JSON string representation of the object.
+     */
+    toString(): string;
+    /**
+     * Retrieves a value by key from the JSON object.
+     *
+     * @public
+     * @param key - The key to retrieve the value for.
+     * @returns The value associated with the key.
+     */
+    getValue(key: string): JSONValue;
+    /**
+     * Sets a value by key in the JSON object.
+     *
+     * @public
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    setValue(key: string, value: JSONValue): void;
+    /**
+     * Deletes a key-value pair from the JSON object.
+     *
+     * @public
+     * @param key - The key to delete.
+     */
+    deleteValue(key: string): void;
+}
+//# sourceMappingURL=Json.d.ts.map

package/IO/Json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Json.d.ts","sourceRoot":"","sources":["../../src/IO/Json.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAK,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAMzC;;;;GAIG;AACH,qBAAa,IAAI;IAIb,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IAMtC;;;;;OAKG;IACH,OAAO;IAQP;;;;OAIG;IACH,IAAW,OAAO,IAAI,UAAU,CAE/B;IAMD;;;;;;;OAOG;WACW,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS1C;;;;;;;OAOG;WACW,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAIzC;;;;;OAKG;IACI,QAAQ,IAAI,MAAM;IAQzB;;;;;;OAMG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAIvC;;;;;;OAMG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAIpD;;;;;OAKG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAOxC"}

package/IO/Json.js

@@ -0,0 +1,114 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Json = void 0;
+const jsonc_parser_1 = require("jsonc-parser");
+const String_1 = require("../System/String");
+// #region Imports
+// #endregion
+/**
+ * The `Json` class for handling JSON data.
+ *
+ * @public
+ */
+class Json {
+    // #region Fields
+    _entries;
+    // #endregion
+    // #region Constructor
+    /**
+     * Constructs a new instance of the `Json` class.
+     *
+     * @private
+     * @param entries - The entries to initialize the JSON object.
+     */
+    constructor(entries) {
+        this._entries = entries;
+    }
+    // #endregion
+    // #region Properties
+    /**
+     * Gets the entries of the JSON object.
+     *
+     * @public
+     */
+    get entries() {
+        return this._entries;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Parses a JSON string into a `Json` instance.
+     *
+     * @public
+     * @static
+     * @param content - The JSON string to parse.
+     * @returns A `Json` instance representing the parsed data.
+     */
+    static parse(content) {
+        try {
+            const parsedContent = (0, jsonc_parser_1.parse)(content);
+            return new Json(parsedContent);
+        }
+        catch (error) {
+            throw new Error(`Unable to parse JSON.${String_1.StringExtensions.newLine}${error.message}`);
+        }
+    }
+    /**
+     * Creates a new `Json` instance from a JSON object.
+     *
+     * @public
+     * @static
+     * @param obj - The JSON object to create the instance from.
+     * @returns A `Json` instance representing the JSON object.
+     */
+    static from(obj) {
+        return new Json(obj);
+    }
+    /**
+     * Converts the `Json` instance back to a JSON string.
+     *
+     * @public
+     * @returns A JSON string representation of the object.
+     */
+    toString() {
+        try {
+            return JSON.stringify(this._entries, null, 2);
+        }
+        catch (error) {
+            throw new Error(`Unable to convert to JSON string.${String_1.StringExtensions.newLine}${error.message}`);
+        }
+    }
+    /**
+     * Retrieves a value by key from the JSON object.
+     *
+     * @public
+     * @param key - The key to retrieve the value for.
+     * @returns The value associated with the key.
+     */
+    getValue(key) {
+        return this._entries[key];
+    }
+    /**
+     * Sets a value by key in the JSON object.
+     *
+     * @public
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    setValue(key, value) {
+        this._entries[key] = value;
+    }
+    /**
+     * Deletes a key-value pair from the JSON object.
+     *
+     * @public
+     * @param key - The key to delete.
+     */
+    deleteValue(key) {
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+        delete this._entries[key];
+    }
+}
+exports.Json = Json;
+//# sourceMappingURL=Json.js.map

package/IO/Json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Json.js","sourceRoot":"","sources":["../../src/IO/Json.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAElB,+CAAmD;AACnD,6CAAoD;AAuBpD,kBAAkB;AAElB,aAAa;AAEb;;;;GAIG;AACH,MAAa,IAAI;IAEb,iBAAiB;IAEA,QAAQ,CAAa;IAEtC,aAAa;IAEb,sBAAsB;IAEtB;;;;;OAKG;IACH,YAAoB,OAAmB;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB;;;;OAIG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,OAAe;QAC/B,IAAI,CAAC;YACD,MAAM,aAAa,GAAG,IAAA,oBAAU,EAAC,OAAO,CAAe,CAAC;YACxD,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,wBAAwB,yBAAgB,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,IAAI,CAAC,GAAe;QAC9B,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACI,QAAQ;QACX,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oCAAoC,yBAAgB,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpG,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,GAAW,EAAE,KAAgB;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,GAAW;QAC1B,gEAAgE;QAChE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CAIJ;AAnHD,oBAmHC"}

package/IO/Path.d.ts

@@ -0,0 +1,125 @@
+import { type IGlobOptions } from './Glob';
+export declare class Path {
+    /**
+     * Gets the path separator
+     * @public
+     * @static
+     * @returns {string}
+     */
+    static get separator(): string;
+    /**
+     * Changes the extension of a file path. The path parameter specifies a file path, and the extension parameter specifies a file extension (with a leading period, such as ".json" or ".js").
+     * @public
+     * @static
+     * @param {string} path The path
+     * @param {string} extension The extenison
+     * @returns {string} The function returns a file path with the same root, directory, and base name parts as path, but with the file extension changed to the specified extension. If path is null, the function returns null. If path does not contain a file extension, the new file extension is appended to the path. If extension is null, any exsiting extension is removed from path.
+     */
+    static changeExtension(path: string, extension: string): string;
+    /**
+     * Get the directory name of the given path.
+     * @public
+     * @static
+     * @param {string} path The path
+     * @returns {string} This method effectively removes the last element of the given file path, i.e. it returns a string consisting of all characters up to but not including the last backslash ("\") in the file path. The returned value is null if the file path is null or if the file path denotes a root (such as "\", "C:", or "\\server\share").
+     */
+    static getDirectoryName(path: string): string;
+    /**
+     * Get a string array of the given path.
+     * @public
+     * @static
+     * @param {string} path The path
+     * @returns {Array<string>}
+     */
+    static getDirectorySegments(path: string): Array<string>;
+    /**
+     * @public
+     * @static
+     * @param {string} path The path
+     * @returns {string} The name and extension parts of the given path. The resulting string contains the characters of path that follow the last backslash ("\"), slash ("/"), or colon (":") character in  path. The resulting string is the entire path if path  contains no backslash after removing trailing slashes, slash, or colon characters. The resulting  string is null if path is null.
+     */
+    static getFileName(path: string): string;
+    /**
+     * @public
+     * @static
+     * @param {string} path The path
+     * @returns {string} Returns the file name of the specified path string without the extension.
+     */
+    static getFileNameWithoutExtension(path: string): string;
+    /**
+     * @public
+     * @static
+     * @param {string} path The path
+     * @param {boolean} includeDot If true, the returned string includes the period (.) before the extension. If false or omitted, the period is not included.
+     * @returns {string} Returns the extension of the specified path string.
+     */
+    static getExtension(path: string, includeDot?: boolean): string;
+    /**
+     * @public
+     * @static
+     * @param {boolean} alphanumeric If true, the generated name will only contain alphanumeric characters.
+     * @returns {string} Returns a cryptographically strong random 8.3 string that can be used as either a folder name or a file name.
+     */
+    static getRandomFileName(alphanumeric?: boolean): string;
+    /**
+     * @public
+     * @static
+     * @param {Array<string>} path Array of path strings
+     * @returns {string}
+     */
+    static combine(...path: Array<string>): string;
+    /**
+     * Normalize file path slashes to be unix-like forward slashes.
+     * @public
+     * @static
+     * @param {string} path Path string
+     * @param {boolean} stripTrailing By default trailing slashes are removed. Pass false as the last argument to disable this behavior and keep trailing slashes
+     * @returns {string}
+     */
+    static normalize(path: string, stripTrailing?: boolean): string;
+    /**
+     * Converts a relative path to an absolute path based on a given base path.
+     *
+     * @public
+     * @static
+     * @param {string} paths Path string
+     * @returns {string}
+     */
+    static resolve(...paths: Array<string>): string;
+    /**
+     * Determines whether path is an absolute path. An absolute path will always resolve to the same location, regardless of the working directory.
+     * @public
+     * @static
+     * @param {string} path Path string
+     * @returns {boolean}
+     */
+    static isAbsolute(path: string): boolean;
+    /**
+     * Find files and directories using glob patterns.
+     *
+     * @public
+     * @static
+     * @param {string | string[]} pattern - The globbing pattern
+     * @param {object} options The globbing options.
+     * @returns {string[]} The Files
+     */
+    static glob(pattern: string | Array<string>, options?: IGlobOptions): Array<string>;
+    /**
+     * Solve the relative path from {from} to {to} based on the current working directory.
+     * At times we have two absolute paths, and we need to derive the relative path from one to the other.
+     * This is actually the reverse transform of path.resolve.
+     *
+     * @public
+     * @static
+     * @param {string} from The from path.
+     * @param {string} to The to options.
+     * @returns {string} The relative Files
+     * @example
+     * ```typescript
+     * Path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb');
+     * // Returns: '../../impl/bbb'
+     * ```
+     */
+    static relative(from: string, to: string): string;
+}
+//# sourceMappingURL=Path.d.ts.map

package/IO/Path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../../src/IO/Path.ts"],"names":[],"mappings":"AAKA,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAIjD,qBAAa,IAAI;IAIb;;;;;OAKG;IACH,WAAkB,SAAS,IAAI,MAAM,CAEpC;IAMD;;;;;;;OAOG;WACW,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAwBtE;;;;;;OAMG;WACW,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpD;;;;;;OAMG;WACW,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAI/D;;;;;OAKG;WACW,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/C;;;;;OAKG;WACW,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAY/D;;;;;;OAMG;WACW,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM;IAKtE;;;;;OAKG;WACW,iBAAiB,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM;IAiB/D;;;;;OAKG;WACW,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM;IAUrD;;;;;;;OAOG;WACW,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM;IAmCtE;;;;;;;OAOG;WACW,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM;IAItD;;;;;;OAMG;WACW,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/C;;;;;;;;OAQG;WACW,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;IAkC1F;;;;;;;;;;;;;;;OAeG;WACW,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;CAM3D"}