xypriss 9.0.13 → 9.1.1

package/dist/esm/src/sys.js

@@ -1,401 +0,0 @@
-import path__default from 'path';
-import { XyPrissFS } from './sys/System.js';
-import { DotEnvLoader } from './utils/DotEnvLoader.js';
-
-/**
- * **XyPriss System Variables (`__sys__`)**
- *
- * The **Central Nervous System** of a XyPriss application.
- * This class serves as the singleton entry point for:
- *
- * 1.  **Configuration Management**: Stores and syncs app metadata (`__port__`, `__mode__`).
- * 2.  **Environment Control**: Provides a safe, typed interface for `process.env`.
- * 3.  **System Operations**: Inherits ALL capabilities from `SysApi`, `FSApi`, and `PathApi`.
- *
- * Access this global instance via `__sys__` anywhere in your code.
- *
- * @class XyPrissSys
- * @extends XyPrissFS
- */
-class XyPrissSys extends XyPrissFS {
-    /**
-     * **Initialize System**
-     *
-     * Creates the global system instance.
-     * Automatically syncs ports and environment settings based on inputs.
-     *
-     * @param {Record<string, any>} [data] - Initial configuration data to merge.
-     */
-    constructor(data = {}) {
-        const root = data.__root__ || process.cwd();
-        super({ __root__: root });
-        // =========================================================================
-        // SYSTEM METADATA (Configuration)
-        // =========================================================================
-        /** Application version string (semver). */
-        this.__version__ = "0.0.0";
-        /** Application author or organization. */
-        this.__author__ = "unknown";
-        /** Brief application description. */
-        this.__description__ = "A XyPriss application";
-        /** Map of application-specific URLs (e.g., API docs, frontend). */
-        this.__app_urls__ = {};
-        /** Application slug name (kebab-case recommended). */
-        this.__name__ = "xypriss-app";
-        /** Short alias for CLI or logging. */
-        this.__alias__ = "app";
-        /** Primary listening port (number). Syncs with `__PORT__`. */
-        this.__port__ = 3000;
-        /** Primary listening port (mirror). Syncs with `__port__`. */
-        this.__PORT__ = 3000;
-        /** Absolute path to the project root directory. */
-        this.__root__ = process.cwd();
-        /**
-         * **Environment Variable Manager (`__env__`)**
-         *
-         * A cleaner, safer interface for interacting with `process.env`.
-         * Also manages the current environment mode (development, production, etc.).
-         */
-        this.__env__ = {
-            /** Current environment mode (development, production, staging, test). */
-            mode: "development",
-            /**
-             * Sets an environment variable.
-             * @param {string} key - The variable name.
-             * @param {string} value - The value to set.
-             */
-            set: (key, value) => {
-                if (globalThis.__xy_env_store__) {
-                    globalThis.__xy_env_store__[key] = value;
-                }
-                process.env[key] = value;
-            },
-            /**
-             * Gets an environment variable with an optional default.
-             * @param {string} key - The variable name.
-             * @param {string} [defaultValue] - Value to return if key is missing.
-             * @returns {string|undefined} The value or default.
-             */
-            get: (key, defaultValue) => {
-                const store = globalThis.__xy_env_store__ || process.env;
-                return store[key] || defaultValue;
-            },
-            /**
-             * Checks if an environment variable exists.
-             * @param {string} key - The variable name.
-             * @returns {boolean} True if defined.
-             */
-            has: (key) => {
-                const store = globalThis.__xy_env_store__ || process.env;
-                return store[key] !== undefined;
-            },
-            /**
-             * Deletes an environment variable.
-             * @param {string} key - The variable name.
-             */
-            delete: (key) => {
-                if (globalThis.__xy_env_store__) {
-                    delete globalThis.__xy_env_store__[key];
-                }
-                delete process.env[key];
-            },
-            /**
-             * Returns all environment variables as an object.
-             * @returns {NodeJS.ProcessEnv} Dictionary of all variables.
-             */
-            all: () => {
-                return globalThis.__xy_env_store__ || process.env;
-            },
-            // Helper methods for the mode
-            /** Returns true if `mode` is "production". */
-            isProduction: () => this.__env__.mode === "production",
-            /** Returns true if `mode` is "development". */
-            isDevelopment: () => this.__env__.mode === "development",
-            /** Returns true if `mode` is "staging". */
-            isStaging: () => this.__env__.mode === "staging",
-            /** Returns true if `mode` is "test". */
-            isTest: () => this.__env__.mode === "test",
-            /** Returns true if `mode` matches the provided name. */
-            is: (envName) => this.__env__.mode === envName,
-        };
-        this.__root__ = root;
-        this.$update(data);
-    }
-    /**
-     * **Update Configuration**
-     *
-     * Merges a configuration object into the system state.
-     * Handles intelligent synchronization of properties (like matching `__port__` and `__PORT__`).
-     *
-     * @param {Record<string, any>} data - Data to merge.
-     */
-    $update(data) {
-        // Prepare data for merging, protecting the __env__ manager
-        const mergeData = { ...data };
-        const envUpdate = data.__env__ || data.__env || data.__mode__ || data.__mode;
-        // Remove environment keys from mergeData to prevent Object.assign from overwriting the manager object
-        delete mergeData.__env__;
-        delete mergeData.__env;
-        delete mergeData.__mode__;
-        delete mergeData.__mode;
-        Object.assign(this, mergeData);
-        // Sync ports
-        if (data.__port__ !== undefined)
-            this.__PORT__ = data.__port__;
-        if (data.__PORT__ !== undefined)
-            this.__port__ = data.__PORT__;
-        if (data.__port !== undefined) {
-            this.__port__ = data.__port;
-            this.__PORT__ = data.__port;
-        }
-        if (data.__PORT !== undefined) {
-            this.__port__ = data.__PORT;
-            this.__PORT__ = data.__PORT;
-        }
-        // Correctly update environment mode without destroying the manager
-        if (envUpdate !== undefined) {
-            if (typeof envUpdate === "string") {
-                this.__env__.mode = envUpdate;
-            }
-            else if (typeof envUpdate === "object" &&
-                envUpdate !== null &&
-                envUpdate.mode) {
-                this.__env__.mode = envUpdate.mode;
-            }
-        }
-    }
-    /**
-     * **Add Custom Variable ($add)**
-     *
-     * Dynamically adds a property to the system object.
-     * Use this for runtime configuration injection.
-     *
-     * @param {string} key - Property name.
-     * @param {any} value - Value.
-     */
-    $add(key, value) {
-        this[key] = value;
-    }
-    /**
-     * **Remove Variable ($remove)**
-     *
-     * Removes a property from the system object.
-     *
-     * @param {string} key - Property name.
-     * @returns {boolean} True if the property existed and was removed.
-     */
-    $remove(key) {
-        if (this.$has(key)) {
-            delete this[key];
-            return true;
-        }
-        return false;
-    }
-    /**
-     * **Serialize to JSON ($toJSON)**
-     *
-     * Returns a clean, plain JSON representation of the system configuration.
-     * It strictly excludes internal methods, prefix-properties (starting with `$`),
-     * and API inheritance artifacts (`fs`/`sys`/`path` references).
-     *
-     * @returns {Record<string, any>} A serializable configuration object.
-     */
-    $toJSON() {
-        const json = {};
-        for (const key in this) {
-            if (!key.startsWith("$") &&
-                typeof this[key] !== "function" &&
-                key !== "__env__" &&
-                !["fs", "sys", "path"].includes(key)) {
-                json[key] = this[key];
-            }
-        }
-        return json;
-    }
-    // =========================================================================
-    // HELPERS
-    // =========================================================================
-    /**
-     * **Get Value ($get)**
-     *
-     * Safely retrieves a configuration value by key, with a fallback default.
-     *
-     * @template T
-     * @param {string} key - Property key.
-     * @param {T} [defaultValue] - Value to return if key is undefined.
-     * @returns {T} The found value or default.
-     */
-    $get(key, defaultValue) {
-        return (this[key] !== undefined ? this[key] : defaultValue);
-    }
-    /**
-     * **Check Existence ($has)**
-     *
-     * Checks if a configuration key is defined on the system object.
-     *
-     * @param {string} key - Property key.
-     * @returns {boolean} True if defined.
-     */
-    $has(key) {
-        return this[key] !== undefined;
-    }
-    /**
-     * **List Configuration Keys ($keys)**
-     *
-     * Returns a list of all active configuration keys (e.g., `__port__`, `__version__`).
-     * Filters out internal methods and API properties.
-     *
-     * @returns {string[]} Array of key strings.
-     */
-    $keys() {
-        return Object.keys(this).filter((key) => !key.startsWith("$") &&
-            typeof this[key] !== "function" &&
-            key !== "__env__" &&
-            !["fs", "sys", "path"].includes(key));
-    }
-    /**
-     * **Reset System State ($reset)**
-     *
-     * Resets all custom configuration to default values.
-     * Useful for testing or re-initialization.
-     */
-    $reset() {
-        const envManager = this.__env__;
-        Object.keys(this).forEach((key) => {
-            if (key !== "__env__" &&
-                !key.startsWith("$") &&
-                !["fs", "sys", "path"].includes(key)) {
-                delete this[key];
-            }
-        });
-        this.__version__ = "0.0.0";
-        this.__author__ = "unknown";
-        this.__app_urls__ = {};
-        this.__name__ = "xypriss-app";
-        this.__description__ = "A XyPriss application";
-        this.__alias__ = "app";
-        this.__port__ = 3000;
-        this.__PORT__ = 3000;
-        this.__root__ = process.cwd();
-        this.__env__ = envManager;
-        this.__env__.mode = "development";
-    }
-    /**
-     * **Clone System ($clone)**
-     *
-     * Creates a deep independent copy of the current system configuration.
-     *
-     * @returns {XyPrissSys} A new independent instance.
-     */
-    $clone() {
-        return new XyPrissSys(this.$toJSON());
-    }
-}
-// Global Registration & Environment Setup
-if (typeof globalThis !== "undefined") {
-    // 1. Store the original environment and load .env files
-    const originalEnv = { ...process.env };
-    // Discover .env files in current and parent directories
-    const envPaths = [];
-    let currentDir = process.cwd();
-    const rootDir = path__default.parse(currentDir).root;
-    while (currentDir !== rootDir) {
-        envPaths.push(path__default.resolve(currentDir, ".env"));
-        envPaths.push(path__default.resolve(currentDir, ".env.local"));
-        envPaths.push(path__default.resolve(currentDir, ".private/.env"));
-        currentDir = path__default.dirname(currentDir);
-    }
-    // Add root directory as well
-    envPaths.push(path__default.resolve(rootDir, ".env"));
-    const loaded = DotEnvLoader.load({
-        path: envPaths,
-        override: true,
-    });
-    // Merge loaded variables into our private store
-    globalThis.__xy_env_store__ = { ...originalEnv, ...loaded };
-    const defaultPort = parseInt(globalThis.__xy_env_store__["PORT"] || "3000");
-    // 2. Initialize the global system instance
-    globalThis.__sys__ =
-        globalThis.__sys__ ||
-            new XyPrissSys({
-                __port__: defaultPort,
-                __PORT__: defaultPort,
-                __mode__: globalThis.__xy_env_store__["NODE_ENV"] ||
-                    "development",
-            });
-    // 3. The "Env Shield": Discourage direct process.env access
-    // This Proxy hides non-essential variables from users to force __sys__.__env__ usage.
-    const whitelistedFields = [
-        "PORT",
-        "TERM",
-        "PATH",
-        "PWD",
-        "HOME",
-        "USER",
-        "LANG",
-        "COLORTERM",
-        "FORCE_COLOR",
-        "TERM_PROGRAM",
-        "EDITOR",
-        "SHELL",
-        "SHLVL",
-        "NO_DEPRECATION",
-        "DEBUG_FD",
-        "DEBUG",
-        "NODE_DEBUG",
-        "NODE_OPTIONS",
-        "NODE_ENV",
-        "ENC_SECRET_KEY",
-        "ENC_SECRET_SEED",
-        "ENC_SECRET_SALT",
-        "TRACE_DEPRECATION",
-        "APPEND_DEPRECATION",
-        "READABLE_STREAM",
-        "BUN_CONFIG_VERBOSE_FETCH",
-    ];
-    let warningShown = false;
-    const envShield = new Proxy(process.env, {
-        get(target, prop, receiver) {
-            if (typeof prop !== "string")
-                return Reflect.get(target, prop, receiver);
-            // Allow whitelisted or internal fields (XY_, XYPRISS_, DOTENV_)
-            if (whitelistedFields.includes(prop) ||
-                prop.startsWith("XY_") ||
-                prop.startsWith("XYPRISS_") ||
-                prop.startsWith("ENC_") ||
-                prop.startsWith("DOTENV_")) {
-                return Reflect.get(target, prop, receiver);
-            }
-            // For anything else, if it's not our own codebase, warn and hide
-            if (!prop.startsWith("__") && !whitelistedFields.includes(prop)) {
-                if (!warningShown) {
-                    const store = globalThis.__xy_env_store__ || {};
-                    const isSilent = store["XYPRISS_ENV_SHIELD"] === "silent";
-                    if (!isSilent) {
-                        console.warn(`\x1b[33m[SECURITY-SHIELD]\x1b[0m Direct access to process.env."${prop}" is blocked for security. ` +
-                            `Please use \x1b[36m__sys__.__env__.get("${prop}")\x1b[0m instead. Set "XYPRISS_ENV_SHIELD=silent" in your .env file to disable this warning.`);
-                    }
-                    warningShown = true;
-                }
-                return undefined; // MASKED for user code
-            }
-            return Reflect.get(target, prop, receiver);
-        },
-    });
-    // Protect the global reference
-    try {
-        Object.defineProperty(process, "env", {
-            value: envShield,
-            writable: false,
-            configurable: true,
-        });
-    }
-    catch (e) {
-        // Fallback for environments where process.env is strictly protected
-    }
-}
-/** Global singleton instance of the system. */
-const __sys__ = globalThis.__sys__;
-
-export { XyPrissSys, __sys__ };
-//# sourceMappingURL=sys.js.map

