@openfairygui/functions 0.2.0 → 0.3.0-alpha.2

package/README.md

@@ -13,12 +13,13 @@ npm install --save @openfairygui/core @openfairygui/functions
 ```ts
 import { NodeIO } from '@openfairygui/core/node';
 import { inspect } from '@openfairygui/functions';
-import { publishNode, restoreNode } from '@openfairygui/functions/node';
+import { publishNode, restoreNode, validateProjectNode } from '@openfairygui/functions/node';
 
 const io = new NodeIO();
 const doc = await io.readProject('./MyProject/MyProject.fairy');
 
 const report = inspect(doc);
+const validation = await validateProjectNode('./MyProject/MyProject.fairy');
 await publishNode({ document: doc, output: './release' });
 
 await restoreNode({
@@ -27,17 +28,19 @@ await restoreNode({
 });
 ```
 
-`publishNode` owns the standard Node filesystem, Sharp raster backend, and project plugin discovery. `restoreNode` owns the Node filesystem and Sharp image extraction required by trusted-local artifact recovery. The root `publish()` and `restore()` exports remain the lower-level capability-injected workflows for custom hosts.
+`validateProjectNode` combines detailed project reads, UAM integrity checks, source checks, and Sharp image decoding without writing files. `publishNode` owns the standard Node filesystem, Sharp raster backend, and project plugin discovery. `restoreNode` owns the Node filesystem and Sharp image extraction required by trusted-local artifact recovery. The root `validateProject()`, `publish()`, and `restore()` exports remain lower-level workflows for custom hosts.
 
 ## Browser LayaBox publish
 
 Use `@openfairygui/core/web` to read the raw project, then publish through the browser-only entry. Both filesystems are caller-owned, so they can be File System Access, OPFS, IndexedDB, ZIP, or memory adapters.
 
 ```ts
+import { liftDocumentToUamProject } from '@openfairygui/core';
 import { WebIO } from '@openfairygui/core/web';
-import { publishBrowser } from '@openfairygui/functions/web';
+import { publishBrowser, validateProjectWeb } from '@openfairygui/functions/web';
 
-const document = await new WebIO(sourceFileSystem).readProject('Project.fairy');
+const document = await new WebIO(sourceFileSystem).readProject('Project.fairy', { hydrateResourceBytes: true });
+const validation = await validateProjectWeb(liftDocumentToUamProject(document));
 const result = await publishBrowser({
 	document,
 	sourceFileSystem,

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_publish = require("./publish-CykUJfVa.cjs");
-const require_restore = require("./restore-CEywQUHz.cjs");
+const require_publish = require("./publish-C7qHwEiP.cjs");
+const require_restore = require("./restore-LXbDQqmT.cjs");
 const require_uam_transaction = require("./uam-transaction.cjs");
 //#region src/inspect.ts
 function mapResource(resource) {
@@ -104,125 +104,6 @@ function inspect(doc) {
 	};
 }
 //#endregion
-//#region src/validate.ts
-/**
-* Severity of a validation issue.
-*/
-let ValidationSeverity = /* @__PURE__ */ function(ValidationSeverity) {
-	ValidationSeverity["ERROR"] = "error";
-	ValidationSeverity["WARNING"] = "warning";
-	ValidationSeverity["INFO"] = "info";
-	return ValidationSeverity;
-}({});
-const VALIDATE_DEFAULTS = { throwOnError: false };
-/**
-* Validates a FairyGUI project for common issues:
-* - Missing resource IDs
-* - Broken `ui://` references (src pointing to non-existent resources)
-* - Empty components (no children)
-* - Controllers with no pages
-* - Duplicate resource IDs within a package
-*
-* The validation result is stored in `doc.getRoot().getExtras()._validation`.
-*
-* ```ts
-* await doc.transform(validate({ throwOnError: true }));
-* ```
-*/
-function validate(_options = {}) {
-	const options = {
-		...VALIDATE_DEFAULTS,
-		..._options
-	};
-	return require_publish.createTransform("validate", (doc) => {
-		const issues = [];
-		const root = doc.getRoot();
-		if (!root.getProjectId()) issues.push({
-			severity: ValidationSeverity.WARNING,
-			message: "Project has no ID."
-		});
-		const globalResources = /* @__PURE__ */ new Map();
-		for (const pkg of root.listPackages()) {
-			if (!pkg.getId()) issues.push({
-				severity: ValidationSeverity.ERROR,
-				message: `Package "${pkg.getName()}" has no ID.`,
-				packageName: pkg.getName()
-			});
-			const idSet = /* @__PURE__ */ new Set();
-			for (const res of pkg.listResources()) {
-				const resId = res.getId();
-				if (!resId) {
-					issues.push({
-						severity: ValidationSeverity.WARNING,
-						message: `Resource "${res.getName()}" has no ID.`,
-						packageName: pkg.getName(),
-						resourceName: res.getName()
-					});
-					continue;
-				}
-				if (idSet.has(resId)) issues.push({
-					severity: ValidationSeverity.ERROR,
-					message: `Duplicate resource ID "${resId}" in package "${pkg.getName()}".`,
-					packageName: pkg.getName(),
-					resourceName: res.getName()
-				});
-				idSet.add(resId);
-				globalResources.set(`${pkg.getId()}${resId}`, `${pkg.getName()}/${res.getName()}`);
-			}
-			for (const comp of pkg.listComponents()) {
-				const children = comp.listChildren();
-				if (children.length === 0) issues.push({
-					severity: ValidationSeverity.INFO,
-					message: `Component "${comp.getName()}" has no children.`,
-					packageName: pkg.getName(),
-					componentName: comp.getName()
-				});
-				for (const ctrl of comp.listControllers()) if (ctrl.listPages().length === 0) issues.push({
-					severity: ValidationSeverity.WARNING,
-					message: `Controller "${ctrl.getName()}" in "${comp.getName()}" has no pages.`,
-					packageName: pkg.getName(),
-					componentName: comp.getName()
-				});
-				for (const child of children) {
-					const src = child.getSrc?.();
-					if (!src) continue;
-					if (src.startsWith("ui://")) {
-						const idPart = src.slice(5);
-						if (idPart.length > 8) {
-							const key = `${idPart.slice(0, 8)}${idPart.slice(8)}`;
-							if (!globalResources.has(key)) issues.push({
-								severity: ValidationSeverity.ERROR,
-								message: `Broken reference "${src}" in "${child.getName()}" (component "${comp.getName()}").`,
-								packageName: pkg.getName(),
-								componentName: comp.getName(),
-								resourceName: child.getName()
-							});
-						}
-					}
-				}
-			}
-		}
-		const errors = issues.filter((i) => i.severity === ValidationSeverity.ERROR);
-		const warnings = issues.filter((i) => i.severity === ValidationSeverity.WARNING);
-		const infos = issues.filter((i) => i.severity === ValidationSeverity.INFO);
-		const result = {
-			ok: errors.length === 0,
-			errors,
-			warnings,
-			infos
-		};
-		root.setExtras({
-			...root.getExtras(),
-			_validation: result
-		});
-		const logger = doc.getLogger();
-		if (errors.length) logger.warn(`validate: ${errors.length} error(s) found.`);
-		if (warnings.length) logger.warn(`validate: ${warnings.length} warning(s) found.`);
-		logger.info(`validate: ${issues.length} issue(s) total.`);
-		if (options.throwOnError && errors.length > 0) throw new Error(`Validation failed with ${errors.length} error(s):\n${errors.map((e) => `  - ${e.message}`).join("\n")}`);
-	});
-}
-//#endregion
 //#region src/prune.ts
 const PRUNE_DEFAULTS = {
 	emptyComponents: false,
@@ -321,7 +202,6 @@ function rename(options) {
 }
 //#endregion
 exports.AUTO_GENERATED_CODE_MARK = require_publish.AUTO_GENERATED_CODE_MARK;
-exports.ValidationSeverity = ValidationSeverity;
 exports.applyUamTransactionApp = require_uam_transaction.applyUamTransactionApp;
 exports.applyUamTransactionAppAsync = require_uam_transaction.applyUamTransactionAppAsync;
 exports.atlas = require_publish.atlas;
@@ -337,4 +217,4 @@ exports.rename = rename;
 exports.resolvePackageCodegenPlan = require_publish.resolvePackageCodegenPlan;
 exports.resolvePublishOptions = require_publish.resolvePublishOptions;
 exports.restore = require_restore.restore;
-exports.validate = validate;
+exports.validateProject = require_publish.validateProject;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { a as AtlasRasterInput, c as AtlasRasterResolvedBuffer, d as PublishSourceFileSystem, i as AtlasRasterCompositeInput, l as PublishFileSystem, n as atlas, o as AtlasRasterMetadata, r as AtlasRasterBackend, s as AtlasRasterPipeline, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-CHsu2Y8i.cjs";
 import { A as ExtrasMap, B as ResolvedPublishOptions, C as MaybePromise, D as CliAtlasSettings, E as PluginModule, F as RootProjectSettings, I as publish, L as PublishOptions, M as HasOptionalSrc, N as HasOptionalUrl, O as CliCodeGenerationSettings, P as PublishDependency, R as ResolvePublishOptionsOverrides, S as LoadedPlugin, T as PluginManifest, V as resolvePublishOptions, _ as encodeText, a as RestoreImageExtractor, b as CodeWriter, c as restore, d as CodegenMember, f as CodegenReferencedComponent, g as decodeText, h as buildCodegenClasses, i as RestoreImageExtractInput, j as HasOptionalFont, k as CliPublishSettings, l as AUTO_GENERATED_CODE_MARK, m as ResolvedPackageCodegenPlan, n as RestoreImageCropInput, o as RestoreOptions, p as PublishCodeGenerationOptions, r as RestoreImageCropper, s as RestoreResult, t as RestoreFileSystem, u as CodegenClass, v as publishCodeGeneration, w as Plugin, x as ICodeWriterConfig, y as resolvePackageCodegenPlan, z as ResolvedPublishAtlasOptions } from "./restore-BeWaJNjR.cjs";
 import { ApplyUamTransactionAppDiagnostic, ApplyUamTransactionAppError, ApplyUamTransactionAppInput, ApplyUamTransactionAppResult, applyUamTransactionApp, applyUamTransactionAppAsync } from "./uam-transaction.cjs";
-import { Document, Transform } from "@openfairygui/core";
+import { Document, ProjectDiagnostic, ProjectValidationReport, Transform, UamProject } from "@openfairygui/core";
 
 //#region src/inspect.d.ts
 /**
@@ -69,55 +69,16 @@ interface InspectReport {
 declare function inspect(doc: Document): InspectReport;
 //#endregion
 //#region src/validate.d.ts
-/**
- * Severity of a validation issue.
- */
-declare enum ValidationSeverity {
-  ERROR = "error",
-  WARNING = "warning",
-  INFO = "info"
-}
-/**
- * A single validation issue found in the project.
- */
-interface ValidationIssue {
-  severity: ValidationSeverity;
-  message: string;
-  /** Package name where the issue was found. */
-  packageName?: string;
-  /** Component name where the issue was found. */
-  componentName?: string;
-  /** Resource/object name related to the issue. */
-  resourceName?: string;
-}
-/**
- * Result returned by `validate()`.
- */
-interface ValidationResult {
-  ok: boolean;
-  errors: ValidationIssue[];
-  warnings: ValidationIssue[];
-  infos: ValidationIssue[];
+interface ValidateProjectOptions {
+  /** Diagnostics collected while reading the source project. */
+  readDiagnostics?: readonly ProjectDiagnostic[];
+  /** Whether the reader and host completed every requested check. */
+  complete?: boolean;
+  /** Validate hydrated resource bytes in addition to the UAM graph. */
+  validateSources?: boolean;
 }
-interface ValidateOptions {
-  /** If true, the transform throws on errors. Default: false. */
-  throwOnError?: boolean;
-}
-/**
- * Validates a FairyGUI project for common issues:
- * - Missing resource IDs
- * - Broken `ui://` references (src pointing to non-existent resources)
- * - Empty components (no children)
- * - Controllers with no pages
- * - Duplicate resource IDs within a package
- *
- * The validation result is stored in `doc.getRoot().getExtras()._validation`.
- *
- * ```ts
- * await doc.transform(validate({ throwOnError: true }));
- * ```
- */
-declare function validate(_options?: ValidateOptions): Transform;
+/** Validate one authoritative UAM snapshot without mutating it. */
+declare function validateProject(project: UamProject, options?: ValidateProjectOptions): ProjectValidationReport;
 //#endregion
 //#region src/prune.d.ts
 interface PruneOptions {
@@ -174,4 +135,4 @@ declare function rename(options: RenameOptions): Transform;
  */
 declare function createTransform(name: string, fn: Transform): Transform;
 //#endregion
-export { AUTO_GENERATED_CODE_MARK, type ApplyUamTransactionAppDiagnostic, type ApplyUamTransactionAppError, type ApplyUamTransactionAppInput, type ApplyUamTransactionAppResult, type AtlasOptions, type AtlasRasterBackend, type AtlasRasterCompositeInput, type AtlasRasterInput, type AtlasRasterMetadata, type AtlasRasterPipeline, type AtlasRasterResolvedBuffer, type CliAtlasSettings, type CliCodeGenerationSettings, type CliPublishSettings, type CodeWriter, type CodegenClass, type CodegenMember, type CodegenReferencedComponent, type ExtrasMap, type HasOptionalFont, type HasOptionalSrc, type HasOptionalUrl, type ICodeWriterConfig, type InspectCategoryReport, type InspectReport, type LoadedPlugin, type MaybePromise, type Plugin, type PluginManifest, type PluginModule, type PruneOptions, type PublishCodeGenerationOptions, type PublishDependency, type PublishFileSystem, type PublishOptions, type PublishOutputFileSystem, type PublishSourceFileSystem, type RenameOptions, type ResolvePublishOptionsOverrides, type ResolvedPackageCodegenPlan, type ResolvedPublishAtlasOptions, type ResolvedPublishOptions, type RestoreFileSystem, type RestoreImageCropInput, type RestoreImageCropper, type RestoreImageExtractInput, type RestoreImageExtractor, type RestoreOptions, type RestoreResult, type RootProjectSettings, type ValidateOptions, type ValidationIssue, type ValidationResult, ValidationSeverity, applyUamTransactionApp, applyUamTransactionAppAsync, atlas, buildCodegenClasses, createTransform, decodeText, encodeText, inspect, prune, publish, publishCodeGeneration, rename, resolvePackageCodegenPlan, resolvePublishOptions, restore, validate };
+export { AUTO_GENERATED_CODE_MARK, type ApplyUamTransactionAppDiagnostic, type ApplyUamTransactionAppError, type ApplyUamTransactionAppInput, type ApplyUamTransactionAppResult, type AtlasOptions, type AtlasRasterBackend, type AtlasRasterCompositeInput, type AtlasRasterInput, type AtlasRasterMetadata, type AtlasRasterPipeline, type AtlasRasterResolvedBuffer, type CliAtlasSettings, type CliCodeGenerationSettings, type CliPublishSettings, type CodeWriter, type CodegenClass, type CodegenMember, type CodegenReferencedComponent, type ExtrasMap, type HasOptionalFont, type HasOptionalSrc, type HasOptionalUrl, type ICodeWriterConfig, type InspectCategoryReport, type InspectReport, type LoadedPlugin, type MaybePromise, type Plugin, type PluginManifest, type PluginModule, type PruneOptions, type PublishCodeGenerationOptions, type PublishDependency, type PublishFileSystem, type PublishOptions, type PublishOutputFileSystem, type PublishSourceFileSystem, type RenameOptions, type ResolvePublishOptionsOverrides, type ResolvedPackageCodegenPlan, type ResolvedPublishAtlasOptions, type ResolvedPublishOptions, type RestoreFileSystem, type RestoreImageCropInput, type RestoreImageCropper, type RestoreImageExtractInput, type RestoreImageExtractor, type RestoreOptions, type RestoreResult, type RootProjectSettings, type ValidateProjectOptions, applyUamTransactionApp, applyUamTransactionAppAsync, atlas, buildCodegenClasses, createTransform, decodeText, encodeText, inspect, prune, publish, publishCodeGeneration, rename, resolvePackageCodegenPlan, resolvePublishOptions, restore, validateProject };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { a as AtlasRasterInput, c as AtlasRasterResolvedBuffer, d as PublishSourceFileSystem, i as AtlasRasterCompositeInput, l as PublishFileSystem, n as atlas, o as AtlasRasterMetadata, r as AtlasRasterBackend, s as AtlasRasterPipeline, t as AtlasOptions, u as PublishOutputFileSystem } from "./atlas-C6tbl7nn.js";
 import { A as ExtrasMap, B as ResolvedPublishOptions, C as MaybePromise, D as CliAtlasSettings, E as PluginModule, F as RootProjectSettings, I as publish, L as PublishOptions, M as HasOptionalSrc, N as HasOptionalUrl, O as CliCodeGenerationSettings, P as PublishDependency, R as ResolvePublishOptionsOverrides, S as LoadedPlugin, T as PluginManifest, V as resolvePublishOptions, _ as encodeText, a as RestoreImageExtractor, b as CodeWriter, c as restore, d as CodegenMember, f as CodegenReferencedComponent, g as decodeText, h as buildCodegenClasses, i as RestoreImageExtractInput, j as HasOptionalFont, k as CliPublishSettings, l as AUTO_GENERATED_CODE_MARK, m as ResolvedPackageCodegenPlan, n as RestoreImageCropInput, o as RestoreOptions, p as PublishCodeGenerationOptions, r as RestoreImageCropper, s as RestoreResult, t as RestoreFileSystem, u as CodegenClass, v as publishCodeGeneration, w as Plugin, x as ICodeWriterConfig, y as resolvePackageCodegenPlan, z as ResolvedPublishAtlasOptions } from "./restore-Dh0-Nvms.js";
 import { ApplyUamTransactionAppDiagnostic, ApplyUamTransactionAppError, ApplyUamTransactionAppInput, ApplyUamTransactionAppResult, applyUamTransactionApp, applyUamTransactionAppAsync } from "./uam-transaction.js";
-import { Document, Transform } from "@openfairygui/core";
+import { Document, ProjectDiagnostic, ProjectValidationReport, Transform, UamProject } from "@openfairygui/core";
 
 //#region src/inspect.d.ts
 /**
@@ -69,55 +69,16 @@ interface InspectReport {
 declare function inspect(doc: Document): InspectReport;
 //#endregion
 //#region src/validate.d.ts
-/**
- * Severity of a validation issue.
- */
-declare enum ValidationSeverity {
-  ERROR = "error",
-  WARNING = "warning",
-  INFO = "info"
-}
-/**
- * A single validation issue found in the project.
- */
-interface ValidationIssue {
-  severity: ValidationSeverity;
-  message: string;
-  /** Package name where the issue was found. */
-  packageName?: string;
-  /** Component name where the issue was found. */
-  componentName?: string;
-  /** Resource/object name related to the issue. */
-  resourceName?: string;
-}
-/**
- * Result returned by `validate()`.
- */
-interface ValidationResult {
-  ok: boolean;
-  errors: ValidationIssue[];
-  warnings: ValidationIssue[];
-  infos: ValidationIssue[];
+interface ValidateProjectOptions {
+  /** Diagnostics collected while reading the source project. */
+  readDiagnostics?: readonly ProjectDiagnostic[];
+  /** Whether the reader and host completed every requested check. */
+  complete?: boolean;
+  /** Validate hydrated resource bytes in addition to the UAM graph. */
+  validateSources?: boolean;
 }
-interface ValidateOptions {
-  /** If true, the transform throws on errors. Default: false. */
-  throwOnError?: boolean;
-}
-/**
- * Validates a FairyGUI project for common issues:
- * - Missing resource IDs
- * - Broken `ui://` references (src pointing to non-existent resources)
- * - Empty components (no children)
- * - Controllers with no pages
- * - Duplicate resource IDs within a package
- *
- * The validation result is stored in `doc.getRoot().getExtras()._validation`.
- *
- * ```ts
- * await doc.transform(validate({ throwOnError: true }));
- * ```
- */
-declare function validate(_options?: ValidateOptions): Transform;
+/** Validate one authoritative UAM snapshot without mutating it. */
+declare function validateProject(project: UamProject, options?: ValidateProjectOptions): ProjectValidationReport;
 //#endregion
 //#region src/prune.d.ts
 interface PruneOptions {
@@ -174,4 +135,4 @@ declare function rename(options: RenameOptions): Transform;
  */
 declare function createTransform(name: string, fn: Transform): Transform;
 //#endregion
-export { AUTO_GENERATED_CODE_MARK, type ApplyUamTransactionAppDiagnostic, type ApplyUamTransactionAppError, type ApplyUamTransactionAppInput, type ApplyUamTransactionAppResult, type AtlasOptions, type AtlasRasterBackend, type AtlasRasterCompositeInput, type AtlasRasterInput, type AtlasRasterMetadata, type AtlasRasterPipeline, type AtlasRasterResolvedBuffer, type CliAtlasSettings, type CliCodeGenerationSettings, type CliPublishSettings, type CodeWriter, type CodegenClass, type CodegenMember, type CodegenReferencedComponent, type ExtrasMap, type HasOptionalFont, type HasOptionalSrc, type HasOptionalUrl, type ICodeWriterConfig, type InspectCategoryReport, type InspectReport, type LoadedPlugin, type MaybePromise, type Plugin, type PluginManifest, type PluginModule, type PruneOptions, type PublishCodeGenerationOptions, type PublishDependency, type PublishFileSystem, type PublishOptions, type PublishOutputFileSystem, type PublishSourceFileSystem, type RenameOptions, type ResolvePublishOptionsOverrides, type ResolvedPackageCodegenPlan, type ResolvedPublishAtlasOptions, type ResolvedPublishOptions, type RestoreFileSystem, type RestoreImageCropInput, type RestoreImageCropper, type RestoreImageExtractInput, type RestoreImageExtractor, type RestoreOptions, type RestoreResult, type RootProjectSettings, type ValidateOptions, type ValidationIssue, type ValidationResult, ValidationSeverity, applyUamTransactionApp, applyUamTransactionAppAsync, atlas, buildCodegenClasses, createTransform, decodeText, encodeText, inspect, prune, publish, publishCodeGeneration, rename, resolvePackageCodegenPlan, resolvePublishOptions, restore, validate };
+export { AUTO_GENERATED_CODE_MARK, type ApplyUamTransactionAppDiagnostic, type ApplyUamTransactionAppError, type ApplyUamTransactionAppInput, type ApplyUamTransactionAppResult, type AtlasOptions, type AtlasRasterBackend, type AtlasRasterCompositeInput, type AtlasRasterInput, type AtlasRasterMetadata, type AtlasRasterPipeline, type AtlasRasterResolvedBuffer, type CliAtlasSettings, type CliCodeGenerationSettings, type CliPublishSettings, type CodeWriter, type CodegenClass, type CodegenMember, type CodegenReferencedComponent, type ExtrasMap, type HasOptionalFont, type HasOptionalSrc, type HasOptionalUrl, type ICodeWriterConfig, type InspectCategoryReport, type InspectReport, type LoadedPlugin, type MaybePromise, type Plugin, type PluginManifest, type PluginModule, type PruneOptions, type PublishCodeGenerationOptions, type PublishDependency, type PublishFileSystem, type PublishOptions, type PublishOutputFileSystem, type PublishSourceFileSystem, type RenameOptions, type ResolvePublishOptionsOverrides, type ResolvedPackageCodegenPlan, type ResolvedPublishAtlasOptions, type ResolvedPublishOptions, type RestoreFileSystem, type RestoreImageCropInput, type RestoreImageCropper, type RestoreImageExtractInput, type RestoreImageExtractor, type RestoreOptions, type RestoreResult, type RootProjectSettings, type ValidateProjectOptions, applyUamTransactionApp, applyUamTransactionAppAsync, atlas, buildCodegenClasses, createTransform, decodeText, encodeText, inspect, prune, publish, publishCodeGeneration, rename, resolvePackageCodegenPlan, resolvePublishOptions, restore, validateProject };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { a as decodeText, g as createTransform, h as atlas, i as buildCodegenClasses, l as resolvePackageCodegenPlan, n as resolvePublishOptions, o as encodeText, r as AUTO_GENERATED_CODE_MARK, s as publishCodeGeneration, t as publish } from "./publish-DXoaC1Nl.js";
-import { t as restore } from "./restore-BQp01WY3.js";
+import { _ as validateProject, a as decodeText, g as createTransform, h as atlas, i as buildCodegenClasses, l as resolvePackageCodegenPlan, n as resolvePublishOptions, o as encodeText, r as AUTO_GENERATED_CODE_MARK, s as publishCodeGeneration, t as publish } from "./publish-CyBj2o7n.js";
+import { t as restore } from "./restore-DVo1hXpN.js";
 import { applyUamTransactionApp, applyUamTransactionAppAsync } from "./uam-transaction.js";
 //#region src/inspect.ts
 function mapResource(resource) {
@@ -103,125 +103,6 @@ function inspect(doc) {
 	};
 }
 //#endregion
-//#region src/validate.ts
-/**
-* Severity of a validation issue.
-*/
-let ValidationSeverity = /* @__PURE__ */ function(ValidationSeverity) {
-	ValidationSeverity["ERROR"] = "error";
-	ValidationSeverity["WARNING"] = "warning";
-	ValidationSeverity["INFO"] = "info";
-	return ValidationSeverity;
-}({});
-const VALIDATE_DEFAULTS = { throwOnError: false };
-/**
-* Validates a FairyGUI project for common issues:
-* - Missing resource IDs
-* - Broken `ui://` references (src pointing to non-existent resources)
-* - Empty components (no children)
-* - Controllers with no pages
-* - Duplicate resource IDs within a package
-*
-* The validation result is stored in `doc.getRoot().getExtras()._validation`.
-*
-* ```ts
-* await doc.transform(validate({ throwOnError: true }));
-* ```
-*/
-function validate(_options = {}) {
-	const options = {
-		...VALIDATE_DEFAULTS,
-		..._options
-	};
-	return createTransform("validate", (doc) => {
-		const issues = [];
-		const root = doc.getRoot();
-		if (!root.getProjectId()) issues.push({
-			severity: ValidationSeverity.WARNING,
-			message: "Project has no ID."
-		});
-		const globalResources = /* @__PURE__ */ new Map();
-		for (const pkg of root.listPackages()) {
-			if (!pkg.getId()) issues.push({
-				severity: ValidationSeverity.ERROR,
-				message: `Package "${pkg.getName()}" has no ID.`,
-				packageName: pkg.getName()
-			});
-			const idSet = /* @__PURE__ */ new Set();
-			for (const res of pkg.listResources()) {
-				const resId = res.getId();
-				if (!resId) {
-					issues.push({
-						severity: ValidationSeverity.WARNING,
-						message: `Resource "${res.getName()}" has no ID.`,
-						packageName: pkg.getName(),
-						resourceName: res.getName()
-					});
-					continue;
-				}
-				if (idSet.has(resId)) issues.push({
-					severity: ValidationSeverity.ERROR,
-					message: `Duplicate resource ID "${resId}" in package "${pkg.getName()}".`,
-					packageName: pkg.getName(),
-					resourceName: res.getName()
-				});
-				idSet.add(resId);
-				globalResources.set(`${pkg.getId()}${resId}`, `${pkg.getName()}/${res.getName()}`);
-			}
-			for (const comp of pkg.listComponents()) {
-				const children = comp.listChildren();
-				if (children.length === 0) issues.push({
-					severity: ValidationSeverity.INFO,
-					message: `Component "${comp.getName()}" has no children.`,
-					packageName: pkg.getName(),
-					componentName: comp.getName()
-				});
-				for (const ctrl of comp.listControllers()) if (ctrl.listPages().length === 0) issues.push({
-					severity: ValidationSeverity.WARNING,
-					message: `Controller "${ctrl.getName()}" in "${comp.getName()}" has no pages.`,
-					packageName: pkg.getName(),
-					componentName: comp.getName()
-				});
-				for (const child of children) {
-					const src = child.getSrc?.();
-					if (!src) continue;
-					if (src.startsWith("ui://")) {
-						const idPart = src.slice(5);
-						if (idPart.length > 8) {
-							const key = `${idPart.slice(0, 8)}${idPart.slice(8)}`;
-							if (!globalResources.has(key)) issues.push({
-								severity: ValidationSeverity.ERROR,
-								message: `Broken reference "${src}" in "${child.getName()}" (component "${comp.getName()}").`,
-								packageName: pkg.getName(),
-								componentName: comp.getName(),
-								resourceName: child.getName()
-							});
-						}
-					}
-				}
-			}
-		}
-		const errors = issues.filter((i) => i.severity === ValidationSeverity.ERROR);
-		const warnings = issues.filter((i) => i.severity === ValidationSeverity.WARNING);
-		const infos = issues.filter((i) => i.severity === ValidationSeverity.INFO);
-		const result = {
-			ok: errors.length === 0,
-			errors,
-			warnings,
-			infos
-		};
-		root.setExtras({
-			...root.getExtras(),
-			_validation: result
-		});
-		const logger = doc.getLogger();
-		if (errors.length) logger.warn(`validate: ${errors.length} error(s) found.`);
-		if (warnings.length) logger.warn(`validate: ${warnings.length} warning(s) found.`);
-		logger.info(`validate: ${issues.length} issue(s) total.`);
-		if (options.throwOnError && errors.length > 0) throw new Error(`Validation failed with ${errors.length} error(s):\n${errors.map((e) => `  - ${e.message}`).join("\n")}`);
-	});
-}
-//#endregion
 //#region src/prune.ts
 const PRUNE_DEFAULTS = {
 	emptyComponents: false,
@@ -319,4 +200,4 @@ function rename(options) {
 	});
 }
 //#endregion
-export { AUTO_GENERATED_CODE_MARK, ValidationSeverity, applyUamTransactionApp, applyUamTransactionAppAsync, atlas, buildCodegenClasses, createTransform, decodeText, encodeText, inspect, prune, publish, publishCodeGeneration, rename, resolvePackageCodegenPlan, resolvePublishOptions, restore, validate };
+export { AUTO_GENERATED_CODE_MARK, applyUamTransactionApp, applyUamTransactionAppAsync, atlas, buildCodegenClasses, createTransform, decodeText, encodeText, inspect, prune, publish, publishCodeGeneration, rename, resolvePackageCodegenPlan, resolvePublishOptions, restore, validateProject };

package/dist/node.cjs

@@ -1,12 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_publish = require("./publish-CykUJfVa.cjs");
-const require_restore = require("./restore-CEywQUHz.cjs");
+const require_publish = require("./publish-C7qHwEiP.cjs");
+const require_restore = require("./restore-LXbDQqmT.cjs");
+let _openfairygui_core = require("@openfairygui/core");
+let _openfairygui_core_node = require("@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 });
@@ -46,7 +48,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(require("url").pathToFileURL(__filename).href).import(mainPath);
 	const defaultExport = mod.default;
 	return isObject(defaultExport) ? defaultExport : mod;
@@ -56,9 +58,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);
@@ -86,11 +88,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;
@@ -99,7 +101,7 @@ async function loadSharpBackend() {
 async function loadNodePublishPlugins(document, assetsPath) {
 	const projectDir = document.getProjectDir?.() || (assetsPath ? require_publish.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.
@@ -127,9 +129,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");
@@ -194,7 +196,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.");
@@ -232,8 +234,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) => {
@@ -252,5 +254,70 @@ async function restoreNode(options) {
 	});
 }
 //#endregion
+//#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 _openfairygui_core_node.NodeIO().readProjectDetailed(projectPath, { hydrateResourceBytes: true });
+	if (!read.document) return (0, _openfairygui_core.createProjectValidationReport)(read.diagnostics, false);
+	let project;
+	try {
+		project = (0, _openfairygui_core.liftDocumentToUamProject)(read.document);
+	} catch (error) {
+		return (0, _openfairygui_core.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 = require_publish.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 (0, _openfairygui_core.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 (0, _openfairygui_core.createProjectValidationReport)(diagnostics, read.complete && !diagnostics.some((diagnostic) => diagnostic.code === "decode_capability_unavailable"));
+}
+//#endregion
 exports.publishNode = publishNode;
 exports.restoreNode = restoreNode;
+exports.validateProjectNode = validateProjectNode;