@yydb/light-db 0.0.0

package/dist/collection/types.d.ts

@@ -0,0 +1,365 @@
+/**
+ * LightDB 集合层类型定义
+ * 包含所有集合相关的接口、类型和结构体定义
+ */
+/**
+ * 主键类型
+ * 支持字符串和数值类型
+ */
+export type PrimaryKeyType = string | number;
+/**
+ * 文档类型
+ * 泛型 T 表示用户定义的文档结构
+ */
+export type Document<T> = T & Record<string, unknown>;
+/**
+ * 比较操作符条件
+ */
+export interface ComparisonOperators<T> {
+    /** 等于 */
+    $eq?: T;
+    /** 不等于 */
+    $ne?: T;
+    /** 大于 */
+    $gt?: T;
+    /** 大于等于 */
+    $gte?: T;
+    /** 小于 */
+    $lt?: T;
+    /** 小于等于 */
+    $lte?: T;
+}
+/**
+ * 数组操作符条件
+ */
+export interface ArrayOperators<T> {
+    /** 包含于数组 */
+    $in?: T[];
+    /** 不包含于数组 */
+    $nin?: T[];
+}
+/**
+ * 存在性操作符条件
+ */
+export interface ExistenceOperators {
+    /** 字段是否存在 */
+    $exists?: boolean;
+}
+/**
+ * 正则表达式操作符条件
+ */
+export interface RegexOperators {
+    /** 正则表达式匹配 */
+    $regex?: RegExp | string;
+    /** 正则表达式选项 */
+    $options?: string;
+}
+/**
+ * 字段查询条件
+ * 可以是精确值、比较操作符或组合操作符
+ */
+export type FieldCondition<T> = T | ComparisonOperators<T> | ArrayOperators<T> | ExistenceOperators | RegexOperators;
+/**
+ * 逻辑操作符条件
+ */
+export interface LogicalOperators<T> {
+    /** 逻辑与 */
+    $and?: QueryFilter<T>[];
+    /** 逻辑或 */
+    $or?: QueryFilter<T>[];
+    /** 逻辑非 */
+    $not?: QueryFilter<T>;
+    /** 逻辑非（等同于 $not） */
+    $nor?: QueryFilter<T>[];
+}
+/**
+ * 查询过滤器
+ * 用于筛选文档
+ */
+export type QueryFilter<T> = {
+    [K in keyof T]?: FieldCondition<T[K]>;
+} & LogicalOperators<T>;
+/**
+ * 更新操作符
+ */
+export interface UpdateOperators<T> {
+    /** 设置字段值 */
+    $set?: Partial<T>;
+    /** 删除字段 */
+    $unset?: Partial<Record<keyof T, true>>;
+    /** 字段值增加 */
+    $inc?: Partial<Record<keyof T, number>>;
+    /** 字段值乘法 */
+    $mul?: Partial<Record<keyof T, number>>;
+    /** 字段值重命名 */
+    $rename?: Partial<Record<keyof T, string>>;
+    /** 设置字段值为当前日期 */
+    $currentDate?: Partial<
+        Record<
+            keyof T,
+            | true
+            | {
+                  $type: "date" | "timestamp";
+              }
+        >
+    >;
+    /** 数组添加元素 */
+    $push?: Partial<
+        Record<
+            keyof T,
+            | unknown
+            | {
+                  $each?: unknown[];
+                  $position?: number;
+                  $slice?: number;
+              }
+        >
+    >;
+    /** 数组删除元素 */
+    $pull?: Partial<Record<keyof T, unknown | QueryFilter<unknown>>>;
+    /** 数组添加元素（去重） */
+    $addToSet?: Partial<
+        Record<
+            keyof T,
+            | unknown
+            | {
+                  $each?: unknown[];
+              }
+        >
+    >;
+    /** 数组弹出元素 */
+    $pop?: Partial<Record<keyof T, 1 | -1>>;
+}
+/**
+ * 更新操作
+ * 可以是部分文档或更新操作符
+ */
+export type UpdateOperation<T> = Partial<T> | UpdateOperators<T>;
+/**
+ * 排序方向
+ */
+export type SortDirection = 1 | -1 | "asc" | "desc";
+/**
+ * 排序条件
+ */
+export type SortCondition<T> = Partial<Record<keyof T, SortDirection>>;
+/**
+ * 查询选项
+ */
+export interface QueryOptions<T> {
+    /** 查询过滤器 */
+    where?: QueryFilter<T>;
+    /** 排序条件 */
+    sort?: SortCondition<T>;
+    /** 跳过记录数 */
+    offset?: number;
+    /** 返回记录数限制 */
+    limit?: number;
+    /** 返回的字段（投影） */
+    fields?: Array<keyof T>;
+}
+/**
+ * 插入选项
+ */
+export interface InsertOptions {
+    /** 如果主键已存在是否抛出异常 */
+    throwOnDuplicate?: boolean;
+}
+/**
+ * 更新选项
+ */
+export interface UpdateOptions {
+    /** 如果记录不存在是否抛出异常 */
+    throwOnMissing?: boolean;
+    /** 是否更新多条记录 */
+    multi?: boolean;
+    /** 如果记录不存在是否插入 */
+    upsert?: boolean;
+}
+/**
+ * 删除选项
+ */
+export interface DeleteOptions {
+    /** 如果记录不存在是否抛出异常 */
+    throwOnMissing?: boolean;
+    /** 是否删除多条记录 */
+    multi?: boolean;
+}
+/**
+ * 插入结果
+ */
+export interface InsertResult<T> {
+    /** 插入是否成功 */
+    success: boolean;
+    /** 插入的文档数量 */
+    insertedCount: number;
+    /** 插入的文档 */
+    insertedDocs: T[];
+}
+/**
+ * 批量插入结果
+ */
+export interface InsertManyResult<T> {
+    /** 插入是否成功 */
+    success: boolean;
+    /** 成功插入的文档数量 */
+    insertedCount: number;
+    /** 失败的文档数量 */
+    failedCount: number;
+    /** 插入的文档 */
+    insertedDocs: T[];
+    /** 错误列表 */
+    errors?: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+/**
+ * 更新结果
+ */
+export interface UpdateResult {
+    /** 更新是否成功 */
+    success: boolean;
+    /** 匹配的文档数量 */
+    matchedCount: number;
+    /** 修改的文档数量 */
+    modifiedCount: number;
+    /** 是否插入了新文档（upsert） */
+    upserted?: boolean;
+    /** 插入的文档主键（upsert） */
+    upsertedId?: PrimaryKeyType;
+}
+/**
+ * 删除结果
+ */
+export interface DeleteResult {
+    /** 删除是否成功 */
+    success: boolean;
+    /** 删除的文档数量 */
+    deletedCount: number;
+}
+/**
+ * 查询结果
+ */
+export interface FindResult<T> {
+    /** 查询到的文档 */
+    docs: T[];
+    /** 总文档数（不考虑分页） */
+    total?: number;
+    /** 是否使用了索引 */
+    usedIndex?: boolean;
+    /** 使用的索引名称 */
+    indexName?: string;
+}
+/**
+ * 二级索引配置
+ */
+export interface IndexConfig<T = unknown> {
+    /** 索引名称 */
+    name: string;
+    /** 索引字段名 */
+    fieldName: keyof T & string;
+    /** 是否唯一索引 */
+    unique?: boolean;
+    /** 是否稀疏索引（不索引 null/undefined 值） */
+    sparse?: boolean;
+}
+/**
+ * 集合配置选项
+ */
+export interface CollectionOptions<T = unknown> {
+    /** 主键字段名 */
+    primaryKey: keyof T & string;
+    /** 二级索引配置 */
+    indexes?: IndexConfig<T>[];
+    /** 集合名称 */
+    name?: string;
+}
+/**
+ * 集合统计信息
+ */
+export interface CollectionStats {
+    /** 集合名称 */
+    name: string;
+    /** 文档数量 */
+    documentCount: number;
+    /** 索引数量 */
+    indexCount: number;
+    /** 索引统计信息 */
+    indexes: Array<{
+        name: string;
+        type: "primary" | "secondary";
+        fieldName: string;
+        unique: boolean;
+        keyCount: number;
+    }>;
+    /** 估算的内存使用量（字节） */
+    memoryUsage: number;
+}
+/**
+ * 集合事件类型
+ */
+export type CollectionEventType = "insert" | "update" | "delete";
+/**
+ * 集合事件监听器
+ */
+export type CollectionEventListener<T> = (
+    event: CollectionEventType,
+    data: {
+        doc?: T;
+        oldDoc?: T;
+        docs?: T[];
+        filter?: QueryFilter<T>;
+    },
+) => void;
+/**
+ * 查询游标选项
+ */
+export interface CursorOptions {
+    /** 批量获取大小 */
+    batchSize?: number;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+}
+/**
+ * 聚合管道阶段
+ */
+export type AggregationStage<T> =
+    | {
+          $match: QueryFilter<T>;
+      }
+    | {
+          $group: {
+              _id: string | Record<string, unknown>;
+              [key: string]: unknown;
+          };
+      }
+    | {
+          $sort: SortCondition<T>;
+      }
+    | {
+          $limit: number;
+      }
+    | {
+          $skip: number;
+      }
+    | {
+          $project: Partial<Record<keyof T, 0 | 1 | Record<string, unknown>>>;
+      }
+    | {
+          $unwind:
+              | string
+              | {
+                    path: string;
+                    preserveNullAndEmptyArrays?: boolean;
+                };
+      }
+    | {
+          $lookup: {
+              from: string;
+              localField: string;
+              foreignField: string;
+              as: string;
+          };
+      };
+//# sourceMappingURL=types.d.ts.map

package/dist/collection/types.d.ts.map

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

package/dist/collection/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * LightDB 集合层类型定义
+ * 包含所有集合相关的接口、类型和结构体定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/collection/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/collection/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/constants/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LightDB 存储引擎常量定义
+ * 包含文件格式、魔数、版本等核心常量
+ */
+/** 魔数：用于标识 .light 文件格式 */
+export declare const LIGHT_MAGIC = 1279870792;
+/** 魔数的字符串表示：'LIGH' */
+export declare const LIGHT_MAGIC_STRING = "LIGH";
+/** 当前文件格式版本号 */
+export declare const LIGHT_VERSION = 1;
+/** 默认页面大小：4KB */
+export declare const DEFAULT_PAGE_SIZE = 4096;
+/** 默认 WAL 文件大小阈值：16MB，超过此值触发检查点 */
+export declare const DEFAULT_WAL_THRESHOLD: number;
+/** Header 固定长度：魔数(4) + 版本(4) + 页面大小(4) + 上次快照LSN(8) + 保留(16) = 36字节 */
+export declare const HEADER_SIZE = 36;
+/** WAL 记录头部长度：LSN(8) + 事务ID(8) + 操作类型(1) + Key长度(4) + Value长度(4) + 校验和(4) = 29字节 */
+export declare const WAL_RECORD_HEADER_SIZE = 29;
+/** SHM Header 大小：WAL文件大小(8) + 最后完整页LSN(8) + 记录数量(4) + 校验和(4) = 24字节 */
+export declare const SHM_HEADER_SIZE = 24;
+/** SHM 哈希表条目大小：页面ID(4) + LSN(8) + WAL偏移(8) = 20字节 */
+export declare const SHM_ENTRY_SIZE = 20;
+/** SHM 哈希表默认容量 */
+export declare const SHM_DEFAULT_CAPACITY = 1024;
+/** 页面头部大小：页面ID(4) + 记录数(2) + 空闲空间(2) + 校验和(4) = 12字节 */
+export declare const PAGE_HEADER_SIZE = 12;
+/** 操作类型枚举值 */
+export declare enum OperationType {
+    /** 插入操作 */
+    Insert = 1,
+    /** 更新操作 */
+    Update = 2,
+    /** 删除操作 */
+    Delete = 3,
+    /** 批量插入 */
+    BatchInsert = 4,
+    /** 检查点标记 */
+    Checkpoint = 16,
+}
+/** 文件扩展名 */
+export declare const FILE_EXTENSIONS: {
+    /** 主数据文件 */
+    readonly LIGHT: ".light";
+    /** 预写日志文件 */
+    readonly WAL: ".wal";
+    /** 共享内存索引文件 */
+    readonly SHM: ".shm";
+    /** 临时文件 */
+    readonly TEMP: ".tmp";
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0BAA0B;AAC1B,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,sBAAsB;AACtB,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,gBAAgB;AAChB,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,iBAAiB;AACjB,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,mCAAmC;AACnC,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAEtD,uEAAuE;AACvE,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,uEAAuE;AACvE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,qDAAqD;AACrD,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,kBAAkB;AAClB,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,cAAc;AACd,oBAAY,aAAa;IACrB,WAAW;IACX,MAAM,IAAO;IACb,WAAW;IACX,MAAM,IAAO;IACb,WAAW;IACX,MAAM,IAAO;IACb,WAAW;IACX,WAAW,IAAO;IAClB,YAAY;IACZ,UAAU,KAAO;CACpB;AAED,YAAY;AACZ,eAAO,MAAM,eAAe;IACxB,YAAY;;IAEZ,aAAa;;IAEb,eAAe;;IAEf,WAAW;;CAEL,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * LightDB 存储引擎常量定义
+ * 包含文件格式、魔数、版本等核心常量
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_EXTENSIONS =
+    exports.OperationType =
+    exports.PAGE_HEADER_SIZE =
+    exports.SHM_DEFAULT_CAPACITY =
+    exports.SHM_ENTRY_SIZE =
+    exports.SHM_HEADER_SIZE =
+    exports.WAL_RECORD_HEADER_SIZE =
+    exports.HEADER_SIZE =
+    exports.DEFAULT_WAL_THRESHOLD =
+    exports.DEFAULT_PAGE_SIZE =
+    exports.LIGHT_VERSION =
+    exports.LIGHT_MAGIC_STRING =
+    exports.LIGHT_MAGIC =
+        void 0;
+/** 魔数：用于标识 .light 文件格式 */
+exports.LIGHT_MAGIC = 0x4c494748;
+/** 魔数的字符串表示：'LIGH' */
+exports.LIGHT_MAGIC_STRING = "LIGH";
+/** 当前文件格式版本号 */
+exports.LIGHT_VERSION = 1;
+/** 默认页面大小：4KB */
+exports.DEFAULT_PAGE_SIZE = 4096;
+/** 默认 WAL 文件大小阈值：16MB，超过此值触发检查点 */
+exports.DEFAULT_WAL_THRESHOLD = 16 * 1024 * 1024;
+/** Header 固定长度：魔数(4) + 版本(4) + 页面大小(4) + 上次快照LSN(8) + 保留(16) = 36字节 */
+exports.HEADER_SIZE = 36;
+/** WAL 记录头部长度：LSN(8) + 事务ID(8) + 操作类型(1) + Key长度(4) + Value长度(4) + 校验和(4) = 29字节 */
+exports.WAL_RECORD_HEADER_SIZE = 29;
+/** SHM Header 大小：WAL文件大小(8) + 最后完整页LSN(8) + 记录数量(4) + 校验和(4) = 24字节 */
+exports.SHM_HEADER_SIZE = 24;
+/** SHM 哈希表条目大小：页面ID(4) + LSN(8) + WAL偏移(8) = 20字节 */
+exports.SHM_ENTRY_SIZE = 20;
+/** SHM 哈希表默认容量 */
+exports.SHM_DEFAULT_CAPACITY = 1024;
+/** 页面头部大小：页面ID(4) + 记录数(2) + 空闲空间(2) + 校验和(4) = 12字节 */
+exports.PAGE_HEADER_SIZE = 12;
+/** 操作类型枚举值 */
+var OperationType;
+(function (OperationType) {
+    /** 插入操作 */
+    OperationType[(OperationType["Insert"] = 1)] = "Insert";
+    /** 更新操作 */
+    OperationType[(OperationType["Update"] = 2)] = "Update";
+    /** 删除操作 */
+    OperationType[(OperationType["Delete"] = 3)] = "Delete";
+    /** 批量插入 */
+    OperationType[(OperationType["BatchInsert"] = 4)] = "BatchInsert";
+    /** 检查点标记 */
+    OperationType[(OperationType["Checkpoint"] = 16)] = "Checkpoint";
+})(OperationType || (exports.OperationType = OperationType = {}));
+/** 文件扩展名 */
+exports.FILE_EXTENSIONS = {
+    /** 主数据文件 */
+    LIGHT: ".light",
+    /** 预写日志文件 */
+    WAL: ".wal",
+    /** 共享内存索引文件 */
+    SHM: ".shm",
+    /** 临时文件 */
+    TEMP: ".tmp",
+};
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,0BAA0B;AACb,QAAA,WAAW,GAAG,UAAU,CAAC;AAEtC,sBAAsB;AACT,QAAA,kBAAkB,GAAG,MAAM,CAAC;AAEzC,gBAAgB;AACH,QAAA,aAAa,GAAG,CAAC,CAAC;AAE/B,iBAAiB;AACJ,QAAA,iBAAiB,GAAG,IAAI,CAAC;AAEtC,mCAAmC;AACtB,QAAA,qBAAqB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,uEAAuE;AAC1D,QAAA,WAAW,GAAG,EAAE,CAAC;AAE9B,oFAAoF;AACvE,QAAA,sBAAsB,GAAG,EAAE,CAAC;AAEzC,uEAAuE;AAC1D,QAAA,eAAe,GAAG,EAAE,CAAC;AAElC,qDAAqD;AACxC,QAAA,cAAc,GAAG,EAAE,CAAC;AAEjC,kBAAkB;AACL,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAEzC,wDAAwD;AAC3C,QAAA,gBAAgB,GAAG,EAAE,CAAC;AAEnC,cAAc;AACd,IAAY,aAWX;AAXD,WAAY,aAAa;IACrB,WAAW;IACX,qDAAa,CAAA;IACb,WAAW;IACX,qDAAa,CAAA;IACb,WAAW;IACX,qDAAa,CAAA;IACb,WAAW;IACX,+DAAkB,CAAA;IAClB,YAAY;IACZ,8DAAiB,CAAA;AACrB,CAAC,EAXW,aAAa,6BAAb,aAAa,QAWxB;AAED,YAAY;AACC,QAAA,eAAe,GAAG;IAC3B,YAAY;IACZ,KAAK,EAAE,QAAQ;IACf,aAAa;IACb,GAAG,EAAE,MAAM;IACX,eAAe;IACf,GAAG,EAAE,MAAM;IACX,WAAW;IACX,IAAI,EAAE,MAAM;CACN,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * LightDB 存储引擎错误定义
+ * 提供详细的错误类型和错误消息
+ */
+/**
+ * 存储引擎错误基类
+ */
+export declare class StorageError extends Error {
+    /** 错误代码 */
+    readonly code: string;
+    /** 错误上下文信息 */
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+}
+/**
+ * 文件操作错误
+ */
+export declare class FileOperationError extends StorageError {
+    constructor(message: string, filePath: string, operation: string);
+}
+/**
+ * 文件格式错误
+ */
+export declare class FileFormatError extends StorageError {
+    constructor(message: string, filePath: string, expected?: string, actual?: unknown);
+}
+/**
+ * 校验和错误
+ */
+export declare class ChecksumError extends StorageError {
+    constructor(message: string, expected: number, actual: number, position?: number);
+}
+/**
+ * WAL 错误
+ */
+export declare class WalError extends StorageError {
+    constructor(message: string, lsn?: bigint, offset?: number);
+}
+/**
+ * 恢复错误
+ */
+export declare class RecoveryError extends StorageError {
+    constructor(message: string, phase: string, details?: unknown);
+}
+/**
+ * 检查点错误
+ */
+export declare class CheckpointError extends StorageError {
+    constructor(message: string, lsn?: bigint);
+}
+/**
+ * 页面错误
+ */
+export declare class PageError extends StorageError {
+    constructor(message: string, pageId: number, details?: unknown);
+}
+/**
+ * 序列化错误
+ */
+export declare class SerializationError extends StorageError {
+    constructor(message: string, data?: unknown);
+}
+/**
+ * 配置错误
+ */
+export declare class ConfigurationError extends StorageError {
+    constructor(message: string, option?: string, value?: unknown);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACnC,WAAW;IACX,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,cAAc;IACd,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS/E;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAKnE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;CAKrF;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;CAKnF;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,YAAY;gBAC1B,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7D;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAKhE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;CAK5C;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAKjE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACpC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAK9C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACpC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKhE"}