package/dist/esm/src/sys.js.map

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

package/dist/esm/src/types/NotFoundConfig.js

@@ -1,84 +0,0 @@
-import { Interface, Mod } from 'reliant-type';
-
-const schm = Interface({
-    /**
-     * The title displayed in the browser tab and as the primary heading of the error page.
-     */
-    title: "string",
-    /**
-     * The descriptive message explaining the error to the user.
-     */
-    message: "string",
-    /**
-     * The original URL path that resulted in the 404 Not Found error.
-     */
-    requestedPath: "string",
-    /**
-     * The CSS class name applied to the body or container to define the visual theme (e.g., 'theme-dark').
-     */
-    themeClass: "auto|light|dark",
-    /**
-     * A string containing raw CSS rules to be injected directly into the page for custom styling overrides.
-     */
-    customCSS: "string",
-    /**
-     * The absolute or relative URL of the favicon to be displayed in the browser's address bar or tabs.
-     */
-    faviconUrl: "string",
-    /**
-     * The HTTP method (e.g., GET, POST) used for the request that triggered the error.
-     */
-    requestedMethod: "string",
-    /**
-     * The name of the application or server instance, typically used for branding in headers or footers.
-     */
-    appName: "string",
-    /**
-     * The target URL for automatic or manual redirection from the error page.
-     */
-    redirectTo: "string",
-    /**
-     * The human-readable text for the redirection link or button.
-     */
-    redirectText: "string",
-    /**
-     * A client-side function executed to handle the redirection logic or countdown behavior.
-     */
-    // @fortify-ignore
-    redirectScript: "fn(...args: any[]) => void)?",
-    /**
-     * Contact information, an email address, for user assistance.
-     */
-    contactEmail: "string?",
-});
-const validate404Cfg = (cfg) => {
-    const modSchm = Mod.omit(Mod.deepPartial(schm), [
-        "requestedMethod",
-        "requestedPath",
-    ]);
-    try {
-        const rs = modSchm.safeParse(cfg);
-        if (!rs.success) {
-            console.error("error: ", rs.errors.map((e) => e.message).join("\n"));
-            throw new Error(rs.errors.map((e) => e.message).join("\n"));
-        }
-        return rs.data;
-    }
-    catch (error) {
-        console.error("error: ", error);
-        throw error.message;
-    }
-};
-// validate404Cfg({
-//     enabled: true,
-//     title: "Page Not Found - XyPriss",
-//     message: "The page you're looking for doesn't exist.",
-//     redirectTo: "/",
-//     redirectScript: () => {
-//         console.log("redirecting...");
-//         return {}
-//     },
-// })
-
-export { validate404Cfg };
-//# sourceMappingURL=NotFoundConfig.js.map

