@zowe/cli 7.16.6 → 7.18.0

package/lib/zosfiles/edit/Edit.utils.js

@@ -0,0 +1,365 @@
+"use strict";
+/*
+* This program and the accompanying materials are made available under the terms of the
+* Eclipse Public License v2.0 which accompanies this distribution, and is available at
+* https://www.eclipse.org/legal/epl-v20.html
+*
+* SPDX-License-Identifier: EPL-2.0
+*
+* Copyright Contributors to the Zowe Project.
+*
+*/
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EditUtilities = exports.Prompt = void 0;
+const zos_files_for_zowe_sdk_1 = require("@zowe/zos-files-for-zowe-sdk");
+const imperative_1 = require("@zowe/imperative");
+const CompareBaseHelper_1 = require("../compare/CompareBaseHelper");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path = require("path");
+const LocalfileDataset_handler_1 = require("../compare/lf-ds/LocalfileDataset.handler");
+const LocalfileUss_handler_1 = require("../compare/lf-uss/LocalfileUss.handler");
+/**
+ * enum of prompts to be used as input to {@link EditUtilities.promptUser} during the file editing process
+ * @export
+ * @enum
+ */
+var Prompt;
+(function (Prompt) {
+    Prompt[Prompt["useStash"] = 0] = "useStash";
+    Prompt[Prompt["viewDiff"] = 1] = "viewDiff";
+    Prompt[Prompt["overwriteRemote"] = 2] = "overwriteRemote";
+    Prompt[Prompt["viewUpdatedRemote"] = 3] = "viewUpdatedRemote";
+    Prompt[Prompt["continueToUpload"] = 4] = "continueToUpload";
+})(Prompt = exports.Prompt || (exports.Prompt = {}));
+/**
+ * A shared utility class that uss and ds handlers use for local file editing
+ * @export
+ * @class
+ */
+class EditUtilities {
+    /**
+     * Builds a temp path where local file will be saved. If uss file, file name will be hashed
+     * to prevent any conflicts with file naming. A given filename will always result in the
+     * same unique file path.
+     * @param {ILocalFile} lfFile - object containing pertinent information about the local file during the editing process
+     * @returns {Promise<string>} - returns unique file path for temp file
+     * @memberof EditUtilities
+     */
+    static buildTempPath(lfFile, commandParameters) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            // find the appropriate extension for either uss or ds
+            const ussExt = (lfFile.fileType === 'uss' && lfFile.fileName.includes(".")) ? lfFile.fileName.split(".").pop() : "";
+            let ext = "." + (lfFile.fileType === 'uss' ? ussExt : ((_a = commandParameters.arguments.extension) !== null && _a !== void 0 ? _a : "txt"));
+            ext = (ext === "." ? "" : ext);
+            if (lfFile.fileType === 'uss') {
+                // Hash in a repeatable way if uss fileName (in case presence of special chars)
+                const crypto = require("crypto");
+                let hash = crypto.createHash('sha256').update(lfFile.fileName).digest('hex');
+                // shorten hash
+                const hashLen = 10;
+                hash = hash.slice(0, hashLen);
+                return path.join((0, os_1.tmpdir)(), path.parse(lfFile.fileName).name + '_' + hash + ext);
+            }
+            return path.join((0, os_1.tmpdir)(), lfFile.fileName + ext);
+        });
+    }
+    /**
+     * Check for temp path's existence (check if previously 'stashed'/temp edits exist)
+     * @param {string} tempPath - unique file path for local file (stash/temp file)
+     * @returns {Promise<boolean>} - promise that resolves to true if stash exists or false if doesn't
+     * @memberof EditUtilities
+     */
+    static checkForStash(tempPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return (0, fs_1.existsSync)(tempPath);
+            }
+            catch (err) {
+                throw new imperative_1.ImperativeError({
+                    msg: 'Failure when checking for stash. Command terminated.',
+                    causeErrors: err
+                });
+            }
+        });
+    }
+    /**
+     * Collection of prompts to be used at different points in editing process
+     * @param {Prompt} prompt - selected prompt from {@link Prompt} (enum object)
+     * @param {Boolean} conflict - optional. true if detected conflict between local and remote files
+     * @returns {Promise<boolean>} - promise whose resolution depends on user input
+     * @memberof EditUtilities
+     */
+    static promptUser(prompt, conflict) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let input;
+            let promptText;
+            const promptPrefix = (conflict ? 'CONFLICT: ' : '');
+            switch (prompt) {
+                case Prompt.useStash:
+                    promptText = 'Keep and continue editing found temp file? y/n';
+                    break;
+                case Prompt.viewDiff:
+                    promptText = 'View diff between temp and mainframe files? y/n';
+                    break;
+                case Prompt.viewUpdatedRemote:
+                    promptText = promptPrefix + 'Remote has changed. View diff between local and mainframe files? y/n';
+                    break;
+                case Prompt.overwriteRemote:
+                    promptText = promptPrefix + 'Overwrite remote with local edits? (Answer after editing) y/n';
+                    break;
+                case Prompt.continueToUpload:
+                    promptText = promptPrefix + 'Ignore conflicts and overwrite remote? y/n';
+                    break;
+            }
+            do {
+                input = yield imperative_1.CliUtils.readPrompt(imperative_1.TextUtils.chalk.green(promptText));
+            } while (input != null && input.toLowerCase() != 'y' && input.toLowerCase() != 'n');
+            if (input == null) {
+                throw new imperative_1.ImperativeError({
+                    msg: imperative_1.TextUtils.chalk.red('No input provided. Command terminated. Temp file will persist.')
+                });
+            }
+            return input.toLowerCase() === 'y';
+        });
+    }
+    /**
+     * Download file and determine if downloading just to get etag (useStash) or to save file locally & get etag (!useStash)
+     * @param {AbstractSession} session - the session object generated from the connected profile
+     * @param {ILocalFile} lfFile - object containing pertinent information about the local file during the editing process
+     * @param {boolean} useStash - should be true if don't want to overwrite local file when refreshing etag
+     * @returns {ILocalFile}
+     */
+    static localDownload(session, lfFile, useStash) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // account for both useStash|!useStash and uss|ds when downloading
+            const tempPath = useStash ? path.posix.join((0, os_1.tmpdir)(), "toDelete.txt") : lfFile.tempPath;
+            const args = [
+                session,
+                lfFile.fileName,
+                {
+                    returnEtag: true,
+                    binary: null,
+                    encoding: null,
+                    file: tempPath
+                }
+            ];
+            if (lfFile.fileType === 'uss') {
+                lfFile.zosResp = yield zos_files_for_zowe_sdk_1.Download.ussFile(...args);
+                lfFile.encoding = args[2].encoding;
+            }
+            else {
+                lfFile.zosResp = yield zos_files_for_zowe_sdk_1.Download.dataSet(...args);
+            }
+            if (useStash) {
+                yield this.destroyTempFile(path.posix.join((0, os_1.tmpdir)(), "toDelete.txt"));
+            }
+            return lfFile;
+        });
+    }
+    /**
+     * Performs appropriate file comparison (either in browser or as a terminal diff) between local file and remote
+     * Local file (lf) will then be opened in default editor
+     * @param {AbstractSession} session - the session object generated from the connected profile
+     * @param {IHandlerParameters} commandParameters - parameters supplied by args
+     * @param {ILocalFile} lfFile - object containing pertinent information about the local file during the editing process
+     * @param {boolean} promptUser - optional. if there are changes then prompt user to show diff, otherwise return
+     * @returns {Promise<IZosFilesResponse>} - the response generated by {@link CompareBaseHelper.getResponse}
+     * @memberof EditUtilities
+     */
+    static fileComparison(session, commandParameters, lfFile, promptUser) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const handlerDs = new LocalfileDataset_handler_1.default();
+            const handlerUss = new LocalfileUss_handler_1.default();
+            const helper = new CompareBaseHelper_1.CompareBaseHelper(commandParameters);
+            const gui = imperative_1.ProcessUtils.isGuiAvailable();
+            const options = {
+                name1: "local file",
+                name2: "remote file"
+            };
+            helper.browserView = (gui === imperative_1.GuiResult.GUI_AVAILABLE);
+            const lf = yield handlerDs.getFile1(session, commandParameters.arguments, helper);
+            let mf;
+            try {
+                if (commandParameters.positionals[2].includes('d')) {
+                    mf = yield handlerDs.getFile2(session, commandParameters.arguments, helper);
+                }
+                else {
+                    mf = yield handlerUss.getFile2(session, commandParameters.arguments, helper);
+                }
+            }
+            catch (err) {
+                throw new imperative_1.ImperativeError({
+                    msg: imperative_1.TextUtils.chalk.red(err + '\nCommand terminated. Issue retrieving files for comparison.'),
+                    causeErrors: err
+                });
+            }
+            const localContent = helper.prepareContent(lf);
+            const remoteContent = helper.prepareContent(mf);
+            let viewUpdatedRemote = !promptUser;
+            if (localContent !== remoteContent) {
+                lfFile.conflict = true;
+            }
+            if (promptUser && lfFile.conflict) {
+                viewUpdatedRemote = yield this.promptUser(Prompt.viewUpdatedRemote, lfFile.conflict);
+            }
+            if (!viewUpdatedRemote) {
+                return;
+            }
+            const diffResponse = yield helper.getResponse(localContent, remoteContent, options);
+            if (!helper.browserView) {
+                if (diffResponse) {
+                    commandParameters.response.console.log('\n' + diffResponse.commandResponse);
+                }
+                else {
+                    throw new imperative_1.ImperativeError({
+                        msg: imperative_1.TextUtils.chalk.red('Diff was unable to be generated')
+                    });
+                }
+            }
+            return diffResponse;
+        });
+    }
+    /**
+     * Enable user to make their edits and wait for user input to indicate editing is complete
+     * @param {ILocalFile} lfFile - object containing pertinent information about the local file during the editing process
+     * @param {string} editor - optional parameter originally supplied by args
+     * @memberof EditUtilities
+     */
+    static makeEdits(lfFile, editor) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (lfFile.guiAvail) {
+                imperative_1.ProcessUtils.openInEditor(lfFile.tempPath, editor, true);
+            }
+            return yield this.promptUser(Prompt.overwriteRemote, lfFile.conflict);
+        });
+    }
+    /**
+     * Upload temp file with saved etag
+     *  - if matching etag: successful upload, destroy stash/temp -> END
+     *  - if non-matching etag: unsuccessful upload -> refresh etag -> perform file comparison/edit -> re-attempt upload
+     * @param {AbstractSession} session - the session object generated from the connected profile
+     * @param {IHandlerParameters} commandParameters - parameters supplied by args
+     * @param {ILocalFile} lfFile - object containing pertinent information about the local file during the editing process
+     * @returns {Promise<[boolean, boolean]>} - [resolves to true if uploading was successful and
+     * false if not, resolves to true if user wishes to cancel command and false if not]
+     * @memberof EditUtilities
+     */
+    static uploadEdits(session, commandParameters, lfFile) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const etagMismatchCode = 412;
+            const args = [
+                session,
+                lfFile.tempPath,
+                lfFile.fileName,
+                {
+                    encoding: lfFile.encoding,
+                    etag: lfFile.zosResp.apiResponse.etag,
+                    returnEtag: true
+                },
+            ];
+            let response;
+            try {
+                if (lfFile.fileType === 'uss') {
+                    response = yield zos_files_for_zowe_sdk_1.Upload.fileToUssFile(...args);
+                }
+                else {
+                    response = yield zos_files_for_zowe_sdk_1.Upload.fileToDataset(...args);
+                }
+                if (response.success) {
+                    // If matching etag & successful upload, destroy temp file -> END
+                    yield this.destroyTempFile(lfFile.tempPath);
+                    return [true, false];
+                }
+                else {
+                    if (response.commandResponse.includes('412')) {
+                        return yield this.etagMismatch(session, commandParameters, lfFile);
+                        //returns [uploaded, canceled]
+                    }
+                }
+            }
+            catch (err) {
+                if (err.errorCode && err.errorCode == etagMismatchCode) {
+                    return yield this.etagMismatch(session, commandParameters, lfFile);
+                }
+            }
+            throw new imperative_1.ImperativeError({
+                msg: imperative_1.TextUtils.chalk.red((response === null || response === void 0 ? void 0 : response.errorMessage) +
+                    'Command terminated. Issue uploading stash. Temp file will persist'),
+                causeErrors: response === null || response === void 0 ? void 0 : response.errorMessage
+            });
+        });
+    }
+    /**
+     * When changes occur in the remote file, user will have to overwrite remote or account for the discrepancy between files
+     * @param {AbstractSession} session - the session object generated from the connected profile
+     * @param {IHandlerParameters} commandParameters - parameters supplied by args
+     * @param {ILocalFile} lfFile - object containing pertinent information about the local file during the editing process
+     * @returns {Promise<boolean>} - returns a boolean where true means command is canceled and false means continue
+     * @memberof EditUtilities
+     */
+    static etagMismatch(session, commandParameters, lfFile) {
+        return __awaiter(this, void 0, void 0, function* () {
+            lfFile.conflict = true;
+            try {
+                //alert user that the version of document they've been editing has changed
+                //ask if they want to see changes on the remote file before continuing
+                const viewUpdatedRemote = yield this.promptUser(Prompt.viewUpdatedRemote, lfFile.conflict);
+                if (viewUpdatedRemote) {
+                    yield this.fileComparison(session, commandParameters, lfFile);
+                }
+                //ask if they want to keep editing or upload despite changes to remote
+                const continueToUpload = yield this.promptUser(Prompt.continueToUpload, lfFile.conflict);
+                // refresh etag, keep stash
+                yield this.localDownload(session, lfFile, true);
+                if (!continueToUpload) {
+                    // create more edits & open stash/lf in editor
+                    const readyToUpload = yield this.makeEdits(lfFile, commandParameters.arguments.editor);
+                    if (readyToUpload) {
+                        return yield EditUtilities.uploadEdits(session, commandParameters, lfFile);
+                    }
+                    else {
+                        return [false, true]; //[uploaded, canceled]
+                    }
+                }
+                return [false, false]; //[uploaded, canceled]
+            }
+            catch (err) {
+                throw new imperative_1.ImperativeError({
+                    msg: imperative_1.TextUtils.chalk.red('Command terminated. Issue with etag. Temp file will persist.'),
+                    causeErrors: err
+                });
+            }
+        });
+    }
+    /**
+     * Destroy path of temporary local file (remove stash)
+     * @param {string} tempPath - unique file path for local file (stash)
+     * @memberof EditUtilities
+     */
+    static destroyTempFile(tempPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, fs_1.unlinkSync)(tempPath);
+            }
+            catch (err) {
+                throw new imperative_1.ImperativeError({
+                    msg: 'Temporary file could not be deleted: ${tempPath}',
+                    causeErrors: err
+                });
+            }
+        });
+    }
+}
+exports.EditUtilities = EditUtilities;
+//# sourceMappingURL=Edit.utils.js.map

