@forgeax/engine-runtime 0.1.6 → 0.1.7
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 +16 -0
- package/dist/.tsbuildinfo +1 -1
- package/dist/__tests__/render-error-exhaustive.test-d.d.ts.map +1 -1
- package/dist/collect-scene-asset.d.ts +6 -3
- package/dist/collect-scene-asset.d.ts.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +5 -3
- package/dist/index.mjs.map +1 -1
- package/package.json +30 -30
- package/src/__tests__/asset-registry-guid-reverse.test.ts +33 -0
- package/src/__tests__/dawn/material-cooked-fixture.dawn.test.ts +39 -6
- package/src/__tests__/errors.unit.test.ts +24 -0
- package/src/__tests__/lights.unit.test.ts +15 -11
- package/src/__tests__/pbr-pipeline.unit.test.ts +7 -4
- package/src/__tests__/render-error-exhaustive.test-d.ts +36 -0
- package/src/__tests__/render-feature-prepared-graphics.browser.test.ts +5 -1
- package/src/__tests__/renderer.test-d.ts +2 -0
- package/src/__tests__/rhi-null-command-flow.unit.test.ts +14 -0
- package/src/__tests__/sprite-lit-bgl-byte-identical.test.ts +3 -3
- package/src/__tests__/ssao-passes.test.ts +4 -0
- package/src/collect-scene-asset.ts +14 -7
- package/src/index.ts +5 -1
package/README.md
CHANGED
|
@@ -110,6 +110,22 @@ its structured construction error. After construction, `attach`, `draw`,
|
|
|
110
110
|
`inspect`, `observe`, and `recover` remain receipt-bound and `dispose()` is
|
|
111
111
|
idempotent.
|
|
112
112
|
|
|
113
|
+
### Browser backend selection and diagnosis
|
|
114
|
+
|
|
115
|
+
The default browser path prefers native WebGPU and can retry through the
|
|
116
|
+
`wgpu`/WebGL2 downlevel backend. Consequently, a native-channel
|
|
117
|
+
`adapter-unavailable` error means only that `navigator.gpu.requestAdapter()` did
|
|
118
|
+
not produce an adapter; it is not a verdict that the machine cannot run the
|
|
119
|
+
game. A thrown `requestAdapter()` failure is reported separately as
|
|
120
|
+
`webgpu-runtime-error` with the original name/message in `detail.error`, while a
|
|
121
|
+
literal `null` remains `adapter-unavailable`.
|
|
122
|
+
|
|
123
|
+
Always diagnose the final structured error rather than matching the word
|
|
124
|
+
“WebGPU”. Inspect `.code`, `.expected`, `.hint`, and nested backend causes. Asset,
|
|
125
|
+
shader, Pack, permission-policy, and application bootstrap failures belong to
|
|
126
|
+
their own owners and must not be repaired by replacing ForgeaX with a second
|
|
127
|
+
Canvas renderer or by swallowing the entry-module exception.
|
|
128
|
+
|
|
113
129
|
## Import each domain from its owner
|
|
114
130
|
|
|
115
131
|
| Need | Canonical package | Example imports |
|