nano-git 0.2.0 → 0.2.1

package/dist/workdir/core.d.mts

@@ -0,0 +1,166 @@
+import { SHA1 } from "../core/types.mjs";
+import { VirtualNotDirectoryError, VirtualNotFileError, VirtualNotSymlinkError, VirtualOriginUnavailableError, VirtualPathAlreadyExistsError, VirtualPathNotFoundError, VirtualRevertNotSupportedError } from "../core/errors.mjs";
+
+//#region src/workdir/core.d.ts
+/**
+ * 虚拟工作目录条目种类
+ *
+ * - `"blob"`: 普通文件或可执行文件（mode 100644 / 100755）
+ * - `"tree"`: 目录（mode 40000）
+ * - `"symlink"`: 符号链接（mode 120000）
+ */
+type VirtualEntryKind = "blob" | "tree" | "symlink";
+/**
+ * 虚拟路径状态信息
+ *
+ * 由 `stat()` 返回，描述路径对应的节点属性。
+ */
+interface VirtualEntryStat {
+  /** 条目种类 */
+  readonly kind: VirtualEntryKind;
+  /** Git 文件模式（如 "100644"、"100755"、"40000"、"120000"） */
+  readonly mode: string;
+  /** 文件大小（对 blob 和 symlink 有效；目录返回 0） */
+  readonly size: number;
+  /** 内容哈希（对 repo-backed 节点返回 origin 哈希；CoW 节点可能为 null） */
+  readonly hash: SHA1 | null;
+}
+/**
+ * 目录条目
+ *
+ * 由 `readdir()` 返回，描述目录下的子条目。
+ */
+interface VirtualDirEntry {
+  /** 条目名称（不含路径前缀） */
+  readonly name: string;
+  /** 条目种类 */
+  readonly kind: VirtualEntryKind;
+  /** Git 文件模式 */
+  readonly mode: string;
+}
+/**
+ * 变更操作类型
+ *
+ * 用于 `listChanges()` 返回的变更记录。
+ */
+type VirtualChangeType = "add" | "modify" | "delete" | "rename" | "copy";
+/**
+ * 单条变更记录
+ *
+ * 由 `listChanges()` 返回，描述 session 内的单次操作。
+ * 变更记录是会话内调试/测试辅助，不保证是最小 diff。
+ */
+interface VirtualChange {
+  /** 操作路径 */
+  readonly path: string;
+  /** 变更操作类型 */
+  readonly type: VirtualChangeType;
+  /** rename/copy 操作的源路径（其他操作为 undefined） */
+  readonly oldPath?: string;
+}
+/**
+ * 创建 VirtualWorkdirSession 的选项
+ */
+interface CreateVirtualWorkdirSessionOptions {
+  /** 基线 tree 的 SHA-1 哈希 */
+  readonly baseTree: SHA1;
+}
+/**
+ * VirtualWorkdirSession（虚拟工作目录会话）
+ *
+ * 提供独立生命周期的可变 tree 视图，基于 `baseTree + CoW overlay` 模型。
+ * 不绑定 commit，不涉及 Git index / 真实工作目录。
+ *
+ * @example
+ * ```ts
+ * import { createMemoryRepository } from "nano-git/repository/memory";
+ * import { createVirtualWorkdirSession } from "nano-git/workdir/memory";
+ *
+ * const repo = createMemoryRepository();
+ * const tree = repo.writeTree(); // 初始空 tree
+ * const session = createVirtualWorkdirSession(repo, { baseTree: tree });
+ *
+ * session.writeFile("hello.txt", Buffer.from("world"));
+ * const newTree = session.writeTree();
+ * ```
+ */
+interface VirtualWorkdirSession {
+  /** 当前基线 tree 的 SHA-1 哈希 */
+  readonly baseTree: SHA1;
+  /** 路径是否存在 */
+  exists(path: string): boolean;
+  /** 获取路径状态信息，不存在时返回 null */
+  stat(path: string): VirtualEntryStat | null;
+  /** 读取目录内容，根目录为 "" */
+  readdir(path?: string): VirtualDirEntry[];
+  /** 读取文件内容 */
+  readFile(path: string): Buffer;
+  /** 读取符号链接目标 */
+  readLink(path: string): string;
+  /** 写入文件（新建或覆盖） */
+  writeFile(path: string, content: Buffer, options?: {
+    readonly mode?: "100644" | "100755";
+  }): void;
+  /** 写入符号链接（新建或覆盖） */
+  writeLink(path: string, target: string): void;
+  /** 创建目录（含必要父目录） */
+  mkdir(path: string): void;
+  /** 删除路径（文件、目录或符号链接） */
+  delete(path: string): void;
+  /**
+   * 重命名路径
+   *
+   * 只做路径重绑定，不退化为 delete + write。
+   * 目录重命名后，子项保持懒加载。
+   */
+  rename(from: string, to: string): void;
+  /**
+   * 复制路径
+   *
+   * 新建 session node，共享 origin，不共享 node 身份。
+   * 目录复制为浅复制，子项保持懒加载。
+   */
+  copy(from: string, to: string): void;
+  /**
+   * 恢复路径到其 origin
+   *
+   * 仅对当前 CoW 节点恢复其 origin（repo-backed 版本）。
+   * 对纯新建节点抛出 VirtualRevertNotSupportedError。
+   */
+  revert(path: string): void;
+  /**
+   * 导出当前 overlay 为新 tree
+   *
+   * 只重新合成受影响目录，复用未修改节点的哈希。
+   * 不自动推进 baseTree。
+   */
+  writeTree(): SHA1;
+  /**
+   * 重置 session 到指定基线 tree
+   *
+   * 丢弃全部 overlay 与变更历史。
+   */
+  reset(baseTree: SHA1): void;
+  /**
+   * 列出会话内的变更记录
+   *
+   * 是会话内调试/测试辅助，不保证是最小 diff 引擎。
+   * 输出稳定、测试可断言即可。
+   */
+  listChanges(): VirtualChange[];
+}
+/**
+ * VirtualWorkdirBackend
+ *
+ * session 内部状态存储的抽象接口。
+ * memory / file / sqlite 后端通过实现此接口来提供不同的持久化策略。
+ *
+ * 本接口在后续 Phase 中会逐步补充完整方法签名。
+ * 当前仅为命名冻结与角色声明。
+ */
+interface VirtualWorkdirBackend {
+  /** 后端类型标识 */
+  readonly kind: "memory" | "file" | "sqlite";
+}
+//#endregion
+export { CreateVirtualWorkdirSessionOptions, VirtualChange, VirtualChangeType, VirtualDirEntry, VirtualEntryKind, VirtualEntryStat, VirtualNotDirectoryError, VirtualNotFileError, VirtualNotSymlinkError, VirtualOriginUnavailableError, VirtualPathAlreadyExistsError, VirtualPathNotFoundError, VirtualRevertNotSupportedError, VirtualWorkdirBackend, VirtualWorkdirSession };

