pelican-engine 0.3.10 → 0.3.12

package/docs/api/REFERENCE.md

@@ -1,4 +1,4 @@
-# pelican 0.3.10 API 索引
+# pelican 0.3.12 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.10"
+SDK_VERSION = "0.3.12"
 ```
 
 ## Vec2
@@ -281,6 +281,8 @@ export interface RopeDefinition {
   radius?: number;
   /** Defaults to the host interval; an explicit value must exactly match it. */
   fixedDt?: number;
+  /** When true, step once after each physics phase; defaults to false (manual stepping). */
+  autoStep?: boolean;
   substeps?: number;
   iterations?: number;
   damping?: number;
@@ -289,16 +291,30 @@ export interface RopeDefinition {
 }
 ```
 
+## RopeContact
+
+来源：`packages/sdk/src/index.ts:143`
+
+```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:140`
+来源：`packages/sdk/src/index.ts:150`
 
 ```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 };
 }
@@ -306,12 +322,12 @@ export interface RopeState {
 
 ## RopeService
 
-来源：`packages/sdk/src/index.ts:148`
+来源：`packages/sdk/src/index.ts:158`
 
 ```ts
 export interface RopeService {
   create(definition: RopeDefinition): void;
-  /** Explicit fixed solver ticks; not automatically advanced with the host. A failed batch leaves the rope unchanged. */
+  /** Explicit ticks for manual ropes only. Auto-stepped ropes reject this call. A failed batch leaves the rope unchanged. */
   step(id: string, ticks?: number): RopeState;
   inspect(id: string): RopeState;
   setColliders(id: string, colliders: readonly RopeCollider[]): void;
@@ -325,7 +341,7 @@ export interface RopeService {
 
 ## NavigationCell
 
-来源：`packages/sdk/src/index.ts:163`
+来源：`packages/sdk/src/index.ts:173`
 
 ```ts
 export interface NavigationCell { readonly x: number; readonly y: number }
@@ -333,7 +349,7 @@ export interface NavigationCell { readonly x: number; readonly y: number }
 
 ## NavigationObstacleUpdate
 
-来源：`packages/sdk/src/index.ts:165`
+来源：`packages/sdk/src/index.ts:175`
 
 ```ts
 export interface NavigationObstacleUpdate { readonly cell: NavigationCell; readonly blocked: boolean }
@@ -341,7 +357,7 @@ export interface NavigationObstacleUpdate { readonly cell: NavigationCell; reado
 
 ## NavigationGrid
 
-来源：`packages/sdk/src/index.ts:166`
+来源：`packages/sdk/src/index.ts:176`
 
 ```ts
 export interface NavigationGrid {
@@ -357,7 +373,7 @@ export interface NavigationGrid {
 
 ## NavigationService
 
-来源：`packages/sdk/src/index.ts:175`
+来源：`packages/sdk/src/index.ts:185`
 
 ```ts
 export interface NavigationService {
@@ -376,7 +392,7 @@ export interface NavigationService {
 
 ## RenderMode
 
-来源：`packages/sdk/src/index.ts:187`
+来源：`packages/sdk/src/index.ts:197`
 
 ```ts
 export type RenderMode = "raster" | "hybrid" | "path";
@@ -384,7 +400,7 @@ export type RenderMode = "raster" | "hybrid" | "path";
 
 ## RenderCapabilities
 
-来源：`packages/sdk/src/index.ts:188`
+来源：`packages/sdk/src/index.ts:198`
 
 ```ts
 export interface RenderCapabilities {
@@ -396,7 +412,7 @@ export interface RenderCapabilities {
 
 ## RenderSettings
 
-来源：`packages/sdk/src/index.ts:193`
+来源：`packages/sdk/src/index.ts:203`
 
 ```ts
 export interface RenderSettings {
@@ -414,7 +430,7 @@ export interface RenderSettings {
 
 ## RenderService
 
-来源：`packages/sdk/src/index.ts:204`
+来源：`packages/sdk/src/index.ts:214`
 
 ```ts
 export interface RenderService {
@@ -431,7 +447,7 @@ export interface RenderService {
 
 ## MaterialBufferInput
 
-来源：`packages/sdk/src/index.ts:214`
+来源：`packages/sdk/src/index.ts:224`
 
 ```ts
 export interface MaterialBufferInput {
@@ -447,7 +463,7 @@ export interface MaterialBufferInput {
 
 ## RenderBufferReference
 
-来源：`packages/sdk/src/index.ts:223`
+来源：`packages/sdk/src/index.ts:233`
 
 ```ts
 export interface RenderBufferReference {
@@ -459,7 +475,7 @@ export interface RenderBufferReference {
 
 ## RenderBufferBindings
 
-来源：`packages/sdk/src/index.ts:228`
+来源：`packages/sdk/src/index.ts:238`
 
 ```ts
 export interface RenderBufferBindings {
@@ -471,7 +487,7 @@ export interface RenderBufferBindings {
 
 ## MaterialTextureInput
 
-来源：`packages/sdk/src/index.ts:233`
+来源：`packages/sdk/src/index.ts:243`
 
 ```ts
 export interface MaterialTextureInput extends ComputeTextureBinding {
@@ -484,7 +500,7 @@ export interface MaterialTextureInput extends ComputeTextureBinding {
 
 ## RenderTextureReference
 
-来源：`packages/sdk/src/index.ts:239`
+来源：`packages/sdk/src/index.ts:249`
 
 ```ts
 export interface RenderTextureReference extends ComputeTextureSize {
@@ -495,7 +511,7 @@ export interface RenderTextureReference extends ComputeTextureSize {
 
 ## RenderTextureBindings
 
-来源：`packages/sdk/src/index.ts:243`
+来源：`packages/sdk/src/index.ts:253`
 
 ```ts
 export interface RenderTextureBindings {
@@ -507,7 +523,7 @@ export interface RenderTextureBindings {
 
 ## PostProcessState
 
-来源：`packages/sdk/src/index.ts:248`
+来源：`packages/sdk/src/index.ts:258`
 
 ```ts
 export interface PostProcessState {
@@ -519,7 +535,7 @@ export interface PostProcessState {
 
 ## PostProcessService
 
-来源：`packages/sdk/src/index.ts:253`
+来源：`packages/sdk/src/index.ts:263`
 
 ```ts
 export interface PostProcessService {
@@ -536,7 +552,7 @@ export interface PostProcessService {
 
 ## ComputeBufferHandle
 
-来源：`packages/sdk/src/index.ts:263`
+来源：`packages/sdk/src/index.ts:273`
 
 ```ts
 export interface ComputeBufferHandle {
@@ -548,7 +564,7 @@ export interface ComputeBufferHandle {
 
 ## ComputeTaskHandle
 
-来源：`packages/sdk/src/index.ts:268`
+来源：`packages/sdk/src/index.ts:278`
 
 ```ts
 export interface ComputeTaskHandle {
@@ -559,7 +575,7 @@ export interface ComputeTaskHandle {
 
 ## ComputeBufferInput
 
-来源：`packages/sdk/src/index.ts:272`
+来源：`packages/sdk/src/index.ts:282`
 
 ```ts
 export interface ComputeBufferInput {
@@ -572,7 +588,7 @@ export interface ComputeBufferInput {
 
 ## ComputeTextureHandle
 
-来源：`packages/sdk/src/index.ts:278`
+来源：`packages/sdk/src/index.ts:288`
 
 ```ts
 export interface ComputeTextureHandle {
@@ -585,7 +601,7 @@ export interface ComputeTextureHandle {
 
 ## ComputeTextureSize
 
-来源：`packages/sdk/src/index.ts:284`
+来源：`packages/sdk/src/index.ts:294`
 
 ```ts
 export interface ComputeTextureSize {
@@ -596,7 +612,7 @@ export interface ComputeTextureSize {
 
 ## ComputeTextureDataInput
 
-来源：`packages/sdk/src/index.ts:288`
+来源：`packages/sdk/src/index.ts:298`
 
 ```ts
 export interface ComputeTextureDataInput extends ComputeTextureSize {
@@ -609,7 +625,7 @@ export interface ComputeTextureDataInput extends ComputeTextureSize {
 
 ## ComputeTextureAssetInput
 
-来源：`packages/sdk/src/index.ts:294`
+来源：`packages/sdk/src/index.ts:304`
 
 ```ts
 export interface ComputeTextureAssetInput {
@@ -623,7 +639,7 @@ export interface ComputeTextureAssetInput {
 
 ## ComputeTextureInput
 
-来源：`packages/sdk/src/index.ts:301`
+来源：`packages/sdk/src/index.ts:311`
 
 ```ts
 export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetInput;
@@ -631,7 +647,7 @@ export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetI
 
 ## ComputeTextureBinding
 
-来源：`packages/sdk/src/index.ts:302`
+来源：`packages/sdk/src/index.ts:312`
 
 ```ts
 export interface ComputeTextureBinding {
@@ -644,7 +660,7 @@ export interface ComputeTextureBinding {
 
 ## ComputeDispatchInput
 
-来源：`packages/sdk/src/index.ts:308`
+来源：`packages/sdk/src/index.ts:318`
 
 ```ts
 export interface ComputeDispatchInput {
@@ -663,7 +679,7 @@ export interface ComputeDispatchInput {
 
 ## ComputeTaskState
 
-来源：`packages/sdk/src/index.ts:320`
+来源：`packages/sdk/src/index.ts:330`
 
 ```ts
 export interface ComputeTaskState {
@@ -674,7 +690,7 @@ export interface ComputeTaskState {
 
 ## ComputeService
 
-来源：`packages/sdk/src/index.ts:324`
+来源：`packages/sdk/src/index.ts:334`
 
 ```ts
 export interface ComputeService {
@@ -701,7 +717,7 @@ export interface ComputeService {
 
 ## InputService
 
-来源：`packages/sdk/src/index.ts:344`
+来源：`packages/sdk/src/index.ts:354`
 
 ```ts
 export interface InputService {
@@ -714,13 +730,15 @@ export interface InputService {
 
 ## PhysicsService
 
-来源：`packages/sdk/src/index.ts:350`
+来源：`packages/sdk/src/index.ts:360`
 
 ```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. */
@@ -741,7 +759,7 @@ export interface PhysicsService {
 
 ## AnimationService
 
-来源：`packages/sdk/src/index.ts:370`
+来源：`packages/sdk/src/index.ts:382`
 
 ```ts
 export interface AnimationService {
@@ -760,7 +778,7 @@ export interface AnimationService {
 
 ## CameraService
 
-来源：`packages/sdk/src/index.ts:382`
+来源：`packages/sdk/src/index.ts:394`
 
 ```ts
 export interface CameraService {
@@ -780,7 +798,7 @@ export interface CameraService {
 
 ## UIService
 
-来源：`packages/sdk/src/index.ts:395`
+来源：`packages/sdk/src/index.ts:407`
 
 ```ts
 export interface UIService {
@@ -792,7 +810,7 @@ export interface UIService {
 
 ## AudioService
 
-来源：`packages/sdk/src/index.ts:400`
+来源：`packages/sdk/src/index.ts:412`
 
 ```ts
 export interface AudioService {
@@ -814,7 +832,7 @@ export interface AudioService {
 
 ## StorageService
 
-来源：`packages/sdk/src/index.ts:415`
+来源：`packages/sdk/src/index.ts:427`
 
 ```ts
 export interface StorageService {
@@ -830,7 +848,7 @@ export interface StorageService {
 
 ## SceneService
 
-来源：`packages/sdk/src/index.ts:424`
+来源：`packages/sdk/src/index.ts:436`
 
 ```ts
 export interface SceneService {
@@ -841,7 +859,7 @@ export interface SceneService {
 
 ## ModelDefinition
 
-来源：`packages/sdk/src/index.ts:428`
+来源：`packages/sdk/src/index.ts:440`
 
 ```ts
 export interface ModelDefinition {
@@ -861,7 +879,7 @@ export interface ModelDefinition {
 
 ## RigidBodyDefinition
 
-来源：`packages/sdk/src/index.ts:441`
+来源：`packages/sdk/src/index.ts:453`
 
 ```ts
 export interface RigidBodyDefinition {
@@ -882,7 +900,7 @@ export interface RigidBodyDefinition {
 
 ## CharacterDefinition
 
-来源：`packages/sdk/src/index.ts:455`
+来源：`packages/sdk/src/index.ts:467`
 
 ```ts
 export interface CharacterDefinition {
@@ -897,7 +915,7 @@ export interface CharacterDefinition {
 
 ## UIElementDefinition
 
-来源：`packages/sdk/src/index.ts:463`
+来源：`packages/sdk/src/index.ts:475`
 
 ```ts
 export interface UIElementDefinition {
@@ -917,7 +935,7 @@ export interface UIElementDefinition {
 
 ## SoundDefinition
 
-来源：`packages/sdk/src/index.ts:476`
+来源：`packages/sdk/src/index.ts:488`
 
 ```ts
 export interface SoundDefinition {
@@ -931,7 +949,7 @@ export interface SoundDefinition {
 
 ## AudioBusDefinition
 
-来源：`packages/sdk/src/index.ts:483`
+来源：`packages/sdk/src/index.ts:495`
 
 ```ts
 export interface AudioBusDefinition {
@@ -942,7 +960,7 @@ export interface AudioBusDefinition {
 
 ## SYSTEM_PHASES
 
-来源：`packages/sdk/src/index.ts:487`
+来源：`packages/sdk/src/index.ts:499`
 
 ```ts
 SYSTEM_PHASES = [
@@ -957,7 +975,7 @@ SYSTEM_PHASES = [
 
 ## SystemPhase
 
-来源：`packages/sdk/src/index.ts:495`
+来源：`packages/sdk/src/index.ts:507`
 
 ```ts
 export type SystemPhase = (typeof SYSTEM_PHASES)[number];
@@ -965,7 +983,7 @@ export type SystemPhase = (typeof SYSTEM_PHASES)[number];
 
 ## Geometry
 
-来源：`packages/sdk/src/index.ts:496`
+来源：`packages/sdk/src/index.ts:508`
 
 ```ts
 export type Geometry =
@@ -976,7 +994,7 @@ export type Geometry =
 
 ## GRAPH_TYPES
 
-来源：`packages/sdk/src/index.ts:500`
+来源：`packages/sdk/src/index.ts:512`
 
 ```ts
 GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
@@ -984,7 +1002,7 @@ GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
 
 ## GraphType
 
-来源：`packages/sdk/src/index.ts:501`
+来源：`packages/sdk/src/index.ts:513`
 
 ```ts
 export type GraphType = typeof GRAPH_TYPES[number];
@@ -992,7 +1010,7 @@ export type GraphType = typeof GRAPH_TYPES[number];
 
 ## GraphValue
 
-来源：`packages/sdk/src/index.ts:502`
+来源：`packages/sdk/src/index.ts:514`
 
 ```ts
 export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
@@ -1000,7 +1018,7 @@ export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
 
 ## GraphParameter
 
-来源：`packages/sdk/src/index.ts:503`
+来源：`packages/sdk/src/index.ts:515`
 
 ```ts
 export interface GraphParameter {
@@ -1012,7 +1030,7 @@ export interface GraphParameter {
 
 ## GRAPH_INPUT_TYPES
 
-来源：`packages/sdk/src/index.ts:508`
+来源：`packages/sdk/src/index.ts:520`
 
 ```ts
 GRAPH_INPUT_TYPES = {
@@ -1026,7 +1044,7 @@ GRAPH_INPUT_TYPES = {
 
 ## GraphInputName
 
-来源：`packages/sdk/src/index.ts:515`
+来源：`packages/sdk/src/index.ts:527`
 
 ```ts
 export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
@@ -1034,7 +1052,7 @@ export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
 
 ## GRAPH_OPERATIONS
 
-来源：`packages/sdk/src/index.ts:516`
+来源：`packages/sdk/src/index.ts:528`
 
 ```ts
 GRAPH_OPERATIONS = {
@@ -1046,7 +1064,7 @@ GRAPH_OPERATIONS = {
 
 ## GraphNode
 
-来源：`packages/sdk/src/index.ts:521`
+来源：`packages/sdk/src/index.ts:533`
 
 ```ts
 export type GraphNode =
@@ -1073,7 +1091,7 @@ export type GraphNode =
 
 ## Graph
 
-来源：`packages/sdk/src/index.ts:541`
+来源：`packages/sdk/src/index.ts:553`
 
 ```ts
 export interface Graph {
@@ -1085,7 +1103,7 @@ export interface Graph {
 
 ## MaterialGraphs
 
-来源：`packages/sdk/src/index.ts:546`
+来源：`packages/sdk/src/index.ts:558`
 
 ```ts
 export interface MaterialGraphs {
@@ -1101,7 +1119,7 @@ export interface MaterialGraphs {
 
 ## VertexGraphs
 
-来源：`packages/sdk/src/index.ts:555`
+来源：`packages/sdk/src/index.ts:567`
 
 ```ts
 export interface VertexGraphs {
@@ -1114,7 +1132,7 @@ export interface VertexGraphs {
 
 ## MaterialInput
 
-来源：`packages/sdk/src/index.ts:561`
+来源：`packages/sdk/src/index.ts:573`
 
 ```ts
 export interface MaterialInput {
@@ -1148,7 +1166,7 @@ export interface MaterialInput {
 
 ## MaterialDefinition
 
-来源：`packages/sdk/src/index.ts:588`
+来源：`packages/sdk/src/index.ts:600`
 
 ```ts
 export interface MaterialDefinition extends MaterialInput {
@@ -1158,7 +1176,7 @@ export interface MaterialDefinition extends MaterialInput {
 
 ## PostProcessInput
 
-来源：`packages/sdk/src/index.ts:591`
+来源：`packages/sdk/src/index.ts:603`
 
 ```ts
 export interface PostProcessInput {
@@ -1173,7 +1191,7 @@ export interface PostProcessInput {
 
 ## PostProcessDefinition
 
-来源：`packages/sdk/src/index.ts:599`
+来源：`packages/sdk/src/index.ts:611`
 
 ```ts
 export interface PostProcessDefinition extends PostProcessInput {
@@ -1183,7 +1201,7 @@ export interface PostProcessDefinition extends PostProcessInput {
 
 ## ComputeInput
 
-来源：`packages/sdk/src/index.ts:602`
+来源：`packages/sdk/src/index.ts:614`
 
 ```ts
 export interface ComputeInput {
@@ -1199,7 +1217,7 @@ export interface ComputeInput {
 
 ## ComputeDefinition
 
-来源：`packages/sdk/src/index.ts:611`
+来源：`packages/sdk/src/index.ts:623`
 
 ```ts
 export interface ComputeDefinition extends ComputeInput {
@@ -1209,7 +1227,7 @@ export interface ComputeDefinition extends ComputeInput {
 
 ## AssetInput
 
-来源：`packages/sdk/src/index.ts:614`
+来源：`packages/sdk/src/index.ts:626`
 
 ```ts
 export interface AssetInput {
@@ -1226,7 +1244,7 @@ export interface AssetInput {
 
 ## AssetDefinition
 
-来源：`packages/sdk/src/index.ts:624`
+来源：`packages/sdk/src/index.ts:636`
 
 ```ts
 export interface AssetDefinition extends AssetInput {
@@ -1236,7 +1254,7 @@ export interface AssetDefinition extends AssetInput {
 
 ## MeshDefinition
 
-来源：`packages/sdk/src/index.ts:627`
+来源：`packages/sdk/src/index.ts:639`
 
 ```ts
 export interface MeshDefinition {
@@ -1249,7 +1267,7 @@ export interface MeshDefinition {
 
 ## LightDefinition
 
-来源：`packages/sdk/src/index.ts:633`
+来源：`packages/sdk/src/index.ts:645`
 
 ```ts
 export interface LightDefinition {
@@ -1271,7 +1289,7 @@ export interface LightDefinition {
 
 ## EntityInput
 
-来源：`packages/sdk/src/index.ts:648`
+来源：`packages/sdk/src/index.ts:660`
 
 ```ts
 export interface EntityInput {
@@ -1290,7 +1308,7 @@ export interface EntityInput {
 
 ## PrefabInput
 
-来源：`packages/sdk/src/index.ts:660`
+来源：`packages/sdk/src/index.ts:672`
 
 ```ts
 export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
@@ -1300,7 +1318,7 @@ export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
 
 ## PrefabDefinition
 
-来源：`packages/sdk/src/index.ts:663`
+来源：`packages/sdk/src/index.ts:675`
 
 ```ts
 export interface PrefabDefinition extends PrefabInput {
@@ -1310,7 +1328,7 @@ export interface PrefabDefinition extends PrefabInput {
 
 ## SceneInput
 
-来源：`packages/sdk/src/index.ts:666`
+来源：`packages/sdk/src/index.ts:678`
 
 ```ts
 export interface SceneInput {
@@ -1342,7 +1360,7 @@ export interface SceneInput {
 
 ## SceneDefinition
 
-来源：`packages/sdk/src/index.ts:691`
+来源：`packages/sdk/src/index.ts:703`
 
 ```ts
 export interface SceneDefinition extends SceneInput {
@@ -1352,7 +1370,7 @@ export interface SceneDefinition extends SceneInput {
 
 ## SystemInput
 
-来源：`packages/sdk/src/index.ts:694`
+来源：`packages/sdk/src/index.ts:706`
 
 ```ts
 export interface SystemInput {
@@ -1369,7 +1387,7 @@ export interface SystemInput {
 
 ## SystemDefinition
 
-来源：`packages/sdk/src/index.ts:704`
+来源：`packages/sdk/src/index.ts:716`
 
 ```ts
 export interface SystemDefinition extends SystemInput {
@@ -1379,7 +1397,7 @@ export interface SystemDefinition extends SystemInput {
 
 ## GameInput
 
-来源：`packages/sdk/src/index.ts:707`
+来源：`packages/sdk/src/index.ts:719`
 
 ```ts
 export interface GameInput {
@@ -1405,7 +1423,7 @@ export interface GameInput {
 
 ## GameDefinition
 
-来源：`packages/sdk/src/index.ts:726`
+来源：`packages/sdk/src/index.ts:738`
 
 ```ts
 export interface GameDefinition extends GameInput {
@@ -1415,7 +1433,7 @@ export interface GameDefinition extends GameInput {
 
 ## GameInstance
 
-来源：`packages/sdk/src/index.ts:729`
+来源：`packages/sdk/src/index.ts:741`
 
 ```ts
 export interface GameInstance {
@@ -1426,7 +1444,7 @@ export interface GameInstance {
 
 ## defineComponent
 
-来源：`packages/sdk/src/index.ts:733`
+来源：`packages/sdk/src/index.ts:745`
 
 ```ts
 export function defineComponent<const S extends ComponentSchema>(input: {
@@ -1437,7 +1455,7 @@ export function defineComponent<const S extends ComponentSchema>(input: {
 
 ## defineMaterial
 
-来源：`packages/sdk/src/index.ts:739`
+来源：`packages/sdk/src/index.ts:751`
 
 ```ts
 export function defineMaterial(input: MaterialInput): MaterialDefinition;
@@ -1445,7 +1463,7 @@ export function defineMaterial(input: MaterialInput): MaterialDefinition;
 
 ## definePostProcess
 
-来源：`packages/sdk/src/index.ts:742`
+来源：`packages/sdk/src/index.ts:754`
 
 ```ts
 export function definePostProcess(input: PostProcessInput): PostProcessDefinition;
@@ -1453,7 +1471,7 @@ export function definePostProcess(input: PostProcessInput): PostProcessDefinitio
 
 ## defineCompute
 
-来源：`packages/sdk/src/index.ts:745`
+来源：`packages/sdk/src/index.ts:757`
 
 ```ts
 export function defineCompute(input: ComputeInput): ComputeDefinition;
@@ -1461,7 +1479,7 @@ export function defineCompute(input: ComputeInput): ComputeDefinition;
 
 ## defineAsset
 
-来源：`packages/sdk/src/index.ts:748`
+来源：`packages/sdk/src/index.ts:760`
 
 ```ts
 export function defineAsset(input: AssetInput): AssetDefinition;
@@ -1469,7 +1487,7 @@ export function defineAsset(input: AssetInput): AssetDefinition;
 
 ## definePrefab
 
-来源：`packages/sdk/src/index.ts:751`
+来源：`packages/sdk/src/index.ts:763`
 
 ```ts
 export function definePrefab(input: PrefabInput): PrefabDefinition;
@@ -1477,7 +1495,7 @@ export function definePrefab(input: PrefabInput): PrefabDefinition;
 
 ## defineScene
 
-来源：`packages/sdk/src/index.ts:754`
+来源：`packages/sdk/src/index.ts:766`
 
 ```ts
 export function defineScene(input: SceneInput): SceneDefinition;
@@ -1485,7 +1503,7 @@ export function defineScene(input: SceneInput): SceneDefinition;
 
 ## defineSystem
 
-来源：`packages/sdk/src/index.ts:757`
+来源：`packages/sdk/src/index.ts:769`
 
 ```ts
 export function defineSystem(input: SystemInput): SystemDefinition;
@@ -1493,7 +1511,7 @@ export function defineSystem(input: SystemInput): SystemDefinition;
 
 ## defineGame
 
-来源：`packages/sdk/src/index.ts:760`
+来源：`packages/sdk/src/index.ts:772`
 
 ```ts
 export function defineGame(input: GameInput): GameDefinition;
@@ -1501,7 +1519,7 @@ export function defineGame(input: GameInput): GameDefinition;
 
 ## instantiateGame
 
-来源：`packages/sdk/src/index.ts:764`
+来源：`packages/sdk/src/index.ts:776`
 
 ```ts
 export function instantiateGame(