package/lib/zosfiles/edit/Edit.utils.js.map

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

package/lib/zosfiles/edit/ds/Dataset.definition.d.ts

@@ -0,0 +1,6 @@
+import { ICommandDefinition } from "@zowe/imperative";
+/**
+ * Edit data set command definition containing its description, examples and/or options
+ * @type {ICommandDefinition}
+ */
+export declare const DatasetDefinition: ICommandDefinition;

package/lib/zosfiles/edit/ds/Dataset.definition.js

@@ -0,0 +1,58 @@
+"use strict";
+/*
+* This program and the accompanying materials are made available under the terms of the
+* Eclipse Public License v2.0 which accompanies this distribution, and is available at
+* https://www.eclipse.org/legal/epl-v20.html
+*
+* SPDX-License-Identifier: EPL-2.0
+*
+* Copyright Contributors to the Zowe Project.
+*
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatasetDefinition = void 0;
+const Edit_options_1 = require("../Edit.options");
+// Does not use the import in anticipation of some internationalization work to be done later.
+const strings = require("../../-strings-/en").default.EDIT;
+/**
+ * Edit data set command definition containing its description, examples and/or options
+ * @type {ICommandDefinition}
+ */
+exports.DatasetDefinition = {
+    name: "data-set",
+    aliases: ["ds"],
+    summary: strings.ACTIONS.DATA_SET.SUMMARY,
+    description: strings.ACTIONS.DATA_SET.DESCRIPTION,
+    type: "command",
+    handler: __dirname + "/../Edit.handler",
+    profile: {
+        optional: ["zosmf"],
+    },
+    positionals: [
+        {
+            name: "dataSetName",
+            description: strings.ACTIONS.DATA_SET.POSITIONALS.DATASETNAME,
+            type: "string",
+            required: true
+        },
+    ],
+    options: [
+        Edit_options_1.EditOptions.editor,
+        Edit_options_1.EditOptions.extension
+    ],
+    examples: [
+        {
+            description: strings.ACTIONS.DATA_SET.EXAMPLES.EX1,
+            options: `ibmuser.cntl(iefbr14) --editor notepad`
+        },
+        {
+            description: strings.ACTIONS.DATA_SET.EXAMPLES.EX1,
+            options: `ibmuser.cntl(iefbr14) --editor C:\\Windows\\System32\\Notepad.exe`
+        },
+        {
+            description: strings.ACTIONS.USS_FILE.EXAMPLES.EX2,
+            options: `ibmuser.jcl(iefbr14) --editor notepad --extension jcl`
+        }
+    ]
+};
+//# sourceMappingURL=Dataset.definition.js.map

