mcdev 9.0.2 → 10.0.0

package/@types/lib/util/util.d.ts

@@ -1,27 +1,48 @@
 export namespace Util {
-    let authFileName: string;
-    let boilerplateDirectory: string;
-    let configFileName: string;
-    let defaultGitBranch: string;
-    let parentBuName: string;
-    let standardizedSplitChar: string;
-    let folderNameSlashEscapeChar: string;
-    let skipInteraction: SkipInteraction;
-    let packageJsonMcdev: any;
-    let OPTIONS: {};
-    let changedKeysMap: {};
-    let matchedByName: {};
+    export let authFileName: string;
+    export let boilerplateDirectory: string;
+    export { defaultBoilerplateRoot as boilerplateRoot };
+    export let configFileName: string;
+    export let defaultGitBranch: string;
+    export let parentBuName: string;
+    export let standardizedSplitChar: string;
+    export let folderNameSlashEscapeChar: string;
+    export let skipInteraction: SkipInteraction;
+    export { packageJsonMcdev };
+    export let OPTIONS: {};
+    export let changedKeysMap: {};
+    export let matchedByName: {};
+    /**
+     * Resolve a path within the bundled project boilerplate.
+     *
+     * @param {...string} segments path segments below the boilerplate root
+     * @returns {string} absolute boilerplate path
+     */
+    export function getBoilerplatePath(...segments: string[]): string;
+    /**
+     * Override the boilerplate root for embedded consumers and tests.
+     *
+     * @param {string} root absolute or cwd-relative boilerplate root
+     * @returns {string} resolved boilerplate root
+     */
+    export function setBoilerplateRoot(root: string): string;
+    /**
+     * Restore the package's default boilerplate root.
+     *
+     * @returns {string} restored boilerplate root
+     */
+    export function resetBoilerplateRoot(): string;
     /**
      * helper that allows filtering an object by its keys
      *
-     * @param {Object.<string,*>} originalObj object that you want to filter
+     * @param {Object.<string, unknown>} originalObj object that you want to filter
      * @param {string[]} [whitelistArr] positive filter. if not provided, returns originalObj without filter
-     * @returns {Object.<string,*>} filtered object that only contains keys you provided
+     * @returns {Object.<string, unknown>} filtered object that only contains keys you provided
      */
-    function filterObjByKeys(originalObj: {
-        [x: string]: any;
+    export function filterObjByKeys(originalObj: {
+        [x: string]: unknown;
     }, whitelistArr?: string[]): {
-        [x: string]: any;
+        [x: string]: unknown;
     };
     /**
      * extended Array.includes method that allows check if an array-element starts with a certain string
@@ -30,7 +51,7 @@ export namespace Util {
      * @param {string} search the string you are looking for
      * @returns {boolean} found / not found
      */
-    function includesStartsWith(arr: string[], search: string): boolean;
+    export function includesStartsWith(arr: string[], search: string): boolean;
     /**
      * extended Array.includes method that allows check if an array-element starts with a certain string
      *
@@ -38,7 +59,7 @@ export namespace Util {
      * @param {string} search the string you are looking for
      * @returns {number} array index 0..n or -1 of not found
      */
-    function includesStartsWithIndex(arr: string[], search: string): number;
+    export function includesStartsWithIndex(arr: string[], search: string): number;
     /**
      * check if a market name exists in current mcdev config
      *
@@ -46,7 +67,7 @@ export namespace Util {
      * @param {Mcdevrc} properties local mcdev config
      * @returns {boolean} found market or not
      */
-    function checkMarket(market: string, properties: Mcdevrc): boolean;
+    export function checkMarket(market: string, properties: Mcdevrc): boolean;
     /**
      * check if a market name exists in current mcdev config
      *
@@ -54,14 +75,14 @@ export namespace Util {
      * @param {Mcdevrc} properties local mcdev config
      * @returns {boolean} found market or not
      */
-    function checkMarketList(marketArr: string[], properties: Mcdevrc): boolean;
+    export function checkMarketList(marketArr: string[], properties: Mcdevrc): boolean;
     /**
      * ensure provided MarketList exists and it's content including markets and BUs checks out
      *
      * @param {string} mlName name of marketList
      * @param {Mcdevrc} properties General configuration to be used in retrieve
      */
-    function verifyMarketList(mlName: string, properties: Mcdevrc): void;
+    export function verifyMarketList(mlName: string, properties: Mcdevrc): void;
     /**
      *
      * @param {string | TypeKeyCombo} selectedTypes supported metadata type
@@ -69,56 +90,56 @@ export namespace Util {
      * @param {string} [commandName] for log output only
      * @returns {TypeKeyCombo | undefined} true if everything is valid; false otherwise
      */
-    function checkAndPrepareTypeKeyCombo(selectedTypes: string | TypeKeyCombo, keyArr?: string[], commandName?: string): TypeKeyCombo | undefined;
+    export function checkAndPrepareTypeKeyCombo(selectedTypes: string | TypeKeyCombo, keyArr?: string[], commandName?: string): TypeKeyCombo | undefined;
     /**
      * used to ensure the program tells surrounding software that an unrecoverable error occured
      *
      * @returns {void}
      */
-    function signalFatalError(): void;
+    export function signalFatalError(): void;
     /**
      * SFMC accepts multiple true values for Boolean attributes for which we are checking here.
      * The same problem occurs when evaluating boolean CLI flags
      *
-     * @param {*} attrValue value
+     * @param {string|number|boolean|null|undefined} attrValue value
      * @returns {boolean} attribute value == true ? true : false
      */
-    function isTrue(attrValue: any): boolean;
+    export function isTrue(attrValue: string | number | boolean | null | undefined): boolean;
     /**
      * SFMC accepts multiple false values for Boolean attributes for which we are checking here.
      * The same problem occurs when evaluating boolean CLI flags
      *
-     * @param {*} attrValue value
+     * @param {string|number|boolean|null|undefined} attrValue value
      * @returns {boolean} attribute value == false ? true : false
      */
-    function isFalse(attrValue: any): boolean;
-    function isEqual(item1: string | number | boolean | any[] | object, item2: string | number | boolean | any[] | object): boolean;
-    function _isEqualArray(array1: any[], array2: any[]): boolean;
-    function _isEqualObject(item1: object, item2: object): boolean;
+    export function isFalse(attrValue: string | number | boolean | null | undefined): boolean;
+    export function isEqual(item1: string | number | boolean | any[] | object, item2: string | number | boolean | any[] | object): boolean;
+    export function _isEqualArray(array1: any[], array2: any[]): boolean;
+    export function _isEqualObject(item1: object, item2: object): boolean;
     /**
-     * helper for Mcdev.retrieve, Mcdev.retrieveAsTemplate and Mcdev.deploy
+     * helper for Mcdev.retrieve and Mcdev.deploy
      *
      * @param {string} selectedType type or type-subtype
      * @param {boolean} [handleOutside] if the API reponse is irregular this allows you to handle it outside of this generic method
      * @returns {boolean} type ok or not
      */
-    function _isValidType(selectedType: string, handleOutside?: boolean): boolean;
+    export function _isValidType(selectedType: string, handleOutside?: boolean): boolean;
     /**
-     * helper for Mcdev.retrieve, Mcdev.retrieveAsTemplate and Mcdev.deploy
+     * helper for Mcdev.retrieve and Mcdev.deploy
      *
      * @param {Mcdevrc} properties javascript object in .mcdevrc.json
      * @param {string} businessUnit name of BU
      * @param {boolean} [handleOutside] if the API reponse is irregular this allows you to handle it outside of this generic method
      * @returns {boolean} bu found or not
      */
-    function isValidBU(properties: Mcdevrc, businessUnit: string, handleOutside?: boolean): boolean;
+    export function isValidBU(properties: Mcdevrc, businessUnit: string, handleOutside?: boolean): boolean;
     /**
      * helper that deals with extracting type and subtype
      *
      * @param {string} selectedType "type" or "type-subtype"
      * @returns {{type:string, subType:string}} first elem is type, second elem is subType
      */
-    function getTypeAndSubType(selectedType: string): {
+    export function getTypeAndSubType(selectedType: string): {
         type: string;
         subType: string;
     };
@@ -128,7 +149,7 @@ export namespace Util {
      * @param {'typeRetrieveByDefault'|'typeCdpByDefault'} field relevant field in type definition
      * @returns {string[]} type choices
      */
-    function getTypeChoices(field: "typeRetrieveByDefault" | "typeCdpByDefault"): string[];
+    export function getTypeChoices(field: "typeRetrieveByDefault" | "typeCdpByDefault"): string[];
     /**
      * helper for cli.selectTypes and init.config.fixMcdevConfig that converts subtypes back to main type if all and only defaults were selected
      * this keeps the config automatically upgradable when we add new subtypes or change what is selected by default
@@ -138,29 +159,29 @@ export namespace Util {
      * @param {'asset'} [type] metadata type
      * @returns {string[]} filtered selectedTypes
      */
-    function summarizeSubtypes(field: "typeRetrieveByDefault" | "typeCdpByDefault", selectedTypes: string[], type?: "asset"): string[];
-    let logFileName: string;
-    function _createNewLoggerTransport(noLogFile?: boolean): object;
-    let loggerTransports: any;
-    let logger: Logger;
-    function startLogger(restart?: boolean, noLogFile?: boolean): void;
-    function metadataLogger(level: string, type: string, method: string, payload: any, source?: string): void;
-    function replaceByObject(str: string | object, obj: TemplateMap): string | object;
-    function inverseGet(objs: object, val: string | number): string;
+    export function summarizeSubtypes(field: "typeRetrieveByDefault" | "typeCdpByDefault", selectedTypes: string[], type?: "asset"): string[];
+    export let logFileName: string;
+    export function _createNewLoggerTransport(noLogFile?: boolean): object;
+    export let loggerTransports: any;
+    export let logger: Logger;
+    export function startLogger(restart?: boolean, noLogFile?: boolean): void;
+    export function metadataLogger(level: string, type: string, method: string, payload: Error | string | object, source?: string): void;
+    export function replaceByObject(str: string | object, obj: TemplateMap): string | object;
+    export function inverseGet(objs: object, val: string | number): string;
     /**
      *helper for Mcdev.fixKeys. Retrieve dependent metadata
      *
      * @param {string} fixedType type of the metadata passed as a parameter to fixKeys function
      * @returns {string[]} array of types that depend on the given type
      */
-    function getDependentMetadata(fixedType: string): string[];
+    export function getDependentMetadata(fixedType: string): string[];
     /**
      * Returns Order in which metadata needs to be retrieved/deployed
      *
      * @param {string[]} typeArr which should be retrieved/deployed
      * @returns {Object.<string, string[]>} retrieve/deploy order as array
      */
-    function getMetadataHierachy(typeArr: string[]): {
+    export function getMetadataHierachy(typeArr: string[]): {
         [x: string]: string[];
     };
     /**
@@ -168,9 +189,9 @@ export namespace Util {
      *
      * @param {string} path 'fieldA.fieldB.fieldC'
      * @param {object} obj some parent object
-     * @returns {any} value of obj.path
+     * @returns {ReturnType<JSON['parse']>} value of obj.path
      */
-    function resolveObjPath(path: string, obj: object): any;
+    export function resolveObjPath(path: string, obj: object): ReturnType<JSON["parse"]>;
     /**
      * helper to run other commands as if run manually by user
      *
@@ -179,7 +200,7 @@ export namespace Util {
      * @param {boolean} [hideOutput] if true, output of command will be hidden from CLI
      * @returns {string|void} output of command if hideOutput is true
      */
-    function execSync(cmd: string, args?: string[], hideOutput?: boolean): string | void;
+    export function execSync(cmd: string, args?: string[], hideOutput?: boolean): string | void;
     /**
      * standardize check to ensure only one result is returned from template search
      *
@@ -188,7 +209,7 @@ export namespace Util {
      * @param {string} searchValue the value which is being looked for
      * @returns {MetadataTypeItem} metadata to be used in building template
      */
-    function templateSearchResult(results: MetadataTypeItem[], keyToSearch: string, searchValue: string): MetadataTypeItem;
+    export function templateSearchResult(results: MetadataTypeItem[], keyToSearch: string, searchValue: string): MetadataTypeItem;
     /**
      * configures what is displayed in the console
      *
@@ -198,7 +219,7 @@ export namespace Util {
      * @param {boolean} [argv.debug] enables developer output & features
      * @returns {void}
      */
-    function setLoggingLevel(argv: {
+    export function setLoggingLevel(argv: {
         silent?: boolean;
         verbose?: boolean;
         debug?: boolean;
@@ -208,16 +229,20 @@ export namespace Util {
      *
      * @param {string} type api name of the type thats in beta
      */
-    function logBeta(type: string): void;
+    export function logBeta(type: string): void;
     /**
      * outputs a warning that the given method is deprecated
      *
      * @param {string} method name of the method
      * @param {string} [useInstead] optionally specify which method to use instead
      */
-    function logDeprecated(method: string, useInstead?: string): void;
-    function logNotSupported(definition: any, method: string, item?: MetadataTypeItem): void;
-    namespace color {
+    export function logDeprecated(method: string, useInstead?: string): void;
+    export function logNotSupported(definition: {
+        type: string;
+        keyField: string;
+        nameField: string;
+    }, method: string, item?: MetadataTypeItem): void;
+    export namespace color {
         let reset: string;
         let dim: string;
         let bright: string;
@@ -250,31 +275,43 @@ export namespace Util {
      * @param {string} msg log message that should be wrapped with color codes
      * @returns {string} gray msg
      */
-    function getGrayMsg(msg: string): string;
+    export function getGrayMsg(msg: string): string;
     /**
      * helper that returns the prefix of item specific log messages
      *
-     * @param {any} definition metadata definition
+     * @param {{type:string, keyField:string, nameField:string}} definition metadata definition
      * @param {MetadataTypeItem} metadataItem metadata item
      * @returns {string} msg prefix
      */
-    function getMsgPrefix(definition: any, metadataItem: MetadataTypeItem): string;
+    export function getMsgPrefix(definition: {
+        type: string;
+        keyField: string;
+        nameField: string;
+    }, metadataItem: MetadataTypeItem): string;
     /**
      * helper that returns the prefix of item specific log messages
      *
-     * @param {any} definition metadata definition
+     * @param {{type:string, keyField:string, nameField:string}} definition metadata definition
      * @param {MetadataTypeItem} metadataItem metadata item
      * @returns {string} key or key/name combo
      */
-    function getTypeKeyName(definition: any, metadataItem: MetadataTypeItem): string;
+    export function getTypeKeyName(definition: {
+        type: string;
+        keyField: string;
+        nameField: string;
+    }, metadataItem: MetadataTypeItem): string;
     /**
      * helper that returns the prefix of item specific log messages
      *
-     * @param {any} definition metadata definition
+     * @param {{type:string, keyField:string, nameField:string}} definition metadata definition
      * @param {MetadataTypeItem} metadataItem metadata item
      * @returns {string} key or key/name combo
      */
-    function getKeyName(definition: any, metadataItem: MetadataTypeItem): string;
+    export function getKeyName(definition: {
+        type: string;
+        keyField: string;
+        nameField: string;
+    }, metadataItem: MetadataTypeItem): string;
     /**
      * helper to print the subtypes we filtered by
      *
@@ -282,7 +319,7 @@ export namespace Util {
      * @param {string} [indent] optional prefix of spaces to be added to the log message
      * @returns {void}
      */
-    function logSubtypes(subTypeArr: string[], indent?: string): void;
+    export function logSubtypes(subTypeArr: string[], indent?: string): void;
     /**
      * helper to print the subtypes we filtered by
      *
@@ -290,14 +327,14 @@ export namespace Util {
      * @param {boolean} [isId] optional flag to indicate if key is an id
      * @returns {string} string to be appended to log message
      */
-    function getKeysString(keyArr: string[] | string, isId?: boolean): string;
+    export function getKeysString(keyArr: string[] | string, isId?: boolean): string;
     /**
      * pause execution of code; useful when multiple server calls are dependent on each other and might not be executed right away
      *
      * @param {number} ms time in miliseconds to wait
      * @returns {Promise.<void>} - promise to wait for
      */
-    function sleep(ms: number): Promise<void>;
+    export function sleep(ms: number): Promise<void>;
     /**
      * helper for Asset.extractCode and Script.prepExtractedCode to determine if a code block is a valid SSJS block
      *
@@ -316,7 +353,7 @@ export namespace Util {
      * @param {string} code code block to check
      * @returns {string} the SSJS code if code block is a valid SSJS block, otherwise null
      */
-    function getSsjs(code: string): string;
+    export function getSsjs(code: string): string;
     /**
      * allows us to filter just like with SQL's LIKE operator
      *
@@ -324,7 +361,7 @@ export namespace Util {
      * @param {string} search search string in SQL LIKE format
      * @returns {boolean} true if testString matches search
      */
-    function stringLike(testString: string, search: string): boolean;
+    export function stringLike(testString: string, search: string): boolean;
     /**
      * returns true if no LIKE filter is defined or if all filters match
      *
@@ -333,14 +370,14 @@ export namespace Util {
      * @param {object} [filters] only used in recursive calls
      * @returns {boolean} true if no LIKE filter is defined or if all filters match
      */
-    function fieldsLike(metadata: MetadataTypeItem, definition: object, filters?: object): boolean;
+    export function fieldsLike(metadata: MetadataTypeItem, definition: object, filters?: object): boolean;
     /**
      * helper used by SOAP methods to ensure the type always uses an upper-cased first letter
      *
      * @param {string} str string to capitalize
      * @returns {string} str with first letter capitalized
      */
-    function capitalizeFirstLetter(str: string): string;
+    export function capitalizeFirstLetter(str: string): string;
     /**
      * helper for Retriever and Deployer class
      *
@@ -349,59 +386,60 @@ export namespace Util {
      * @param {boolean} [returnEmpty] returns array with null element if false/not set; Retriever needs this to be false; Deployer needs it to be true
      * @returns {TypeKeyCombo} -
      */
-    function createTypeKeyCombo(typeArr: string | string[], keyArr: string[], returnEmpty?: boolean): TypeKeyCombo;
+    export function createTypeKeyCombo(typeArr: string | string[], keyArr: string[], returnEmpty?: boolean): TypeKeyCombo;
     /**
      * helper that converts TypeKeyCombo objects into a string with all relevant -m parameters
      *
      * @param {TypeKeyCombo} [selectedTypes] selected metadata types & key
      * @returns {string} object converted into --metadata parameters
      */
-    function convertTypeKeyToCli(selectedTypes?: TypeKeyCombo): string;
+    export function convertTypeKeyToCli(selectedTypes?: TypeKeyCombo): string;
     /**
      * helper that converts TypeKeyCombo objects into a string with all relevant -m parameters
      *
      * @param {TypeKeyCombo} [selectedTypes] selected metadata types & key
      * @returns {string} object converted into --metadata parameters
      */
-    function convertTypeKeyToString(selectedTypes?: TypeKeyCombo): string;
+    export function convertTypeKeyToString(selectedTypes?: TypeKeyCombo): string;
     /**
      * helper that checks how many keys are defined in TypeKeyCombo object
      *
      * @param {TypeKeyCombo} [selectedTypes] selected metadata types & key
      * @returns {number} amount of keys across all types
      */
-    function getTypeKeyCount(selectedTypes?: TypeKeyCombo): number;
+    export function getTypeKeyCount(selectedTypes?: TypeKeyCombo): number;
     /**
      * async version of Array.find()
      * returns the first element in the provided array that satisfies the provided testin function
      *
-     * @param {Array} arr your test array
-     * @param {Function} asyncCallback callback
-     * @returns {Promise.<any | undefined>} first element that passed the test
+     * @template T
+     * @param {T[]} arr your test array
+     * @param {(element: T) => Promise.<boolean>} asyncCallback callback
+     * @returns {Promise.<T | undefined>} first element that passed the test
      */
-    function findAsync(arr: any[], asyncCallback: Function): Promise<any | undefined>;
+    export function findAsync<T>(arr: T[], asyncCallback: (element: T) => Promise<boolean>): Promise<T | undefined>;
     /**
      *
      * @param {Array} array array to be chunked
      * @param {number} chunk_size integer > 0
      * @returns {Array[]} array of arrays with max chunk_size members per element, last element might have less
      */
-    function chunk(array: any[], chunk_size: number): any[][];
+    export function chunk(array: any[], chunk_size: number): any[][];
     /**
      * recursively find all values of the given key in the object
      *
-     * @param {any} object data to search in
+     * @param {object} object data to search in
      * @param {string} key attribute to find
      * @returns {Array} all values of the given key
      */
-    function findLeafVals(object: any, key: string): any[];
+    export function findLeafVals(object: object, key: string): any[];
     /**
      * helper that returns a new object with sorted attributes of the given object
      *
      * @param {object} obj object with unsorted attributes
      * @returns {object} obj but with sorted attributes
      */
-    function sortObjectAttributes(obj: object): object;
+    export function sortObjectAttributes(obj: object): object;
 }
 export type AuthObject = import("../../types/mcdev.d.js").AuthObject;
 export type BuObject = import("../../types/mcdev.d.js").BuObject;
@@ -424,4 +462,7 @@ export type SoapRequestParams = import("../../types/mcdev.d.js").SoapRequestPara
 export type TemplateMap = import("../../types/mcdev.d.js").TemplateMap;
 export type TypeKeyCombo = import("../../types/mcdev.d.js").TypeKeyCombo;
 export type SDKError = import("../../types/mcdev.d.js").SDKError;
+declare const defaultBoilerplateRoot: string;
+import packageJsonMcdev from '../../package.json' with { type: 'json' };
+export {};
 //# sourceMappingURL=util.d.ts.map

package/@types/lib/util/util.d.ts.map

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

package/@types/lib/util/validations.d.ts

@@ -1,12 +1,24 @@
 /**
+ * helper for validation
  *
- * @param {any} definition type definition
- * @param {any} item MetadataItem
+ * @param {string} [root] project root containing the custom validation module
+ * @returns {Promise.<void>} -
+ */
+export function loadCustomRules(root?: string): Promise<void>;
+/**
+ *
+ * @param {{type:string, keyField:string, nameField:string}} definition type definition
+ * @param {ReturnType<JSON['parse']>} item MetadataItem
  * @param {string} targetDir folder in which the MetadataItem is deployed from (deploy/cred/bu)
  * @param {CodeExtract[]} [codeExtractItemArr] array of code snippets
+ * @param {string} [root] project root containing .mcdev-validations.js
  * @returns {Promise.<validationRuleList>} MetadataItem
  */
-export default function validation(definition: any, item: any, targetDir: string, codeExtractItemArr?: CodeExtract[]): Promise<validationRuleList>;
+export default function validation(definition: {
+    type: string;
+    keyField: string;
+    nameField: string;
+}, item: ReturnType<JSON["parse"]>, targetDir: string, codeExtractItemArr?: CodeExtract[], root?: string): Promise<validationRuleList>;
 export type validationRuleList = import("../../types/mcdev.d.js").validationRuleList;
 export type validationRuleFix = import("../../types/mcdev.d.js").validationRuleFix;
 export type validationRuleTest = import("../../types/mcdev.d.js").validationRuleTest;

package/@types/lib/util/validations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../../lib/util/validations.js"],"names":[],"mappings":"AAqCA;;;;;;;GAOG;AACH,+CANW,GAAG,QACH,GAAG,aACH,MAAM,uBACN,WAAW,EAAE,GACX,OAAO,CAAE,kBAAkB,CAAC,CAuHxC;iCA7JY,OAAO,wBAAwB,EAAE,kBAAkB;gCACnD,OAAO,wBAAwB,EAAE,iBAAiB;iCAClD,OAAO,wBAAwB,EAAE,kBAAkB;0BACnD,OAAO,wBAAwB,EAAE,WAAW"}
+{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../../lib/util/validations.js"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,uCAHW,MAAM,GACJ,OAAO,CAAE,IAAI,CAAC,CAwB1B;AACD;;;;;;;;GAQG;AACH,+CAPW;IAAC,IAAI,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,SAAS,EAAC,MAAM,CAAA;CAAC,QAChD,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,aACzB,MAAM,uBACN,WAAW,EAAE,SACb,MAAM,GACJ,OAAO,CAAE,kBAAkB,CAAC,CAoHxC;iCAlKY,OAAO,wBAAwB,EAAE,kBAAkB;gCACnD,OAAO,wBAAwB,EAAE,iBAAiB;iCAClD,OAAO,wBAAwB,EAAE,kBAAkB;0BACnD,OAAO,wBAAwB,EAAE,WAAW"}