@openfairygui/cli 0.2.0 → 0.3.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/cli",
-  "version": "0.2.0",
+  "version": "0.3.0-alpha.2",
   "description": "FairyGUI Headless Authoring SDK — command-line interface.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -33,13 +33,13 @@
     "restore"
   ],
   "devDependencies": {
-    "@openfairygui/core": "0.2.0",
-    "@openfairygui/functions": "0.2.0"
+    "@openfairygui/functions": "0.3.0-alpha.2",
+    "@openfairygui/core": "0.3.0-alpha.2"
   },
   "dependencies": {
     "commander": "^14.0.2",
     "jiti": "^2.7.0",
-    "@openfairygui/backend": "0.2.0"
+    "@openfairygui/backend": "0.3.0-alpha.2"
   },
   "optionalDependencies": {
     "sharp": ">=0.33.0"

package/src/cli.ts

@@ -3,6 +3,7 @@ import { registerBackendCapabilitiesCommand } from './commands/backend-capabilit
 import { registerInspectCommand } from './commands/inspect.js';
 import { registerPublishCommand } from './commands/publish.js';
 import { registerRestoreCommand } from './commands/restore.js';
+import { registerValidateCommand } from './commands/validate.js';
 import { readPackageVersion } from './utils/package-version.js';
 
 const PACKAGE_VERSION = readPackageVersion();
@@ -15,6 +16,7 @@ function createProgram(): Command {
 	registerInspectCommand(program);
 	registerPublishCommand(program);
 	registerRestoreCommand(program);
+	registerValidateCommand(program);
 	registerBackendCapabilitiesCommand(program);
 
 	program.addHelpText(

package/src/commands/validate.ts

@@ -0,0 +1,25 @@
+import type { Command } from 'commander';
+import { validateProjectNode } from '@openfairygui/functions/node';
+import { resolveFairyPath } from '../utils/project-input.js';
+
+export function registerValidateCommand(program: Command): void {
+	program
+		.command('validate')
+		.description('Validate project structure, references, and source files')
+		.argument('<project-dir>', 'Project root directory or .fairy file')
+		.option('--json', 'Print the machine-readable validation report')
+		.action(async (projectDir: string, options: { json?: boolean }) => {
+			const fairyPath = await resolveFairyPath(projectDir);
+			const report = await validateProjectNode(fairyPath);
+			if (options.json) {
+				console.log(JSON.stringify(report, null, 2));
+			} else {
+				console.log(`${report.status.toUpperCase()}: ${fairyPath}`);
+				for (const diagnostic of report.diagnostics) {
+					const source = diagnostic.sourcePath ? ` (${diagnostic.sourcePath})` : '';
+					console.log(`${diagnostic.severity.toUpperCase()} ${diagnostic.code} ${diagnostic.path}${source}: ${diagnostic.message}`);
+				}
+			}
+			process.exitCode = report.status === 'valid' ? 0 : report.status === 'invalid' ? 1 : 2;
+		});
+}