@playcraft/cli 0.1.64 → 0.1.66

package/README.md

@@ -258,16 +258,16 @@ PLAYCRAFT_TOOL_REQUEST_ID=<错误中显示的请求编号> playcraft tools build
 
 ### 构建相关
 
-| 命令             | 说明                                     | 示例                                                   |
-| ---------------- | ---------------------------------------- | ------------------------------------------------------ |
-| `build`          | 完整打包（阶段1 + 阶段2）                | `playcraft build --platform facebook`                  |
-| `build-base`     | 仅执行阶段1（生成多文件产物）            | `playcraft build-base ./src --output ./build`          |
-| `build-playable` | 仅执行阶段2（从多文件产物生成 Playable） | `playcraft build-playable ./build --platform facebook` |
-| `analyze`        | 生成打包分析报告                         | `playcraft analyze --platform facebook`                |
+| 命令             | 说明                                           | 示例                                                   |
+| ---------------- | ---------------------------------------------- | ------------------------------------------------------ |
+| `build`          | 本地构建预览，产物为 `dist/preview/index.html` | `playcraft build`                                      |
+| `build-base`     | 仅执行阶段1（生成多文件产物）                  | `playcraft build-base ./src --output ./build`          |
+| `build-playable` | 仅执行阶段2（从多文件产物生成 Playable）       | `playcraft build-playable ./build --platform facebook` |
+| `analyze`        | 生成打包分析报告                               | `playcraft analyze --platform facebook`                |
 
 ## 🎯 支持的平台
 
-现已支持 **10 个主流广告平台**：
+平台导出支持以下主流广告平台（渠道包通过平台导出生成，`playcraft build` 只做本地预览构建）：
 
 | 平台              | 格式     | 大小限制             | SDK/API      |
 | ----------------- | -------- | -------------------- | ------------ |
@@ -296,45 +296,39 @@ playcraft start --project your-project-id
 # 3. 在本地 IDE 编辑代码，云端编辑器自动同步
 ```
 
-### 打包 Playable Ads
+### 本地构建预览
 
 ```bash
-# Facebook 平台（ZIP，Phaser 产物格式）
-playcraft build --platform facebook --format zip --output ./dist/facebook
-
-# Snapchat 平台（ZIP）
-playcraft build --platform snapchat --format zip --output ./dist/snapchat
-
-# 批量打包所有平台
-for platform in facebook snapchat ironsource applovin google tiktok unity liftoff moloco bigo; do
-  playcraft build --platform $platform --output ./dist/$platform
-done
+# 在项目根目录构建，产物固定为 dist/preview/index.html
+playcraft build
 ```
 
+`playcraft build` 不提供渠道、格式和输出目录参数，各广告平台的渠道包请通过平台导出生成。下方的优化参数只影响本地预览，平台导出不会读取它们。
+
 ### 构建优化
 
 ```bash
 # 🎬 场景选择（推荐！可减小 30-60% 文件大小）
 # 交互式选择（自动检测多个场景并提示）
-playcraft build --platform facebook
+playcraft build
 
 # 指定特定场景
-playcraft build --platform facebook --scenes BallGame
+playcraft build --scenes BallGame
 
 # 指定多个场景
-playcraft build --platform facebook --scenes "MainMenu,Gameplay,Settings"
+playcraft build --scenes "MainMenu,Gameplay,Settings"
 
 # 启用图片压缩
-playcraft build --platform facebook --compress-images --image-quality 75
+playcraft build --compress-images --image-quality 75
 
 # 启用模型压缩
-playcraft build --platform facebook --compress-models --model-compression draco
+playcraft build --compress-models --model-compression draco
 
 # 生成分析报告
-playcraft build --platform facebook --analyze
+playcraft build --analyze
 
 # 组合使用（场景选择 + 图片压缩 + 分析）
-playcraft build --platform facebook --scenes MainScene --compress-images --analyze
+playcraft build --scenes MainScene --compress-images --analyze
 ```
 
 ## ⚙️ 配置
@@ -350,9 +344,6 @@ playcraft build --platform facebook --scenes MainScene --compress-images --analy
     "dir": "./"
   },
   "build": {
-    "platform": "facebook",
-    "format": "html",
-    "outputDir": "./dist",
     "useVite": true,
     "compressImages": true,
     "imageQuality": 75,
@@ -370,6 +361,8 @@ playcraft build --platform facebook --scenes MainScene --compress-images --analy
 3. 配置文件（`playcraft.config.json`）
 4. 默认值
 
+`build` 字段只为本地构建补充命令行没有给出的优化参数。`playcraft build` 的渠道、格式和输出位置是固定的，配置文件里的 `platform`、`format`、`outputDir` 对它不起作用；渠道包请通过平台导出生成，平台导出不读取这个文件。
+
 ## 📁 数据目录
 
 CLI 会在 `~/.playcraft/` 目录下存储：
@@ -384,7 +377,7 @@ CLI 会在 `~/.playcraft/` 目录下存储：
 当项目包含多个场景时，CLI 会自动提供交互式场景选择：
 
 ```bash
