@qimen-lab/core 0.1.1

package/dist/entity/types/index.d.ts

@@ -0,0 +1,319 @@
+/**
+ * Entity 包类型定义
+ *
+ * 包含实体管理器、状态、能力相关的类型和常量
+ */
+import type { IEntity, SearchParams, ILocalSearchParams, IFlatSearchParams, ITreeSearchParams, Schema, RegistrSchema } from '@/schema';
+import type { IComposableBase } from '@/composable';
+import type { RequestContext } from '@/context';
+import type { HttpRequestOptions, HttpRequestTask } from '@/http';
+export type { IEntity, SearchParams, ILocalSearchParams, IFlatSearchParams, ITreeSearchParams, FlatSchema, TreeSchema, BaseSchema, } from '@/schema';
+export type { IComposableBase } from '@/composable';
+export { ComposableBase } from '@/composable';
+export type { RequestContext, RequestTask, PaginationInfo } from '@/context';
+export type { HttpRequestOptions, HttpRequestTask, HttpContext } from '@/http';
+export type { ICacheProvider } from '@/cache';
+export { KernelError, KernelErrorCode } from '@/error';
+/** Schema 缓存 Symbol */
+export declare const SCHEMA_CACHE_SYMBOL: unique symbol;
+/** 实体操作类型 */
+export declare enum ENTITY_ACTION {
+    LIST = "list",
+    GET = "get",
+    GET_ALL = "getAll",
+    CREATE = "create",
+    UPDATE = "update",
+    DELETE = "delete",
+    TOGGLE = "toggle",
+    SAVE = "save",
+    BATCH_DELETE = "batchDelete"
+}
+/** 本地变更集 */
+export interface ILocalChangeSet<T = any> {
+    /** 新增项 */
+    added: T[];
+    /** 更新项 */
+    updated: Map<string | number, T>;
+    /** 删除项 ID */
+    deleted: (string | number)[];
+}
+/** 删除计划 */
+export interface IDeletionPlan<T = any> {
+    /** 仅本地存在的项（未同步到远程，可直接删除） */
+    localOnly: T[];
+    /** 已持久化的项（需要远程删除） */
+    persistent: T[];
+}
+/** 基础实体状态接口 */
+export interface IBaseEntityState<TSearch extends SearchParams = SearchParams> {
+    loading: boolean;
+    items: IEntity[];
+    item: IEntity | null;
+    search: TSearch;
+    schema: Schema;
+    cacheTTL: number;
+    isRemote: boolean;
+    refreshView(): void;
+    dispose(): void;
+}
+/** 本地实体状态接口 */
+export interface ILocalEntityState<TSearch extends ILocalSearchParams = ILocalSearchParams> extends IBaseEntityState<TSearch> {
+    sourceData: Map<string | number, IEntity>;
+    updateData(result: any[]): void;
+}
+/** 平铺本地实体状态接口 */
+export interface IFlatLocalEntityState<TSearch extends ILocalSearchParams = ILocalSearchParams> extends ILocalEntityState<TSearch> {
+    hasChanges: boolean;
+    changes: ILocalChangeSet;
+    addItem(item: IEntity): Promise<void>;
+    updateItem(item: IEntity): Promise<void>;
+    softDelete(plan: IDeletionPlan): Promise<void>;
+    getDeletionPlan(ids: (string | number)[]): IDeletionPlan;
+    confirmDelete(): Promise<void>;
+    rollbackDelete(): Promise<void>;
+    clearChanges(): Promise<void>;
+}
+/** 远程实体状态接口 */
+export interface IRemoteEntityState<TSearch extends SearchParams = SearchParams> extends IBaseEntityState<TSearch> {
+    total: number;
+}
+/** 平铺远程实体状态接口 */
+export interface IFlatRemoteEntityState<TSearch extends IFlatSearchParams = IFlatSearchParams> extends IRemoteEntityState<TSearch> {
+    page: number;
+    pageSize: number;
+    pages: number;
+    hasMore: boolean;
+    isDirty(currentItem?: IEntity): boolean;
+    edit(item: IEntity): void;
+    rollback(): void;
+}
+/** 树形远程实体状态接口 */
+export interface ITreeRemoteEntityState<TSearch extends ITreeSearchParams = ITreeSearchParams> extends IRemoteEntityState<TSearch> {
+    expandedIds: Set<string | number>;
+}
+/** 实体状态联合类型 */
+export type EntityState<TSearch extends SearchParams = SearchParams> = ILocalEntityState<TSearch> | IRemoteEntityState<TSearch>;
+/** 核心实体管理器接口 */
+export interface ICoreEntityManager extends IComposableBase {
+    domain: string;
+    entityName: string;
+    url: string;
+    schema: RegistrSchema;
+    readonly compiledSchema: Schema;
+    getSchema(): Schema;
+    getSchemaRules(fieldName?: string): any;
+    request(action: ENTITY_ACTION, options: HttpRequestOptions): HttpRequestTask;
+    cancelAll(): void;
+    dispose(): void;
+}
+/** 基础实体管理器接口 */
+export interface IBaseEntityManager<TSearch extends SearchParams = SearchParams> extends ICoreEntityManager {
+    loading: boolean;
+    items: IEntity[];
+    item: IEntity | null;
+    search: TSearch;
+    sourceData: Map<string | number, IEntity>;
+    fetch(action: ENTITY_ACTION, options: HttpRequestOptions): Promise<RequestContext>;
+    buildOptions(action: ENTITY_ACTION, params?: any, body?: any, extra?: Partial<HttpRequestOptions>): Promise<HttpRequestOptions>;
+}
+/** Schema 能力接口 */
+export interface ISchemaAbility {
+    getSchema(): Schema;
+    getSchemaRules(fieldName?: string): any;
+    readonly schemaKeys: Record<string, string>;
+    readonly schemaTree: {
+        isTree: boolean;
+        isLazy: boolean;
+        root: any;
+    };
+    readonly schemaSort: {
+        prop: string;
+        order: string;
+    };
+    readonly schemaFilters: string[];
+    readonly schemaIdType: string;
+}
+/** 本地列表能力接口 */
+export interface ILocalListAbility<T = any> {
+    list(): Promise<T[]>;
+    refresh(): Promise<T[]>;
+    filter(keyword: string): T[];
+    sort(sortBy: string, sortOrder: 'asc' | 'desc'): T[];
+}
+/** 本地获取能力接口 */
+export interface ILocalGetAbility<T = any> {
+    get(id: string | number): T | undefined;
+}
+/** 平铺本地变更能力接口 */
+export interface IFlatLocalMutationAbility<T = any> {
+    create(item: T): void;
+    update(item: T): void;
+    toggle(item: T, field?: string): void;
+    save(isBatch?: boolean): Promise<void>;
+}
+/** 平铺本地删除能力接口 */
+export interface IFlatLocalDeleteAbility<T = any> {
+    delete(ids: (string | number)[], immediate?: boolean): Promise<void>;
+}
+/** 平铺本地状态能力接口 */
+export interface IFlatLocalStateAbility<T = any> {
+    readonly loading: boolean;
+    readonly isEmpty: boolean;
+    readonly total: number;
+    readonly items: T[];
+    readonly hasChanges: boolean;
+    getDeletionPlan(ids: (string | number)[]): IDeletionPlan<T>;
+    readonly adds: T[];
+    readonly updates: T[];
+}
+/** 平铺远程列表能力接口 */
+export interface IFlatRemoteListAbility<T = any> {
+    list(): Promise<T[]>;
+    refresh(): Promise<T[]>;
+}
+/** 平铺远程获取全部能力接口 */
+export interface IFlatRemoteGetAllAbility<T = any> {
+    getAll(): Promise<T[]>;
+}
+/** 远程获取能力接口 */
+export interface IRemoteGetAbility<T = any> {
+    get(id: string | number): Promise<T>;
+}
+/** 远程创建能力接口 */
+export interface IRemoteCreateAbility<T = any> {
+    create(data: Partial<T>): Promise<T>;
+}
+/** 远程更新能力接口 */
+export interface IRemoteUpdateAbility<T = any> {
+    update(data: Partial<T>): Promise<T>;
+}
+/** 远程删除能力接口 */
+export interface IRemoteDeleteAbility {
+    delete(id: string | number | (string | number)[]): Promise<void>;
+}
+/** 远程切换能力接口 */
+export interface IRemoteToggleAbility<T = any> {
+    toggle(item: T, field?: string): Promise<void>;
+}
+/** 平铺远程查询能力接口 */
+export interface IFlatRemoteQueryAbility {
+    prev(): Promise<void>;
+    next(): Promise<void>;
+    jump(page: number): Promise<void>;
+    changeSize(size: number): Promise<void>;
+    filter(text: string): Promise<void>;
+    searchBy(search: any): Promise<void>;
+    sort(prop: string, order: string): Promise<void>;
+    reset(): Promise<void>;
+}
+/** 平铺远程状态能力接口 */
+export interface IFlatRemoteStateAbility<T = any> {
+    readonly loading: boolean;
+    readonly isEmpty: boolean;
+    readonly hasMore: boolean;
+    readonly total: number;
+    readonly items: T[];
+    readonly page: number;
+    readonly pageSize: number;
+    readonly pages: number;
+    isDirty(currentItem?: T): boolean;
+    edit(item: T): void;
+    rollback(): void;
+}
+/** 树形远程状态能力接口 */
+export interface ITreeRemoteStateAbility<T = any> {
+    readonly loading: boolean;
+    readonly isEmpty: boolean;
+    readonly items: T[];
+}
+/** 树管理能力接口 */
+export interface ITreeManagerAbility<T = any> {
+    expand(id: string | number): void;
+    collapse(id: string | number): void;
+    move(id: string | number, targetPid: string | number | null): void;
+    refresh(pid?: string | number): Promise<void>;
+    getSubTree(pid?: string | number): T[];
+    isDirty(currentItem?: T): boolean;
+    edit(item: T): void;
+    rollback(): void;
+}
+/** 状态 Schema 能力接口 */
+export interface IStateSchemaAbility {
+    readonly idField: string;
+    readonly idType: string;
+    readonly nameField: string;
+    readonly defaultSort: string;
+    readonly defaultOrder: string;
+    readonly searchFields: string[];
+    readonly isTree: boolean;
+    readonly isLazy: boolean;
+    readonly root: any;
+    readonly parentIdField: string;
+    readonly childrenField: string;
+    readonly pathField: string;
+    readonly leafField: string;
+    readonly expandedField: string;
+    readonly useFlat: boolean;
+}
+/** 状态缓存能力接口 */
+export interface IStateCacheAbility {
+    readonly cacheKey: string;
+    tryGetCache(): Promise<any>;
+    setCache(data: any): Promise<void>;
+    clearCache(): Promise<void>;
+}
+/** 状态脏检查能力接口 */
+export interface IStateDirtyAbility<T = any> {
+    isDirty(item?: T): boolean;
+    startEdit(item: T): void;
+    submitEdit(item: T): void;
+    cancelEdit(item: T): void;
+    rollbackAll(): void;
+}
+/** 状态本地变更能力接口 */
+export interface IStateLocalMutationAbility<T = any> {
+    readonly hasChanges: boolean;
+    readonly changes: ILocalChangeSet<T>;
+    addItem(item: T): Promise<void>;
+    updateItem(item: T): Promise<void>;
+    updateData(result: any[]): Promise<void>;
+    softDelete(plan: IDeletionPlan<T>): Promise<void>;
+    getDeletionPlan(ids: (string | number)[]): IDeletionPlan<T>;
+    confirmDelete(): Promise<void>;
+    rollbackDelete(): Promise<void>;
+    clearChanges(): void;
+}
+/** 状态搜索能力接口 */
+export interface IStateSearchAbility<T = any, TSearch extends SearchParams = SearchParams> {
+    toParams(): any;
+    filter(text: string): void;
+    searchBy(search: Partial<TSearch>): void;
+    matchKeyword(item: T): boolean;
+    applySort(list: T[]): T[];
+    sort(field: string, order: string): void;
+}
+/** 树路径能力接口 */
+export interface ITreePathAbility<T = any> {
+    ingest(data: T | T[], manualParentId?: string | number | null): void;
+    rebuildDescendantsPaths(pid: any, parentPath: string, nextDepth: number): void;
+    toggleExpand(id: string | number | T, expanded?: boolean): void;
+    toggleLeaf(id: string | number | T, leaf?: boolean): void;
+}
+/** 树生命周期能力接口 */
+export interface ITreeLifecycleAbility<T = any> {
+    removeNode(id: string | number): void;
+    moveNode(id: string | number, targetPid: string | number | null): void;
+    syncChildren(pid: string | number | null, newData: T[]): void;
+    getChildren(pid?: any, predicate?: (node: T) => boolean): T[];
+}
+/** 树搜索能力接口 */
+export interface ITreeSearchAbility<T = any> {
+    applySearchExpansion(): void;
+    applySort(list: T[]): T[];
+    matchKeyword(node: T, keyword: string): boolean;
+}
+/** 树视图能力接口 */
+export interface ITreeViewAbility {
+    refreshView(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/entity/types/index.d.ts.map

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

package/dist/entity/types/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Entity 包类型定义
+ *
+ * 包含实体管理器、状态、能力相关的类型和常量
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENTITY_ACTION = exports.SCHEMA_CACHE_SYMBOL = exports.KernelErrorCode = exports.KernelError = exports.ComposableBase = void 0;
+var composable_1 = require("@/composable");
+Object.defineProperty(exports, "ComposableBase", { enumerable: true, get: function () { return composable_1.ComposableBase; } });
+var error_1 = require("@/error");
+Object.defineProperty(exports, "KernelError", { enumerable: true, get: function () { return error_1.KernelError; } });
+Object.defineProperty(exports, "KernelErrorCode", { enumerable: true, get: function () { return error_1.KernelErrorCode; } });
+// ============================================
+// Symbol 常量
+// ============================================
+/** Schema 缓存 Symbol */
+exports.SCHEMA_CACHE_SYMBOL = Symbol('schema-cache');
+// ============================================
+// 实体动作枚举
+// ============================================
+/** 实体操作类型 */
+var ENTITY_ACTION;
+(function (ENTITY_ACTION) {
+    ENTITY_ACTION["LIST"] = "list";
+    ENTITY_ACTION["GET"] = "get";
+    ENTITY_ACTION["GET_ALL"] = "getAll";
+    ENTITY_ACTION["CREATE"] = "create";
+    ENTITY_ACTION["UPDATE"] = "update";
+    ENTITY_ACTION["DELETE"] = "delete";
+    ENTITY_ACTION["TOGGLE"] = "toggle";
+    ENTITY_ACTION["SAVE"] = "save";
+    ENTITY_ACTION["BATCH_DELETE"] = "batchDelete";
+})(ENTITY_ACTION || (exports.ENTITY_ACTION = ENTITY_ACTION = {}));
+//# sourceMappingURL=index.js.map

package/dist/entity/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/entity/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAmCH,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAQvB,iCAAuD;AAA9C,oGAAA,WAAW,OAAA;AAAE,wGAAA,eAAe,OAAA;AAErC,+CAA+C;AAC/C,YAAY;AACZ,+CAA+C;AAE/C,uBAAuB;AACV,QAAA,mBAAmB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1D,+CAA+C;AAC/C,SAAS;AACT,+CAA+C;AAE/C,aAAa;AACb,IAAY,aAUX;AAVD,WAAY,aAAa;IACrB,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,mCAAkB,CAAA;IAClB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,6CAA4B,CAAA;AAChC,CAAC,EAVW,aAAa,6BAAb,aAAa,QAUxB"}

package/dist/error/ErrorBase.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 🎯 基础错误类
+ * 提供标准化的错误接口
+ */
+export declare abstract class ErrorBase extends Error {
+    /**
+     * 错误代码
+     */
+    readonly code: string | number;
+    /**
+     * 错误发生的时间戳
+     */
+    readonly timestamp: Date;
+    /**
+     * 额外的错误上下文数据
+     */
+    readonly context?: Record<string, any>;
+    /**
+     * 构造函数
+     * @param message 错误消息
+     * @param code 错误代码
+     * @param context 上下文信息（可选）
+     */
+    constructor(message: string, // 错误消息
+    code: string | number, // 错误代码
+    context?: Record<string, any>);
+    /**
+     * 转换为 JSON 格式
+     * @returns 包含错误信息的对象
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * 转换为字符串
+     * @returns 格式化的错误字符串
+     */
+    toString(): string;
+}
+//# sourceMappingURL=ErrorBase.d.ts.map

package/dist/error/ErrorBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBase.d.ts","sourceRoot":"","sources":["../../../src/error/ErrorBase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,SAAU,SAAQ,KAAK;IACzC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtC;;OAEG;IACH,SAAgB,SAAS,EAAE,IAAI,CAAC;IAEhC;;OAEG;IACH,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9C;;;;;OAKG;gBAEC,OAAO,EAAE,MAAM,EAAE,OAAO;IACxB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAkBjC;;;OAGG;IACI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWpC;;;OAGG;IACI,QAAQ,IAAI,MAAM;CAe5B"}

package/dist/error/ErrorBase.esm.js

@@ -0,0 +1,58 @@
+/**
+ * 🎯 基础错误类
+ * 提供标准化的错误接口
+ */
+export class ErrorBase extends Error {
+    /**
+     * 构造函数
+     * @param message 错误消息
+     * @param code 错误代码
+     * @param context 上下文信息（可选）
+     */
+    constructor(message, // 错误消息
+    code, // 错误代码
+    context // 上下文信息（可选）
+    ) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.context = context;
+        this.timestamp = new Date();
+        // 保持正确的原型链
+        Object.setPrototypeOf(this, new.target.prototype);
+        // 捕获堆栈跟踪
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * 转换为 JSON 格式
+     * @returns 包含错误信息的对象
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            stack: this.stack,
+            timestamp: this.timestamp.toISOString(),
+            context: this.context,
+        };
+    }
+    /**
+     * 转换为字符串
+     * @returns 格式化的错误字符串
+     */
+    toString() {
+        const parts = [`[${this.name}]`];
+        if (this.code) {
+            parts.push(`(${this.code})`);
+        }
+        parts.push(this.message);
+        if (this.context) {
+            parts.push(JSON.stringify(this.context));
+        }
+        return parts.join(' ');
+    }
+}
+//# sourceMappingURL=ErrorBase.js.map

