nano-git 0.3.1 → 0.3.2

package/dist/workdir/{session-internal.mjs → workdir-path.mjs}

@@ -1,13 +1,13 @@
 import { VirtualNotDirectoryError, VirtualNotFileError, VirtualPathAlreadyExistsError, VirtualPathNotFoundError } 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 { mergeDirectoryChildren } from "./overlay.mjs";
 import { assertValidVirtualPath, baseName, joinPath, parentPath, splitPathSegments } from "./path.mjs";
-//#region src/workdir/session-internal.ts
+//#region src/workdir/workdir-path.ts
 /**
-* Virtual Workdir session 内部共享逻辑
+* Virtual Workdir 路径解析与共享读视图
 *
-* 供 session.ts 与 write-tree.ts 复用：
+* 供 workdir.ts 与 write-tree.ts 复用：
 * - 路径解析（resolvePath / resolveWriteTarget*）
 * - 目录子项展开（listDirectoryChildren / getDirectoryChildrenView）
 * - origin 节点懒注册（ensureNodeFromTreeEntry）
@@ -28,7 +28,7 @@ function joinChildPath(dirPath, name) {
 }
 function getRootNode(state) {
 	const root = state.getNode(VIRTUAL_ROOT_NODE_ID);
-	if (root === null) throw new Error("Virtual workdir session is missing root node");
+	if (root === null) throw new Error("Virtual workdir is missing root node");
 	return root;
 }
 /**
@@ -265,7 +265,7 @@ function resolvePathByParentLookup(source, state, path) {
 	};
 }
 /**
-* 确保 origin 条目对应的 session 节点已懒注册
+* 确保 origin 条目对应的 workdir 节点已懒注册
 */
 function ensureNodeFromTreeEntry(state, entry) {
 	const id = originBackedNodeId(entry.hash);
@@ -321,11 +321,11 @@ function buildAddedModes(state, dirNode) {
 	for (const name of dirNode.state.overlay.addedEntries.keys()) {
 		const nodeId = dirNode.state.overlay.addedEntries.get(name);
 		const node = state.getNode(nodeId);
-		if (node !== null) addedModes.set(name, sessionNodeMode(node));
+		if (node !== null) addedModes.set(name, workdirNodeMode(node));
 	}
 	return addedModes;
 }
-function sessionNodeMode(node) {
+function workdirNodeMode(node) {
 	if (node.state.kind === "directory") return "40000";
 	if (node.state.kind === "symlink") return "120000";
 	return node.state.mode;

package/dist/workdir/{session-transaction.mjs → workdir-transaction.mjs}

@@ -1,14 +1,14 @@
 import { createNodeId } from "./ids.mjs";
-import { overlayBindEntry } from "./overlay.mjs";
-import { cloneSessionNodeForCopy } from "./nodes.mjs";
 import { readRepoBlobContent } from "./origin.mjs";
-import { listDirectoryChildren } from "./session-internal.mjs";
+import { overlayBindEntry } from "./overlay.mjs";
+import { listDirectoryChildren } from "./workdir-path.mjs";
 import { observeListedDirectoryChild } from "./directory-view.mjs";
-//#region src/workdir/session-transaction.ts
+import { cloneWorkdirNodeForCopy } from "./nodes.mjs";
+//#region src/workdir/workdir-transaction.ts
 /**
-* Virtual Workdir 事务包装与会话辅助函数
+* Virtual Workdir 写事务与节点辅助函数
 *
-* 从 session.ts 提取，降低编排层的复杂度：
+* 从 workdir.ts 提取，降低编排层复杂度：
 * - 写操作事务生命周期管理
 * - 父目录 overlay 更新
 * - 节点状态统计（stat）
@@ -17,7 +17,7 @@ import { observeListedDirectoryChild } from "./directory-view.mjs";
 /**
 * 在 state store 事务边界内执行写操作。
 *
-* @param state - session 内部状态存储
+* @param state - workdir 内部状态存储
 * @param onBeforeCommit - 提交前回调（在事务 callback 内执行）；可为 null
 * @param onCommitted - 提交后回调（在事务 callback 外执行）
 * @param fn - 实际写入逻辑
@@ -46,7 +46,7 @@ function updateParentOverlay(state, parentId, newOverlay) {
 	});
 }
 /**
-* 获取节点统计信息（用于 session.stat() 实现）
+* 获取节点统计信息（用于 workdir.stat() 实现）
 */
 function statNode(source, node, path) {
 	if (node.state.kind === "directory") return statDirectoryNode(node);
@@ -91,7 +91,7 @@ function statDirectoryNode(node) {
 */
 function cloneNodeGraphForCopy(source, state, node, path) {
 	const newNodeId = createNodeId();
-	const cloned = cloneSessionNodeForCopy(node, newNodeId);
+	const cloned = cloneWorkdirNodeForCopy(node, newNodeId);
 	state.setNode(cloned);
 	if (node.state.kind !== "directory" || cloned.state.kind !== "directory") return newNodeId;
 	let overlay = cloned.state.overlay;

package/dist/workdir/workdir.d.mts

@@ -0,0 +1,30 @@
+import { ObjectDatabase } from "../core/types/odb.mjs";
+import { CreateVirtualWorkdirOptions, VirtualWorkdir } from "./core.mjs";
+import { VirtualWorkdirStateStore } from "./state-store.mjs";
+
+//#region src/workdir/workdir.d.ts
+/**
+ * 基于 ObjectDatabase 创建 VirtualWorkdir
+ *
+ * @example
+ * ```ts
+ * const repo = createMemoryRepository();
+ * const tree = repo.createTree([]);
+ * const workdir = createVirtualWorkdir(repo.objects, { baseTree: tree });
+ * expect(workdir.readdir()).toEqual([]);
+ * ```
+ */
+declare function createVirtualWorkdir(source: ObjectDatabase, options: CreateVirtualWorkdirOptions): VirtualWorkdir;
+/**
+ * 基于已有状态存储打开 VirtualWorkdir
+ *
+ * @example
+ * ```ts
+ * const store = createVirtualWorkdirMemoryStateStore(tree);
+ * const workdir = openVirtualWorkdir(repo.objects, store);
+ * expect(workdir.baseTree).toBe(tree);
+ * ```
+ */
+declare function openVirtualWorkdir(source: ObjectDatabase, state: VirtualWorkdirStateStore): VirtualWorkdir;
+//#endregion
+export { createVirtualWorkdir, openVirtualWorkdir };

package/dist/workdir/{session.mjs → workdir.mjs}

@@ -1,47 +1,47 @@
 import { VirtualNotDirectoryError, VirtualNotFileError, VirtualNotSymlinkError, VirtualPathAlreadyExistsError, VirtualPathNotFoundError, VirtualRevertNotSupportedError } from "../core/errors.mjs";
 import { createNodeId } from "./ids.mjs";
-import { overlayBindEntry, overlayRenameEntry, overlayTombstoneEntry } from "./overlay.mjs";
-import { revertNodeState } from "./nodes.mjs";
 import { modeToVirtualEntryKind, readRepoBlobContent } from "./origin.mjs";
+import { overlayBindEntry, overlayRenameEntry, overlayTombstoneEntry } from "./overlay.mjs";
 import { assertValidVirtualPath, normalizeDirectoryPath } from "./path.mjs";
-import { getDirectoryChildrenView, getRootNode, requireExistingWriteTarget, requireMissingWriteTarget, resolveLeafWriteTarget, resolvePath, resolveWriteTransfer } from "./session-internal.mjs";
+import { getDirectoryChildrenView, getRootNode, requireExistingWriteTarget, requireMissingWriteTarget, resolveLeafWriteTarget, resolvePath, resolveWriteTransfer } from "./workdir-path.mjs";
 import { createChangeIndexPlanner } from "./change-index-plan.mjs";
 import { computeVirtualDiff, rebuildNormalizedChangeIndex, refreshChangeRecordForPath, replaceChangeRecords, rewriteChangeRecordForRename, writeChangeRecordForCopy } from "./change-index.mjs";
 import { createDirtyDirPlanner } from "./dirty-dir-plan.mjs";
-import { cloneNodeGraphForCopy, runInWriteTransaction, statDirectoryNode, statNode, updateParentOverlay } from "./session-transaction.mjs";
-import { writeTreeFromSession } from "./write-tree.mjs";
+import { revertNodeState } from "./nodes.mjs";
 import { createVirtualWorkdirMemoryStateStore } from "./memory-backend.mjs";
-//#region src/workdir/session.ts
+import { cloneNodeGraphForCopy, runInWriteTransaction, statDirectoryNode, statNode, updateParentOverlay } from "./workdir-transaction.mjs";
+import { writeTreeFromSession } from "./write-tree.mjs";
+//#region src/workdir/workdir.ts
 /**
-* VirtualWorkdirSession 行为编排
+* VirtualWorkdir 行为编排
 *
 * Phase 5：完整文件/目录 rename 与 copy 语义。
 */
 /**
-* 基于 ObjectDatabase 创建 VirtualWorkdirSession
+* 基于 ObjectDatabase 创建 VirtualWorkdir
 *
 * @example
 * ```ts
 * const repo = createMemoryRepository();
 * const tree = repo.createTree([]);
-* const session = createVirtualWorkdirSession(repo.objects, { baseTree: tree });
-* expect(session.readdir()).toEqual([]);
+* const workdir = createVirtualWorkdir(repo.objects, { baseTree: tree });
+* expect(workdir.readdir()).toEqual([]);
 * ```
 */
-function createVirtualWorkdirSession(source, options) {
-	return openVirtualWorkdirSession(source, createVirtualWorkdirMemoryStateStore(options.baseTree));
+function createVirtualWorkdir(source, options) {
+	return openVirtualWorkdir(source, createVirtualWorkdirMemoryStateStore(options.baseTree));
 }
 /**
-* 基于已有状态存储打开 session
+* 基于已有状态存储打开 VirtualWorkdir
 *
 * @example
 * ```ts
 * const store = createVirtualWorkdirMemoryStateStore(tree);
-* const session = openVirtualWorkdirSession(repo.objects, store);
-* expect(session.baseTree).toBe(tree);
+* const workdir = openVirtualWorkdir(repo.objects, store);
+* expect(workdir.baseTree).toBe(tree);
 * ```
 */
-function openVirtualWorkdirSession(source, state) {
+function openVirtualWorkdir(source, state) {
 	const currentNodeHashes = /* @__PURE__ */ new Map();
 	const invalidateDiffCaches = () => {
 		currentNodeHashes.clear();
@@ -277,4 +277,4 @@ function openVirtualWorkdirSession(source, state) {
 	};
 }
 //#endregion
-export { createVirtualWorkdirSession, openVirtualWorkdirSession };
+export { createVirtualWorkdir, openVirtualWorkdir };

package/dist/workdir/write-tree.mjs

@@ -1,25 +1,25 @@
 import { writeObject } from "../objects/raw.mjs";
 import { readRepoTree } from "./origin.mjs";
-import { listDirectoryChildren } from "./session-internal.mjs";
+import { listDirectoryChildren } from "./workdir-path.mjs";
 import { createNamedOriginChildLookup, observeListedDirectoryChild, observeNamedDirectoryChild, planAffectedDirectoryChildren } from "./directory-view.mjs";
 import { materializeDirtyDirSummary } from "./dirty-dir.mjs";
 //#region src/workdir/write-tree.ts
 /**
 * Virtual Workdir overlay -> tree 最小化编译
 *
-* 遍历 session 的目录 overlay，将受影响的目录重写为新 tree，
+* 遍历 workdir 的目录 overlay，将受影响的目录重写为新 tree，
 * 未修改的 repo-backed 子树/文件尽量复用原对象哈希。
 *
 * writeTree() 成功后不清空 overlay，不推进 baseTree。
 */
 /**
-* 将当前 session 状态编译为新的根 tree
+* 将当前 workdir 状态编译为新的根 tree
 *
 * 只重写受 overlay 影响的目录；文件/符号链接仅在 materialized 时写新 blob。
 * 未修改的 repo-backed 条目直接复用 origin hash。
 *
 * @param source - 可写对象数据库（用于写入新 blob/tree）
-* @param state - session 内存状态
+* @param state - workdir 内部状态
 * @returns 新根 tree 的 SHA-1
 *
 * @example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nano-git",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "files": [
     "dist"
   ],

package/dist/workdir/memory-backend.d.mts

@@ -1,17 +0,0 @@
-import { VirtualWorkdirBackend } from "./core.mjs";
-
-//#region src/workdir/memory-backend.d.ts
-/**
- * 创建内存版 Virtual Workdir backend
- *
- * @example
- * ```ts
- * const backend = createMemoryVirtualWorkdirBackend();
- * const sessionId = backend.createSession({ baseTree: tree });
- * const session = backend.openSession(repo.objects, sessionId);
- * expect(session.baseTree).toBe(tree);
- * ```
- */
-declare function createMemoryVirtualWorkdirBackend(): VirtualWorkdirBackend;
-//#endregion
-export { createMemoryVirtualWorkdirBackend };

package/dist/workdir/session-id.mjs

@@ -1,18 +0,0 @@
-//#region src/workdir/session-id.ts
-let nextSessionCounter = 1;
-/**
-* 分配新的 session ID
-*
-* @example
-* ```ts
-* const sessionId = createVirtualWorkdirSessionId();
-* expect(String(sessionId).startsWith("session:")).toBe(true);
-* ```
-*/
-function createVirtualWorkdirSessionId() {
-	const id = `session:${nextSessionCounter}`;
-	nextSessionCounter += 1;
-	return id;
-}
-//#endregion
-export { createVirtualWorkdirSessionId };

package/dist/workdir/session.d.mts

@@ -1,30 +0,0 @@
-import { ObjectDatabase } from "../core/types/odb.mjs";
-import { CreateVirtualWorkdirSessionOptions, VirtualWorkdirSession } from "./core.mjs";
-import { VirtualWorkdirStateStore } from "./state-store.mjs";
-
-//#region src/workdir/session.d.ts
-/**
- * 基于 ObjectDatabase 创建 VirtualWorkdirSession
- *
- * @example
- * ```ts
- * const repo = createMemoryRepository();
- * const tree = repo.createTree([]);
- * const session = createVirtualWorkdirSession(repo.objects, { baseTree: tree });
- * expect(session.readdir()).toEqual([]);
- * ```
- */
-declare function createVirtualWorkdirSession(source: ObjectDatabase, options: CreateVirtualWorkdirSessionOptions): VirtualWorkdirSession;
-/**
- * 基于已有状态存储打开 session
- *
- * @example
- * ```ts
- * const store = createVirtualWorkdirMemoryStateStore(tree);
- * const session = openVirtualWorkdirSession(repo.objects, store);
- * expect(session.baseTree).toBe(tree);
- * ```
- */
-declare function openVirtualWorkdirSession(source: ObjectDatabase, state: VirtualWorkdirStateStore): VirtualWorkdirSession;
-//#endregion
-export { createVirtualWorkdirSession, openVirtualWorkdirSession };