@gitkraken/core-gitlens 0.1.0

package/dist/utils/lazy.js

@@ -0,0 +1,40 @@
+/** Provides lazy initialization support */
+export class Lazy {
+    valueProvider;
+    _evaluated = false;
+    get evaluated() {
+        return this._evaluated;
+    }
+    _exception;
+    _value;
+    /**
+     * Creates a new instance of Lazy<T> that uses the specified initialization function.
+     * @param valueProvider The initialization function that is used to produce the value when it is needed.
+     */
+    constructor(valueProvider) {
+        this.valueProvider = valueProvider;
+    }
+    /** Gets the lazily initialized value of the current Lazy<T> instance */
+    get value() {
+        if (!this._evaluated) {
+            try {
+                this._value = this.valueProvider();
+            }
+            catch (ex) {
+                this._exception = ex;
+                throw ex;
+            }
+            finally {
+                this._evaluated = true;
+            }
+        }
+        if (this._exception)
+            throw this._exception;
+        return this._value;
+    }
+}
+/** Creates a new lazy value with the specified initialization function */
+export function lazy(valueProvider) {
+    return new Lazy(valueProvider);
+}
+//# sourceMappingURL=lazy.js.map

package/dist/utils/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../src/utils/lazy.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,OAAO,IAAI;IAaa;IAZrB,UAAU,GAAY,KAAK,CAAC;IACpC,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAEO,UAAU,CAAoB;IAC9B,MAAM,CAAK;IAEnB;;;OAGG;IACH,YAA6B,aAAsB;QAAtB,kBAAa,GAAb,aAAa,CAAS;IAAG,CAAC;IAEvD,wEAAwE;IACxE,IAAI,KAAK;QACR,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,IAAI,CAAC;gBACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACpC,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC;gBACb,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;gBACrB,MAAM,EAAE,CAAC;YACV,CAAC;oBAAS,CAAC;gBACV,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACxB,CAAC;QACF,CAAC;QAED,IAAI,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,CAAC,UAAU,CAAC;QAE3C,OAAO,IAAI,CAAC,MAAO,CAAC;IACrB,CAAC;CACD;AAED,0EAA0E;AAC1E,MAAM,UAAU,IAAI,CAAI,aAAsB;IAC7C,OAAO,IAAI,IAAI,CAAI,aAAa,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/loggable.d.ts

@@ -0,0 +1,5 @@
+export interface Loggable {
+    toLoggable(): string;
+}
+export declare function isLoggable(o: unknown): o is Loggable;
+//# sourceMappingURL=loggable.d.ts.map

package/dist/utils/loggable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggable.d.ts","sourceRoot":"","sources":["../../src/utils/loggable.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACxB,UAAU,IAAI,MAAM,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,QAAQ,CAEpD"}

package/dist/utils/loggable.js

@@ -0,0 +1,4 @@
+export function isLoggable(o) {
+    return o != null && typeof o === 'object' && 'toLoggable' in o && typeof o.toLoggable === 'function';
+}
+//# sourceMappingURL=loggable.js.map

