@skmtc/core 0.0.273 → 0.0.275

package/esm/deps/jsr.io/@std/log/0.224.6/levels.js

@@ -0,0 +1,43 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+/**
+ * Use this to retrieve the numeric log level by it's associated name.
+ * Defaults to INFO.
+ */
+export const LogLevels = {
+    NOTSET: 0,
+    DEBUG: 10,
+    INFO: 20,
+    WARN: 30,
+    ERROR: 40,
+    CRITICAL: 50,
+};
+/** Permitted log level names */
+export const LogLevelNames = Object.keys(LogLevels).filter((key) => isNaN(Number(key)));
+const byLevel = {
+    [LogLevels.NOTSET]: "NOTSET",
+    [LogLevels.DEBUG]: "DEBUG",
+    [LogLevels.INFO]: "INFO",
+    [LogLevels.WARN]: "WARN",
+    [LogLevels.ERROR]: "ERROR",
+    [LogLevels.CRITICAL]: "CRITICAL",
+};
+/**
+ * Returns the numeric log level associated with the passed,
+ * stringy log level name.
+ */
+export function getLevelByName(name) {
+    const level = LogLevels[name];
+    if (level !== undefined) {
+        return level;
+    }
+    throw new Error(`Cannot get log level: no level named ${name}`);
+}
+/** Returns the stringy log level name provided the numeric log level. */
+export function getLevelName(level) {
+    const levelName = byLevel[level];
+    if (levelName) {
+        return levelName;
+    }
+    throw new Error(`Cannot get log level: no name for level: ${level}`);
+}

package/esm/deps/jsr.io/@std/log/0.224.6/logger.d.ts

@@ -0,0 +1,62 @@
+import type { LevelName, LogLevel } from "./levels.js";
+import type { BaseHandler } from "./base_handler.js";
+export type GenericFunction = (...args: any[]) => any;
+export interface LogRecordOptions {
+    msg: string;
+    args: unknown[];
+    level: LogLevel;
+    loggerName: string;
+}
+export declare class LoggerConfig {
+    level?: LevelName;
+    handlers?: string[];
+}
+export interface LogConfig {
+    handlers?: {
+        [name: string]: BaseHandler;
+    };
+    loggers?: {
+        [name: string]: LoggerConfig;
+    };
+}
+/**
+ * An object that encapsulates provided message and arguments as well some
+ * metadata that can be later used when formatting a message.
+ */
+export declare class LogRecord {
+    #private;
+    readonly msg: string;
+    readonly level: number;
+    readonly levelName: string;
+    readonly loggerName: string;
+    constructor(options: LogRecordOptions);
+    get args(): unknown[];
+    get datetime(): Date;
+}
+export interface LoggerOptions {
+    handlers?: BaseHandler[];
+}
+export declare class Logger {
+    #private;
+    handlers: BaseHandler[];
+    constructor(loggerName: string, levelName: LevelName, options?: LoggerOptions);
+    /** Use this to retrieve the current numeric log level. */
+    get level(): LogLevel;
+    /** Use this to set the numeric log level. */
+    set level(level: LogLevel);
+    get levelName(): LevelName;
+    set levelName(levelName: LevelName);
+    get loggerName(): string;
+    asString(data: unknown, isProperty?: boolean): string;
+    debug<T>(msg: () => T, ...args: unknown[]): T | undefined;
+    debug<T>(msg: T extends GenericFunction ? never : T, ...args: unknown[]): T;
+    info<T>(msg: () => T, ...args: unknown[]): T | undefined;
+    info<T>(msg: T extends GenericFunction ? never : T, ...args: unknown[]): T;
+    warn<T>(msg: () => T, ...args: unknown[]): T | undefined;
+    warn<T>(msg: T extends GenericFunction ? never : T, ...args: unknown[]): T;
+    error<T>(msg: () => T, ...args: unknown[]): T | undefined;
+    error<T>(msg: T extends GenericFunction ? never : T, ...args: unknown[]): T;
+    critical<T>(msg: () => T, ...args: unknown[]): T | undefined;
+    critical<T>(msg: T extends GenericFunction ? never : T, ...args: unknown[]): T;
+}
+//# sourceMappingURL=logger.d.ts.map

package/esm/deps/jsr.io/@std/log/0.224.6/logger.d.ts.map

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

package/esm/deps/jsr.io/@std/log/0.224.6/logger.js