package/dist/error/ErrorBase.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBase.js","sourceRoot":"","sources":["../../../src/error/ErrorBase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAgB,SAAU,SAAQ,KAAK;IAgBzC;;;;;OAKG;IACH,YACI,OAAe,EAAE,OAAO;IACxB,IAAqB,EAAE,OAAO;IAC9B,OAA6B,CAAC,YAAY;;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,WAAW;QACX,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAElD,SAAS;QACT,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC;IACN,CAAC;IAED;;;OAGG;IACI,QAAQ;QACX,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACJ"}

package/dist/error/ErrorBase.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorBase = void 0;
+/**
+ * 🎯 基础错误类
+ * 提供标准化的错误接口
+ */
+class ErrorBase extends Error {
+    /**
+     * 构造函数
+     * @param message 错误消息
+     * @param code 错误代码
+     * @param context 上下文信息（可选）
+     */
+    constructor(message, // 错误消息
+    code, // 错误代码
+    context // 上下文信息（可选）
+    ) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.context = context;
+        this.timestamp = new Date();
+        // 保持正确的原型链
+        Object.setPrototypeOf(this, new.target.prototype);
+        // 捕获堆栈跟踪
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * 转换为 JSON 格式
+     * @returns 包含错误信息的对象
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            stack: this.stack,
+            timestamp: this.timestamp.toISOString(),
+            context: this.context,
+        };
+    }
+    /**
+     * 转换为字符串
+     * @returns 格式化的错误字符串
+     */
+    toString() {
+        const parts = [`[${this.name}]`];
+        if (this.code) {
+            parts.push(`(${this.code})`);
+        }
+        parts.push(this.message);
+        if (this.context) {
+            parts.push(JSON.stringify(this.context));
+        }
+        return parts.join(' ');
+    }
+}
+exports.ErrorBase = ErrorBase;
+//# sourceMappingURL=ErrorBase.js.map