package/dist/utils/loggable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggable.js","sourceRoot":"","sources":["../../src/utils/loggable.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,UAAU,CAAC,CAAU;IACpC,OAAO,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,IAAI,CAAC,IAAI,OAAQ,CAAc,CAAC,UAAU,KAAK,UAAU,CAAC;AACpH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,63 @@
+import type { ScopedLogger } from './logger.scoped.js';
+export type LogLevel = 'off' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+export declare const OrderedLevel: {
+    readonly Off: 0;
+    readonly Trace: 1;
+    readonly Debug: 2;
+    readonly Info: 3;
+    readonly Warn: 4;
+    readonly Error: 5;
+};
+export type OrderedLevel = (typeof OrderedLevel)[keyof typeof OrderedLevel];
+export interface LogChannelProvider {
+    readonly name: string;
+    createChannel(name: string): LogChannel;
+    toLoggable?(o: unknown): string | undefined;
+    hash?(data: string): string;
+    sanitizeKeys?: Set<string>;
+}
+export interface LogChannel {
+    readonly name: string;
+    readonly logLevel: OrderedLevel;
+    readonly onDidChangeLogLevel?: (listener: (level: OrderedLevel) => void) => {
+        dispose(): void;
+    };
+    dispose?(): void;
+    show?(preserveFocus?: boolean): void;
+    trace(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(error: string | Error, ...args: any[]): void;
+}
+declare class Logger {
+    #private;
+    configure(provider: LogChannelProvider, debugging?: boolean): void;
+    enabled(level?: Exclude<LogLevel, 'off'>): boolean;
+    get isDebugging(): boolean;
+    get logLevel(): LogLevel;
+    get timestamp(): string;
+    trace(message: string, ...params: any[]): void;
+    trace(scope: ScopedLogger | undefined, message: string, ...params: any[]): void;
+    debug(message: string, ...params: any[]): void;
+    debug(scope: ScopedLogger | undefined, message: string, ...params: any[]): void;
+    info(message: string, ...params: any[]): void;
+    info(scope: ScopedLogger | undefined, message: string, ...params: any[]): void;
+    warn(message: string, ...params: any[]): void;
+    warn(scope: ScopedLogger | undefined, message: string, ...params: any[]): void;
+    error(ex: Error | unknown, message?: string, ...params: any[]): void;
+    error(ex: Error | unknown, scope?: ScopedLogger, message?: string, ...params: any[]): void;
+    showOutputChannel(preserveFocus?: boolean): void;
+    toLoggable(o: any, name?: string): string;
+    sanitize(key: string, value: unknown): string | undefined;
+}
+declare const _logger: Logger;
+export { _logger as Logger };
+export declare const customLoggableNameFns: WeakMap<object, (instance: any, name: string) => string>;
+export declare function getLoggableName(instance: object): string;
+export interface LogProvider {
+    enabled(logLevel: Exclude<LogLevel, 'off'>): boolean;
+    log(logLevel: LogLevel, scope: ScopedLogger | undefined, message: string, ...params: any[]): void;
+}
+export declare const defaultLogProvider: LogProvider;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

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

package/dist/utils/logger.js

@@ -0,0 +1,316 @@
+import { padOrTruncateEnd } from './string.js';
+const isoTRegex = /T/;
+const stackCallerRegex = /.*\s*?at\s(.+?)\s/;
+const leadingUnderscoreRegex = /^_+/;
+export const OrderedLevel = {
+    Off: 0,
+    Trace: 1,
+    Debug: 2,
+    Info: 3,
+    Warn: 4,
+    Error: 5,
+};
+const defaultSanitizeKeys = ['accessToken', 'password', 'token'];
+class Logger {
+    #output;
+    #provider;
+    configure(provider, debugging = false) {
+        this.#provider = {
+            ...provider,
+            sanitizeKeys: new Set([...defaultSanitizeKeys, ...(provider.sanitizeKeys ?? [])]),
+        };
+        this.#isDebugging = debugging;
+        // Create output channel and sync with the host's log level
+        this.#output = provider.createChannel(provider.name);
+        this.#level = this.#output.logLevel;
+        this.#output.onDidChangeLogLevel?.(level => {
+            this.#level = level;
+        });
+    }
+    enabled(level) {
+        if (this.isDebugging)
+            return true;
+        if (this.#level === OrderedLevel.Off)
+            return false;
+        if (level == null)
+            return true;
+        return this.#level <= toOrderedLevel(level);
+    }
+    #isDebugging = false;
+    get isDebugging() {
+        return this.#isDebugging;
+    }
+    #level = OrderedLevel.Off;
+    get logLevel() {
+        return toFriendlyLogLevel(this.#level);
+    }
+    get timestamp() {
+        return `[${new Date().toISOString().replace(isoTRegex, ' ').slice(0, -1)}]`;
+    }
+    trace(scopeOrMessage, ...params) {
+        if ((this.#level === OrderedLevel.Off || this.#level > OrderedLevel.Trace) && !this.isDebugging)
+            return;
+        let message;
+        if (typeof scopeOrMessage === 'string') {
+            message = scopeOrMessage;
+        }
+        else {
+            message = params.shift();
+            if (scopeOrMessage != null) {
+                message = `${scopeOrMessage.prefix} ${message ?? ''}`;
+            }
+        }
+        if (this.isDebugging) {
+            console.debug(`[${padOrTruncateEnd(this.#provider.name, 13)}]`, this.timestamp, message ?? '', ...params);
+        }
+        this.#output?.trace(`  ${message ?? ''}${this.#toLoggableParams(true, params)}`);
+    }
+    debug(scopeOrMessage, ...params) {
+        if ((this.#level === OrderedLevel.Off || this.#level > OrderedLevel.Debug) && !this.isDebugging)
+            return;
+        let message;
+        if (typeof scopeOrMessage === 'string') {
+            message = scopeOrMessage;
+        }
+        else {
+            message = params.shift();
+            if (scopeOrMessage != null) {
+                message = `${scopeOrMessage.prefix} ${message ?? ''}`;
+            }
+        }
+        if (this.isDebugging) {
+            console.debug(`[${padOrTruncateEnd(this.#provider.name, 13)}]`, this.timestamp, message ?? '', ...params);
+        }
+        this.#output?.debug(`  ${message ?? ''}${this.#toLoggableParams(false, params)}`);
+    }
+    info(scopeOrMessage, ...params) {
+        if ((this.#level === OrderedLevel.Off || this.#level > OrderedLevel.Info) && !this.isDebugging)
+            return;
+        let message;
+        if (typeof scopeOrMessage === 'string') {
+            message = scopeOrMessage;
+        }
+        else {
+            message = params.shift();
+            if (scopeOrMessage != null) {
+                message = `${scopeOrMessage.prefix} ${message ?? ''}`;
+            }
+        }
+        if (this.isDebugging) {
+            console.info(`[${padOrTruncateEnd(this.#provider.name, 13)}]`, this.timestamp, message ?? '', ...params);
+        }
+        this.#output?.info(`   ${message ?? ''}${this.#toLoggableParams(false, params)}`);
+    }
+    warn(scopeOrMessage, ...params) {
+        if ((this.#level === OrderedLevel.Off || this.#level > OrderedLevel.Warn) && !this.isDebugging)
+            return;
+        let message;
+        if (typeof scopeOrMessage === 'string') {
+            message = scopeOrMessage;
+        }
+        else {
+            message = params.shift();
+            if (scopeOrMessage != null) {
+                message = `${scopeOrMessage.prefix} ${message ?? ''}`;
+            }
+        }
+        if (this.isDebugging) {
+            console.warn(`[${padOrTruncateEnd(this.#provider.name, 13)}]`, this.timestamp, message ?? '', ...params);
+        }
+        this.#output?.warn(`${message ?? ''}${this.#toLoggableParams(false, params)}`);
+    }
+    error(ex, scopeOrMessage, ...params) {
+        if ((this.#level === OrderedLevel.Off || this.#level > OrderedLevel.Error) && !this.isDebugging)
+            return;
+        let message;
+        if (scopeOrMessage == null || typeof scopeOrMessage === 'string') {
+            message = scopeOrMessage;
+        }
+        else {
+            message = `${scopeOrMessage.prefix} ${params.shift() ?? ''}`;
+        }
+        if (message == null) {
+            const stack = ex instanceof Error ? ex.stack : undefined;
+            if (stack) {
+                const match = stackCallerRegex.exec(stack);
+                if (match != null) {
+                    message = match[1];
+                }
+            }
+        }
+        if (this.isDebugging) {
+            if (ex != null) {
+                console.error(`[${padOrTruncateEnd(this.#provider.name, 13)}]`, this.timestamp, message ?? '', ...params, ex);
+            }
+            else {
+                console.error(`[${padOrTruncateEnd(this.#provider.name, 13)}]`, this.timestamp, message ?? '', ...params);
+            }
+        }
+        const errorMessage = `  ${message ?? ''}${this.#toLoggableParams(false, params)}`;
+        if (ex != null) {
+            // eslint-disable-next-line @typescript-eslint/no-base-to-string
+            this.#output?.error(String(ex), errorMessage);
+        }
+        else {
+            this.#output?.error(errorMessage);
+        }
+    }
+    showOutputChannel(preserveFocus) {
+        this.#output?.show?.(preserveFocus);
+    }
+    toLoggable(o, name) {
+        if (name != null) {
+            const sanitized = this.sanitize(name, o);
+            if (sanitized != null)
+                return sanitized;
+        }
+        if (typeof o === 'function')
+            return '<function>';
+        if (o == null || typeof o !== 'object')
+            return String(o);
+        if (o instanceof Error)
+            return String(o);
+        if (Array.isArray(o)) {
+            const maxItems = 10;
+            const items = o.length > maxItems ? o.slice(0, maxItems) : o;
+            const suffix = o.length > maxItems ? `, …+${o.length - maxItems}` : '';
+            return `[${items.map(i => this.toLoggable(i)).join(', ')}${suffix}]`;
+        }
+        const toLoggable = this.#provider?.toLoggable;
+        const loggable = toLoggable?.(o);
+        if (loggable != null)
+            return loggable;
+        const sanitizeKeys = this.#provider?.sanitizeKeys;
+        try {
+            return JSON.stringify(o, (key, value) => {
+                if (key.charCodeAt(0) === 95)
+                    return undefined; // skip '_'-prefixed keys
+                if (sanitizeKeys?.has(key))
+                    return this.sanitize(key, value);
+                if (key !== '' && typeof value === 'object' && value != null && !Array.isArray(value)) {
+                    if (value instanceof Error)
+                        return String(value);
+                    return toLoggable?.(value) ?? value;
+                }
+                return value;
+            });
+        }
+        catch {
+            debugger;
+            return '<error>';
+        }
+    }
+    sanitize(key, value) {
+        // Nothing to redact if the value is null/undefined
+        if (value == null)
+            return undefined;
+        // Strip leading underscores so `_token` matches `token` in sanitizeKeys
+        const sanitizeKey = key.replace(leadingUnderscoreRegex, '') || key;
+        if (!this.#provider?.sanitizeKeys?.has(sanitizeKey))
+            return undefined;
+        if (this.#provider.hash != null) {
+            return `<${sanitizeKey}:${this.#provider.hash(typeof value === 'string' ? value : JSON.stringify(value))}>`;
+        }
+        return `<${sanitizeKey}>`;
+    }
+    #toLoggableParams(debugOnly, params) {
+        if (params.length === 0 ||
+            (debugOnly && (this.#level === OrderedLevel.Off || this.#level > OrderedLevel.Debug) && !this.isDebugging)) {
+            return '';
+        }
+        const loggableParams = params.map(p => this.toLoggable(p)).join(', ');
+        return loggableParams.length !== 0 ? ` \u2014 ${loggableParams}` : '';
+    }
+}
+const _logger = new Logger();
+export { _logger as Logger };
+function toOrderedLevel(logLevel) {
+    switch (logLevel) {
+        case 'off':
+            return OrderedLevel.Off;
+        case 'trace':
+            return OrderedLevel.Trace;
+        case 'debug':
+            return OrderedLevel.Debug;
+        case 'info':
+            return OrderedLevel.Info;
+        case 'warn':
+            return OrderedLevel.Warn;
+        case 'error':
+            return OrderedLevel.Error;
+        default:
+            return OrderedLevel.Off;
+    }
+}
+function toFriendlyLogLevel(level) {
+    switch (level) {
+        case OrderedLevel.Off:
+            return 'off';
+        case OrderedLevel.Trace:
+            return 'trace';
+        case OrderedLevel.Debug:
+            return 'debug';
+        case OrderedLevel.Info:
+            return 'info';
+        case OrderedLevel.Warn:
+            return 'warn';
+        case OrderedLevel.Error:
+            return 'error';
+        default:
+            return 'off';
+    }
+}
+export const customLoggableNameFns = new WeakMap();
+export function getLoggableName(instance) {
+    let ctor;
+    if (typeof instance === 'function') {
+        ctor = instance.prototype?.constructor;
+        if (ctor == null)
+            return instance.name;
+    }
+    else {
+        ctor = instance.constructor;
+    }
+    let name = ctor?.name ?? '';
+    // Strip webpack module name (since I never name classes with an _)
+    const index = name.indexOf('_');
+    if (index !== -1) {
+        name = name.substring(index + 1);
+    }
+    // Walk the prototype chain to find a custom name function (supports @logName on base classes)
+    let proto = ctor;
+    while (proto != null) {
+        const customNameFn = customLoggableNameFns.get(proto);
+        if (customNameFn != null) {
+            return customNameFn(instance, name);
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    return name;
+}
+export const defaultLogProvider = {
+    enabled: (logLevel) => _logger.enabled(logLevel),
+    log: (logLevel, scope, message, ...params) => {
+        switch (logLevel) {
+            case 'error':
+                _logger.error(undefined, scope, message, ...params);
+                break;
+            case 'warn':
+                scope?.warn(message, ...params);
+                break;
+            case 'info':
+                scope?.info(message, ...params);
+                break;
+            case 'debug':
+                scope?.debug(message, ...params);
+                break;
+            case 'trace':
+                scope?.trace(message, ...params);
+                break;
+            default:
+                scope?.debug(message, ...params);
+                break;
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/logger.scoped.d.ts

@@ -0,0 +1,56 @@
+import { runInScope } from '#env/logScope.js';
+import type { LogLevel } from './logger.js';
+/** Runs a function within a log scope context. */
+export { runInScope };
+export declare const logScopeIdGenerator: import("./counter.js").Counter;
+export interface ScopedLogger {
+    readonly scopeId?: number;
+    readonly prevScopeId?: number;
+    readonly prefix: string;
+    enabled(level: Exclude<LogLevel, 'off'>): boolean;
+    trace(message: string, ...params: any[]): void;
+    debug(message: string, ...params: any[]): void;
+    info(message: string, ...params: any[]): void;
+    warn(message: string, ...params: any[]): void;
+    error(ex: Error | unknown, message?: string, ...params: any[]): void;
+    /** Adds exit details for this scope. Details are automatically prefixed with ' \u2022 ' and accumulate. */
+    addExitInfo(...details: string[]): void;
+    /** Sets the failure reason for this scope. Overwrites any previous failure. */
+    setFailed(reason: string): void;
+    /** @internal Returns exit info for logging - used internally by the @log decorator */
+    getExitInfo(): {
+        details: string | undefined;
+        failed: string | undefined;
+    };
+}
+export declare function createLogScope(scopeId: number, prevScopeId: number | undefined, prefix: string): ScopedLogger;
+export declare function formatLoggableScopeBlock(prefix: string, suffix?: string): string;
+export declare function getLoggableScopeBlock(scopeId: number, prevScopeId?: number, label?: string): string;
+/** Gets the current log scope */
+export declare function getScopedLogger(): (ScopedLogger & Disposable) | undefined;
+/**
+ * @internal only exported for use in other logging-related modules, not for general use
+ */
+export declare function getNewLogScope(prefix: string, scope: ScopedLogger | boolean | undefined, label?: string): ScopedLogger;
+/**
+ * Creates a scoped logger for standalone functions and code blocks
+ * Returns `undefined` when all logging is disabled
+ *
+ * This is the non-decorator equivalent of `@log()` for standalone functions,
+ * callbacks, and code blocks. Supports the `using` keyword for automatic cleanup.
+ *
+ * @param prefix - The log prefix (typically `ClassName.methodName`)
+ * @param log - Controls automatic entry/exit logging with timing:
+ *   - omitted/falsy: scope tracking only (no auto-logging)
+ *   - `true`: auto entry + exit with timing at debug level
+ *   - `{ level?, message?, onlyExit? }`: fine-grained control
+ */
+export declare function maybeStartScopedLogger(prefix: string, log?: boolean | {
+    level?: Exclude<LogLevel, 'off' | 'error' | 'warn'>;
+    message?: string;
+    onlyExit?: true;
+}, options?: {
+    scopeLabel?: string;
+    scope?: ScopedLogger;
+}): (ScopedLogger & Disposable) | undefined;
+//# sourceMappingURL=logger.scoped.d.ts.map

package/dist/utils/logger.scoped.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.scoped.d.ts","sourceRoot":"","sources":["../../src/utils/logger.scoped.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,kDAAkD;AAClD,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,eAAO,MAAM,mBAAmB,gCAAqB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IAElD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC9C,KAAK,CAAC,EAAE,EAAE,KAAK,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErE,2GAA2G;IAC3G,WAAW,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxC,+EAA+E;IAC/E,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,sFAAsF;IACtF,WAAW,IAAI;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;CAC3E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAiC7G;AA+BD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUnG;AAED,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,SAAS,CAQzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,EACzC,KAAK,CAAC,EAAE,MAAM,GACZ,YAAY,CAQd;AAoBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,OAAO,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,EAC1G,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,GACrD,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,SAAS,CAuCzC"}