@dazhicheng/utils 1.3.4 → 1.3.6

package/dist/install.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vue';
+export type SFCWithInstall<T> = T & Plugin;
+export declare function withInstall<T, E extends Record<string, any>>(main: T, extra?: E): SFCWithInstall<T> & E;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,KAAK,CAAA;AAEtC,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;AAE1C,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,GAc/D,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CACrC"}

package/dist/is.d.ts

@@ -0,0 +1,238 @@
+import dayjs from "dayjs";
+/**
+ * 判断值的类型
+ *
+ * @param val 未知类型的值
+ * @param type 需要判断的目标类型
+ * @returns 如果val的类型与目标类型相符，则返回true；否则返回false
+ *
+ * 说明：
+ * - 该函数通过Object.prototype.toString.call(val)方法获取val的内部[[Class]]属性值，然后与目标类型进行比较
+ * - 这种方法可以准确地判断值的类型，包括数组、函数、日期等特殊对象
+ */
+export declare function is(val: unknown, type: string): boolean;
+/**
+ * 判断一个值是否已定义
+ *
+ * 此函数用于检查传入的值是否为 undefined，以确定该值是否已定义
+ * 在 TypeScript 中，通过这种方式可以对类型进行精确的判断，而不仅仅是依赖于值
+ *
+ * @param val 可能为任意类型的值，可能为 undefined
+ * @returns 如果值不为 undefined，则返回 true；否则返回 false
+ */
+export declare function isDef<T = unknown>(val?: T): val is T;
+/**
+ * 判断值是否未定义
+ *
+ * 此函数用于检查传入的值是否为 undefined 或者 null
+ * 它提供了一种类型安全的方式来忽略未知的类型，并确保我们在处理可能不存在的值时能够安全地进行
+ *
+ * @param val 可能为 undefined 或具体类型的值
+ * @returns 如果值为 undefined 则返回 true；否则返回 false
+ */
+export declare function isUndefined(val?: any): val is undefined;
+/**
+ * 判断给定的值是否为 null
+ *
+ * @param val 任何类型的值，用于检查是否为 null
+ * @returns 返回 true 如果 val 是 null，否则返回 false
+ */
+export declare function isNull(val: unknown): val is null;
+/**
+ * 检查值是否为 null 或 undefined
+ *
+ * @param val 未知类型值，从 unknown 类型进行参数输入，可以接受任何类型的值
+ * @returns 返回一个布尔值，如果 val 是 undefined 或 null，则返回 true，否则返回 false
+ */
+export declare function isNullOrUnDef(val: unknown): val is null | undefined;
+/**
+ * 检查给定的值是否为对象
+ *
+ * @param val 任意值，待检查其类型
+ * @returns 如果值是对象，则返回true；否则返回false
+ *
+ * 此函数的存在是为了提供一个精确的类型检查机制，以确定传入的参数是否符合Record类型，
+ * 这在处理复杂的数据结构时尤其有用，例如JSON数据解析或复杂的对象操作。通过这种方式，
+ * 开发者可以确保数据的结构符合预期，从而避免潜在的运行时错误。
+ * @example 如需从联合类型中获取对象类型，可以使用以下方式
+ *  isObject<TipConfig>
+ */
+export declare function isObject<T>(val: unknown | Record<string, T>): val is Record<string, T>;
+/**
+ * 检查给定的值是否为空
+ * 此函数旨在统一处理多种数据类型，包括字符串、数组、Map、Set和对象
+ * undefined 和 null 值也被视为"空"
+ * 以判断它们是否为空。对于每种数据类型，采用不同的方法来检查空值
+ *
+ * @param val 任意类型的值，其空状态将被检查
+ * @returns 如果值被认为是空的，则返回 true，否则返回 false
+ */
+export declare function isEmpty<T>(val: T): boolean;
+/**
+ * 检查给定的值是否为空（包括0值）
+ * 将以下值判定为空：0、'0'、'undefined'、'null'
+ *
+ * @param val 任意类型的值
+ * @returns 如果值为 0、'0'、'undefined'、'null'，则返回 true，否则返回 false
+ */
+export declare function isEmptyZero(val: unknown): boolean;
+/**
+ * 判断给定的值是否为Date类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是Date类型，返回true；否则返回false
+ */
+export declare function isDate(val: unknown): val is Date;
+/**
+ * 判断给定的值是否为Number类型 排除NaN
+ * 一个数字与自身相比较，除了 NaN 之外都应该相等
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是Number类型，返回true；否则返回false
+ */
+export declare function isNumber(val: unknown): val is number;
+/**
+ * 判断给定的值是否为Promise类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是Promise类型，返回true；否则返回false
+ */
+export declare function isPromise<T = any>(val: unknown): val is Promise<T>;
+/**
+ * 判断给定的值是否为String类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是String类型，返回true；否则返回false
+ */
+export declare function isString(val: unknown): val is string;
+/**
+ * 判断给定的值是否为Function类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是Function类型，返回true；否则返回false
+ */
+export declare function isFunction(val: unknown): val is (...args: any[]) => any;
+/**
+ * 判断给定的值是否为Boolean类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是Boolean类型，返回true；否则返回false
+ */
+export declare function isBoolean(val: unknown): val is boolean;
+/**
+ * 判断给定的值是否为RegExp类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是RegExp类型，返回true；否则返回false
+ */
+export declare function isRegExp(val: unknown): val is RegExp;
+/**
+ * 判断给定的值是否为Array类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是Array类型，返回true；否则返回false
+ */
+export declare function isArray(val: any): val is Array<any>;
+/**
+ * 判断给定的值是否为Window类型
+ *
+ * @param val 未知类型值，由用户传入
+ * @returns 如果val是Window类型，返回true；否则返回false
+ */
+export declare function isWindow(val: any): val is Window;
+/**
+ * 判断给定的值是否是一个 DOM 元素。
+ *
+ * @param e 任意类型的值，其类型由调用者决定。
+ * @returns 如果 `e` 是一个 DOM 元素实例，则返回 `true`，否则返回 `false`。
+ */
+export declare function isElement(e: unknown): e is Element;
+/**
+ * 检查给定的值是否为Map类型
+ *
+ * @param val 未知类型的值
+ * @returns 如果给定的值是Map类型，则返回true；否则返回false
+ */
+export declare function isMap(val: unknown): val is Map<any, any>;
+export declare const isServer: boolean;
+export declare const isClient: boolean;
+/**
+ * 检查给定的值是否为正确的Url地址
+ *
+ * @param path 字符串类型的值
+ * @returns 如果给定的值是Url地址，则返回true；否则返回false
+ */
+export declare function isUrl(path: string): boolean;
+/**
+ * 判断一个字符串是否可以转换为数字
+ *
+ * @param val 待检查的字符串
+ * @returns 如果字符串可以转换为数字，则返回true；否则返回false
+ */
+export declare function isStringNumber(val: string): boolean;
+/**
+ * 检查给定的值是否为原始类型
+ *
+ * 原始类型包括：数字、字符串、布尔值、符号、大整数、未定义、空值
+ *
+ * @param {*} value 要检查的值
+ * @returns {boolean} 检查结果
+ */
+export declare function isPrimitive(value: any): boolean;
+/**
+ * 是否为错误对象
+ * @param val 入参
+ */
+export declare function isError(val: any): boolean;
+/**
+ * 是否为Symbol函数
+ * @param val 入参
+ */
+export declare function isSymbol(val: any): boolean;
+/**
+ * 是否为Set对象
+ * @param val 入参
+ */
+export declare function isSet(val: any): boolean;
+/**
+ * 是否为非真
+ * @param val 入参
+ */
+export declare function isFalse(val: any): boolean;
+/**
+ * 是否为真
+ * @param val 入参
+ */
+export declare function isTrue(val: any): boolean;
+/**
+ * 获取设备类型
+ */
+export declare function getDeviceType(): string;
+/**
+ * 获取浏览器类型
+ */
+export declare function getBrowserType(): string;
+/**
+ * 是否为ios
+ * @returns {boolean} 是-否
+ */
+export declare function isIos(): boolean;
+/**
+ * 是否为Android
+ */
+export declare function isAndroid(): boolean;
+/**
+ * 是否为PC端
+ */
+export declare function isPC(): boolean;
+/**
+ * @description 判读是否为外链
+ * @param path
+ */
+export declare function isExternal(path: string): boolean;
+/**
+ * @description 判断是否为json
+ * @param value
+ */
+export declare function isJson(value: string | null): boolean;
+export declare function isDayjsObject(value: any): value is dayjs.Dayjs;
+//# sourceMappingURL=is.d.ts.map

