pelican-engine 0.3.9 → 0.3.11

package/docs/api/REFERENCE.md

@@ -1,4 +1,4 @@
-# pelican 0.3.9 API 索引
+# pelican 0.3.11 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.9"
+SDK_VERSION = "0.3.11"
 ```
 
 ## Vec2
@@ -254,20 +254,88 @@ export interface SystemContext extends EngineFacade {
   readonly render: RenderService;
   readonly compute: ComputeService;
   readonly navigation: NavigationService;
+  readonly ropes: RopeService;
 }
 ```
 
-## NavigationCell
+## RopeCollider
 
 来源：`packages/sdk/src/index.ts:123`
 
+```ts
+export type RopeCollider =
+  | { kind: "sphere"; id: string; center: Vec3; radius: number }
+  | { kind: "plane"; id: string; normal: Vec3; offset: number };
+```
+
+## RopeDefinition
+
+来源：`packages/sdk/src/index.ts:126`
+
+```ts
+export interface RopeDefinition {
+  id: string;
+  points: readonly Vec3[];
+  /** Kilograms per particle, positive and at most 1e6. */
+  mass: number;
+  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;
+  gravity?: Vec3;
+  anchors?: readonly { index: number; position: Vec3 }[];
+}
+```
+
+## RopeState
+
+来源：`packages/sdk/src/index.ts:142`
+
+```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 }[];
+  maxDistanceError: number;
+  resources: { particles: number; constraints: number; anchors: number; colliders: number };
+}
+```
+
+## RopeService
+
+来源：`packages/sdk/src/index.ts:150`
+
+```ts
+export interface RopeService {
+  create(definition: RopeDefinition): void;
+  /** 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;
+  setAnchor(id: string, index: number, position: Vec3): void;
+  releaseAnchor(id: string, index: number): void;
+  applyForce(id: string, index: number, force: Vec3): void;
+  applyImpulse(id: string, index: number, impulse: Vec3): void;
+  destroy(id: string): void;
+}
+```
+
+## NavigationCell
+
+来源：`packages/sdk/src/index.ts:165`
+
 ```ts
 export interface NavigationCell { readonly x: number; readonly y: number }
 ```
 
 ## NavigationObstacleUpdate
 
