@qimen-lab/core 0.1.4 → 0.1.5

package/dist/entity/abilities/mutation/LocalMutationAbility.esm.js

@@ -0,0 +1,164 @@
+/**
+ * LocalMutationAbility - 本地变更集能力
+ *
+ * 为宿主提供本地数据变更管理功能（新增/更新/删除/回滚）。
+ * this 指向宿主（Manager），this.schema/sourceData 可直接访问。
+ * 私有状态 _changes/_deleteSnapshots 通过 abilityState 管理。
+ * 防抖 refreshView 通过 this.debounce() 管理。
+ */
+export const LocalMutationAbility = {
+    hasChanges: {
+        get() {
+            const changes = this.abilityState('StateLocalMutation:changes');
+            return (changes !== undefined &&
+                (changes.added.length > 0 || changes.updated.size > 0 || changes.deleted.length > 0));
+        },
+    },
+    changes: {
+        get() {
+            var _a;
+            return (_a = this.abilityState('StateLocalMutation:changes')) !== null && _a !== void 0 ? _a : this._createEmptyChanges();
+        },
+    },
+    async addItem(item) {
+        const idField = this.schema.idField || 'id';
+        const idType = this.schema.idType || 'string';
+        const tempId = idType === 'number' ? -Math.abs(Date.now()) : crypto.randomUUID();
+        item.tempId = tempId;
+        item.isNew = true;
+        const changes = this._getOrCreateChanges();
+        changes.added.push(item);
+        this.sourceData.set(item[idField] || item.tempId, item);
+        await this._commitChange();
+    },
+    async updateItem(item) {
+        const idField = this.schema.idField || 'id';
+        const key = item[idField] || item.tempId;
+        this.sourceData.set(key, { ...item });
+        const id = item[idField];
+        const changes = this._getOrCreateChanges();
+        const isNew = changes.added.some((i) => i[idField] === id || i.tempId === item.tempId);
+        if (!isNew && id) {
+            changes.updated.set(id, { ...item });
+        }
+        await this._commitChange();
+    },
+    async updateData(result) {
+        const idField = this.schema.idField || 'id';
+        this.setAbilityState('StateLocalMutation:changes', this._createEmptyChanges());
+        result.forEach((item) => {
+            const id = item[idField];
+            const tempId = item.tempId;
+            if (tempId && this.sourceData.has(tempId)) {
+                this.sourceData.delete(tempId);
+            }
+            this.sourceData.set(id, item);
+        });
+        await this._commitChange();
+    },
+    async softDelete(plan) {
+        const idField = this.schema.idField || 'id';
+        const { localOnly, persistent } = plan;
+        const localIds = localOnly.map((item) => typeof item === 'object' ? item[idField] : item);
+        const persistentIds = persistent.map((item) => typeof item === 'object' ? item[idField] : item);
+        const allIds = [...localIds, ...persistentIds];
+        // 保存所有待删除项的快照（用于回滚）
+        const deleteSnapshots = this._getOrCreateDeleteSnapshots();
+        allIds.forEach((id) => {
+            const item = Array.from(this.sourceData.values()).find((i) => i[idField] === id);
+            if (item) {
+                deleteSnapshots.set(id, { ...item });
+            }
+        });
+        if (localIds.length > 0) {
+            const changes = this._getOrCreateChanges();
+            const localSet = new Set(localIds);
+            changes.added = changes.added.filter((item) => !localSet.has(item[idField]));
+            changes.deleted.push(...localIds);
+        }
+        if (persistentIds.length > 0) {
+            const changes = this._getOrCreateChanges();
+            changes.deleted.push(...persistentIds);
+        }
+        await this._deleteFromSource(allIds);
+    },
+    getDeletionPlan(ids) {
+        const idField = this.schema.idField || 'id';
+        const plan = { localOnly: [], persistent: [] };
+        const changes = this.abilityState('StateLocalMutation:changes');
+        const addedIds = changes
+            ? new Set(changes.added.map((item) => item[idField]))
+            : new Set();
+        ids.forEach(id => {
+            if (addedIds.has(id)) {
+                plan.localOnly.push(id);
+            }
+            else {
+                plan.persistent.push(id);
+            }
+        });
+        return plan;
+    },
+    async confirmDelete() {
+        const deleteSnapshots = this._getOrCreateDeleteSnapshots();
+        deleteSnapshots.clear();
+        const changes = this.abilityState('StateLocalMutation:changes');
+        if (changes) {
+            changes.deleted.length = 0;
+        }
+        await this._commitChange();
+    },
+    async rollbackDelete() {
+        const deleteSnapshots = this._getOrCreateDeleteSnapshots();
+        const changes = this.abilityState('StateLocalMutation:changes');
+        if (deleteSnapshots.size === 0 && (!changes || changes.deleted.length === 0))
+            return;
+        deleteSnapshots.forEach((item, id) => {
+            this.sourceData.set(id, item);
+        });
+        deleteSnapshots.clear();
+        if (changes) {
+            changes.deleted.length = 0;
+        }
+        await this._commitChange();
+    },
+    clearChanges() {
+        this.setAbilityState('StateLocalMutation:changes', this._createEmptyChanges());
+    },
+    // ---- 内部辅助方法 ----
+    _getOrCreateChanges() {
+        let changes = this.abilityState('StateLocalMutation:changes');
+        if (!changes) {
+            changes = this._createEmptyChanges();
+            this.setAbilityState('StateLocalMutation:changes', changes);
+        }
+        return changes;
+    },
+    _getOrCreateDeleteSnapshots() {
+        let snapshots = this.abilityState('StateLocalMutation:deleteSnapshots');
+        if (!snapshots) {
+            snapshots = new Map();
+            this.setAbilityState('StateLocalMutation:deleteSnapshots', snapshots);
+        }
+        return snapshots;
+    },
+    _createEmptyChanges() {
+        return {
+            added: [],
+            updated: new Map(),
+            deleted: [],
+        };
+    },
+    async _commitChange() {
+        var _a;
+        // 缓存立即更新（保证数据一致性）
+        await ((_a = this.setCache) === null || _a === void 0 ? void 0 : _a.call(this, this.sourceData));
+        // 视图刷新防抖（高频操作时合并渲染）
+        this.debounce('refreshView', () => { var _a; return (_a = this.refreshView) === null || _a === void 0 ? void 0 : _a.call(this); }, 50)();
+    },
+    async _deleteFromSource(ids) {
+        ids.forEach(key => this.sourceData.delete(key));
+        await this._commitChange();
+    },
+};
+//# sourceMappingURL=LocalMutationAbility.js.map