package/dist/is.d.ts.map

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

package/dist/merge.d.ts

@@ -0,0 +1,17 @@
+import type { Defu } from 'defu';
+export { 
+/** 定制合并 createMerge=createDefu https://www.npmjs.com/package/defu */
+createDefu as createMerge, 
+/** 对象合并 merge=defu https://www.npmjs.com/package/defu */
+defu as merge, 
+/** 过滤 mergFn=defuFn https://www.npmjs.com/package/defu */
+defuFn as mergFn, } from 'defu';
+/**
+ * 对象合并函数，支持指定字段直接覆盖和数组类型直接替换
+ * @param source 源对象，将被合并的目标对象
+ * @param defaultsAndOptions 其他默认对象，最后一项可为 Source 的 key 数组，指定需要覆盖的 key
+ * @returns 合并后的对象
+ */
+export declare function mergeWithArrayOverride<Source extends Record<string, any>, Defaults extends Array<Record<string, any>>>(source: Source, ...defaultsAndOptions: [...Defaults]): Defu<Source, Defaults>;
+export declare function mergeWithArrayOverride<Source extends Record<string, any>, Defaults extends Array<Record<string, any>>>(source: Source, ...defaultsAndOptions: [...Defaults, Array<keyof Source>]): Defu<Source, Defaults>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAGhC,OAAO;AACL,qEAAqE;AACrE,UAAU,IAAI,WAAW;AACzB,yDAAyD;AACzD,IAAI,IAAI,KAAK;AACb,0DAA0D;AAC1D,MAAM,IAAI,MAAM,GACjB,MAAM,MAAM,CAAA;AAEb;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,QAAQ,SAAS,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAC/E,wBAAgB,sBAAsB,CACpC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,QAAQ,SAAS,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA"}