package/dist/workdir/core.mjs

@@ -0,0 +1,2 @@
+import { VirtualNotDirectoryError, VirtualNotFileError, VirtualNotSymlinkError, VirtualOriginUnavailableError, VirtualPathAlreadyExistsError, VirtualPathNotFoundError, VirtualRevertNotSupportedError } from "../core/errors.mjs";
+export { VirtualNotDirectoryError, VirtualNotFileError, VirtualNotSymlinkError, VirtualOriginUnavailableError, VirtualPathAlreadyExistsError, VirtualPathNotFoundError, VirtualRevertNotSupportedError };

package/dist/workdir/ids.mjs

@@ -0,0 +1,20 @@
+//#region src/workdir/ids.ts
+/** 根目录节点的固定 ID（每个 session 一致） */
+const VIRTUAL_ROOT_NODE_ID = "root";
+let nextNodeCounter = 1;
+/**
+* 分配新的 session 节点 ID
+*/
+function createNodeId() {
+	const id = `node:${nextNodeCounter}`;
+	nextNodeCounter += 1;
+	return id;
+}
+/**
+* 为仓库对象哈希派生稳定的 session 节点 ID（懒加载、未 copy 前复用）
+*/
+function originBackedNodeId(hash) {
+	return `origin:${hash}`;
+}
+//#endregion
+export { VIRTUAL_ROOT_NODE_ID, createNodeId, originBackedNodeId };

package/dist/workdir/memory-backend.mjs

@@ -0,0 +1,21 @@
+import { VIRTUAL_ROOT_NODE_ID } from "./ids.mjs";
+import { createVirtualChangeLog } from "./change-log.mjs";
+import { createRootDirectoryNode } from "./nodes.mjs";
+//#region src/workdir/memory-backend.ts
+/**
+* Virtual Workdir 会话内存状态（与 ODB 后端无关的纯状态容器）
+*/
+/**
+* 创建初始 session 状态（仅根目录节点，绑定 baseTree origin）
+*/
+function createVirtualWorkdirMemoryState(baseTree) {
+	const nodes = /* @__PURE__ */ new Map();
+	nodes.set(VIRTUAL_ROOT_NODE_ID, createRootDirectoryNode(baseTree));
+	return {
+		baseTree,
+		nodes,
+		changeLog: createVirtualChangeLog()
+	};
+}
+//#endregion
+export { createVirtualWorkdirMemoryState };