package/dist/esm/src/types/NotFoundConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"NotFoundConfig.js","sources":["../../../../src/types/NotFoundConfig.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA,MAAM,IAAI,GAAG,SAAS,CAAC;AACnB;;AAEG;AACH,IAAA,KAAK,EAAE,QAAQ;AAEf;;AAEG;AACH,IAAA,OAAO,EAAE,QAAQ;AAEjB;;AAEG;AACH,IAAA,aAAa,EAAE,QAAQ;AAEvB;;AAEG;AACH,IAAA,UAAU,EAAE,iBAAiB;AAE7B;;AAEG;AACH,IAAA,SAAS,EAAE,QAAQ;AAEnB;;AAEG;AACH,IAAA,UAAU,EAAE,QAAQ;AAEpB;;AAEG;AACH,IAAA,eAAe,EAAE,QAAQ;AAEzB;;AAEG;AACH,IAAA,OAAO,EAAE,QAAQ;AAEjB;;AAEG;AACH,IAAA,UAAU,EAAE,QAAQ;AAEpB;;AAEG;AACH,IAAA,YAAY,EAAE,QAAQ;AAEtB;;AAEG;;AAEH,IAAA,cAAc,EAAE,8BAA8B;AAE9C;;AAEG;AACH,IAAA,YAAY,EAAE,SAAS;AAC1B,CAAA,CAAC,CAAC;AAgBU,MAAA,cAAc,GAAG,CAAC,GAAmB,KAAI;AAClD,IAAA,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;QAC5C,iBAAiB;QACjB,eAAe;AAClB,KAAA,CAAC,CAAC;AACH,IAAA,IAAI;QACA,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAClC,QAAA,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE;YACb,OAAO,CAAC,KAAK,CACT,SAAS,EACT,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7C,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;SAC/D;QACD,OAAO,EAAE,CAAC,IAAI,CAAC;KAClB;IAAC,OAAO,KAAU,EAAE;AACjB,QAAA,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,CAAC,OAAO,CAAC;KACvB;AACL,EAAE;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;;;;"}

