pelican-engine 0.3.11 → 0.3.13

package/docs/api/REFERENCE.md

@@ -1,4 +1,4 @@
-# pelican 0.3.11 API 索引
+# pelican 0.3.13 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.11"
+SDK_VERSION = "0.3.13"
 ```
 
 ## Vec2
@@ -268,9 +268,17 @@ export type RopeCollider =
   | { kind: "plane"; id: string; normal: Vec3; offset: number };
 ```
 
+## RopeBodyCollider
+
+来源：`packages/sdk/src/index.ts:127`
+
+```ts
+export interface RopeBodyCollider { readonly id: string; readonly entity: string }
+```
+
 ## RopeDefinition
 
-来源：`packages/sdk/src/index.ts:126`
+来源：`packages/sdk/src/index.ts:128`
 
 ```ts
 export interface RopeDefinition {
@@ -283,6 +291,8 @@ export interface RopeDefinition {
   fixedDt?: number;
   /** When true, step once after each physics phase; defaults to false (manual stepping). */
   autoStep?: boolean;
+  /** Automatically sample and react to existing dynamic, non-trigger sphere bodies. Requires autoStep. */
+  bodyColliders?: readonly RopeBodyCollider[];
   substeps?: number;
   iterations?: number;
   damping?: number;
@@ -291,16 +301,30 @@ export interface RopeDefinition {
 }
 ```
 
+## RopeContact
+
+来源：`packages/sdk/src/index.ts:147`
+
+```ts
+export interface RopeContact {
+  tick: number; particle: number; colliderId: string; penetration: number;
+  /** Opposite of particle projection impulses, N·s; absent in older snapshots. */
+  reactionImpulse?: Vec3;
+  /** Angular impulse about the world origin; absent in older snapshots. */
+  reactionAngularImpulse?: Vec3;
+}
+```
+
 ## RopeState
 