-playcraft build --platform facebook
+playcraft build
 ```
 
 **交互界面**：
@@ -411,10 +404,10 @@ playcraft build --platform facebook
 
 ```bash
 # 指定单个场景
-playcraft build --platform facebook --scenes MainScene
+playcraft build --scenes MainScene
 
 # 指定多个场景
-playcraft build --platform facebook --scenes "MainScene,Gameplay"
+playcraft build --scenes "MainScene,Gameplay"
 ```
 
 详见：[场景选择功能文档](../../docs/cli/scene-selection-feature.md)

package/dist/commands/build.js

@@ -8,9 +8,10 @@ import { cleanupBuildTempDirectory, createBuildTempDirectory } from './build-tem
 import inquirer from 'inquirer';
 import { tmpdir } from 'node:os';
 import { generatedWorkspace } from '../workspace-runtime/workspaces/artifact-receipts.js';
-import { isolateWorkspaceForBuild } from '../workspace-runtime/workspaces/delivery-build.js';
+import { isolateWorkspaceForBuild } from '../workspace-runtime/workspaces/build-isolation.js';
 import { finalizeWorkspacePlayable, readWorkspacePlayable, workspacePlayableSignature } from '../workspace-runtime/previews/finalize.js';
 import { AgentApiClient } from '../utils/agent-api-client.js';
+import { WORKSPACE_PLAYABLE_OUTPUT_PATH } from '@playcraft/common/cloud-workspace/runtime';
 /**
  * 类型守卫：检查对象是否符合 PlayableScriptsConfig 类型
  */
@@ -247,13 +248,52 @@ async function analyzeBaseBuild(baseBuildDir, ammoReplacement) {
         suggestedEngine: ammoCheck.suggestedEngine,
     };
 }
+/**
+ * Format and clean the former `playcraft build` flags carried. Vite and draco model compression are
+ * already the builder's defaults, and leaving them unset lets playcraft.config.json supply them.
+ */
+const BUILD_DEFAULTS = { format: 'html', clean: true };
+/**
+ * `playcraft build`: a local review build of the current project. It always produces one HTML file at
+ * `dist/preview/index.html`; channel packaging is done by platform export, not by this command. The
+ * tuning options (compression, scenes, engine, ...) apply to this preview only.
+ * `output` and `base` are internal: the preview publisher builds into its own scratch folder, and the
+ * batch runtime only needs the multi-file base build.
+ */
+export async function previewBuildCommand(projectPath, options = {}) {
+    const { output, base, ...tuning } = options;
+    const project = path.resolve(projectPath);
+    if (base)
+        return buildCommand(project, { ...BUILD_DEFAULTS, ...tuning, mode: 'base', ...(output ? { output } : {}) });
+    const preview = { ...BUILD_DEFAULTS, ...tuning, mode: 'full', platform: 'playcraft' };
+    if (output)
+        return buildCommand(project, { ...preview, output });
+    const workspace = process.env.PLAYCRAFT_BUILD_ISOLATED !== '1' ? await generatedWorkspace(project) : undefined;
+    // A workspace build isolates, validates and publishes the canonical preview itself.
+    if (workspace?.root === project)
+        return buildCommand(project, preview);
+    const scratch = await fs.mkdtemp(path.join(tmpdir(), 'playcraft-preview-build-'));
+    try {
+        await buildCommand(project, { ...preview, output: scratch });
+        const entries = await fs.readdir(scratch, { withFileTypes: true });
+        if (entries.length !== 1 || !entries[0].isFile() || !entries[0].name.endsWith('.html'))
+            throw new Error('preview_not_single_file');
+        const target = path.join(project, WORKSPACE_PLAYABLE_OUTPUT_PATH);
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.copyFile(path.join(scratch, entries[0].name), target);
+        console.log(target);
+    }
+    finally {
+        await fs.rm(scratch, { recursive: true, force: true });
+    }
+}
 export async function buildCommand(projectPath, options) {
     // 解析项目路径 - 在 spinner 之前执行以便调试
     const resolvedProjectPath = path.resolve(projectPath);
     const workspace = options.workspaceArtifact !== false && process.env.PLAYCRAFT_BUILD_ISOLATED !== '1' && options.mode === 'full' && options.platform === 'playcraft'
         && (!options.format || options.format === 'html') ? await generatedWorkspace(resolvedProjectPath) : undefined;
     const requestedOutput = options.output ? path.resolve(options.output) : path.join(resolvedProjectPath, 'dist');
-    const canonicalOutput = [path.join(resolvedProjectPath, 'dist'), path.join(resolvedProjectPath, 'dist/playable')].includes(requestedOutput);
+    const canonicalOutput = [path.join(resolvedProjectPath, 'dist'), path.join(resolvedProjectPath, path.dirname(WORKSPACE_PLAYABLE_OUTPUT_PATH))].includes(requestedOutput);
     if (workspace?.root === resolvedProjectPath) {
         const prefix = requestedOutput.endsWith(path.sep) ? requestedOutput : `${requestedOutput}${path.sep}`;
         if (requestedOutput === workspace.root || workspace.root.startsWith(prefix))
@@ -269,7 +309,7 @@ export async function buildCommand(projectPath, options) {
                 if (entries.length !== 1 || !entries[0].isFile() || !entries[0].name.endsWith('.html'))
                     throw new Error('preview_not_single_file');
                 await finalizeWorkspacePlayable(workspace.root, await fs.readFile(path.join(output, entries[0].name)), 'playcraft build', { expectedSignature: signature });
-                console.log(path.join(workspace.root, 'dist/playable/index.html'));
+                console.log(path.join(workspace.root, WORKSPACE_PLAYABLE_OUTPUT_PATH));
                 try {
                     const { bytes } = await readWorkspacePlayable(workspace.root);
                     const { previewUrl } = await new AgentApiClient().publishWorkspacePlayable({ workspaceId: workspace.workspaceId, directoryName: path.basename(workspace.root) }, bytes);
@@ -744,7 +784,32 @@ export async function buildCommand(projectPath, options) {
             ...(options.tracking === false ? { tracking: { enabled: false } } : {}),
         };
         if (fileConfig) {
-            Object.assign(buildOptions, fileConfig);
+            // playcraft.config.json 只补充调用方没有给出的参数：显式参数，以及上面已确定的渠道、格式和
+            // 输出目录始终优先（playcraft build 固定这三项，配置文件不能把它改成渠道包或别的输出位置）。
+            const explicit = {
+                platform: buildOptions.platform,
+                format: buildOptions.format,
+                outputDir: buildOptions.outputDir,
+                compressEngine: options.compress,
+                compressConfigJson: options.compressConfig,
+                compressJS: options.compressJs,
+                analyze: options.analyze,
+                useVite: options.useVite,
+                cssMinify: options.cssMinify,
+                jsMinify: options.jsMinify,
+                compressImages: options.compressImages,
+                imageQuality: options.imageQuality,
+                convertToWebP: options.convertToWebP,
+                compressModels: options.compressModels,
+                modelCompression: options.modelCompression,
+                esmMode: options.esmMode,
+                storeUrls: options.storeUrls,
+                tracking: options.tracking === false ? false : undefined,
+            };
+            for (const [key, value] of Object.entries(fileConfig)) {
+                if (explicit[key] === undefined)
+                    Object.assign(buildOptions, { [key]: value });
+            }
         }
         buildOptions.validation = {
             ...buildOptions.validation,
@@ -760,7 +825,7 @@ export async function buildCommand(projectPath, options) {
             if (isEditorProject) {
                 throw new Error('检测到这是 PlayCanvas 编辑器项目，不是多文件构建产物。\n\n' +
                     '请使用以下命令之一：\n' +
-                    '  1. playcraft build <项目路径>          # 完整构建（推荐）\n' +
+                    '  1. playcraft build <项目路径>          # 本地构建预览（推荐）\n' +
                     '  2. playcraft build-base <项目路径>     # 先生成多文件产物\n' +
                     '     playcraft build-playable <产物路径> # 再转换为 Playable\n\n' +
                     '💡 提示: build-playable 命令仅用于已有的多文件构建产物');

package/dist/commands/create.js

@@ -1067,8 +1067,8 @@ function printCreateNextSteps(template, _targetDir, name, here, worktree) {
         console.log(`  ${pc.cyan('playcraft remix init-template --from-atom-tree')}`);
         console.log(`  ${pc.cyan('npm run verify:contract && npm run dev')}`);
         console.log();
-        console.log(pc.dim('如需使用 PlayCraft CLI 打渠道包：'));
-        console.log(`  ${pc.cyan('playcraft build . -p facebook')}`);
+        console.log(pc.dim('本地构建预览（产物在 dist/preview/index.html，渠道包请使用平台导出）：'));
+        console.log(`  ${pc.cyan('playcraft build .')}`);
         console.log();
         console.log(pc.dim('正式接入 PlayCraft 后，替换项目 ID：'));
         console.log(`  ${pc.cyan('playcraft config set --key projectId --value <真实项目ID>')}`);
@@ -1081,8 +1081,8 @@ function printCreateNextSteps(template, _targetDir, name, here, worktree) {
         console.log(`  ${pc.cyan('npm run build -- google')}`);
         console.log(`  ${pc.cyan('npm run builds')}`);
         console.log();
-        console.log(pc.dim('或使用 PlayCraft CLI：'));
-        console.log(`  ${pc.cyan(`playcraft build ${here ? '.' : name} -p facebook`)}`);
+        console.log(pc.dim('或使用 PlayCraft CLI 本地构建预览（产物在 dist/preview/index.html）：'));
+        console.log(`  ${pc.cyan(`playcraft build ${here ? '.' : name}`)}`);
     }
     console.log();
 }

package/dist/commands/inspect.js

@@ -106,18 +106,16 @@ export async function inspectCommand(projectPath) {
         console.log('\n' + pc.bold('💡 建议:\n'));
         if (projectType === 'build') {
             console.log(pc.green('✅ 这是一个构建后的项目，可以直接打包为 Playable Ad'));
-            console.log(pc.dim('   运行: playcraft build --platform facebook'));
+            console.log(pc.dim('   运行: playcraft build'));
         }
         else if (projectType === 'playcraft-source' || projectType === 'playcanvas-source') {
             console.log(pc.yellow('⚠️  这是源代码项目，建议先构建再打包\n'));
             console.log(pc.cyan('方式 1 (推荐): 使用 PlayCanvas REST API 构建'));
             console.log(pc.dim('   1. 在 PlayCanvas Editor 中发布项目'));
             console.log(pc.dim('   2. 使用 REST API 下载构建'));
-            console.log(pc.dim('   3. 运行: playcraft build --platform facebook\n'));
-            console.log(pc.cyan('方式 2: 使用本地构建（实验性功能）'));
-            console.log(pc.dim('   运行: playcraft build --platform facebook --auto-build\n'));
-            console.log(pc.cyan('方式 3: 直接从源代码打包（可能不完整）'));
-            console.log(pc.dim('   运行: playcraft build --platform facebook --skip-build'));
+            console.log(pc.dim('   3. 运行: playcraft build\n'));
+            console.log(pc.cyan('方式 2: 直接本地构建'));
+            console.log(pc.dim('   运行: playcraft build'));
         }
         else {
             console.log(pc.red('❌ 无法识别项目类型，请确保:'));

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Command, CommanderError } from 'commander';
+import { Command, CommanderError, Option } from 'commander';
 import { accountActivationMessage } from './auth/messages.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
@@ -11,7 +11,7 @@ import { stopCommand } from './commands/stop.js';
 import { statusCommand } from './commands/status.js';
 import { logsCommand } from './commands/logs.js';
 import { configCommand } from './commands/config.js';
-import { buildCommand } from './commands/build.js';
+import { buildCommand, previewBuildCommand } from './commands/build.js';
 import { buildAllCommand } from './commands/build-all.js';
 import { upgradeCommand } from './commands/upgrade.js';
 import { checkForUpdates } from './utils/version-checker.js';
@@ -174,28 +174,34 @@ program
         token: options.token,
     });
 });
-// build 命令 - 完整流程（阶段1 + 阶段2）
+/**
+ * 只保留命令行上显式给出的参数。commander 的默认值与构建器默认值相同，去掉后 playcraft.config.json
+ * 才能补充这些参数；否则默认值会被当成显式参数，压过配置文件。
+ */
+function explicitOptions(command) {
+    const options = command.opts();
+    return Object.fromEntries(Object.keys(options)
+        .filter(key => command.getOptionValueSource(key) !== 'default')
+        .map(key => [key, options[key]]));
+}
+/** commander 把 --convert-webp / --no-convert-webp 解析成 convertWebp，构建器使用的字段是 convertToWebP。 */
+function withConvertToWebP({ convertWebp, ...options }) {
+    return { ...options, convertToWebP: convertWebp };
+}
+// build 命令 - 本地构建当前项目用于 review，产物固定为 dist/preview/index.html；渠道导出走平台导出
 program
     .command('build')
-    .description('打包项目为 Playable Ad（自动执行基础构建和渠道打包）')
+    .description('本地构建当前项目，产物输出到 dist/preview/index.html（渠道导出请使用平台导出）')
     .argument('[project-path]', '项目路径', process.cwd())
-    .option('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo|inmobi|adikteev|remerge|mintegral)')
-    .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
-    .option('-o, --output <path>', '输出目录', './dist')
     .option('-c, --config <file>', '配置文件路径')
     .option('-s, --scenes <scenes>', '选择场景: "all"=所有场景, "default"=默认场景, 或逗号分隔的场景名,如 "MainMenu,Gameplay"')
     .option('-e, --engine <engine>', '指定引擎类型 (playcanvas|phaser|pixijs|threejs|cocos|babylonjs|layaair|egret|generic)，默认自动检测')
-    .option('--clean', '构建前清理旧的输出目录（默认启用）', true)
-    .option('--no-clean', '跳过清理旧的输出目录')
     .option('--compress', '压缩引擎代码（使用 LZ4，仅 PlayCanvas）')
     .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积，仅 PlayCanvas）')
     .option('--compress-js', '压缩所有 JS 代码（LZ4 源码保护，浏览器中无法查看变量名和方法名）')
     .option('--analyze', '生成打包分析报告')
     .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon（仅 PlayCanvas）')
     .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)，仅 PlayCanvas')
-    .option('--auto-build', '如果是源代码项目，自动执行本地构建')
-    .option('--skip-build', '跳过本地构建，直接从源代码打包（可能不完整）')
-    .option('--mode <mode>', '构建模式 (full|base|playable)')
     .option('--use-vite', '使用 Vite 构建（默认启用）', true)
     .option('--no-use-vite', '禁用 Vite，使用旧构建器')
     .option('--css-minify', '压缩 CSS（默认根据平台配置）')
@@ -212,8 +218,10 @@ program
     .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
     .option('--use-playable-scripts', '使用 @playcraft/devkit 构建工具打包（可玩广告项目专用）', false)
     .option('--no-tracking', '禁用埋点 tracking adapter 注入（默认启用）')
-    .action(async (projectPath, options) => {
-    await buildCommand(projectPath, options);
+    .addOption(new Option('-o, --output <path>').hideHelp())
+    .addOption(new Option('--base').hideHelp())
+    .action(async (projectPath, _options, command) => {
+    await previewBuildCommand(projectPath, withConvertToWebP(explicitOptions(command)));
 });
 // build-base 命令 - 只执行阶段1：基础构建
 program
@@ -262,9 +270,9 @@ program
     .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
     .option('--esm-mode <mode>', 'ESM 模块处理模式 (auto|enabled|disabled)', 'auto')
     .option('--no-tracking', '禁用埋点 tracking adapter 注入（默认启用）')
-    .action(async (projectPath, options) => {
+    .action(async (projectPath, _options, command) => {
     await buildCommand(projectPath, {
-        ...options,
+        ...withConvertToWebP(explicitOptions(command)),
         analyze: true,
     });
 });
@@ -300,9 +308,9 @@ program
     .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
     .option('--esm-mode <mode>', 'ESM 模块处理模式 (auto|enabled|disabled)', 'auto')
     .option('--no-tracking', '禁用埋点 tracking adapter 注入（默认启用）')
-    .action(async (baseBuildDir, options) => {
+    .action(async (baseBuildDir, _options, command) => {
     await buildCommand(baseBuildDir, {
-        ...options,
+        ...withConvertToWebP(explicitOptions(command)),
         mode: 'playable',
     });
 });
@@ -343,7 +351,7 @@ program
     .option('--theme <theme>', '指定要构建的主题（devkit 项目专用）')
     .option('--no-tracking', '禁用埋点 tracking adapter 注入（默认启用）')
     .action(async (projectPath, options) => {
-    await buildAllCommand(projectPath, options);
+    await buildAllCommand(projectPath, withConvertToWebP(options));
 });
 // 新增：inspect 命令 - 检查项目类型
 program

package/dist/model-adaptation/node-inspection.js

@@ -0,0 +1,173 @@
+import { createHash } from 'node:crypto';
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import sharp from 'sharp';
+import { canonicalModelAdaptation, createModelAdaptationCore, inspectModelAdaptationSource, readModelSourceDocument, workspaceModelAdaptationSchema, } from '@playcraft/common/cloud-workspace/runtime';
+const require = createRequire(import.meta.url);
+const hash = (bytes) => createHash('sha256').update(bytes).digest('hex');
+let serialized = Promise.resolve();
+function assert(condition, code) { if (!condition)
+    throw Error(code); }
+/** Actual engine loading and decoded pixels, with no renderer, browser or project code execution. */
+export function inspectRigidModel(input) {
+    const result = serialized.then(() => inspect(input));
+    serialized = result.catch(() => undefined);
+    return result;
+}
+async function inspect(input) {
+    input.signal?.throwIfAborted();
+    const parsed = readModelSourceDocument(input.bytes), document = parsed.document;
+    const { binary, extraChunks } = parsed;
+    assert(binary && !extraChunks?.length && !(document.buffers ?? []).some((value) => value.uri)
+        && !(document.images ?? []).some((value) => value.uri), 'model_prepare_self_contained_glb_required');
+    assert(!(document.extensionsRequired ?? []).some((name) => ['KHR_draco_mesh_compression', 'KHR_texture_basisu', 'EXT_meshopt_compression'].includes(name)), 'model_prepare_decoder_not_configured');
+    assert((document.images ?? []).length <= 64, 'model_prepare_image_bound');
+    const threeEntry = require.resolve('three'), threeRoot = dirname(dirname(threeEntry));
+    const threePackage = JSON.parse(await readFile(join(threeRoot, 'package.json'), 'utf8'));
+    assert(threePackage.version === '0.183.2', 'model_prepare_loader_version_mismatch');
+    // Variable module URLs avoid inventing a second public engine type contract.
+    const THREE = await import(pathToFileURL(join(threeRoot, 'build/three.module.js')).href);
+    const loaderPath = require.resolve('three/examples/jsm/loaders/GLTFLoader.js');
+    const { GLTFLoader } = await import(pathToFileURL(loaderPath).href);
+    const descriptors = new Map(['self', 'ProgressEvent', 'createImageBitmap'].map(name => [name, Object.getOwnPropertyDescriptor(globalThis, name)]));
+    const pending = new Set(), decoded = [];
+    let loaded, factory;
+    const errors = [];
+    let decodedBytes = 0;
+    try {
+        Object.defineProperty(globalThis, 'self', { configurable: true, value: globalThis });
+        Object.defineProperty(globalThis, 'ProgressEvent', { configurable: true, value: class extends Event {
+                lengthComputable;
+                loaded;
+                total;
+                constructor(type, init = {}) { super(type); this.lengthComputable = Boolean(init.lengthComputable); this.loaded = init.loaded ?? 0; this.total = init.total ?? 0; }
+            } });
+        Object.defineProperty(globalThis, 'createImageBitmap', { configurable: true, value: (blob, options = {}) => {
+                const task = (async () => {
+                    assert(blob instanceof Blob && blob.size <= 32 * 1024 * 1024, 'model_prepare_image_bound');
+                    const bytes = Buffer.from(await blob.arrayBuffer());
+                    let decoder = sharp(bytes, { limitInputPixels: 16_777_216 });
+                    if (options.imageOrientation === 'flipY')
+                        decoder = decoder.flip();
+                    const metadata = await decoder.metadata(), allocation = (metadata.width ?? 0) * (metadata.height ?? 0) * 4;
+                    assert(allocation > 0 && decodedBytes + allocation <= 128 * 1024 * 1024, 'model_prepare_decoded_image_budget');
+                    decodedBytes += allocation;
+                    const raw = await decoder.ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+                    assert(raw.info.channels === 4 && raw.data.length === raw.info.width * raw.info.height * 4, 'model_prepare_image_decode_failed');
+                    const image = { width: raw.info.width, height: raw.info.height, data: new Uint8ClampedArray(raw.data), close() { this.data = null; } };
+                    decoded.push({ image, encodedHash: hash(bytes), rgbaHash: hash(raw.data), width: image.width, height: image.height });
+                    return image;
+                })();
+                pending.add(task);
+                void task.then(() => pending.delete(task), () => pending.delete(task));
+                return task;
+            } });
+        const manager = new THREE.LoadingManager();
+        manager.onError = () => errors.push('embedded-resource-load-failed');
+        loaded = await new GLTFLoader(manager).parseAsync(input.bytes.buffer.slice(input.bytes.byteOffset, input.bytes.byteOffset + input.bytes.byteLength), '');
+        await Promise.all([...pending]);
+        input.signal?.throwIfAborted();
+        assert(!errors.length, 'model_prepare_resource_load_failed');
+        const inventory = await inspectModelAdaptationSource({ source: loaded.scene, animationCount: loaded.animations.length, digestBytes: hash, signal: input.signal });
+        assert(!inventory.unsupported.length, 'model_prepare_rigid_source_required');
+        let triangles = 0;
+        loaded.scene.traverse((node) => {
+            if (node.isMesh && node.geometry) {
+                const count = node.geometry.index?.count ?? node.geometry.getAttribute('position')?.count ?? 0;
+                assert(Number.isSafeInteger(count) && count % 3 === 0, 'model_prepare_triangles_required');
+                triangles += count / 3;
+            }
+        });
+        assert(triangles > 0, 'model_prepare_empty_model');
+        let plan = workspaceModelAdaptationSchema.parse(input.adaptation ? { ...input.adaptation, source: input.source } : { schemaVersion: 1, source: input.source });
+        if (input.split) {
+            const ref = (role) => {
+                const expected = input.split.output.nodes.filter(node => node.role === role);
+                assert(expected.length === 1, 'model_prepare_split_roles_invalid');
+                const matches = inventory.nodes.filter(node => node.sourceNodeId === expected[0].sourceNodeId && node.name === expected[0].name);
+                assert(matches.length === 1 && matches[0].geometryHash, 'model_prepare_split_node_identity_mismatch');
+                return { sourceNodeId: matches[0].sourceNodeId, geometryHash: matches[0].geometryHash };
+            };
+            plan = workspaceModelAdaptationSchema.parse({ ...plan, hinges: [{ id: 'primary', movingNodeRef: ref('lid'), bodyNodeRefs: [ref('body')],
+                        pivot: input.split.hinge.pivot, axis: input.split.hinge.axis, openAngleDegrees: input.split.hinge.openAngleDegrees }] });
+        }
+        assert(input.requiredCapability !== 'rigid-hinge' || plan.hinges.length > 0, 'model_prepare_needs_part_mapping');
+        const points = (node) => {
+            const result = [];
+            node.updateMatrixWorld(true);
+            node.traverse((item) => {
+                const position = item.isMesh && item.geometry?.getAttribute('position');
+                if (position)
+                    for (let index = 0; index < position.count; index++) {
+                        if (result.length >= 4_000_000)
+                            throw Error('model_prepare_geometry_bound');
+                        result.push(new THREE.Vector3().fromBufferAttribute(position, index).applyMatrix4(item.matrixWorld).toArray());
+                    }
+            });
+            return result;
+        };
+        const distance = (before, after) => {
+            assert(before.length === after.length, 'model_prepare_geometry_changed');
+            return before.reduce((maximum, point, index) => Math.max(maximum, Math.hypot(...point.map((value, axis) => value - after[index][axis]))), 0);
+        };
+        const original = points(loaded.scene);
+        factory = await createModelAdaptationCore({ THREE, source: loaded.scene, sourceIdentity: input.source, plan,
+            animationCount: loaded.animations.length, digestBytes: hash, signal: input.signal });
+        const instance = factory.create(), samples = [];
+        try {
+            for (const declared of plan.hinges) {
+                const hinge = instance.getHinge(declared.id);
+                const body = hinge.body.map(node => points(node)), moving = points(hinge.moving);
+                for (const fraction of [.25, .5, .75, 1]) {
+                    input.signal?.throwIfAborted();
+                    const angleDegrees = declared.openAngleDegrees * fraction;
+                    instance.setHinge(declared.id, angleDegrees);
+                    const bodyDisplacement = Math.max(...hinge.body.map((node, index) => distance(body[index], points(node))));
+                    const movingDisplacement = distance(moving, points(hinge.moving));
+                    assert(bodyDisplacement <= 1e-8 && movingDisplacement > 1e-8, 'model_prepare_hinge_motion_failed');
+                    samples.push({ hingeId: declared.id, angleDegrees, bodyDisplacement, movingDisplacement });
+                }
+                instance.setHinge(declared.id, 0);
+                assert(distance(moving, points(hinge.moving)) <= 1e-8, 'model_prepare_closed_recovery_failed');
+            }
+            assert(distance(original, points(loaded.scene)) === 0, 'model_prepare_source_mutated');
+        }
+        finally {
+            instance.dispose();
+        }
+        const dependencies = await Promise.all([['three', join(threeRoot, 'build/three.module.js')], ['three-core', join(threeRoot, 'build/three.core.js')], ['loader', loaderPath]]
+            .map(async ([name, path]) => ({ name: name, contentHash: hash(await readFile(path)) })));
+        return { schemaVersion: 1, kind: 'actual-engine-geometry-inspection', source: input.source, plan, inventory, samples, triangles,
+            decodedTextures: decoded.map(({ image: _image, ...value }) => value),
+            tool: { threeVersion: threePackage.version, sharpVersions: sharp.versions, nodeVersion: process.versions.node, dependencies,
+                dependencyHash: hash(canonicalModelAdaptation(dependencies)) },
+            rendered: false, browserStarted: false, modelAcceptance: false };
+    }
+    finally {
+        await Promise.allSettled([...pending]);
+        factory?.release();
+        const disposed = new Set();
+        loaded?.scene?.traverse((node) => {
+            for (const item of [node.geometry, ...(Array.isArray(node.material) ? node.material : node.material ? [node.material] : [])]) {
+                if (!item || disposed.has(item))
+                    continue;
+                disposed.add(item);
+                for (const value of Object.values(item))
+                    if (value?.isTexture && !disposed.has(value)) {
+                        disposed.add(value);
+                        value.dispose();
+                    }
+                item.dispose();
+            }
+        });
+        for (const entry of decoded)
+            entry.image.close();
+        for (const [name, descriptor] of descriptors)
+            if (descriptor)
+                Object.defineProperty(globalThis, name, descriptor);
+            else
+                delete globalThis[name];
+    }
+}

package/dist/model-adaptation/project-template.js

@@ -120,7 +120,7 @@ try {
 export const modelProjectStyle = `body{margin:0;background:#eee9e0;color:#202d38;font:16px system-ui}main{max-width:1120px;margin:auto;padding:24px}#stage{height:62vh;min-height:240px;border:1px solid #c2ccd1;border-radius:8px;overflow:hidden}canvas{display:block;width:100%;height:100%}#controls{display:flex;gap:12px;flex-wrap:wrap;margin-top:16px}button,input{padding:10px 18px;border:1px solid currentColor;border-radius:4px;background:#f8f4ec;color:inherit}button{cursor:pointer}label{display:inline-flex;align-items:center;gap:8px}input{width:110px}
 `;
 export const modelProjectPrepare = String.raw `import { createHash } from 'node:crypto';
-import { readFile, readdir } from 'node:fs/promises';
+import { readFile, readdir, lstat } from 'node:fs/promises';
 import { join, relative } from 'node:path';
 const hash = bytes => createHash('sha256').update(bytes).digest('hex');
 const canonical = value => Array.isArray(value) ? '[' + value.map(canonical).join(',') + ']' : value && typeof value === 'object'
@@ -137,13 +137,45 @@ export async function prepareModelBuild(root) {
   }
   const packed = await readFile(join(root, 'src/assets/packed-model.glb')); if (hash(packed) !== meta.packedHash) throw Error('model_packed_bytes_changed');
   const core = await readFile(join(root, 'src/runtime/model-adaptation-core.js')); if (hash(core) !== meta.coreHash) throw Error('model_core_changed');
-  const inputs = []; async function walk(directory) { for (const entry of await readdir(directory, { withFileTypes: true })) {
-    const path = join(directory, entry.name); if (entry.isDirectory()) await walk(path); else if (entry.isFile()) inputs.push({ path: relative(root, path).split('\\').join('/'), contentHash: hash(await readFile(path)) }); else throw Error('model_input_not_regular');
-  } }
-  await walk(join(root, 'src')); await walk(join(root, 'source')); await walk(join(root, 'scripts'));
-  for (const path of ['index.html','package.json','vite.config.mjs','.playcraft/workspace.json','.playcraft/model-adaptation.json','.playcraft/model-adaptation-lineage.json','package-lock.json','pnpm-lock.yaml']) {
-    try { inputs.push({ path, contentHash: hash(await readFile(join(root, path))) }); } catch (error) { if (error.code !== 'ENOENT' || !path.endsWith('lock.json') && path !== 'pnpm-lock.yaml') throw error; }
-  }
+  const inputs = [];
+  if (meta.buildBindingVersion === 2) {
+    const declaration = JSON.parse(await readFile(join(root, '.playcraft/model-build-inputs.json'), 'utf8'));
+    const model = declaration.models?.[0];
+    if (declaration.schemaVersion !== 1 || !Array.isArray(declaration.models) || declaration.models.length !== 1 ||
+      model?.source?.kind !== 'resource' || canonical(model.source) !== canonical(plan.source) || !Array.isArray(model.adaptationFiles)) throw Error('model_build_manifest_invalid');
+    const paths = new Map();
+    for (const file of [...model.source.files, ...model.adaptationFiles]) {
+      if (!file || typeof file.path !== 'string' || !file.path || file.path.length > 512 || /[\\\0:]/.test(file.path) || file.path.startsWith('/') ||
+        file.path.split('/').some(part => !part || part === '.' || part === '..') ||
+        file.contentHash !== undefined && !/^[a-f0-9]{64}$/.test(file.contentHash)) throw Error('model_build_manifest_invalid');
+      const previous = paths.get(file.path); if (previous?.contentHash && file.contentHash && previous.contentHash !== file.contentHash) throw Error('model_build_input_conflict');
+      paths.set(file.path, previous?.contentHash ? previous : file);
+    }
+    if (paths.size > 256) throw Error('model_build_input_limit');
+    const readInput = async path => {
+      let current = root; for (const [index, part] of path.split('/').entries()) {
+        current = join(current, part); const stat = await lstat(current);
+        if (stat.isSymbolicLink() || (index < path.split('/').length - 1 ? !stat.isDirectory() : !stat.isFile() || stat.nlink !== 1 || stat.size > 64 * 1024 * 1024)) throw Error('model_input_not_regular');
+      }
+      return readFile(current);
+    };
+    for (const path of ['package.json','pnpm-lock.yaml','package-lock.json','yarn.lock']) {
+      try { const bytes = await readInput(path); if (!paths.has(path)) inputs.push({ path, contentHash: hash(bytes) }); }
+      catch (error) { if (error.code !== 'ENOENT') throw error; }
+    }
+    for (const file of paths.values()) {
+      const contentHash = hash(await readInput(file.path)); if (file.contentHash && contentHash !== file.contentHash) throw Error('model_build_input_changed');
+      inputs.push({ path: file.path, contentHash });
+    }
+  } else if (meta.buildBindingVersion === undefined || meta.buildBindingVersion === 1) {
+    async function walk(directory) { for (const entry of await readdir(directory, { withFileTypes: true })) {
+      const path = join(directory, entry.name); if (entry.isDirectory()) await walk(path); else if (entry.isFile()) inputs.push({ path: relative(root, path).split('\\').join('/'), contentHash: hash(await readFile(path)) }); else throw Error('model_input_not_regular');
+    } }
+    await walk(join(root, 'src')); await walk(join(root, 'source')); await walk(join(root, 'scripts'));
+    for (const path of ['index.html','package.json','vite.config.mjs','.playcraft/workspace.json','.playcraft/model-adaptation.json','.playcraft/model-adaptation-lineage.json','package-lock.json','pnpm-lock.yaml']) {
+      try { inputs.push({ path, contentHash: hash(await readFile(join(root, path))) }); } catch (error) { if (error.code !== 'ENOENT' || !path.endsWith('lock.json') && path !== 'pnpm-lock.yaml') throw error; }
+    }
+  } else throw Error('model_build_binding_version_unsupported');
   inputs.sort((a,b) => a.path.localeCompare(b.path, 'en'));
   const binding = { sourceKind: 'external-model', candidateId: meta.candidateId, sourceHash: plan.source.contentHash,
     adaptationHash: hash(await readFile(join(root, 'src/adapter.js'))), buildHash: hash(canonical(inputs)) };