@researchdatabox/redbox-core 0.0.0-bootstrap.0

package/dist/services/ConfigService.js

@@ -0,0 +1,379 @@
+"use strict";
+// Copyright (c) 2017 Queensland Cyber Infrastructure Foundation (http://www.qcif.edu.au/)
+//
+// GNU GENERAL PUBLIC LICENSE
+//    Version 2, June 1991
+//
+// This program is free software; you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation; either version 2 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License along
+// with this program; if not, write to the Free Software Foundation, Inc.,
+// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Services = void 0;
+const CoreService_1 = require("../CoreService");
+const fs = __importStar(require("fs-extra"));
+const path_1 = require("path");
+const _ = __importStar(require("lodash"));
+var Services;
+(function (Services) {
+    /**
+     * Dynamic Configuration related functions...
+     *
+     * Author: <a href='https://github.com/shilob' target='_blank'>Shilo Banihit</a>
+     *
+     */
+    class Config extends CoreService_1.Services.Core.Service {
+        _exportedMethods = [
+            'getBrand',
+            'mergeHookConfig'
+        ];
+        getBrand(brandName, configBlock) {
+            const defaultBrand = _.get(sails, 'config.auth.defaultBrand', 'default');
+            const resolveFromBrandingAware = (name) => {
+                if (_.isFunction(_.get(sails, 'config.brandingAware')) && !_.isEmpty(name)) {
+                    const brandingConfig = sails.config.brandingAware(name);
+                    const configVal = _.get(brandingConfig, configBlock);
+                    if (!_.isUndefined(configVal)) {
+                        return configVal;
+                    }
+                }
+                return undefined;
+            };
+            let configVal = resolveFromBrandingAware(brandName);
+            if (_.isUndefined(configVal)) {
+                configVal = resolveFromBrandingAware(defaultBrand);
+            }
+            if (_.isUndefined(configVal)) {
+                configVal = _.get(sails.config.brandingConfigurationDefaults, configBlock);
+            }
+            if (_.isUndefined(configVal)) {
+                const legacyConfig = _.get(sails.config, configBlock, {});
+                configVal = _.get(legacyConfig, brandName);
+                if (_.isUndefined(configVal)) {
+                    configVal = _.get(legacyConfig, defaultBrand);
+                }
+            }
+            if (_.isUndefined(configVal)) {
+                return undefined;
+            }
+            return configVal;
+        }
+        mergeHookConfig(hookName, configMap = sails.config, config_dirs = ["form-config", "config"], branded_app_config_dirs = ["branded-config"], dontMergeFields = ["fields"]) {
+            const that = this;
+            let hook_root_dir = `${sails.config.appPath}/node_modules/${hookName}`;
+            let appPath = sails.config.appPath;
+            // check if the app path was launched from the hook directory, e.g. when launching tests.
+            if (!fs.pathExistsSync(hook_root_dir) && _.endsWith(sails.config.appPath, hookName)) {
+                hook_root_dir = sails.config.appPath;
+                appPath = appPath.substring(0, appPath.lastIndexOf(`/node_modules/${hookName}`));
+            }
+            const hook_log_header = hookName;
+            const origDontMerge = _.clone(dontMergeFields);
+            const concatArrsFn = function (objValue, srcValue, key) {
+                const dontMergeIndex = _.findIndex(dontMergeFields, (o) => {
+                    return _.isString(o) ? _.isEqual(o, key) : !_.isEmpty(o[key]);
+                });
+                if (dontMergeIndex != -1) {
+                    if (!_.isString(dontMergeFields[dontMergeIndex])) {
+                        const dontMergeFieldMap = dontMergeFields;
+                        if (dontMergeFieldMap[key] == "this_file") {
+                            return srcValue;
+                        }
+                        else {
+                            return objValue;
+                        }
+                    }
+                    return srcValue;
+                }
+                return undefined;
+            };
+            sails.log.verbose(`${hookName}::Merging branded app configuration...`);
+            _.each(branded_app_config_dirs, (branded_app_config_dir) => {
+                branded_app_config_dir = `${hook_root_dir}/${branded_app_config_dir}`;
+                sails.log.verbose(`${hook_log_header}::Looking at: ${branded_app_config_dir}`);
+                if (fs.pathExistsSync(branded_app_config_dir)) {
+                    const dirs = fs.readdirSync(branded_app_config_dir);
+                    _.each(dirs, (dir) => {
+                        const fullPath = (0, path_1.resolve)(branded_app_config_dir, dir);
+                        if (fs.statSync(fullPath).isDirectory()) {
+                            const brandName = (0, path_1.basename)(fullPath);
+                            // init-only directory will only create config entries. Intended for initialising config in a new environment that's managed either via API or screens once live.
+                            const initFiles = this.walkDirSync(`${fullPath}/init-only`, []);
+                            sails.log.verbose(hook_log_header + "::Processing:");
+                            sails.log.verbose(initFiles);
+                            _.each(initFiles, (file_path) => {
+                                const config_file = require(file_path);
+                                const configKey = (0, path_1.basename)(file_path);
+                                AppConfigService.createConfig(brandName, configKey, config_file).then((config) => { sails.log.verbose(hook_log_header + "::Configuration created:"); sails.log.verbose(config); })
+                                    .catch((error) => { sails.log.verbose(hook_log_header + "::Skipping creation of config as it already exists:"); sails.log.verbose(error); });
+                            });
+                            // Files in override directory are always updated (for config items without management screens)
+                            const overrideFiles = this.walkDirSync(`${fullPath}/override`, []);
+                            sails.log.verbose(hook_log_header + "::Processing:");
+                            sails.log.verbose(overrideFiles);
+                            _.each(overrideFiles, (file_path) => {
+                                const config_file = require(file_path);
+                                const configKey = (0, path_1.basename)(file_path);
+                                const brand = BrandingService.getBrand(brandName);
+                                AppConfigService.createOrUpdateConfig(brand, configKey, config_file).then((config) => {
+                                    sails.log.verbose(hook_log_header + "::Configuration created or updated:");
+                                    sails.log.verbose(config);
+                                });
+                            });
+                        }
+                        else {
+                            sails.log.verbose(hook_log_header + "::Skipping, Found file where we are only expecting directories:" + fullPath);
+                        }
+                    });
+                }
+                else {
+                    sails.log.verbose(hook_log_header + "::Skipping, directory not found:" + branded_app_config_dir);
+                }
+            });
+            sails.log.verbose(`${hook_log_header}::Merging branded app configuration...complete.`);
+            sails.log.verbose(`${hookName}::Merging configuration...`);
+            _.each(config_dirs, (config_dir) => {
+                config_dir = `${hook_root_dir}/${config_dir}`;
+                sails.log.verbose(`${hook_log_header}::Looking at: ${config_dir}`);
+                if (fs.pathExistsSync(config_dir)) {
+                    const files = this.walkDirSync(config_dir, []);
+                    sails.log.verbose(hook_log_header + "::Processing:");
+                    sails.log.verbose(files);
+                    _.each(files, (file_path) => {
+                        const config_file = require(file_path);
+                        // for overriding values...
+                        const hasCustomDontMerge = _.findKey(config_file, "_dontMerge");
+                        if (hasCustomDontMerge) {
+                            dontMergeFields = dontMergeFields.concat(config_file[hasCustomDontMerge]['_dontMerge']);
+                            _.unset(config_file[hasCustomDontMerge], "_dontMerge");
+                        }
+                        // for deleting values...
+                        const hasDeleteFields = _.findKey(config_file, "_delete");
+                        if (hasDeleteFields) {
+                            _.each(config_file[hasDeleteFields]['_delete'], (toDelete) => {
+                                _.unset(configMap[hasDeleteFields], toDelete);
+                            });
+                            _.unset(config_file[hasDeleteFields], "_delete");
+                        }
+                        _.mergeWith(configMap, config_file, concatArrsFn);
+                        dontMergeFields = _.clone(origDontMerge);
+                    });
+                }
+                else {
+                    sails.log.verbose(hook_log_header + "::Skipping, directory not found:" + config_dir);
+                }
+            });
+            sails.log.verbose(`${hook_log_header}::Merging configuration...complete.`);
+            sails.log.verbose(`${hook_log_header}::Merging Translation files...`);
+            const configWithOptions = sails.config;
+            this.mergeTranslationFiles(hook_root_dir, hook_log_header, configWithOptions.dontBackupCoreLanguageFilesWhenMerging);
+            //If assets directory exists, there must be some assets to copy over
+            if (fs.pathExistsSync(`${hook_root_dir}/assets/`)) {
+                sails.log.verbose(`${hook_log_header}::Copying assets...`);
+                fs.copySync(`${hook_root_dir}/assets/`, "assets/");
+                fs.copySync(`${hook_root_dir}/assets/`, ".tmp/public/");
+            }
+            //If assets directory exists, there must be some assets to copy over
+            if (fs.pathExistsSync(`${hook_root_dir}/views/`)) {
+                sails.log.verbose(`${hook_log_header}::Copying views...`);
+                fs.copySync(`${hook_root_dir}/views/`, "views/");
+            }
+            // check if the core exists when API definitions are present ...
+            if (fs.pathExistsSync(`${appPath}/api/core`) && fs.pathExistsSync(`${hook_root_dir}/api`) && !fs.pathExistsSync(`${hook_root_dir}/api/core`)) {
+                sails.log.verbose(`${hook_log_header}::Adding Symlink to API core... ${hook_root_dir}/api/core -> ${appPath}/api/core`);
+                // create core services symlink if not present
+                fs.ensureSymlinkSync(`${appPath}/api/core`, `${hook_root_dir}/api/core`);
+            }
+            sails.log.verbose(`${hook_log_header}::Adding custom API elements...`);
+            const apiDirs = ["services"];
+            const sailsDynamic = sails;
+            _.each(apiDirs, (apiType) => {
+                const files = this.walkDirSync(`${hook_root_dir}/api/${apiType}`, []);
+                if (!sailsDynamic[apiType]) {
+                    sailsDynamic[apiType] = {};
+                }
+                sails.log.verbose(`${hook_log_header}::Processing '${apiType}':`);
+                sails.log.verbose(JSON.stringify(files));
+                if (!_.isEmpty(files)) {
+                    _.each(files, (file) => {
+                        const apiDef = require(file);
+                        const globalName = (0, path_1.basename)(file, '.js');
+                        const apiElemName = globalName.toLowerCase();
+                        // TODO: deal with controllers or services in nested directories
+                        sailsDynamic[apiType][apiElemName] = apiDef;
+                        globalThis[globalName] = apiDef;
+                    });
+                }
+            });
+            const controllerDirs = ["controllers"];
+            _.each(controllerDirs, (apiType) => {
+                const files = that.walkDirSync(`${hook_root_dir}/api/${apiType}`, []);
+                sails.log.verbose(`${hook_log_header}::Processing '${apiType}':`);
+                sails.log.verbose(JSON.stringify(files));
+                if (!_.isEmpty(files)) {
+                    _.each(files, (file) => {
+                        const apiDef = require(file);
+                        const baseName = (0, path_1.basename)(file, '.js');
+                        const controllerName = (0, path_1.basename)(baseName, 'Controller');
+                        // sails[apiType][apiElemName] = apiDef;
+                        const sailsConfigWithControllers = sails.config;
+                        if (_.isEmpty(sailsConfigWithControllers.controllers)) {
+                            sailsConfigWithControllers.controllers = {};
+                        }
+                        if (_.isEmpty(sailsConfigWithControllers.controllers.moduleDefinitions)) {
+                            sailsConfigWithControllers.controllers.moduleDefinitions = {};
+                        }
+                        const moduleDefinitions = sailsConfigWithControllers.controllers.moduleDefinitions;
+                        _.forOwn(apiDef, (methodFn, methodName) => {
+                            if (!_.startsWith(methodName, '_') && _.isFunction(methodFn)) {
+                                sails.log.verbose(`Setting: ${controllerName}/${methodName}`);
+                                moduleDefinitions[`${controllerName}/${methodName}`] = methodFn;
+                            }
+                        });
+                    });
+                }
+            });
+            // for simple copying of API elements...
+            // Note: 'policies' removed - now loaded via api/hooks/redbox-core-loader
+            const apiCopyDirs = ['responses'];
+            for (const apiCopyDir of apiCopyDirs) {
+                const apiCopyFiles = this.walkDirSync(`${hook_root_dir}/api/${apiCopyDir}`, []);
+                if (!_.isEmpty(apiCopyFiles)) {
+                    for (const apiCopyFile of apiCopyFiles) {
+                        const dest = `${appPath}/api/${apiCopyDir}/${(0, path_1.basename)(apiCopyFile)}`;
+                        sails.log.verbose(`Copying ${apiCopyFile} to ${dest}`);
+                        fs.copySync(apiCopyFile, dest);
+                    }
+                }
+            }
+            sails.log.verbose(`${hook_log_header}::Adding custom API elements...completed.`);
+            sails.log.verbose(`${hookName}::Merge complete.`);
+        }
+        walkDirSync(dir, filelist = []) {
+            if (!fs.pathExistsSync(dir)) {
+                return filelist;
+            }
+            try {
+                const files = fs.readdirSync(dir).sort();
+                _.each(files, (file) => {
+                    const resolved = (0, path_1.resolve)(dir, file);
+                    if (fs.statSync(resolved).isDirectory()) {
+                        filelist = this.walkDirSync(resolved, filelist);
+                    }
+                    else {
+                        filelist.push(resolved);
+                    }
+                });
+            }
+            catch (e) {
+                sails.log.error(`Error walking directory: ${dir}`);
+                sails.log.error(e);
+            }
+            return filelist;
+        }
+        getDirsSync(srcPath) {
+            if (!fs.pathExistsSync(srcPath)) {
+                return [];
+            }
+            return fs.readdirSync(srcPath, { withFileTypes: true })
+                .filter(dirent => dirent.isDirectory())
+                .map(dirent => dirent.name);
+        }
+        mergeTranslationFiles(hook_root_dir, hook_log_header, overwriteOrig = false) {
+            const langCodes = this.getDirsSync(`${hook_root_dir}/locales`);
+            sails.log.verbose(`${hook_log_header}::Language codes to process: ${JSON.stringify(langCodes)}`);
+            for (const langCode of langCodes) {
+                const langBasePath = `locales/${langCode}/translation`;
+                const langJsonPath = `${langBasePath}.json`;
+                const langCsvPath = `${langBasePath}.csv`;
+                const language_file_path = (0, path_1.resolve)(`assets/${langJsonPath}`);
+                const hook_language_file_path = (0, path_1.resolve)(hook_root_dir, langJsonPath);
+                const hook_language_file_csv_path = (0, path_1.resolve)(hook_root_dir, langCsvPath);
+                const mergeFn = function () {
+                    // the actual merge
+                    if (fs.pathExistsSync(language_file_path) && fs.pathExistsSync(hook_language_file_path)) {
+                        sails.log.verbose(`${hook_log_header}::Merging '${langCode}' translation file...`);
+                        const mainTranslation = require(language_file_path);
+                        const hookTranslation = require(hook_language_file_path);
+                        _.merge(mainTranslation, hookTranslation);
+                        // if not overwriting the original, we save a copy of the 'core' version 
+                        if (!overwriteOrig) {
+                            const core_language_file_path = `assets/${langBasePath}-core.json`;
+                            if (!fs.pathExistsSync(core_language_file_path)) {
+                                fs.copySync(language_file_path, core_language_file_path);
+                            }
+                        }
+                        fs.writeFileSync(language_file_path, JSON.stringify(mainTranslation, null, 2));
+                    }
+                };
+                // check if the CSV version is there, and if so convert it
+                if (fs.pathExistsSync(hook_language_file_csv_path)) {
+                    // convert the CSV to JSON 
+                    this.csvToi18Next(hook_language_file_csv_path, hook_language_file_path, mergeFn);
+                }
+                else {
+                    mergeFn();
+                }
+            }
+        }
+        csvToi18Next(csvPath, jsonPath, cb) {
+            const csv = require('csv-parser');
+            const languageJson = {};
+            fs.createReadStream(csvPath)
+                .pipe(csv())
+                .on('data', (row) => {
+                languageJson[row.Key] = row.Message;
+            })
+                .on('end', () => {
+                let data = JSON.stringify(languageJson, null, "  ");
+                data = data.replace(/\\\\\\/g, '\\');
+                fs.writeFileSync(jsonPath, data);
+                cb();
+            });
+        }
+    }
+    Services.Config = Config;
+})(Services || (exports.Services = Services = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ29uZmlnU2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJ2aWNlcy9Db25maWdTZXJ2aWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQSwwRkFBMEY7QUFDMUYsRUFBRTtBQUNGLDZCQUE2QjtBQUM3QiwwQkFBMEI7QUFDMUIsRUFBRTtBQUNGLHVFQUF1RTtBQUN2RSx1RUFBdUU7QUFDdkUsb0VBQW9FO0FBQ3BFLHNDQUFzQztBQUN0QyxFQUFFO0FBQ0Ysa0VBQWtFO0FBQ2xFLGlFQUFpRTtBQUNqRSxnRUFBZ0U7QUFDaEUsK0NBQStDO0FBQy9DLEVBQUU7QUFDRiwwRUFBMEU7QUFDMUUsMEVBQTBFO0FBQzFFLDhEQUE4RDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBRTlELGdEQUFzRDtBQUd0RCw2Q0FBK0I7QUFDL0IsK0JBQXlDO0FBQ3pDLDBDQUE0QjtBQUU1QixJQUFpQixRQUFRLENBbVZ4QjtBQW5WRCxXQUFpQixRQUFRO0lBQ3ZCOzs7OztPQUtHO0lBQ0gsTUFBYSxNQUFPLFNBQVEsc0JBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTztRQUU1QixnQkFBZ0IsR0FBYTtZQUM5QyxVQUFVO1lBQ1YsaUJBQWlCO1NBQ2xCLENBQUM7UUFFSyxRQUFRLENBQUMsU0FBaUIsRUFBRSxXQUFtQjtZQUNwRCxNQUFNLFlBQVksR0FBRyxDQUFDLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSwwQkFBMEIsRUFBRSxTQUFTLENBQVcsQ0FBQztZQUNuRixNQUFNLHdCQUF3QixHQUFHLENBQUMsSUFBWSxFQUFFLEVBQUU7Z0JBQ2hELElBQUksQ0FBQyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxzQkFBc0IsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUM7b0JBQzNFLE1BQU0sY0FBYyxHQUFHLEtBQUss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

package/dist/services/ContrastService.d.ts

@@ -0,0 +1,77 @@
+import { Services as services } from '../CoreService';
+type TextSize = 'normal' | 'large';
+/**
+ * Represents a contrast ratio violation for a color pair
+ */
+export interface ContrastViolation {
+    /** Name identifier for the color pair */
+    pair: string;
+    /** Actual contrast ratio calculated */
+    ratio: number;
+    /** Minimum required ratio per WCAG AA */
+    required: number;
+    /** The two colors being compared [foreground, background] */
+    colors: [string, string];
+    /** Text size category affecting minimum ratio */
+    textSize: TextSize;
+}
+/**
+ * ContrastService
+ *
+ * Validate color contrast ratios using WCAG AA standards
+ * and provide suggestions for compliant color combinations.
+ *
+ * Usage: await ContrastService.validate(variablesMap)
+ * Returns: { valid: boolean, violations: ContrastViolation[] }
+ *
+ * Usage: await ContrastService.suggestCompliant(colorA, colorB)
+ * Returns: { suggested: string, originalRatio: number, newRatio: number }
+ */
+export declare namespace Services {
+    class Contrast extends services.Core.Service {
+        protected _exportedMethods: string[];
+        /**
+         * WCAG AA contrast requirements
+         * Normal text: 4.5:1, Large text: 3:1
+         */
+        private readonly WCAG_AA_NORMAL;
+        private readonly WCAG_AA_LARGE;
+        /**
+         * Convert hex color to RGB values
+         */
+        private hexToRgb;
+        /**
+         * Calculate relative luminance of a color
+         * Formula: https://www.w3.org/TR/WCAG21/#dfn-relative-luminance
+         */
+        getLuminance(color: string): number;
+        /**
+         * Calculate contrast ratio between two colors
+         * Formula: https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio
+         */
+        calculateRatio(colorA: string, colorB: string): number;
+        /**
+         * Validate contrast ratios for defined color pairs
+         * Returns violations for pairs that don't meet WCAG AA standards
+         */
+        validate(variables: Record<string, string>): {
+            valid: boolean;
+            violations: ContrastViolation[];
+        };
+        /**
+         * Suggest a compliant color by adjusting the foreground color
+         * to meet contrast requirements with the background
+         */
+        suggestCompliant(foreground: string, background: string, textSize?: TextSize): {
+            suggested: string;
+            originalRatio: number;
+            newRatio: number;
+            adjustments: number;
+        };
+    }
+}
+declare global {
+    let ContrastService: Services.Contrast;
+}
+export {};
+//# sourceMappingURL=ContrastService.d.ts.map

package/dist/services/ContrastService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContrastService.d.ts","sourceRoot":"","sources":["../../src/services/ContrastService.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,QAAQ,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,KAAK,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,iDAAiD;IACjD,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,yBAAiB,QAAQ,CAAC;IACtB,MAAa,QAAS,SAAQ,QAAQ,CAAC,IAAI,CAAC,OAAO;QAE/C,UAAmB,gBAAgB,EAAE,MAAM,EAAE,CAK3C;QAEF;;;WAGG;QACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;QACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAO;QAErC;;WAEG;QACH,OAAO,CAAC,QAAQ;QAShB;;;WAGG;QACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;QAoBnC;;;WAGG;QACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;QAUtD;;;WAGG;QACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;YACzC,KAAK,EAAE,OAAO,CAAC;YACf,UAAU,EAAE,iBAAiB,EAAE,CAAC;SACnC;QA+DD;;;WAGG;QACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAmB,GAAG;YACrF,SAAS,EAAE,MAAM,CAAC;YAClB,aAAa,EAAE,MAAM,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,EAAE,MAAM,CAAC;SACvB;KAiEJ;CACJ;AAED,OAAO,CAAC,MAAM,CAAC;IACX,IAAI,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAC1C"}