package/dist/error/ErrorBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBase.js","sourceRoot":"","sources":["../../../src/error/ErrorBase.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAsB,SAAU,SAAQ,KAAK;IAgBzC;;;;;OAKG;IACH,YACI,OAAe,EAAE,OAAO;IACxB,IAAqB,EAAE,OAAO;IAC9B,OAA6B,CAAC,YAAY;;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,WAAW;QACX,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAElD,SAAS;QACT,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC;IACN,CAAC;IAED;;;OAGG;IACI,QAAQ;QACX,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACJ;AA7ED,8BA6EC"}

package/dist/error/GestureError.d.ts

@@ -0,0 +1,45 @@
+import { KernelError } from './KernelError';
+import { KernelErrorCode } from './codes';
+/**
+ * 🖱️ 手势事件处理错误类
+ *
+ * 用于处理与手势识别和处理相关的错误
+ * 继承自KernelError，提供统一的错误处理机制
+ *
+ * @example
+ * ```ts
+ * try {
+ *   // 手势处理逻辑
+ *   handleGesture(event);
+ * } catch (error) {
+ *   throw new GestureError('手势识别失败', KernelErrorCode.GESTURE_RECOGNITION_ERROR, {
+ *     gestureType: 'swipe',
+ *     targetElement: event.target,
+ *     position: { x: event.clientX, y: event.clientY }
+ *   });
+ * }
+ * ```
+ */
+export declare class GestureError extends KernelError {
+    /**
+     * 构造函数
+     *
+     * @param message - 错误消息，描述具体的错误原因
+     * @param code - 错误代码，来自KernelErrorCode枚举
+     * @param context - 可选参数，提供与错误相关的上下文信息
+     *
+     * @example
+     * ```ts
+     * const error = new GestureError('无法识别手势类型', KernelErrorCode.GESTURE_RECOGNITION_ERROR);
+     *
+     * const errorWithCtx = new GestureError('滑动距离不足', KernelErrorCode.GESTURE_DISTANCE_INSUFFICIENT, {
+     *   minDistance: 50,
+     *   actualDistance: 30,
+     *   startPosition: { x: 10, y: 20 },
+     *   endPosition: { x: 25, y: 35 }
+     * });
+     * ```
+     */
+    constructor(message: string, code: KernelErrorCode, context?: Record<string, any>);
+}
+//# sourceMappingURL=GestureError.d.ts.map

