@openfairygui/backend 0.2.0-alpha.29 → 0.2.0-alpha.30

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_runtime = require("./runtime-BxbnisWJ.cjs");
+const require_runtime = require("./runtime-CcBLI-J7.cjs");
 //#region src/storage.ts
 var StorageFileStat = class {
 	constructor(kind) {
@@ -72,6 +72,7 @@ async function inferStat(storage, filePath) {
 }
 function createBackendStorageFileSystem(storage) {
 	if (typeof storage.unlink !== "function") throw createPathError("ENOTSUP", "Storage adapter must provide unlink() for project resource lifecycle writes.");
+	if (typeof storage.rmdir !== "function") throw createPathError("ENOTSUP", "Storage adapter must provide rmdir() for project resource folder lifecycle writes.");
 	const lockedPaths = /* @__PURE__ */ new Set();
 	const fileSystem = {
 		stat(filePath) {
@@ -131,6 +132,9 @@ function createBackendStorageFileSystem(storage) {
 			lockedPaths.delete(resolved);
 			return storage.unlink(resolved);
 		},
+		rmdir(dirPath) {
+			return storage.rmdir(fileSystem.resolve(dirPath));
+		},
 		join(...paths) {
 			return storage.join ? storage.join(...paths) : joinStoragePath(...paths);
 		},

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { $ as BACKEND_COMPATIBILITY_POLICY, A as BackendSessionSnapshot, B as ListJobsInput, C as BackendJobNotFoundError, D as BackendProjectSessionStorage, E as BackendJobStatus, F as GetCacheSnapshotInput, G as OpenProjectSessionInput, H as MaterializeSessionSnapshot, I as GetEventsInput, J as SaveSessionInput, K as RefreshCacheInput, L as GetEventsSnapshot, M as CacheRefreshFailedError, N as CancelJobInput, O as BackendResult, P as EventCursorInvalidError, Q as BACKEND_CAPABILITY_SCHEMA_VERSION, R as GetJobInput, S as BackendJobNotCancellableError, T as BackendJobSnapshot, U as MaterializeValidationFailedError, V as MaterializeSessionInput, W as MaterializeWriteFailedError, X as SessionStaleWriteError, Y as SessionNotFoundError, Z as UamFidelityUnsupportedError, _ as BackendHostAdapter, a as BackendCacheEntry, b as BackendJobListSnapshot, c as BackendCapabilityManifest, d as BackendEvent, et as BACKEND_CONTRACT_VERSION, f as BackendEventKind, g as BackendFileSystem, h as BackendFileStat, i as BackendArtifactBridgeCapability, it as BackendStage, j as BackendSuccess, k as BackendRuntimeOptions, l as BackendCapabilityUnavailableError, m as BackendFileHandle, n as AdvisoryLockConflictError, nt as BackendMessage, o as BackendCacheSnapshot, p as BackendFailure, q as SavePartialFailureError, r as ApplySessionTransactionInput, rt as BackendResponseMeta, s as BackendCapabilities, t as BackendRuntime, tt as BackendDiagnostic, u as BackendError, v as BackendJobErrors, w as BackendJobProgress, x as BackendJobListStatusFilter, y as BackendJobKind, z as InProcessLockConflictError } from "./runtime-BB_3Ws5y.cjs";
+import { $ as BACKEND_COMPATIBILITY_POLICY, A as BackendSessionSnapshot, B as ListJobsInput, C as BackendJobNotFoundError, D as BackendProjectSessionStorage, E as BackendJobStatus, F as GetCacheSnapshotInput, G as OpenProjectSessionInput, H as MaterializeSessionSnapshot, I as GetEventsInput, J as SaveSessionInput, K as RefreshCacheInput, L as GetEventsSnapshot, M as CacheRefreshFailedError, N as CancelJobInput, O as BackendResult, P as EventCursorInvalidError, Q as BACKEND_CAPABILITY_SCHEMA_VERSION, R as GetJobInput, S as BackendJobNotCancellableError, T as BackendJobSnapshot, U as MaterializeValidationFailedError, V as MaterializeSessionInput, W as MaterializeWriteFailedError, X as SessionStaleWriteError, Y as SessionNotFoundError, Z as UamFidelityUnsupportedError, _ as BackendHostAdapter, a as BackendCacheEntry, b as BackendJobListSnapshot, c as BackendCapabilityManifest, d as BackendEvent, et as BACKEND_CONTRACT_VERSION, f as BackendEventKind, g as BackendFileSystem, h as BackendFileStat, i as BackendArtifactBridgeCapability, it as BackendStage, j as BackendSuccess, k as BackendRuntimeOptions, l as BackendCapabilityUnavailableError, m as BackendFileHandle, n as AdvisoryLockConflictError, nt as BackendMessage, o as BackendCacheSnapshot, p as BackendFailure, q as SavePartialFailureError, r as ApplySessionTransactionInput, rt as BackendResponseMeta, s as BackendCapabilities, t as BackendRuntime, tt as BackendDiagnostic, u as BackendError, v as BackendJobErrors, w as BackendJobProgress, x as BackendJobListStatusFilter, y as BackendJobKind, z as InProcessLockConflictError } from "./runtime-Wu6vGZ-j.cjs";
 import { FileSystem } from "@openfairygui/core/project-io";
 
 //#region src/storage.d.ts
@@ -23,6 +23,7 @@ interface BackendAsyncStorageAdapter {
   resolvePath?(filePath: string): Promise<string>;
   openExclusive?(filePath: string): Promise<BackendFileHandle>;
   unlink(filePath: string): Promise<void>;
+  rmdir(dirPath: string): Promise<void>;
   join?(...paths: string[]): string;
   dirname?(filePath: string): string;
   resolve?(...paths: string[]): string;

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as BACKEND_COMPATIBILITY_POLICY, A as BackendSessionSnapshot, B as ListJobsInput, C as BackendJobNotFoundError, D as BackendProjectSessionStorage, E as BackendJobStatus, F as GetCacheSnapshotInput, G as OpenProjectSessionInput, H as MaterializeSessionSnapshot, I as GetEventsInput, J as SaveSessionInput, K as RefreshCacheInput, L as GetEventsSnapshot, M as CacheRefreshFailedError, N as CancelJobInput, O as BackendResult, P as EventCursorInvalidError, Q as BACKEND_CAPABILITY_SCHEMA_VERSION, R as GetJobInput, S as BackendJobNotCancellableError, T as BackendJobSnapshot, U as MaterializeValidationFailedError, V as MaterializeSessionInput, W as MaterializeWriteFailedError, X as SessionStaleWriteError, Y as SessionNotFoundError, Z as UamFidelityUnsupportedError, _ as BackendHostAdapter, a as BackendCacheEntry, b as BackendJobListSnapshot, c as BackendCapabilityManifest, d as BackendEvent, et as BACKEND_CONTRACT_VERSION, f as BackendEventKind, g as BackendFileSystem, h as BackendFileStat, i as BackendArtifactBridgeCapability, it as BackendStage, j as BackendSuccess, k as BackendRuntimeOptions, l as BackendCapabilityUnavailableError, m as BackendFileHandle, n as AdvisoryLockConflictError, nt as BackendMessage, o as BackendCacheSnapshot, p as BackendFailure, q as SavePartialFailureError, r as ApplySessionTransactionInput, rt as BackendResponseMeta, s as BackendCapabilities, t as BackendRuntime, tt as BackendDiagnostic, u as BackendError, v as BackendJobErrors, w as BackendJobProgress, x as BackendJobListStatusFilter, y as BackendJobKind, z as InProcessLockConflictError } from "./runtime-B4SwHTRC.mjs";
+import { $ as BACKEND_COMPATIBILITY_POLICY, A as BackendSessionSnapshot, B as ListJobsInput, C as BackendJobNotFoundError, D as BackendProjectSessionStorage, E as BackendJobStatus, F as GetCacheSnapshotInput, G as OpenProjectSessionInput, H as MaterializeSessionSnapshot, I as GetEventsInput, J as SaveSessionInput, K as RefreshCacheInput, L as GetEventsSnapshot, M as CacheRefreshFailedError, N as CancelJobInput, O as BackendResult, P as EventCursorInvalidError, Q as BACKEND_CAPABILITY_SCHEMA_VERSION, R as GetJobInput, S as BackendJobNotCancellableError, T as BackendJobSnapshot, U as MaterializeValidationFailedError, V as MaterializeSessionInput, W as MaterializeWriteFailedError, X as SessionStaleWriteError, Y as SessionNotFoundError, Z as UamFidelityUnsupportedError, _ as BackendHostAdapter, a as BackendCacheEntry, b as BackendJobListSnapshot, c as BackendCapabilityManifest, d as BackendEvent, et as BACKEND_CONTRACT_VERSION, f as BackendEventKind, g as BackendFileSystem, h as BackendFileStat, i as BackendArtifactBridgeCapability, it as BackendStage, j as BackendSuccess, k as BackendRuntimeOptions, l as BackendCapabilityUnavailableError, m as BackendFileHandle, n as AdvisoryLockConflictError, nt as BackendMessage, o as BackendCacheSnapshot, p as BackendFailure, q as SavePartialFailureError, r as ApplySessionTransactionInput, rt as BackendResponseMeta, s as BackendCapabilities, t as BackendRuntime, tt as BackendDiagnostic, u as BackendError, v as BackendJobErrors, w as BackendJobProgress, x as BackendJobListStatusFilter, y as BackendJobKind, z as InProcessLockConflictError } from "./runtime-BQOEw22M.mjs";
 import { FileSystem } from "@openfairygui/core/project-io";
 
 //#region src/storage.d.ts
@@ -23,6 +23,7 @@ interface BackendAsyncStorageAdapter {
   resolvePath?(filePath: string): Promise<string>;
   openExclusive?(filePath: string): Promise<BackendFileHandle>;
   unlink(filePath: string): Promise<void>;
+  rmdir(dirPath: string): Promise<void>;
   join?(...paths: string[]): string;
   dirname?(filePath: string): string;
   resolve?(...paths: string[]): string;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { i as BACKEND_CONTRACT_VERSION, n as BACKEND_CAPABILITY_SCHEMA_VERSION, r as BACKEND_COMPATIBILITY_POLICY, t as BackendRuntime } from "./runtime-griAoBRA.mjs";
+import { i as BACKEND_CONTRACT_VERSION, n as BACKEND_CAPABILITY_SCHEMA_VERSION, r as BACKEND_COMPATIBILITY_POLICY, t as BackendRuntime } from "./runtime-NiBgr7PF.mjs";
 //#region src/storage.ts
 var StorageFileStat = class {
 	constructor(kind) {
@@ -71,6 +71,7 @@ async function inferStat(storage, filePath) {
 }
 function createBackendStorageFileSystem(storage) {
 	if (typeof storage.unlink !== "function") throw createPathError("ENOTSUP", "Storage adapter must provide unlink() for project resource lifecycle writes.");
+	if (typeof storage.rmdir !== "function") throw createPathError("ENOTSUP", "Storage adapter must provide rmdir() for project resource folder lifecycle writes.");
 	const lockedPaths = /* @__PURE__ */ new Set();
 	const fileSystem = {
 		stat(filePath) {
@@ -130,6 +131,9 @@ function createBackendStorageFileSystem(storage) {
 			lockedPaths.delete(resolved);
 			return storage.unlink(resolved);
 		},
+		rmdir(dirPath) {
+			return storage.rmdir(fileSystem.resolve(dirPath));
+		},
 		join(...paths) {
 			return storage.join ? storage.join(...paths) : joinStoragePath(...paths);
 		},

package/dist/node.cjs

@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_runtime = require("./runtime-BxbnisWJ.cjs");
+const require_runtime = require("./runtime-CcBLI-J7.cjs");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = __toESM(node_fs_promises);
 let node_path = require("node:path");
@@ -72,6 +72,9 @@ function createNodeBackendFileSystem() {
 		unlink(filePath) {
 			return node_fs_promises.default.unlink(filePath);
 		},
+		rmdir(dirPath) {
+			return node_fs_promises.default.rmdir(dirPath);
+		},
 		join(...paths) {
 			return node_path.default.join(...paths);
 		},

package/dist/node.d.cts

@@ -1,4 +1,4 @@
-import { _ as BackendHostAdapter, g as BackendFileSystem, h as BackendFileStat, k as BackendRuntimeOptions, m as BackendFileHandle, t as BackendRuntime } from "./runtime-BB_3Ws5y.cjs";
+import { _ as BackendHostAdapter, g as BackendFileSystem, h as BackendFileStat, k as BackendRuntimeOptions, m as BackendFileHandle, t as BackendRuntime } from "./runtime-Wu6vGZ-j.cjs";
 
 //#region src/node.d.ts
 declare function createNodeBackendFileSystem(): BackendFileSystem;

package/dist/node.d.mts

@@ -1,4 +1,4 @@
-import { _ as BackendHostAdapter, g as BackendFileSystem, h as BackendFileStat, k as BackendRuntimeOptions, m as BackendFileHandle, t as BackendRuntime } from "./runtime-B4SwHTRC.mjs";
+import { _ as BackendHostAdapter, g as BackendFileSystem, h as BackendFileStat, k as BackendRuntimeOptions, m as BackendFileHandle, t as BackendRuntime } from "./runtime-BQOEw22M.mjs";
 
 //#region src/node.d.ts
 declare function createNodeBackendFileSystem(): BackendFileSystem;

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { t as BackendRuntime } from "./runtime-griAoBRA.mjs";
+import { t as BackendRuntime } from "./runtime-NiBgr7PF.mjs";
 import fs from "node:fs/promises";
 import path from "node:path";
 //#region src/node.ts
@@ -47,6 +47,9 @@ function createNodeBackendFileSystem() {
 		unlink(filePath) {
 			return fs.unlink(filePath);
 		},
+		rmdir(dirPath) {
+			return fs.rmdir(dirPath);
+		},
 		join(...paths) {
 			return path.join(...paths);
 		},

package/dist/{runtime-B4SwHTRC.d.mts → runtime-BQOEw22M.d.mts}

@@ -70,6 +70,7 @@ interface BackendFileSystem {
   resolvePath(filePath: string): Promise<string>;
   openExclusive(filePath: string): Promise<BackendFileHandle>;
   unlink(filePath: string): Promise<void>;
+  rmdir(dirPath: string): Promise<void>;
   join(...paths: string[]): string;
   dirname(filePath: string): string;
   resolve(...paths: string[]): string;

package/dist/{runtime-BxbnisWJ.cjs → runtime-CcBLI-J7.cjs}

@@ -155,11 +155,15 @@ function createWriterFileSystem(fileSystem, writtenPaths, failedPaths) {
 		},
 		join: (...paths) => fileSystem.join(...paths),
 		dirname: (path) => fileSystem.dirname(path),
-		unlink: (path) => trackWrite(path, () => fileSystem.unlink(path))
+		unlink: (path) => trackWrite(path, () => fileSystem.unlink(path)),
+		rmdir: (path) => trackWrite(path, () => fileSystem.rmdir(path))
 	};
 }
 async function writeSessionProject(input) {
-	await new _openfairygui_core_project_io.ProjectWriter(createWriterFileSystem(input.fileSystem, input.writtenPaths, input.failedPaths)).write(input.document, input.fairyPath, { staleSourceFiles: input.staleSourceFiles });
+	await new _openfairygui_core_project_io.ProjectWriter(createWriterFileSystem(input.fileSystem, input.writtenPaths, input.failedPaths)).write(input.document, input.fairyPath, {
+		staleSourceFiles: input.staleSourceFiles,
+		staleResourceFolders: input.staleResourceFolders
+	});
 }
 //#endregion
 //#region src/services/snapshot-utils.ts
@@ -238,6 +242,7 @@ function projectSourceFiles(project) {
 			fileName: "package.xml"
 		});
 		const branches = /* @__PURE__ */ new Set();
+		for (const folder of pkg.folders) if (folder.branch) branches.add(folder.branch);
 		for (const resource of pkg.resources) {
 			if (resource.branch) branches.add(resource.branch);
 			const fileName = resource.kind === "component" ? `${resource.name}.xml` : resource.fileName ?? (resource.kind === "image" ? "" : resource.file) ?? "";
@@ -266,6 +271,22 @@ function sourceFileKey(source) {
 		source.fileName
 	].join("\0");
 }
+function projectResourceFolders(project) {
+	const result = /* @__PURE__ */ new Map();
+	for (const pkg of project.packages) for (const folder of pkg.folders) result.set(`${pkg.id}/${folder.branch}/${folder.path}`, {
+		packageName: pkg.name,
+		branch: folder.branch,
+		path: folder.path
+	});
+	return result;
+}
+function resourceFolderKey(folder) {
+	return [
+		folder.branch,
+		folder.packageName,
+		folder.path
+	].join("\0");
+}
 function recordStaleProjectFiles(session, previousProject, nextProject) {
 	if (!session.fileSystem) return;
 	const previousSources = projectSourceFiles(previousProject);
@@ -275,6 +296,13 @@ function recordStaleProjectFiles(session, previousProject, nextProject) {
 		if (!nextSourceKeys.has(key)) session.pendingStaleSourceFiles.set(key, source);
 	}
 	for (const key of nextSourceKeys) session.pendingStaleSourceFiles.delete(key);
+	const previousFolders = projectResourceFolders(previousProject);
+	const nextFolderKeys = new Set([...projectResourceFolders(nextProject).values()].map(resourceFolderKey));
+	for (const folder of previousFolders.values()) {
+		const key = resourceFolderKey(folder);
+		if (!nextFolderKeys.has(key)) session.pendingStaleResourceFolders.set(key, folder);
+	}
+	for (const key of nextFolderKeys) session.pendingStaleResourceFolders.delete(key);
 }
 function toBackendDiagnostics(error) {
 	return error.diagnostics.length > 0 ? error.diagnostics.map((diagnostic) => ({ ...diagnostic })) : [{
@@ -467,11 +495,13 @@ var AuthoringService = class {
 				document: (0, _openfairygui_core_uam.materializeUamProject)(session.project),
 				fairyPath: session.fairyPath,
 				staleSourceFiles: [...session.pendingStaleSourceFiles.values()],
+				staleResourceFolders: [...session.pendingStaleResourceFolders.values()],
 				writtenPaths: committedPaths,
 				failedPaths
 			});
 			session.fileSystem ??= fileSystem;
 			session.pendingStaleSourceFiles.clear();
+			session.pendingStaleResourceFolders.clear();
 			(0, _openfairygui_core_uam.commitUamProjectSourcePaths)(session.project);
 			session.lastSavedRevision = session.revision;
 			session.dirty = false;
@@ -609,11 +639,18 @@ var AuthoringService = class {
 				document,
 				fairyPath,
 				staleSourceFiles: isSessionStorageTarget ? [...session.pendingStaleSourceFiles.values()] : [],
+				staleResourceFolders: isSessionStorageTarget ? [...session.pendingStaleResourceFolders.values()] : [],
 				writtenPaths,
 				failedPaths
 			});
-			if (isSessionStorageTarget) session.pendingStaleSourceFiles.clear();
-			if (storageTarget && !isSessionStorageTarget) session.pendingStaleSourceFiles.clear();
+			if (isSessionStorageTarget) {
+				session.pendingStaleSourceFiles.clear();
+				session.pendingStaleResourceFolders.clear();
+			}
+			if (storageTarget && !isSessionStorageTarget) {
+				session.pendingStaleSourceFiles.clear();
+				session.pendingStaleResourceFolders.clear();
+			}
 			if (isSessionStorageTarget || storageTarget) (0, _openfairygui_core_uam.commitUamProjectSourcePaths)(session.project);
 			if (storageTarget) {
 				this.context.sessionsByPath.delete(session.canonicalPathKey);
@@ -1141,7 +1178,7 @@ function createProjectReaderFileSystem(fileSystem) {
 		}
 	};
 }
-function createCaptureFileSystem(files) {
+function createCaptureFileSystem(files, directories) {
 	const normalize = (filePath) => filePath.replace(/\\/g, "/").replace(/\/+/g, "/");
 	return {
 		async readFile(filePath) {
@@ -1160,7 +1197,9 @@ function createCaptureFileSystem(files) {
 		async writeFileRaw(filePath, data) {
 			files.set(normalize(filePath), data.slice());
 		},
-		async mkdir() {},
+		async mkdir(dirPath) {
+			directories.add(normalize(dirPath));
+		},
 		async readdir() {
 			return [];
 		},
@@ -1193,15 +1232,20 @@ function capturedFilesEqual(left, right) {
 	}
 	return true;
 }
+function capturedDirectoriesEqual(left, right) {
+	return left.size === right.size && [...left].every((directory) => right.has(directory));
+}
 async function hasFullUamFidelity(document, project) {
 	const sourceFiles = /* @__PURE__ */ new Map();
 	const materializedFiles = /* @__PURE__ */ new Map();
+	const sourceDirectories = /* @__PURE__ */ new Set();
+	const materializedDirectories = /* @__PURE__ */ new Set();
 	try {
-		await Promise.all([new _openfairygui_core_project_io.ProjectWriter(createCaptureFileSystem(sourceFiles)).write(document, "Project.fairy"), new _openfairygui_core_project_io.ProjectWriter(createCaptureFileSystem(materializedFiles)).write((0, _openfairygui_core_uam.materializeUamProject)(project), "Project.fairy")]);
+		await Promise.all([new _openfairygui_core_project_io.ProjectWriter(createCaptureFileSystem(sourceFiles, sourceDirectories)).write(document, "Project.fairy"), new _openfairygui_core_project_io.ProjectWriter(createCaptureFileSystem(materializedFiles, materializedDirectories)).write((0, _openfairygui_core_uam.materializeUamProject)(project), "Project.fairy")]);
 	} catch {
 		return false;
 	}
-	return capturedFilesEqual(sourceFiles, materializedFiles);
+	return capturedFilesEqual(sourceFiles, materializedFiles) && capturedDirectoriesEqual(sourceDirectories, materializedDirectories);
 }
 var RuntimeService = class {
 	constructor(context, cacheService, eventService, jobService) {
@@ -1252,6 +1296,7 @@ var RuntimeService = class {
 				revision: 0,
 				lastSavedRevision: 0,
 				pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
+				pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
 				dirty: false,
 				lockHeld: true,
 				closed: false
@@ -1311,6 +1356,7 @@ var RuntimeService = class {
 			revision: 0,
 			lastSavedRevision: 0,
 			pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
+			pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
 			dirty: false,
 			lockHeld: false,
 			closed: false

package/dist/{runtime-griAoBRA.mjs → runtime-NiBgr7PF.mjs}

@@ -154,11 +154,15 @@ function createWriterFileSystem(fileSystem, writtenPaths, failedPaths) {
 		},
 		join: (...paths) => fileSystem.join(...paths),
 		dirname: (path) => fileSystem.dirname(path),
-		unlink: (path) => trackWrite(path, () => fileSystem.unlink(path))
+		unlink: (path) => trackWrite(path, () => fileSystem.unlink(path)),
+		rmdir: (path) => trackWrite(path, () => fileSystem.rmdir(path))
 	};
 }
 async function writeSessionProject(input) {
-	await new ProjectWriter(createWriterFileSystem(input.fileSystem, input.writtenPaths, input.failedPaths)).write(input.document, input.fairyPath, { staleSourceFiles: input.staleSourceFiles });
+	await new ProjectWriter(createWriterFileSystem(input.fileSystem, input.writtenPaths, input.failedPaths)).write(input.document, input.fairyPath, {
+		staleSourceFiles: input.staleSourceFiles,
+		staleResourceFolders: input.staleResourceFolders
+	});
 }
 //#endregion
 //#region src/services/snapshot-utils.ts
@@ -237,6 +241,7 @@ function projectSourceFiles(project) {
 			fileName: "package.xml"
 		});
 		const branches = /* @__PURE__ */ new Set();
+		for (const folder of pkg.folders) if (folder.branch) branches.add(folder.branch);
 		for (const resource of pkg.resources) {
 			if (resource.branch) branches.add(resource.branch);
 			const fileName = resource.kind === "component" ? `${resource.name}.xml` : resource.fileName ?? (resource.kind === "image" ? "" : resource.file) ?? "";
@@ -265,6 +270,22 @@ function sourceFileKey(source) {
 		source.fileName
 	].join("\0");
 }
+function projectResourceFolders(project) {
+	const result = /* @__PURE__ */ new Map();
+	for (const pkg of project.packages) for (const folder of pkg.folders) result.set(`${pkg.id}/${folder.branch}/${folder.path}`, {
+		packageName: pkg.name,
+		branch: folder.branch,
+		path: folder.path
+	});
+	return result;
+}
+function resourceFolderKey(folder) {
+	return [
+		folder.branch,
+		folder.packageName,
+		folder.path
+	].join("\0");
+}
 function recordStaleProjectFiles(session, previousProject, nextProject) {
 	if (!session.fileSystem) return;
 	const previousSources = projectSourceFiles(previousProject);
@@ -274,6 +295,13 @@ function recordStaleProjectFiles(session, previousProject, nextProject) {
 		if (!nextSourceKeys.has(key)) session.pendingStaleSourceFiles.set(key, source);
 	}
 	for (const key of nextSourceKeys) session.pendingStaleSourceFiles.delete(key);
+	const previousFolders = projectResourceFolders(previousProject);
+	const nextFolderKeys = new Set([...projectResourceFolders(nextProject).values()].map(resourceFolderKey));
+	for (const folder of previousFolders.values()) {
+		const key = resourceFolderKey(folder);
+		if (!nextFolderKeys.has(key)) session.pendingStaleResourceFolders.set(key, folder);
+	}
+	for (const key of nextFolderKeys) session.pendingStaleResourceFolders.delete(key);
 }
 function toBackendDiagnostics(error) {
 	return error.diagnostics.length > 0 ? error.diagnostics.map((diagnostic) => ({ ...diagnostic })) : [{
@@ -466,11 +494,13 @@ var AuthoringService = class {
 				document: materializeUamProject(session.project),
 				fairyPath: session.fairyPath,
 				staleSourceFiles: [...session.pendingStaleSourceFiles.values()],
+				staleResourceFolders: [...session.pendingStaleResourceFolders.values()],
 				writtenPaths: committedPaths,
 				failedPaths
 			});
 			session.fileSystem ??= fileSystem;
 			session.pendingStaleSourceFiles.clear();
+			session.pendingStaleResourceFolders.clear();
 			commitUamProjectSourcePaths(session.project);
 			session.lastSavedRevision = session.revision;
 			session.dirty = false;
@@ -608,11 +638,18 @@ var AuthoringService = class {
 				document,
 				fairyPath,
 				staleSourceFiles: isSessionStorageTarget ? [...session.pendingStaleSourceFiles.values()] : [],
+				staleResourceFolders: isSessionStorageTarget ? [...session.pendingStaleResourceFolders.values()] : [],
 				writtenPaths,
 				failedPaths
 			});
-			if (isSessionStorageTarget) session.pendingStaleSourceFiles.clear();
-			if (storageTarget && !isSessionStorageTarget) session.pendingStaleSourceFiles.clear();
+			if (isSessionStorageTarget) {
+				session.pendingStaleSourceFiles.clear();
+				session.pendingStaleResourceFolders.clear();
+			}
+			if (storageTarget && !isSessionStorageTarget) {
+				session.pendingStaleSourceFiles.clear();
+				session.pendingStaleResourceFolders.clear();
+			}
 			if (isSessionStorageTarget || storageTarget) commitUamProjectSourcePaths(session.project);
 			if (storageTarget) {
 				this.context.sessionsByPath.delete(session.canonicalPathKey);
@@ -1140,7 +1177,7 @@ function createProjectReaderFileSystem(fileSystem) {
 		}
 	};
 }
-function createCaptureFileSystem(files) {
+function createCaptureFileSystem(files, directories) {
 	const normalize = (filePath) => filePath.replace(/\\/g, "/").replace(/\/+/g, "/");
 	return {
 		async readFile(filePath) {
@@ -1159,7 +1196,9 @@ function createCaptureFileSystem(files) {
 		async writeFileRaw(filePath, data) {
 			files.set(normalize(filePath), data.slice());
 		},
-		async mkdir() {},
+		async mkdir(dirPath) {
+			directories.add(normalize(dirPath));
+		},
 		async readdir() {
 			return [];
 		},
@@ -1192,15 +1231,20 @@ function capturedFilesEqual(left, right) {
 	}
 	return true;
 }
+function capturedDirectoriesEqual(left, right) {
+	return left.size === right.size && [...left].every((directory) => right.has(directory));
+}
 async function hasFullUamFidelity(document, project) {
 	const sourceFiles = /* @__PURE__ */ new Map();
 	const materializedFiles = /* @__PURE__ */ new Map();
+	const sourceDirectories = /* @__PURE__ */ new Set();
+	const materializedDirectories = /* @__PURE__ */ new Set();
 	try {
-		await Promise.all([new ProjectWriter(createCaptureFileSystem(sourceFiles)).write(document, "Project.fairy"), new ProjectWriter(createCaptureFileSystem(materializedFiles)).write(materializeUamProject(project), "Project.fairy")]);
+		await Promise.all([new ProjectWriter(createCaptureFileSystem(sourceFiles, sourceDirectories)).write(document, "Project.fairy"), new ProjectWriter(createCaptureFileSystem(materializedFiles, materializedDirectories)).write(materializeUamProject(project), "Project.fairy")]);
 	} catch {
 		return false;
 	}
-	return capturedFilesEqual(sourceFiles, materializedFiles);
+	return capturedFilesEqual(sourceFiles, materializedFiles) && capturedDirectoriesEqual(sourceDirectories, materializedDirectories);
 }
 var RuntimeService = class {
 	constructor(context, cacheService, eventService, jobService) {
@@ -1251,6 +1295,7 @@ var RuntimeService = class {
 				revision: 0,
 				lastSavedRevision: 0,
 				pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
+				pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
 				dirty: false,
 				lockHeld: true,
 				closed: false
@@ -1310,6 +1355,7 @@ var RuntimeService = class {
 			revision: 0,
 			lastSavedRevision: 0,
 			pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
+			pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
 			dirty: false,
 			lockHeld: false,
 			closed: false

package/dist/{runtime-BB_3Ws5y.d.cts → runtime-Wu6vGZ-j.d.cts}

@@ -70,6 +70,7 @@ interface BackendFileSystem {
   resolvePath(filePath: string): Promise<string>;
   openExclusive(filePath: string): Promise<BackendFileHandle>;
   unlink(filePath: string): Promise<void>;
+  rmdir(dirPath: string): Promise<void>;
   join(...paths: string[]): string;
   dirname(filePath: string): string;
   resolve(...paths: string[]): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/backend",
-  "version": "0.2.0-alpha.29",
+  "version": "0.2.0-alpha.30",
   "description": "FairyGUI Headless Authoring SDK — stateful backend runtime and session services.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -52,8 +52,8 @@
     "runtime"
   ],
   "dependencies": {
-    "@openfairygui/core": "0.2.0-alpha.29",
-    "@openfairygui/functions": "0.2.0-alpha.29"
+    "@openfairygui/core": "0.2.0-alpha.30",
+    "@openfairygui/functions": "0.2.0-alpha.30"
   },
   "devDependencies": {
     "ava": "^7.0.0",

package/src/node.ts

@@ -54,6 +54,9 @@ export function createNodeBackendFileSystem(): BackendFileSystem {
 		unlink(filePath: string): Promise<void> {
 			return fs.unlink(filePath);
 		},
+		rmdir(dirPath: string): Promise<void> {
+			return fs.rmdir(dirPath);
+		},
 		join(...paths: string[]): string {
 			return path.join(...paths);
 		},

package/src/runtime/contracts.ts

@@ -30,6 +30,7 @@ export interface BackendFileSystem {
 	resolvePath(filePath: string): Promise<string>;
 	openExclusive(filePath: string): Promise<BackendFileHandle>;
 	unlink(filePath: string): Promise<void>;
+	rmdir(dirPath: string): Promise<void>;
 	join(...paths: string[]): string;
 	dirname(filePath: string): string;
 	resolve(...paths: string[]): string;

package/src/services/authoring-service.ts

@@ -1,4 +1,4 @@
-import type { ProjectSourceFile } from '@openfairygui/core/project-io';
+import type { ProjectResourceFolder, ProjectSourceFile } from '@openfairygui/core/project-io';
 import {
 	commitUamProjectSourcePaths,
 	materializeUamProject,
@@ -41,6 +41,9 @@ function projectSourceFiles(project: UamProject): Map<string, ProjectSourceFile>
 			fileName: 'package.xml',
 		});
 		const branches = new Set<string>();
+		for (const folder of pkg.folders) {
+			if (folder.branch) branches.add(folder.branch);
+		}
 		for (const resource of pkg.resources) {
 			if (resource.branch) branches.add(resource.branch);
 			const fileName = resource.kind === 'component'
@@ -70,6 +73,24 @@ function sourceFileKey(source: ProjectSourceFile): string {
 	return [source.branch, source.packageName, source.path, source.fileName].join('\0');
 }
 
+function projectResourceFolders(project: UamProject): Map<string, ProjectResourceFolder> {
+	const result = new Map<string, ProjectResourceFolder>();
+	for (const pkg of project.packages) {
+		for (const folder of pkg.folders) {
+			result.set(`${pkg.id}/${folder.branch}/${folder.path}`, {
+				packageName: pkg.name,
+				branch: folder.branch,
+				path: folder.path,
+			});
+		}
+	}
+	return result;
+}
+
+function resourceFolderKey(folder: ProjectResourceFolder): string {
+	return [folder.branch, folder.packageName, folder.path].join('\0');
+}
+
 function recordStaleProjectFiles(
 	session: Parameters<typeof toSessionSnapshot>[0],
 	previousProject: UamProject,
@@ -85,6 +106,15 @@ function recordStaleProjectFiles(
 	for (const key of nextSourceKeys) {
 		session.pendingStaleSourceFiles.delete(key);
 	}
+	const previousFolders = projectResourceFolders(previousProject);
+	const nextFolderKeys = new Set([...projectResourceFolders(nextProject).values()].map(resourceFolderKey));
+	for (const folder of previousFolders.values()) {
+		const key = resourceFolderKey(folder);
+		if (!nextFolderKeys.has(key)) session.pendingStaleResourceFolders.set(key, folder);
+	}
+	for (const key of nextFolderKeys) {
+		session.pendingStaleResourceFolders.delete(key);
+	}
 }
 
 function toBackendDiagnostics(error: ApplyUamTransactionAppError): BackendDiagnostic[] {
@@ -411,11 +441,13 @@ export class AuthoringService {
 				document: materializeUamProject(session.project),
 				fairyPath: session.fairyPath,
 				staleSourceFiles: [...session.pendingStaleSourceFiles.values()],
+				staleResourceFolders: [...session.pendingStaleResourceFolders.values()],
 				writtenPaths: committedPaths,
 				failedPaths,
 			});
 			session.fileSystem ??= fileSystem;
 			session.pendingStaleSourceFiles.clear();
+			session.pendingStaleResourceFolders.clear();
 			commitUamProjectSourcePaths(session.project);
 			session.lastSavedRevision = session.revision;
 			session.dirty = false;
@@ -650,11 +682,18 @@ export class AuthoringService {
 				document,
 				fairyPath,
 				staleSourceFiles: isSessionStorageTarget ? [...session.pendingStaleSourceFiles.values()] : [],
+				staleResourceFolders: isSessionStorageTarget ? [...session.pendingStaleResourceFolders.values()] : [],
 				writtenPaths,
 				failedPaths,
 			});
-			if (isSessionStorageTarget) session.pendingStaleSourceFiles.clear();
-			if (storageTarget && !isSessionStorageTarget) session.pendingStaleSourceFiles.clear();
+			if (isSessionStorageTarget) {
+				session.pendingStaleSourceFiles.clear();
+				session.pendingStaleResourceFolders.clear();
+			}
+			if (storageTarget && !isSessionStorageTarget) {
+				session.pendingStaleSourceFiles.clear();
+				session.pendingStaleResourceFolders.clear();
+			}
 			if (isSessionStorageTarget || storageTarget) commitUamProjectSourcePaths(session.project);
 			if (storageTarget) {
 				this.context.sessionsByPath.delete(session.canonicalPathKey);

package/src/services/context.ts

@@ -32,6 +32,8 @@ export interface BackendSessionState {
 	lastSavedRevision: number;
 	/** Package-controlled files deferred until a successful replacement project write. */
 	pendingStaleSourceFiles: Map<string, import('@openfairygui/core/project-io').ProjectSourceFile>;
+	/** Empty resource directories deferred until a successful replacement project write. */
+	pendingStaleResourceFolders: Map<string, import('@openfairygui/core/project-io').ProjectResourceFolder>;
 	dirty: boolean;
 	lockHeld: boolean;
 	closed: boolean;

package/src/services/runtime-service.ts

@@ -79,7 +79,10 @@ function createProjectReaderFileSystem(fileSystem: NonNullable<BackendContext['f
 	};
 }
 
-function createCaptureFileSystem(files: Map<string, string | Uint8Array>): FileSystem {
+function createCaptureFileSystem(
+	files: Map<string, string | Uint8Array>,
+	directories: Set<string>,
+): FileSystem {
 	const normalize = (filePath: string): string => filePath.replace(/\\/g, '/').replace(/\/+/g, '/');
 	return {
 		async readFile(filePath: string): Promise<string> {
@@ -98,7 +101,9 @@ function createCaptureFileSystem(files: Map<string, string | Uint8Array>): FileS
 		async writeFileRaw(filePath: string, data: Uint8Array): Promise<void> {
 			files.set(normalize(filePath), data.slice());
 		},
-		async mkdir(): Promise<void> {},
+		async mkdir(dirPath: string): Promise<void> {
+			directories.add(normalize(dirPath));
+		},
 		async readdir(): Promise<string[]> {
 			return [];
 		},
@@ -135,16 +140,22 @@ function capturedFilesEqual(left: Map<string, string | Uint8Array>, right: Map<s
 	return true;
 }
 
+function capturedDirectoriesEqual(left: Set<string>, right: Set<string>): boolean {
+	return left.size === right.size && [...left].every((directory) => right.has(directory));
+}
+
 async function hasFullUamFidelity(
 	document: Awaited<ReturnType<ProjectReader['read']>>,
 	project: UamProject,
 ): Promise<boolean> {
 	const sourceFiles = new Map<string, string | Uint8Array>();
 	const materializedFiles = new Map<string, string | Uint8Array>();
+	const sourceDirectories = new Set<string>();
+	const materializedDirectories = new Set<string>();
 	try {
 		await Promise.all([
-			new ProjectWriter(createCaptureFileSystem(sourceFiles)).write(document, 'Project.fairy'),
-			new ProjectWriter(createCaptureFileSystem(materializedFiles)).write(
+			new ProjectWriter(createCaptureFileSystem(sourceFiles, sourceDirectories)).write(document, 'Project.fairy'),
+			new ProjectWriter(createCaptureFileSystem(materializedFiles, materializedDirectories)).write(
 				materializeUamProject(project),
 				'Project.fairy',
 			),
@@ -152,7 +163,8 @@ async function hasFullUamFidelity(
 	} catch {
 		return false;
 	}
-	return capturedFilesEqual(sourceFiles, materializedFiles);
+	return capturedFilesEqual(sourceFiles, materializedFiles)
+		&& capturedDirectoriesEqual(sourceDirectories, materializedDirectories);
 }
 
 export class RuntimeService {
@@ -225,6 +237,7 @@ export class RuntimeService {
 				revision: 0,
 				lastSavedRevision: 0,
 				pendingStaleSourceFiles: new Map(),
+				pendingStaleResourceFolders: new Map(),
 				dirty: false,
 				lockHeld: true,
 				closed: false,
@@ -292,6 +305,7 @@ export class RuntimeService {
 			revision: 0,
 			lastSavedRevision: 0,
 			pendingStaleSourceFiles: new Map(),
+			pendingStaleResourceFolders: new Map(),
 			dirty: false,
 			lockHeld: false,
 			closed: false,

package/src/services/session-project-writer.ts

@@ -44,6 +44,7 @@ function createWriterFileSystem(
 		join: (...paths) => fileSystem.join(...paths),
 		dirname: (path) => fileSystem.dirname(path),
 		unlink: (path) => trackWrite(path, () => fileSystem.unlink(path)),
+		rmdir: (path) => trackWrite(path, () => fileSystem.rmdir(path)),
 	};
 }
 
@@ -52,6 +53,7 @@ export async function writeSessionProject(input: {
 	document: Document;
 	fairyPath: string;
 	staleSourceFiles: ProjectSourceFile[];
+	staleResourceFolders: import('@openfairygui/core/project-io').ProjectResourceFolder[];
 	writtenPaths: string[];
 	failedPaths: string[];
 }): Promise<void> {
@@ -60,5 +62,6 @@ export async function writeSessionProject(input: {
 	);
 	await writer.write(input.document, input.fairyPath, {
 		staleSourceFiles: input.staleSourceFiles,
+		staleResourceFolders: input.staleResourceFolders,
 	});
 }

package/src/storage.ts

@@ -22,6 +22,7 @@ export interface BackendAsyncStorageAdapter {
 	resolvePath?(filePath: string): Promise<string>;
 	openExclusive?(filePath: string): Promise<BackendFileHandle>;
 	unlink(filePath: string): Promise<void>;
+	rmdir(dirPath: string): Promise<void>;
 	join?(...paths: string[]): string;
 	dirname?(filePath: string): string;
 	resolve?(...paths: string[]): string;
@@ -117,6 +118,9 @@ export function createBackendStorageFileSystem(storage: BackendAsyncStorageAdapt
 	if (typeof storage.unlink !== 'function') {
 		throw createPathError('ENOTSUP', 'Storage adapter must provide unlink() for project resource lifecycle writes.');
 	}
+	if (typeof storage.rmdir !== 'function') {
+		throw createPathError('ENOTSUP', 'Storage adapter must provide rmdir() for project resource folder lifecycle writes.');
+	}
 	const lockedPaths = new Set<string>();
 
 	const fileSystem: BackendStorageFileSystem = {
@@ -179,6 +183,9 @@ export function createBackendStorageFileSystem(storage: BackendAsyncStorageAdapt
 			lockedPaths.delete(resolved);
 			return storage.unlink(resolved);
 		},
+		rmdir(dirPath: string): Promise<void> {
+			return storage.rmdir(fileSystem.resolve(dirPath));
+		},
 		join(...paths: string[]): string {
 			return storage.join ? storage.join(...paths) : joinStoragePath(...paths);
 		},