@code-pushup/utils 0.56.0 → 0.57.0

package/src/lib/text-formats/html/details.js

@@ -0,0 +1,20 @@
+import { NEW_LINE } from '../constants.js';
+/**
+ * <details {open}>
+ *   <summary>{title}</summary>
+ *
+ *   {content}
+ *
+ * <details>
+ */
+export function details(title, content, cfg = { open: false }) {
+    return `<details${cfg.open ? ' open' : ''}>${NEW_LINE}<summary>${title}</summary>${NEW_LINE}${
+    // ⚠️ The blank line is needed to ensure Markdown in content is rendered correctly.
+    NEW_LINE}${content}${NEW_LINE}${
+    // @TODO in the future we could consider adding it only if the content ends with a code block
+    // ⚠️ The blank line ensure Markdown in content is rendered correctly.
+    NEW_LINE}</details>${
+    // ⚠️ The blank line is needed to ensure Markdown after details is rendered correctly.
+    NEW_LINE}`;
+}
+//# sourceMappingURL=details.js.map

package/src/lib/text-formats/html/details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.js","sourceRoot":"","sources":["../../../../../../../packages/utils/src/lib/text-formats/html/details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,KAAa,EACb,OAAe,EACf,MAAyB,EAAE,IAAI,EAAE,KAAK,EAAE;IAExC,OAAO,WACL,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACvB,IAAI,QAAQ,YAAY,KAAK,aAAa,QAAQ,GAAG;IACnD,mFAAmF;IACnF,QACF,GAAG,OAAO,GAAG,QAAQ,GAAG;IACtB,6FAA6F;IAC7F,sEAAsE;IACtE,QACF,aAAa;IACX,sFAAsF;IACtF,QACF,EAAE,CAAC;AACL,CAAC"}

package/src/lib/text-formats/html/font-style.js

@@ -0,0 +1,13 @@
+const boldElement = 'b';
+export function bold(text) {
+    return `<${boldElement}>${text}</${boldElement}>`;
+}
+const italicElement = 'i';
+export function italic(text) {
+    return `<${italicElement}>${text}</${italicElement}>`;
+}
+const codeElement = 'code';
+export function code(text) {
+    return `<${codeElement}>${text}</${codeElement}>`;
+}
+//# sourceMappingURL=font-style.js.map

package/src/lib/text-formats/html/font-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-style.js","sourceRoot":"","sources":["../../../../../../../packages/utils/src/lib/text-formats/html/font-style.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,IAAI,WAAW,IAAI,IAAI,KAAK,WAAW,GAAG,CAAC;AACpD,CAAC;AAED,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,IAAI,aAAa,IAAI,IAAI,KAAK,aAAa,GAAG,CAAC;AACxD,CAAC;AAED,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,IAAI,WAAW,IAAI,IAAI,KAAK,WAAW,GAAG,CAAC;AACpD,CAAC"}

package/src/lib/text-formats/html/link.js

@@ -0,0 +1,4 @@
+export function link(href, text) {
+    return `<a href="${href}">${text || href}</a>`;
+}
+//# sourceMappingURL=link.js.map

package/src/lib/text-formats/html/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../../../../../packages/utils/src/lib/text-formats/html/link.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,IAAa;IAC9C,OAAO,YAAY,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC;AACjD,CAAC"}

package/src/lib/text-formats/html/table.js

@@ -0,0 +1,27 @@
+import { NEW_LINE } from '../constants.js';
+import { columnsToStringArray, rowToStringArray } from '../table.js';
+function wrap(elem, content) {
+    return `<${elem}>${content}</${elem}>${NEW_LINE}`;
+}
+function wrapRow(content) {
+    const elem = 'tr';
+    return `<${elem}>${NEW_LINE}${content}</${elem}>${NEW_LINE}`;
+}
+export function table(tableData) {
+    if (tableData.rows.length === 0) {
+        throw new Error("Data can't be empty");
+    }
+    // @TODO add formatting
+    const tableHeaderCols = columnsToStringArray(tableData)
+        .map(s => wrap('th', s))
+        .join('');
+    const tableHeaderRow = wrapRow(tableHeaderCols);
+    const tableBody = rowToStringArray(tableData)
+        .map(arr => {
+        const columns = arr.map(s => wrap('td', s)).join('');
+        return wrapRow(columns);
+    })
+        .join('');
+    return wrap('table', `${NEW_LINE}${tableHeaderRow}${tableBody}`);
+}
+//# sourceMappingURL=table.js.map