package/dist/stateHandler.d.ts

@@ -0,0 +1,22 @@
+export declare class StateHandler {
+    private condition;
+    private promiseResolvers;
+    isConditionTrue(): boolean;
+    reset(): void;
+    setConditionFalse(): void;
+    setConditionTrue(): void;
+    waitForCondition(): Promise<void>;
+    private clearPromises;
+}
+export declare class StateHandlerOld {
+    private condition;
+    private rejectCondition;
+    private resolveCondition;
+    isConditionTrue(): boolean;
+    reset(): void;
+    setConditionFalse(): void;
+    setConditionTrue(): void;
+    waitForCondition(): Promise<void>;
+    private clearPromises;
+}
+//# sourceMappingURL=stateHandler.d.ts.map

package/dist/stateHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateHandler.d.ts","sourceRoot":"","sources":["../src/stateHandler.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,gBAAgB,CAGT;IAEf,eAAe,IAAI,OAAO;IAI1B,KAAK,IAAI,IAAI;IAKb,iBAAiB,IAAI,IAAI;IAQzB,gBAAgB,IAAI,IAAI;IAQxB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC,OAAO,CAAC,aAAa;CAGtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,gBAAgB,CAA4B;IAEpD,eAAe,IAAI,OAAO;IAI1B,KAAK,IAAI,IAAI;IAMb,iBAAiB,IAAI,IAAI;IASzB,gBAAgB,IAAI,IAAI;IASxB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,OAAO,CAAC,aAAa;CAItB"}

package/dist/string.d.ts

@@ -0,0 +1,4 @@
+export declare function capitalize(str: string): string;
+export declare function trim(str: string): string;
+export declare function kebabToCamelCase(str: string): string;
+//# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/stroge.d.ts