package/dist/entity/abilities/mutation/LocalMutationAbility.esm.js.map

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

package/dist/entity/abilities/mutation/index.esm.js

@@ -0,0 +1,2 @@
+export { LocalMutationAbility } from './LocalMutationAbility';
+//# sourceMappingURL=index.js.map

package/dist/entity/abilities/mutation/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/mutation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/entity/abilities/remote/FlatRemoteGetAllAbility.esm.js

@@ -0,0 +1,20 @@
+/**
+ * FlatRemoteGetAllAbility - 远程获取全部数据能力
+ *
+ * 提供获取全部数据的能力，支持 300ms leading 防抖。
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ * 防抖通过 this.debounce() 管理，宿主统一管理。
+ */
+export const FlatRemoteGetAllAbility = {
+    getAll() {
+        return this.debounce('get-all', () => this._internalGetAll(), 300, true)();
+    },
+    async _internalGetAll() {
+        const options = await this.buildOptions('get-all', {}, {}, {});
+        const context = await this.fetch('get-all', options);
+        const items = context.data.list;
+        this.updateData(items, items.length);
+        return this.items;
+    },
+};
+//# sourceMappingURL=FlatRemoteGetAllAbility.js.map

package/dist/entity/abilities/remote/FlatRemoteGetAllAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlatRemoteGetAllAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/FlatRemoteGetAllAbility.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACtD,MAAM;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,eAAe;QACjB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ,CAAC"}

package/dist/entity/abilities/remote/FlatRemoteListAbility.esm.js

