@forgeax/engine-assets-runtime 0.1.6 → 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.
Files changed (35) hide show
  1. package/README.md +11 -0
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/asset-registry.d.ts +2 -0
  4. package/dist/asset-registry.d.ts.map +1 -1
  5. package/dist/handles.d.ts +2 -0
  6. package/dist/handles.d.ts.map +1 -1
  7. package/dist/index.d.ts +4 -5
  8. package/dist/index.d.ts.map +1 -1
  9. package/dist/index.mjs +62 -9
  10. package/dist/index.mjs.map +1 -1
  11. package/dist/mipmap-generator.d.ts +3 -1
  12. package/dist/mipmap-generator.d.ts.map +1 -1
  13. package/dist/registry/instantiate.d.ts +2 -0
  14. package/dist/registry/instantiate.d.ts.map +1 -1
  15. package/dist/registry/validate-material.d.ts +1 -0
  16. package/dist/registry/validate-material.d.ts.map +1 -1
  17. package/package.json +14 -14
  18. package/src/__tests__/catalog-replica.unit.test.ts +36 -0
  19. package/src/__tests__/inline-pack-loaders.unit.test.ts +37 -0
  20. package/src/__tests__/instantiate-publication-fence.unit.test.ts +59 -1
  21. package/src/__tests__/material-ready.integration.test.ts +87 -6
  22. package/src/__tests__/material-stale-generation.unit.test.ts +1 -6
  23. package/src/__tests__/resolve-asset-handle.unit.test.ts +1 -1
  24. package/src/__tests__/scriptable-pack-public-surface.test-d.ts +11 -0
  25. package/src/__tests__/validate-material.unit.test.ts +46 -1
  26. package/src/asset-registry.ts +5 -0
  27. package/src/handles.ts +7 -1
  28. package/src/index.ts +17 -3
  29. package/src/material/inspection.ts +1 -1
  30. package/src/material/loader.ts +9 -9
  31. package/src/material/runtime-shader.ts +1 -1
  32. package/src/mipmap-generator.ts +43 -1
  33. package/src/registry/instantiate.ts +14 -4
  34. package/src/registry/load-by-guid.ts +1 -1
  35. package/src/registry/validate-material.ts +96 -3
package/README.md CHANGED
@@ -14,6 +14,17 @@ render owner。缺失或 stale 时 inspect、修复 producer 并 recook；不会
14
14
 
15
15
  ## Authoring and recovery index
16
16
 
17
+ ## Material contract index
18
+
19
+ The runtime loader reads the Pack publication by GUID and exposes a read-only
20
+ projection to render. Runtime values and module slots are data, while compiler
21
+ context is a closed input; no material macro, feature define, cook, or DDC
22
+ write belongs here. Preserve the layered identities
23
+ `materialContractDigest`, `sourceClosureDigest`, `layoutIdentity`,
24
+ `programIdentity`, `cookIdentity`, and `materialPublicationIdentity`, and
25
+ compare `current` with `generation` before sending the first producer
26
+ divergence back through cold-cook and receipt/artifact verification.
27
+
17
28
  The shortest static consumer path is `configurePackIndex(url)` followed by
18
29
  `loadByGuid<ConcreteAsset>(guid)`. The public barrel exposes the concrete
19
30
  16-kind types and returns durable payloads, dependency `refs`, and local