-来源：`packages/sdk/src/index.ts:125`
+来源：`packages/sdk/src/index.ts:167`
 
 ```ts
 export interface NavigationObstacleUpdate { readonly cell: NavigationCell; readonly blocked: boolean }
@@ -275,7 +343,7 @@ export interface NavigationObstacleUpdate { readonly cell: NavigationCell; reado
 
 ## NavigationGrid
 
-来源：`packages/sdk/src/index.ts:126`
+来源：`packages/sdk/src/index.ts:168`
 
 ```ts
 export interface NavigationGrid {
@@ -291,7 +359,7 @@ export interface NavigationGrid {
 
 ## NavigationService
 
-来源：`packages/sdk/src/index.ts:135`
+来源：`packages/sdk/src/index.ts:177`
 
 ```ts
 export interface NavigationService {
@@ -310,7 +378,7 @@ export interface NavigationService {
 
 ## RenderMode
 
-来源：`packages/sdk/src/index.ts:147`
+来源：`packages/sdk/src/index.ts:189`
 
 ```ts
 export type RenderMode = "raster" | "hybrid" | "path";
@@ -318,7 +386,7 @@ export type RenderMode = "raster" | "hybrid" | "path";
 
 ## RenderCapabilities
 
-来源：`packages/sdk/src/index.ts:148`
+来源：`packages/sdk/src/index.ts:190`
 
 ```ts
 export interface RenderCapabilities {
@@ -330,7 +398,7 @@ export interface RenderCapabilities {
 
 ## RenderSettings
 
-来源：`packages/sdk/src/index.ts:153`
+来源：`packages/sdk/src/index.ts:195`
 
 ```ts
 export interface RenderSettings {
@@ -348,7 +416,7 @@ export interface RenderSettings {
 
 ## RenderService
 
-来源：`packages/sdk/src/index.ts:164`
+来源：`packages/sdk/src/index.ts:206`
 
 ```ts
 export interface RenderService {
@@ -365,7 +433,7 @@ export interface RenderService {
 
 ## MaterialBufferInput
 
-来源：`packages/sdk/src/index.ts:174`
+来源：`packages/sdk/src/index.ts:216`
 
 ```ts
 export interface MaterialBufferInput {
@@ -381,7 +449,7 @@ export interface MaterialBufferInput {
 
 ## RenderBufferReference
 
-来源：`packages/sdk/src/index.ts:183`
+来源：`packages/sdk/src/index.ts:225`
 
 ```ts
 export interface RenderBufferReference {
@@ -393,7 +461,7 @@ export interface RenderBufferReference {
 
 ## RenderBufferBindings
 
-来源：`packages/sdk/src/index.ts:188`
+来源：`packages/sdk/src/index.ts:230`
 
 ```ts
 export interface RenderBufferBindings {
@@ -405,7 +473,7 @@ export interface RenderBufferBindings {
 
 ## MaterialTextureInput
 
-来源：`packages/sdk/src/index.ts:193`
+来源：`packages/sdk/src/index.ts:235`
 
 ```ts
 export interface MaterialTextureInput extends ComputeTextureBinding {
@@ -418,7 +486,7 @@ export interface MaterialTextureInput extends ComputeTextureBinding {
 
 ## RenderTextureReference
 
-来源：`packages/sdk/src/index.ts:199`
+来源：`packages/sdk/src/index.ts:241`
 
 ```ts
 export interface RenderTextureReference extends ComputeTextureSize {
@@ -429,7 +497,7 @@ export interface RenderTextureReference extends ComputeTextureSize {
 
 ## RenderTextureBindings
 
-来源：`packages/sdk/src/index.ts:203`
+来源：`packages/sdk/src/index.ts:245`
 
 ```ts
 export interface RenderTextureBindings {
@@ -441,7 +509,7 @@ export interface RenderTextureBindings {
 
 ## PostProcessState
 
-来源：`packages/sdk/src/index.ts:208`
+来源：`packages/sdk/src/index.ts:250`
 
 ```ts
 export interface PostProcessState {
@@ -453,7 +521,7 @@ export interface PostProcessState {
 
 ## PostProcessService
 
-来源：`packages/sdk/src/index.ts:213`
+来源：`packages/sdk/src/index.ts:255`
 
 ```ts
 export interface PostProcessService {
@@ -470,7 +538,7 @@ export interface PostProcessService {
 
 ## ComputeBufferHandle
 
-来源：`packages/sdk/src/index.ts:223`
+来源：`packages/sdk/src/index.ts:265`
 
 ```ts
 export interface ComputeBufferHandle {
@@ -482,7 +550,7 @@ export interface ComputeBufferHandle {
 
 ## ComputeTaskHandle
 
-来源：`packages/sdk/src/index.ts:228`
+来源：`packages/sdk/src/index.ts:270`
 
 ```ts
 export interface ComputeTaskHandle {
@@ -493,7 +561,7 @@ export interface ComputeTaskHandle {
 
 ## ComputeBufferInput
 
-来源：`packages/sdk/src/index.ts:232`
+来源：`packages/sdk/src/index.ts:274`
 
 ```ts
 export interface ComputeBufferInput {
@@ -506,7 +574,7 @@ export interface ComputeBufferInput {
 
 ## ComputeTextureHandle
 
-来源：`packages/sdk/src/index.ts:238`
+来源：`packages/sdk/src/index.ts:280`
 
 ```ts
 export interface ComputeTextureHandle {
@@ -519,7 +587,7 @@ export interface ComputeTextureHandle {
 
 ## ComputeTextureSize
 
-来源：`packages/sdk/src/index.ts:244`
+来源：`packages/sdk/src/index.ts:286`
 
 ```ts
 export interface ComputeTextureSize {
@@ -530,7 +598,7 @@ export interface ComputeTextureSize {
 
 ## ComputeTextureDataInput
 
-来源：`packages/sdk/src/index.ts:248`
+来源：`packages/sdk/src/index.ts:290`
 
 ```ts
 export interface ComputeTextureDataInput extends ComputeTextureSize {
@@ -543,7 +611,7 @@ export interface ComputeTextureDataInput extends ComputeTextureSize {
 
 ## ComputeTextureAssetInput
 
-来源：`packages/sdk/src/index.ts:254`
+来源：`packages/sdk/src/index.ts:296`
 
 ```ts
 export interface ComputeTextureAssetInput {
@@ -557,7 +625,7 @@ export interface ComputeTextureAssetInput {
 
 ## ComputeTextureInput
 
-来源：`packages/sdk/src/index.ts:261`
+来源：`packages/sdk/src/index.ts:303`
 
 ```ts
 export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetInput;
@@ -565,7 +633,7 @@ export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetI
 
 ## ComputeTextureBinding
 
-来源：`packages/sdk/src/index.ts:262`
+来源：`packages/sdk/src/index.ts:304`
 
 ```ts
 export interface ComputeTextureBinding {
@@ -578,7 +646,7 @@ export interface ComputeTextureBinding {
 
 ## ComputeDispatchInput
 
-来源：`packages/sdk/src/index.ts:268`
+来源：`packages/sdk/src/index.ts:310`
 
 ```ts
 export interface ComputeDispatchInput {
@@ -597,7 +665,7 @@ export interface ComputeDispatchInput {
 
 ## ComputeTaskState
 
-来源：`packages/sdk/src/index.ts:280`
+来源：`packages/sdk/src/index.ts:322`
 
 ```ts
 export interface ComputeTaskState {
@@ -608,7 +676,7 @@ export interface ComputeTaskState {
 
 ## ComputeService
 
-来源：`packages/sdk/src/index.ts:284`
+来源：`packages/sdk/src/index.ts:326`
 
 ```ts
 export interface ComputeService {
@@ -635,7 +703,7 @@ export interface ComputeService {
 
 ## InputService
 
-来源：`packages/sdk/src/index.ts:304`
+来源：`packages/sdk/src/index.ts:346`
 
 ```ts
 export interface InputService {
@@ -648,7 +716,7 @@ export interface InputService {
 
 ## PhysicsService
 
-来源：`packages/sdk/src/index.ts:310`
+来源：`packages/sdk/src/index.ts:352`
 
 ```ts
 export interface PhysicsService {
@@ -675,7 +743,7 @@ export interface PhysicsService {
 
 ## AnimationService
 
-来源：`packages/sdk/src/index.ts:330`
+来源：`packages/sdk/src/index.ts:372`
 
 ```ts
 export interface AnimationService {
@@ -694,7 +762,7 @@ export interface AnimationService {
 
 ## CameraService
 
-来源：`packages/sdk/src/index.ts:342`
+来源：`packages/sdk/src/index.ts:384`
 
 ```ts
 export interface CameraService {
@@ -714,7 +782,7 @@ export interface CameraService {
 
 ## UIService
 
-来源：`packages/sdk/src/index.ts:355`
+来源：`packages/sdk/src/index.ts:397`
 
 ```ts
 export interface UIService {
@@ -726,7 +794,7 @@ export interface UIService {
 
 ## AudioService
 
-来源：`packages/sdk/src/index.ts:360`
+来源：`packages/sdk/src/index.ts:402`
 
 ```ts
 export interface AudioService {
@@ -748,7 +816,7 @@ export interface AudioService {
 
 ## StorageService
 
-来源：`packages/sdk/src/index.ts:375`
+来源：`packages/sdk/src/index.ts:417`
 
 ```ts
 export interface StorageService {
@@ -764,7 +832,7 @@ export interface StorageService {
 
 ## SceneService
 
-来源：`packages/sdk/src/index.ts:384`
+来源：`packages/sdk/src/index.ts:426`
 
 ```ts
 export interface SceneService {
@@ -775,7 +843,7 @@ export interface SceneService {
 
 ## ModelDefinition
 
-来源：`packages/sdk/src/index.ts:388`
+来源：`packages/sdk/src/index.ts:430`
 
 ```ts
 export interface ModelDefinition {
@@ -795,7 +863,7 @@ export interface ModelDefinition {
 
 ## RigidBodyDefinition
 
-来源：`packages/sdk/src/index.ts:401`
+来源：`packages/sdk/src/index.ts:443`
 
 ```ts
 export interface RigidBodyDefinition {
@@ -816,7 +884,7 @@ export interface RigidBodyDefinition {
 
 ## CharacterDefinition
 
-来源：`packages/sdk/src/index.ts:415`
+来源：`packages/sdk/src/index.ts:457`
 
 ```ts
 export interface CharacterDefinition {
@@ -831,7 +899,7 @@ export interface CharacterDefinition {
 
 ## UIElementDefinition
 
-来源：`packages/sdk/src/index.ts:423`
+来源：`packages/sdk/src/index.ts:465`
 
 ```ts
 export interface UIElementDefinition {
@@ -851,7 +919,7 @@ export interface UIElementDefinition {
 
 ## SoundDefinition
 
-来源：`packages/sdk/src/index.ts:436`
+来源：`packages/sdk/src/index.ts:478`
 
 ```ts
 export interface SoundDefinition {
@@ -865,7 +933,7 @@ export interface SoundDefinition {
 
 ## AudioBusDefinition
 
-来源：`packages/sdk/src/index.ts:443`
+来源：`packages/sdk/src/index.ts:485`
 
 ```ts
 export interface AudioBusDefinition {
@@ -876,7 +944,7 @@ export interface AudioBusDefinition {
 
 ## SYSTEM_PHASES
 
-来源：`packages/sdk/src/index.ts:447`
+来源：`packages/sdk/src/index.ts:489`
 
 ```ts
 SYSTEM_PHASES = [
@@ -891,7 +959,7 @@ SYSTEM_PHASES = [
 
 ## SystemPhase
 
-来源：`packages/sdk/src/index.ts:455`
+来源：`packages/sdk/src/index.ts:497`
 
 ```ts
 export type SystemPhase = (typeof SYSTEM_PHASES)[number];
@@ -899,7 +967,7 @@ export type SystemPhase = (typeof SYSTEM_PHASES)[number];
 
 ## Geometry
 
-来源：`packages/sdk/src/index.ts:456`
+来源：`packages/sdk/src/index.ts:498`
 
 ```ts
 export type Geometry =
@@ -910,7 +978,7 @@ export type Geometry =
 
 ## GRAPH_TYPES
 
-来源：`packages/sdk/src/index.ts:460`
+来源：`packages/sdk/src/index.ts:502`
 
 ```ts
 GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
@@ -918,7 +986,7 @@ GRAPH_TYPES = ["float", "vec2", "vec3", "vec4", "bool"] as const
 
 ## GraphType
 
-来源：`packages/sdk/src/index.ts:461`
+来源：`packages/sdk/src/index.ts:503`
 
 ```ts
 export type GraphType = typeof GRAPH_TYPES[number];
@@ -926,7 +994,7 @@ export type GraphType = typeof GRAPH_TYPES[number];
 
 ## GraphValue
 
-来源：`packages/sdk/src/index.ts:462`
+来源：`packages/sdk/src/index.ts:504`
 
 ```ts
 export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
@@ -934,7 +1002,7 @@ export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;
 
 ## GraphParameter
 
-来源：`packages/sdk/src/index.ts:463`
+来源：`packages/sdk/src/index.ts:505`
 
 ```ts
 export interface GraphParameter {
@@ -946,7 +1014,7 @@ export interface GraphParameter {
 
 ## GRAPH_INPUT_TYPES
 
-来源：`packages/sdk/src/index.ts:468`
+来源：`packages/sdk/src/index.ts:510`
 
 ```ts
 GRAPH_INPUT_TYPES = {
@@ -960,7 +1028,7 @@ GRAPH_INPUT_TYPES = {
 
 ## GraphInputName
 
-来源：`packages/sdk/src/index.ts:475`
+来源：`packages/sdk/src/index.ts:517`
 
 ```ts
 export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
@@ -968,7 +1036,7 @@ export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;
 
 ## GRAPH_OPERATIONS
 
-来源：`packages/sdk/src/index.ts:476`
+来源：`packages/sdk/src/index.ts:518`
 
 ```ts
 GRAPH_OPERATIONS = {
@@ -980,7 +1048,7 @@ GRAPH_OPERATIONS = {
 
 ## GraphNode
 
-来源：`packages/sdk/src/index.ts:481`
+来源：`packages/sdk/src/index.ts:523`
 
 ```ts
 export type GraphNode =
@@ -1007,7 +1075,7 @@ export type GraphNode =
 
 ## Graph
 
-来源：`packages/sdk/src/index.ts:501`
+来源：`packages/sdk/src/index.ts:543`
 
 ```ts
 export interface Graph {
@@ -1019,7 +1087,7 @@ export interface Graph {
 
 ## MaterialGraphs
 
-来源：`packages/sdk/src/index.ts:506`
+来源：`packages/sdk/src/index.ts:548`
 
 ```ts
 export interface MaterialGraphs {
@@ -1035,7 +1103,7 @@ export interface MaterialGraphs {
 
 ## VertexGraphs
 
-来源：`packages/sdk/src/index.ts:515`
+来源：`packages/sdk/src/index.ts:557`
 
 ```ts
 export interface VertexGraphs {
@@ -1048,7 +1116,7 @@ export interface VertexGraphs {
 
 ## MaterialInput
 
-来源：`packages/sdk/src/index.ts:521`
+来源：`packages/sdk/src/index.ts:563`
 
 ```ts
 export interface MaterialInput {
@@ -1082,7 +1150,7 @@ export interface MaterialInput {
 
 ## MaterialDefinition
 
-来源：`packages/sdk/src/index.ts:548`
+来源：`packages/sdk/src/index.ts:590`
 
 ```ts
 export interface MaterialDefinition extends MaterialInput {
@@ -1092,7 +1160,7 @@ export interface MaterialDefinition extends MaterialInput {
 
 ## PostProcessInput
 
-来源：`packages/sdk/src/index.ts:551`
+来源：`packages/sdk/src/index.ts:593`
 
 ```ts
 export interface PostProcessInput {
@@ -1107,7 +1175,7 @@ export interface PostProcessInput {
 
 ## PostProcessDefinition
 
-来源：`packages/sdk/src/index.ts:559`
+来源：`packages/sdk/src/index.ts:601`
 
 ```ts
 export interface PostProcessDefinition extends PostProcessInput {
@@ -1117,7 +1185,7 @@ export interface PostProcessDefinition extends PostProcessInput {
 
 ## ComputeInput
 
-来源：`packages/sdk/src/index.ts:562`
+来源：`packages/sdk/src/index.ts:604`
 
 ```ts
 export interface ComputeInput {
@@ -1133,7 +1201,7 @@ export interface ComputeInput {
 
 ## ComputeDefinition
 
-来源：`packages/sdk/src/index.ts:571`
+来源：`packages/sdk/src/index.ts:613`
 
 ```ts
 export interface ComputeDefinition extends ComputeInput {
@@ -1143,7 +1211,7 @@ export interface ComputeDefinition extends ComputeInput {
 
 ## AssetInput
 
-来源：`packages/sdk/src/index.ts:574`
+来源：`packages/sdk/src/index.ts:616`
 
 ```ts
 export interface AssetInput {
@@ -1160,7 +1228,7 @@ export interface AssetInput {
 
 ## AssetDefinition
 
-来源：`packages/sdk/src/index.ts:584`
+来源：`packages/sdk/src/index.ts:626`
 
 ```ts
 export interface AssetDefinition extends AssetInput {
@@ -1170,7 +1238,7 @@ export interface AssetDefinition extends AssetInput {
 
 ## MeshDefinition
 
-来源：`packages/sdk/src/index.ts:587`
+来源：`packages/sdk/src/index.ts:629`
 
 ```ts
 export interface MeshDefinition {
@@ -1183,7 +1251,7 @@ export interface MeshDefinition {
 
 ## LightDefinition
 
-来源：`packages/sdk/src/index.ts:593`
+来源：`packages/sdk/src/index.ts:635`
 
 ```ts
 export interface LightDefinition {
@@ -1205,7 +1273,7 @@ export interface LightDefinition {
 
 ## EntityInput
 
-来源：`packages/sdk/src/index.ts:608`
+来源：`packages/sdk/src/index.ts:650`
 
 ```ts
 export interface EntityInput {
@@ -1224,7 +1292,7 @@ export interface EntityInput {
 
 ## PrefabInput
 
-来源：`packages/sdk/src/index.ts:620`
+来源：`packages/sdk/src/index.ts:662`
 
 ```ts
 export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
@@ -1234,7 +1302,7 @@ export interface PrefabInput extends Omit<EntityInput, "prefab" | "parent"> {
 
 ## PrefabDefinition
 
-来源：`packages/sdk/src/index.ts:623`
+来源：`packages/sdk/src/index.ts:665`
 
 ```ts
 export interface PrefabDefinition extends PrefabInput {
@@ -1244,7 +1312,7 @@ export interface PrefabDefinition extends PrefabInput {
 
 ## SceneInput
 
-来源：`packages/sdk/src/index.ts:626`
+来源：`packages/sdk/src/index.ts:668`
 
 ```ts
 export interface SceneInput {
@@ -1276,7 +1344,7 @@ export interface SceneInput {
 
 ## SceneDefinition
 
-来源：`packages/sdk/src/index.ts:651`
+来源：`packages/sdk/src/index.ts:693`
 
 ```ts
 export interface SceneDefinition extends SceneInput {
@@ -1286,7 +1354,7 @@ export interface SceneDefinition extends SceneInput {
 
 ## SystemInput
 
-来源：`packages/sdk/src/index.ts:654`
+来源：`packages/sdk/src/index.ts:696`
 
 ```ts
 export interface SystemInput {
@@ -1303,7 +1371,7 @@ export interface SystemInput {
 
 ## SystemDefinition
 
-来源：`packages/sdk/src/index.ts:664`
+来源：`packages/sdk/src/index.ts:706`
 
 ```ts
 export interface SystemDefinition extends SystemInput {
@@ -1313,7 +1381,7 @@ export interface SystemDefinition extends SystemInput {
 
 ## GameInput
 
-来源：`packages/sdk/src/index.ts:667`
+来源：`packages/sdk/src/index.ts:709`
 
 ```ts
 export interface GameInput {
@@ -1339,7 +1407,7 @@ export interface GameInput {
 
 ## GameDefinition
 
-来源：`packages/sdk/src/index.ts:686`
+来源：`packages/sdk/src/index.ts:728`
 
 ```ts
 export interface GameDefinition extends GameInput {
@@ -1349,7 +1417,7 @@ export interface GameDefinition extends GameInput {
 
 ## GameInstance
 
-来源：`packages/sdk/src/index.ts:689`
+来源：`packages/sdk/src/index.ts:731`
 
 ```ts
 export interface GameInstance {
@@ -1360,7 +1428,7 @@ export interface GameInstance {
 
 ## defineComponent
 
-来源：`packages/sdk/src/index.ts:693`
+来源：`packages/sdk/src/index.ts:735`
 
 ```ts
 export function defineComponent<const S extends ComponentSchema>(input: {
@@ -1371,7 +1439,7 @@ export function defineComponent<const S extends ComponentSchema>(input: {
 
 ## defineMaterial
 
-来源：`packages/sdk/src/index.ts:699`
+来源：`packages/sdk/src/index.ts:741`
 
 ```ts
 export function defineMaterial(input: MaterialInput): MaterialDefinition;
@@ -1379,7 +1447,7 @@ export function defineMaterial(input: MaterialInput): MaterialDefinition;
 
 ## definePostProcess
 
-来源：`packages/sdk/src/index.ts:702`
+来源：`packages/sdk/src/index.ts:744`
 
 ```ts
 export function definePostProcess(input: PostProcessInput): PostProcessDefinition;
@@ -1387,7 +1455,7 @@ export function definePostProcess(input: PostProcessInput): PostProcessDefinitio
 
 ## defineCompute
 
-来源：`packages/sdk/src/index.ts:705`
+来源：`packages/sdk/src/index.ts:747`
 
 ```ts
 export function defineCompute(input: ComputeInput): ComputeDefinition;
@@ -1395,7 +1463,7 @@ export function defineCompute(input: ComputeInput): ComputeDefinition;
 
 ## defineAsset
 
-来源：`packages/sdk/src/index.ts:708`
+来源：`packages/sdk/src/index.ts:750`
 
 ```ts
 export function defineAsset(input: AssetInput): AssetDefinition;
@@ -1403,7 +1471,7 @@ export function defineAsset(input: AssetInput): AssetDefinition;
 
 ## definePrefab
 
-来源：`packages/sdk/src/index.ts:711`
+来源：`packages/sdk/src/index.ts:753`
 
 ```ts
 export function definePrefab(input: PrefabInput): PrefabDefinition;
@@ -1411,7 +1479,7 @@ export function definePrefab(input: PrefabInput): PrefabDefinition;
 
 ## defineScene
 
-来源：`packages/sdk/src/index.ts:714`
+来源：`packages/sdk/src/index.ts:756`
 
 ```ts
 export function defineScene(input: SceneInput): SceneDefinition;
@@ -1419,7 +1487,7 @@ export function defineScene(input: SceneInput): SceneDefinition;
 
 ## defineSystem
 
-来源：`packages/sdk/src/index.ts:717`
+来源：`packages/sdk/src/index.ts:759`
 
 ```ts
 export function defineSystem(input: SystemInput): SystemDefinition;
@@ -1427,7 +1495,7 @@ export function defineSystem(input: SystemInput): SystemDefinition;
 
 ## defineGame
 
-来源：`packages/sdk/src/index.ts:720`
+来源：`packages/sdk/src/index.ts:762`
 
 ```ts
 export function defineGame(input: GameInput): GameDefinition;
@@ -1435,7 +1503,7 @@ export function defineGame(input: GameInput): GameDefinition;
 
 ## instantiateGame
 
-来源：`packages/sdk/src/index.ts:724`
+来源：`packages/sdk/src/index.ts:766`
 
 ```ts
 export function instantiateGame(