@@ -0,0 +1,47 @@
+/**
+ * FlatRemoteListAbility - 远程列表查询能力
+ *
+ * 提供列表查询和强制刷新的能力，支持 300ms 防抖。
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ * 防抖通过 this.debounce() 管理，宿主统一管理。
+ *
+ * 设计说明：
+ * debounce 在 immediate=false 时不返回异步结果，
+ * 因此 list/refresh 直接调用 _internalList，
+ * 防抖仅用于合并短时间内的重复调用（防止并发请求）。
+ */
+export const FlatRemoteListAbility = {
+    /**
+     * 普通查询
+     */
+    async list() {
+        return this._internalList(false);
+    },
+    /**
+     * 强制刷新：跳过缓存，直接请求
+     */
+    async refresh() {
+        return this._internalList(true);
+    },
+    async _internalList(force = false) {
+        if (!force) {
+            const cached = await this.tryGetCache();
+            if (cached) {
+                this.updateData(cached.items, cached.total);
+                this.emit('listed', this.items);
+                return this.items;
+            }
+        }
+        // 穿透缓存或强制刷新，获取最新参数
+        const params = this.toParams();
+        // 构建 options
+        const options = await this.buildOptions('list', params, null, {});
+        const context = await this.fetch('list', options);
+        const { list, total } = context.data;
+        // 同步状态
+        this.updateData(list, total);
+        this.emit('listed', this.items);
+        return this.items;
+    },
+};
+//# sourceMappingURL=FlatRemoteListAbility.js.map

package/dist/entity/abilities/remote/FlatRemoteListAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlatRemoteListAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/FlatRemoteListAbility.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACpD;;OAEG;IACH,KAAK,CAAC,IAAI;QACN,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAiB,KAAK;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACT,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAChC,OAAO,IAAI,CAAC,KAAK,CAAC;YACtB,CAAC;QACL,CAAC;QAED,mBAAmB;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE/B,aAAa;QACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAElE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAElD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;QACrC,OAAO;QACP,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ,CAAC"}

package/dist/entity/abilities/remote/FlatRemoteQueryAbility.esm.js

@@ -0,0 +1,70 @@
+import { KernelError, KernelErrorCode } from '../../../error/index.esm.js';
+/**
+ * FlatRemoteQueryAbility - 远程查询能力
+ *
+ * 提供分页导航、过滤、排序等查询操作。
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ */
+export const FlatRemoteQueryAbility = {
+    async prev() {
+        const page = this.page - 1;
+        if (this.isValidPage(page)) {
+            this.page = page;
+            return await this._internalList(false);
+        }
+        this.logger.warn('Already on the first page, cannot go prev.');
+        return [];
+    },
+    async next() {
+        const page = this.page + 1;
+        if (this.isValidPage(page)) {
+            this.page = page;
+            return await this._internalList(false);
+        }
+        this.logger.warn('Already on the last page, cannot go next.');
+        return [];
+    },
+    async jump(page) {
+        if (this.isValidPage(page)) {
+            this.page = page;
+            return await this._internalList(false);
+        }
+        this.logger.warn(`Invalid page: ${page}. Options are: ${this.pageSizes}`);
+        return [];
+    },
+    async changeSize(size) {
+        if (!this.pageSizes.includes(size)) {
+            if (this.systemConfig('env') === 'development')
+                throw new KernelError(`Invalid pageSize: ${size}. Options are: ${this.pageSizes}`, KernelErrorCode.INVALID_PAGE_SIZE);
+            this.logger.error(`Invalid pageSize: ${size}. Options are: ${this.pageSizes}`);
+            return [];
+        }
+        this.pageSize = size;
+        this.page = 1;
+        return await this._internalList(true);
+    },
+    /** 过滤查询 */
+    async filter(text) {
+        this.page = 1;
+        this.search.keyword = text;
+        return await this._internalList(true);
+    },
+    async searchBy(search) {
+        this.search = { ...this.search, ...search };
+        return await this._internalList(true);
+    },
+    /** 排序 */
+    async sort(prop, order) {
+        this.search.sortBy = order ? prop : '';
+        this.search.sortOrder = order || 'asc';
+        this.page = 1;
+        return await this._internalList(false);
+    },
+    /** 重置 */
+    async reset() {
+        this.page = 1;
+        this.search = {};
+        return await this._internalList(true);
+    },
+};
+//# sourceMappingURL=FlatRemoteQueryAbility.js.map

package/dist/entity/abilities/remote/FlatRemoteQueryAbility.esm.js.map

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

package/dist/entity/abilities/remote/FlatRemoteStateAbility.esm.js