package/src/lib/text-formats/html/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../../../../../packages/utils/src/lib/text-formats/html/table.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,SAAS,IAAI,CAAC,IAAY,EAAE,OAAe;IACzC,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,IAAI,IAAI,IAAI,QAAQ,GAAG,OAAO,KAAK,IAAI,IAAI,QAAQ,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,SAAgB;IACpC,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,uBAAuB;IACvB,MAAM,eAAe,GAAG,oBAAoB,CAAC,SAAS,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SACvB,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC;SAC1C,GAAG,CAAC,GAAG,CAAC,EAAE;QACT,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/src/lib/text-formats/index.d.ts

@@ -1,8 +1,8 @@
-import { details } from './html/details';
-import { bold, code, italic } from './html/font-style';
-import { link } from './html/link';
-import { table } from './html/table';
-export { NEW_LINE, SPACE, TAB, HIERARCHY } from './constants';
+import { details } from './html/details.js';
+import { bold, code, italic } from './html/font-style.js';
+import { link } from './html/link.js';
+import { table } from './html/table.js';
+export { NEW_LINE, SPACE, TAB, HIERARCHY } from './constants.js';
 export declare const html: {
     bold: typeof bold;
     italic: typeof italic;

package/src/lib/text-formats/index.js

@@ -0,0 +1,14 @@
+import { details } from './html/details.js';
+import { bold, code, italic } from './html/font-style.js';
+import { link } from './html/link.js';
+import { table } from './html/table.js';
+export { NEW_LINE, SPACE, TAB, HIERARCHY } from './constants.js';
+export const html = {
+    bold,
+    italic,
+    code,
+    link,
+    details,
+    table,
+};
+//# sourceMappingURL=index.js.map

package/src/lib/text-formats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/utils/src/lib/text-formats/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,KAAK;CACN,CAAC"}

package/src/lib/text-formats/table.js

@@ -0,0 +1,92 @@
+import { capitalize } from '../transform.js';
+export function rowToStringArray({ rows, columns = [] }) {
+    if (Array.isArray(rows.at(0)) && typeof columns.at(0) === 'object') {
+        throw new TypeError('Column can`t be object when rows are primitive values');
+    }
+    return rows.map(row => {
+        // row = ['100 ms', '200 ms']
+        if (Array.isArray(row)) {
+            return row.map(String);
+        }
+        // row = { prop1: '100 ms', prop2: '200 ms' }
+        const objectRow = row;
+        // columns [] || column.at(0) = 'center'
+        if (columns.length === 0 || typeof columns.at(0) === 'string') {
+            return Object.values(objectRow).map(value => value == null ? '' : String(value));
+        }
+        // column = {key: 'prop1'}
+        return columns.map(({ key }) => objectRow[key] == null ? '' : String(objectRow[key]));
+    });
+}
+// Determine effective columns based on the input rows and optional columns parameter
+export function columnsToStringArray({ rows, columns = [], }) {
+    const firstRow = rows.at(0);
+    const primitiveRows = Array.isArray(firstRow);
+    if (typeof columns.at(0) === 'string' && !primitiveRows) {
+        throw new Error('invalid union type. Caught by model parsing.');
+    }
+    if (columns.length === 0) {
+        if (Array.isArray(firstRow)) {
+            return firstRow.map((_, idx) => String(idx));
+        }
+        return Object.keys(firstRow);
+    }
+    // columns = ['right', 'left']; row = ['100 ms', '200 ms'] => 1,2,3
+    if (typeof columns.at(0) === 'string') {
+        return columns.map(String);
+    }
+    // columns = [
+    // {key: 'prop1' label: 'Property 1'},
+    // {key: 'prop2'}
+    // ]; row = [ {prop1: '100 ms', prop2: '200 ms'}] => Property 1, Prop2
+    const cols = columns;
+    return cols.map(({ label, key }) => label ?? capitalize(key));
+}
+export function getColumnAlignmentForKeyAndIndex(targetKey, targetIdx, columns = []) {
+    const column = columns.at(targetIdx) ?? columns.find(col => col.key === targetKey);
+    if (typeof column === 'string') {
+        return column;
+    }
+    else if (typeof column === 'object') {
+        return column.align ?? 'center';
+    }
+    else {
+        return 'center';
+    }
+}
+export function getColumnAlignmentForIndex(targetIdx, columns = []) {
+    const column = columns.at(targetIdx);
+    if (column == null) {
+        return 'center';
+    }
+    else if (typeof column === 'string') {
+        return column;
+    }
+    else if (typeof column === 'object') {
+        return column.align ?? 'center';
+    }
+    else {
+        return 'center';
+    }
+}
+export function getColumnAlignments(tableData) {
+    const { rows, columns = [] } = tableData;
+    // this is caught by the table schema in @code-pushup/models
+    if (rows.at(0) == null) {
+        throw new Error('first row can`t be undefined.');
+    }
+    if (Array.isArray(rows.at(0))) {
+        const firstPrimitiveRow = rows.at(0);
+        return Array.from({ length: firstPrimitiveRow.length }).map((_, idx) => getColumnAlignmentForIndex(idx, columns));
+    }
+    const biggestRow = rows
+        .toSorted((a, b) => Object.keys(a).length - Object.keys(b).length)
+        .at(-1);
+    if (columns.length > 0) {
+        return columns.map((column, idx) => typeof column === 'string'
+            ? column
+            : getColumnAlignmentForKeyAndIndex(column.key, idx, columns));
+    }
+    return Object.keys(biggestRow ?? {}).map(_ => 'center');
+}
+//# sourceMappingURL=table.js.map

package/src/lib/text-formats/table.js.map

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

package/src/lib/transform.d.ts

@@ -7,8 +7,7 @@ export declare function distinct<T extends string | number | boolean>(array: T[]
 export declare function deepClone<T>(obj: T): T;
 export declare function factorOf<T>(items: T[], filterFn: (i: T) => boolean): number;
 type ArgumentValue = number | string | boolean | string[];
-export type CliArgsObject<T extends object = Record<string, ArgumentValue>> = T extends never ? // eslint-disable-next-line @typescript-eslint/naming-convention
-Record<string, ArgumentValue | undefined> | {
+export type CliArgsObject<T extends object = Record<string, ArgumentValue>> = T extends never ? Record<string, ArgumentValue | undefined> | {
     _: string;
 } : T;
 /**

package/src/lib/transform.js

@@ -0,0 +1,111 @@
+import { platform } from 'node:os';
+export function toArray(val) {
+    return Array.isArray(val) ? val : [val];
+}
+export function objectToKeys(obj) {
+    return Object.keys(obj);
+}
+export function objectToEntries(obj) {
+    return Object.entries(obj);
+}
+export function objectFromEntries(entries) {
+    return Object.fromEntries(entries);
+}
+export function countOccurrences(values) {
+    return values.reduce((acc, value) => ({ ...acc, [value]: (acc[value] ?? 0) + 1 }), {});
+}
+export function distinct(array) {
+    return [...new Set(array)];
+}
+export function deepClone(obj) {
+    return obj == null || typeof obj !== 'object' ? obj : structuredClone(obj);
+}
+export function factorOf(items, filterFn) {
+    const itemCount = items.length;
+    // early exit for empty rows
+    if (!itemCount) {
+        return 1;
+    }
+    const filterCount = items.filter(filterFn).length;
+    // if no rows result from the filter fn we forward return 1 as factor
+    return filterCount === 0 ? 1 : (itemCount - filterCount) / itemCount;
+}
+/**
+ * Converts an object with different types of values into an array of command-line arguments.
+ *
+ * @example
+ * const args = objectToProcessArgs({
+ *   _: ['node', 'index.js'], // node index.js
+ *   name: 'Juanita', // --name=Juanita
+ *   formats: ['json', 'md'] // --format=json --format=md
+ * });
+ */
+export function objectToCliArgs(params) {
+    if (!params) {
+        return [];
+    }
+    return Object.entries(params).flatMap(([key, value]) => {
+        // process/file/script
+        if (key === '_') {
+            return Array.isArray(value) ? value : [`${value}`];
+        }
+        const prefix = key.length === 1 ? '-' : '--';
+        // "-*" arguments (shorthands)
+        if (Array.isArray(value)) {
+            return value.map(v => `${prefix}${key}="${v}"`);
+        }
+        // "--*" arguments ==========
+        if (Array.isArray(value)) {
+            return value.map(v => `${prefix}${key}="${v}"`);
+        }
+        if (typeof value === 'object') {
+            return Object.entries(value).flatMap(
+            // transform nested objects to the dot notation `key.subkey`
+            ([k, v]) => objectToCliArgs({ [`${key}.${k}`]: v }));
+        }
+        if (typeof value === 'string') {
+            return [`${prefix}${key}="${value}"`];
+        }
+        if (typeof value === 'number') {
+            return [`${prefix}${key}=${value}`];
+        }
+        if (typeof value === 'boolean') {
+            return [`${prefix}${value ? '' : 'no-'}${key}`];
+        }
+        throw new Error(`Unsupported type ${typeof value} for key ${key}`);
+    });
+}
+export function toUnixPath(path) {
+    return path.replace(/\\/g, '/');
+}
+export function toUnixNewlines(text) {
+    return platform() === 'win32' ? text.replace(/\r\n/g, '\n') : text;
+}
+export function fromJsonLines(jsonLines) {
+    const unifiedNewLines = toUnixNewlines(jsonLines).trim();
+    return JSON.parse(`[${unifiedNewLines.split('\n').join(',')}]`);
+}
+export function toJsonLines(json) {
+    return json.map(item => JSON.stringify(item)).join('\n');
+}
+export function capitalize(text) {
+    return `${text.charAt(0).toLocaleUpperCase()}${text.slice(1)}`;
+}
+export function toNumberPrecision(value, decimalPlaces) {
+    return Number(`${Math.round(Number.parseFloat(`${value}e${decimalPlaces}`))}e-${decimalPlaces}`);
+}
+export function toOrdinal(value) {
+    /* eslint-disable @typescript-eslint/no-magic-numbers */
+    if (value % 10 === 1 && value % 100 !== 11) {
+        return `${value}st`;
+    }
+    if (value % 10 === 2 && value % 100 !== 12) {
+        return `${value}nd`;
+    }
+    if (value % 10 === 3 && value % 100 !== 13) {
+        return `${value}rd`;
+    }
+    /* eslint-enable @typescript-eslint/no-magic-numbers */
+    return `${value}th`;
+}
+//# sourceMappingURL=transform.js.map

package/src/lib/transform.js.map

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

package/src/lib/types.d.ts

@@ -1,8 +1,8 @@
-export type ExcludeNullFromPropertyTypes<T> = {
-    [P in keyof T]: Exclude<T[P], null>;
+export type ExcludeNullableProps<T> = {
+    [P in keyof T]: NonNullable<T[P]>;
 };
 export type ItemOrArray<T> = T | T[];
-export type ExtractArray<T> = T extends Array<unknown> ? T : never;
+export type ExtractArray<T> = T extends unknown[] ? T : never;
 export type ExtractArrays<T extends Record<string, unknown>> = {
     [K in keyof T]: ExtractArray<T[K]>;
 };

package/src/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/src/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/utils/src/lib/types.ts"],"names":[],"mappings":""}

package/src/lib/verbose-utils.js

@@ -0,0 +1,20 @@
+import { ui } from './logging.js';
+function getLogVerbose(verbose = false) {
+    return (msg) => {
+        if (verbose) {
+            ui().logger.info(msg);
+        }
+    };
+}
+function getExecVerbose(verbose = false) {
+    return (fn) => {
+        if (verbose) {
+            fn();
+        }
+    };
+}
+export const verboseUtils = (verbose = false) => ({
+    log: getLogVerbose(verbose),
+    exec: getExecVerbose(verbose),
+});
+//# sourceMappingURL=verbose-utils.js.map

package/src/lib/verbose-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-utils.js","sourceRoot":"","sources":["../../../../../packages/utils/src/lib/verbose-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAElC,SAAS,aAAa,CAAC,OAAO,GAAG,KAAK;IACpC,OAAO,CAAC,GAAW,EAAE,EAAE;QACrB,IAAI,OAAO,EAAE,CAAC;YACZ,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAO,GAAG,KAAK;IACrC,OAAO,CAAC,EAAiB,EAAE,EAAE;QAC3B,IAAI,OAAO,EAAE,CAAC;YACZ,EAAE,EAAE,CAAC;QACP,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC;IAC3B,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC;CAC9B,CAAC,CAAC"}

package/src/lib/zod-validation.d.ts

@@ -0,0 +1,3 @@
+import type { MessageBuilder } from 'zod-validation-error';
+export declare function formatErrorPath(errorPath: (string | number)[]): string;
+export declare const zodErrorMessageBuilder: MessageBuilder;

package/src/lib/zod-validation.js

@@ -0,0 +1,22 @@
+import { bold, red } from 'ansis';
+export function formatErrorPath(errorPath) {
+    return errorPath
+        .map((key, index) => {
+        if (typeof key === 'number') {
+            return `[${key}]`;
+        }
+        return index > 0 ? `.${key}` : key;
+    })
+        .join('');
+}
+export const zodErrorMessageBuilder = issues => issues
+    .map(issue => {
+    const formattedMessage = red(`${bold(issue.code)}: ${issue.message}`);
+    const formattedPath = formatErrorPath(issue.path);
+    if (formattedPath) {
+        return `Validation error at ${bold(formattedPath)}\n${formattedMessage}\n`;
+    }
+    return `${formattedMessage}\n`;
+})
+    .join('\n');
+//# sourceMappingURL=zod-validation.js.map

package/src/lib/zod-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-validation.js","sourceRoot":"","sources":["../../../../../packages/utils/src/lib/zod-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGlC,MAAM,UAAU,eAAe,CAAC,SAA8B;IAC5D,OAAO,SAAS;SACb,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,GAAG,GAAG,CAAC;QACpB,CAAC;QACD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACrC,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAmB,MAAM,CAAC,EAAE,CAC7D,MAAM;KACH,GAAG,CAAC,KAAK,CAAC,EAAE;IACX,MAAM,gBAAgB,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,uBAAuB,IAAI,CAAC,aAAa,CAAC,KAAK,gBAAgB,IAAI,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,gBAAgB,IAAI,CAAC;AACjC,CAAC,CAAC;KACD,IAAI,CAAC,IAAI,CAAC,CAAC"}