@@ -0,0 +1,84 @@
+export type Options = Partial<CreateStorageParams>;
+export declare const enableStorageEncryption = true;
+export declare const DEFAULT_CACHE_TIME: number;
+export type CreateStorageParams = {
+    prefixKey: string;
+    storage: Storage;
+    hasEncrypt: boolean;
+    timeout?: number | null;
+} & EncryptionParams;
+export type EncryptionParams = {
+    key: string;
+    iv: string;
+};
+type CipherOption = {
+    iv?: CryptoJS.lib.WordArray | undefined;
+    [key: string]: any;
+};
+export declare const cacheCipher: {
+    key: string;
+    iv: string;
+};
+declare class AesEncryption {
+    private key;
+    private iv;
+    constructor(opt?: Partial<EncryptionParams>);
+    get getOptions(): CipherOption;
+    encryptByAES(cipherText: string): string;
+    decryptByAES(cipherText: string): string;
+}
+export declare function create({ prefixKey, storage, key, iv, timeout, hasEncrypt, }?: Partial<CreateStorageParams>): {
+    storage: Storage;
+    prefixKey?: string;
+    encryption: AesEncryption;
+    hasEncrypt: boolean;
+    getKey: (key: string) => string;
+    set: (key: string, value: any, expire?: number | null) => void;
+    get: (key: string, def?: any) => any;
+    remove: (key: string) => void;
+    clear: () => void;
+};
+export declare function createStorage(storage?: Storage, options?: Options): {
+    storage: Storage;
+    prefixKey?: string;
+    encryption: AesEncryption;
+    hasEncrypt: boolean;
+    getKey: (key: string) => string;
+    set: (key: string, value: any, expire?: number | null) => void;
+    get: (key: string, def?: any) => any;
+    remove: (key: string) => void;
+    clear: (options?: {
+        keys?: string[];
+        exclude?: string[];
+    }) => void;
+};
+export declare function createSessionStorage(options?: Options): {
+    storage: Storage;
+    prefixKey?: string;
+    encryption: AesEncryption;
+    hasEncrypt: boolean;
+    getKey: (key: string) => string;
+    set: (key: string, value: any, expire?: number | null) => void;
+    get: (key: string, def?: any) => any;
+    remove: (key: string) => void;
+    clear: (options?: {
+        keys?: string[];
+        exclude?: string[];
+    }) => void;
+};
+export declare function createLocalStorage(options?: Options): {
+    storage: Storage;
+    prefixKey?: string;
+    encryption: AesEncryption;
+    hasEncrypt: boolean;
+    getKey: (key: string) => string;
+    set: (key: string, value: any, expire?: number | null) => void;
+    get: (key: string, def?: any) => any;
+    remove: (key: string) => void;
+    clear: (options?: {
+        keys?: string[];
+        exclude?: string[];
+    }) => void;
+};
+export {};
+//# sourceMappingURL=stroge.d.ts.map

package/dist/stroge.d.ts.map

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

package/dist/testid-helper.d.ts