@@ -0,0 +1,78 @@
+/**
+ * FlatRemoteStateAbility - 扁平远程状态能力
+ *
+ * 提供对实体集合的计算属性和状态管理方法。
+ * 数据字段（loading, items, page 等）已在 Manager 上定义，
+ * 此 Ability 补充计算属性和状态操作方法。
+ *
+ * 注意：不定义与 Manager 数据字段同名的 getter（如 loading, items, page 等），
+ * 避免覆盖实例属性导致无法赋值。
+ *
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ */
+export const FlatRemoteStateAbility = {
+    // 计算属性（不与 Manager 数据字段同名）
+    isEmpty: {
+        get() {
+            return this.items.length === 0;
+        },
+    },
+    // 状态操作方法（原 FlatRemoteEntityState 的方法）
+    /**
+     * 更新列表数据和分页信息
+     */
+    updateData(list, total) {
+        this.items = list || [];
+        this.total = typeof total === 'number' ? total : this.items.length;
+        this.pages = Math.ceil(this.total / this.pageSize) || 0;
+        this.hasMore = this.page < this.pages;
+    },
+    /**
+     * 更新单个实体
+     */
+    updateItem(item) {
+        if (!item)
+            return;
+        this.item = item;
+        // 同步到 items 列表
+        const index = this.items.findIndex((i) => i.id === item.id);
+        if (index >= 0) {
+            this.items[index] = item;
+        }
+    },
+    /**
+     * 验证页码是否有效
+     */
+    isValidPage(page) {
+        return page >= 1 && page <= this.pages;
+    },
+    /**
+     * 从 items 中删除实体
+     */
+    deleteFromItems(id) {
+        const ids = Array.isArray(id) ? id : [id];
+        this.items = this.items.filter((i) => !ids.includes(i.id));
+        this.total = Math.max(0, this.total - ids.length);
+        this.pages = Math.ceil(this.total / this.pageSize) || 0;
+        this.hasMore = this.page < this.pages;
+    },
+    /**
+     * 刷新视图（替换数组引用以触发响应式更新）
+     */
+    refreshView() {
+        this.items = [...this.items];
+    },
+    /**
+     * 开始编辑
+     */
+    edit(item) {
+        this.startEdit(item);
+    },
+    /**
+     * 回滚所有编辑
+     */
+    rollback() {
+        this.rollbackAll();
+    },
+};
+//# sourceMappingURL=FlatRemoteStateAbility.js.map

package/dist/entity/abilities/remote/FlatRemoteStateAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlatRemoteStateAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/FlatRemoteStateAbility.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACrD,0BAA0B;IAC1B,OAAO,EAAE;QACL,GAAG;YACC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;QACnC,CAAC;KACJ;IAED,sCAAsC;IAEtC;;OAEG;IACH,UAAU,CAAC,IAAW,EAAE,KAAc;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACnE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAS;QAChB,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,eAAe;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC7B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACpB,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,EAAyC;QACrD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,WAAW;QACP,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAS;QACV,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,IAAI,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;CACJ,CAAC"}

package/dist/entity/abilities/remote/RemoteCreateAbility.esm.js

@@ -0,0 +1,33 @@
+import { KernelError, KernelErrorCode } from '../../../error/index.esm.js';
+/**
+ * RemoteCreateAbility - 远程创建能力
+ *
+ * 该能力为实体管理器（Entity Manager）提供通过网络请求创建远程数据的功能。
+ * 它封装了发送创建请求、处理响应、同步本地状态以及事件发射的完整流程。
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ */
+export const RemoteCreateAbility = {
+    /**
+     * 创建一条新记录
+     *
+     * 发送请求以在服务器上创建新记录，并自动同步创建结果到本地状态。
+     *
+     * @param data - 包含待创建记录所需字段的对象
+     * @returns 一个 Promise，解析为服务器返回的、已创建后的完整记录。
+     * @throws {KernelError} 当操作进行中或请求失败时抛出错误。
+     */
+    async create(data) {
+        // 1. 状态锁保护：防止请求飞行中再次触发
+        if (this.loading) {
+            throw new KernelError('Operation in progress, please wait.', KernelErrorCode.ENTITY_OPERATION_IN_PROGRESS);
+        }
+        // 2. 发起请求 (fetch 内部会自动处理 loading 状态的切换)
+        const options = await this.buildOptions('create', {}, data, {});
+        const context = await this.fetch('create', options);
+        const item = context.data.item;
+        this.updateItem(item);
+        this.emit('created', item);
+        return this.item;
+    },
+};
+//# sourceMappingURL=RemoteCreateAbility.js.map