package/lib/zosfiles/edit/ds/Dataset.definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dataset.definition.js","sourceRoot":"","sources":["../../../../src/zosfiles/edit/ds/Dataset.definition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;EASE;;;AAGF,kDAA8C;AAG9C,8FAA8F;AAC9F,MAAM,OAAO,GAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAA8B,CAAC,IAAI,CAAC;AAEnF;;;GAGG;AACU,QAAA,iBAAiB,GAAuB;IACjD,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACzC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW;IACjD,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS,GAAG,kBAAkB;IACvC,OAAO,EAAE;QACL,QAAQ,EAAE,CAAC,OAAO,CAAC;KACtB;IACD,WAAW,EAAE;QACT;YACI,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW;YAC7D,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,OAAO,EAAE;QACL,0BAAW,CAAC,MAAM;QAClB,0BAAW,CAAC,SAAS;KACxB;IACD,QAAQ,EAAE;QACN;YACI,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;YAClD,OAAO,EAAE,wCAAwC;SACpD;QACD;YACI,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;YAClD,OAAO,EAAE,mEAAmE;SAC/E;QACD;YACI,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;YAClD,OAAO,EAAE,uDAAuD;SACnE;KACJ;CACJ,CAAC"}

package/lib/zosfiles/edit/uss/USSFile.definition.d.ts