@@ -0,0 +1,179 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _LogRecord_args, _LogRecord_datetime, _Logger_instances, _Logger_level, _Logger_loggerName, _Logger_log;
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+import { getLevelByName, getLevelName, LogLevels } from "./levels.js";
+export class LoggerConfig {
+    constructor() {
+        Object.defineProperty(this, "level", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "handlers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+    }
+}
+/**
+ * An object that encapsulates provided message and arguments as well some
+ * metadata that can be later used when formatting a message.
+ */
+export class LogRecord {
+    constructor(options) {
+        Object.defineProperty(this, "msg", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        _LogRecord_args.set(this, void 0);
+        _LogRecord_datetime.set(this, void 0);
+        Object.defineProperty(this, "level", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "levelName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "loggerName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.msg = options.msg;
+        __classPrivateFieldSet(this, _LogRecord_args, [...options.args], "f");
+        this.level = options.level;
+        this.loggerName = options.loggerName;
+        __classPrivateFieldSet(this, _LogRecord_datetime, new Date(), "f");
+        this.levelName = getLevelName(options.level);
+    }
+    get args() {
+        return [...__classPrivateFieldGet(this, _LogRecord_args, "f")];
+    }
+    get datetime() {
+        return new Date(__classPrivateFieldGet(this, _LogRecord_datetime, "f").getTime());
+    }
+}
+_LogRecord_args = new WeakMap(), _LogRecord_datetime = new WeakMap();
+export class Logger {
+    constructor(loggerName, levelName, options = {}) {
+        _Logger_instances.add(this);
+        _Logger_level.set(this, void 0);
+        Object.defineProperty(this, "handlers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        _Logger_loggerName.set(this, void 0);
+        __classPrivateFieldSet(this, _Logger_loggerName, loggerName, "f");
+        __classPrivateFieldSet(this, _Logger_level, getLevelByName(levelName), "f");
+        this.handlers = options.handlers || [];
+    }
+    /** Use this to retrieve the current numeric log level. */
+    get level() {
+        return __classPrivateFieldGet(this, _Logger_level, "f");
+    }
+    /** Use this to set the numeric log level. */
+    set level(level) {
+        try {
+            __classPrivateFieldSet(this, _Logger_level, getLevelByName(getLevelName(level)), "f");
+        }
+        catch (_) {
+            throw new TypeError(`Invalid log level: ${level}`);
+        }
+    }
+    get levelName() {
+        return getLevelName(__classPrivateFieldGet(this, _Logger_level, "f"));
+    }
+    set levelName(levelName) {
+        __classPrivateFieldSet(this, _Logger_level, getLevelByName(levelName), "f");
+    }
+    get loggerName() {
+        return __classPrivateFieldGet(this, _Logger_loggerName, "f");
+    }
+    asString(data, isProperty = false) {
+        if (typeof data === "string") {
+            if (isProperty)
+                return `"${data}"`;
+            return data;
+        }
+        else if (data === null ||
+            typeof data === "number" ||
+            typeof data === "bigint" ||
+            typeof data === "boolean" ||
+            typeof data === "undefined" ||
+            typeof data === "symbol") {
+            return String(data);
+        }
+        else if (data instanceof Error) {
+            return data.stack;
+        }
+        else if (typeof data === "object") {
+            return `{${Object.entries(data)
+                .map(([k, v]) => `"${k}":${this.asString(v, true)}`)
+                .join(",")}}`;
+        }
+        return "undefined";
+    }
+    debug(msg, ...args) {
+        return __classPrivateFieldGet(this, _Logger_instances, "m", _Logger_log).call(this, LogLevels.DEBUG, msg, ...args);
+    }
+    info(msg, ...args) {
+        return __classPrivateFieldGet(this, _Logger_instances, "m", _Logger_log).call(this, LogLevels.INFO, msg, ...args);
+    }
+    warn(msg, ...args) {
+        return __classPrivateFieldGet(this, _Logger_instances, "m", _Logger_log).call(this, LogLevels.WARN, msg, ...args);
+    }
+    error(msg, ...args) {
+        return __classPrivateFieldGet(this, _Logger_instances, "m", _Logger_log).call(this, LogLevels.ERROR, msg, ...args);
+    }
+    critical(msg, ...args) {
+        return __classPrivateFieldGet(this, _Logger_instances, "m", _Logger_log).call(this, LogLevels.CRITICAL, msg, ...args);
+    }
+}
+_Logger_level = new WeakMap(), _Logger_loggerName = new WeakMap(), _Logger_instances = new WeakSet(), _Logger_log = function _Logger_log(level, msg, ...args) {
+    if (this.level > level) {
+        return msg instanceof Function ? undefined : msg;
+    }
+    let fnResult;
+    let logMessage;
+    if (msg instanceof Function) {
+        fnResult = msg();
+        logMessage = this.asString(fnResult);
+    }
+    else {
+        logMessage = this.asString(msg);
+    }
+    const record = new LogRecord({
+        msg: logMessage,
+        args: args,
+        level: level,
+        loggerName: this.loggerName,
+    });
+    this.handlers.forEach((handler) => {
+        handler.handle(record);
+    });
+    return msg instanceof Function ? fnResult : msg;
+};

package/esm/deps/jsr.io/@std/log/0.224.6/mod.d.ts

@@ -0,0 +1,390 @@
+/**
+ * Logging library with the support for terminal and file outputs. Also provides
+ * interfaces for building custom loggers.
+ *
+ * ## Loggers
+ *
+ * Loggers are objects that you interact with. When you use a logger method it
+ * constructs a `LogRecord` and passes it down to its handlers for output. To
+ * create custom loggers, specify them in `loggers` when calling `log.setup`.
+ *
+ * ## Custom message format
+ *
+ * If you want to override default format of message you can define `formatter`
+ * option for handler. It can a function that takes `LogRecord`
+ * as argument and outputs string.
+ *
+ * The default log format is `{levelName} {msg}`.
+ *
+ * ### Logging Structured JSON Lines
+ *
+ * To output logs in a structured JSON format you can configure most handlers
+ * with a formatter that produces a JSON string. Either use the premade
+ * `log.formatters.jsonFormatter` or write your own function that takes a
+ * {@linkcode LogRecord} and returns a JSON.stringify'd object.
+ * If you want the log to go to stdout then use {@linkcode ConsoleHandler} with
+ * the configuration `useColors: false` to turn off the ANSI terminal colours.
+ *
+ * ```ts
+ * import * as log from "@std/log";
+ *
+ * log.setup({
+ *   handlers: {
+ *     default: new log.ConsoleHandler("DEBUG", {
+ *       formatter: log.formatters.jsonFormatter,
+ *       useColors: false,
+ *     }),
+ *   },
+ * });
+ * ```
+ *
+ * The first argument passed to a log function is always treated as the
+ * message and will be stringified differently. To have arguments JSON.stringify'd
+ * you must pass them after the first.
+ *
+ * ```ts
+ * import * as log from "@std/log";
+ *
+ * log.info("This is the message", { thisWillBe: "JSON.stringify'd"});
+ * // {"level":"INFO","datetime":1702501580505,"message":"This is the message","args":{"thisWillBe":"JSON.stringify'd"}}
+ *
+ * log.info({ thisWontBe: "JSON.stringify'd"}, "This is an argument");
+ * // {"level":"INFO","datetime":1702501580505,"message":"{\"thisWontBe\":\"JSON.stringify'd\"}","args":"This is an argument"}
+ * ```
+ *
+ * ## Inline Logging
+ *
+ * Log functions return the data passed in the `msg` parameter. Data is returned
+ * regardless if the logger actually logs it.
+ *
+ * ## Lazy Log Evaluation
+ *
+ * Some log statements are expensive to compute. In these cases, you can use
+ * lazy log evaluation to prevent the computation taking place if the logger
+ * won't log the message.
+ *
+ * > NOTE: When using lazy log evaluation, `undefined` will be returned if the
+ * > resolver function is not called because the logger won't log it. It is an
+ * > antipattern use lazy evaluation with inline logging because the return value
+ * > depends on the current log level.
+ *
+ * ## For module authors
+ *
+ * The authors of public modules can let the users display the internal logs of the
+ * module by using a custom logger:
+ *
+ * ```ts
+ * import { getLogger } from "@std/log";
+ *
+ * function logger() {
+ *   return getLogger("my-awesome-module");
+ * }
+ *
+ * export function sum(a: number, b: number) {
+ *   logger().debug(`running ${a} + ${b}`);
+ *   return a + b;
+ * }
+ *
+ * export function mult(a: number, b: number) {
+ *   logger().debug(`running ${a} * ${b}`);
+ *   return a * b;
+ * }
+ * ```
+ *
+ * The user of the module can then display the internal logs with:
+ *
+ * ```ts, ignore
+ * import * as log from "@std/log";
+ * import { sum } from "<the-awesome-module>/mod.ts";
+ *
+ * log.setup({
+ *   handlers: {
+ *     console: new log.ConsoleHandler("DEBUG"),
+ *   },
+ *
+ *   loggers: {
+ *     "my-awesome-module": {
+ *       level: "DEBUG",
+ *       handlers: ["console"],
+ *     },
+ *   },
+ * });
+ *
+ * sum(1, 2); // prints "running 1 + 2" to the console
+ * ```
+ *
+ * Please note that, due to the order of initialization of the loggers, the
+ * following won't work:
+ *
+ * ```ts
+ * import { getLogger } from "@std/log";
+ *
+ * const logger = getLogger("my-awesome-module");
+ *
+ * export function sum(a: number, b: number) {
+ *   logger.debug(`running ${a} + ${b}`); // no message will be logged, because getLogger() was called before log.setup()
+ *   return a + b;
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as log from "@std/log";
+ *
+ * // Simple default logger out of the box. You can customize it
+ * // by overriding logger and handler named "default", or providing
+ * // additional logger configurations. You can log any data type.
+ * log.debug("Hello world");
+ * log.info(123456);
+ * log.warn(true);
+ * log.error({ foo: "bar", fizz: "bazz" });
+ * log.critical("500 Internal server error");
+ *
+ * // custom configuration with 2 loggers (the default and `tasks` loggers).
+ * log.setup({
+ *   handlers: {
+ *     console: new log.ConsoleHandler("DEBUG"),
+ *
+ *     file: new log.FileHandler("WARN", {
+ *       filename: "./log.txt",
+ *       // you can change format of output message using any keys in `LogRecord`.
+ *       formatter: (record) => `${record.levelName} ${record.msg}`,
+ *     }),
+ *   },
+ *
+ *   loggers: {
+ *     // configure default logger available via short-hand methods above.
+ *     default: {
+ *       level: "DEBUG",
+ *       handlers: ["console", "file"],
+ *     },
+ *
+ *     tasks: {
+ *       level: "ERROR",
+ *       handlers: ["console"],
+ *     },
+ *   },
+ * });
+ *
+ * let logger;
+ *
+ * // get default logger.
+ * logger = log.getLogger();
+ * logger.debug("fizz"); // logs to `console`, because `file` handler requires "WARN" level.
+ * logger.warn(41256); // logs to both `console` and `file` handlers.
+ *
+ * // get custom logger
+ * logger = log.getLogger("tasks");
+ * logger.debug("fizz"); // won't get output because this logger has "ERROR" level.
+ * logger.error({ productType: "book", value: "126.11" }); // log to `console`.
+ *
+ * // if you try to use a logger that hasn't been configured
+ * // you're good to go, it gets created automatically with level set to 0
+ * // so no message is logged.
+ * const unknownLogger = log.getLogger("mystery");
+ * unknownLogger.info("foobar"); // no-op
+ * ```
+ *
+ * @example
+ * Custom message format example
+ * ```ts
+ * import * as log from "@std/log";
+ *
+ * log.setup({
+ *   handlers: {
+ *     stringFmt: new log.ConsoleHandler("DEBUG", {
+ *       formatter: (record) => `[${record.levelName}] ${record.msg}`,
+ *     }),
+ *
+ *     functionFmt: new log.ConsoleHandler("DEBUG", {
+ *       formatter: (logRecord) => {
+ *         let msg = `${logRecord.level} ${logRecord.msg}`;
+ *
+ *         logRecord.args.forEach((arg, index) => {
+ *           msg += `, arg${index}: ${arg}`;
+ *         });
+ *
+ *         return msg;
+ *       },
+ *     }),
+ *
+ *     anotherFmt: new log.ConsoleHandler("DEBUG", {
+ *       formatter: (record) => `[${record.loggerName}] - ${record.levelName} ${record.msg}`,
+ *     }),
+ *   },
+ *
+ *   loggers: {
+ *     default: {
+ *       level: "DEBUG",
+ *       handlers: ["stringFmt", "functionFmt"],
+ *     },
+ *     dataLogger: {
+ *       level: "INFO",
+ *       handlers: ["anotherFmt"],
+ *     },
+ *   },
+ * });
+ *
+ * // calling:
+ * log.debug("Hello, world!", 1, "two", [3, 4, 5]);
+ * // results in: [DEBUG] Hello, world!
+ * // output from "stringFmt" handler.
+ * // 10 Hello, world!, arg0: 1, arg1: two, arg3: [3, 4, 5] // output from "functionFmt" formatter.
+ *
+ * // calling:
+ * log.getLogger("dataLogger").error("oh no!");
+ * // results in:
+ * // [dataLogger] - ERROR oh no! // output from anotherFmt handler.
+ * ```
+
+ *
+ * @example
+ * JSON to stdout with no color example
+ * ```ts
+ * import * as log from "@std/log";
+ *
+ * log.setup({
+ *   handlers: {
+ *     jsonStdout: new log.ConsoleHandler("DEBUG", {
+ *       formatter: log.formatters.jsonFormatter,
+ *       useColors: false,
+ *     }),
+ *   },
+ *
+ *   loggers: {
+ *     default: {
+ *       level: "DEBUG",
+ *       handlers: ["jsonStdout"],
+ *     },
+ *   },
+ * });
+ *
+ * // calling:
+ * log.info("Hey");
+ * // results in:
+ * // {"level":"INFO","datetime":1702481922294,"message":"Hey"}
+ *
+ * // calling:
+ * log.info("Hey", { product: "nail" });
+ * // results in:
+ * // {"level":"INFO","datetime":1702484111115,"message":"Hey","args":{"product":"nail"}}
+ *
+ * // calling:
+ * log.info("Hey", 1, "two", [3, 4, 5]);
+ * // results in:
+ * // {"level":"INFO","datetime":1702481922294,"message":"Hey","args":[1,"two",[3,4,5]]}
+ * ```
+ *
+ * @example
+ * Custom JSON example
+ * ```ts
+ * import * as log from "@std/log";
+ *
+ * log.setup({
+ *   handlers: {
+ *     customJsonFmt: new log.ConsoleHandler("DEBUG", {
+ *       formatter: (record) => JSON.stringify({
+ *         lvl: record.level,
+ *         msg: record.msg,
+ *         time: record.datetime.toISOString(),
+ *         name: record.loggerName,
+ *       }),
+ *       useColors: false,
+ *     }),
+ *   },
+ *
+ *   loggers: {
+ *     default: {
+ *       level: "DEBUG",
+ *       handlers: ["customJsonFmt"],
+ *     },
+ *   },
+ * });
+ *
+ * // calling:
+ * log.info("complete");
+ * // results in:
+ * // {"lvl":20,"msg":"complete","time":"2023-12-13T16:38:27.328Z","name":"default"}
+ * ```
+ *
+ * @example
+ * Inline Logging
+ * ```ts
+ * import * as logger from "@std/log";
+ *
+ * const stringData: string = logger.debug("hello world");
+ * const booleanData: boolean = logger.debug(true, 1, "abc");
+ * const fn = (): number => {
+ *   return 123;
+ * };
+ * const resolvedFunctionData: number = logger.debug(fn());
+ * console.log(stringData); // 'hello world'
+ * console.log(booleanData); // true
+ * console.log(resolvedFunctionData); // 123
+ * ```
+ *
+ * @example
+ * Lazy Log Evaluation
+ * ```ts
+ * import * as log from "@std/log";
+ *
+ * log.setup({
+ *   handlers: {
+ *     console: new log.ConsoleHandler("DEBUG"),
+ *   },
+ *
+ *   loggers: {
+ *     tasks: {
+ *       level: "ERROR",
+ *       handlers: ["console"],
+ *     },
+ *   },
+ * });
+ *
+ * function someExpensiveFn(num: number, bool: boolean) {
+ *   // do some expensive computation
+ * }
+ *
+ * // not logged, as debug < error.
+ * const data = log.debug(() => someExpensiveFn(5, true));
+ * console.log(data); // undefined
+ * ```
+ *
+ * Handlers are responsible for actual output of log messages. When a handler is
+ * called by a logger, it firstly checks that {@linkcode LogRecord}'s level is
+ * not lower than level of the handler. If level check passes, handlers formats
+ * log record into string and outputs it to target.
+ *
+ * ## Custom handlers
+ *
+ * Custom handlers can be implemented by subclassing {@linkcode BaseHandler} or
+ * {@linkcode WriterHandler}.
+ *
+ * {@linkcode BaseHandler} is bare-bones handler that has no output logic at all,
+ *
+ * {@linkcode WriterHandler} is an abstract class that supports any target with
+ * `Writer` interface.
+ *
+ * During setup async hooks `setup` and `destroy` are called, you can use them
+ * to open and close file/HTTP connection or any other action you might need.
+ *
+ * For examples check source code of {@linkcode FileHandler}`
+ * and {@linkcode TestHandler}.
+ *
+ * @module
+ */
+export * from "./base_handler.js";
+export * from "./console_handler.js";
+export * from "./file_handler.js";
+export * from "./rotating_file_handler.js";
+export * from "./levels.js";
+export * from "./logger.js";
+export * from "./formatters.js";
+export * from "./critical.js";
+export * from "./debug.js";
+export * from "./error.js";
+export * from "./get_logger.js";
+export * from "./info.js";
+export * from "./setup.js";
+export * from "./warn.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/deps/jsr.io/@std/log/0.224.6/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/log/0.224.6/mod.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsXG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}