@playcraft/cli 0.0.44 → 0.0.46

package/dist/commands/image.js

@@ -670,6 +670,17 @@ async function runBatchStep(cmd, args, inputPath, outputPath) {
             await safeToFile(sharp(inputPath).resize(targetW, targetH, { fit }), outputPath, inputPath);
             break;
         }
+        case 'crop': {
+            const x = Number(getArg('--x') ?? 0);
+            const y = Number(getArg('--y') ?? 0);
+            const width = Number(getArg('--width'));
+            const height = Number(getArg('--height'));
+            if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+                throw new Error('batch crop requires --width and --height');
+            }
+            await safeToFile(sharp(inputPath).extract({ left: x, top: y, width, height }), outputPath, inputPath);
+            break;
+        }
         case 'convert': {
             const fmt = (getArg('--format') ?? outputPath.split('.').pop() ?? 'png').toLowerCase();
             const quality = Number(getArg('--quality') ?? 85);

package/dist/commands/prad.js

@@ -0,0 +1,61 @@
+import * as fs from 'node:fs';
+import pc from 'picocolors';
+import { checkPradFile } from '../prad/check.js';
+import { explainPradPath, formatExplain } from '../prad/explain.js';
+export function registerPradCommands(program) {
+    const prad = program.command('prad').description('PRAD (PlayCraft Remix Assembly DSL) 校验与调试');
+    prad
+        .command('check')
+        .description('静态校验 docs/atom-tree.json（PRAD 文档）')
+        .argument('[file]', 'PRAD JSON 文件', 'docs/atom-tree.json')
+        .option('--gate <n>', 'Gate 1–4', (v) => parseInt(v, 10))
+        .option('--strict-drafts', 'draft atom 视为 error')
+        .option('--legacy', '允许缺失 pradVersion')
+        .option('--spec-dir <path>', 'PRAD spec 目录（含 spine-registry）')
+        .option('--skills-dir <path>', 'Skills 库目录')
+        .action((file, options) => {
+        if (!fs.existsSync(file)) {
+            console.error(pc.red(`File not found: ${file}`));
+            process.exit(1);
+        }
+        const result = checkPradFile(file, {
+            gate: options.gate,
+            strictDrafts: options.strictDrafts,
+            legacy: options.legacy,
+            specDir: options.specDir,
+            skillsDir: options.skillsDir,
+        });
+        for (const w of result.warnings) {
+            console.log(pc.yellow(`${w.code} [${w.path}] ${w.message}`));
+        }
+        for (const e of result.errors) {
+            console.error(pc.red(`${e.code} [${e.path}] ${e.message}`));
+        }
+        if (result.ok) {
+            console.log(pc.green('prad check: pass'));
+            process.exit(0);
+        }
+        console.error(pc.red(`prad check: fail (${result.errors.length} errors)`));
+        process.exit(1);
+    });
+    prad
+        .command('explain')
+        .description('解释 PRAD 节点 path 的上下文（slot / atom / bindAs）')
+        .argument('[file]', 'PRAD JSON 文件', 'docs/atom-tree.json')
+        .requiredOption('--path <logicalPath>', '逻辑 path，如 scenes.entry.ui_layer.play_btn')
+        .option('--spec-dir <path>', 'PRAD spec 目录')
+        .option('--skills-dir <path>', 'Skills 库目录')
+        .action((file, options) => {
+        if (!fs.existsSync(file)) {
+            console.error(pc.red(`File not found: ${file}`));
+            process.exit(1);
+        }
+        const doc = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        const result = explainPradPath(doc, options.path, {
+            specDir: options.specDir,
+            skillsDir: options.skillsDir,
+        });
+        console.log(formatExplain(result));
+        process.exit(result.found ? 0 : 1);
+    });
+}

package/dist/commands/remix.js

@@ -2,6 +2,7 @@ import inquirer from 'inquirer';
 import { exec } from 'child_process';
 import { loadGlobalConfig } from '../config.js';
 import { DEFAULT_PLAYCRAFT_CLOUD_BASE } from './login.js';
+import { initTemplateCommand } from '../remix/init-template.js';
 function resolveBackendBaseUrl(options) {
     const globalConfig = loadGlobalConfig();
     const raw = options.url ||
@@ -165,6 +166,25 @@ export function registerRemixCommands(program) {
     const remix = program
         .command('remix')
         .description('Remix 工作流命令（JWT 鉴权，调用用户态 API）');
+    remix
+        .command('init-template')
+        .description('Apply engine scaffold (phaser|threejs) to project or bake full templates (maintainer)')
+        .option('--engine <name>', 'Engine adapter: phaser | threejs')
+        .option('--from-atom-tree', 'Read adapter from docs/atom-tree.json meta.engineDecision')
+        .option('--project-dir <path>', 'Project root', process.cwd())
+        .option('--force', 'Replace game/ even when adapter mismatch')
+        .option('--bake', 'Maintainer: write packages/cli/project-templates/{engine}/')
+        .option('--all-engines', 'With --bake: bake phaser and threejs')
+        .action(async (opts) => {
+        await initTemplateCommand({
+            engine: opts.engine,
+            fromAtomTree: Boolean(opts.fromAtomTree),
+            projectDir: String(opts.projectDir || process.cwd()),
+            force: Boolean(opts.force),
+            bake: Boolean(opts.bake),
+            allEngines: Boolean(opts.allEngines),
+        });
+    });
     remix
         .command('create')
         .description('创建 remix 分支（POST /api/projects/:id/branches）')