@openfairygui/functions 0.2.0 → 0.3.0-alpha.2

package/dist/node.d.cts

@@ -1,6 +1,6 @@
 import { r as AtlasRasterBackend } from "./atlas-CHsu2Y8i.cjs";
 import { L as PublishOptions, S as LoadedPlugin, o as RestoreOptions, s as RestoreResult } from "./restore-BeWaJNjR.cjs";
-import { Document } from "@openfairygui/core";
+import { Document, ProjectValidationReport } from "@openfairygui/core";
 
 //#region src/adapters/node/publish.d.ts
 interface PublishNodeOptions extends Omit<PublishOptions, 'atlas' | 'basePath' | 'encoder' | 'fs' | 'plugins'> {
@@ -33,4 +33,7 @@ interface RestoreNodeOptions extends Omit<RestoreOptions, 'fs' | 'cropImage' | '
 /** Restore trusted local published artifacts through the standard Node host adapter. */
 declare function restoreNode(options: RestoreNodeOptions): Promise<RestoreResult>;
 //#endregion
-export { type PublishNodeOptions, type RestoreNodeOptions, publishNode, restoreNode };
+//#region src/adapters/node/validate.d.ts
+declare function validateProjectNode(projectPath: string): Promise<ProjectValidationReport>;
+//#endregion
+export { type PublishNodeOptions, type RestoreNodeOptions, publishNode, restoreNode, validateProjectNode };

package/dist/node.d.ts

@@ -1,6 +1,6 @@
 import { r as AtlasRasterBackend } from "./atlas-C6tbl7nn.js";
 import { L as PublishOptions, S as LoadedPlugin, o as RestoreOptions, s as RestoreResult } from "./restore-Dh0-Nvms.js";
-import { Document } from "@openfairygui/core";
+import { Document, ProjectValidationReport } from "@openfairygui/core";
 
 //#region src/adapters/node/publish.d.ts
 interface PublishNodeOptions extends Omit<PublishOptions, 'atlas' | 'basePath' | 'encoder' | 'fs' | 'plugins'> {
@@ -33,4 +33,7 @@ interface RestoreNodeOptions extends Omit<RestoreOptions, 'fs' | 'cropImage' | '
 /** Restore trusted local published artifacts through the standard Node host adapter. */
 declare function restoreNode(options: RestoreNodeOptions): Promise<RestoreResult>;
 //#endregion
-export { type PublishNodeOptions, type RestoreNodeOptions, publishNode, restoreNode };
+//#region src/adapters/node/validate.d.ts
+declare function validateProjectNode(projectPath: string): Promise<ProjectValidationReport>;
+//#endregion
+export { type PublishNodeOptions, type RestoreNodeOptions, publishNode, restoreNode, validateProjectNode };

package/dist/node.js

@@ -1,11 +1,13 @@
-import { m as formatPluginError, t as publish, u as resolveProjectBasePath } from "./publish-DXoaC1Nl.js";
-import { t as restore } from "./restore-BQp01WY3.js";
+import { _ as validateProject, m as formatPluginError, t as publish, u as resolveProjectBasePath } from "./publish-CyBj2o7n.js";
+import { t as restore } from "./restore-DVo1hXpN.js";
+import { createProjectValidationReport, liftDocumentToUamProject } from "@openfairygui/core";
+import { NodeIO } from "@openfairygui/core/node";
 //#region src/adapters/node/plugins.ts
-const importNative$2 = new Function("id", "return import(id)");
+const importNative$3 = new Function("id", "return import(id)");
 async function loadPlugins(doc, pluginsDir) {
 	if (!pluginsDir) return [];
-	const fs = await importNative$2("node:fs/promises");
-	const path = await importNative$2("node:path");
+	const fs = await importNative$3("node:fs/promises");
+	const path = await importNative$3("node:path");
 	let entries;
 	try {
 		entries = await fs.readdir(pluginsDir, { withFileTypes: true });
@@ -45,7 +47,7 @@ function resolvePluginMain(path, pluginDir, manifest) {
 	return mainPath;
 }
 async function loadPlugin(mainPath) {
-	const { createJiti } = await importNative$2("jiti");
+	const { createJiti } = await importNative$3("jiti");
 	const mod = await createJiti(import.meta.url).import(mainPath);
 	const defaultExport = mod.default;
 	return isObject(defaultExport) ? defaultExport : mod;
@@ -55,9 +57,9 @@ function isObject(value) {
 }
 //#endregion
 //#region src/adapters/node/publish.ts
-const importNative$1 = new Function("id", "return import(id)");
+const importNative$2 = new Function("id", "return import(id)");
 async function createNodePublishFileSystem() {
-	const [fs, path] = await Promise.all([importNative$1("node:fs/promises"), importNative$1("node:path")]);
+	const [fs, path] = await Promise.all([importNative$2("node:fs/promises"), importNative$2("node:path")]);
 	return {
 		async readFileRaw(filePath) {
 			const data = await fs.readFile(filePath);
@@ -85,11 +87,11 @@ async function resolveNodeAssetsPath(document, assetsPath) {
 	if (assetsPath) return assetsPath;
 	const projectDir = document.getProjectDir?.() ?? "";
 	if (!projectDir) return void 0;
-	return (await importNative$1("node:path")).join(projectDir, "assets");
+	return (await importNative$2("node:path")).join(projectDir, "assets");
 }
 async function loadSharpBackend() {
 	try {
-		const loaded = await importNative$1("sharp");
+		const loaded = await importNative$2("sharp");
 		return loaded.default ?? loaded;
 	} catch {
 		return;
@@ -98,7 +100,7 @@ async function loadSharpBackend() {
 async function loadNodePublishPlugins(document, assetsPath) {
 	const projectDir = document.getProjectDir?.() || (assetsPath ? resolveProjectBasePath(assetsPath) : "");
 	if (!projectDir) return [];
-	return loadPlugins(document, (await importNative$1("node:path")).join(projectDir, "plugins"));
+	return loadPlugins(document, (await importNative$2("node:path")).join(projectDir, "plugins"));
 }
 /**
 * Publish a FairyGUI project through the standard Node host adapter.
@@ -126,9 +128,9 @@ async function publishNode(options) {
 }
 //#endregion
 //#region src/adapters/node/restore.ts
-const importNative = new Function("id", "return import(id)");
+const importNative$1 = new Function("id", "return import(id)");
 async function createNodeRestoreFileSystem() {
-	const [fs, path] = await Promise.all([importNative("node:fs/promises"), importNative("node:path")]);
+	const [fs, path] = await Promise.all([importNative$1("node:fs/promises"), importNative$1("node:path")]);
 	return {
 		async readFile(filePath) {
 			return fs.readFile(filePath, "utf-8");
@@ -193,7 +195,7 @@ async function createNodeRestoreFileSystem() {
 async function createRestoreImageProcessors() {
 	let sharp;
 	try {
-		const loaded = await importNative("sharp");
+		const loaded = await importNative$1("sharp");
 		sharp = loaded.default ?? loaded;
 	} catch {
 		throw new Error("restoreNode: Sharp is required to crop atlas images. Install sharp before restoring.");
@@ -231,8 +233,8 @@ async function createRestoreImageProcessors() {
 		if (input.expectedWidth > 0 && input.expectedHeight > 0 && (info.width !== input.expectedWidth || info.height !== input.expectedHeight)) throw new Error(`restore: Cropped image size mismatch for ${targetPath}: expected ${input.expectedWidth}x${input.expectedHeight}, got ${info.width}x${info.height}`);
 		return data;
 	}
-	const fs = await importNative("node:fs/promises");
-	const path = await importNative("node:path");
+	const fs = await importNative$1("node:fs/promises");
+	const path = await importNative$1("node:path");
 	return {
 		extractImage,
 		cropImage: async (input) => {
@@ -251,4 +253,68 @@ async function restoreNode(options) {
 	});
 }
 //#endregion
-export { publishNode, restoreNode };
+//#region src/adapters/node/validate.ts
+const importNative = new Function("id", "return import(id)");
+function sourceName(resource) {
+	return resource.sourcePath ?? resource.fileName ?? resource.file ?? resource.name;
+}
+async function validateProjectNode(projectPath) {
+	const read = await new NodeIO().readProjectDetailed(projectPath, { hydrateResourceBytes: true });
+	if (!read.document) return createProjectValidationReport(read.diagnostics, false);
+	let project;
+	try {
+		project = liftDocumentToUamProject(read.document);
+	} catch (error) {
+		return createProjectValidationReport([...read.diagnostics, {
+			severity: "error",
+			code: "invalid_uam",
+			path: "project",
+			message: `Project cannot be represented as UAM: ${error instanceof Error ? error.message : String(error)}`,
+			sourcePath: projectPath
+		}], false);
+	}
+	const base = validateProject(project, {
+		readDiagnostics: read.diagnostics,
+		complete: read.complete,
+		validateSources: true
+	});
+	let diagnostics = base.diagnostics;
+	const knownCorruptPaths = new Set(base.diagnostics.filter((diagnostic) => diagnostic.code === "corrupt_source").map((diagnostic) => diagnostic.path));
+	const images = project.packages.flatMap((pkg, packageIndex) => pkg.resources.map((resource, resourceIndex) => ({
+		pkg,
+		packageIndex,
+		resource,
+		resourceIndex
+	})).filter(({ resource, packageIndex, resourceIndex }) => resource.kind === "image" && resource.sourceBytes instanceof Uint8Array && !knownCorruptPaths.has(`packages[${packageIndex}].resources[${resourceIndex}]`)));
+	if (images.length === 0) return base;
+	let sharp;
+	try {
+		const loaded = await importNative("sharp");
+		sharp = loaded.default ?? loaded;
+	} catch {
+		return createProjectValidationReport([...base.diagnostics, {
+			severity: "warning",
+			code: "decode_capability_unavailable",
+			path: "project",
+			message: "Sharp is unavailable, so Node image decoding could not be completed."
+		}], false);
+	}
+	const decodedPaths = new Set(images.map(({ packageIndex, resourceIndex }) => `packages[${packageIndex}].resources[${resourceIndex}]`));
+	diagnostics = diagnostics.filter((diagnostic) => diagnostic.code !== "decode_capability_unavailable" || !decodedPaths.has(diagnostic.path));
+	for (const { pkg, packageIndex, resource, resourceIndex } of images) try {
+		await sharp(resource.sourceBytes).raw().toBuffer();
+	} catch (error) {
+		diagnostics.push({
+			severity: "error",
+			code: "corrupt_source",
+			path: `packages[${packageIndex}].resources[${resourceIndex}]`,
+			message: `Image source cannot be decoded: ${error instanceof Error ? error.message : String(error)}`,
+			packageId: pkg.id,
+			resourceId: resource.id,
+			sourcePath: sourceName(resource)
+		});
+	}
+	return createProjectValidationReport(diagnostics, read.complete && !diagnostics.some((diagnostic) => diagnostic.code === "decode_capability_unavailable"));
+}
+//#endregion
+export { publishNode, restoreNode, validateProjectNode };

package/dist/{publish-CykUJfVa.cjs → publish-C7qHwEiP.cjs}

@@ -1,4 +1,21 @@
 let _openfairygui_core = require("@openfairygui/core");
+//#region src/validate.ts
+/** Validate one authoritative UAM snapshot without mutating it. */
+function validateProject(project, options = {}) {
+	const diagnostics = [
+		...options.readDiagnostics ?? [],
+		...(0, _openfairygui_core.validateUamProject)(project),
+		...(0, _openfairygui_core.validateUamReferences)(project)
+	];
+	let complete = options.complete ?? true;
+	if (options.validateSources) {
+		const source = (0, _openfairygui_core.validateUamSourceBytes)(project);
+		diagnostics.push(...source.diagnostics);
+		complete = complete && source.complete;
+	}
+	return (0, _openfairygui_core.createProjectValidationReport)(diagnostics, complete);
+}
+//#endregion
 //#region src/utils.ts
 /**
 * Wraps a transform function, assigning it a name for the transform stack.
@@ -3267,3 +3284,9 @@ Object.defineProperty(exports, "trimTrailingSlashes", {
 		return trimTrailingSlashes;
 	}
 });
+Object.defineProperty(exports, "validateProject", {
+	enumerable: true,
+	get: function() {
+		return validateProject;
+	}
+});

package/dist/{publish-DXoaC1Nl.js → publish-CyBj2o7n.js}

@@ -1,4 +1,21 @@
-import { BinaryWriter, GearType, ProjectType, TransitionActionType, deriveMovieClipModel, parseJta, probeRasterImage } from "@openfairygui/core";
+import { BinaryWriter, GearType, ProjectType, TransitionActionType, createProjectValidationReport, deriveMovieClipModel, parseJta, probeRasterImage, validateUamProject, validateUamReferences, validateUamSourceBytes } from "@openfairygui/core";
+//#region src/validate.ts
+/** Validate one authoritative UAM snapshot without mutating it. */
+function validateProject(project, options = {}) {
+	const diagnostics = [
+		...options.readDiagnostics ?? [],
+		...validateUamProject(project),
+		...validateUamReferences(project)
+	];
+	let complete = options.complete ?? true;
+	if (options.validateSources) {
+		const source = validateUamSourceBytes(project);
+		diagnostics.push(...source.diagnostics);
+		complete = complete && source.complete;
+	}
+	return createProjectValidationReport(diagnostics, complete);
+}
+//#endregion
 //#region src/utils.ts
 /**
 * Wraps a transform function, assigning it a name for the transform stack.
@@ -3171,4 +3188,4 @@ function _computeDependencies(doc, pkg, pkgMap) {
 	}
 }
 //#endregion
-export { decodeText as a, resolveCodeGenerationSettings as c, basename as d, normalizeComparablePath as f, createTransform as g, atlas as h, buildCodegenClasses as i, resolvePackageCodegenPlan as l, formatPluginError as m, resolvePublishOptions as n, encodeText as o, trimTrailingSlashes as p, AUTO_GENERATED_CODE_MARK as r, publishCodeGeneration as s, publish as t, resolveProjectBasePath as u };
+export { validateProject as _, decodeText as a, resolveCodeGenerationSettings as c, basename as d, normalizeComparablePath as f, createTransform as g, atlas as h, buildCodegenClasses as i, resolvePackageCodegenPlan as l, formatPluginError as m, resolvePublishOptions as n, encodeText as o, trimTrailingSlashes as p, AUTO_GENERATED_CODE_MARK as r, publishCodeGeneration as s, publish as t, resolveProjectBasePath as u };

package/dist/{restore-BQp01WY3.js → restore-DVo1hXpN.js}

@@ -1,4 +1,4 @@
-import { d as basename, f as normalizeComparablePath, p as trimTrailingSlashes } from "./publish-DXoaC1Nl.js";
+import { d as basename, f as normalizeComparablePath, p as trimTrailingSlashes } from "./publish-CyBj2o7n.js";
 import { BinaryReader, ProjectType, ProjectWriter, generateId } from "@openfairygui/core";
 //#region src/restore-internals/output-transaction.ts
 function isPathWithin(root, candidate) {

package/dist/{restore-CEywQUHz.cjs → restore-LXbDQqmT.cjs}

@@ -1,4 +1,4 @@
-const require_publish = require("./publish-CykUJfVa.cjs");
+const require_publish = require("./publish-C7qHwEiP.cjs");
 let _openfairygui_core = require("@openfairygui/core");
 //#region src/restore-internals/output-transaction.ts
 function isPathWithin(root, candidate) {

package/dist/uam-transaction.cjs

@@ -13,7 +13,7 @@ function compactDiagnostic(diagnostic) {
 	return Object.fromEntries(Object.entries(diagnostic).filter(([, value]) => value !== void 0));
 }
 function isTransactionSupportIssue(issue) {
-	return "code" in issue;
+	return !("severity" in issue);
 }
 function mapTransactionDiagnostics(error) {
 	if (error.issues?.length) return error.issues.map((issue) => {

package/dist/uam-transaction.js

@@ -12,7 +12,7 @@ function compactDiagnostic(diagnostic) {
 	return Object.fromEntries(Object.entries(diagnostic).filter(([, value]) => value !== void 0));
 }
 function isTransactionSupportIssue(issue) {
-	return "code" in issue;
+	return !("severity" in issue);
 }
 function mapTransactionDiagnostics(error) {
 	if (error.issues?.length) return error.issues.map((issue) => {

package/dist/web.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_publish = require("./publish-CykUJfVa.cjs");
+const require_publish = require("./publish-C7qHwEiP.cjs");
 let _openfairygui_core = require("@openfairygui/core");
 let fast_xml_parser = require("fast-xml-parser");
 //#region src/adapters/web/raster.ts
@@ -186,6 +186,9 @@ async function decodeRaster(bytes, mimeType) {
 		bitmap.close();
 	}
 }
+async function validateBrowserImageSource(bytes, path) {
+	await decodeRaster(bytes, imageMimeType(path));
+}
 async function decodeSvgWithDom(blob) {
 	if (typeof globalThis.Image !== "function" || typeof globalThis.URL?.createObjectURL !== "function" || typeof globalThis.URL?.revokeObjectURL !== "function") throw new Error("publishBrowser: createImageBitmap rejected SVG and DOM image decoding is unavailable.");
 	const url = globalThis.URL.createObjectURL(blob);
@@ -437,4 +440,46 @@ async function publishBrowser(options) {
 	}
 }
 //#endregion
+//#region src/adapters/web/validate.ts
+function sourceName(resource) {
+	return resource.sourcePath ?? resource.fileName ?? resource.name;
+}
+async function validateProjectWeb(project) {
+	const base = require_publish.validateProject(project, { validateSources: true });
+	if (!project.packages.some((pkg) => pkg.resources.some((resource) => resource.kind === "image" && resource.sourceBytes instanceof Uint8Array))) return base;
+	try {
+		assertBrowserImageSupport();
+	} catch (error) {
+		return (0, _openfairygui_core.createProjectValidationReport)([...base.diagnostics, {
+			severity: "warning",
+			code: "decode_capability_unavailable",
+			path: "project",
+			message: error instanceof Error ? error.message : String(error)
+		}], false);
+	}
+	const decodedPaths = /* @__PURE__ */ new Set();
+	const diagnostics = [...base.diagnostics];
+	for (const [packageIndex, pkg] of project.packages.entries()) for (const [resourceIndex, resource] of pkg.resources.entries()) {
+		if (resource.kind !== "image" || !(resource.sourceBytes instanceof Uint8Array)) continue;
+		try {
+			await validateBrowserImageSource(resource.sourceBytes, sourceName(resource));
+			decodedPaths.add(`packages[${packageIndex}].resources[${resourceIndex}]`);
+		} catch (error) {
+			const capabilityUnavailable = error instanceof Error && /(?:required|unavailable)/iu.test(error.message);
+			diagnostics.push({
+				severity: capabilityUnavailable ? "warning" : "error",
+				code: capabilityUnavailable ? "decode_capability_unavailable" : "corrupt_source",
+				path: `packages[${packageIndex}].resources[${resourceIndex}]`,
+				message: `Image source cannot be decoded: ${error instanceof Error ? error.message : String(error)}`,
+				packageId: pkg.id,
+				resourceId: resource.id,
+				sourcePath: sourceName(resource)
+			});
+		}
+	}
+	const resolved = diagnostics.filter((diagnostic) => diagnostic.code !== "decode_capability_unavailable" || !decodedPaths.has(diagnostic.path));
+	return (0, _openfairygui_core.createProjectValidationReport)(resolved, !resolved.some((diagnostic) => diagnostic.code === "decode_capability_unavailable"));
+}
+//#endregion
 exports.publishBrowser = publishBrowser;
+exports.validateProjectWeb = validateProjectWeb;

package/dist/web.d.cts

@@ -1,5 +1,5 @@
 import { d as PublishSourceFileSystem, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-CHsu2Y8i.cjs";
-import { Document } from "@openfairygui/core";
+import { Document, ProjectValidationReport, UamProject } from "@openfairygui/core";
 
 //#region src/adapters/web/publish.d.ts
 type BrowserPublishProjectType = 'layabox';
@@ -41,4 +41,7 @@ interface BrowserPublishResult {
  */
 declare function publishBrowser(options: BrowserPublishOptions): Promise<BrowserPublishResult>;
 //#endregion
-export { type BrowserPublishAtlasOptions, type BrowserPublishDiagnostic, type BrowserPublishOptions, type BrowserPublishOutputFileSystem, type BrowserPublishProjectType, type BrowserPublishResult, type BrowserPublishSourceFileSystem, type BrowserPublishedFile, publishBrowser };
+//#region src/adapters/web/validate.d.ts
+declare function validateProjectWeb(project: UamProject): Promise<ProjectValidationReport>;
+//#endregion
+export { type BrowserPublishAtlasOptions, type BrowserPublishDiagnostic, type BrowserPublishOptions, type BrowserPublishOutputFileSystem, type BrowserPublishProjectType, type BrowserPublishResult, type BrowserPublishSourceFileSystem, type BrowserPublishedFile, publishBrowser, validateProjectWeb };

package/dist/web.d.ts

@@ -1,5 +1,5 @@
 import { d as PublishSourceFileSystem, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-C6tbl7nn.js";
-import { Document } from "@openfairygui/core";
+import { Document, ProjectValidationReport, UamProject } from "@openfairygui/core";
 
 //#region src/adapters/web/publish.d.ts
 type BrowserPublishProjectType = 'layabox';
@@ -41,4 +41,7 @@ interface BrowserPublishResult {
  */
 declare function publishBrowser(options: BrowserPublishOptions): Promise<BrowserPublishResult>;
 //#endregion
-export { type BrowserPublishAtlasOptions, type BrowserPublishDiagnostic, type BrowserPublishOptions, type BrowserPublishOutputFileSystem, type BrowserPublishProjectType, type BrowserPublishResult, type BrowserPublishSourceFileSystem, type BrowserPublishedFile, publishBrowser };
+//#region src/adapters/web/validate.d.ts
+declare function validateProjectWeb(project: UamProject): Promise<ProjectValidationReport>;
+//#endregion
+export { type BrowserPublishAtlasOptions, type BrowserPublishDiagnostic, type BrowserPublishOptions, type BrowserPublishOutputFileSystem, type BrowserPublishProjectType, type BrowserPublishResult, type BrowserPublishSourceFileSystem, type BrowserPublishedFile, publishBrowser, validateProjectWeb };

package/dist/web.js

@@ -1,5 +1,5 @@
-import { c as resolveCodeGenerationSettings, n as resolvePublishOptions, t as publish } from "./publish-DXoaC1Nl.js";
-import { ProjectType } from "@openfairygui/core";
+import { _ as validateProject, c as resolveCodeGenerationSettings, n as resolvePublishOptions, t as publish } from "./publish-CyBj2o7n.js";
+import { ProjectType, createProjectValidationReport } from "@openfairygui/core";
 import { XMLParser, XMLValidator } from "fast-xml-parser";
 //#region src/adapters/web/raster.ts
 const MAX_SVG_SOURCE_BYTES = 8 * 1024 * 1024;
@@ -185,6 +185,9 @@ async function decodeRaster(bytes, mimeType) {
 		bitmap.close();
 	}
 }
+async function validateBrowserImageSource(bytes, path) {
+	await decodeRaster(bytes, imageMimeType(path));
+}
 async function decodeSvgWithDom(blob) {
 	if (typeof globalThis.Image !== "function" || typeof globalThis.URL?.createObjectURL !== "function" || typeof globalThis.URL?.revokeObjectURL !== "function") throw new Error("publishBrowser: createImageBitmap rejected SVG and DOM image decoding is unavailable.");
 	const url = globalThis.URL.createObjectURL(blob);
@@ -436,4 +439,45 @@ async function publishBrowser(options) {
 	}
 }
 //#endregion
-export { publishBrowser };
+//#region src/adapters/web/validate.ts
+function sourceName(resource) {
+	return resource.sourcePath ?? resource.fileName ?? resource.name;
+}
+async function validateProjectWeb(project) {
+	const base = validateProject(project, { validateSources: true });
+	if (!project.packages.some((pkg) => pkg.resources.some((resource) => resource.kind === "image" && resource.sourceBytes instanceof Uint8Array))) return base;
+	try {
+		assertBrowserImageSupport();
+	} catch (error) {
+		return createProjectValidationReport([...base.diagnostics, {
+			severity: "warning",
+			code: "decode_capability_unavailable",
+			path: "project",
+			message: error instanceof Error ? error.message : String(error)
+		}], false);
+	}
+	const decodedPaths = /* @__PURE__ */ new Set();
+	const diagnostics = [...base.diagnostics];
+	for (const [packageIndex, pkg] of project.packages.entries()) for (const [resourceIndex, resource] of pkg.resources.entries()) {
+		if (resource.kind !== "image" || !(resource.sourceBytes instanceof Uint8Array)) continue;
+		try {
+			await validateBrowserImageSource(resource.sourceBytes, sourceName(resource));
+			decodedPaths.add(`packages[${packageIndex}].resources[${resourceIndex}]`);
+		} catch (error) {
+			const capabilityUnavailable = error instanceof Error && /(?:required|unavailable)/iu.test(error.message);
+			diagnostics.push({
+				severity: capabilityUnavailable ? "warning" : "error",
+				code: capabilityUnavailable ? "decode_capability_unavailable" : "corrupt_source",
+				path: `packages[${packageIndex}].resources[${resourceIndex}]`,
+				message: `Image source cannot be decoded: ${error instanceof Error ? error.message : String(error)}`,
+				packageId: pkg.id,
+				resourceId: resource.id,
+				sourcePath: sourceName(resource)
+			});
+		}
+	}
+	const resolved = diagnostics.filter((diagnostic) => diagnostic.code !== "decode_capability_unavailable" || !decodedPaths.has(diagnostic.path));
+	return createProjectValidationReport(resolved, !resolved.some((diagnostic) => diagnostic.code === "decode_capability_unavailable"));
+}
+//#endregion
+export { publishBrowser, validateProjectWeb };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/functions",
-  "version": "0.2.0",
+  "version": "0.3.0-alpha.2",
   "description": "FairyGUI Headless Authoring SDK — composable transform functions.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -75,7 +75,7 @@
   "dependencies": {
     "fast-xml-parser": "^5.0.0",
     "jiti": "^2.6.1",
-    "@openfairygui/core": "0.2.0"
+    "@openfairygui/core": "0.3.0-alpha.2"
   },
   "optionalDependencies": {
     "sharp": ">=0.33.0"

package/src/adapters/node/validate.ts

@@ -0,0 +1,93 @@
+import {
+	createProjectValidationReport,
+	liftDocumentToUamProject,
+	type ProjectDiagnostic,
+	type ProjectValidationReport,
+	type UamProject,
+} from '@openfairygui/core';
+import { NodeIO } from '@openfairygui/core/node';
+import { validateProject } from '../../validate.js';
+
+const importNative = new Function('id', 'return import(id)') as <T>(id: string) => Promise<T>;
+
+function sourceName(resource: {
+	kind: string;
+	name: string;
+	fileName?: string;
+	file?: string;
+	sourcePath?: string;
+}): string {
+	return resource.sourcePath ?? resource.fileName ?? resource.file ?? resource.name;
+}
+
+export async function validateProjectNode(projectPath: string): Promise<ProjectValidationReport> {
+	const read = await new NodeIO().readProjectDetailed(projectPath, { hydrateResourceBytes: true });
+	if (!read.document) return createProjectValidationReport(read.diagnostics, false);
+
+	let project: UamProject;
+	try {
+		project = liftDocumentToUamProject(read.document);
+	} catch (error) {
+		return createProjectValidationReport([...read.diagnostics, {
+			severity: 'error',
+			code: 'invalid_uam',
+			path: 'project',
+			message: `Project cannot be represented as UAM: ${error instanceof Error ? error.message : String(error)}`,
+			sourcePath: projectPath,
+		}], false);
+	}
+	const base = validateProject(project, {
+		readDiagnostics: read.diagnostics,
+		complete: read.complete,
+		validateSources: true,
+	});
+	let diagnostics: ProjectDiagnostic[] = base.diagnostics;
+	const knownCorruptPaths = new Set(base.diagnostics
+		.filter((diagnostic) => diagnostic.code === 'corrupt_source')
+		.map((diagnostic) => diagnostic.path));
+	const images = project.packages.flatMap((pkg, packageIndex) => pkg.resources
+		.map((resource, resourceIndex) => ({ pkg, packageIndex, resource, resourceIndex }))
+		.filter(({ resource, packageIndex, resourceIndex }) => (
+			resource.kind === 'image'
+			&& resource.sourceBytes instanceof Uint8Array
+			&& !knownCorruptPaths.has(`packages[${packageIndex}].resources[${resourceIndex}]`)
+		)));
+	if (images.length === 0) return base;
+
+	let sharp: ((bytes: Uint8Array) => { raw(): { toBuffer(): Promise<unknown> } });
+	try {
+		const loaded = await importNative<typeof import('sharp')>('sharp');
+		sharp = (loaded as unknown as { default?: typeof loaded }).default ?? loaded;
+	} catch {
+		return createProjectValidationReport([...base.diagnostics, {
+			severity: 'warning',
+			code: 'decode_capability_unavailable',
+			path: 'project',
+			message: 'Sharp is unavailable, so Node image decoding could not be completed.',
+		}], false);
+	}
+	const decodedPaths = new Set(images.map(({ packageIndex, resourceIndex }) => `packages[${packageIndex}].resources[${resourceIndex}]`));
+	diagnostics = diagnostics.filter((diagnostic) => (
+		diagnostic.code !== 'decode_capability_unavailable' || !decodedPaths.has(diagnostic.path)
+	));
+
+	for (const { pkg, packageIndex, resource, resourceIndex } of images) {
+		try {
+			await sharp(resource.sourceBytes!).raw().toBuffer();
+		} catch (error) {
+			diagnostics.push({
+				severity: 'error',
+				code: 'corrupt_source',
+				path: `packages[${packageIndex}].resources[${resourceIndex}]`,
+				message: `Image source cannot be decoded: ${error instanceof Error ? error.message : String(error)}`,
+				packageId: pkg.id,
+				resourceId: resource.id,
+				sourcePath: sourceName(resource),
+			});
+		}
+	}
+	return createProjectValidationReport(
+		diagnostics,
+		read.complete && !diagnostics.some((diagnostic) => diagnostic.code === 'decode_capability_unavailable'),
+	);
+}

package/src/adapters/web/raster.ts

@@ -265,6 +265,10 @@ async function decodeRaster(bytes: Uint8Array, mimeType: string): Promise<Browse
 	}
 }
 
+export async function validateBrowserImageSource(bytes: Uint8Array, path: string): Promise<void> {
+	await decodeRaster(bytes, imageMimeType(path));
+}
+
 async function decodeSvgWithDom(blob: Blob): Promise<BrowserRaster> {
 	if (typeof globalThis.Image !== 'function'
 		|| typeof globalThis.URL?.createObjectURL !== 'function'

package/src/adapters/web/validate.ts

@@ -0,0 +1,60 @@
+import {
+	createProjectValidationReport,
+	type ProjectDiagnostic,
+	type ProjectValidationReport,
+	type UamProject,
+} from '@openfairygui/core';
+import { validateProject } from '../../validate.js';
+import { assertBrowserImageSupport, validateBrowserImageSource } from './raster.js';
+
+function sourceName(resource: {
+	name: string;
+	fileName?: string;
+	sourcePath?: string;
+}): string {
+	return resource.sourcePath ?? resource.fileName ?? resource.name;
+}
+
+export async function validateProjectWeb(project: UamProject): Promise<ProjectValidationReport> {
+	const base = validateProject(project, { validateSources: true });
+	const hasHydratedImages = project.packages.some((pkg) => pkg.resources.some(
+		(resource) => resource.kind === 'image' && resource.sourceBytes instanceof Uint8Array,
+	));
+	if (!hasHydratedImages) return base;
+	try {
+		assertBrowserImageSupport();
+	} catch (error) {
+		return createProjectValidationReport([...base.diagnostics, {
+			severity: 'warning',
+			code: 'decode_capability_unavailable',
+			path: 'project',
+			message: error instanceof Error ? error.message : String(error),
+		}], false);
+	}
+	const decodedPaths = new Set<string>();
+	const diagnostics: ProjectDiagnostic[] = [...base.diagnostics];
+	for (const [packageIndex, pkg] of project.packages.entries()) {
+		for (const [resourceIndex, resource] of pkg.resources.entries()) {
+			if (resource.kind !== 'image' || !(resource.sourceBytes instanceof Uint8Array)) continue;
+			try {
+				await validateBrowserImageSource(resource.sourceBytes, sourceName(resource));
+				decodedPaths.add(`packages[${packageIndex}].resources[${resourceIndex}]`);
+			} catch (error) {
+				const capabilityUnavailable = error instanceof Error && /(?:required|unavailable)/iu.test(error.message);
+				diagnostics.push({
+					severity: capabilityUnavailable ? 'warning' : 'error',
+					code: capabilityUnavailable ? 'decode_capability_unavailable' : 'corrupt_source',
+					path: `packages[${packageIndex}].resources[${resourceIndex}]`,
+					message: `Image source cannot be decoded: ${error instanceof Error ? error.message : String(error)}`,
+					packageId: pkg.id,
+					resourceId: resource.id,
+					sourcePath: sourceName(resource),
+				});
+			}
+		}
+	}
+	const resolved = diagnostics.filter((diagnostic) => (
+		diagnostic.code !== 'decode_capability_unavailable' || !decodedPaths.has(diagnostic.path)
+	));
+	return createProjectValidationReport(resolved, !resolved.some((diagnostic) => diagnostic.code === 'decode_capability_unavailable'));
+}

package/src/index.ts

@@ -1,10 +1,7 @@
 export { inspect, type InspectReport, type InspectCategoryReport } from './inspect.js';
 export {
-	validate,
-	type ValidateOptions,
-	type ValidationResult,
-	type ValidationIssue,
-	ValidationSeverity,
+	validateProject,
+	type ValidateProjectOptions,
 } from './validate.js';
 export { prune, type PruneOptions } from './prune.js';
 export { rename, type RenameOptions } from './rename.js';