@openfairygui/backend 0.2.0-alpha.34 → 0.2.0-alpha.35

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_runtime = require("./runtime-CTA1SNix.cjs");
+const require_runtime = require("./runtime-CQQmzsxV.cjs");
 //#region src/storage.ts
 var StorageFileStat = class {
 	constructor(kind) {

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-D8kpBZmu.mjs";
+import { i as BACKEND_CONTRACT_VERSION, n as BACKEND_CAPABILITY_SCHEMA_VERSION, r as BACKEND_COMPATIBILITY_POLICY, t as BackendRuntime } from "./runtime-DtCn0Y44.mjs";
 //#region src/storage.ts
 var StorageFileStat = class {
 	constructor(kind) {

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-CTA1SNix.cjs");
+const require_runtime = require("./runtime-CQQmzsxV.cjs");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = __toESM(node_fs_promises);
 let node_path = require("node:path");

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { t as BackendRuntime } from "./runtime-D8kpBZmu.mjs";
+import { t as BackendRuntime } from "./runtime-DtCn0Y44.mjs";
 import fs from "node:fs/promises";
 import path from "node:path";
 //#region src/node.ts

package/dist/{runtime-CTA1SNix.cjs → runtime-CQQmzsxV.cjs}

@@ -162,7 +162,8 @@ function createWriterFileSystem(fileSystem, writtenPaths, failedPaths) {
 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,
-		staleResourceFolders: input.staleResourceFolders
+		staleResourceFolders: input.staleResourceFolders,
+		staleBranchDirectories: input.staleBranchDirectories
 	});
 }
 //#endregion
@@ -213,12 +214,17 @@ function resourceFolderKey(folder) {
 		folder.path
 	].join("\0");
 }
+function branchDirectoryKey(directory) {
+	return [directory.branch, directory.packageName ?? ""].join("\0");
+}
 function recordStaleProjectFiles(session, previousProject, nextProject) {
 	if (!session.fileSystem) return;
 	for (const source of (0, _openfairygui_core_uam.staleSourceFiles)(previousProject, nextProject)) session.pendingStaleSourceFiles.set(sourceFileKey(source), source);
 	for (const source of (0, _openfairygui_core_uam.staleSourceFiles)(nextProject, previousProject)) session.pendingStaleSourceFiles.delete(sourceFileKey(source));
 	for (const folder of (0, _openfairygui_core_uam.staleResourceFolders)(previousProject, nextProject)) session.pendingStaleResourceFolders.set(resourceFolderKey(folder), folder);
 	for (const folder of (0, _openfairygui_core_uam.staleResourceFolders)(nextProject, previousProject)) session.pendingStaleResourceFolders.delete(resourceFolderKey(folder));
+	for (const directory of (0, _openfairygui_core_uam.staleBranchDirectories)(previousProject, nextProject)) session.pendingStaleBranchDirectories.set(branchDirectoryKey(directory), directory);
+	for (const directory of (0, _openfairygui_core_uam.staleBranchDirectories)(nextProject, previousProject)) session.pendingStaleBranchDirectories.delete(branchDirectoryKey(directory));
 }
 function toBackendDiagnostics(error) {
 	return error.diagnostics.length > 0 ? error.diagnostics.map((diagnostic) => ({ ...diagnostic })) : [{
@@ -426,12 +432,14 @@ var AuthoringService = class {
 				fairyPath: session.fairyPath,
 				staleSourceFiles: [...session.pendingStaleSourceFiles.values()],
 				staleResourceFolders: [...session.pendingStaleResourceFolders.values()],
+				staleBranchDirectories: [...session.pendingStaleBranchDirectories.values()],
 				writtenPaths: committedPaths,
 				failedPaths
 			});
 			session.fileSystem ??= fileSystem;
 			session.pendingStaleSourceFiles.clear();
 			session.pendingStaleResourceFolders.clear();
+			session.pendingStaleBranchDirectories.clear();
 			(0, _openfairygui_core_uam.commitUamProjectSourcePaths)(session.project);
 			session.lastSavedRevision = session.revision;
 			session.dirty = false;
@@ -570,16 +578,19 @@ var AuthoringService = class {
 				fairyPath,
 				staleSourceFiles: isSessionStorageTarget ? [...session.pendingStaleSourceFiles.values()] : [],
 				staleResourceFolders: isSessionStorageTarget ? [...session.pendingStaleResourceFolders.values()] : [],
+				staleBranchDirectories: isSessionStorageTarget ? [...session.pendingStaleBranchDirectories.values()] : [],
 				writtenPaths,
 				failedPaths
 			});
 			if (isSessionStorageTarget) {
 				session.pendingStaleSourceFiles.clear();
 				session.pendingStaleResourceFolders.clear();
+				session.pendingStaleBranchDirectories.clear();
 			}
 			if (storageTarget && !isSessionStorageTarget) {
 				session.pendingStaleSourceFiles.clear();
 				session.pendingStaleResourceFolders.clear();
+				session.pendingStaleBranchDirectories.clear();
 			}
 			if (isSessionStorageTarget || storageTarget) (0, _openfairygui_core_uam.commitUamProjectSourcePaths)(session.project);
 			if (storageTarget) {
@@ -1228,6 +1239,7 @@ var RuntimeService = class {
 				lastSavedRevision: 0,
 				pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
 				pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
+				pendingStaleBranchDirectories: /* @__PURE__ */ new Map(),
 				dirty: false,
 				lockHeld: true,
 				closed: false
@@ -1288,6 +1300,7 @@ var RuntimeService = class {
 			lastSavedRevision: 0,
 			pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
 			pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
+			pendingStaleBranchDirectories: /* @__PURE__ */ new Map(),
 			dirty: false,
 			lockHeld: false,
 			closed: false

package/dist/{runtime-D8kpBZmu.mjs → runtime-DtCn0Y44.mjs}

@@ -1,4 +1,4 @@
-import { UAM_SUPPORTED_MATERIALIZATION_SCOPE, UAM_SUPPORTED_TRANSACTION_SCOPE, commitUamProjectSourcePaths, liftDocumentToUamProject, materializeUamProject, normalizeUamProject, staleResourceFolders, staleSourceFiles, validateUamProject } from "@openfairygui/core/uam";
+import { UAM_SUPPORTED_MATERIALIZATION_SCOPE, UAM_SUPPORTED_TRANSACTION_SCOPE, commitUamProjectSourcePaths, liftDocumentToUamProject, materializeUamProject, normalizeUamProject, staleBranchDirectories, staleResourceFolders, staleSourceFiles, validateUamProject } from "@openfairygui/core/uam";
 import { applyUamTransactionAppAsync } from "@openfairygui/functions/uam";
 import { ProjectReader, ProjectWriter } from "@openfairygui/core/project-io";
 //#region src/contracts.ts
@@ -161,7 +161,8 @@ function createWriterFileSystem(fileSystem, writtenPaths, failedPaths) {
 async function writeSessionProject(input) {
 	await new ProjectWriter(createWriterFileSystem(input.fileSystem, input.writtenPaths, input.failedPaths)).write(input.document, input.fairyPath, {
 		staleSourceFiles: input.staleSourceFiles,
-		staleResourceFolders: input.staleResourceFolders
+		staleResourceFolders: input.staleResourceFolders,
+		staleBranchDirectories: input.staleBranchDirectories
 	});
 }
 //#endregion
@@ -212,12 +213,17 @@ function resourceFolderKey(folder) {
 		folder.path
 	].join("\0");
 }
+function branchDirectoryKey(directory) {
+	return [directory.branch, directory.packageName ?? ""].join("\0");
+}
 function recordStaleProjectFiles(session, previousProject, nextProject) {
 	if (!session.fileSystem) return;
 	for (const source of staleSourceFiles(previousProject, nextProject)) session.pendingStaleSourceFiles.set(sourceFileKey(source), source);
 	for (const source of staleSourceFiles(nextProject, previousProject)) session.pendingStaleSourceFiles.delete(sourceFileKey(source));
 	for (const folder of staleResourceFolders(previousProject, nextProject)) session.pendingStaleResourceFolders.set(resourceFolderKey(folder), folder);
 	for (const folder of staleResourceFolders(nextProject, previousProject)) session.pendingStaleResourceFolders.delete(resourceFolderKey(folder));
+	for (const directory of staleBranchDirectories(previousProject, nextProject)) session.pendingStaleBranchDirectories.set(branchDirectoryKey(directory), directory);
+	for (const directory of staleBranchDirectories(nextProject, previousProject)) session.pendingStaleBranchDirectories.delete(branchDirectoryKey(directory));
 }
 function toBackendDiagnostics(error) {
 	return error.diagnostics.length > 0 ? error.diagnostics.map((diagnostic) => ({ ...diagnostic })) : [{
@@ -425,12 +431,14 @@ var AuthoringService = class {
 				fairyPath: session.fairyPath,
 				staleSourceFiles: [...session.pendingStaleSourceFiles.values()],
 				staleResourceFolders: [...session.pendingStaleResourceFolders.values()],
+				staleBranchDirectories: [...session.pendingStaleBranchDirectories.values()],
 				writtenPaths: committedPaths,
 				failedPaths
 			});
 			session.fileSystem ??= fileSystem;
 			session.pendingStaleSourceFiles.clear();
 			session.pendingStaleResourceFolders.clear();
+			session.pendingStaleBranchDirectories.clear();
 			commitUamProjectSourcePaths(session.project);
 			session.lastSavedRevision = session.revision;
 			session.dirty = false;
@@ -569,16 +577,19 @@ var AuthoringService = class {
 				fairyPath,
 				staleSourceFiles: isSessionStorageTarget ? [...session.pendingStaleSourceFiles.values()] : [],
 				staleResourceFolders: isSessionStorageTarget ? [...session.pendingStaleResourceFolders.values()] : [],
+				staleBranchDirectories: isSessionStorageTarget ? [...session.pendingStaleBranchDirectories.values()] : [],
 				writtenPaths,
 				failedPaths
 			});
 			if (isSessionStorageTarget) {
 				session.pendingStaleSourceFiles.clear();
 				session.pendingStaleResourceFolders.clear();
+				session.pendingStaleBranchDirectories.clear();
 			}
 			if (storageTarget && !isSessionStorageTarget) {
 				session.pendingStaleSourceFiles.clear();
 				session.pendingStaleResourceFolders.clear();
+				session.pendingStaleBranchDirectories.clear();
 			}
 			if (isSessionStorageTarget || storageTarget) commitUamProjectSourcePaths(session.project);
 			if (storageTarget) {
@@ -1227,6 +1238,7 @@ var RuntimeService = class {
 				lastSavedRevision: 0,
 				pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
 				pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
+				pendingStaleBranchDirectories: /* @__PURE__ */ new Map(),
 				dirty: false,
 				lockHeld: true,
 				closed: false
@@ -1287,6 +1299,7 @@ var RuntimeService = class {
 			lastSavedRevision: 0,
 			pendingStaleSourceFiles: /* @__PURE__ */ new Map(),
 			pendingStaleResourceFolders: /* @__PURE__ */ new Map(),
+			pendingStaleBranchDirectories: /* @__PURE__ */ new Map(),
 			dirty: false,
 			lockHeld: false,
 			closed: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/backend",
-  "version": "0.2.0-alpha.34",
+  "version": "0.2.0-alpha.35",
   "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.34",
-    "@openfairygui/functions": "0.2.0-alpha.34"
+    "@openfairygui/core": "0.2.0-alpha.35",
+    "@openfairygui/functions": "0.2.0-alpha.35"
   },
   "devDependencies": {
     "ava": "^7.0.0",

package/src/services/authoring-service.ts

@@ -1,7 +1,8 @@
-import type { ProjectResourceFolder, ProjectSourceFile } from '@openfairygui/core/project-io';
+import type { ProjectBranchDirectory, ProjectResourceFolder, ProjectSourceFile } from '@openfairygui/core/project-io';
 import {
 	commitUamProjectSourcePaths,
 	materializeUamProject,
+	staleBranchDirectories,
 	staleResourceFolders,
 	staleSourceFiles,
 	type UamProject,
@@ -41,6 +42,10 @@ function resourceFolderKey(folder: ProjectResourceFolder): string {
 	return [folder.branch, folder.packageName, folder.path].join('\0');
 }
 
+function branchDirectoryKey(directory: ProjectBranchDirectory): string {
+	return [directory.branch, directory.packageName ?? ''].join('\0');
+}
+
 function recordStaleProjectFiles(
 	session: Parameters<typeof toSessionSnapshot>[0],
 	previousProject: UamProject,
@@ -59,6 +64,12 @@ function recordStaleProjectFiles(
 	for (const folder of staleResourceFolders(nextProject, previousProject)) {
 		session.pendingStaleResourceFolders.delete(resourceFolderKey(folder));
 	}
+	for (const directory of staleBranchDirectories(previousProject, nextProject)) {
+		session.pendingStaleBranchDirectories.set(branchDirectoryKey(directory), directory);
+	}
+	for (const directory of staleBranchDirectories(nextProject, previousProject)) {
+		session.pendingStaleBranchDirectories.delete(branchDirectoryKey(directory));
+	}
 }
 
 function toBackendDiagnostics(error: ApplyUamTransactionAppError): BackendDiagnostic[] {
@@ -405,12 +416,14 @@ export class AuthoringService {
 				fairyPath: session.fairyPath,
 				staleSourceFiles: [...session.pendingStaleSourceFiles.values()],
 				staleResourceFolders: [...session.pendingStaleResourceFolders.values()],
+				staleBranchDirectories: [...session.pendingStaleBranchDirectories.values()],
 				writtenPaths: committedPaths,
 				failedPaths,
 			});
 			session.fileSystem ??= fileSystem;
 			session.pendingStaleSourceFiles.clear();
 			session.pendingStaleResourceFolders.clear();
+			session.pendingStaleBranchDirectories.clear();
 			commitUamProjectSourcePaths(session.project);
 			session.lastSavedRevision = session.revision;
 			session.dirty = false;
@@ -646,16 +659,19 @@ export class AuthoringService {
 				fairyPath,
 				staleSourceFiles: isSessionStorageTarget ? [...session.pendingStaleSourceFiles.values()] : [],
 				staleResourceFolders: isSessionStorageTarget ? [...session.pendingStaleResourceFolders.values()] : [],
+				staleBranchDirectories: isSessionStorageTarget ? [...session.pendingStaleBranchDirectories.values()] : [],
 				writtenPaths,
 				failedPaths,
 			});
 			if (isSessionStorageTarget) {
 				session.pendingStaleSourceFiles.clear();
 				session.pendingStaleResourceFolders.clear();
+				session.pendingStaleBranchDirectories.clear();
 			}
 			if (storageTarget && !isSessionStorageTarget) {
 				session.pendingStaleSourceFiles.clear();
 				session.pendingStaleResourceFolders.clear();
+				session.pendingStaleBranchDirectories.clear();
 			}
 			if (isSessionStorageTarget || storageTarget) commitUamProjectSourcePaths(session.project);
 			if (storageTarget) {

package/src/services/context.ts

@@ -34,6 +34,8 @@ export interface BackendSessionState {
 	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>;
+	/** Removed package-branch and root-branch directories deferred until controlled files are replaced. */
+	pendingStaleBranchDirectories: Map<string, import('@openfairygui/core/project-io').ProjectBranchDirectory>;
 	dirty: boolean;
 	lockHeld: boolean;
 	closed: boolean;

package/src/services/runtime-service.ts

@@ -238,6 +238,7 @@ export class RuntimeService {
 				lastSavedRevision: 0,
 				pendingStaleSourceFiles: new Map(),
 				pendingStaleResourceFolders: new Map(),
+				pendingStaleBranchDirectories: new Map(),
 				dirty: false,
 				lockHeld: true,
 				closed: false,
@@ -306,6 +307,7 @@ export class RuntimeService {
 			lastSavedRevision: 0,
 			pendingStaleSourceFiles: new Map(),
 			pendingStaleResourceFolders: new Map(),
+			pendingStaleBranchDirectories: new Map(),
 			dirty: false,
 			lockHeld: false,
 			closed: false,

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

@@ -1,5 +1,5 @@
 import type { Document } from '@openfairygui/core';
-import { type FileSystem, type ProjectSourceFile, ProjectWriter } from '@openfairygui/core/project-io';
+import { type FileSystem, type ProjectBranchDirectory, type ProjectSourceFile, ProjectWriter } from '@openfairygui/core/project-io';
 import type { BackendFileSystem } from '../runtime.js';
 
 function createWriterFileSystem(
@@ -54,6 +54,7 @@ export async function writeSessionProject(input: {
 	fairyPath: string;
 	staleSourceFiles: ProjectSourceFile[];
 	staleResourceFolders: import('@openfairygui/core/project-io').ProjectResourceFolder[];
+	staleBranchDirectories: ProjectBranchDirectory[];
 	writtenPaths: string[];
 	failedPaths: string[];
 }): Promise<void> {
@@ -63,5 +64,6 @@ export async function writeSessionProject(input: {
 	await writer.write(input.document, input.fairyPath, {
 		staleSourceFiles: input.staleSourceFiles,
 		staleResourceFolders: input.staleResourceFolders,
+		staleBranchDirectories: input.staleBranchDirectories,
 	});
 }