package/dist/entity/abilities/remote/RemoteCreateAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteCreateAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/RemoteCreateAbility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IAClD;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,IAAS;QAClB,uBAAuB;QACvB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CACjB,qCAAqC,EACrC,eAAe,CAAC,4BAA4B,CAC/C,CAAC;QACN,CAAC;QAED,wCAAwC;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAK,CAAC;IACtB,CAAC;CACJ,CAAC"}

package/dist/entity/abilities/remote/RemoteDeleteAbility.esm.js

@@ -0,0 +1,34 @@
+import { KernelError, KernelErrorCode } from '../../../error/index.esm.js';
+/**
+ * RemoteDeleteAbility - 远程删除能力
+ *
+ * 提供删除远程实体的能力，通过HTTP请求与服务器交互。
+ * 支持单个或批量删除操作，并自动更新本地状态。
+ * 使用 loading 锁防止并发删除请求。
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ */
+export const RemoteDeleteAbility = {
+    /**
+     * 远程删除一个或多个实体
+     *
+     * 根据传入的目标类型自动判断是单个删除还是批量删除，
+     * 发起相应的API调用并更新本地状态。
+     *
+     * @param id - 要删除的实体ID或ID数组
+     * @throws {KernelError} 当操作进行中或删除请求失败时抛出错误
+     */
+    async delete(id) {
+        // loading 锁保护：防止并发删除请求
+        if (this.loading) {
+            throw new KernelError('Operation in progress, please wait.', KernelErrorCode.ENTITY_OPERATION_IN_PROGRESS);
+        }
+        const isBatch = Array.isArray(id);
+        const action = isBatch ? 'batch-delete' : 'delete';
+        const options = isBatch
+            ? await this.buildOptions(action, {}, { ids: id }, {})
+            : await this.buildOptions(action, { [this.idField]: id }, null, {});
+        await this.fetch(action, options);
+        this.deleteFromItems(id);
+    },
+};
+//# sourceMappingURL=RemoteDeleteAbility.js.map

package/dist/entity/abilities/remote/RemoteDeleteAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteDeleteAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/RemoteDeleteAbility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IAClD;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAyC;QAClD,uBAAuB;QACvB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CACjB,qCAAqC,EACrC,eAAe,CAAC,4BAA4B,CAC/C,CAAC;QACN,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnD,MAAM,OAAO,GAAG,OAAO;YACnB,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;YACtD,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;CACJ,CAAC"}

package/dist/entity/abilities/remote/RemoteGetAbility.esm.js

@@ -0,0 +1,23 @@
+/**
+ * RemoteGetAbility - 远程获取能力
+ *
+ * this 指向宿主（Manager），this.state 可直接访问。
+ */
+export const RemoteGetAbility = {
+    /**
+     * 远程获取实体
+     *
+     * @param id 要获取的实体ID
+     * @returns Promise<any> 获取的实体的Promise
+     */
+    async get(id) {
+        var _a;
+        const { idField } = this.schemaKeys;
+        const options = await this.buildOptions('get', { [idField]: id }, null, {});
+        const context = await this.fetch('get', options);
+        const result = (_a = context.data) === null || _a === void 0 ? void 0 : _a.item;
+        this.updateItem(result);
+        return result;
+    },
+};
+//# sourceMappingURL=RemoteGetAbility.js.map

package/dist/entity/abilities/remote/RemoteGetAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteGetAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/RemoteGetAbility.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IAC/C;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,EAAmB;;QACzB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAEpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,MAAA,OAAO,CAAC,IAAI,0CAAE,IAAI,CAAC;QAElC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ,CAAC"}

package/dist/entity/abilities/remote/RemoteToggleAbility.esm.js