package/dist/workdir/memory.d.mts

@@ -0,0 +1,2 @@
+import { createVirtualWorkdirSession } from "./session.mjs";
+export { createVirtualWorkdirSession };

package/dist/workdir/memory.mjs

@@ -0,0 +1,2 @@
+import { createVirtualWorkdirSession } from "./session.mjs";
+export { createVirtualWorkdirSession };

package/dist/workdir/nodes.mjs

@@ -0,0 +1,112 @@
+import { VIRTUAL_ROOT_NODE_ID } from "./ids.mjs";
+import { cloneDirectoryOverlay, createEmptyDirectoryOverlay } from "./overlay.mjs";
+//#region src/workdir/nodes.ts
+/**
+* Virtual Workdir 会话节点状态模型
+*
+* 节点身份（nodeId）与目录路径绑定分离；origin 描述 repo-backed 来源。
+*/
+/**
+* 创建绑定 repo 根 tree 的目录节点（带空 overlay）
+*/
+function createRootDirectoryNode(originTreeHash) {
+	return {
+		id: VIRTUAL_ROOT_NODE_ID,
+		origin: {
+			kind: "repo-tree",
+			hash: originTreeHash
+		},
+		state: {
+			kind: "directory",
+			overlay: createEmptyDirectoryOverlay()
+		}
+	};
+}
+/**
+* 节点是否携带可 revert 的 repo origin
+*/
+function nodeHasRepoOrigin(node) {
+	return node.origin.kind === "repo-tree" || node.origin.kind === "repo-blob";
+}
+/**
+* 目录 overlay 是否有 session 层修改
+*/
+function isDirectoryOverlayDirty(overlay) {
+	return overlay.addedEntries.size > 0 || overlay.deletedNames.size > 0;
+}
+/**
+* 将节点状态恢复到 origin 语义（丢弃 materialize / 目录 overlay）
+*
+* 无 repo origin 时返回原状态引用，由上层决定是否抛错。
+*/
+function revertNodeState(node) {
+	if (!nodeHasRepoOrigin(node)) return node;
+	if (node.state.kind === "directory") return {
+		...node,
+		state: {
+			kind: "directory",
+			overlay: createEmptyDirectoryOverlay()
+		}
+	};
+	if (node.state.kind === "file") {
+		const mode = node.state.mode;
+		return {
+			...node,
+			state: {
+				kind: "file",
+				mode
+			}
+		};
+	}
+	return {
+		...node,
+		state: {
+			kind: "symlink",
+			mode: "120000"
+		}
+	};
+}
+/**
+* 为 `copy` 创建新节点：共享 origin，目录为浅复制（子项绑定保留，但 nodeId 为新）
+*/
+function cloneSessionNodeForCopy(source, newId) {
+	const origin = source.origin;
+	if (source.state.kind === "directory") return {
+		id: newId,
+		origin,
+		state: {
+			kind: "directory",
+			overlay: cloneDirectoryOverlay(source.state.overlay)
+		}
+	};
+	if (source.state.kind === "file") {
+		const content = source.state.content;
+		return {
+			id: newId,
+			origin,
+			state: content === void 0 ? {
+				kind: "file",
+				mode: source.state.mode
+			} : {
+				kind: "file",
+				mode: source.state.mode,
+				content: Buffer.from(content)
+			}
+		};
+	}
+	const target = source.state.target;
+	return {
+		id: newId,
+		origin,
+		state: target === void 0 ? {
+			kind: "symlink",
+			mode: "120000"
+		} : {
+			kind: "symlink",
+			mode: "120000",
+			target: Buffer.from(target)
+		}
+	};
+}
+//#endregion
+export { cloneSessionNodeForCopy, createRootDirectoryNode, isDirectoryOverlayDirty, revertNodeState };

package/dist/workdir/origin.mjs