@@ -0,0 +1,151 @@
+/**
+ * TestID 生成工具函数
+ * 用于为组件自动生成唯一、层级化的 testid
+ *
+ * @module testid-helper
+ * @see e2e-testing-solution/TESTID-SPECIFICATION.md
+ */
+/**
+ * 从组件传入的 API 配置提取资源名称
+ *
+ * - 当 `api` 是字符串时，直接返回字符串（推荐传入类似 `client.queryUserList` 的唯一名称）
+ * - 当 `api` 是函数引用时，返回函数名
+ * - 其它情况返回空字符串，由调用方自行兜底
+ *
+ * @param api - API 字符串或函数
+ * @returns 资源名称（原样或函数名）
+ *
+ * @example
+ * ```ts
+ * extractResourceFromApi('adminClientImpl.FindTriggerProjects')
+ * // → 'adminClientImpl.FindTriggerProjects'
+ *
+ * extractResourceFromApi(CountryGetPageGET)
+ * // → 'CountryGetPageGET'
+ * ```
+ */
+export declare function extractResourceFromApi(api: string | Function): string;
+/**
+ * 生成 testid
+ *
+ * 将多个部分拼接成完整的 testid，自动过滤 null、undefined 和空字符串
+ *
+ * @param parts - testid 的各个部分
+ * @returns 拼接后的 testid
+ *
+ * @example
+ * ```ts
+ * generateTestId('user', 'form', 'field', 'username')
+ * // → 'user-form-field-username'
+ *
+ * generateTestId('user', null, 'table', undefined, 'row', '123')
+ * // → 'user-table-row-123'
+ *
+ * generateTestId('modal', 'user-edit')
+ * // → 'modal-user-edit'
+ * ```
+ */
+export declare function generateTestId(...parts: (string | undefined | null)[]): string;
+/**
+ * 转换为 kebab-case
+ *
+ * 支持以下转换：
+ * - 空格分隔: "Add User" → "add-user"
+ * - PascalCase: "AddUser" → "add-user"
+ * - camelCase: "addUser" → "add-user"
+ * - 下划线: "add_user" → "add-user"
+ * - 中文: "用户管理" → "yong-hu-guan-li"（需要拼音库，可选功能）
+ *
+ * @param str - 要转换的字符串
+ * @returns kebab-case 字符串
+ *
+ * @example
+ * ```ts
+ * toKebabCase('Add User')
+ * // → 'add-user'
+ *
+ * toKebabCase('AddUser')
+ * // → 'add-user'
+ *
+ * toKebabCase('addUser')
+ * // → 'add-user'
+ *
+ * toKebabCase('add_user')
+ * // → 'add-user'
+ *
+ * toKebabCase('Add-User')
+ * // → 'add-user'
+ * ```
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * 从 fieldNames 生成表单名称
+ *
+ * 取 schema 中前 N 个 fieldName 拼接，用于自动生成表单名称
+ *
+ * @param fieldNames - 字段名称数组
+ * @param maxLength - 最多取几个字段名（默认 3）
+ * @returns 拼接后的表单名称
+ *
+ * @example
+ * ```ts
+ * generateFormName(['username', 'email', 'phone', 'address'])
+ * // → 'username-email-phone'
+ *
+ * generateFormName(['username', 'email'], 3)
+ * // → 'username-email'
+ *
+ * generateFormName(['username'], 3)
+ * // → 'username'
+ *
+ * generateFormName([])
+ * // → 'form'
+ * ```
+ */
+export declare function generateFormName(fieldNames: string[], maxLength?: number): string;
+/**
+ * 从标题提取 ID
+ *
+ * 用于从 Modal/Drawer 的 title 生成 ID
+ *
+ * @param title - 标题字符串
+ * @returns kebab-case ID
+ *
+ * @example
+ * ```ts
+ * extractIdFromTitle('Add User')
+ * // → 'add-user'
+ *
+ * extractIdFromTitle('编辑用户信息')
+ * // → 'bian-ji-yong-hu-xin-xi'
+ * ```
+ */
+export declare function extractIdFromTitle(title: string): string;
+/**
+ * 验证 testid 是否有效
+ *
+ * 检查 testid 是否符合命名规范：
+ * - 非空
+ * - 只包含小写字母、数字、连字符
+ * - 不以连字符开头或结尾
+ *
+ * @param testid - 要验证的 testid
+ * @returns 是否有效
+ *
+ * @example
+ * ```ts
+ * isValidTestId('user-form-field-username')
+ * // → true
+ *
+ * isValidTestId('User-Form')
+ * // → false (包含大写字母)
+ *
+ * isValidTestId('-user-form')
+ * // → false (以连字符开头)
+ *
+ * isValidTestId('')
+ * // → false (空字符串)
+ * ```
+ */
+export declare function isValidTestId(testid: string): boolean;
+//# sourceMappingURL=testid-helper.d.ts.map

package/dist/testid-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testid-helper.d.ts","sourceRoot":"","sources":["../src/testid-helper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAWrE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,CAM9E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqB/C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,SAAI,GAAG,MAAM,CAgB5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOrD"}