package/dist/error/GestureError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GestureError.d.ts","sourceRoot":"","sources":["../../../src/error/GestureError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;;;;OAkBG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAMpF"}

package/dist/error/GestureError.esm.js

@@ -0,0 +1,48 @@
+import { KernelError } from './KernelError';
+/**
+ * 🖱️ 手势事件处理错误类
+ *
+ * 用于处理与手势识别和处理相关的错误
+ * 继承自KernelError，提供统一的错误处理机制
+ *
+ * @example
+ * ```ts
+ * try {
+ *   // 手势处理逻辑
+ *   handleGesture(event);
+ * } catch (error) {
+ *   throw new GestureError('手势识别失败', KernelErrorCode.GESTURE_RECOGNITION_ERROR, {
+ *     gestureType: 'swipe',
+ *     targetElement: event.target,
+ *     position: { x: event.clientX, y: event.clientY }
+ *   });
+ * }
+ * ```
+ */
+export class GestureError extends KernelError {
+    /**
+     * 构造函数
+     *
+     * @param message - 错误消息，描述具体的错误原因
+     * @param code - 错误代码，来自KernelErrorCode枚举
+     * @param context - 可选参数，提供与错误相关的上下文信息
+     *
+     * @example
+     * ```ts
+     * const error = new GestureError('无法识别手势类型', KernelErrorCode.GESTURE_RECOGNITION_ERROR);
+     *
+     * const errorWithCtx = new GestureError('滑动距离不足', KernelErrorCode.GESTURE_DISTANCE_INSUFFICIENT, {
+     *   minDistance: 50,
+     *   actualDistance: 30,
+     *   startPosition: { x: 10, y: 20 },
+     *   endPosition: { x: 25, y: 35 }
+     * });
+     * ```
+     */
+    constructor(message, code, context) {
+        super(message, code, context);
+        // 保持正确的原型链
+        Object.setPrototypeOf(this, GestureError.prototype);
+    }
+}
+//# sourceMappingURL=GestureError.js.map

package/dist/error/GestureError.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GestureError.js","sourceRoot":"","sources":["../../../src/error/GestureError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,OAAe,EAAE,IAAqB,EAAE,OAA6B;QAC7E,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAE9B,WAAW;QACX,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACJ"}