@@ -0,0 +1,55 @@
+import { VirtualOriginUnavailableError } from "../core/errors.mjs";
+import { tryReadObject } from "../objects/raw.mjs";
+//#region src/workdir/origin.ts
+/**
+* 从对象源读取 repo-backed origin（tree/blob）
+*
+* 仅依赖 ObjectSource，不绑定具体 ODB 后端实现。
+*/
+/**
+* 读取 tree 对象；缺失时抛 VirtualOriginUnavailableError
+*/
+function readRepoTree(source, hash, path) {
+	const obj = tryReadObject(source, hash);
+	if (obj === void 0) throw new VirtualOriginUnavailableError(path, `Origin tree object missing: ${hash}`);
+	if (obj.type !== "tree") throw new VirtualOriginUnavailableError(path, `Expected tree at origin, got ${obj.type}`);
+	return obj;
+}
+/**
+* 读取 blob 原始内容；缺失时抛 VirtualOriginUnavailableError
+*/
+function readRepoBlobContent(source, hash, path) {
+	const obj = tryReadObject(source, hash);
+	if (obj === void 0) throw new VirtualOriginUnavailableError(path, `Origin blob object missing: ${hash}`);
+	if (obj.type !== "blob") throw new VirtualOriginUnavailableError(path, `Expected blob at origin, got ${obj.type}`);
+	return obj.content;
+}
+/**
+* 根据 tree 条目构造节点 origin
+*/
+function treeEntryToNodeOrigin(entry) {
+	if (entry.mode === "40000") return {
+		kind: "repo-tree",
+		hash: entry.hash
+	};
+	if (entry.mode === "100644" || entry.mode === "100755" || entry.mode === "120000") return {
+		kind: "repo-blob",
+		mode: entry.mode,
+		hash: entry.hash
+	};
+	return {
+		kind: "repo-blob",
+		mode: "100644",
+		hash: entry.hash
+	};
+}
+/**
+* Git mode 转为 VirtualEntryKind
+*/
+function modeToVirtualEntryKind(mode) {
+	if (mode === "40000") return "tree";
+	if (mode === "120000") return "symlink";
+	return "blob";
+}
+//#endregion
+export { modeToVirtualEntryKind, readRepoBlobContent, readRepoTree, treeEntryToNodeOrigin };

package/dist/workdir/overlay.mjs

@@ -0,0 +1,95 @@
+//#region src/workdir/overlay.ts
+/**
+* 创建空目录 overlay
+*/
+function createEmptyDirectoryOverlay() {
+	return {
+		addedEntries: /* @__PURE__ */ new Map(),
+		deletedNames: /* @__PURE__ */ new Set()
+	};
+}
+/**
+* 克隆目录 overlay（深拷贝 Map/Set）
+*/
+function cloneDirectoryOverlay(overlay) {
+	return {
+		addedEntries: new Map(overlay.addedEntries),
+		deletedNames: new Set(overlay.deletedNames)
+	};
+}
+/**
+* 按 RFC 规则合成目录子项列表
+*
+* 1. 从 origin 去掉 deletedNames
+* 2. addedEntries 覆盖同名 origin
+* 3. 仅存在于 addedEntries 的条目追加
+* 4. 按 Git tree 名称排序
+*/
+function mergeDirectoryChildren(originChildren, overlay, addedEntryModes) {
+	const byName = /* @__PURE__ */ new Map();
+	for (const child of originChildren) {
+		if (overlay.deletedNames.has(child.name)) continue;
+		const overrideId = overlay.addedEntries.get(child.name);
+		if (overrideId !== void 0) {
+			const mode = addedEntryModes.get(child.name) ?? child.mode;
+			byName.set(child.name, {
+				name: child.name,
+				mode,
+				nodeId: overrideId
+			});
+		} else byName.set(child.name, {
+			name: child.name,
+			mode: child.mode,
+			nodeId: child.nodeId
+		});
+	}
+	for (const [name, nodeId] of overlay.addedEntries) {
+		if (byName.has(name)) continue;
+		const mode = addedEntryModes.get(name);
+		if (mode === void 0) throw new Error(`Missing mode for added directory entry '${name}'`);
+		byName.set(name, {
+			name,
+			mode,
+			nodeId
+		});
+	}
+	const merged = Array.from(byName.values());
+	merged.sort((a, b) => a.name.localeCompare(b.name));
+	return merged;
+}
+/**
+* 在目录 overlay 中绑定或覆盖条目（create / modify / rename 目标 / copy 目标）
+*/
+function overlayBindEntry(overlay, name, nodeId) {
+	const addedEntries = new Map(overlay.addedEntries);
+	const deletedNames = new Set(overlay.deletedNames);
+	addedEntries.set(name, nodeId);
+	deletedNames.delete(name);
+	return {
+		addedEntries,
+		deletedNames
+	};
+}
+/**
+* 在目录 overlay 中删除条目（tombstone；不递归清理子节点存储）
+*/
+function overlayTombstoneEntry(overlay, name) {
+	const addedEntries = new Map(overlay.addedEntries);
+	const deletedNames = new Set(overlay.deletedNames);
+	if (addedEntries.has(name)) addedEntries.delete(name);
+	else deletedNames.add(name);
+	return {
+		addedEntries,
+		deletedNames
+	};
+}
+/**
+* 在同一目录内重命名：复用 nodeId，仅改绑定名
+*/
+function overlayRenameEntry(overlay, fromName, toName, nodeId) {
+	let next = overlayTombstoneEntry(overlay, fromName);
+	next = overlayBindEntry(next, toName, nodeId);
+	return next;
+}
+//#endregion
+export { cloneDirectoryOverlay, createEmptyDirectoryOverlay, mergeDirectoryChildren, overlayBindEntry, overlayRenameEntry, overlayTombstoneEntry };

