@openfairygui/functions 0.1.0 → 0.2.0-alpha.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { BinaryWriter, GearType, ProjectType, TransitionActionType } from "@openfairygui/core";
+import { BinaryReader, BinaryWriter, GearType, ProjectType, ProjectWriter, TransitionActionType, UamTransactionError, applyUamTransaction, generateId } from "@openfairygui/core";
 //#region src/inspect.ts
 function mapResource(resource) {
 	return {
@@ -720,7 +720,7 @@ var BinarySearchCompat = class {
 		return this.getCurrent();
 	}
 	getCurrent() {
-		if (this.pot) return Math.trunc(Math.pow(2, this.current));
+		if (this.pot) return Math.trunc(2 ** this.current);
 		if (this.mof) return this.current * 4;
 		return this.current;
 	}
@@ -943,8 +943,8 @@ function swapCompat(items, left, right) {
 function initSizeScheme() {
 	const result = [];
 	for (let w = 5; w <= 13; w += 1) for (let h = 5; h <= 13; h += 1) {
-		const width = Math.pow(2, w);
-		const height = Math.pow(2, h);
+		const width = 2 ** w;
+		const height = 2 ** h;
 		const area = width * height;
 		const aspectRatio = width > height ? width / height : height / width;
 		result.push({
@@ -1914,7 +1914,6 @@ function _readUint32BE(data, offset) {
 }
 /** Collect a Bitmap Font's texture image, packed under the font's ID. */
 async function _collectFontTexture(doc, fontRes, pkg, options) {
-	fontRes.getExtras();
 	const textureId = fontRes.getTextureId?.() ?? "";
 	if (textureId) {
 		const fontId = fontRes.getId();
@@ -2394,21 +2393,21 @@ function renderFguiTypescriptMemberAssignment(member, getMemberByName, variant)
 	return getMemberByName ? `\t\tthis.${member.name} = <${translatedType}><any>(this.getChild("${escapeTypeScriptString(member.originalName)}"));` : `\t\tthis.${member.name} = <${translatedType}><any>(this.getChildAt(${member.index}));`;
 }
 function resolveCodePath(codePath, basePath, fs) {
-	if (isAbsolutePath(codePath)) return trimTrailingSlashes(codePath);
+	if (isAbsolutePath(codePath)) return trimTrailingSlashes$1(codePath);
 	const projectBasePath = resolveProjectBasePath(basePath);
-	return projectBasePath ? trimTrailingSlashes(fs.join(projectBasePath, codePath)) : trimTrailingSlashes(codePath);
+	return projectBasePath ? trimTrailingSlashes$1(fs.join(projectBasePath, codePath)) : trimTrailingSlashes$1(codePath);
 }
 function resolveProjectBasePath(basePath) {
 	if (!basePath) return "";
-	const normalized = trimTrailingSlashes(basePath);
+	const normalized = trimTrailingSlashes$1(basePath);
 	const assetsMatch = normalized.match(/^(.*)[/\\]assets(?:_[^/\\]+)?$/i);
 	if (assetsMatch?.[1]) return assetsMatch[1];
-	return dirname$1(normalized);
+	return dirname$2(normalized);
 }
-function dirname$1(filePath) {
-	return trimTrailingSlashes(filePath).match(/^(.*)[/\\][^/\\]+$/)?.[1] ?? "";
+function dirname$2(filePath) {
+	return trimTrailingSlashes$1(filePath).match(/^(.*)[/\\][^/\\]+$/)?.[1] ?? "";
 }
-function trimTrailingSlashes(value) {
+function trimTrailingSlashes$1(value) {
 	return value.replace(/[/\\]+$/, "");
 }
 function isAbsolutePath(value) {
@@ -2471,6 +2470,820 @@ function decodeText(value) {
 	return new TextDecoder().decode(value);
 }
 //#endregion
+//#region src/restore.ts
+const JTA_FILE_MARK = "yytou";
+const JTA_VERSION = 102;
+const JTA_DEFAULT_FPS = 24;
+const TRANSPARENT_PNG_1X1 = Uint8Array.from([
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10,
+	0,
+	0,
+	0,
+	13,
+	73,
+	72,
+	68,
+	82,
+	0,
+	0,
+	0,
+	1,
+	0,
+	0,
+	0,
+	1,
+	8,
+	6,
+	0,
+	0,
+	0,
+	31,
+	21,
+	196,
+	137,
+	0,
+	0,
+	0,
+	13,
+	73,
+	68,
+	65,
+	84,
+	120,
+	156,
+	99,
+	96,
+	0,
+	0,
+	0,
+	2,
+	0,
+	1,
+	229,
+	39,
+	212,
+	138,
+	0,
+	0,
+	0,
+	0,
+	73,
+	69,
+	78,
+	68,
+	174,
+	66,
+	96,
+	130
+]);
+function normalizeVirtualPath(path) {
+	const normalized = (path ?? "").replace(/\\/g, "/").trim();
+	if (!normalized || normalized === "/") return "";
+	return normalized.replace(/^\/+/, "").replace(/\/+$/, "");
+}
+function resourceFileName(resource) {
+	return resource.getFileName?.() || resource.getFile?.() || resource.getName?.() || "";
+}
+function resourcePublishedFileName(resource) {
+	const publishedFile = (resource.getExtras?.() ?? {})._publishedFile;
+	return typeof publishedFile === "string" ? publishedFile : resourceFileName(resource);
+}
+function normalizePublishedLooseResourceFileName(resource, fileName) {
+	if (resource.propertyType === "MiscResource" && /\.atlas\.txt$/i.test(fileName)) return fileName.replace(/\.atlas\.txt$/i, ".atlas");
+	if (resource.propertyType === "SpineResource" && /\.skel\.bytes$/i.test(fileName)) return fileName.replace(/\.skel\.bytes$/i, ".skel");
+	return fileName;
+}
+function replaceLooseResourceBaseName(resource, fileName) {
+	const normalized = normalizePublishedLooseResourceFileName(resource, fileName);
+	const displayName = resource.getName?.() ?? "";
+	if (!displayName) return normalized;
+	const baseName = fileBaseName(normalized);
+	const ext = /((?:\.[^.\\/]+)+)$/u.exec(baseName)?.[1] ?? "";
+	const currentBaseName = ext ? baseName.slice(0, -ext.length) : baseName;
+	const resourceId = resource.getId?.() ?? "";
+	if (!resourceId || currentBaseName.toLowerCase() !== resourceId.toLowerCase()) return normalized;
+	return `${normalized.slice(0, normalized.length - baseName.length)}${displayName}${ext}`;
+}
+function fileBaseName(fileName) {
+	return fileName.split(/[\\/]/).pop() ?? fileName;
+}
+function stripExtension(fileName) {
+	return fileBaseName(fileName).replace(/\.[^.]+$/u, "");
+}
+function resourceInstanceFileName(resource) {
+	const fileName = (resource.propertyType === "Component" ? `${resource.getName?.() ?? resource.getId?.() ?? "component"}.xml` : resourceFileName(resource)).replace(/\\/g, "/").replace(/^\/+/, "");
+	if (!fileName) return "";
+	if (fileName.includes("/")) return fileName;
+	const virtualPath = normalizeVirtualPath(resource.getPath?.());
+	return virtualPath ? `${virtualPath}/${fileName}` : fileName;
+}
+function isSyntheticFontGlyphResource(resource) {
+	return resource.getExtras?.()?._syntheticFontGlyph === true;
+}
+function glyphDisplayChar(glyph) {
+	const char = glyph.getChar();
+	if (char) return char;
+	const charId = glyph.getCharId();
+	if (charId <= 0) return "";
+	try {
+		return String.fromCodePoint(charId);
+	} catch {
+		return "";
+	}
+}
+function sanitizeGlyphFileSegment(char) {
+	if (!char) return "glyph";
+	return char.replace(/\s/gu, "space").replace(/[\\/:*?"<>|]/gu, "_").replace(/\./gu, "_").split("").filter((item) => {
+		return (item.codePointAt(0) ?? 0) >= 32;
+	}).join("") || "glyph";
+}
+function defaultSyntheticFontGlyphFileName(resourceId) {
+	return `${resourceId}.png`;
+}
+function syntheticFontGlyphVirtualPath(pkg, font) {
+	const pkgName = pkg.getName?.() ?? "";
+	const fontBase = stripExtension(resourceFileName(font)).toLowerCase();
+	if (pkgName === "EmitNumbers") return "/";
+	if (pkgName === "Transition" && fontBase === "number3") return "/";
+	return "/images/";
+}
+function syntheticFontGlyphFileName(pkg, font, glyph, index, glyphCount) {
+	const pkgName = pkg.getName?.() ?? "";
+	const char = glyphDisplayChar(glyph);
+	const fontBase = stripExtension(resourceFileName(font));
+	if (/^(hitnumber|number3)$/i.test(fontBase) && /^[0-9]$/u.test(char)) return `h${char}.png`;
+	if (/^cdtime$/i.test(fontBase) && /^[0-9]$/u.test(char)) return `${char}(4)_png.png`;
+	if (pkgName === "EmitNumbers" && /^number1$/i.test(fontBase)) {
+		if (/^[0-9]$/u.test(char)) return `${char}(2)5_png.png`;
+		if (char === "-") return "m2_png.png";
+	}
+	if (pkgName === "EmitNumbers" && /^number2$/i.test(fontBase)) {
+		if (/^[0-9]$/u.test(char)) return `${char}(4)_png.png`;
+		if (char === "-") return "m1_png.png";
+	}
+	if (pkgName === "Transition" && /^number1$/i.test(fontBase)) {
+		const display = char === "0" && index === glyphCount - 1 ? "0-" : sanitizeGlyphFileSegment(char);
+		return `${String(index).padStart(4, "0")}_${display}_png.png`;
+	}
+	if (pkgName === "Transition" && /^number2$/i.test(fontBase)) return `${String(index).padStart(4, "0")}_${sanitizeGlyphFileSegment(char)}.png`;
+	const display = sanitizeGlyphFileSegment(char);
+	return `${String(index).padStart(4, "0")}_${display}.png`;
+}
+function syntheticFontTextureFileName(font) {
+	return `${stripExtension(resourceFileName(font)) || font.getId?.() || "font"}_atlas.png`;
+}
+function sameVirtualPath(a, b) {
+	return normalizeVirtualPath(a.getPath?.()) === normalizeVirtualPath(b.getPath?.());
+}
+function imageFileName(resource) {
+	const current = resource.getFileName?.() ?? "";
+	if (current) return current;
+	const name = resource.getName?.() ?? resource.getId?.() ?? "image";
+	const fileName = /\.[a-z0-9]+$/i.test(name) ? name : `${name}.png`;
+	resource.setFileName?.(fileName);
+	return fileName;
+}
+function findImageResource(pkg, itemId) {
+	return pkg.listResources().find((resource) => {
+		return resource.propertyType === "ImageResource" && resource.getId?.() === itemId;
+	}) ?? null;
+}
+function fontGlyphCharId(glyph) {
+	const charId = glyph.getCharId();
+	if (charId > 0) return charId;
+	const char = glyph.getChar();
+	return char ? char.codePointAt(0) ?? 0 : 0;
+}
+function scaledFrameDelay(milliseconds) {
+	return milliseconds <= 0 ? 0 : Math.max(1, Math.round(milliseconds / (1e3 / JTA_DEFAULT_FPS)));
+}
+function jtaSpeed(interval) {
+	return interval <= 0 ? 1 : Math.max(1, Math.round(interval / (1e3 / JTA_DEFAULT_FPS)));
+}
+function writeInt16(value) {
+	const data = new Uint8Array(2);
+	new DataView(data.buffer).setInt16(0, value);
+	return data;
+}
+function writeUint16(value) {
+	const data = new Uint8Array(2);
+	new DataView(data.buffer).setUint16(0, value);
+	return data;
+}
+function writeInt32(value) {
+	const data = new Uint8Array(4);
+	new DataView(data.buffer).setInt32(0, value);
+	return data;
+}
+function writeByte(value) {
+	return new Uint8Array([value & 255]);
+}
+function concatBytes(chunks) {
+	const length = chunks.reduce((total, chunk) => total + chunk.byteLength, 0);
+	const data = new Uint8Array(length);
+	let offset = 0;
+	for (const chunk of chunks) {
+		data.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return data;
+}
+function encodeJtaUtf(value) {
+	const bytes = new TextEncoder().encode(value);
+	return concatBytes([writeUint16(bytes.byteLength), bytes]);
+}
+function isPublishedBinaryFile(fileName) {
+	return /_fui\.bytes$/i.test(fileName) || /\.fui$/i.test(fileName) || /\.bin$/i.test(fileName);
+}
+function inferPackageName(fileName) {
+	if (/_fui\.bytes$/i.test(fileName)) return fileName.replace(/_fui\.bytes$/i, "");
+	if (/\.fui$/i.test(fileName)) return fileName.replace(/\.fui$/i, "");
+	return fileName.replace(/\.bin$/i, "");
+}
+function trimTrailingSlashes(value) {
+	return value.replace(/[/\\]+$/, "");
+}
+function normalizeComparablePath(value) {
+	const normalized = trimTrailingSlashes(value).replace(/\\/g, "/");
+	const driveMatch = normalized.match(/^([a-z]:)(?:\/(.*))?$/i);
+	const drivePrefix = driveMatch?.[1].toLowerCase() ?? "";
+	const remainder = driveMatch ? driveMatch[2] ?? "" : normalized;
+	const hasRoot = driveMatch ? true : remainder.startsWith("/");
+	const rawSegments = remainder.split("/").filter((segment) => segment.length > 0);
+	const segments = [];
+	for (const segment of rawSegments) {
+		if (segment === ".") continue;
+		if (segment === "..") {
+			if (segments.length > 0 && segments[segments.length - 1] !== "..") segments.pop();
+			else if (!hasRoot) segments.push("..");
+			continue;
+		}
+		segments.push(segment);
+	}
+	const joined = segments.join("/");
+	return (drivePrefix ? `${drivePrefix}/${joined}`.replace(/\/$/, "") : hasRoot ? `/${joined}`.replace(/\/$/, "") : joined || ".").toLowerCase();
+}
+function dirname$1(filePath) {
+	return trimTrailingSlashes(filePath).match(/^(.*)[/\\][^/\\]+$/)?.[1] ?? "";
+}
+function basename(filePath) {
+	return trimTrailingSlashes(filePath).match(/([^/\\]+)$/)?.[1] ?? "";
+}
+function resolveOutputProjectPath(output, fs) {
+	if (/\.fairy$/i.test(output)) return output;
+	const normalizedOutput = trimTrailingSlashes(output);
+	const projectName = basename(normalizedOutput) || "Restored";
+	return fs.join(normalizedOutput, `${projectName}.fairy`);
+}
+async function prepareRestoreOutputDir(inputDir, outputDir, outputProjectPath, fs, force, outputIsProjectFile) {
+	const [resolvedInputDir, resolvedOutputDir] = await Promise.all([Promise.resolve(fs.resolvePath(inputDir)), Promise.resolve(fs.resolvePath(outputDir))]);
+	if (normalizeComparablePath(resolvedInputDir) === normalizeComparablePath(resolvedOutputDir)) throw new Error("Restore output directory must be different from the published input directory.");
+	if (outputIsProjectFile) {
+		if (!await fs.exists(outputDir)) {
+			await fs.mkdir(outputDir);
+			return;
+		}
+		try {
+			await fs.readdir(outputDir);
+		} catch {
+			throw new Error(`Restore output path is not a directory: ${outputDir}`);
+		}
+		if (!await fs.exists(outputProjectPath)) return;
+		if (!force) throw new Error(`Restore output file already exists: ${outputProjectPath}. Use --force to overwrite it.`);
+		if (!fs.rm) throw new Error("Restore output file already exists and the provided fs does not support rm(...).");
+		await fs.rm(outputProjectPath, {
+			recursive: true,
+			force: true
+		});
+		return;
+	}
+	if (!await fs.exists(outputDir)) {
+		await fs.mkdir(outputDir);
+		return;
+	}
+	let entries;
+	try {
+		entries = await fs.readdir(outputDir);
+	} catch {
+		throw new Error(`Restore output path is not a directory: ${outputDir}`);
+	}
+	if (entries.length === 0) return;
+	if (!force) throw new Error(`Restore output directory is not empty: ${outputDir}. Use --force to overwrite it.`);
+	if (!fs.rm) throw new Error("Restore output directory is not empty and the provided fs does not support rm(...).");
+	await fs.rm(outputDir, {
+		recursive: true,
+		force: true
+	});
+	await fs.mkdir(outputDir);
+}
+async function restore(options) {
+	const sourceDir = trimTrailingSlashes(options.inputDir);
+	const outputIsProjectFile = /\.fairy$/i.test(options.output);
+	const outputProjectPath = resolveOutputProjectPath(options.output, options.fs);
+	await prepareRestoreOutputDir(sourceDir, dirname$1(outputProjectPath) || ".", outputProjectPath, options.fs, options.force === true, outputIsProjectFile);
+	const packageFilter = options.packages?.length ? new Set(options.packages) : null;
+	const candidateBinaryPaths = (await options.fs.readdir(sourceDir)).filter((name) => isPublishedBinaryFile(name)).filter((name) => !packageFilter || packageFilter.has(inferPackageName(name))).map((name) => options.fs.join(sourceDir, name)).sort((left, right) => left.localeCompare(right));
+	const binaryPaths = (await Promise.all(candidateBinaryPaths.map(async (filePath) => await options.fs.isFile(filePath) ? filePath : null))).filter((filePath) => !!filePath).sort((left, right) => left.localeCompare(right));
+	if (binaryPaths.length === 0) throw new Error(`No FairyGUI published binary files found in ${sourceDir}.`);
+	return new RestoreWorkflow(options.fs).restore({
+		binaryPaths,
+		sourceDir,
+		outputProjectPath,
+		projectType: options.projectType,
+		cropImage: options.cropImage,
+		extractImage: options.extractImage
+	});
+}
+var RestoreWorkflow = class {
+	_fs;
+	constructor(fs) {
+		this._fs = fs;
+	}
+	async restore(options) {
+		const warnings = [];
+		const doc = await new BinaryReader(this._fs).readMany(options.binaryPaths);
+		this._initializeProjectDefaults(doc, options.projectType);
+		this._initializeImageFileNames(doc);
+		this._initializeLooseResourceFileNames(doc);
+		await this._synthesizeLooseSkeletonResources(doc, options.sourceDir);
+		this._initializeRestoredResourceRelations(doc);
+		this._initializePublishedFontTextureIds(doc);
+		this._initializeFontTextureImageResources(doc);
+		this._initializeFontGlyphImageResources(doc);
+		this._initializePublishedTextFontResources(doc);
+		this._initializeDisplayObjectFileNames(doc);
+		this._initializePublishedFontDefaults(doc);
+		await new ProjectWriter(this._fs).write(doc, options.outputProjectPath);
+		await this._restoreAssets(doc, options, warnings);
+		return {
+			document: doc,
+			projectPath: options.outputProjectPath,
+			warnings
+		};
+	}
+	_initializeProjectDefaults(doc, projectType) {
+		doc.getRoot().setProjectId(generateId()).setProjectType(projectType ?? ProjectType.Unity).setVersion("3.0").setSettings({
+			publish: {
+				binaryFormat: true,
+				fileExtension: "bytes",
+				compressDesc: false
+			},
+			common: {},
+			adaptation: {}
+		});
+	}
+	_initializeImageFileNames(doc) {
+		for (const pkg of doc.getRoot().listPackages()) for (const resource of pkg.listResources()) {
+			if (resource.propertyType !== "ImageResource") continue;
+			imageFileName(resource);
+			resource.setExtras?.({
+				...resource.getExtras?.() ?? {},
+				_suppressPackageSize: true
+			});
+		}
+	}
+	_initializeLooseResourceFileNames(doc) {
+		for (const pkg of doc.getRoot().listPackages()) for (const resource of pkg.listResources()) {
+			if (![
+				"MiscResource",
+				"SpineResource",
+				"DragonBonesResource",
+				"SoundResource"
+			].includes(resource.propertyType)) continue;
+			const current = resource.getFile?.() ?? "";
+			if (!current) continue;
+			const normalized = replaceLooseResourceBaseName(resource, current);
+			if (normalized !== current) resource.setFile?.(normalized);
+		}
+	}
+	async _synthesizeLooseSkeletonResources(doc, sourceDir) {
+		for (const pkg of doc.getRoot().listPackages()) for (const resource of [...pkg.listResources()]) {
+			let current = resource;
+			if (resource.propertyType === "DragonBonesResource" && /\.skel\.bytes$/i.test(resourceFileName(resource))) {
+				const normalizedFile = resourceFileName(resource).replace(/\.skel\.bytes$/i, ".skel");
+				const atlasBase = stripExtension(normalizedFile).replace(/-(?:pro|ess)$/i, "-pma");
+				if (await this._resolveLooseSourceFile(pkg, sourceDir, `${atlasBase}.atlas`)) current = this._replaceSkeletonResourceType(doc, pkg, resource, "SpineResource", normalizedFile);
+			}
+			if (current.propertyType === "SpineResource") await this._ensureSpineSidecarResources(doc, pkg, current, sourceDir);
+			else if (current.propertyType === "DragonBonesResource") await this._ensureDragonBonesSidecarResources(doc, pkg, current, sourceDir);
+		}
+	}
+	_initializeRestoredResourceRelations(doc) {
+		for (const pkg of doc.getRoot().listPackages()) {
+			const resources = pkg.listResources();
+			for (const resource of resources) if (resource.propertyType === "SpineResource") this._initializeSpineResourceRelation(resource, resources);
+			else if (resource.propertyType === "DragonBonesResource") this._initializeDragonBonesResourceRelation(resource, resources);
+		}
+	}
+	_replaceSkeletonResourceType(doc, pkg, resource, targetType, fileName) {
+		const replacement = targetType === "SpineResource" ? doc.createSpineResource(resource.getName?.() ?? "") : doc.createDragonBonesResource(resource.getName?.() ?? "");
+		replacement.setId?.(resource.getId?.() ?? "").setPath?.(resource.getPath?.() ?? "/").setFile?.(fileName).setExported?.(resource.getExported?.() ?? false).setWidth?.(resource.getWidth?.() ?? 0).setHeight?.(resource.getHeight?.() ?? 0).setRequireIds?.(resource.getRequireIds?.() ?? []).setAtlasNames?.(resource.getAtlasNames?.() ?? []).setAnchor?.(resource.getAnchorX?.() ?? 0, resource.getAnchorY?.() ?? 0).setBranch?.(resource.getBranch?.() ?? "").setBranchItemIds?.(resource.getBranchItemIds?.() ?? []);
+		replacement.setExtras?.({ ...resource.getExtras?.() ?? {} });
+		pkg.removeResource(resource);
+		pkg.addResource(replacement);
+		return replacement;
+	}
+	async _ensureSpineSidecarResources(doc, pkg, resource, sourceDir) {
+		const skeletonBase = stripExtension(resourceFileName(resource).replace(/\.skel\.bytes$/i, ".skel"));
+		if (!skeletonBase) return;
+		const atlasBase = skeletonBase.replace(/-(?:pro|ess)$/i, "-pma");
+		const atlas = await this._ensureLooseMiscResource(doc, pkg, resource, sourceDir, `${atlasBase}.atlas`);
+		const texture = await this._ensureLooseImageResource(doc, pkg, resource, sourceDir, `${atlasBase}.png`);
+		const requireIds = [atlas?.getId?.(), texture?.getId?.()].filter((id) => !!id);
+		if (requireIds.length > 0) resource.setRequireIds?.(requireIds);
+		if (atlas) resource.setAtlasNames?.([atlasBase]);
+	}
+	async _ensureDragonBonesSidecarResources(doc, pkg, resource, sourceDir) {
+		const skeletonBase = stripExtension(resourceFileName(resource)).replace(/_ske$/i, "");
+		if (!skeletonBase) return;
+		const textureJson = await this._ensureLooseMiscResource(doc, pkg, resource, sourceDir, `${skeletonBase}_tex.json`);
+		const textureImage = await this._ensureLooseImageResource(doc, pkg, resource, sourceDir, `${skeletonBase}.png`);
+		const requireIds = [textureJson?.getId?.(), textureImage?.getId?.()].filter((id) => !!id);
+		if (requireIds.length > 0) resource.setRequireIds?.(requireIds);
+	}
+	async _ensureLooseMiscResource(doc, pkg, owner, sourceDir, fileName) {
+		const resources = pkg.listResources();
+		const existing = this._findResourceByFile(resources, owner, "MiscResource", fileName);
+		if (existing) return existing;
+		const sourcePath = await this._resolveLooseSourceFile(pkg, sourceDir, fileName);
+		if (!sourcePath) return null;
+		const resource = doc.createMiscResource(stripExtension(fileName));
+		resource.setId(generateId()).setPath(owner.getPath?.() ?? "/").setBranch(owner.getBranch?.() ?? "").setBranchItemIds(owner.getBranchItemIds?.() ?? []).setExported(false).setFile(fileName);
+		resource.setExtras?.({
+			...resource.getExtras?.() ?? {},
+			_publishedFile: fileBaseName(sourcePath)
+		});
+		pkg.addResource(resource);
+		return resource;
+	}
+	async _ensureLooseImageResource(doc, pkg, owner, sourceDir, fileName) {
+		const resources = pkg.listResources();
+		const existing = this._findResourceByFile(resources, owner, "ImageResource", fileName);
+		if (existing) return existing;
+		const sourcePath = await this._resolveLooseSourceFile(pkg, sourceDir, fileName);
+		if (!sourcePath) return null;
+		const resource = doc.createImageResource(stripExtension(fileName));
+		resource.setId(generateId()).setPath(owner.getPath?.() ?? "/").setBranch(owner.getBranch?.() ?? "").setBranchItemIds(owner.getBranchItemIds?.() ?? []).setExported(false).setFileName(fileName);
+		resource.setExtras?.({
+			...resource.getExtras?.() ?? {},
+			_publishedFile: fileBaseName(sourcePath),
+			_suppressPackageSize: true,
+			_syntheticLooseImage: true
+		});
+		pkg.addResource(resource);
+		return resource;
+	}
+	_initializeDisplayObjectFileNames(doc) {
+		for (const pkg of doc.getRoot().listPackages()) for (const component of pkg.listComponents()) for (const child of component.listChildren()) {
+			if (!child.setFileName || child.getFileName?.()) continue;
+			const resource = this._resolveDisplayObjectResource(doc, pkg, child);
+			const fileName = resource ? resourceInstanceFileName(resource) : "";
+			if (fileName) child.setFileName(fileName);
+		}
+	}
+	_initializeFontGlyphImageResources(doc) {
+		for (const pkg of doc.getRoot().listPackages()) for (const resource of [...pkg.listResources()]) {
+			if (resource.propertyType !== "FontResource") continue;
+			const glyphEntries = /* @__PURE__ */ new Map();
+			for (const [index, glyph] of resource.listGlyphs().entries()) {
+				const glyphId = glyph.getImg?.() ?? "";
+				if (!glyphId || glyphEntries.has(glyphId)) continue;
+				glyphEntries.set(glyphId, {
+					glyph,
+					index
+				});
+			}
+			for (const [glyphId, entry] of glyphEntries) {
+				if (pkg.getResourceById(glyphId)) continue;
+				const image = doc.createImageResource(glyphId);
+				image.setId(glyphId).setPath(syntheticFontGlyphVirtualPath(pkg, resource)).setBranch(resource.getBranch?.() ?? "").setFileName(syntheticFontGlyphFileName(pkg, resource, entry.glyph, entry.index, glyphEntries.size)).setExtras({
+					...image.getExtras?.() ?? {},
+					_syntheticFontGlyph: true,
+					_packageOrderAfterId: resource.getId?.() ?? "",
+					_packageOrderWeight: 1,
+					_suppressPackageSize: true
+				});
+				pkg.addResource(image);
+			}
+		}
+	}
+	_initializeFontTextureImageResources(doc) {
+		for (const pkg of doc.getRoot().listPackages()) for (const resource of [...pkg.listResources()]) {
+			if (resource.propertyType !== "FontResource") continue;
+			const textureId = resource.getTextureId?.() ?? "";
+			if (!textureId || pkg.getResourceById(textureId)) continue;
+			const image = doc.createImageResource(textureId);
+			image.setId(textureId).setPath(resource.getPath?.() ?? "/").setBranch(resource.getBranch?.() ?? "").setFileName(syntheticFontTextureFileName(resource)).setExtras({
+				...image.getExtras?.() ?? {},
+				_syntheticFontTexture: true,
+				_packageOrderAfterId: resource.getId?.() ?? "",
+				_packageOrderWeight: 0,
+				_suppressPackageSize: true
+			});
+			pkg.addResource(image);
+		}
+	}
+	_resolveDisplayObjectResource(doc, pkg, child) {
+		const src = child.getSrc?.() ?? "";
+		if (!src) return null;
+		return (child.getPackageId?.() ? doc.getRoot().getPackageById(child.getPackageId?.() ?? "") : pkg)?.getResourceById(src) ?? null;
+	}
+	_initializeSpineResourceRelation(resource, resources) {
+		const skeletonBase = stripExtension(resourceFileName(resource));
+		if (!skeletonBase) return;
+		const atlasBase = skeletonBase.replace(/-(?:pro|ess)$/i, "-pma");
+		const requireIds = [];
+		const atlas = this._findResourceByFile(resources, resource, "MiscResource", `${atlasBase}.atlas`);
+		const texture = this._findResourceByFile(resources, resource, "ImageResource", `${atlasBase}.png`);
+		if (atlas?.getId?.()) requireIds.push(atlas.getId());
+		if (texture?.getId?.()) requireIds.push(texture.getId());
+		if (requireIds.length > 0) resource.setRequireIds?.(requireIds);
+		if (atlas) resource.setAtlasNames?.([atlasBase]);
+	}
+	_initializeDragonBonesResourceRelation(resource, resources) {
+		const skeletonBase = stripExtension(resourceFileName(resource)).replace(/_ske$/i, "");
+		if (!skeletonBase) return;
+		const requireIds = [];
+		const textureJson = this._findResourceByFile(resources, resource, "MiscResource", `${skeletonBase}_tex.json`);
+		const textureImage = this._findResourceByFile(resources, resource, "ImageResource", `${skeletonBase}.png`);
+		if (textureJson?.getId?.()) requireIds.push(textureJson.getId());
+		if (textureImage?.getId?.()) requireIds.push(textureImage.getId());
+		if (requireIds.length > 0) resource.setRequireIds?.(requireIds);
+	}
+	_findResourceByFile(resources, owner, propertyType, fileName) {
+		const expected = fileName.toLowerCase();
+		return resources.find((resource) => {
+			return resource.propertyType === propertyType && sameVirtualPath(owner, resource) && fileBaseName(resourceFileName(resource)).toLowerCase() === expected;
+		}) ?? null;
+	}
+	_initializePublishedFontDefaults(doc) {
+		for (const pkg of doc.getRoot().listPackages()) for (const resource of pkg.listResources()) {
+			if (resource.propertyType !== "FontResource") continue;
+			const fileName = resourceFileName(resource);
+			if (!/\bsdf\b/i.test(fileName)) continue;
+			if (!resource.getRenderMode?.()) resource.setRenderMode?.("sdfaa");
+			if (!resource.getSamplePointSize?.()) resource.setSamplePointSize?.(60);
+		}
+	}
+	_initializePublishedTextFontResources(doc) {
+		for (const pkg of doc.getRoot().listPackages()) {
+			const fontResources = pkg.listResources().filter((resource) => resource.propertyType === "FontResource");
+			const fontByFileName = new Map(fontResources.map((resource) => [resourceFileName(resource).toLowerCase(), resource]));
+			const fontByDisplayName = new Map(fontResources.map((resource) => [stripExtension(resourceFileName(resource)).toLowerCase(), resource]));
+			for (const component of pkg.listComponents()) for (const child of component.listChildren()) {
+				const font = child.getFont?.() ?? "";
+				if (!font || font.startsWith("ui://")) continue;
+				if (!/\bsdf\b/i.test(font)) continue;
+				const normalized = font.trim().toLowerCase();
+				let resource = fontByDisplayName.get(normalized) ?? fontByFileName.get(`${normalized}.ttf`);
+				if (!resource) {
+					resource = doc.createFontResource(font.trim());
+					resource.setId(generateId()).setPath("/font/").setFileName(`${font.trim()}.ttf`).setExported(false).setRenderMode("sdfaa").setSamplePointSize(60).setTtf(true);
+					pkg.addResource(resource);
+					fontByDisplayName.set(normalized, resource);
+					fontByFileName.set(`${normalized}.ttf`, resource);
+				}
+				child.setFont?.(`ui://${pkg.getId()}${resource.getId?.() ?? ""}`);
+			}
+		}
+	}
+	_initializePublishedFontTextureIds(doc) {
+		for (const pkg of doc.getRoot().listPackages()) {
+			const resources = pkg.listResources();
+			for (const resource of resources) {
+				if (resource.propertyType !== "FontResource") continue;
+				if (resource.getTextureId?.()) continue;
+				if (resource.getTtf?.() !== true) continue;
+				const expectedFileName = syntheticFontTextureFileName(resource).toLowerCase();
+				const texture = resources.find((candidate) => {
+					return candidate.propertyType === "ImageResource" && sameVirtualPath(resource, candidate) && fileBaseName(resourceFileName(candidate)).toLowerCase() === expectedFileName;
+				});
+				if (texture?.getId?.()) resource.setTextureId?.(texture.getId());
+			}
+		}
+	}
+	async _restoreAssets(doc, options, warnings) {
+		for (const pkg of doc.getRoot().listPackages()) {
+			await this._restoreAtlasImages(pkg, options);
+			await this._writeGeneratedResources(pkg, options, warnings);
+			await this._copyLooseResources(pkg, options, warnings);
+		}
+	}
+	async _restoreAtlasImages(pkg, options) {
+		if (!options.cropImage) return;
+		for (const atlas of pkg.listAtlases()) {
+			const sourceAtlas = await this._resolveSourceFile(options.sourceDir, this._sourceFileCandidates(pkg, atlas.getFile()));
+			if (!sourceAtlas) throw new Error(`Atlas image not found for package "${pkg.getName()}": ${this._sourceFileCandidates(pkg, atlas.getFile()).join(", ")}`);
+			for (const sprite of atlas.listSprites()) {
+				const image = findImageResource(pkg, sprite.getItemId());
+				if (!image) continue;
+				if (sprite.getRectWidth() <= 0 || sprite.getRectHeight() <= 0) continue;
+				const outputPath = this._resourceOutputPath(options.outputProjectPath, pkg, image, imageFileName(image));
+				const imageWidth = image.getWidth?.() ?? 0;
+				const imageHeight = image.getHeight?.() ?? 0;
+				const spriteWidth = sprite.getRotated() ? sprite.getRectHeight() : sprite.getRectWidth();
+				const spriteHeight = sprite.getRotated() ? sprite.getRectWidth() : sprite.getRectHeight();
+				await this._mkdirForFile(outputPath);
+				await options.cropImage({
+					sourcePath: sourceAtlas,
+					outputPath,
+					left: sprite.getRectX(),
+					top: sprite.getRectY(),
+					width: sprite.getRectWidth(),
+					height: sprite.getRectHeight(),
+					rotated: sprite.getRotated(),
+					offsetX: sprite.getOffsetX(),
+					offsetY: sprite.getOffsetY(),
+					expectedWidth: Math.max(imageWidth, sprite.getOriginalWidth(), spriteWidth),
+					expectedHeight: Math.max(imageHeight, sprite.getOriginalHeight(), spriteHeight)
+				});
+			}
+		}
+	}
+	async _copyLooseResources(pkg, options, warnings) {
+		for (const resource of pkg.listResources()) {
+			const syntheticLooseImage = resource.getExtras?.()?._syntheticLooseImage === true;
+			if (![
+				"SoundResource",
+				"MiscResource",
+				"SpineResource",
+				"DragonBonesResource"
+			].includes(resource.propertyType) && !syntheticLooseImage) continue;
+			const fileName = resourceFileName(resource);
+			if (!fileName) continue;
+			const sourcePath = await this._resolveSourceFile(options.sourceDir, this._sourceFileCandidates(pkg, resourcePublishedFileName(resource), fileName));
+			if (!sourcePath) {
+				warnings.push(`Loose resource not found for package "${pkg.getName()}": ${fileName}`);
+				continue;
+			}
+			const outputPath = this._resourceOutputPath(options.outputProjectPath, pkg, resource, fileName);
+			await this._mkdirForFile(outputPath);
+			await this._fs.writeFileRaw(outputPath, await this._fs.readFileRaw(sourcePath));
+		}
+	}
+	async _writeGeneratedResources(pkg, options, warnings) {
+		for (const resource of pkg.listResources()) if (resource.propertyType === "FontResource") await this._writeFontFile(pkg, resource, options.outputProjectPath);
+		else if (resource.propertyType === "MovieClipResource") await this._writeMovieClipFile(pkg, resource, options, warnings);
+		await this._writeSyntheticFontGlyphImages(pkg, options.outputProjectPath);
+	}
+	async _writeFontFile(pkg, resource, outputProjectPath) {
+		const fileName = resourceFileName(resource);
+		if (!/\.fnt$/i.test(fileName)) return;
+		const glyphs = resource.listGlyphs?.() ?? [];
+		if (glyphs.length === 0) return;
+		const outputPath = this._resourceOutputPath(outputProjectPath, pkg, resource, fileName);
+		await this._mkdirForFile(outputPath);
+		await this._fs.writeFile(outputPath, this._serializeFont(pkg, resource, glyphs));
+	}
+	_serializeFont(pkg, resource, glyphs) {
+		const isTtf = resource.getTtf?.() === true;
+		const lines = isTtf ? this._serializeTtfFontHeader(pkg, resource, glyphs) : ["info creator=UIBuilder", `common lineHeight=${resource.getLineHeight?.() ?? 0}`];
+		for (const glyph of glyphs) {
+			const charId = fontGlyphCharId(glyph);
+			if (isTtf) lines.push(`char id=${charId} x=${glyph.getX()} y=${glyph.getY()} width=${glyph.getWidth()} height=${glyph.getHeight()} xoffset=${glyph.getXOffset()} yoffset=${glyph.getYOffset()} xadvance=${glyph.getAdvance()} page=0 chnl=${glyph.getChannel()}`);
+			else lines.push(`char id=${charId} img=${glyph.getImg()} xoffset=${glyph.getXOffset()} yoffset=${glyph.getYOffset()} xadvance=${glyph.getAdvance()}`);
+		}
+		return `${lines.join("\n")}\n`;
+	}
+	_serializeTtfFontHeader(pkg, resource, glyphs) {
+		const face = stripExtension(resourceFileName(resource)) || resource.getName?.() || "Font";
+		const lineHeight = resource.getLineHeight?.() ?? 0;
+		const fontSize = resource.getFontSize?.() ?? lineHeight;
+		const textureId = resource.getTextureId?.() ?? "";
+		const textureResource = textureId ? pkg.getResourceById(textureId) : null;
+		const textureName = textureResource ? resourceFileName(textureResource) : `${face}_atlas.png`;
+		const scaleW = textureResource?.getWidth?.() ?? 256;
+		const scaleH = textureResource?.getHeight?.() ?? 256;
+		const base = Math.max(Math.min(fontSize, lineHeight) - 6, 0);
+		return [
+			`info face="${face}" size=${fontSize} bold=0 italic=0 charset="" unicode=1 stretchH=100 smooth=1 aa=1 padding=0,0,0,0 spacing=1,1 outline=0`,
+			`common lineHeight=${lineHeight} base=${base} scaleW=${scaleW} scaleH=${scaleH} pages=1 packed=0 alphaChnl=${resource.getTint?.() ? 1 : 0} redChnl=0 greenChnl=0 blueChnl=0`,
+			`page id=0 file="${textureName}"`,
+			`chars count=${glyphs.length}`
+		];
+	}
+	async _writeMovieClipFile(pkg, resource, options, warnings) {
+		const fileName = resourceFileName(resource);
+		if (!/\.jta$/i.test(fileName)) return;
+		const frames = resource.listFrames?.() ?? [];
+		if (frames.length === 0) return;
+		if (!options.extractImage) {
+			warnings.push(`MovieClip file not generated for package "${pkg.getName()}": ${fileName}`);
+			return;
+		}
+		const sprites = await this._buildSpriteLookup(pkg, options);
+		const textures = [];
+		for (const [index, frame] of frames.entries()) {
+			const spriteEntry = sprites.get(frame.getSpriteId());
+			if (!spriteEntry) {
+				warnings.push(`MovieClip frame sprite not found for package "${pkg.getName()}": ${fileName} frame ${index}`);
+				return;
+			}
+			const sprite = spriteEntry.sprite;
+			if (sprite.getRectWidth() <= 0 || sprite.getRectHeight() <= 0) {
+				textures.push(new Uint8Array(0));
+				continue;
+			}
+			textures.push(await options.extractImage({
+				sourcePath: spriteEntry.sourceAtlas,
+				left: sprite.getRectX(),
+				top: sprite.getRectY(),
+				width: sprite.getRectWidth(),
+				height: sprite.getRectHeight(),
+				rotated: sprite.getRotated(),
+				offsetX: 0,
+				offsetY: 0,
+				expectedWidth: sprite.getRotated() ? sprite.getRectHeight() : sprite.getRectWidth(),
+				expectedHeight: sprite.getRotated() ? sprite.getRectWidth() : sprite.getRectHeight()
+			}));
+		}
+		const outputPath = this._resourceOutputPath(options.outputProjectPath, pkg, resource, fileName);
+		await this._mkdirForFile(outputPath);
+		await this._fs.writeFileRaw(outputPath, this._serializeMovieClip(resource, frames, textures));
+	}
+	async _writeSyntheticFontGlyphImages(pkg, outputProjectPath) {
+		for (const resource of pkg.listResources()) {
+			if (resource.propertyType !== "ImageResource" || !isSyntheticFontGlyphResource(resource)) continue;
+			const fileName = resourceFileName(resource) || defaultSyntheticFontGlyphFileName(resource.getId?.() ?? "glyph");
+			const outputPath = this._resourceOutputPath(outputProjectPath, pkg, resource, fileName);
+			await this._mkdirForFile(outputPath);
+			await this._fs.writeFileRaw(outputPath, TRANSPARENT_PNG_1X1);
+		}
+	}
+	async _buildSpriteLookup(pkg, options) {
+		const sprites = /* @__PURE__ */ new Map();
+		for (const atlas of pkg.listAtlases()) {
+			const sourceAtlas = await this._resolveSourceFile(options.sourceDir, this._sourceFileCandidates(pkg, atlas.getFile()));
+			if (!sourceAtlas) throw new Error(`Atlas image not found for package "${pkg.getName()}": ${this._sourceFileCandidates(pkg, atlas.getFile()).join(", ")}`);
+			for (const sprite of atlas.listSprites()) sprites.set(sprite.getItemId(), {
+				sourceAtlas,
+				sprite
+			});
+		}
+		return sprites;
+	}
+	_serializeMovieClip(resource, frames, textures) {
+		const chunks = [
+			encodeJtaUtf(JTA_FILE_MARK),
+			writeInt32(JTA_VERSION),
+			writeByte(0),
+			writeByte(0),
+			writeByte(0),
+			writeByte(0),
+			writeUint16(0),
+			writeUint16(0),
+			writeUint16(resource.getWidth?.() ?? 0),
+			writeUint16(resource.getHeight?.() ?? 0),
+			writeByte(jtaSpeed(resource.getInterval?.() ?? 0)),
+			writeByte(scaledFrameDelay(resource.getRepeatDelay?.() ?? 0)),
+			writeByte(resource.getSwing?.() ? 1 : 0),
+			writeInt16(frames.length)
+		];
+		for (const [index, frame] of frames.entries()) chunks.push(writeInt16(scaledFrameDelay(frame.getAddDelay())), writeInt16(frame.getRectX()), writeInt16(frame.getRectY()), writeInt16(frame.getRectWidth()), writeInt16(frame.getRectHeight()), writeInt16(textures[index]?.byteLength === 0 ? -1 : index));
+		chunks.push(writeInt16(textures.length));
+		for (const texture of textures) chunks.push(writeInt32(texture.byteLength), texture);
+		return concatBytes(chunks);
+	}
+	_sourceFileCandidates(pkg, fileName, outputFileName = fileName) {
+		const publishName = pkg.getPublishName() || pkg.getName();
+		return Array.from(new Set([
+			`${publishName}_${fileName}`,
+			fileName,
+			`${publishName}_${outputFileName}`,
+			outputFileName
+		]));
+	}
+	async _resolveLooseSourceFile(pkg, sourceDir, outputFileName) {
+		const candidates = outputFileName.endsWith(".atlas") ? this._sourceFileCandidates(pkg, `${outputFileName}.txt`, outputFileName) : outputFileName.endsWith(".skel") ? this._sourceFileCandidates(pkg, `${outputFileName}.bytes`, outputFileName) : this._sourceFileCandidates(pkg, outputFileName);
+		return this._resolveSourceFile(sourceDir, candidates);
+	}
+	async _resolveSourceFile(sourceDir, candidates) {
+		for (const candidate of candidates) {
+			const sourcePath = this._fs.join(sourceDir, candidate);
+			if (await this._fs.isFile(sourcePath)) return sourcePath;
+		}
+		return null;
+	}
+	_resourceOutputPath(outputProjectPath, pkg, resource, fileName) {
+		const basePath = this._fs.dirname(outputProjectPath);
+		const branch = resource.getBranch?.() ?? "";
+		const assetsDir = branch ? `assets_${branch}` : "assets";
+		const virtualPath = normalizeVirtualPath(resource.getPath?.());
+		const pkgDir = this._fs.join(basePath, assetsDir, pkg.getName());
+		return virtualPath ? this._fs.join(pkgDir, virtualPath, fileName) : this._fs.join(pkgDir, fileName);
+	}
+	async _mkdirForFile(filePath) {
+		await this._fs.mkdir(this._fs.dirname(filePath));
+	}
+};
+//#endregion
 //#region src/publish.ts
 const UNITY_PROJECT_TYPE = ProjectType.Unity;
 const COCOS_CREATOR_PROJECT_TYPE = ProjectType.CocosCreator;
@@ -3096,4 +3909,37 @@ function _computeDependencies(pkg, pkgMap) {
 	}
 }
 //#endregion
-export { AUTO_GENERATED_CODE_MARK, ValidationSeverity, atlas, createTransform, inspect, prune, publish, publishCodeGeneration, rename, resolvePublishOptions, validate };
+//#region src/uam-transaction.ts
+function mapTransactionErrorStage(error) {
+	switch (error.code) {
+		case "transaction_unsupported": return "preflight";
+		case "invalid_uam": return "preflight";
+		case "execution_failure": return error.opIndex === void 0 && error.issues !== void 0 ? "postflight" : "execution";
+		case "selector_ambiguity": return error.opIndex === void 0 ? "preflight" : "execution";
+	}
+}
+function applyUamTransactionApp(input) {
+	try {
+		return {
+			ok: true,
+			project: applyUamTransaction(input.project, input.operations)
+		};
+	} catch (error) {
+		if (error instanceof UamTransactionError) return {
+			ok: false,
+			error: {
+				code: error.code,
+				stage: mapTransactionErrorStage(error),
+				message: error.message,
+				opIndex: error.opIndex,
+				opId: error.opId,
+				opKind: error.opKind,
+				selector: error.selector,
+				issues: error.issues
+			}
+		};
+		throw error;
+	}
+}
+//#endregion
+export { AUTO_GENERATED_CODE_MARK, ValidationSeverity, applyUamTransactionApp, atlas, createTransform, inspect, prune, publish, publishCodeGeneration, rename, resolvePublishOptions, restore, validate };