pelican-engine 0.3.21 → 0.3.23

package/docs/api/REFERENCE.md

@@ -1,4 +1,4 @@
-# pelican 0.3.21 API 索引
+# pelican 0.3.23 API 索引
 
 Installed declarations: `lib/sdk/index.d.ts` (relative to the package root).
 The signatures below come from the same public SDK source as repository games.
@@ -11,7 +11,7 @@ Source-file paths and line numbers are build-time provenance only; TypeScript so
 来源：`packages/sdk/src/index.ts:2`
 
 ```ts
-SDK_VERSION = "0.3.21"
+SDK_VERSION = "0.3.23"
 ```
 
 ## Vec2
@@ -456,10 +456,18 @@ export interface ClothVisualOptions {
 }
 ```
 
-## ClothDefinition
+## ClothBodyCollider
 
 来源：`packages/sdk/src/index.ts:237`
 
+```ts
+export interface ClothBodyCollider { readonly id: string; readonly entity: string }
+```
+
+## ClothDefinition
+
+来源：`packages/sdk/src/index.ts:238`
+
 ```ts
 export interface ClothDefinition {
   id: string;
@@ -480,12 +488,16 @@ export interface ClothDefinition {
   visual?: ClothVisualOptions;
   /** Discrete non-adjacent particle self-contact; defaults to true for new cloth. */
   selfCollisions?: boolean;
+  /** Sphere triangle-surface contacts; defaults to true for new cloth. */
+  surfaceCollisions?: boolean;
+  /** Optional live dynamic sphere bindings; sampled after the physics phase, one-way only. */
+  bodyColliders?: readonly ClothBodyCollider[];
 }
 ```
 
 ## ClothContact
 
-来源：`packages/sdk/src/index.ts:257`
+来源：`packages/sdk/src/index.ts:262`
 
 ```ts
 export interface ClothContact { tick: number; particle: number; colliderId: string; penetration: number }
@@ -493,22 +505,30 @@ export interface ClothContact { tick: number; particle: number; colliderId: stri
 
 ## ClothSelfContact
 
-来源：`packages/sdk/src/index.ts:258`
+来源：`packages/sdk/src/index.ts:263`
 
 ```ts
 export interface ClothSelfContact { tick: number; firstParticle: number; secondParticle: number; penetration: number }
 ```
 
+## ClothSurfaceContact
+
+来源：`packages/sdk/src/index.ts:264`
+
+```ts
+export interface ClothSurfaceContact { tick: number; triangle: number; colliderId: string; penetration: number; barycentric: [number, number, number] }
+```
+
 ## ClothState
 
-来源：`packages/sdk/src/index.ts:259`
+来源：`packages/sdk/src/index.ts:265`
 
 ```ts
 export interface ClothState {
-  tick: number; simulatedSeconds: number; disposed: boolean; selfCollisions: boolean;
+  tick: number; simulatedSeconds: number; disposed: boolean; selfCollisions: boolean; surfaceCollisions: boolean;
   positions: Vec3[]; velocities: Vec3[]; triangles: ClothTriangle[];
   anchors: { index: number; position: Vec3 }[];
-  contacts: ClothContact[]; selfContacts: ClothSelfContact[];
+  contacts: ClothContact[]; selfContacts: ClothSelfContact[]; surfaceContacts: ClothSurfaceContact[];
   maxDistanceError: number;
   resources: { particles: number; triangles: number; constraints: number; anchors: number; colliders: number };
 }
@@ -516,7 +536,7 @@ export interface ClothState {
 
 ## ClothVisualState
 
-来源：`packages/sdk/src/index.ts:267`
+来源：`packages/sdk/src/index.ts:273`
 
 ```ts
 export interface ClothVisualState {
@@ -527,7 +547,7 @@ export interface ClothVisualState {
 
 ## ClothService
 
-来源：`packages/sdk/src/index.ts:271`
+来源：`packages/sdk/src/index.ts:277`
 
 ```ts
 export interface ClothService {
@@ -547,7 +567,7 @@ export interface ClothService {
 
 ## NavigationCell
 
-来源：`packages/sdk/src/index.ts:287`
+来源：`packages/sdk/src/index.ts:293`
 
 ```ts
 export interface NavigationCell { readonly x: number; readonly y: number }
@@ -555,7 +575,7 @@ export interface NavigationCell { readonly x: number; readonly y: number }
 
 ## NavigationObstacleUpdate
 
-来源：`packages/sdk/src/index.ts:289`
+来源：`packages/sdk/src/index.ts:295`
 
 ```ts
 export interface NavigationObstacleUpdate { readonly cell: NavigationCell; readonly blocked: boolean }
@@ -563,7 +583,7 @@ export interface NavigationObstacleUpdate { readonly cell: NavigationCell; reado
 
 ## NavigationGrid
 
-来源：`packages/sdk/src/index.ts:290`
+来源：`packages/sdk/src/index.ts:296`
 
 ```ts
 export interface NavigationGrid {
@@ -579,7 +599,7 @@ export interface NavigationGrid {
 
 ## NavigationService
 
-来源：`packages/sdk/src/index.ts:299`
+来源：`packages/sdk/src/index.ts:305`
 
 ```ts
 export interface NavigationService {
@@ -598,7 +618,7 @@ export interface NavigationService {
 
 ## RenderMode
 
-来源：`packages/sdk/src/index.ts:311`
+来源：`packages/sdk/src/index.ts:317`
 
 ```ts
 export type RenderMode = "raster" | "hybrid" | "path";
@@ -606,7 +626,7 @@ export type RenderMode = "raster" | "hybrid" | "path";
 
 ## RenderCapabilities
 
-来源：`packages/sdk/src/index.ts:312`
+来源：`packages/sdk/src/index.ts:318`
 
 ```ts
 export interface RenderCapabilities {
@@ -618,7 +638,7 @@ export interface RenderCapabilities {
 
 ## RenderSettings
 
-来源：`packages/sdk/src/index.ts:317`
+来源：`packages/sdk/src/index.ts:323`
 
 ```ts
 export interface RenderSettings {
@@ -636,7 +656,7 @@ export interface RenderSettings {
 
 ## RenderService
 
-来源：`packages/sdk/src/index.ts:328`
+来源：`packages/sdk/src/index.ts:334`
 
 ```ts
 export interface RenderService {
@@ -653,7 +673,7 @@ export interface RenderService {
 
 ## MaterialBufferInput
 
-来源：`packages/sdk/src/index.ts:338`
+来源：`packages/sdk/src/index.ts:344`
 
 ```ts
 export interface MaterialBufferInput {
@@ -669,7 +689,7 @@ export interface MaterialBufferInput {
 
 ## RenderBufferReference
 
-来源：`packages/sdk/src/index.ts:347`
+来源：`packages/sdk/src/index.ts:353`
 
 ```ts
 export interface RenderBufferReference {
@@ -681,7 +701,7 @@ export interface RenderBufferReference {
 
 ## RenderBufferBindings
 
-来源：`packages/sdk/src/index.ts:352`
+来源：`packages/sdk/src/index.ts:358`
 
 ```ts
 export interface RenderBufferBindings {
@@ -693,7 +713,7 @@ export interface RenderBufferBindings {
 
 ## MaterialTextureInput
 
-来源：`packages/sdk/src/index.ts:357`
+来源：`packages/sdk/src/index.ts:363`
 
 ```ts
 export interface MaterialTextureInput extends ComputeTextureBinding {
@@ -706,7 +726,7 @@ export interface MaterialTextureInput extends ComputeTextureBinding {
 
 ## RenderTextureReference
 
-来源：`packages/sdk/src/index.ts:363`
+来源：`packages/sdk/src/index.ts:369`
 
 ```ts
 export interface RenderTextureReference extends ComputeTextureSize {
@@ -717,7 +737,7 @@ export interface RenderTextureReference extends ComputeTextureSize {
 
 ## RenderTextureBindings
 
-来源：`packages/sdk/src/index.ts:367`
+来源：`packages/sdk/src/index.ts:373`
 
 ```ts
 export interface RenderTextureBindings {
@@ -729,7 +749,7 @@ export interface RenderTextureBindings {
 
 ## PostProcessState
 
-来源：`packages/sdk/src/index.ts:372`
+来源：`packages/sdk/src/index.ts:378`
 
 ```ts
 export interface PostProcessState {
@@ -741,7 +761,7 @@ export interface PostProcessState {
 
 ## PostProcessService
 
-来源：`packages/sdk/src/index.ts:377`
+来源：`packages/sdk/src/index.ts:383`
 
 ```ts
 export interface PostProcessService {
@@ -758,7 +778,7 @@ export interface PostProcessService {
 
 ## ComputeBufferHandle
 
-来源：`packages/sdk/src/index.ts:387`
+来源：`packages/sdk/src/index.ts:393`
 
 ```ts
 export interface ComputeBufferHandle {
@@ -770,7 +790,7 @@ export interface ComputeBufferHandle {
 
 ## ComputeTaskHandle
 
-来源：`packages/sdk/src/index.ts:392`
+来源：`packages/sdk/src/index.ts:398`
 
 ```ts
 export interface ComputeTaskHandle {
@@ -781,7 +801,7 @@ export interface ComputeTaskHandle {
 
 ## ComputeBufferInput
 
-来源：`packages/sdk/src/index.ts:396`
+来源：`packages/sdk/src/index.ts:402`
 
 ```ts
 export interface ComputeBufferInput {
@@ -794,7 +814,7 @@ export interface ComputeBufferInput {
 
 ## ComputeTextureHandle
 
-来源：`packages/sdk/src/index.ts:402`
+来源：`packages/sdk/src/index.ts:408`
 
 ```ts
 export interface ComputeTextureHandle {
@@ -807,7 +827,7 @@ export interface ComputeTextureHandle {
 
 ## ComputeTextureSize
 
-来源：`packages/sdk/src/index.ts:408`
+来源：`packages/sdk/src/index.ts:414`
 
 ```ts
 export interface ComputeTextureSize {
@@ -818,7 +838,7 @@ export interface ComputeTextureSize {
 
 ## ComputeTextureDataInput
 
-来源：`packages/sdk/src/index.ts:412`
+来源：`packages/sdk/src/index.ts:418`
 
 ```ts
 export interface ComputeTextureDataInput extends ComputeTextureSize {
@@ -831,7 +851,7 @@ export interface ComputeTextureDataInput extends ComputeTextureSize {
 
 ## ComputeTextureAssetInput
 
-来源：`packages/sdk/src/index.ts:418`
+来源：`packages/sdk/src/index.ts:424`
 
 ```ts
 export interface ComputeTextureAssetInput {
@@ -845,7 +865,7 @@ export interface ComputeTextureAssetInput {
 
 ## ComputeTextureInput
 
-来源：`packages/sdk/src/index.ts:425`
+来源：`packages/sdk/src/index.ts:431`
 
 ```ts
 export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetInput;
@@ -853,7 +873,7 @@ export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetI
 
 ## ComputeTextureBinding
 
-来源：`packages/sdk/src/index.ts:426`
+来源：`packages/sdk/src/index.ts:432`
 
 ```ts
 export interface ComputeTextureBinding {
@@ -866,7 +886,7 @@ export interface ComputeTextureBinding {
 
 ## ComputeDispatchInput
 
-来源：`packages/sdk/src/index.ts:432`
+来源：`packages/sdk/src/index.ts:438`
 
 ```ts
 export interface ComputeDispatchInput {
@@ -885,7 +905,7 @@ export interface ComputeDispatchInput {
 
 ## ComputeTaskState
 
-来源：`packages/sdk/src/index.ts:444`
+来源：`packages/sdk/src/index.ts:450`
 
 ```ts
 export interface ComputeTaskState {
@@ -896,7 +916,7 @@ export interface ComputeTaskState {
 
 ## ComputeService
 
-来源：`packages/sdk/src/index.ts:448`
+来源：`packages/sdk/src/index.ts:454`
 
 ```ts
 export interface ComputeService {
@@ -923,7 +943,7 @@ export interface ComputeService {
 
 ## InputService
 
-来源：`packages/sdk/src/index.ts:468`
+来源：`packages/sdk/src/index.ts:474`
 
 ```ts
 export interface InputService {
@@ -936,7 +956,7 @@ export interface InputService {
 
 ## PhysicsService
 
-来源：`packages/sdk/src/index.ts:474`
+来源：`packages/sdk/src/index.ts:480`
 
 ```ts
 export interface PhysicsService {
@@ -965,7 +985,7 @@ export interface PhysicsService {
 
 ## AnimationService
 
-来源：`packages/sdk/src/index.ts:496`
+来源：`packages/sdk/src/index.ts:502`
 
 ```ts
 export interface AnimationService {
@@ -984,7 +1004,7 @@ export interface AnimationService {
 
 ## CameraService
 
-来源：`packages/sdk/src/index.ts:508`
+来源：`packages/sdk/src/index.ts:514`
 
 ```ts
 export interface CameraService {
@@ -1004,7 +1024,7 @@ export interface CameraService {
 
 ## UIService
 
-来源：`packages/sdk/src/index.ts:521`
+来源：`packages/sdk/src/index.ts:527`
 
 ```ts
 export interface UIService {
@@ -1016,7 +1036,7 @@ export interface UIService {
 
 ## AudioService
 
-来源：`packages/sdk/src/index.ts:526`
+来源：`packages/sdk/src/index.ts:532`
 
 ```ts
 export interface AudioService {
@@ -1038,7 +1058,7 @@ export interface AudioService {
 
 ## StorageService
 
-来源：`packages/sdk/src/index.ts:541`
+来源：`packages/sdk/src/index.ts:547`
 
 ```ts
 export interface StorageService {
@@ -1054,7 +1074,7 @@ export interface StorageService {
 
 ## SceneService
 
-来源：`packages/sdk/src/index.ts:550`
+来源：`packages/sdk/src/index.ts:556`
 
 ```ts
 export interface SceneService {
@@ -1065,7 +1085,7 @@ export interface SceneService {
 
 ## ModelDefinition
 
-来源：`packages/sdk/src/index.ts:554`
+来源：`packages/sdk/src/index.ts:560`
 
 ```ts
 export interface ModelDefinition {
@@ -1085,7 +1105,7 @@ export interface ModelDefinition {
 
 ## RigidBodyDefinition
 
-来源：`packages/sdk/src/index.ts:567`
+来源：`packages/sdk/src/index.ts:573`
 
 ```ts
 export interface RigidBodyDefinition {
@@ -1106,7 +1126,7 @@ export interface RigidBodyDefinition {
 
 ## CharacterDefinition
 
-来源：`packages/sdk/src/index.ts:581`
+来源：`packages/sdk/src/index.ts:587`
 
 ```ts
 export interface CharacterDefinition {
@@ -1121,7 +1141,7 @@ export interface CharacterDefinition {
 
 ## UIElementDefinition
 
-来源：`packages/sdk/src/index.ts:589`
+来源：`packages/sdk/src/index.ts:595`
 
 ```ts
 export interface UIElementDefinition {
@@ -1141,7 +1161,7 @@ export interface UIElementDefinition {
 
 ## SoundDefinition
 
-来源：`packages/sdk/src/index.ts:602`
+来源：`packages/sdk/src/index.ts:608`
 
 ```ts
 export interface SoundDefinition {
@@ -1155,7 +1175,7 @@ export interface SoundDefinition {
 
 ## AudioBusDefinition
 
-来源：`packages/sdk/src/index.ts:609`
+来源：`packages/sdk/src/index.ts:615`
 
 ```ts
 export interface AudioBusDefinition {
@@ -1166,7 +1186,7 @@ export interface AudioBusDefinition {
 
 ## SYSTEM_PHASES
 
-来源：`packages/sdk/src/index.ts:613`
+来源：`packages/sdk/src/index.ts:619`
 
 ```ts
 SYSTEM_PHASES = [
@@ -1181,7 +1201,7 @@ SYSTEM_PHASES = [
 
 ## SystemPhase
 
-来源：`packages/sdk/src/index.ts:621`
+来源：`packages/sdk/src/index.ts:627`
 
 ```ts
 export type SystemPhase = (typeof SYSTEM_PHASES)[number];
@@ -1189,7 +1209,7 @@ export type SystemPhase = (typeof SYSTEM_PHASES)[number];
 
 ## Geometry
 
-来源：`packages/sdk/src/index.ts:622`
+来源：`packages/sdk/src/index.ts:628`
 
 ```ts
 export type Geometry =
@@ -1200,7 +1220,7 @@ export type Geometry =
 
 ## GRAPH_TYPES
 
-来源：`packages/sdk/src/index.ts:626`
+来源：`packages/sdk/src/index.ts:632`
 
 ```ts
 GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
@@ -1208,7 +1228,7 @@ GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
 
 ## GraphType
 
-来源：`packages/sdk/src/index.ts:627`
+来源：`packages/sdk/src/index.ts:633`
 
 ```ts
 export type GraphType = typeof GRAPH_TYPES[number];
@@ -1216,7 +1236,7 @@ export type GraphType = typeof GRAPH_TYPES[number];
 
 ## GraphValue
 
-来源：`packages/sdk/src/index.ts:628`
+来源：`packages/sdk/src/index.ts:634`
 
 ```ts
 export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
@@ -1224,7 +1244,7 @@ export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
 
 ## GraphParameter
 
-来源：`packages/sdk/src/index.ts:629`
+来源：`packages/sdk/src/index.ts:635`
 
 ```ts
 export interface GraphParameter {
@@ -1236,7 +1256,7 @@ export interface GraphParameter {
 
 ## GRAPH_INPUT_TYPES
 
-来源：`packages/sdk/src/index.ts:634`
+来源：`packages/sdk/src/index.ts:640`
 
 ```ts
 GRAPH_INPUT_TYPES = {
@@ -1250,7 +1270,7 @@ GRAPH_INPUT_TYPES = {
 
 ## GraphInputName
 
-来源：`packages/sdk/src/index.ts:641`
+来源：`packages/sdk/src/index.ts:647`
 
 ```ts
 export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
@@ -1258,7 +1278,7 @@ export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
 
 ## GRAPH_OPERATIONS
 
-来源：`packages/sdk/src/index.ts:642`
+来源：`packages/sdk/src/index.ts:648`
 
 ```ts
 GRAPH_OPERATIONS = {
@@ -1270,7 +1290,7 @@ GRAPH_OPERATIONS = {
 
 ## GraphNode
 
-来源：`packages/sdk/src/index.ts:647`
+来源：`packages/sdk/src/index.ts:653`
 
 ```ts
 export type GraphNode =
@@ -1297,7 +1317,7 @@ export type GraphNode =
 
 ## Graph
 
-来源：`packages/sdk/src/index.ts:667`
+来源：`packages/sdk/src/index.ts:673`
 
 ```ts
 export interface Graph {
@@ -1309,7 +1329,7 @@ export interface Graph {
 
 ## MaterialGraphs
 
-来源：`packages/sdk/src/index.ts:672`
+来源：`packages/sdk/src/index.ts:678`
 
 ```ts
 export interface MaterialGraphs {
@@ -1325,7 +1345,7 @@ export interface MaterialGraphs {
 
 ## VertexGraphs
 
-来源：`packages/sdk/src/index.ts:681`
+来源：`packages/sdk/src/index.ts:687`
 
 ```ts
 export interface VertexGraphs {
@@ -1338,7 +1358,7 @@ export interface VertexGraphs {
 
 ## MaterialInput
 
-来源：`packages/sdk/src/index.ts:687`
+来源：`packages/sdk/src/index.ts:693`
 
 ```ts
 export interface MaterialInput {
@@ -1372,7 +1392,7 @@ export interface MaterialInput {
 
 ## MaterialDefinition
 
-来源：`packages/sdk/src/index.ts:714`
+来源：`packages/sdk/src/index.ts:720`
 
 ```ts
 export interface MaterialDefinition extends MaterialInput {
@@ -1382,7 +1402,7 @@ export interface MaterialDefinition extends MaterialInput {
 
 ## PostProcessInput
 
-来源：`packages/sdk/src/index.ts:717`
+来源：`packages/sdk/src/index.ts:723`
 
 ```ts
 export interface PostProcessInput {
@@ -1397,7 +1417,7 @@ export interface PostProcessInput {
 
 ## PostProcessDefinition
 
-来源：`packages/sdk/src/index.ts:725`
+来源：`packages/sdk/src/index.ts:731`
 
 ```ts
 export interface PostProcessDefinition extends PostProcessInput {
@@ -1407,7 +1427,7 @@ export interface PostProcessDefinition extends PostProcessInput {
 
 ## ComputeInput
 
-来源：`packages/sdk/src/index.ts:728`
+来源：`packages/sdk/src/index.ts:734`
 
 ```ts
 export interface ComputeInput {
@@ -1423,7 +1443,7 @@ export interface ComputeInput {
 
 ## ComputeDefinition
 
-来源：`packages/sdk/src/index.ts:737`
+来源：`packages/sdk/src/index.ts:743`
 
 ```ts
 export interface ComputeDefinition extends ComputeInput {
@@ -1433,7 +1453,7 @@ export interface ComputeDefinition extends ComputeInput {
 
 ## AssetInput
 
-来源：`packages/sdk/src/index.ts:740`
+来源：`packages/sdk/src/index.ts:746`
 
 ```ts
 export interface AssetInput {
@@ -1450,7 +1470,7 @@ export interface AssetInput {
 
 ## AssetDefinition
 
-来源：`packages/sdk/src/index.ts:750`
+来源：`packages/sdk/src/index.ts:756`
 
 ```ts
 export interface AssetDefinition extends AssetInput {
@@ -1460,7 +1480,7 @@ export interface AssetDefinition extends AssetInput {
 
 ## MeshDefinition
 
-来源：`packages/sdk/src/index.ts:753`
+来源：`packages/sdk/src/index.ts:759`
 
 ```ts
 export interface MeshDefinition {
@@ -1473,7 +1493,7 @@ export interface MeshDefinition {
 
 ## LightDefinition
 
-来源：`packages/sdk/src/index.ts:759`
+来源：`packages/sdk/src/index.ts:765`
 
 ```ts
 export interface LightDefinition {
@@ -1495,7 +1515,7 @@ export interface LightDefinition {
 
 ## EntityInput
 
-来源：`packages/sdk/src/index.ts:774`
+来源：`packages/sdk/src/index.ts:780`
 
 ```ts
 export interface EntityInput {
@@ -1514,7 +1534,7 @@ export interface EntityInput {
 
 ## PrefabInput
 
-来源：`packages/sdk/src/index.ts:786`
+来源：`packages/sdk/src/index.ts:792`
 
 ```ts
 export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
@@ -1524,7 +1544,7 @@ export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
 
 ## PrefabDefinition
 
-来源：`packages/sdk/src/index.ts:789`
+来源：`packages/sdk/src/index.ts:795`
 
 ```ts
 export interface PrefabDefinition extends PrefabInput {
@@ -1534,7 +1554,7 @@ export interface PrefabDefinition extends PrefabInput {
 
 ## SceneInput
 
-来源：`packages/sdk/src/index.ts:792`
+来源：`packages/sdk/src/index.ts:798`
 
 ```ts
 export interface SceneInput {
@@ -1566,7 +1586,7 @@ export interface SceneInput {
 
 ## SceneDefinition
 
-来源：`packages/sdk/src/index.ts:817`
+来源：`packages/sdk/src/index.ts:823`
 
 ```ts
 export interface SceneDefinition extends SceneInput {
@@ -1576,7 +1596,7 @@ export interface SceneDefinition extends SceneInput {
 
 ## SystemInput
 
-来源：`packages/sdk/src/index.ts:820`
+来源：`packages/sdk/src/index.ts:826`
 
 ```ts
 export interface SystemInput {
@@ -1593,7 +1613,7 @@ export interface SystemInput {
 
 ## SystemDefinition
 
-来源：`packages/sdk/src/index.ts:830`
+来源：`packages/sdk/src/index.ts:836`
 
 ```ts
 export interface SystemDefinition extends SystemInput {
@@ -1603,7 +1623,7 @@ export interface SystemDefinition extends SystemInput {
 
 ## GameInput
 
-来源：`packages/sdk/src/index.ts:833`
+来源：`packages/sdk/src/index.ts:839`
 
 ```ts
 export interface GameInput {
@@ -1629,7 +1649,7 @@ export interface GameInput {
 
 ## GameDefinition
 
-来源：`packages/sdk/src/index.ts:852`
+来源：`packages/sdk/src/index.ts:858`
 
 ```ts
 export interface GameDefinition extends GameInput {
@@ -1639,7 +1659,7 @@ export interface GameDefinition extends GameInput {
 
 ## GameInstance
 
-来源：`packages/sdk/src/index.ts:855`
+来源：`packages/sdk/src/index.ts:861`
 
 ```ts
 export interface GameInstance {
@@ -1650,7 +1670,7 @@ export interface GameInstance {
 
 ## defineComponent
 
-来源：`packages/sdk/src/index.ts:859`
+来源：`packages/sdk/src/index.ts:865`
 
 ```ts
 export function defineComponent<const S extends ComponentSchema>(input: {
@@ -1661,7 +1681,7 @@ export function defineComponent<const S extends ComponentSchema>(input: {
 
 ## defineMaterial
 
-来源：`packages/sdk/src/index.ts:865`
+来源：`packages/sdk/src/index.ts:871`
 
 ```ts
 export function defineMaterial(input: MaterialInput): MaterialDefinition;
@@ -1669,7 +1689,7 @@ export function defineMaterial(input: MaterialInput): MaterialDefinition;
 
 ## definePostProcess
 
-来源：`packages/sdk/src/index.ts:868`
+来源：`packages/sdk/src/index.ts:874`
 
 ```ts
 export function definePostProcess(input: PostProcessInput): PostProcessDefinition;
@@ -1677,7 +1697,7 @@ export function definePostProcess(input: PostProcessInput): PostProcessDefinitio
 
 ## defineCompute
 
-来源：`packages/sdk/src/index.ts:871`
+来源：`packages/sdk/src/index.ts:877`
 
 ```ts
 export function defineCompute(input: ComputeInput): ComputeDefinition;
@@ -1685,7 +1705,7 @@ export function defineCompute(input: ComputeInput): ComputeDefinition;
 
 ## defineAsset
 
-来源：`packages/sdk/src/index.ts:874`
+来源：`packages/sdk/src/index.ts:880`
 
 ```ts
 export function defineAsset(input: AssetInput): AssetDefinition;
@@ -1693,7 +1713,7 @@ export function defineAsset(input: AssetInput): AssetDefinition;
 
 ## definePrefab
 
-来源：`packages/sdk/src/index.ts:877`
+来源：`packages/sdk/src/index.ts:883`
 
 ```ts
 export function definePrefab(input: PrefabInput): PrefabDefinition;
@@ -1701,7 +1721,7 @@ export function definePrefab(input: PrefabInput): PrefabDefinition;
 
 ## defineScene
 
-来源：`packages/sdk/src/index.ts:880`
+来源：`packages/sdk/src/index.ts:886`
 
 ```ts
 export function defineScene(input: SceneInput): SceneDefinition;
@@ -1709,7 +1729,7 @@ export function defineScene(input: SceneInput): SceneDefinition;
 
 ## defineSystem
 
-来源：`packages/sdk/src/index.ts:883`
+来源：`packages/sdk/src/index.ts:889`
 
 ```ts
 export function defineSystem(input: SystemInput): SystemDefinition;
@@ -1717,7 +1737,7 @@ export function defineSystem(input: SystemInput): SystemDefinition;
 
 ## defineGame
 
-来源：`packages/sdk/src/index.ts:886`
+来源：`packages/sdk/src/index.ts:892`
 
 ```ts
 export function defineGame(input: GameInput): GameDefinition;
@@ -1725,7 +1745,7 @@ export function defineGame(input: GameInput): GameDefinition;
 
 ## instantiateGame
 
-来源：`packages/sdk/src/index.ts:890`
+来源：`packages/sdk/src/index.ts:896`
 
 ```ts
 export function instantiateGame(