tbdb 0.0.0 → 0.0.5

package/dist/extension/tree/util/resolveOverwriteNodes.d.ts

@@ -0,0 +1,26 @@
+import type { TableTree } from "../TableTree";
+import type { ITreeNode, ITreeOverwriteOptions } from "../tree.types";
+export interface IResolveOverwriteNodesOptions extends ITreeOverwriteOptions {
+    /** move 模式下忽略当前正在移动的节点自身冲突。 */
+    ignoreNodeIds?: string[];
+}
+export interface IResolveOverwriteNodesResult<TNode extends ITreeNode = ITreeNode> {
+    /** 可以继续写入或移动的节点。 */
+    nodes: TNode[];
+    /** 被跳过的节点。 */
+    skippedNodes: TNode[];
+    /** 需要先删除的冲突节点 ID。 */
+    deleteNodeIds: string[];
+    /** replace 类覆盖中，来源节点和被覆盖目标节点的对应关系。 */
+    replacePairs: {
+        sourceNode: TNode;
+        targetNode: TNode;
+    }[];
+    /** 需要递归合并的目录节点对。 */
+    mergePairs: {
+        sourceNode: TNode;
+        targetNode: TNode;
+    }[];
+}
+/** 解析覆盖策略，返回后续写入、跳过、删除和合并计划。 */
+export declare function resolveOverwriteNodes<TNode extends ITreeNode>(table: TableTree<TNode>, parentId: string, nodes: TNode[], options?: IResolveOverwriteNodesOptions): Promise<IResolveOverwriteNodesResult<TNode>>;

package/dist/extension/tree/util/resolveTreeIndex.d.ts

@@ -0,0 +1,4 @@
+import type { TableTree } from "../TableTree";
+import type { ITreeIndexOptions, ITreeNode } from "../tree.types";
+/** 为同一父级下的一批节点计算写入 index。 */
+export declare function resolveTreeIndexes<TNode extends ITreeNode>(table: TableTree<TNode>, parentId: string, count: number, options?: ITreeIndexOptions): Promise<string[]>;

package/dist/extension/tree/util/setTreeNumberStat.d.ts

@@ -0,0 +1,9 @@
+import type { ITreeNodeMetadataKeys } from "../tree.types";
+type TreeNumberStatKey = keyof ITreeNodeMetadataKeys;
+/**
+ * 目录统计字段保持 0 值不落库的历史语义：有值则 set，无值则 unset。
+ *
+ * 这样可以让空目录保持字段精简，同时所有 metadata 刷新入口都使用同一套 0 值处理规则。
+ */
+export declare function setTreeNumberStat($set: Record<string, any>, $unset: Record<string, true>, key: TreeNumberStatKey, value: number): void;
+export {};

package/dist/extension/tree/util/stripTreeManagedFields.d.ts

@@ -0,0 +1,5 @@
+import type { ITreeNode } from "../tree.types";
+/** 移除由目录树内部维护的统计字段，避免外部写入破坏树结构元数据。 */
+export declare function stripTreeManagedFields<T extends Record<string, any>>(data: T): Partial<T>;
+/** 判断字段是否属于目录树内部维护的统计字段。 */
+export declare function isTreeManagedField(field: keyof ITreeNode | string): boolean;

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export { defineTable } from "./core/defineTable";
 export { SQLiteAdapter } from "./adapter/SQLite";
 export { MongoDBAdapter } from "./adapter/MongoDB";
 export { defineGlobalDBAdapter } from "./core/defineTable";
+export { TableTree } from "./extension/tree";
 export { TableJSON } from "fzz/src/objects/funcs/TableJSON";