package/dist/workdir/path.mjs

@@ -0,0 +1,70 @@
+/**
+* 规范化 readdir 等 API 的目录路径参数
+*
+* `undefined` 与 `""` 均视为根目录。
+*/
+function normalizeDirectoryPath(path) {
+	if (path === void 0 || path === "") return "";
+	assertValidVirtualPath(path);
+	return path;
+}
+/**
+* 校验非根虚拟路径格式（用于文件/子路径操作）
+*
+* @throws 路径为空或格式非法时抛出 Error
+*/
+function assertValidVirtualPath(path) {
+	if (path === "") throw new Error("Path must not be empty");
+	validateVirtualPathSegments(path);
+}
+/**
+* 校验路径段规则（根路径 `""` 由调用方单独处理）
+*/
+function validateVirtualPathSegments(path) {
+	if (path.startsWith("/")) throw new Error(`Path must not start with '/': ${path}`);
+	if (path.endsWith("/")) throw new Error(`Path must not end with '/': ${path}`);
+	if (path.includes("//")) throw new Error(`Path must not contain consecutive slashes: ${path}`);
+	for (const segment of path.split("/")) {
+		if (segment === "." || segment === "..") throw new Error(`Path must not contain '.' or '..': ${path}`);
+		if (segment === "") throw new Error(`Path must not contain empty segments: ${path}`);
+	}
+}
+/**
+* 将路径拆分为段（不含空段）
+*
+* 调用前须保证路径已通过 `assertValidVirtualPath`。
+*/
+function splitPathSegments(path) {
+	return path.split("/");
+}
+/**
+* 返回父路径；单段路径返回 `null`（表示无父目录，父为根）
+*/
+function parentPath(path) {
+	assertValidVirtualPath(path);
+	const lastSlash = path.lastIndexOf("/");
+	if (lastSlash === -1) return null;
+	return path.slice(0, lastSlash);
+}
+/**
+* 返回路径最后一段（条目名）
+*/
+function baseName(path) {
+	assertValidVirtualPath(path);
+	const lastSlash = path.lastIndexOf("/");
+	return lastSlash === -1 ? path : path.slice(lastSlash + 1);
+}
+/**
+* 组合父路径与条目名
+*
+* @param parent - `null` 表示根下直接子项
+*/
+function joinPath(parent, name) {
+	if (name === "" || name.includes("/")) throw new Error(`Invalid entry name: ${name}`);
+	if (parent === null) return name;
+	if (parent === "") return name;
+	assertValidVirtualPath(parent);
+	return `${parent}/${name}`;
+}
+//#endregion
+export { assertValidVirtualPath, baseName, joinPath, normalizeDirectoryPath, parentPath, splitPathSegments };

package/dist/workdir/session-internal.mjs