@@ -0,0 +1,6 @@
+import { ICommandDefinition } from "@zowe/imperative";
+/**
+ * Edit USS file content command definition containing its description, examples and/or options
+ * @type {ICommandDefinition}
+ */
+export declare const USSFileDefinition: ICommandDefinition;

package/lib/zosfiles/edit/uss/USSFile.definition.js

@@ -0,0 +1,53 @@
+"use strict";
+/*
+* This program and the accompanying materials are made available under the terms of the
+* Eclipse Public License v2.0 which accompanies this distribution, and is available at
+* https://www.eclipse.org/legal/epl-v20.html
+*
+* SPDX-License-Identifier: EPL-2.0
+*
+* Copyright Contributors to the Zowe Project.
+*
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USSFileDefinition = void 0;
+const Edit_options_1 = require("../Edit.options");
+// Does not use the import in anticipation of some internationalization work to be done later.
+const strings = require("../../-strings-/en").default.EDIT;
+/**
+ * Edit USS file content command definition containing its description, examples and/or options
+ * @type {ICommandDefinition}
+ */
+exports.USSFileDefinition = {
+    name: "uss-file",
+    aliases: ["uss", "uf"],
+    summary: strings.ACTIONS.USS_FILE.SUMMARY,
+    description: strings.ACTIONS.USS_FILE.DESCRIPTION,
+    type: "command",
+    handler: __dirname + "/../Edit.handler",
+    profile: {
+        optional: ["zosmf"],
+    },
+    positionals: [
+        {
+            name: "ussFilePath",
+            description: strings.ACTIONS.USS_FILE.POSITIONALS.USSFILEPATH,
+            type: "string",
+            required: true
+        },
+    ],
+    options: [
+        Edit_options_1.EditOptions.editor
+    ],
+    examples: [
+        {
+            description: strings.ACTIONS.USS_FILE.EXAMPLES.EX1,
+            options: `/a/ibmuser/my_text.txt --editor notepad`
+        },
+        {
+            description: strings.ACTIONS.USS_FILE.EXAMPLES.EX1,
+            options: `/a/ibmuser/my_text.txt --editor C:\\Windows\\System32\\Notepad.exe`
+        }
+    ]
+};
+//# sourceMappingURL=USSFile.definition.js.map

package/lib/zosfiles/edit/uss/USSFile.definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"USSFile.definition.js","sourceRoot":"","sources":["../../../../src/zosfiles/edit/uss/USSFile.definition.ts"],"names":[],"mappings":";AAAA;;;;;;;;;EASE;;;AAGF,kDAA8C;AAG9C,8FAA8F;AAC9F,MAAM,OAAO,GAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAA8B,CAAC,IAAI,CAAC;AAEnF;;;GAGG;AACU,QAAA,iBAAiB,GAAuB;IACjD,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACzC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW;IACjD,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS,GAAG,kBAAkB;IACvC,OAAO,EAAE;QACL,QAAQ,EAAE,CAAC,OAAO,CAAC;KACtB;IACD,WAAW,EAAE;QACT;YACI,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW;YAC7D,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,OAAO,EAAE;QACL,0BAAW,CAAC,MAAM;KACrB;IACD,QAAQ,EAAE;QACN;YACI,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;YAClD,OAAO,EAAE,yCAAyC;SACrD;QACD;YACI,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;YAClD,OAAO,EAAE,oEAAoE;SAChF;KACJ;CACJ,CAAC"}