pelican-engine 0.3.15 → 0.3.17

package/docs/api/REFERENCE.md

@@ -1,4 +1,4 @@
-# pelican 0.3.15 API 索引
+# pelican 0.3.17 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.15"
+SDK_VERSION = "0.3.17"
 ```
 
 ## Vec2
@@ -323,6 +323,10 @@ export interface RopeDefinition {
   autoStep?: boolean;
   /** Automatically sample and react to existing dynamic, non-trigger sphere bodies. Requires autoStep. */
   bodyColliders?: readonly RopeBodyCollider[];
+  /** Resolve sphere contacts on segment interiors; defaults to true for new ropes. */
+  segmentCollisions?: boolean;
+  /** Resolve discrete non-adjacent segment self contacts; defaults to true for new ropes. */
+  selfCollisions?: boolean;
   /** Optional segmented presentation using an already-declared material id. */
   visual?: RopeVisualOptions;
   substeps?: number;
@@ -335,7 +339,7 @@ export interface RopeDefinition {
 
 ## RopeContact
 
-来源：`packages/sdk/src/index.ts:167`
+来源：`packages/sdk/src/index.ts:171`
 
 ```ts
 export interface RopeContact {
@@ -347,16 +351,54 @@ export interface RopeContact {
 }
 ```
 
+## RopeSegmentContact
+
+来源：`packages/sdk/src/index.ts:179`
+
+```ts
+export interface RopeSegmentContact {
+  tick: number;
+  /** Zero-based index of the first endpoint; the second is segment + 1. */
+  segment: number;
+  colliderId: string;
+  /** Last closest-point fraction from the first endpoint toward the second. */
+  fraction: number;
+  penetration: number;
+  reactionImpulse?: Vec3;
+  reactionAngularImpulse?: Vec3;
+}
+```
+
+## RopeSelfContact
+
+来源：`packages/sdk/src/index.ts:191`
+
+```ts
+export interface RopeSelfContact {
+  tick: number;
+  /** Zero-based first endpoint of each non-adjacent segment, ordered ascending. */
+  firstSegment: number; secondSegment: number;
+  /** Last closest-point fractions along the respective segments. */
+  firstFraction: number; secondFraction: number;
+  /** Maximum observed overlap in metres during this tick. */
+  penetration: number;
+}
+```
+
 ## RopeState
 
-来源：`packages/sdk/src/index.ts:174`
+来源：`packages/sdk/src/index.ts:200`
 
 ```ts
 export interface RopeState {
   tick: number; simulatedSeconds: number; disposed: boolean;
+  segmentCollisions: boolean;
+  selfCollisions: boolean;
   positions: Vec3[]; velocities: Vec3[];
   anchors: { index: number; position: Vec3 }[];
   contacts: RopeContact[];
+  segmentContacts: RopeSegmentContact[];
+  selfContacts: RopeSelfContact[];
   maxDistanceError: number;
   resources: { particles: number; constraints: number; anchors: number; colliders: number };
 }
@@ -364,7 +406,7 @@ export interface RopeState {
 
 ## RopeService
 
-来源：`packages/sdk/src/index.ts:182`
+来源：`packages/sdk/src/index.ts:212`
 
 ```ts
 export interface RopeService {
@@ -385,7 +427,7 @@ export interface RopeService {
 
 ## NavigationCell
 
-来源：`packages/sdk/src/index.ts:199`
+来源：`packages/sdk/src/index.ts:229`
 
 ```ts
 export interface NavigationCell { readonly x: number; readonly y: number }
@@ -393,7 +435,7 @@ export interface NavigationCell { readonly x: number; readonly y: number }
 
 ## NavigationObstacleUpdate
 
-来源：`packages/sdk/src/index.ts:201`
+来源：`packages/sdk/src/index.ts:231`
 
 ```ts
 export interface NavigationObstacleUpdate { readonly cell: NavigationCell; readonly blocked: boolean }
@@ -401,7 +443,7 @@ export interface NavigationObstacleUpdate { readonly cell: NavigationCell; reado
 
 ## NavigationGrid
 
-来源：`packages/sdk/src/index.ts:202`
+来源：`packages/sdk/src/index.ts:232`
 
 ```ts
 export interface NavigationGrid {
@@ -417,7 +459,7 @@ export interface NavigationGrid {
 
 ## NavigationService
 
-来源：`packages/sdk/src/index.ts:211`
+来源：`packages/sdk/src/index.ts:241`
 
 ```ts
 export interface NavigationService {
@@ -436,7 +478,7 @@ export interface NavigationService {
 
 ## RenderMode
 
-来源：`packages/sdk/src/index.ts:223`
+来源：`packages/sdk/src/index.ts:253`
 
 ```ts
 export type RenderMode = "raster" | "hybrid" | "path";
@@ -444,7 +486,7 @@ export type RenderMode = "raster" | "hybrid" | "path";
 
 ## RenderCapabilities
 
-来源：`packages/sdk/src/index.ts:224`
+来源：`packages/sdk/src/index.ts:254`
 
 ```ts
 export interface RenderCapabilities {
@@ -456,7 +498,7 @@ export interface RenderCapabilities {
 
 ## RenderSettings
 
-来源：`packages/sdk/src/index.ts:229`
+来源：`packages/sdk/src/index.ts:259`
 
 ```ts
 export interface RenderSettings {
@@ -474,7 +516,7 @@ export interface RenderSettings {
 
 ## RenderService
 
-来源：`packages/sdk/src/index.ts:240`
+来源：`packages/sdk/src/index.ts:270`
 
 ```ts
 export interface RenderService {
@@ -491,7 +533,7 @@ export interface RenderService {
 
 ## MaterialBufferInput
 
-来源：`packages/sdk/src/index.ts:250`
+来源：`packages/sdk/src/index.ts:280`
 
 ```ts
 export interface MaterialBufferInput {
@@ -507,7 +549,7 @@ export interface MaterialBufferInput {
 
 ## RenderBufferReference
 
-来源：`packages/sdk/src/index.ts:259`
+来源：`packages/sdk/src/index.ts:289`
 
 ```ts
 export interface RenderBufferReference {
@@ -519,7 +561,7 @@ export interface RenderBufferReference {
 
 ## RenderBufferBindings
 
-来源：`packages/sdk/src/index.ts:264`
+来源：`packages/sdk/src/index.ts:294`
 
 ```ts
 export interface RenderBufferBindings {
@@ -531,7 +573,7 @@ export interface RenderBufferBindings {
 
 ## MaterialTextureInput
 
-来源：`packages/sdk/src/index.ts:269`
+来源：`packages/sdk/src/index.ts:299`
 
 ```ts
 export interface MaterialTextureInput extends ComputeTextureBinding {
@@ -544,7 +586,7 @@ export interface MaterialTextureInput extends ComputeTextureBinding {
 
 ## RenderTextureReference
 
-来源：`packages/sdk/src/index.ts:275`
+来源：`packages/sdk/src/index.ts:305`
 
 ```ts
 export interface RenderTextureReference extends ComputeTextureSize {
@@ -555,7 +597,7 @@ export interface RenderTextureReference extends ComputeTextureSize {
 
 ## RenderTextureBindings
 
-来源：`packages/sdk/src/index.ts:279`
+来源：`packages/sdk/src/index.ts:309`
 
 ```ts
 export interface RenderTextureBindings {
@@ -567,7 +609,7 @@ export interface RenderTextureBindings {
 
 ## PostProcessState
 
-来源：`packages/sdk/src/index.ts:284`
+来源：`packages/sdk/src/index.ts:314`
 
 ```ts
 export interface PostProcessState {
@@ -579,7 +621,7 @@ export interface PostProcessState {
 
 ## PostProcessService
 
-来源：`packages/sdk/src/index.ts:289`
+来源：`packages/sdk/src/index.ts:319`
 
 ```ts
 export interface PostProcessService {
@@ -596,7 +638,7 @@ export interface PostProcessService {
 
 ## ComputeBufferHandle
 
-来源：`packages/sdk/src/index.ts:299`
+来源：`packages/sdk/src/index.ts:329`
 
 ```ts
 export interface ComputeBufferHandle {
@@ -608,7 +650,7 @@ export interface ComputeBufferHandle {
 
 ## ComputeTaskHandle
 
-来源：`packages/sdk/src/index.ts:304`
+来源：`packages/sdk/src/index.ts:334`
 
 ```ts
 export interface ComputeTaskHandle {
@@ -619,7 +661,7 @@ export interface ComputeTaskHandle {
 
 ## ComputeBufferInput
 
-来源：`packages/sdk/src/index.ts:308`
+来源：`packages/sdk/src/index.ts:338`
 
 ```ts
 export interface ComputeBufferInput {
@@ -632,7 +674,7 @@ export interface ComputeBufferInput {
 
 ## ComputeTextureHandle
 
-来源：`packages/sdk/src/index.ts:314`
+来源：`packages/sdk/src/index.ts:344`
 
 ```ts
 export interface ComputeTextureHandle {
@@ -645,7 +687,7 @@ export interface ComputeTextureHandle {
 
 ## ComputeTextureSize
 
-来源：`packages/sdk/src/index.ts:320`
+来源：`packages/sdk/src/index.ts:350`
 
 ```ts
 export interface ComputeTextureSize {
@@ -656,7 +698,7 @@ export interface ComputeTextureSize {
 
 ## ComputeTextureDataInput
 
-来源：`packages/sdk/src/index.ts:324`
+来源：`packages/sdk/src/index.ts:354`
 
 ```ts
 export interface ComputeTextureDataInput extends ComputeTextureSize {
@@ -669,7 +711,7 @@ export interface ComputeTextureDataInput extends ComputeTextureSize {
 
 ## ComputeTextureAssetInput
 
-来源：`packages/sdk/src/index.ts:330`
+来源：`packages/sdk/src/index.ts:360`
 
 ```ts
 export interface ComputeTextureAssetInput {
@@ -683,7 +725,7 @@ export interface ComputeTextureAssetInput {
 
 ## ComputeTextureInput
 
-来源：`packages/sdk/src/index.ts:337`
+来源：`packages/sdk/src/index.ts:367`
 
 ```ts
 export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetInput;
@@ -691,7 +733,7 @@ export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetI
 
 ## ComputeTextureBinding
 
-来源：`packages/sdk/src/index.ts:338`
+来源：`packages/sdk/src/index.ts:368`
 
 ```ts
 export interface ComputeTextureBinding {
@@ -704,7 +746,7 @@ export interface ComputeTextureBinding {
 
 ## ComputeDispatchInput
 
-来源：`packages/sdk/src/index.ts:344`
+来源：`packages/sdk/src/index.ts:374`
 
 ```ts
 export interface ComputeDispatchInput {
@@ -723,7 +765,7 @@ export interface ComputeDispatchInput {
 
 ## ComputeTaskState
 
-来源：`packages/sdk/src/index.ts:356`
+来源：`packages/sdk/src/index.ts:386`
 
 ```ts
 export interface ComputeTaskState {
@@ -734,7 +776,7 @@ export interface ComputeTaskState {
 
 ## ComputeService
 
-来源：`packages/sdk/src/index.ts:360`
+来源：`packages/sdk/src/index.ts:390`
 
 ```ts
 export interface ComputeService {
@@ -761,7 +803,7 @@ export interface ComputeService {
 
 ## InputService
 
-来源：`packages/sdk/src/index.ts:380`
+来源：`packages/sdk/src/index.ts:410`
 
 ```ts
 export interface InputService {
@@ -774,7 +816,7 @@ export interface InputService {
 
 ## PhysicsService
 
-来源：`packages/sdk/src/index.ts:386`
+来源：`packages/sdk/src/index.ts:416`
 
 ```ts
 export interface PhysicsService {
@@ -803,7 +845,7 @@ export interface PhysicsService {
 
 ## AnimationService
 
-来源：`packages/sdk/src/index.ts:408`
+来源：`packages/sdk/src/index.ts:438`
 
 ```ts
 export interface AnimationService {
@@ -822,7 +864,7 @@ export interface AnimationService {
 
 ## CameraService
 
-来源：`packages/sdk/src/index.ts:420`
+来源：`packages/sdk/src/index.ts:450`
 
 ```ts
 export interface CameraService {
@@ -842,7 +884,7 @@ export interface CameraService {
 
 ## UIService
 
-来源：`packages/sdk/src/index.ts:433`
+来源：`packages/sdk/src/index.ts:463`
 
 ```ts
 export interface UIService {
@@ -854,7 +896,7 @@ export interface UIService {
 
 ## AudioService
 
-来源：`packages/sdk/src/index.ts:438`
+来源：`packages/sdk/src/index.ts:468`
 
 ```ts
 export interface AudioService {
@@ -876,7 +918,7 @@ export interface AudioService {
 
 ## StorageService
 
-来源：`packages/sdk/src/index.ts:453`
+来源：`packages/sdk/src/index.ts:483`
 
 ```ts
 export interface StorageService {
@@ -892,7 +934,7 @@ export interface StorageService {
 
 ## SceneService
 
-来源：`packages/sdk/src/index.ts:462`
+来源：`packages/sdk/src/index.ts:492`
 
 ```ts
 export interface SceneService {
@@ -903,7 +945,7 @@ export interface SceneService {
 
 ## ModelDefinition
 
-来源：`packages/sdk/src/index.ts:466`
+来源：`packages/sdk/src/index.ts:496`
 
 ```ts
 export interface ModelDefinition {
@@ -923,7 +965,7 @@ export interface ModelDefinition {
 
 ## RigidBodyDefinition
 
-来源：`packages/sdk/src/index.ts:479`
+来源：`packages/sdk/src/index.ts:509`
 
 ```ts
 export interface RigidBodyDefinition {
@@ -944,7 +986,7 @@ export interface RigidBodyDefinition {
 
 ## CharacterDefinition
 
-来源：`packages/sdk/src/index.ts:493`
+来源：`packages/sdk/src/index.ts:523`
 
 ```ts
 export interface CharacterDefinition {
@@ -959,7 +1001,7 @@ export interface CharacterDefinition {
 
 ## UIElementDefinition
 
-来源：`packages/sdk/src/index.ts:501`
+来源：`packages/sdk/src/index.ts:531`
 
 ```ts
 export interface UIElementDefinition {
@@ -979,7 +1021,7 @@ export interface UIElementDefinition {
 
 ## SoundDefinition
 
-来源：`packages/sdk/src/index.ts:514`
+来源：`packages/sdk/src/index.ts:544`
 
 ```ts
 export interface SoundDefinition {
@@ -993,7 +1035,7 @@ export interface SoundDefinition {
 
 ## AudioBusDefinition
 
-来源：`packages/sdk/src/index.ts:521`
+来源：`packages/sdk/src/index.ts:551`
 
 ```ts
 export interface AudioBusDefinition {
@@ -1004,7 +1046,7 @@ export interface AudioBusDefinition {
 
 ## SYSTEM_PHASES
 
-来源：`packages/sdk/src/index.ts:525`
+来源：`packages/sdk/src/index.ts:555`
 
 ```ts
 SYSTEM_PHASES = [
@@ -1019,7 +1061,7 @@ SYSTEM_PHASES = [
 
 ## SystemPhase
 
-来源：`packages/sdk/src/index.ts:533`
+来源：`packages/sdk/src/index.ts:563`
 
 ```ts
 export type SystemPhase = (typeof SYSTEM_PHASES)[number];
@@ -1027,7 +1069,7 @@ export type SystemPhase = (typeof SYSTEM_PHASES)[number];
 
 ## Geometry
 
-来源：`packages/sdk/src/index.ts:534`
+来源：`packages/sdk/src/index.ts:564`
 
 ```ts
 export type Geometry =
@@ -1038,7 +1080,7 @@ export type Geometry =
 
 ## GRAPH_TYPES
 
-来源：`packages/sdk/src/index.ts:538`
+来源：`packages/sdk/src/index.ts:568`
 
 ```ts
 GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
@@ -1046,7 +1088,7 @@ GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
 
 ## GraphType
 
-来源：`packages/sdk/src/index.ts:539`
+来源：`packages/sdk/src/index.ts:569`
 
 ```ts
 export type GraphType = typeof GRAPH_TYPES[number];
@@ -1054,7 +1096,7 @@ export type GraphType = typeof GRAPH_TYPES[number];
 
 ## GraphValue
 
-来源：`packages/sdk/src/index.ts:540`
+来源：`packages/sdk/src/index.ts:570`
 
 ```ts
 export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
@@ -1062,7 +1104,7 @@ export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
 
 ## GraphParameter
 
-来源：`packages/sdk/src/index.ts:541`
+来源：`packages/sdk/src/index.ts:571`
 
 ```ts
 export interface GraphParameter {
@@ -1074,7 +1116,7 @@ export interface GraphParameter {
 
 ## GRAPH_INPUT_TYPES
 
-来源：`packages/sdk/src/index.ts:546`
+来源：`packages/sdk/src/index.ts:576`
 
 ```ts
 GRAPH_INPUT_TYPES = {
@@ -1088,7 +1130,7 @@ GRAPH_INPUT_TYPES = {
 
 ## GraphInputName
 
-来源：`packages/sdk/src/index.ts:553`
+来源：`packages/sdk/src/index.ts:583`
 
 ```ts
 export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
@@ -1096,7 +1138,7 @@ export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
 
 ## GRAPH_OPERATIONS
 
-来源：`packages/sdk/src/index.ts:554`
+来源：`packages/sdk/src/index.ts:584`
 
 ```ts
 GRAPH_OPERATIONS = {
@@ -1108,7 +1150,7 @@ GRAPH_OPERATIONS = {
 
 ## GraphNode
 
-来源：`packages/sdk/src/index.ts:559`
+来源：`packages/sdk/src/index.ts:589`
 
 ```ts
 export type GraphNode =
@@ -1135,7 +1177,7 @@ export type GraphNode =
 
 ## Graph
 
-来源：`packages/sdk/src/index.ts:579`
+来源：`packages/sdk/src/index.ts:609`
 
 ```ts
 export interface Graph {
@@ -1147,7 +1189,7 @@ export interface Graph {
 
 ## MaterialGraphs
 
-来源：`packages/sdk/src/index.ts:584`
+来源：`packages/sdk/src/index.ts:614`
 
 ```ts
 export interface MaterialGraphs {
@@ -1163,7 +1205,7 @@ export interface MaterialGraphs {
 
 ## VertexGraphs
 
-来源：`packages/sdk/src/index.ts:593`
+来源：`packages/sdk/src/index.ts:623`
 
 ```ts
 export interface VertexGraphs {
@@ -1176,7 +1218,7 @@ export interface VertexGraphs {
 
 ## MaterialInput
 
-来源：`packages/sdk/src/index.ts:599`
+来源：`packages/sdk/src/index.ts:629`
 
 ```ts
 export interface MaterialInput {
@@ -1210,7 +1252,7 @@ export interface MaterialInput {
 
 ## MaterialDefinition
 
-来源：`packages/sdk/src/index.ts:626`
+来源：`packages/sdk/src/index.ts:656`
 
 ```ts
 export interface MaterialDefinition extends MaterialInput {
@@ -1220,7 +1262,7 @@ export interface MaterialDefinition extends MaterialInput {
 
 ## PostProcessInput
 
-来源：`packages/sdk/src/index.ts:629`
+来源：`packages/sdk/src/index.ts:659`
 
 ```ts
 export interface PostProcessInput {
@@ -1235,7 +1277,7 @@ export interface PostProcessInput {
 
 ## PostProcessDefinition
 
-来源：`packages/sdk/src/index.ts:637`
+来源：`packages/sdk/src/index.ts:667`
 
 ```ts
 export interface PostProcessDefinition extends PostProcessInput {
@@ -1245,7 +1287,7 @@ export interface PostProcessDefinition extends PostProcessInput {
 
 ## ComputeInput
 
-来源：`packages/sdk/src/index.ts:640`
+来源：`packages/sdk/src/index.ts:670`
 
 ```ts
 export interface ComputeInput {
@@ -1261,7 +1303,7 @@ export interface ComputeInput {
 
 ## ComputeDefinition
 
-来源：`packages/sdk/src/index.ts:649`
+来源：`packages/sdk/src/index.ts:679`
 
 ```ts
 export interface ComputeDefinition extends ComputeInput {
@@ -1271,7 +1313,7 @@ export interface ComputeDefinition extends ComputeInput {
 
 ## AssetInput
 
-来源：`packages/sdk/src/index.ts:652`
+来源：`packages/sdk/src/index.ts:682`
 
 ```ts
 export interface AssetInput {
@@ -1288,7 +1330,7 @@ export interface AssetInput {
 
 ## AssetDefinition
 
-来源：`packages/sdk/src/index.ts:662`
+来源：`packages/sdk/src/index.ts:692`
 
 ```ts
 export interface AssetDefinition extends AssetInput {
@@ -1298,7 +1340,7 @@ export interface AssetDefinition extends AssetInput {
 
 ## MeshDefinition
 
-来源：`packages/sdk/src/index.ts:665`
+来源：`packages/sdk/src/index.ts:695`
 
 ```ts
 export interface MeshDefinition {
@@ -1311,7 +1353,7 @@ export interface MeshDefinition {
 
 ## LightDefinition
 
-来源：`packages/sdk/src/index.ts:671`
+来源：`packages/sdk/src/index.ts:701`
 
 ```ts
 export interface LightDefinition {
@@ -1333,7 +1375,7 @@ export interface LightDefinition {
 
 ## EntityInput
 
-来源：`packages/sdk/src/index.ts:686`
+来源：`packages/sdk/src/index.ts:716`
 
 ```ts
 export interface EntityInput {
@@ -1352,7 +1394,7 @@ export interface EntityInput {
 
 ## PrefabInput
 
-来源：`packages/sdk/src/index.ts:698`
+来源：`packages/sdk/src/index.ts:728`
 
 ```ts
 export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
@@ -1362,7 +1404,7 @@ export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
 
 ## PrefabDefinition
 
-来源：`packages/sdk/src/index.ts:701`
+来源：`packages/sdk/src/index.ts:731`
 
 ```ts
 export interface PrefabDefinition extends PrefabInput {
@@ -1372,7 +1414,7 @@ export interface PrefabDefinition extends PrefabInput {
 
 ## SceneInput
 
-来源：`packages/sdk/src/index.ts:704`
+来源：`packages/sdk/src/index.ts:734`
 
 ```ts
 export interface SceneInput {
@@ -1404,7 +1446,7 @@ export interface SceneInput {
 
 ## SceneDefinition
 
-来源：`packages/sdk/src/index.ts:729`
+来源：`packages/sdk/src/index.ts:759`
 
 ```ts
 export interface SceneDefinition extends SceneInput {
@@ -1414,7 +1456,7 @@ export interface SceneDefinition extends SceneInput {
 
 ## SystemInput
 
-来源：`packages/sdk/src/index.ts:732`
+来源：`packages/sdk/src/index.ts:762`
 
 ```ts
 export interface SystemInput {
@@ -1431,7 +1473,7 @@ export interface SystemInput {
 
 ## SystemDefinition
 
-来源：`packages/sdk/src/index.ts:742`
+来源：`packages/sdk/src/index.ts:772`
 
 ```ts
 export interface SystemDefinition extends SystemInput {
@@ -1441,7 +1483,7 @@ export interface SystemDefinition extends SystemInput {
 
 ## GameInput
 
-来源：`packages/sdk/src/index.ts:745`
+来源：`packages/sdk/src/index.ts:775`
 
 ```ts
 export interface GameInput {
@@ -1467,7 +1509,7 @@ export interface GameInput {
 
 ## GameDefinition
 
-来源：`packages/sdk/src/index.ts:764`
+来源：`packages/sdk/src/index.ts:794`
 
 ```ts
 export interface GameDefinition extends GameInput {
@@ -1477,7 +1519,7 @@ export interface GameDefinition extends GameInput {
 
 ## GameInstance
 
-来源：`packages/sdk/src/index.ts:767`
+来源：`packages/sdk/src/index.ts:797`
 
 ```ts
 export interface GameInstance {
@@ -1488,7 +1530,7 @@ export interface GameInstance {
 
 ## defineComponent
 
-来源：`packages/sdk/src/index.ts:771`
+来源：`packages/sdk/src/index.ts:801`
 
 ```ts
 export function defineComponent<const S extends ComponentSchema>(input: {
@@ -1499,7 +1541,7 @@ export function defineComponent<const S extends ComponentSchema>(input: {
 
 ## defineMaterial
 
-来源：`packages/sdk/src/index.ts:777`
+来源：`packages/sdk/src/index.ts:807`
 
 ```ts
 export function defineMaterial(input: MaterialInput): MaterialDefinition;
@@ -1507,7 +1549,7 @@ export function defineMaterial(input: MaterialInput): MaterialDefinition;
 
 ## definePostProcess
 
-来源：`packages/sdk/src/index.ts:780`
+来源：`packages/sdk/src/index.ts:810`
 
 ```ts
 export function definePostProcess(input: PostProcessInput): PostProcessDefinition;
@@ -1515,7 +1557,7 @@ export function definePostProcess(input: PostProcessInput): PostProcessDefinitio
 
 ## defineCompute
 
-来源：`packages/sdk/src/index.ts:783`
+来源：`packages/sdk/src/index.ts:813`
 
 ```ts
 export function defineCompute(input: ComputeInput): ComputeDefinition;
@@ -1523,7 +1565,7 @@ export function defineCompute(input: ComputeInput): ComputeDefinition;
 
 ## defineAsset
 
-来源：`packages/sdk/src/index.ts:786`
+来源：`packages/sdk/src/index.ts:816`
 
 ```ts
 export function defineAsset(input: AssetInput): AssetDefinition;
@@ -1531,7 +1573,7 @@ export function defineAsset(input: AssetInput): AssetDefinition;
 
 ## definePrefab
 
-来源：`packages/sdk/src/index.ts:789`
+来源：`packages/sdk/src/index.ts:819`
 
 ```ts
 export function definePrefab(input: PrefabInput): PrefabDefinition;
@@ -1539,7 +1581,7 @@ export function definePrefab(input: PrefabInput): PrefabDefinition;
 
 ## defineScene
 
-来源：`packages/sdk/src/index.ts:792`
+来源：`packages/sdk/src/index.ts:822`
 
 ```ts
 export function defineScene(input: SceneInput): SceneDefinition;
@@ -1547,7 +1589,7 @@ export function defineScene(input: SceneInput): SceneDefinition;
 
 ## defineSystem
 
-来源：`packages/sdk/src/index.ts:795`
+来源：`packages/sdk/src/index.ts:825`
 
 ```ts
 export function defineSystem(input: SystemInput): SystemDefinition;
@@ -1555,7 +1597,7 @@ export function defineSystem(input: SystemInput): SystemDefinition;
 
 ## defineGame
 
-来源：`packages/sdk/src/index.ts:798`
+来源：`packages/sdk/src/index.ts:828`
 
 ```ts
 export function defineGame(input: GameInput): GameDefinition;
@@ -1563,7 +1605,7 @@ export function defineGame(input: GameInput): GameDefinition;
 
 ## instantiateGame
 
-来源：`packages/sdk/src/index.ts:802`
+来源：`packages/sdk/src/index.ts:832`
 
 ```ts
 export function instantiateGame(