@@ -0,0 +1,141 @@
+import { VirtualNotDirectoryError } from "../core/errors.mjs";
+import { VIRTUAL_ROOT_NODE_ID, originBackedNodeId } from "./ids.mjs";
+import { mergeDirectoryChildren } from "./overlay.mjs";
+import { readRepoTree, treeEntryToNodeOrigin } from "./origin.mjs";
+import { assertValidVirtualPath, joinPath, splitPathSegments } from "./path.mjs";
+//#region src/workdir/session-internal.ts
+/**
+* Virtual Workdir session 内部共享逻辑
+*
+* 供 session.ts 与 write-tree.ts 复用：
+* - 路径解析（resolvePath）
+* - 目录子项展开（listDirectoryChildren）
+* - origin 节点懒注册（ensureNodeFromTreeEntry）
+*/
+function getRootNode(state) {
+	const root = state.nodes.get(VIRTUAL_ROOT_NODE_ID);
+	if (root === void 0) throw new Error("Virtual workdir session is missing root node");
+	return root;
+}
+/**
+* 从根目录沿路径分段解析到目标节点
+*/
+function resolvePath(source, state, path) {
+	assertValidVirtualPath(path);
+	const segments = splitPathSegments(path);
+	let current = getRootNode(state);
+	let currentPath = "";
+	for (const segment of segments) {
+		if (current.state.kind !== "directory") return {
+			found: false,
+			node: null
+		};
+		const child = listDirectoryChildren(source, state, current, currentPath).find((c) => c.name === segment);
+		if (child === void 0) return {
+			found: false,
+			node: null
+		};
+		currentPath = joinPath(currentPath === "" ? null : currentPath, segment);
+		const childNode = state.nodes.get(child.nodeId);
+		if (childNode === void 0) return {
+			found: false,
+			node: null
+		};
+		current = childNode;
+	}
+	return {
+		found: true,
+		node: current
+	};
+}
+/**
+* 根据父节点与子条目名解析子节点
+*/
+function resolveChild(source, state, parentNode, parentPath, name) {
+	if (parentNode.state.kind !== "directory") return {
+		found: false,
+		node: null
+	};
+	const child = listDirectoryChildren(source, state, parentNode, parentPath).find((c) => c.name === name);
+	if (child === void 0) return {
+		found: false,
+		node: null
+	};
+	const childNode = state.nodes.get(child.nodeId);
+	if (childNode === void 0) return {
+		found: false,
+		node: null
+	};
+	return {
+		found: true,
+		node: childNode
+	};
+}
+/**
+* 确保 origin 条目对应的 session 节点已懒注册
+*/
+function ensureNodeFromTreeEntry(state, entry) {
+	const id = originBackedNodeId(entry.hash);
+	if (!state.nodes.has(id)) {
+		const origin = treeEntryToNodeOrigin(entry);
+		let nodeState;
+		if (entry.mode === "40000") nodeState = {
+			kind: "directory",
+			overlay: {
+				addedEntries: /* @__PURE__ */ new Map(),
+				deletedNames: /* @__PURE__ */ new Set()
+			}
+		};
+		else if (entry.mode === "120000") nodeState = {
+			kind: "symlink",
+			mode: "120000"
+		};
+		else nodeState = {
+			kind: "file",
+			mode: entry.mode === "100755" ? "100755" : "100644"
+		};
+		state.nodes.set(id, {
+			id,
+			origin,
+			state: nodeState
+		});
+	}
+	return id;
+}
+/**
+* 展开目录的完整子项列表（origin + overlay 合成）
+*/
+function listDirectoryChildren(source, state, dirNode, dirPath) {
+	if (dirNode.state.kind !== "directory") throw new VirtualNotDirectoryError(dirPath);
+	let originChildren = [];
+	if (dirNode.origin.kind === "repo-tree") originChildren = readRepoTree(source, dirNode.origin.hash, dirPath).entries.map((entry) => {
+		const childNodeId = ensureNodeFromTreeEntry(state, entry);
+		return {
+			name: entry.name,
+			mode: entry.mode,
+			nodeId: childNodeId
+		};
+	});
+	const addedModes = buildAddedModes(state, dirNode);
+	return mergeDirectoryChildren(originChildren, dirNode.state.overlay, addedModes);
+}
+/**
+* 构建 overlay addedEntries 对应的 mode map
+*/
+function buildAddedModes(state, dirNode) {
+	if (dirNode.state.kind !== "directory") return /* @__PURE__ */ new Map();
+	const addedModes = /* @__PURE__ */ new Map();
+	for (const name of dirNode.state.overlay.addedEntries.keys()) {
+		const nodeId = dirNode.state.overlay.addedEntries.get(name);
+		const node = state.nodes.get(nodeId);
+		if (node !== void 0) addedModes.set(name, sessionNodeMode(node));
+	}
+	return addedModes;
+}
+function sessionNodeMode(node) {
+	if (node.state.kind === "directory") return "40000";
+	if (node.state.kind === "symlink") return "120000";
+	return node.state.mode;
+}
+//#endregion
+export { listDirectoryChildren, resolveChild, resolvePath };