-来源：`packages/sdk/src/index.ts:142`
+来源：`packages/sdk/src/index.ts:154`
 
 ```ts
 export interface RopeState {
   tick: number; simulatedSeconds: number; disposed: boolean;
   positions: Vec3[]; velocities: Vec3[];
   anchors: { index: number; position: Vec3 }[];
-  contacts: { tick: number; particle: number; colliderId: string; penetration: number }[];
+  contacts: RopeContact[];
   maxDistanceError: number;
   resources: { particles: number; constraints: number; anchors: number; colliders: number };
 }
@@ -308,7 +332,7 @@ export interface RopeState {
 
 ## RopeService
 
-来源：`packages/sdk/src/index.ts:150`
+来源：`packages/sdk/src/index.ts:162`
 
 ```ts
 export interface RopeService {
@@ -327,7 +351,7 @@ export interface RopeService {
 
 ## NavigationCell
 
-来源：`packages/sdk/src/index.ts:165`
+来源：`packages/sdk/src/index.ts:177`
 
 ```ts
 export interface NavigationCell { readonly x: number; readonly y: number }
@@ -335,7 +359,7 @@ export interface NavigationCell { readonly x: number; readonly y: number }
 
 ## NavigationObstacleUpdate
 
-来源：`packages/sdk/src/index.ts:167`
+来源：`packages/sdk/src/index.ts:179`
 
 ```ts
 export interface NavigationObstacleUpdate { readonly cell: NavigationCell; readonly blocked: boolean }
@@ -343,7 +367,7 @@ export interface NavigationObstacleUpdate { readonly cell: NavigationCell; reado
 
 ## NavigationGrid
 
-来源：`packages/sdk/src/index.ts:168`
+来源：`packages/sdk/src/index.ts:180`
 
 ```ts
 export interface NavigationGrid {
@@ -359,7 +383,7 @@ export interface NavigationGrid {
 
 ## NavigationService
 
-来源：`packages/sdk/src/index.ts:177`
+来源：`packages/sdk/src/index.ts:189`
 
 ```ts
 export interface NavigationService {
@@ -378,7 +402,7 @@ export interface NavigationService {
 
 ## RenderMode
 
-来源：`packages/sdk/src/index.ts:189`
+来源：`packages/sdk/src/index.ts:201`
 
 ```ts
 export type RenderMode = "raster" | "hybrid" | "path";
@@ -386,7 +410,7 @@ export type RenderMode = "raster" | "hybrid" | "path";
 
 ## RenderCapabilities
 
-来源：`packages/sdk/src/index.ts:190`
+来源：`packages/sdk/src/index.ts:202`
 
 ```ts
 export interface RenderCapabilities {
@@ -398,7 +422,7 @@ export interface RenderCapabilities {
 
 ## RenderSettings
 
-来源：`packages/sdk/src/index.ts:195`
+来源：`packages/sdk/src/index.ts:207`
 
 ```ts
 export interface RenderSettings {
@@ -416,7 +440,7 @@ export interface RenderSettings {
 
 ## RenderService
 
-来源：`packages/sdk/src/index.ts:206`
+来源：`packages/sdk/src/index.ts:218`
 
 ```ts
 export interface RenderService {
@@ -433,7 +457,7 @@ export interface RenderService {
 
 ## MaterialBufferInput
 
-来源：`packages/sdk/src/index.ts:216`
+来源：`packages/sdk/src/index.ts:228`
 
 ```ts
 export interface MaterialBufferInput {
@@ -449,7 +473,7 @@ export interface MaterialBufferInput {
 
 ## RenderBufferReference
 
-来源：`packages/sdk/src/index.ts:225`
+来源：`packages/sdk/src/index.ts:237`
 
 ```ts
 export interface RenderBufferReference {
@@ -461,7 +485,7 @@ export interface RenderBufferReference {
 
 ## RenderBufferBindings
 
-来源：`packages/sdk/src/index.ts:230`
+来源：`packages/sdk/src/index.ts:242`
 
 ```ts
 export interface RenderBufferBindings {
@@ -473,7 +497,7 @@ export interface RenderBufferBindings {
 
 ## MaterialTextureInput
 
-来源：`packages/sdk/src/index.ts:235`
+来源：`packages/sdk/src/index.ts:247`
 
 ```ts
 export interface MaterialTextureInput extends ComputeTextureBinding {
@@ -486,7 +510,7 @@ export interface MaterialTextureInput extends ComputeTextureBinding {
 
 ## RenderTextureReference
 
-来源：`packages/sdk/src/index.ts:241`
+来源：`packages/sdk/src/index.ts:253`
 
 ```ts
 export interface RenderTextureReference extends ComputeTextureSize {
@@ -497,7 +521,7 @@ export interface RenderTextureReference extends ComputeTextureSize {
 
 ## RenderTextureBindings
 
-来源：`packages/sdk/src/index.ts:245`
+来源：`packages/sdk/src/index.ts:257`
 
 ```ts
 export interface RenderTextureBindings {
@@ -509,7 +533,7 @@ export interface RenderTextureBindings {
 
 ## PostProcessState
 
-来源：`packages/sdk/src/index.ts:250`
+来源：`packages/sdk/src/index.ts:262`
 
 ```ts
 export interface PostProcessState {
@@ -521,7 +545,7 @@ export interface PostProcessState {
 
 ## PostProcessService
 
-来源：`packages/sdk/src/index.ts:255`
+来源：`packages/sdk/src/index.ts:267`
 
 ```ts
 export interface PostProcessService {
@@ -538,7 +562,7 @@ export interface PostProcessService {
 
 ## ComputeBufferHandle
 
-来源：`packages/sdk/src/index.ts:265`
+来源：`packages/sdk/src/index.ts:277`
 
 ```ts
 export interface ComputeBufferHandle {
@@ -550,7 +574,7 @@ export interface ComputeBufferHandle {
 
 ## ComputeTaskHandle
 
-来源：`packages/sdk/src/index.ts:270`
+来源：`packages/sdk/src/index.ts:282`
 
 ```ts
 export interface ComputeTaskHandle {
@@ -561,7 +585,7 @@ export interface ComputeTaskHandle {
 
 ## ComputeBufferInput
 
-来源：`packages/sdk/src/index.ts:274`
+来源：`packages/sdk/src/index.ts:286`
 
 ```ts
 export interface ComputeBufferInput {
@@ -574,7 +598,7 @@ export interface ComputeBufferInput {
 
 ## ComputeTextureHandle
 
-来源：`packages/sdk/src/index.ts:280`
+来源：`packages/sdk/src/index.ts:292`
 
 ```ts
 export interface ComputeTextureHandle {
@@ -587,7 +611,7 @@ export interface ComputeTextureHandle {
 
 ## ComputeTextureSize
 
-来源：`packages/sdk/src/index.ts:286`
+来源：`packages/sdk/src/index.ts:298`
 
 ```ts
 export interface ComputeTextureSize {
@@ -598,7 +622,7 @@ export interface ComputeTextureSize {
 
 ## ComputeTextureDataInput
 
-来源：`packages/sdk/src/index.ts:290`
+来源：`packages/sdk/src/index.ts:302`
 
 ```ts
 export interface ComputeTextureDataInput extends ComputeTextureSize {
@@ -611,7 +635,7 @@ export interface ComputeTextureDataInput extends ComputeTextureSize {
 
 ## ComputeTextureAssetInput
 
-来源：`packages/sdk/src/index.ts:296`
+来源：`packages/sdk/src/index.ts:308`
 
 ```ts
 export interface ComputeTextureAssetInput {
@@ -625,7 +649,7 @@ export interface ComputeTextureAssetInput {
 
 ## ComputeTextureInput
 
-来源：`packages/sdk/src/index.ts:303`
+来源：`packages/sdk/src/index.ts:315`
 
 ```ts
 export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetInput;
@@ -633,7 +657,7 @@ export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetI
 
 ## ComputeTextureBinding
 
-来源：`packages/sdk/src/index.ts:304`
+来源：`packages/sdk/src/index.ts:316`
 
 ```ts
 export interface ComputeTextureBinding {
@@ -646,7 +670,7 @@ export interface ComputeTextureBinding {
 
 ## ComputeDispatchInput
 
-来源：`packages/sdk/src/index.ts:310`
+来源：`packages/sdk/src/index.ts:322`
 
 ```ts
 export interface ComputeDispatchInput {
@@ -665,7 +689,7 @@ export interface ComputeDispatchInput {
 
 ## ComputeTaskState
 
-来源：`packages/sdk/src/index.ts:322`
+来源：`packages/sdk/src/index.ts:334`
 
 ```ts
 export interface ComputeTaskState {
@@ -676,7 +700,7 @@ export interface ComputeTaskState {
 
 ## ComputeService
 
-来源：`packages/sdk/src/index.ts:326`
+来源：`packages/sdk/src/index.ts:338`
 
 ```ts
 export interface ComputeService {
@@ -703,7 +727,7 @@ export interface ComputeService {
 
 ## InputService
 
-来源：`packages/sdk/src/index.ts:346`
+来源：`packages/sdk/src/index.ts:358`
 
 ```ts
 export interface InputService {
@@ -716,13 +740,15 @@ export interface InputService {
 
 ## PhysicsService
 
-来源：`packages/sdk/src/index.ts:352`
+来源：`packages/sdk/src/index.ts:364`
 
 ```ts
 export interface PhysicsService {
   moveCharacter(entity: string, displacement: Vec3): void;
   grounded(entity: string): boolean;
   velocity(entity: string): Vec3;
+  /** World-space rigid-body center of mass, including collider offsets. */
+  centerOfMass(entity: string): Vec3;
   setVelocity(entity: string, velocity: Vec3): void;
   impulse(entity: string, impulse: Vec3): void;
   /** Angular velocity in world-space radians per second. */
@@ -743,7 +769,7 @@ export interface PhysicsService {
 
 ## AnimationService
 
-来源：`packages/sdk/src/index.ts:372`
+来源：`packages/sdk/src/index.ts:386`
 
 ```ts
 export interface AnimationService {
@@ -762,7 +788,7 @@ export interface AnimationService {
 
 ## CameraService
 
-来源：`packages/sdk/src/index.ts:384`
+来源：`packages/sdk/src/index.ts:398`
 
 ```ts
 export interface CameraService {
@@ -782,7 +808,7 @@ export interface CameraService {
 
 ## UIService
 
-来源：`packages/sdk/src/index.ts:397`
+来源：`packages/sdk/src/index.ts:411`
 
 ```ts
 export interface UIService {
@@ -794,7 +820,7 @@ export interface UIService {
 
 ## AudioService
 
-来源：`packages/sdk/src/index.ts:402`
+来源：`packages/sdk/src/index.ts:416`
 
 ```ts
 export interface AudioService {
@@ -816,7 +842,7 @@ export interface AudioService {
 
 ## StorageService
 
-来源：`packages/sdk/src/index.ts:417`
+来源：`packages/sdk/src/index.ts:431`
 
 ```ts
 export interface StorageService {
@@ -832,7 +858,7 @@ export interface StorageService {
 
 ## SceneService
 
-来源：`packages/sdk/src/index.ts:426`
+来源：`packages/sdk/src/index.ts:440`
 
 ```ts
 export interface SceneService {
@@ -843,7 +869,7 @@ export interface SceneService {
 
 ## ModelDefinition
 
-来源：`packages/sdk/src/index.ts:430`
+来源：`packages/sdk/src/index.ts:444`
 
 ```ts
 export interface ModelDefinition {
@@ -863,7 +889,7 @@ export interface ModelDefinition {
 
 ## RigidBodyDefinition
 
-来源：`packages/sdk/src/index.ts:443`
+来源：`packages/sdk/src/index.ts:457`
 
 ```ts
 export interface RigidBodyDefinition {
@@ -884,7 +910,7 @@ export interface RigidBodyDefinition {
 
 ## CharacterDefinition
 
-来源：`packages/sdk/src/index.ts:457`
+来源：`packages/sdk/src/index.ts:471`
 
 ```ts
 export interface CharacterDefinition {
@@ -899,7 +925,7 @@ export interface CharacterDefinition {
 
 ## UIElementDefinition
 
-来源：`packages/sdk/src/index.ts:465`
+来源：`packages/sdk/src/index.ts:479`
 
 ```ts
 export interface UIElementDefinition {
@@ -919,7 +945,7 @@ export interface UIElementDefinition {
 
 ## SoundDefinition
 
-来源：`packages/sdk/src/index.ts:478`
+来源：`packages/sdk/src/index.ts:492`
 
 ```ts
 export interface SoundDefinition {
@@ -933,7 +959,7 @@ export interface SoundDefinition {
 
 ## AudioBusDefinition
 
-来源：`packages/sdk/src/index.ts:485`
+来源：`packages/sdk/src/index.ts:499`
 
 ```ts
 export interface AudioBusDefinition {
@@ -944,7 +970,7 @@ export interface AudioBusDefinition {
 
 ## SYSTEM_PHASES
 
-来源：`packages/sdk/src/index.ts:489`
+来源：`packages/sdk/src/index.ts:503`
 
 ```ts
 SYSTEM_PHASES = [
@@ -959,7 +985,7 @@ SYSTEM_PHASES = [
 
 ## SystemPhase
 
-来源：`packages/sdk/src/index.ts:497`
+来源：`packages/sdk/src/index.ts:511`
 
 ```ts
 export type SystemPhase = (typeof SYSTEM_PHASES)[number];
@@ -967,7 +993,7 @@ export type SystemPhase = (typeof SYSTEM_PHASES)[number];
 
 ## Geometry
 
-来源：`packages/sdk/src/index.ts:498`
+来源：`packages/sdk/src/index.ts:512`
 
 ```ts
 export type Geometry =
@@ -978,7 +1004,7 @@ export type Geometry =
 
 ## GRAPH_TYPES
 
-来源：`packages/sdk/src/index.ts:502`
+来源：`packages/sdk/src/index.ts:516`
 
 ```ts
 GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
@@ -986,7 +1012,7 @@ GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
 
 ## GraphType
 
-来源：`packages/sdk/src/index.ts:503`
+来源：`packages/sdk/src/index.ts:517`
 
 ```ts
 export type GraphType = typeof GRAPH_TYPES[number];
@@ -994,7 +1020,7 @@ export type GraphType = typeof GRAPH_TYPES[number];
 
 ## GraphValue
 
-来源：`packages/sdk/src/index.ts:504`
+来源：`packages/sdk/src/index.ts:518`
 
 ```ts
 export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
@@ -1002,7 +1028,7 @@ export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
 
 ## GraphParameter
 
-来源：`packages/sdk/src/index.ts:505`
+来源：`packages/sdk/src/index.ts:519`
 
 ```ts
 export interface GraphParameter {
@@ -1014,7 +1040,7 @@ export interface GraphParameter {
 
 ## GRAPH_INPUT_TYPES
 
-来源：`packages/sdk/src/index.ts:510`
+来源：`packages/sdk/src/index.ts:524`
 
 ```ts
 GRAPH_INPUT_TYPES = {
@@ -1028,7 +1054,7 @@ GRAPH_INPUT_TYPES = {
 
 ## GraphInputName
 
-来源：`packages/sdk/src/index.ts:517`
+来源：`packages/sdk/src/index.ts:531`
 
 ```ts
 export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
@@ -1036,7 +1062,7 @@ export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
 
 ## GRAPH_OPERATIONS
 
-来源：`packages/sdk/src/index.ts:518`
+来源：`packages/sdk/src/index.ts:532`
 
 ```ts
 GRAPH_OPERATIONS = {
@@ -1048,7 +1074,7 @@ GRAPH_OPERATIONS = {
 
 ## GraphNode
 
-来源：`packages/sdk/src/index.ts:523`
+来源：`packages/sdk/src/index.ts:537`
 
 ```ts
 export type GraphNode =
@@ -1075,7 +1101,7 @@ export type GraphNode =
 
 ## Graph
 
-来源：`packages/sdk/src/index.ts:543`
+来源：`packages/sdk/src/index.ts:557`
 
 ```ts
 export interface Graph {
@@ -1087,7 +1113,7 @@ export interface Graph {
 
 ## MaterialGraphs
 
-来源：`packages/sdk/src/index.ts:548`
+来源：`packages/sdk/src/index.ts:562`
 
 ```ts
 export interface MaterialGraphs {
@@ -1103,7 +1129,7 @@ export interface MaterialGraphs {
 
 ## VertexGraphs
 
-来源：`packages/sdk/src/index.ts:557`
+来源：`packages/sdk/src/index.ts:571`
 
 ```ts
 export interface VertexGraphs {
@@ -1116,7 +1142,7 @@ export interface VertexGraphs {
 
 ## MaterialInput
 
-来源：`packages/sdk/src/index.ts:563`
+来源：`packages/sdk/src/index.ts:577`
 
 ```ts
 export interface MaterialInput {
@@ -1150,7 +1176,7 @@ export interface MaterialInput {
 
 ## MaterialDefinition
 
-来源：`packages/sdk/src/index.ts:590`
+来源：`packages/sdk/src/index.ts:604`
 
 ```ts
 export interface MaterialDefinition extends MaterialInput {
@@ -1160,7 +1186,7 @@ export interface MaterialDefinition extends MaterialInput {
 
 ## PostProcessInput
 
-来源：`packages/sdk/src/index.ts:593`
+来源：`packages/sdk/src/index.ts:607`
 
 ```ts
 export interface PostProcessInput {
@@ -1175,7 +1201,7 @@ export interface PostProcessInput {
 
 ## PostProcessDefinition
 
-来源：`packages/sdk/src/index.ts:601`
+来源：`packages/sdk/src/index.ts:615`
 
 ```ts
 export interface PostProcessDefinition extends PostProcessInput {
@@ -1185,7 +1211,7 @@ export interface PostProcessDefinition extends PostProcessInput {
 
 ## ComputeInput
 
-来源：`packages/sdk/src/index.ts:604`
+来源：`packages/sdk/src/index.ts:618`
 
 ```ts
 export interface ComputeInput {
@@ -1201,7 +1227,7 @@ export interface ComputeInput {
 
 ## ComputeDefinition
 
-来源：`packages/sdk/src/index.ts:613`
+来源：`packages/sdk/src/index.ts:627`
 
 ```ts
 export interface ComputeDefinition extends ComputeInput {
@@ -1211,7 +1237,7 @@ export interface ComputeDefinition extends ComputeInput {
 
 ## AssetInput
 
-来源：`packages/sdk/src/index.ts:616`
+来源：`packages/sdk/src/index.ts:630`
 
 ```ts
 export interface AssetInput {
@@ -1228,7 +1254,7 @@ export interface AssetInput {
 
 ## AssetDefinition
 
-来源：`packages/sdk/src/index.ts:626`
+来源：`packages/sdk/src/index.ts:640`
 
 ```ts
 export interface AssetDefinition extends AssetInput {
@@ -1238,7 +1264,7 @@ export interface AssetDefinition extends AssetInput {
 
 ## MeshDefinition
 
-来源：`packages/sdk/src/index.ts:629`
+来源：`packages/sdk/src/index.ts:643`
 
 ```ts
 export interface MeshDefinition {
@@ -1251,7 +1277,7 @@ export interface MeshDefinition {
 
 ## LightDefinition
 
-来源：`packages/sdk/src/index.ts:635`
+来源：`packages/sdk/src/index.ts:649`
 
 ```ts
 export interface LightDefinition {
@@ -1273,7 +1299,7 @@ export interface LightDefinition {
 
 ## EntityInput
 
-来源：`packages/sdk/src/index.ts:650`
+来源：`packages/sdk/src/index.ts:664`
 
 ```ts
 export interface EntityInput {
@@ -1292,7 +1318,7 @@ export interface EntityInput {
 
 ## PrefabInput
 
-来源：`packages/sdk/src/index.ts:662`
+来源：`packages/sdk/src/index.ts:676`
 
 ```ts
 export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
@@ -1302,7 +1328,7 @@ export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
 
 ## PrefabDefinition
 
-来源：`packages/sdk/src/index.ts:665`
+来源：`packages/sdk/src/index.ts:679`
 
 ```ts
 export interface PrefabDefinition extends PrefabInput {
@@ -1312,7 +1338,7 @@ export interface PrefabDefinition extends PrefabInput {
 
 ## SceneInput
 
-来源：`packages/sdk/src/index.ts:668`
+来源：`packages/sdk/src/index.ts:682`
 
 ```ts
 export interface SceneInput {
@@ -1344,7 +1370,7 @@ export interface SceneInput {
 
 ## SceneDefinition
 
-来源：`packages/sdk/src/index.ts:693`
+来源：`packages/sdk/src/index.ts:707`
 
 ```ts
 export interface SceneDefinition extends SceneInput {
@@ -1354,7 +1380,7 @@ export interface SceneDefinition extends SceneInput {
 
 ## SystemInput
 
-来源：`packages/sdk/src/index.ts:696`
+来源：`packages/sdk/src/index.ts:710`
 
 ```ts
 export interface SystemInput {
@@ -1371,7 +1397,7 @@ export interface SystemInput {
 
 ## SystemDefinition
 
-来源：`packages/sdk/src/index.ts:706`
+来源：`packages/sdk/src/index.ts:720`
 
 ```ts
 export interface SystemDefinition extends SystemInput {
@@ -1381,7 +1407,7 @@ export interface SystemDefinition extends SystemInput {
 
 ## GameInput
 
-来源：`packages/sdk/src/index.ts:709`
+来源：`packages/sdk/src/index.ts:723`
 
 ```ts
 export interface GameInput {
@@ -1407,7 +1433,7 @@ export interface GameInput {
 
 ## GameDefinition
 
-来源：`packages/sdk/src/index.ts:728`
+来源：`packages/sdk/src/index.ts:742`
 
 ```ts
 export interface GameDefinition extends GameInput {
@@ -1417,7 +1443,7 @@ export interface GameDefinition extends GameInput {
 
 ## GameInstance
 
-来源：`packages/sdk/src/index.ts:731`
+来源：`packages/sdk/src/index.ts:745`
 
 ```ts
 export interface GameInstance {
@@ -1428,7 +1454,7 @@ export interface GameInstance {
 
 ## defineComponent
 
-来源：`packages/sdk/src/index.ts:735`
+来源：`packages/sdk/src/index.ts:749`
 
 ```ts
 export function defineComponent<const S extends ComponentSchema>(input: {
@@ -1439,7 +1465,7 @@ export function defineComponent<const S extends ComponentSchema>(input: {
 
 ## defineMaterial
 
-来源：`packages/sdk/src/index.ts:741`
+来源：`packages/sdk/src/index.ts:755`
 
 ```ts
 export function defineMaterial(input: MaterialInput): MaterialDefinition;
@@ -1447,7 +1473,7 @@ export function defineMaterial(input: MaterialInput): MaterialDefinition;
 
 ## definePostProcess
 
-来源：`packages/sdk/src/index.ts:744`
+来源：`packages/sdk/src/index.ts:758`
 
 ```ts
 export function definePostProcess(input: PostProcessInput): PostProcessDefinition;
@@ -1455,7 +1481,7 @@ export function definePostProcess(input: PostProcessInput): PostProcessDefinitio
 
 ## defineCompute
 
-来源：`packages/sdk/src/index.ts:747`
+来源：`packages/sdk/src/index.ts:761`
 
 ```ts
 export function defineCompute(input: ComputeInput): ComputeDefinition;
@@ -1463,7 +1489,7 @@ export function defineCompute(input: ComputeInput): ComputeDefinition;
 
 ## defineAsset
 
-来源：`packages/sdk/src/index.ts:750`
+来源：`packages/sdk/src/index.ts:764`
 
 ```ts
 export function defineAsset(input: AssetInput): AssetDefinition;
@@ -1471,7 +1497,7 @@ export function defineAsset(input: AssetInput): AssetDefinition;
 
 ## definePrefab
 
-来源：`packages/sdk/src/index.ts:753`
+来源：`packages/sdk/src/index.ts:767`
 
 ```ts
 export function definePrefab(input: PrefabInput): PrefabDefinition;
@@ -1479,7 +1505,7 @@ export function definePrefab(input: PrefabInput): PrefabDefinition;
 
 ## defineScene
 
-来源：`packages/sdk/src/index.ts:756`
+来源：`packages/sdk/src/index.ts:770`
 
 ```ts
 export function defineScene(input: SceneInput): SceneDefinition;
@@ -1487,7 +1513,7 @@ export function defineScene(input: SceneInput): SceneDefinition;
 
 ## defineSystem
 
-来源：`packages/sdk/src/index.ts:759`
+来源：`packages/sdk/src/index.ts:773`
 
 ```ts
 export function defineSystem(input: SystemInput): SystemDefinition;
@@ -1495,7 +1521,7 @@ export function defineSystem(input: SystemInput): SystemDefinition;
 
 ## defineGame
 
-来源：`packages/sdk/src/index.ts:762`
+来源：`packages/sdk/src/index.ts:776`
 
 ```ts
 export function defineGame(input: GameInput): GameDefinition;
@@ -1503,7 +1529,7 @@ export function defineGame(input: GameInput): GameDefinition;
 
 ## instantiateGame
 
-来源：`packages/sdk/src/index.ts:766`
+来源：`packages/sdk/src/index.ts:780`
 
 ```ts
 export function instantiateGame(