package/dist/esm/src/utils/DotEnvLoader.js

@@ -1,72 +0,0 @@
-import fs__default from 'fs';
-import path__default from 'path';
-
-/**
- * **DotEnvLoader**
- *
- * A lightweight, zero-dependency .env file parser and loader.
- * Inspired by the standard dotenv logic but built specifically for XyPriss.
- */
-class DotEnvLoader {
-    /**
-     * Parses a string or buffer containing .env file content.
-     * @param src Content of the .env file.
-     * @returns Object with key-value pairs.
-     */
-    static parse(src) {
-        const obj = {};
-        let content = src.toString();
-        content = content.replace(/\r\n?/gm, "\n");
-        let match;
-        // Reset lastIndex for the global regex
-        this.LINE.lastIndex = 0;
-        while ((match = this.LINE.exec(content)) !== null) {
-            const key = match[1];
-            let value = (match[2] || "").trim();
-            // Handle quoted values
-            const maybeQuote = value[0];
-            value = value.replace(/^(['"`])([\s\S]*)\1$/gm, "$2");
-            // Handle escaped characters in double quotes
-            if (maybeQuote === '"') {
-                value = value.replace(/\\n/g, "\n");
-                value = value.replace(/\\r/g, "\r");
-            }
-            obj[key] = value;
-        }
-        return obj;
-    }
-    /**
-     * Loads .env files into an object (usually process.env).
-     * @param options Configuration for loading.
-     * @returns The parsed object.
-     */
-    static load(options = {}) {
-        const paths = Array.isArray(options.path)
-            ? options.path
-            : [options.path || path__default.resolve(process.cwd(), ".env")];
-        const override = options.override ?? false;
-        const parsedAll = {};
-        for (const envPath of paths) {
-            try {
-                if (fs__default.existsSync(envPath)) {
-                    const content = fs__default.readFileSync(envPath);
-                    const parsed = this.parse(content);
-                    for (const [key, value] of Object.entries(parsed)) {
-                        if (override || process.env[key] === undefined) {
-                            process.env[key] = value;
-                        }
-                        parsedAll[key] = value;
-                    }
-                }
-            }
-            catch (err) {
-                // Silently ignore or log if debug is enabled
-            }
-        }
-        return parsedAll;
-    }
-}
-DotEnvLoader.LINE = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/gm;
-
-export { DotEnvLoader };
-//# sourceMappingURL=DotEnvLoader.js.map

package/dist/esm/src/utils/DotEnvLoader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DotEnvLoader.js","sources":["../../../../src/utils/DotEnvLoader.ts"],"sourcesContent":[null],"names":["path","fs"],"mappings":";;;AAGA;;;;;AAKG;MACU,YAAY,CAAA;AAIrB;;;;AAIG;IACI,OAAO,KAAK,CAAC,GAAoB,EAAA;QACpC,MAAM,GAAG,GAA2B,EAAE,CAAC;AACvC,QAAA,IAAI,OAAO,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAE3C,QAAA,IAAI,KAAK,CAAC;;AAEV,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;AAExB,QAAA,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE;AAC/C,YAAA,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AACrB,YAAA,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;;AAGpC,YAAA,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;;AAGtD,YAAA,IAAI,UAAU,KAAK,GAAG,EAAE;gBACpB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACpC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;aACvC;AAED,YAAA,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;SACpB;AAED,QAAA,OAAO,GAAG,CAAC;KACd;AAED;;;;AAIG;AACI,IAAA,OAAO,IAAI,CACd,OAAA,GAA4D,EAAE,EAAA;QAE9D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;cACnC,OAAO,CAAC,IAAI;AACd,cAAE,CAAC,OAAO,CAAC,IAAI,IAAIA,aAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5D,QAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC3C,MAAM,SAAS,GAA2B,EAAE,CAAC;AAE7C,QAAA,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE;AACzB,YAAA,IAAI;AACA,gBAAA,IAAIC,WAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;oBACxB,MAAM,OAAO,GAAGA,WAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;oBACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAEnC,oBAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;wBAC/C,IAAI,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;AAC5C,4BAAA,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;yBAC5B;AACD,wBAAA,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;qBAC1B;iBACJ;aACJ;YAAC,OAAO,GAAG,EAAE;;aAEb;SACJ;AAED,QAAA,OAAO,SAAS,CAAC;KACpB;;AAvEuB,YAAI,CAAA,IAAA,GACxB,8IAA8I;;;;"}