nano-git 0.1.0 → 0.2.1

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 };

package/dist/workdir/session.d.mts

@@ -0,0 +1,18 @@
+import { ObjectDatabase } from "../core/types/odb.mjs";
+import { CreateVirtualWorkdirSessionOptions, VirtualWorkdirSession } from "./core.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;
+//#endregion
+export { createVirtualWorkdirSession };