@forgeax/engine-devkit 0.1.7 → 0.1.20

package/README.md

@@ -25,7 +25,7 @@ owns rendering, RHI events, replay backends, and preview execution.
 The normal project commands remain available through the `forgeax` CLI:
 
 ```text
-forgeax new [directory] [--template empty|game-3d]
+forgeax new [directory] --template empty|game-3d
 forgeax init
 forgeax doctor
 forgeax skill install
@@ -35,7 +35,7 @@ forgeax dev
 forgeax build
 forgeax capture --backend auto --require-ui --output artifacts/capture/game-ui.png --json
 forgeax preview
-forgeax package [--output release/game-web.zip]
+forgeax package [--format web-zip|single-html] [--output release/game-web.zip]
 forgeax list --json
 forgeax describe project.build --json
 forgeax run project.build --input request.json --json
@@ -77,12 +77,31 @@ The selected directory is a derived build root and is emptied before writing.
 root. An SDK-owned target fails before template copying with `project-target-inside-sdk`; use a
 sibling directory or an absolute path outside the SDK.
 
+`forgeax new` requires an explicit template: choose `game-3d` for every 3D game, including custom
+3D genres, and choose `empty` otherwise. Omitting `--template` fails with `sdk-template-required`.
+
+> [!IMPORTANT]
+> `game-3d` is a runnable, contentful third-person reference, not an empty 3D scene. It copies
+> authored scene content, visible objects and static collision examples, character/material/animation packs,
+> and UI into the new project; those choices affect the initial picture, movement space, and asset
+> closure. Read the generated project's `README.md` before pruning anything, then keep, adjust, or
+> replace the starter content for the game's goal and update scene, runtime, and pack references
+> together when removing it.
+
 `forgeax package` rebuilds with relative URLs, verifies the complete `forgeax-dist.json` closure,
 and emits a deterministic Web ZIP plus an adjacent SHA-256 file. The archive contains the bundled
 Engine JavaScript/WASM runtime and game assets at its root for HTTPS static or HTML-game hosting;
 it does not contain source, `node_modules`, or a local development server. Use `forgeax preview`
 for local HTTP acceptance. Opening the archived `index.html` through `file://` is unsupported.
 
+`forgeax package --format single-html --output release/game-offline.html` emits a self-contained
+single-HTML candidate and adjacent SHA-256. DevKit derives it from the same verified dist manifest,
+embeds the generated module/worker/WASM/resource closure, and reports the candidate path, digest,
+dist-manifest digest, and embedded asset count. The candidate is the acceptance object: open that
+exact file through `file://` in the release browser profile and require zero remote requests, failed
+requests, console/page errors, and resource misses before promotion. This format does not make
+arbitrary dist `index.html` files or network-dependent services offline.
+
 `discoverRhiDebugOperations()` returns the same descriptors used by help and
 schema output. The operation manifest is the single discovery and recovery
 surface for RHI-debug.