@@ -0,0 +1,40 @@
+/**
+ * RemoteToggleAbility - 远程状态切换能力
+ *
+ * 允许对实体的布尔字段进行远程切换操作（如启用/禁用），支持：
+ * - 乐观 UI 更新（立即响应，提升用户体验）
+ * - 防抖提交（避免频繁请求）
+ * - 操作失败自动回滚
+ * - 支持同一资源不同字段独立控制
+ *
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ * 防抖通过 this.debounce() 管理，宿主统一管理。
+ */
+export const RemoteToggleAbility = {
+    async toggle(item, field) {
+        return this.debounce('toggle', (i, f) => this._internalToggle(i, f), 400, true)(item, field);
+    },
+    async _internalToggle(item, field) {
+        const idField = this.idField;
+        const id = item[idField];
+        // 1. 乐观更新：记录旧值，并立即更新 UI 上的字段值
+        const oldValue = item[field];
+        item[field] = !oldValue;
+        try {
+            // 2. 触发提交请求
+            const options = await this.buildOptions('toggle', { id }, { item, field }, {});
+            const context = await this.fetch('toggle', options);
+            const finalData = context.data.item || item;
+            this.updateItem(finalData);
+            this.emit('toggled', { id, item: finalData, field });
+            return this.item;
+        }
+        catch (error) {
+            // 3. 操作失败：回滚到旧值
+            item[field] = oldValue;
+            this.updateItem(item);
+            return this.item;
+        }
+    },
+};
+//# sourceMappingURL=RemoteToggleAbility.js.map

package/dist/entity/abilities/remote/RemoteToggleAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteToggleAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/RemoteToggleAbility.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IAClD,KAAK,CAAC,MAAM,CAAC,IAAS,EAAE,KAAa;QACjC,OAAO,IAAI,CAAC,QAAQ,CAChB,QAAQ,EACR,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EACjD,GAAG,EACH,IAAI,CACP,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAS,EAAE,KAAa;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzB,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QACxB,IAAI,CAAC;YACD,YAAY;YACZ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;YAC5C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,IAAK,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,gBAAgB;YAChB,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC,IAAK,CAAC;QACtB,CAAC;IACL,CAAC;CACJ,CAAC"}

package/dist/entity/abilities/remote/RemoteUpdateAbility.esm.js

@@ -0,0 +1,34 @@
+import { KernelError, KernelErrorCode } from '../../../error/index.esm.js';
+/**
+ * RemoteUpdateAbility - 远程更新能力
+ *
+ * 该能力为实体管理器（Entity Manager）提供通过网络请求更新远程数据的功能。
+ * 它封装了发送更新请求、处理响应、同步本地状态以及事件发射的完整流程。
+ * this 指向宿主（Manager），数据字段直接在 this 上访问。
+ */
+export const RemoteUpdateAbility = {
+    /**
+     * 更新一条记录
+     *
+     * 发送请求以更新服务器上的指定记录，并自动同步更新结果到本地状态。
+     * 注意：此方法期望 payload 包含主键 ID 字段，以便识别要更新的记录。
+     *
+     * @param data - 包含待更新字段及其新值的对象，必须包含主键 ID。
+     * @returns 一个 Promise，解析为服务器返回的、已更新后的完整记录。
+     * @throws {KernelError} 当操作进行中或请求失败时抛出错误。
+     */
+    async update(data) {
+        // 1. 状态锁保护
+        if (this.loading) {
+            throw new KernelError('Operation in progress, please wait.', KernelErrorCode.ENTITY_OPERATION_IN_PROGRESS);
+        }
+        // 2. 发起请求
+        const options = await this.buildOptions('update', {}, data, {});
+        const context = await this.fetch('update', options);
+        const item = context.data.item;
+        this.updateItem(item);
+        this.emit('updated', item);
+        return this.item;
+    },
+};
+//# sourceMappingURL=RemoteUpdateAbility.js.map

package/dist/entity/abilities/remote/RemoteUpdateAbility.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteUpdateAbility.js","sourceRoot":"","sources":["../../../../../src/entity/abilities/remote/RemoteUpdateAbility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IAClD;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,IAAS;QAClB,WAAW;QACX,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CACjB,qCAAqC,EACrC,eAAe,CAAC,4BAA4B,CAC/C,CAAC;QACN,CAAC;QAED,UAAU;QACV,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAK,CAAC;IACtB,CAAC;CACJ,CAAC"}