@forgeax/engine-devkit 0.1.7 → 0.1.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -2
- package/dist/.tsbuildinfo +1 -1
- package/dist/__tests__/native-preview-dispatch.test.d.ts +2 -0
- package/dist/__tests__/native-preview-dispatch.test.d.ts.map +1 -0
- package/dist/__tests__/native-preview-subject-draw.unit.test.d.ts +2 -0
- package/dist/__tests__/native-preview-subject-draw.unit.test.d.ts.map +1 -0
- package/dist/__tests__/single-html-runtime.e2e.test.d.ts +2 -0
- package/dist/__tests__/single-html-runtime.e2e.test.d.ts.map +1 -0
- package/dist/__tests__/single-html.test.d.ts +2 -0
- package/dist/__tests__/single-html.test.d.ts.map +1 -0
- package/dist/bootstrap-commands.d.ts.map +1 -1
- package/dist/cli-output.d.ts.map +1 -1
- package/dist/cli.mjs +1777 -133
- package/dist/cli.mjs.map +1 -1
- package/dist/commands.d.ts.map +1 -1
- package/dist/dist.d.ts +2 -2
- package/dist/dist.d.ts.map +1 -1
- package/dist/host.d.ts +6 -1
- package/dist/host.d.ts.map +1 -1
- package/dist/index.d.ts +5 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +2317 -1125
- package/dist/index.mjs.map +1 -1
- package/dist/sdk-bootstrap.d.ts +6 -1
- package/dist/sdk-bootstrap.d.ts.map +1 -1
- package/dist/sdk-cli.mjs +33 -15
- package/dist/sdk-cli.mjs.map +1 -1
- package/dist/sdk.d.ts +1 -3
- package/dist/sdk.d.ts.map +1 -1
- package/dist/single-html.d.ts +43 -0
- package/dist/single-html.d.ts.map +1 -0
- package/dist/software-capture.d.ts +38 -0
- package/dist/software-capture.d.ts.map +1 -1
- package/dist/tools/client.d.ts.map +1 -1
- package/dist/tools/native-preview.d.ts.map +1 -1
- package/dist/tools/preview-contributions.d.ts +0 -5
- package/dist/tools/preview-contributions.d.ts.map +1 -1
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +33 -31
package/README.md
CHANGED
|
@@ -25,7 +25,7 @@ owns rendering, RHI events, replay backends, and preview execution.
|
|
|
25
25
|
The normal project commands remain available through the `forgeax` CLI:
|
|
26
26
|
|
|
27
27
|
```text
|
|
28
|
-
forgeax new [directory]
|
|
28
|
+
forgeax new [directory] --template empty|game-3d
|
|
29
29
|
forgeax init
|
|
30
30
|
forgeax doctor
|
|
31
31
|
forgeax skill install
|
|
@@ -35,7 +35,7 @@ forgeax dev
|
|
|
35
35
|
forgeax build
|
|
36
36
|
forgeax capture --backend auto --require-ui --output artifacts/capture/game-ui.png --json
|
|
37
37
|
forgeax preview
|
|
38
|
-
forgeax package [--output release/game-web.zip]
|
|
38
|
+
forgeax package [--format web-zip|single-html] [--output release/game-web.zip]
|
|
39
39
|
forgeax list --json
|
|
40
40
|
forgeax describe project.build --json
|
|
41
41
|
forgeax run project.build --input request.json --json
|
|
@@ -77,12 +77,23 @@ The selected directory is a derived build root and is emptied before writing.
|
|
|
77
77
|
root. An SDK-owned target fails before template copying with `project-target-inside-sdk`; use a
|
|
78
78
|
sibling directory or an absolute path outside the SDK.
|
|
79
79
|
|
|
80
|
+
`forgeax new` requires an explicit template: choose `game-3d` for every 3D game, including custom
|
|
81
|
+
3D genres, and choose `empty` otherwise. Omitting `--template` fails with `sdk-template-required`.
|
|
82
|
+
|
|
80
83
|
`forgeax package` rebuilds with relative URLs, verifies the complete `forgeax-dist.json` closure,
|
|
81
84
|
and emits a deterministic Web ZIP plus an adjacent SHA-256 file. The archive contains the bundled
|
|
82
85
|
Engine JavaScript/WASM runtime and game assets at its root for HTTPS static or HTML-game hosting;
|
|
83
86
|
it does not contain source, `node_modules`, or a local development server. Use `forgeax preview`
|
|
84
87
|
for local HTTP acceptance. Opening the archived `index.html` through `file://` is unsupported.
|
|
85
88
|
|
|
89
|
+
`forgeax package --format single-html --output release/game-offline.html` emits a self-contained
|
|
90
|
+
single-HTML candidate and adjacent SHA-256. DevKit derives it from the same verified dist manifest,
|
|
91
|
+
embeds the generated module/worker/WASM/resource closure, and reports the candidate path, digest,
|
|
92
|
+
dist-manifest digest, and embedded asset count. The candidate is the acceptance object: open that
|
|
93
|
+
exact file through `file://` in the release browser profile and require zero remote requests, failed
|
|
94
|
+
requests, console/page errors, and resource misses before promotion. This format does not make
|
|
95
|
+
arbitrary dist `index.html` files or network-dependent services offline.
|
|
96
|
+
|
|
86
97
|
`discoverRhiDebugOperations()` returns the same descriptors used by help and
|
|
87
98
|
schema output. The operation manifest is the single discovery and recovery
|
|
88
99
|
surface for RHI-debug.
|