Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

fix(gates): an API snapshot lists a union of string literals in one order - the checker prints them in the order it first met them, so a snapshot drifted with no change to the source

yhh41850ab2e503
diff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.json
index b285ae784..87b820484 100644
--- a/docs/astro/src/data/apiStability.generated.json
+++ b/docs/astro/src/data/apiStability.generated.json
@@ -3,10 +3,10 @@
"counts": {
"public": 115,
"beta": 178,
- "experimental": 3105,
+ "experimental": 3169,
"deprecated": 3
},
- "total": 3398,
+ "total": 3462,
"subsystems": [
{
"id": "mobile-controls",
@@ -417,6 +417,18 @@
"validateImageSource"
]
},
+ {
+ "id": "sound",
+ "title": "Audio recipes",
+ "titleZh": "音频配方",
+ "tier": "experimental",
+ "why": "a clip named by its source is made on the device by the code the editor bakes it with, on a worker, and read from the content cache after; checked in a headless game for a sound and a piece of music, and heard by nobody yet on a phone or in a mini-game",
+ "whyZh": "以源文件命名的音频片段在设备上用编辑器烘焙时的同一份代码生成,在工作线程上完成,之后从内容缓存读取;已在无头游戏里对一个音效和一段音乐做过检查,还没有人在手机或小游戏里听过",
+ "entry": [
+ "renderSound",
+ "renderMusic"
+ ]
+ },
{
"id": "rig2d",
"title": "2D rigs",
diff --git a/sdk/etc/ai.api.md b/sdk/etc/ai.api.md
index e10a15f8f..31d5fc2ca 100644
--- a/sdk/etc/ai.api.md
+++ b/sdk/etc/ai.api.md
@@ -63,7 +63,7 @@ ResourceDef<StateMachines>
label: string | undefined
name: string
tooltip: string | undefined
-type: "string" | "number" | "bool" | "entity"
+type: "bool" | "entity" | "number" | "string"
```
## AiOutputs — type @experimental
@@ -81,7 +81,7 @@ options: readonly { label: string; value: string; }[] | undefined
optionsSource: string | undefined
step: number | undefined
tooltip: string | undefined
-type: "string" | "number" | "bool" | "enum"
+type: "bool" | "enum" | "number" | "string"
```
## AiParamValue — type @experimental
@@ -544,8 +544,8 @@ halfExtents: Vec3
## NavPathResult — interface @experimental
```
path: Vec3[] | null
-reason: "none" | "no-surface" | "building" | "start-unavailable" | "target-unavailable" | "disconnected" | "insufficient-clearance" | "radius-mismatch" | "diagnostics-unavailable"
-status: "unknown" | "unavailable" | "complete" | "partial"
+reason: "building" | "diagnostics-unavailable" | "disconnected" | "insufficient-clearance" | "no-surface" | "none" | "radius-mismatch" | "start-unavailable" | "target-unavailable"
+status: "complete" | "partial" | "unavailable" | "unknown"
```
## NavPlugin — class @experimental
@@ -1086,7 +1086,7 @@ PerceptionPlugin
## setStateHook — function @experimental
```
-(def: FsmDefinition, name: string, hook: "onEnter" | "onUpdate" | "onExit", action: string, arg?: string, params?: Record<string, AiParamValue>): FsmDefinition
+(def: FsmDefinition, name: string, hook: "onEnter" | "onExit" | "onUpdate", action: string, arg?: string, params?: Record<string, AiParamValue>): FsmDefinition
```
## stepBehaviorTrees — function @experimental
diff --git a/sdk/etc/dragonbones.api.md b/sdk/etc/dragonbones.api.md
index c348ec42e..804eb8a55 100644
--- a/sdk/etc/dragonbones.api.md
+++ b/sdk/etc/dragonbones.api.md
@@ -52,7 +52,7 @@ removeEntity: (entity: Entity) => void
setAtlasTexture: (skeletonHandle: number, textureId: number) => void
setColor: (entity: Entity, r: number, g: number, b: number, a: number) => void
setEnabled: (entity: Entity, enabled: boolean) => void
-setEntityProps: (entity: Entity, props: Partial<Pick<EntityInfo, "skeletonScale" | "flipX" | "flipY" | "layer" | "playing">> & { timeScale?: number; color?: { r: number; g: number; b: number; a: number; }; }) => void
+setEntityProps: (entity: Entity, props: Partial<Pick<EntityInfo, "flipX" | "flipY" | "layer" | "playing" | "skeletonScale">> & { timeScale?: number; color?: { r: number; g: number; b: number; a: number; }; }) => void
setTimeScale: (entity: Entity, scale: number) => void
stop: (entity: Entity, animation?: string) => void
submitMeshes: (core: SkeletalSubmitCore, registry: unknown, materialOf?: SkeletalMaterialOf, isActive?: (entity: Entity) => boolean) => void
diff --git a/sdk/etc/foliage.api.md b/sdk/etc/foliage.api.md
index bfaafc771..4cd7d2e17 100644
--- a/sdk/etc/foliage.api.md
+++ b/sdk/etc/foliage.api.md
@@ -207,7 +207,7 @@ z: number
## PlantEvent — interface @experimental
```
plant: PlantRef
-type: "removed" | "activated" | "deactivated" | "damaged" | "felled" | "landed" | "harvested" | "regrown"
+type: "activated" | "damaged" | "deactivated" | "felled" | "harvested" | "landed" | "regrown" | "removed"
```
## PlantGrowth — class @experimental
diff --git a/sdk/etc/gameplay.api.md b/sdk/etc/gameplay.api.md
index 933a1561a..3ea02cb7e 100644
--- a/sdk/etc/gameplay.api.md
+++ b/sdk/etc/gameplay.api.md
@@ -203,7 +203,7 @@ y: number
```
filter: ((entity: Entity, data: D) => boolean) | undefined
limit: number | undefined
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
radius: number | undefined
```
diff --git a/sdk/etc/image.api.md b/sdk/etc/image.api.md
index e8431ed7e..aeb8ede89 100644
--- a/sdk/etc/image.api.md
+++ b/sdk/etc/image.api.md
@@ -32,9 +32,9 @@ parts: Record<string, Float32Array<ArrayBufferLike>>
## ImageLayer — interface @experimental
```
adjust: ImageAdjust | undefined
-align: "right" | "left" | "center" | undefined
+align: "center" | "left" | "right" | undefined
at: readonly [number, number] | undefined
-blend: "color" | "normal" | "multiply" | "add" | "hue" | "subtract" | "screen" | "overlay" | "softLight" | "hardLight" | "vividLight" | "linearLight" | "pinLight" | "colorDodge" | "colorBurn" | "linearBurn" | "darken" | "lighten" | "difference" | "exclusion" | "divide" | "saturation" | "luminosity" | undefined
+blend: "add" | "color" | "colorBurn" | "colorDodge" | "darken" | "difference" | "divide" | "exclusion" | "hardLight" | "hue" | "lighten" | "linearBurn" | "linearLight" | "luminosity" | "multiply" | "normal" | "overlay" | "pinLight" | "saturation" | "screen" | "softLight" | "subtract" | "vividLight" | undefined
blendIf: readonly number[] | undefined
blur: number | undefined
build: { head?: number; shoulders?: number; chest?: number; waist?: number; hips?: number; limbs?: number; } | undefined
@@ -54,7 +54,7 @@ face: string | undefined
faces: readonly ImageFill[] | undefined
feather: number | undefined
fill: ImageFill | undefined
-filter: "texture" | "motion" | "lens" | "rays" | "noise" | "gaussian" | "spin" | "zoom" | "sharpen" | "highPass" | "median" | "emboss" | "ripple" | "displace" | "twirl" | "pixelate" | "chromatic" | "vignette" | "fog" | "flare" | undefined
+filter: "chromatic" | "displace" | "emboss" | "flare" | "fog" | "gaussian" | "highPass" | "lens" | "median" | "motion" | "noise" | "pixelate" | "rays" | "ripple" | "sharpen" | "spin" | "texture" | "twirl" | "vignette" | "zoom" | undefined
font: string | undefined
fontSize: number | undefined
from: "below" | undefined
@@ -86,7 +86,7 @@ size: readonly [number, number] | undefined
smear: number | undefined
src: string | undefined
strength: number | undefined
-stroke: { color: ImageFill; width: number; align?: "center" | "inside" | "outside"; join?: "round" | "miter" | "bevel"; cap?: "round" | "butt" | "square"; } | undefined
+stroke: { color: ImageFill; width: number; align?: "center" | "inside" | "outside"; join?: "bevel" | "miter" | "round"; cap?: "butt" | "round" | "square"; } | undefined
strokes: readonly ImageMark[] | undefined
text: string | undefined
thin: number | undefined
diff --git a/sdk/etc/index.api.md b/sdk/etc/index.api.md
index db3339302..3e72e20ee 100644
--- a/sdk/etc/index.api.md
+++ b/sdk/etc/index.api.md
@@ -225,7 +225,7 @@ world: World
label: string | undefined
name: string
tooltip: string | undefined
-type: "string" | "number" | "bool" | "entity"
+type: "bool" | "entity" | "number" | "string"
```
## AiOutputs — type @experimental
@@ -243,7 +243,7 @@ options: readonly { label: string; value: string; }[] | undefined
optionsSource: string | undefined
step: number | undefined
tooltip: string | undefined
-type: "string" | "number" | "bool" | "enum"
+type: "bool" | "enum" | "number" | "string"
```
## AiParamValue — type @experimental
@@ -901,7 +901,7 @@ type: AssetFieldType
```
alwaysInclude: boolean | undefined
folder: string
-mode: "local" | "subpackage" | "remote"
+mode: "local" | "remote" | "subpackage"
```
## AssetGroupMode — type @experimental
@@ -1159,7 +1159,7 @@ ResourceDef<AudioAPI>
## AudioAPI — class @experimental
```
-@internal getVoiceState: (handle: AudioHandle) => "playing" | "paused" | "ended" | "stopped" | "untracked"
+@internal getVoiceState: (handle: AudioHandle) => "ended" | "paused" | "playing" | "stopped" | "untracked"
@internal onPlaybackStop: (callback: (generation: number) => void) => () => void
@internal playbackGeneration: number
baseUrl: string
@@ -2677,7 +2677,7 @@ loadRadius: number
make: (cx: number, cz: number, signal: AbortSignal) => T | null | Promise<T | null>
originX: number
originZ: number
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
publish: (cx: number, cz: number, value: T) => void
release: (cx: number, cz: number, value: T) => void
sizeX: number
@@ -3162,7 +3162,7 @@ ComponentDef<{}>
background: UIVisualInit | undefined
data: DataSource<T> | readonly T[]
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
item: ListItemTemplate<T> | Record<string, ListItemTemplate<T>>
@@ -4471,7 +4471,7 @@ paint: (x: number, z: number, h: number, ny: number) => LayerWeights
splats: () => { a: Splat | null; b: Splat | null; }
toData: () => FieldSourceData
static fromData: (d: FieldSourceData) => FieldSource
-static new (field: Heightfield, data: Pick<TerrainData, "sizeX" | "sizeZ" | "height" | "rockSlope" | "dirtHeight" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
+static new (field: Heightfield, data: Pick<TerrainData, "dirtHeight" | "height" | "rockSlope" | "sizeX" | "sizeZ" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
static prototype: FieldSource
```
@@ -4494,7 +4494,7 @@ Top = 3
## FilterEffectDef — interface @experimental
```
-filter: "lowpass" | "highpass" | "bandpass" | "lowshelf" | "highshelf" | "peaking" | "notch"
+filter: "bandpass" | "highpass" | "highshelf" | "lowpass" | "lowshelf" | "notch" | "peaking"
frequency: number
gainDb: number | undefined
q: number | undefined
@@ -5961,7 +5961,7 @@ spacing: number
accepted: boolean
environmentSunAim: [number, number, number] | null
limit: number
-refusal: "none" | "capacity" | "no-environment-sun"
+refusal: "capacity" | "no-environment-sun" | "none"
refusedCount: number
requested: number
```
@@ -6095,7 +6095,7 @@ sceneName: string | undefined
source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
@@ -6753,7 +6753,7 @@ send: (data: string | ArrayBuffer) => void
## NodeParamSpec — interface @beta
```
key: string
-kind: "texture" | "text" | "bool" | "float" | "color" | "channel"
+kind: "bool" | "channel" | "color" | "float" | "text" | "texture"
label: string
```
@@ -6899,7 +6899,7 @@ entryScene: string
hotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined
leaderboardEncryptionKey: string | undefined
msaaSamples: number | undefined
-outputTransform: "none" | "aces" | "neutral" | undefined
+outputTransform: "aces" | "neutral" | "none" | undefined
physics3dBackend: Physics3DBackend | undefined
physics3dWorld: Partial<Physics3DWorldConfig> | undefined
physicsConfig: Physics2DPluginConfig | undefined
@@ -6914,7 +6914,7 @@ sideModules: { id: string; file: string; globalName?: string; }[] | undefined
steamAppId: number | undefined
uiTheme: "light" | undefined
uiThemeColors: Record<string, string> | undefined
-webChannel: "poki" | "crazygames" | "youtube" | undefined
+webChannel: "crazygames" | "poki" | "youtube" | undefined
worlds: { scene: string; manifest: string; }[] | undefined
ySortLayers: number | undefined
```
@@ -6941,7 +6941,7 @@ used: number
## PageDef — interface @experimental
```
mount: number | (() => Entity) | undefined
-onClose: "keep" | "destroy" | undefined
+onClose: "destroy" | "keep" | undefined
overrides: PrefabOverride[] | undefined
parent: number | (() => Entity) | undefined
prefab: string
@@ -7007,7 +7007,7 @@ filter: "linear" | "nearest" | undefined
mipmaps: boolean | undefined
sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
srgb: boolean | undefined
-wrap: "repeat" | "clamp" | "mirror" | undefined
+wrap: "clamp" | "mirror" | "repeat" | undefined
```
## Particle — const @experimental
@@ -7585,7 +7585,7 @@ kind: string
## Placement — interface @experimental
```
-attach: "upright" | "align"
+attach: "align" | "upright"
biome: string
canopy: number
far: { u0: number; v0: number; u1: number; v1: number; tent?: boolean; } | null | undefined
@@ -7680,7 +7680,7 @@ bytes: number | undefined
draws: number | undefined
height: number | undefined
rejected: number | undefined
-state: "unavailable" | "inactive" | "budget-excluded" | "ready"
+state: "budget-excluded" | "inactive" | "ready" | "unavailable"
updated: boolean | undefined
width: number | undefined
```
@@ -7750,7 +7750,7 @@ world: string
## PlanetStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## Planets — class @experimental
@@ -7922,8 +7922,8 @@ title: string | undefined
```
body: string | ArrayBuffer | undefined
headers: Record<string, string> | undefined
-method: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "OPTIONS" | undefined
-responseType: "json" | "text" | "arraybuffer" | undefined
+method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "POST" | "PUT" | undefined
+responseType: "arraybuffer" | "json" | "text" | undefined
timeout: number | undefined
```
@@ -8066,7 +8066,7 @@ physicsEnabled: boolean | undefined
remoteRoot: string | undefined
runtime: RuntimeBuildConfig | undefined
sceneData: SceneData
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
wasmBaseUrl: string | undefined
```
@@ -8098,7 +8098,7 @@ physicsEnabled: boolean | undefined
prewarmShaders: { timeoutMs?: number; } | undefined
runtime: RuntimeBuildConfig | undefined
scenes: { name: string; data: SceneData; }[]
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
ySortLayers: number | undefined
```
@@ -8303,7 +8303,7 @@ weight: number
```
ceiling: PowerLevel | null
fps: number
-reason: "none" | "battery" | "thermal" | "critical"
+reason: "battery" | "critical" | "none" | "thermal"
saving: boolean
```
@@ -8318,14 +8318,14 @@ ceiling: PowerLevel | undefined
fps: number | undefined
lowBattery: number | undefined
severe: "critical" | "never" | undefined
-thermal: "critical" | "serious" | "never" | undefined
+thermal: "critical" | "never" | "serious" | undefined
```
## PowerState — interface @experimental
```
charging: boolean | null
level: number | null
-thermal: "critical" | "serious" | "nominal" | "fair" | null
+thermal: "critical" | "fair" | "nominal" | "serious" | null
```
## PreSceneDrawCallback — type @experimental
@@ -8408,7 +8408,7 @@ componentType: string | undefined
metadataKey: string | undefined
prefabEntityId: string
propertyName: string | undefined
-type: "property" | "component_added" | "component_replaced" | "component_removed" | "name" | "visibility" | "parent" | "metadata_set" | "metadata_removed"
+type: "component_added" | "component_removed" | "component_replaced" | "metadata_removed" | "metadata_set" | "name" | "parent" | "property" | "visibility"
value: unknown
```
@@ -8701,7 +8701,7 @@ depthPrepass: boolean
detailScale: number
drawCallBudget: number
dynamicGIReduced: boolean
-lighting: "full" | "direct"
+lighting: "direct" | "full"
minRenderScale: number
msaaSamples: 2 | 1 | 4 | 8
particleLimit: number
@@ -8947,7 +8947,7 @@ version: number
## RecipeMember — interface @experimental
```
arc: readonly [number, number] | undefined
-attach: "upright" | "align" | undefined
+attach: "align" | "upright" | undefined
canopy: number | undefined
chance: number | undefined
count: readonly [number, number] | undefined
@@ -9448,7 +9448,7 @@ source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
steamAppId: number | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
worlds: WorldManifest[] | undefined
```
@@ -9997,7 +9997,7 @@ setContentSize: (size: Vec2) => void
background: UIVisualInit | undefined
contentSize: Vec2
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
node: UINodeInit | undefined
@@ -10128,7 +10128,7 @@ size: Vec2
deniedCasters: number
granted: number
reducedCasters: number
-refusal: "none" | "tile-budget" | "tile-too-large" | "atlas-full"
+refusal: "atlas-full" | "none" | "tile-budget" | "tile-too-large"
requested: number
```
@@ -11010,7 +11010,7 @@ VisibleOutside = 2
nestedAt: string | undefined
override: PrefabOverride
reason: string
-site: "variant" | "nested" | "instance"
+site: "instance" | "nested" | "variant"
```
## StaticBatch — const @experimental
@@ -11733,7 +11733,7 @@ region: ((x0: number, z0: number, spacing: number, count: number) => TerrainRegi
## TerrainStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## TerrainTileEntry — interface @experimental
@@ -11968,7 +11968,7 @@ static prototype: TextInputPlugin
```
horizontalOverflow: boolean
metrics: TextMetrics | null
-unsupported: "rich-text" | "custom-font" | "complex-script" | "invalid-box" | null
+unsupported: "complex-script" | "custom-font" | "invalid-box" | "rich-text" | null
verticalOverflow: boolean
```
@@ -12587,7 +12587,7 @@ duration: number | undefined
keepPersistent: boolean | undefined
onComplete: (() => void) | undefined
onStart: (() => void) | undefined
-transition: "none" | "fade" | undefined
+transition: "fade" | "none" | undefined
```
## TreeDataSource — interface @beta
@@ -12602,7 +12602,7 @@ subscribe: ((listener: () => void) => Unsubscribe) | undefined
## TreeDropRequest — interface @beta
```
-position: "before" | "inside" | "after"
+position: "after" | "before" | "inside"
source: TreeRow<T>
target: TreeRow<T>
```
@@ -13393,7 +13393,7 @@ type: DataType
## VibrationOptions — interface @experimental
```
-duration: "short" | "long" | undefined
+duration: "long" | "short" | undefined
intensity: VibrationIntensity | undefined
```
@@ -14136,7 +14136,7 @@ Generator<number, T, void>
```
@internal addressOfComponent: (component: AnyComponentDef, entity: Entity) => number | undefined
@internal addressResolver: (component: AnyComponentDef) => (entity: Entity) => number | undefined
-@internal advanceMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number, through: number) => void
+@internal advanceMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number, through: number) => void
@internal advanceRemovedCursorReader: (component: AnyComponentDef, readerId: number, through: number) => void
@internal advanceRemovedReader: (component: AnyComponentDef, readerId: number, lastRunTick: number) => void
@internal advanceTick: () => void
@@ -14155,7 +14155,7 @@ Generator<number, T, void>
@internal compositionChanges: () => CompositionDelta | null
@internal connectCpp: (cppRegistry: CppRegistry, module?: ESEngineModule, options?: BridgeConnectOptions) => void
@internal disconnectCpp: () => void
-@internal disposeMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => void
+@internal disposeMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => void
@internal disposeRemovedReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeTopologyReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeWriteReader: (component: AnyComponentDef, readerId: number) => void
@@ -14190,16 +14190,16 @@ Generator<number, T, void>
@internal isIterating: () => boolean
@internal layoutEpoch: () => number | null
@internal markChanged: (entity: Entity, component: AnyComponentDef) => void
-@internal mutationRevision: (component: AnyComponentDef, kind: "write" | "topology") => number
-@internal mutationSequence: (kind: "write" | "topology") => number
-@internal mutationsForCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => Entity[]
+@internal mutationRevision: (component: AnyComponentDef, kind: "topology" | "write") => number
+@internal mutationSequence: (kind: "topology" | "write") => number
+@internal mutationsForCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => Entity[]
@internal onCoreDisconnect: (dispose: () => void) => () => void
@internal openSpeculation: (log: { record(world: World, entity: Entity, component: AnyComponentDef): void; }) => void
@internal queries_: QueryCache
@internal queryCostEnabled: boolean
@internal queryEntities: (components: AnyComponentDef[], withFilters?: AnyComponentDef[], withoutFilters?: AnyComponentDef[], precomputedKey?: string, filter?: QueryFilter, precomputedDepIds?: symbol[]) => readonly Entity[]
@internal refreshBuiltinMembership: (entity: Entity, component: AnyComponentDef) => void
-@internal registerMutationCursor: (component: AnyComponentDef, kind: "write" | "topology") => number
+@internal registerMutationCursor: (component: AnyComponentDef, kind: "topology" | "write") => number
@internal registerRemovedCursorReader: (component: AnyComponentDef) => number
@internal registerRemovedReader: (component: AnyComponentDef) => number
@internal registerRemovedReaderFrom: (component: AnyComponentDef, retainFromTick: number) => number
@@ -14307,7 +14307,7 @@ ResourceDef<WorldGens>
```
layers: Record<string, ChunkLayerStatus>
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## WorldGens — class @experimental
@@ -14331,7 +14331,7 @@ static prototype: WorldGens
cellSize: number
cells: WorldCell[]
persistentRefs: number[]
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
scene: string
version: number
```
@@ -14343,7 +14343,7 @@ cells: PartitionedCell[]
errors: string[]
persistent: SceneData
persistentRefs: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
warnings: string[]
```
@@ -14406,7 +14406,7 @@ loadCount: number
loadingCells: string[]
persistentEntities: number
persistentHandles: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
prefetchCells: string[]
prefetchHits: number
prefetchMisses: number
@@ -16527,7 +16527,7 @@ InputRouter
## isDialogOpen — function @experimental
```
-(world: Pick<World, "has" | "get">, root: Entity): boolean
+(world: Pick<World, "get" | "has">, root: Entity): boolean
```
## isDropdownOpen — function @experimental
@@ -16577,7 +16577,7 @@ InputRouter
## isPointerBlockedInTree — function @experimental
```
-(world: Pick<World, "has" | "get" | "valid">, entity: Entity): boolean
+(world: Pick<World, "get" | "has" | "valid">, entity: Entity): boolean
```
## isPrefabEntry — function @experimental
@@ -16742,7 +16742,7 @@ Logger
## manifestPlane — function @experimental
```
-(manifest: { plane?: "xz" | "xy"; } | null): "xz" | "xy"
+(manifest: { plane?: "xy" | "xz"; } | null): "xy" | "xz"
```
## markThemed — function @experimental
@@ -16962,17 +16962,17 @@ MeshRendererPlugin
## packagedAppOptions — function @experimental
```
-(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples" | "quality">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces" | "neutral"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
+(config: Pick<PackagedGameConfig, "colorSpace" | "depthLayers" | "msaaSamples" | "outputTransform" | "quality" | "screenFit" | "ySortLayers">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "aces" | "neutral" | "none"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
```
## packagedRuntimeInit — function @experimental
```
-(config: Pick<PackagedGameConfig, "physicsEnabled" | "physicsConfig" | "physics3dBackend" | "physics3dWorld" | "audioConfig" | "uiTheme" | "uiThemeColors" | "achievements" | "steamAppId" | "screenFit" | "aot" | "debugChannel" | "runtime">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
+(config: Pick<PackagedGameConfig, "achievements" | "aot" | "audioConfig" | "debugChannel" | "physics3dBackend" | "physics3dWorld" | "physicsConfig" | "physicsEnabled" | "runtime" | "screenFit" | "steamAppId" | "uiTheme" | "uiThemeColors">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
```
## paintWeights — function @experimental
```
-(h: number, ny: number, t: Pick<TerrainData, "rockSlope" | "dirtHeight" | "snowHeight">): [number, number, number, number]
+(h: number, ny: number, t: Pick<TerrainData, "dirtHeight" | "rockSlope" | "snowHeight">): [number, number, number, number]
```
## panoramaDirection — function @experimental
@@ -17167,7 +17167,7 @@ ParticlePlugin
## planeSecond — function @experimental
```
-(position: { y: number; z?: number; }, plane: "xz" | "xy"): number
+(position: { y: number; z?: number; }, plane: "xy" | "xz"): number
```
## planetPlugin — const @experimental
@@ -17387,7 +17387,7 @@ PrefabsPlugin
## q — const @experimental
```
-{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "z" | "w">): number; scaled(a: Quat, t: number): Quat; }
+{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "w" | "z">): number; scaled(a: Quat, t: number): Quat; }
```
## quadraticBezier — function @experimental
@@ -18082,7 +18082,7 @@ ServicesPlugin
## setTreeViewData — function @beta
```
-<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "item" | "dragHandle" | "canDrop" | "onDrop">): () => void
+<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "canDrop" | "dragHandle" | "item" | "onDrop">): () => void
```
## setUIVisible — function @experimental
@@ -18607,7 +18607,7 @@ UIVisibilityPlugin
## updateAnimatorLayer — function @experimental
```
-(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "name" | "weight" | "blend" | "mask">): AnimatorControllerDef
+(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "blend" | "mask" | "name" | "weight">): AnimatorControllerDef
```
## updateAnimatorParam — function @experimental
diff --git a/sdk/etc/index.native.api.md b/sdk/etc/index.native.api.md
index 7499a69e4..626bb134a 100644
--- a/sdk/etc/index.native.api.md
+++ b/sdk/etc/index.native.api.md
@@ -225,7 +225,7 @@ world: World
label: string | undefined
name: string
tooltip: string | undefined
-type: "string" | "number" | "bool" | "entity"
+type: "bool" | "entity" | "number" | "string"
```
## AiOutputs — type @experimental
@@ -243,7 +243,7 @@ options: readonly { label: string; value: string; }[] | undefined
optionsSource: string | undefined
step: number | undefined
tooltip: string | undefined
-type: "string" | "number" | "bool" | "enum"
+type: "bool" | "enum" | "number" | "string"
```
## AiParamValue — type @experimental
@@ -901,7 +901,7 @@ type: AssetFieldType
```
alwaysInclude: boolean | undefined
folder: string
-mode: "local" | "subpackage" | "remote"
+mode: "local" | "remote" | "subpackage"
```
## AssetGroupMode — type @experimental
@@ -1159,7 +1159,7 @@ ResourceDef<AudioAPI>
## AudioAPI — class @experimental
```
-@internal getVoiceState: (handle: AudioHandle) => "playing" | "paused" | "ended" | "stopped" | "untracked"
+@internal getVoiceState: (handle: AudioHandle) => "ended" | "paused" | "playing" | "stopped" | "untracked"
@internal onPlaybackStop: (callback: (generation: number) => void) => () => void
@internal playbackGeneration: number
baseUrl: string
@@ -2677,7 +2677,7 @@ loadRadius: number
make: (cx: number, cz: number, signal: AbortSignal) => T | null | Promise<T | null>
originX: number
originZ: number
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
publish: (cx: number, cz: number, value: T) => void
release: (cx: number, cz: number, value: T) => void
sizeX: number
@@ -3170,7 +3170,7 @@ ComponentDef<{}>
background: UIVisualInit | undefined
data: DataSource<T> | readonly T[]
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
item: ListItemTemplate<T> | Record<string, ListItemTemplate<T>>
@@ -4479,7 +4479,7 @@ paint: (x: number, z: number, h: number, ny: number) => LayerWeights
splats: () => { a: Splat | null; b: Splat | null; }
toData: () => FieldSourceData
static fromData: (d: FieldSourceData) => FieldSource
-static new (field: Heightfield, data: Pick<TerrainData, "sizeX" | "sizeZ" | "height" | "rockSlope" | "dirtHeight" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
+static new (field: Heightfield, data: Pick<TerrainData, "dirtHeight" | "height" | "rockSlope" | "sizeX" | "sizeZ" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
static prototype: FieldSource
```
@@ -4502,7 +4502,7 @@ Top = 3
## FilterEffectDef — interface @experimental
```
-filter: "lowpass" | "highpass" | "bandpass" | "lowshelf" | "highshelf" | "peaking" | "notch"
+filter: "bandpass" | "highpass" | "highshelf" | "lowpass" | "lowshelf" | "notch" | "peaking"
frequency: number
gainDb: number | undefined
q: number | undefined
@@ -5969,7 +5969,7 @@ spacing: number
accepted: boolean
environmentSunAim: [number, number, number] | null
limit: number
-refusal: "none" | "capacity" | "no-environment-sun"
+refusal: "capacity" | "no-environment-sun" | "none"
refusedCount: number
requested: number
```
@@ -6103,7 +6103,7 @@ sceneName: string | undefined
source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
@@ -6840,7 +6840,7 @@ es_loadImagePixels: (pathOrBytes: string | ArrayBuffer) => { width: number; heig
es_native_call: ((id: number, method: string, args: string) => boolean) | undefined
es_native_has: ((method: string) => boolean) | undefined
es_pollGamepads: (() => { index: number; connected: boolean; buttons: number[]; axes: number[]; }[]) | undefined
-es_pollMotion: (() => Pick<MotionSample, "timestamp" | "accelerationIncludingGravity" | "gyroscope"> | null) | undefined
+es_pollMotion: (() => Pick<MotionSample, "accelerationIncludingGravity" | "gyroscope" | "timestamp"> | null) | undefined
es_rasterizeGlyph: ((request: PlatformGlyphRequest) => { pixels: ArrayBuffer; width: number; height: number; advance: number; bearingX: number; bearingY: number; } | null) | undefined
es_readAsset: (path: string) => ArrayBuffer | null
es_readCacheFile: ((key: string) => ArrayBuffer | null) | undefined
@@ -6962,7 +6962,7 @@ send: (data: string | ArrayBuffer) => void
## NodeParamSpec — interface @beta
```
key: string
-kind: "texture" | "text" | "bool" | "float" | "color" | "channel"
+kind: "bool" | "channel" | "color" | "float" | "text" | "texture"
label: string
```
@@ -7113,7 +7113,7 @@ entryScene: string
hotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined
leaderboardEncryptionKey: string | undefined
msaaSamples: number | undefined
-outputTransform: "none" | "aces" | "neutral" | undefined
+outputTransform: "aces" | "neutral" | "none" | undefined
physics3dBackend: Physics3DBackend | undefined
physics3dWorld: Partial<Physics3DWorldConfig> | undefined
physicsConfig: Physics2DPluginConfig | undefined
@@ -7128,7 +7128,7 @@ sideModules: { id: string; file: string; globalName?: string; }[] | undefined
steamAppId: number | undefined
uiTheme: "light" | undefined
uiThemeColors: Record<string, string> | undefined
-webChannel: "poki" | "crazygames" | "youtube" | undefined
+webChannel: "crazygames" | "poki" | "youtube" | undefined
worlds: { scene: string; manifest: string; }[] | undefined
ySortLayers: number | undefined
```
@@ -7155,7 +7155,7 @@ used: number
## PageDef — interface @experimental
```
mount: number | (() => Entity) | undefined
-onClose: "keep" | "destroy" | undefined
+onClose: "destroy" | "keep" | undefined
overrides: PrefabOverride[] | undefined
parent: number | (() => Entity) | undefined
prefab: string
@@ -7221,7 +7221,7 @@ filter: "linear" | "nearest" | undefined
mipmaps: boolean | undefined
sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
srgb: boolean | undefined
-wrap: "repeat" | "clamp" | "mirror" | undefined
+wrap: "clamp" | "mirror" | "repeat" | undefined
```
## Particle — const @experimental
@@ -7799,7 +7799,7 @@ kind: string
## Placement — interface @experimental
```
-attach: "upright" | "align"
+attach: "align" | "upright"
biome: string
canopy: number
far: { u0: number; v0: number; u1: number; v1: number; tent?: boolean; } | null | undefined
@@ -7894,7 +7894,7 @@ bytes: number | undefined
draws: number | undefined
height: number | undefined
rejected: number | undefined
-state: "unavailable" | "inactive" | "budget-excluded" | "ready"
+state: "budget-excluded" | "inactive" | "ready" | "unavailable"
updated: boolean | undefined
width: number | undefined
```
@@ -7964,7 +7964,7 @@ world: string
## PlanetStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## Planets — class @experimental
@@ -8136,8 +8136,8 @@ title: string | undefined
```
body: string | ArrayBuffer | undefined
headers: Record<string, string> | undefined
-method: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "OPTIONS" | undefined
-responseType: "json" | "text" | "arraybuffer" | undefined
+method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "POST" | "PUT" | undefined
+responseType: "arraybuffer" | "json" | "text" | undefined
timeout: number | undefined
```
@@ -8280,7 +8280,7 @@ physicsEnabled: boolean | undefined
remoteRoot: string | undefined
runtime: RuntimeBuildConfig | undefined
sceneData: SceneData
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
wasmBaseUrl: string | undefined
```
@@ -8312,7 +8312,7 @@ physicsEnabled: boolean | undefined
prewarmShaders: { timeoutMs?: number; } | undefined
runtime: RuntimeBuildConfig | undefined
scenes: { name: string; data: SceneData; }[]
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
ySortLayers: number | undefined
```
@@ -8517,7 +8517,7 @@ weight: number
```
ceiling: PowerLevel | null
fps: number
-reason: "none" | "battery" | "thermal" | "critical"
+reason: "battery" | "critical" | "none" | "thermal"
saving: boolean
```
@@ -8532,14 +8532,14 @@ ceiling: PowerLevel | undefined
fps: number | undefined
lowBattery: number | undefined
severe: "critical" | "never" | undefined
-thermal: "critical" | "serious" | "never" | undefined
+thermal: "critical" | "never" | "serious" | undefined
```
## PowerState — interface @experimental
```
charging: boolean | null
level: number | null
-thermal: "critical" | "serious" | "nominal" | "fair" | null
+thermal: "critical" | "fair" | "nominal" | "serious" | null
```
## PreSceneDrawCallback — type @experimental
@@ -8622,7 +8622,7 @@ componentType: string | undefined
metadataKey: string | undefined
prefabEntityId: string
propertyName: string | undefined
-type: "property" | "component_added" | "component_replaced" | "component_removed" | "name" | "visibility" | "parent" | "metadata_set" | "metadata_removed"
+type: "component_added" | "component_removed" | "component_replaced" | "metadata_removed" | "metadata_set" | "name" | "parent" | "property" | "visibility"
value: unknown
```
@@ -8915,7 +8915,7 @@ depthPrepass: boolean
detailScale: number
drawCallBudget: number
dynamicGIReduced: boolean
-lighting: "full" | "direct"
+lighting: "direct" | "full"
minRenderScale: number
msaaSamples: 2 | 1 | 4 | 8
particleLimit: number
@@ -9176,7 +9176,7 @@ version: number
## RecipeMember — interface @experimental
```
arc: readonly [number, number] | undefined
-attach: "upright" | "align" | undefined
+attach: "align" | "upright" | undefined
canopy: number | undefined
chance: number | undefined
count: readonly [number, number] | undefined
@@ -9677,7 +9677,7 @@ source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
steamAppId: number | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
worlds: WorldManifest[] | undefined
```
@@ -10226,7 +10226,7 @@ setContentSize: (size: Vec2) => void
background: UIVisualInit | undefined
contentSize: Vec2
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
node: UINodeInit | undefined
@@ -10357,7 +10357,7 @@ size: Vec2
deniedCasters: number
granted: number
reducedCasters: number
-refusal: "none" | "tile-budget" | "tile-too-large" | "atlas-full"
+refusal: "atlas-full" | "none" | "tile-budget" | "tile-too-large"
requested: number
```
@@ -11239,7 +11239,7 @@ VisibleOutside = 2
nestedAt: string | undefined
override: PrefabOverride
reason: string
-site: "variant" | "nested" | "instance"
+site: "instance" | "nested" | "variant"
```
## StaticBatch — const @experimental
@@ -11962,7 +11962,7 @@ region: ((x0: number, z0: number, spacing: number, count: number) => TerrainRegi
## TerrainStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## TerrainTileEntry — interface @experimental
@@ -12197,7 +12197,7 @@ static prototype: TextInputPlugin
```
horizontalOverflow: boolean
metrics: TextMetrics | null
-unsupported: "rich-text" | "custom-font" | "complex-script" | "invalid-box" | null
+unsupported: "complex-script" | "custom-font" | "invalid-box" | "rich-text" | null
verticalOverflow: boolean
```
@@ -12816,7 +12816,7 @@ duration: number | undefined
keepPersistent: boolean | undefined
onComplete: (() => void) | undefined
onStart: (() => void) | undefined
-transition: "none" | "fade" | undefined
+transition: "fade" | "none" | undefined
```
## TreeDataSource — interface @beta
@@ -12831,7 +12831,7 @@ subscribe: ((listener: () => void) => Unsubscribe) | undefined
## TreeDropRequest — interface @beta
```
-position: "before" | "inside" | "after"
+position: "after" | "before" | "inside"
source: TreeRow<T>
target: TreeRow<T>
```
@@ -13622,7 +13622,7 @@ type: DataType
## VibrationOptions — interface @experimental
```
-duration: "short" | "long" | undefined
+duration: "long" | "short" | undefined
intensity: VibrationIntensity | undefined
```
@@ -14365,7 +14365,7 @@ Generator<number, T, void>
```
@internal addressOfComponent: (component: AnyComponentDef, entity: Entity) => number | undefined
@internal addressResolver: (component: AnyComponentDef) => (entity: Entity) => number | undefined
-@internal advanceMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number, through: number) => void
+@internal advanceMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number, through: number) => void
@internal advanceRemovedCursorReader: (component: AnyComponentDef, readerId: number, through: number) => void
@internal advanceRemovedReader: (component: AnyComponentDef, readerId: number, lastRunTick: number) => void
@internal advanceTick: () => void
@@ -14384,7 +14384,7 @@ Generator<number, T, void>
@internal compositionChanges: () => CompositionDelta | null
@internal connectCpp: (cppRegistry: CppRegistry, module?: ESEngineModule, options?: BridgeConnectOptions) => void
@internal disconnectCpp: () => void
-@internal disposeMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => void
+@internal disposeMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => void
@internal disposeRemovedReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeTopologyReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeWriteReader: (component: AnyComponentDef, readerId: number) => void
@@ -14419,16 +14419,16 @@ Generator<number, T, void>
@internal isIterating: () => boolean
@internal layoutEpoch: () => number | null
@internal markChanged: (entity: Entity, component: AnyComponentDef) => void
-@internal mutationRevision: (component: AnyComponentDef, kind: "write" | "topology") => number
-@internal mutationSequence: (kind: "write" | "topology") => number
-@internal mutationsForCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => Entity[]
+@internal mutationRevision: (component: AnyComponentDef, kind: "topology" | "write") => number
+@internal mutationSequence: (kind: "topology" | "write") => number
+@internal mutationsForCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => Entity[]
@internal onCoreDisconnect: (dispose: () => void) => () => void
@internal openSpeculation: (log: { record(world: World, entity: Entity, component: AnyComponentDef): void; }) => void
@internal queries_: QueryCache
@internal queryCostEnabled: boolean
@internal queryEntities: (components: AnyComponentDef[], withFilters?: AnyComponentDef[], withoutFilters?: AnyComponentDef[], precomputedKey?: string, filter?: QueryFilter, precomputedDepIds?: symbol[]) => readonly Entity[]
@internal refreshBuiltinMembership: (entity: Entity, component: AnyComponentDef) => void
-@internal registerMutationCursor: (component: AnyComponentDef, kind: "write" | "topology") => number
+@internal registerMutationCursor: (component: AnyComponentDef, kind: "topology" | "write") => number
@internal registerRemovedCursorReader: (component: AnyComponentDef) => number
@internal registerRemovedReader: (component: AnyComponentDef) => number
@internal registerRemovedReaderFrom: (component: AnyComponentDef, retainFromTick: number) => number
@@ -14536,7 +14536,7 @@ ResourceDef<WorldGens>
```
layers: Record<string, ChunkLayerStatus>
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## WorldGens — class @experimental
@@ -14560,7 +14560,7 @@ static prototype: WorldGens
cellSize: number
cells: WorldCell[]
persistentRefs: number[]
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
scene: string
version: number
```
@@ -14572,7 +14572,7 @@ cells: PartitionedCell[]
errors: string[]
persistent: SceneData
persistentRefs: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
warnings: string[]
```
@@ -14635,7 +14635,7 @@ loadCount: number
loadingCells: string[]
persistentEntities: number
persistentHandles: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
prefetchCells: string[]
prefetchHits: number
prefetchMisses: number
@@ -16806,7 +16806,7 @@ InputRouter
## isDialogOpen — function @experimental
```
-(world: Pick<World, "has" | "get">, root: Entity): boolean
+(world: Pick<World, "get" | "has">, root: Entity): boolean
```
## isDropdownOpen — function @experimental
@@ -16856,7 +16856,7 @@ InputRouter
## isPointerBlockedInTree — function @experimental
```
-(world: Pick<World, "has" | "get" | "valid">, entity: Entity): boolean
+(world: Pick<World, "get" | "has" | "valid">, entity: Entity): boolean
```
## isPrefabEntry — function @experimental
@@ -17021,7 +17021,7 @@ Logger
## manifestPlane — function @experimental
```
-(manifest: { plane?: "xz" | "xy"; } | null): "xz" | "xy"
+(manifest: { plane?: "xy" | "xz"; } | null): "xy" | "xz"
```
## markThemed — function @experimental
@@ -17241,17 +17241,17 @@ MeshRendererPlugin
## packagedAppOptions — function @experimental
```
-(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples" | "quality">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces" | "neutral"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
+(config: Pick<PackagedGameConfig, "colorSpace" | "depthLayers" | "msaaSamples" | "outputTransform" | "quality" | "screenFit" | "ySortLayers">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "aces" | "neutral" | "none"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
```
## packagedRuntimeInit — function @experimental
```
-(config: Pick<PackagedGameConfig, "physicsEnabled" | "physicsConfig" | "physics3dBackend" | "physics3dWorld" | "audioConfig" | "uiTheme" | "uiThemeColors" | "achievements" | "steamAppId" | "screenFit" | "aot" | "debugChannel" | "runtime">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
+(config: Pick<PackagedGameConfig, "achievements" | "aot" | "audioConfig" | "debugChannel" | "physics3dBackend" | "physics3dWorld" | "physicsConfig" | "physicsEnabled" | "runtime" | "screenFit" | "steamAppId" | "uiTheme" | "uiThemeColors">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
```
## paintWeights — function @experimental
```
-(h: number, ny: number, t: Pick<TerrainData, "rockSlope" | "dirtHeight" | "snowHeight">): [number, number, number, number]
+(h: number, ny: number, t: Pick<TerrainData, "dirtHeight" | "rockSlope" | "snowHeight">): [number, number, number, number]
```
## panoramaDirection — function @experimental
@@ -17446,7 +17446,7 @@ ParticlePlugin
## planeSecond — function @experimental
```
-(position: { y: number; z?: number; }, plane: "xz" | "xy"): number
+(position: { y: number; z?: number; }, plane: "xy" | "xz"): number
```
## planetPlugin — const @experimental
@@ -17666,7 +17666,7 @@ PrefabsPlugin
## q — const @experimental
```
-{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "z" | "w">): number; scaled(a: Quat, t: number): Quat; }
+{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "w" | "z">): number; scaled(a: Quat, t: number): Quat; }
```
## quadraticBezier — function @experimental
@@ -18361,7 +18361,7 @@ ServicesPlugin
## setTreeViewData — function @beta
```
-<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "item" | "dragHandle" | "canDrop" | "onDrop">): () => void
+<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "canDrop" | "dragHandle" | "item" | "onDrop">): () => void
```
## setUIVisible — function @experimental
@@ -18886,7 +18886,7 @@ UIVisibilityPlugin
## updateAnimatorLayer — function @experimental
```
-(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "name" | "weight" | "blend" | "mask">): AnimatorControllerDef
+(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "blend" | "mask" | "name" | "weight">): AnimatorControllerDef
```
## updateAnimatorParam — function @experimental
diff --git a/sdk/etc/index.node.api.md b/sdk/etc/index.node.api.md
index 754fa7bb7..f8c7cc835 100644
--- a/sdk/etc/index.node.api.md
+++ b/sdk/etc/index.node.api.md
@@ -220,7 +220,7 @@ world: World
label: string | undefined
name: string
tooltip: string | undefined
-type: "string" | "number" | "bool" | "entity"
+type: "bool" | "entity" | "number" | "string"
```
## AiOutputs — type @experimental
@@ -238,7 +238,7 @@ options: readonly { label: string; value: string; }[] | undefined
optionsSource: string | undefined
step: number | undefined
tooltip: string | undefined
-type: "string" | "number" | "bool" | "enum"
+type: "bool" | "enum" | "number" | "string"
```
## AiParamValue — type @experimental
@@ -896,7 +896,7 @@ type: AssetFieldType
```
alwaysInclude: boolean | undefined
folder: string
-mode: "local" | "subpackage" | "remote"
+mode: "local" | "remote" | "subpackage"
```
## AssetGroupMode — type @experimental
@@ -1154,7 +1154,7 @@ ResourceDef<AudioAPI>
## AudioAPI — class @experimental
```
-@internal getVoiceState: (handle: AudioHandle) => "playing" | "paused" | "ended" | "stopped" | "untracked"
+@internal getVoiceState: (handle: AudioHandle) => "ended" | "paused" | "playing" | "stopped" | "untracked"
@internal onPlaybackStop: (callback: (generation: number) => void) => () => void
@internal playbackGeneration: number
baseUrl: string
@@ -2672,7 +2672,7 @@ loadRadius: number
make: (cx: number, cz: number, signal: AbortSignal) => T | null | Promise<T | null>
originX: number
originZ: number
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
publish: (cx: number, cz: number, value: T) => void
release: (cx: number, cz: number, value: T) => void
sizeX: number
@@ -3157,7 +3157,7 @@ ComponentDef<{}>
background: UIVisualInit | undefined
data: DataSource<T> | readonly T[]
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
item: ListItemTemplate<T> | Record<string, ListItemTemplate<T>>
@@ -4466,7 +4466,7 @@ paint: (x: number, z: number, h: number, ny: number) => LayerWeights
splats: () => { a: Splat | null; b: Splat | null; }
toData: () => FieldSourceData
static fromData: (d: FieldSourceData) => FieldSource
-static new (field: Heightfield, data: Pick<TerrainData, "sizeX" | "sizeZ" | "height" | "rockSlope" | "dirtHeight" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
+static new (field: Heightfield, data: Pick<TerrainData, "dirtHeight" | "height" | "rockSlope" | "sizeX" | "sizeZ" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
static prototype: FieldSource
```
@@ -4489,7 +4489,7 @@ Top = 3
## FilterEffectDef — interface @experimental
```
-filter: "lowpass" | "highpass" | "bandpass" | "lowshelf" | "highshelf" | "peaking" | "notch"
+filter: "bandpass" | "highpass" | "highshelf" | "lowpass" | "lowshelf" | "notch" | "peaking"
frequency: number
gainDb: number | undefined
q: number | undefined
@@ -5956,7 +5956,7 @@ spacing: number
accepted: boolean
environmentSunAim: [number, number, number] | null
limit: number
-refusal: "none" | "capacity" | "no-environment-sun"
+refusal: "capacity" | "no-environment-sun" | "none"
refusedCount: number
requested: number
```
@@ -6090,7 +6090,7 @@ sceneName: string | undefined
source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
@@ -6748,7 +6748,7 @@ send: (data: string | ArrayBuffer) => void
## NodeParamSpec — interface @beta
```
key: string
-kind: "texture" | "text" | "bool" | "float" | "color" | "channel"
+kind: "bool" | "channel" | "color" | "float" | "text" | "texture"
label: string
```
@@ -6894,7 +6894,7 @@ entryScene: string
hotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined
leaderboardEncryptionKey: string | undefined
msaaSamples: number | undefined
-outputTransform: "none" | "aces" | "neutral" | undefined
+outputTransform: "aces" | "neutral" | "none" | undefined
physics3dBackend: Physics3DBackend | undefined
physics3dWorld: Partial<Physics3DWorldConfig> | undefined
physicsConfig: Physics2DPluginConfig | undefined
@@ -6909,7 +6909,7 @@ sideModules: { id: string; file: string; globalName?: string; }[] | undefined
steamAppId: number | undefined
uiTheme: "light" | undefined
uiThemeColors: Record<string, string> | undefined
-webChannel: "poki" | "crazygames" | "youtube" | undefined
+webChannel: "crazygames" | "poki" | "youtube" | undefined
worlds: { scene: string; manifest: string; }[] | undefined
ySortLayers: number | undefined
```
@@ -6936,7 +6936,7 @@ used: number
## PageDef — interface @experimental
```
mount: number | (() => Entity) | undefined
-onClose: "keep" | "destroy" | undefined
+onClose: "destroy" | "keep" | undefined
overrides: PrefabOverride[] | undefined
parent: number | (() => Entity) | undefined
prefab: string
@@ -7002,7 +7002,7 @@ filter: "linear" | "nearest" | undefined
mipmaps: boolean | undefined
sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
srgb: boolean | undefined
-wrap: "repeat" | "clamp" | "mirror" | undefined
+wrap: "clamp" | "mirror" | "repeat" | undefined
```
## Particle — const @experimental
@@ -7580,7 +7580,7 @@ kind: string
## Placement — interface @experimental
```
-attach: "upright" | "align"
+attach: "align" | "upright"
biome: string
canopy: number
far: { u0: number; v0: number; u1: number; v1: number; tent?: boolean; } | null | undefined
@@ -7675,7 +7675,7 @@ bytes: number | undefined
draws: number | undefined
height: number | undefined
rejected: number | undefined
-state: "unavailable" | "inactive" | "budget-excluded" | "ready"
+state: "budget-excluded" | "inactive" | "ready" | "unavailable"
updated: boolean | undefined
width: number | undefined
```
@@ -7745,7 +7745,7 @@ world: string
## PlanetStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## Planets — class @experimental
@@ -7917,8 +7917,8 @@ title: string | undefined
```
body: string | ArrayBuffer | undefined
headers: Record<string, string> | undefined
-method: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "OPTIONS" | undefined
-responseType: "json" | "text" | "arraybuffer" | undefined
+method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "POST" | "PUT" | undefined
+responseType: "arraybuffer" | "json" | "text" | undefined
timeout: number | undefined
```
@@ -8061,7 +8061,7 @@ physicsEnabled: boolean | undefined
remoteRoot: string | undefined
runtime: RuntimeBuildConfig | undefined
sceneData: SceneData
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
wasmBaseUrl: string | undefined
```
@@ -8093,7 +8093,7 @@ physicsEnabled: boolean | undefined
prewarmShaders: { timeoutMs?: number; } | undefined
runtime: RuntimeBuildConfig | undefined
scenes: { name: string; data: SceneData; }[]
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
ySortLayers: number | undefined
```
@@ -8298,7 +8298,7 @@ weight: number
```
ceiling: PowerLevel | null
fps: number
-reason: "none" | "battery" | "thermal" | "critical"
+reason: "battery" | "critical" | "none" | "thermal"
saving: boolean
```
@@ -8313,14 +8313,14 @@ ceiling: PowerLevel | undefined
fps: number | undefined
lowBattery: number | undefined
severe: "critical" | "never" | undefined
-thermal: "critical" | "serious" | "never" | undefined
+thermal: "critical" | "never" | "serious" | undefined
```
## PowerState — interface @experimental
```
charging: boolean | null
level: number | null
-thermal: "critical" | "serious" | "nominal" | "fair" | null
+thermal: "critical" | "fair" | "nominal" | "serious" | null
```
## PreSceneDrawCallback — type @experimental
@@ -8403,7 +8403,7 @@ componentType: string | undefined
metadataKey: string | undefined
prefabEntityId: string
propertyName: string | undefined
-type: "property" | "component_added" | "component_replaced" | "component_removed" | "name" | "visibility" | "parent" | "metadata_set" | "metadata_removed"
+type: "component_added" | "component_removed" | "component_replaced" | "metadata_removed" | "metadata_set" | "name" | "parent" | "property" | "visibility"
value: unknown
```
@@ -8696,7 +8696,7 @@ depthPrepass: boolean
detailScale: number
drawCallBudget: number
dynamicGIReduced: boolean
-lighting: "full" | "direct"
+lighting: "direct" | "full"
minRenderScale: number
msaaSamples: 2 | 1 | 4 | 8
particleLimit: number
@@ -8942,7 +8942,7 @@ version: number
## RecipeMember — interface @experimental
```
arc: readonly [number, number] | undefined
-attach: "upright" | "align" | undefined
+attach: "align" | "upright" | undefined
canopy: number | undefined
chance: number | undefined
count: readonly [number, number] | undefined
@@ -9443,7 +9443,7 @@ source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
steamAppId: number | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
worlds: WorldManifest[] | undefined
```
@@ -9992,7 +9992,7 @@ setContentSize: (size: Vec2) => void
background: UIVisualInit | undefined
contentSize: Vec2
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
node: UINodeInit | undefined
@@ -10123,7 +10123,7 @@ size: Vec2
deniedCasters: number
granted: number
reducedCasters: number
-refusal: "none" | "tile-budget" | "tile-too-large" | "atlas-full"
+refusal: "atlas-full" | "none" | "tile-budget" | "tile-too-large"
requested: number
```
@@ -11005,7 +11005,7 @@ VisibleOutside = 2
nestedAt: string | undefined
override: PrefabOverride
reason: string
-site: "variant" | "nested" | "instance"
+site: "instance" | "nested" | "variant"
```
## StaticBatch — const @experimental
@@ -11728,7 +11728,7 @@ region: ((x0: number, z0: number, spacing: number, count: number) => TerrainRegi
## TerrainStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## TerrainTileEntry — interface @experimental
@@ -11963,7 +11963,7 @@ static prototype: TextInputPlugin
```
horizontalOverflow: boolean
metrics: TextMetrics | null
-unsupported: "rich-text" | "custom-font" | "complex-script" | "invalid-box" | null
+unsupported: "complex-script" | "custom-font" | "invalid-box" | "rich-text" | null
verticalOverflow: boolean
```
@@ -12582,7 +12582,7 @@ duration: number | undefined
keepPersistent: boolean | undefined
onComplete: (() => void) | undefined
onStart: (() => void) | undefined
-transition: "none" | "fade" | undefined
+transition: "fade" | "none" | undefined
```
## TreeDataSource — interface @beta
@@ -12597,7 +12597,7 @@ subscribe: ((listener: () => void) => Unsubscribe) | undefined
## TreeDropRequest — interface @beta
```
-position: "before" | "inside" | "after"
+position: "after" | "before" | "inside"
source: TreeRow<T>
target: TreeRow<T>
```
@@ -13388,7 +13388,7 @@ type: DataType
## VibrationOptions — interface @experimental
```
-duration: "short" | "long" | undefined
+duration: "long" | "short" | undefined
intensity: VibrationIntensity | undefined
```
@@ -14131,7 +14131,7 @@ Generator<number, T, void>
```
@internal addressOfComponent: (component: AnyComponentDef, entity: Entity) => number | undefined
@internal addressResolver: (component: AnyComponentDef) => (entity: Entity) => number | undefined
-@internal advanceMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number, through: number) => void
+@internal advanceMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number, through: number) => void
@internal advanceRemovedCursorReader: (component: AnyComponentDef, readerId: number, through: number) => void
@internal advanceRemovedReader: (component: AnyComponentDef, readerId: number, lastRunTick: number) => void
@internal advanceTick: () => void
@@ -14150,7 +14150,7 @@ Generator<number, T, void>
@internal compositionChanges: () => CompositionDelta | null
@internal connectCpp: (cppRegistry: CppRegistry, module?: ESEngineModule, options?: BridgeConnectOptions) => void
@internal disconnectCpp: () => void
-@internal disposeMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => void
+@internal disposeMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => void
@internal disposeRemovedReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeTopologyReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeWriteReader: (component: AnyComponentDef, readerId: number) => void
@@ -14185,16 +14185,16 @@ Generator<number, T, void>
@internal isIterating: () => boolean
@internal layoutEpoch: () => number | null
@internal markChanged: (entity: Entity, component: AnyComponentDef) => void
-@internal mutationRevision: (component: AnyComponentDef, kind: "write" | "topology") => number
-@internal mutationSequence: (kind: "write" | "topology") => number
-@internal mutationsForCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => Entity[]
+@internal mutationRevision: (component: AnyComponentDef, kind: "topology" | "write") => number
+@internal mutationSequence: (kind: "topology" | "write") => number
+@internal mutationsForCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => Entity[]
@internal onCoreDisconnect: (dispose: () => void) => () => void
@internal openSpeculation: (log: { record(world: World, entity: Entity, component: AnyComponentDef): void; }) => void
@internal queries_: QueryCache
@internal queryCostEnabled: boolean
@internal queryEntities: (components: AnyComponentDef[], withFilters?: AnyComponentDef[], withoutFilters?: AnyComponentDef[], precomputedKey?: string, filter?: QueryFilter, precomputedDepIds?: symbol[]) => readonly Entity[]
@internal refreshBuiltinMembership: (entity: Entity, component: AnyComponentDef) => void
-@internal registerMutationCursor: (component: AnyComponentDef, kind: "write" | "topology") => number
+@internal registerMutationCursor: (component: AnyComponentDef, kind: "topology" | "write") => number
@internal registerRemovedCursorReader: (component: AnyComponentDef) => number
@internal registerRemovedReader: (component: AnyComponentDef) => number
@internal registerRemovedReaderFrom: (component: AnyComponentDef, retainFromTick: number) => number
@@ -14302,7 +14302,7 @@ ResourceDef<WorldGens>
```
layers: Record<string, ChunkLayerStatus>
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## WorldGens — class @experimental
@@ -14326,7 +14326,7 @@ static prototype: WorldGens
cellSize: number
cells: WorldCell[]
persistentRefs: number[]
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
scene: string
version: number
```
@@ -14338,7 +14338,7 @@ cells: PartitionedCell[]
errors: string[]
persistent: SceneData
persistentRefs: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
warnings: string[]
```
@@ -14401,7 +14401,7 @@ loadCount: number
loadingCells: string[]
persistentEntities: number
persistentHandles: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
prefetchCells: string[]
prefetchHits: number
prefetchMisses: number
@@ -16522,7 +16522,7 @@ InputRouter
## isDialogOpen — function @experimental
```
-(world: Pick<World, "has" | "get">, root: Entity): boolean
+(world: Pick<World, "get" | "has">, root: Entity): boolean
```
## isDropdownOpen — function @experimental
@@ -16572,7 +16572,7 @@ InputRouter
## isPointerBlockedInTree — function @experimental
```
-(world: Pick<World, "has" | "get" | "valid">, entity: Entity): boolean
+(world: Pick<World, "get" | "has" | "valid">, entity: Entity): boolean
```
## isPrefabEntry — function @experimental
@@ -16742,7 +16742,7 @@ Logger
## manifestPlane — function @experimental
```
-(manifest: { plane?: "xz" | "xy"; } | null): "xz" | "xy"
+(manifest: { plane?: "xy" | "xz"; } | null): "xy" | "xz"
```
## markThemed — function @experimental
@@ -16967,17 +16967,17 @@ NodePlatformAdapter
## packagedAppOptions — function @experimental
```
-(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples" | "quality">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces" | "neutral"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
+(config: Pick<PackagedGameConfig, "colorSpace" | "depthLayers" | "msaaSamples" | "outputTransform" | "quality" | "screenFit" | "ySortLayers">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "aces" | "neutral" | "none"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
```
## packagedRuntimeInit — function @experimental
```
-(config: Pick<PackagedGameConfig, "physicsEnabled" | "physicsConfig" | "physics3dBackend" | "physics3dWorld" | "audioConfig" | "uiTheme" | "uiThemeColors" | "achievements" | "steamAppId" | "screenFit" | "aot" | "debugChannel" | "runtime">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
+(config: Pick<PackagedGameConfig, "achievements" | "aot" | "audioConfig" | "debugChannel" | "physics3dBackend" | "physics3dWorld" | "physicsConfig" | "physicsEnabled" | "runtime" | "screenFit" | "steamAppId" | "uiTheme" | "uiThemeColors">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
```
## paintWeights — function @experimental
```
-(h: number, ny: number, t: Pick<TerrainData, "rockSlope" | "dirtHeight" | "snowHeight">): [number, number, number, number]
+(h: number, ny: number, t: Pick<TerrainData, "dirtHeight" | "rockSlope" | "snowHeight">): [number, number, number, number]
```
## panoramaDirection — function @experimental
@@ -17172,7 +17172,7 @@ ParticlePlugin
## planeSecond — function @experimental
```
-(position: { y: number; z?: number; }, plane: "xz" | "xy"): number
+(position: { y: number; z?: number; }, plane: "xy" | "xz"): number
```
## planetPlugin — const @experimental
@@ -17392,7 +17392,7 @@ PrefabsPlugin
## q — const @experimental
```
-{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "z" | "w">): number; scaled(a: Quat, t: number): Quat; }
+{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "w" | "z">): number; scaled(a: Quat, t: number): Quat; }
```
## quadraticBezier — function @experimental
@@ -18087,7 +18087,7 @@ ServicesPlugin
## setTreeViewData — function @beta
```
-<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "item" | "dragHandle" | "canDrop" | "onDrop">): () => void
+<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "canDrop" | "dragHandle" | "item" | "onDrop">): () => void
```
## setUIVisible — function @experimental
@@ -18612,7 +18612,7 @@ UIVisibilityPlugin
## updateAnimatorLayer — function @experimental
```
-(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "name" | "weight" | "blend" | "mask">): AnimatorControllerDef
+(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "blend" | "mask" | "name" | "weight">): AnimatorControllerDef
```
## updateAnimatorParam — function @experimental
diff --git a/sdk/etc/logic.api.md b/sdk/etc/logic.api.md
index 41fc2e5e3..451d302df 100644
--- a/sdk/etc/logic.api.md
+++ b/sdk/etc/logic.api.md
@@ -107,7 +107,7 @@ static prototype: ScriptGraphPlugin
default: ScriptValue | undefined
label: string | undefined
name: string
-type: "string" | "number" | "bool" | "entity" | "any"
+type: "any" | "bool" | "entity" | "number" | "string"
```
## ScriptGraphSignature — interface @experimental
@@ -120,7 +120,7 @@ outputs: readonly ScriptGraphPort[]
```
default: ScriptValue | undefined
name: string
-type: "string" | "number" | "bool" | "entity"
+type: "bool" | "entity" | "number" | "string"
```
## ScriptGraphWorldView — interface @experimental
diff --git a/sdk/etc/minigame.api.md b/sdk/etc/minigame.api.md
index 7cfb8bbb6..20e1ebf28 100644
--- a/sdk/etc/minigame.api.md
+++ b/sdk/etc/minigame.api.md
@@ -220,7 +220,7 @@ world: World
label: string | undefined
name: string
tooltip: string | undefined
-type: "string" | "number" | "bool" | "entity"
+type: "bool" | "entity" | "number" | "string"
```
## AiOutputs — type @experimental
@@ -238,7 +238,7 @@ options: readonly { label: string; value: string; }[] | undefined
optionsSource: string | undefined
step: number | undefined
tooltip: string | undefined
-type: "string" | "number" | "bool" | "enum"
+type: "bool" | "enum" | "number" | "string"
```
## AiParamValue — type @experimental
@@ -896,7 +896,7 @@ type: AssetFieldType
```
alwaysInclude: boolean | undefined
folder: string
-mode: "local" | "subpackage" | "remote"
+mode: "local" | "remote" | "subpackage"
```
## AssetGroupMode — type @experimental
@@ -1154,7 +1154,7 @@ ResourceDef<AudioAPI>
## AudioAPI — class @experimental
```
-@internal getVoiceState: (handle: AudioHandle) => "playing" | "paused" | "ended" | "stopped" | "untracked"
+@internal getVoiceState: (handle: AudioHandle) => "ended" | "paused" | "playing" | "stopped" | "untracked"
@internal onPlaybackStop: (callback: (generation: number) => void) => () => void
@internal playbackGeneration: number
baseUrl: string
@@ -2672,7 +2672,7 @@ loadRadius: number
make: (cx: number, cz: number, signal: AbortSignal) => T | null | Promise<T | null>
originX: number
originZ: number
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
publish: (cx: number, cz: number, value: T) => void
release: (cx: number, cz: number, value: T) => void
sizeX: number
@@ -3157,7 +3157,7 @@ ComponentDef<{}>
background: UIVisualInit | undefined
data: DataSource<T> | readonly T[]
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
item: ListItemTemplate<T> | Record<string, ListItemTemplate<T>>
@@ -4466,7 +4466,7 @@ paint: (x: number, z: number, h: number, ny: number) => LayerWeights
splats: () => { a: Splat | null; b: Splat | null; }
toData: () => FieldSourceData
static fromData: (d: FieldSourceData) => FieldSource
-static new (field: Heightfield, data: Pick<TerrainData, "sizeX" | "sizeZ" | "height" | "rockSlope" | "dirtHeight" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
+static new (field: Heightfield, data: Pick<TerrainData, "dirtHeight" | "height" | "rockSlope" | "sizeX" | "sizeZ" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
static prototype: FieldSource
```
@@ -4489,7 +4489,7 @@ Top = 3
## FilterEffectDef — interface @experimental
```
-filter: "lowpass" | "highpass" | "bandpass" | "lowshelf" | "highshelf" | "peaking" | "notch"
+filter: "bandpass" | "highpass" | "highshelf" | "lowpass" | "lowshelf" | "notch" | "peaking"
frequency: number
gainDb: number | undefined
q: number | undefined
@@ -5956,7 +5956,7 @@ spacing: number
accepted: boolean
environmentSunAim: [number, number, number] | null
limit: number
-refusal: "none" | "capacity" | "no-environment-sun"
+refusal: "capacity" | "no-environment-sun" | "none"
refusedCount: number
requested: number
```
@@ -6090,7 +6090,7 @@ sceneName: string | undefined
source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
@@ -6641,7 +6641,7 @@ startGyroscope: ((options: SensorOptions) => void) | undefined
stopAccelerometer: ((options: Callbacks) => void) | undefined
stopGyroscope: ((options: Callbacks) => void) | undefined
vibrateLong: ((options: Callbacks) => void) | undefined
-vibrateShort: ((options: Callbacks & { type: "light" | "medium" | "heavy"; }) => void) | undefined
+vibrateShort: ((options: Callbacks & { type: "heavy" | "light" | "medium"; }) => void) | undefined
```
## MiniGameImage — interface @experimental
@@ -6754,7 +6754,7 @@ data: string | ArrayBuffer | undefined
fail: ((err: { errMsg: string; }) => void) | undefined
header: Record<string, string> | undefined
method: string | undefined
-responseType: "text" | "arraybuffer" | undefined
+responseType: "arraybuffer" | "text" | undefined
success: ((res: { statusCode: number; header?: Record<string, string>; data: string | ArrayBuffer; }) => void) | undefined
timeout: number | undefined
url: string
@@ -6782,7 +6782,7 @@ screenFit: { designWidth: number; designHeight: number; scaleMode: number; match
sideModuleFactories: Partial<Record<SideModuleId, EmscriptenFactory>> | undefined
sideModuleSuffix: string | undefined
sideModules: { id: string; file: string; globalName?: string; }[] | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
ySortLayers: number | undefined
```
@@ -7045,7 +7045,7 @@ send: (data: string | ArrayBuffer) => void
## NodeParamSpec — interface @beta
```
key: string
-kind: "texture" | "text" | "bool" | "float" | "color" | "channel"
+kind: "bool" | "channel" | "color" | "float" | "text" | "texture"
label: string
```
@@ -7191,7 +7191,7 @@ entryScene: string
hotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined
leaderboardEncryptionKey: string | undefined
msaaSamples: number | undefined
-outputTransform: "none" | "aces" | "neutral" | undefined
+outputTransform: "aces" | "neutral" | "none" | undefined
physics3dBackend: Physics3DBackend | undefined
physics3dWorld: Partial<Physics3DWorldConfig> | undefined
physicsConfig: Physics2DPluginConfig | undefined
@@ -7206,7 +7206,7 @@ sideModules: { id: string; file: string; globalName?: string; }[] | undefined
steamAppId: number | undefined
uiTheme: "light" | undefined
uiThemeColors: Record<string, string> | undefined
-webChannel: "poki" | "crazygames" | "youtube" | undefined
+webChannel: "crazygames" | "poki" | "youtube" | undefined
worlds: { scene: string; manifest: string; }[] | undefined
ySortLayers: number | undefined
```
@@ -7233,7 +7233,7 @@ used: number
## PageDef — interface @experimental
```
mount: number | (() => Entity) | undefined
-onClose: "keep" | "destroy" | undefined
+onClose: "destroy" | "keep" | undefined
overrides: PrefabOverride[] | undefined
parent: number | (() => Entity) | undefined
prefab: string
@@ -7299,7 +7299,7 @@ filter: "linear" | "nearest" | undefined
mipmaps: boolean | undefined
sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
srgb: boolean | undefined
-wrap: "repeat" | "clamp" | "mirror" | undefined
+wrap: "clamp" | "mirror" | "repeat" | undefined
```
## Particle — const @experimental
@@ -7877,7 +7877,7 @@ kind: string
## Placement — interface @experimental
```
-attach: "upright" | "align"
+attach: "align" | "upright"
biome: string
canopy: number
far: { u0: number; v0: number; u1: number; v1: number; tent?: boolean; } | null | undefined
@@ -7972,7 +7972,7 @@ bytes: number | undefined
draws: number | undefined
height: number | undefined
rejected: number | undefined
-state: "unavailable" | "inactive" | "budget-excluded" | "ready"
+state: "budget-excluded" | "inactive" | "ready" | "unavailable"
updated: boolean | undefined
width: number | undefined
```
@@ -8042,7 +8042,7 @@ world: string
## PlanetStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## Planets — class @experimental
@@ -8214,8 +8214,8 @@ title: string | undefined
```
body: string | ArrayBuffer | undefined
headers: Record<string, string> | undefined
-method: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "OPTIONS" | undefined
-responseType: "json" | "text" | "arraybuffer" | undefined
+method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "POST" | "PUT" | undefined
+responseType: "arraybuffer" | "json" | "text" | undefined
timeout: number | undefined
```
@@ -8358,7 +8358,7 @@ physicsEnabled: boolean | undefined
remoteRoot: string | undefined
runtime: RuntimeBuildConfig | undefined
sceneData: SceneData
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
wasmBaseUrl: string | undefined
```
@@ -8390,7 +8390,7 @@ physicsEnabled: boolean | undefined
prewarmShaders: { timeoutMs?: number; } | undefined
runtime: RuntimeBuildConfig | undefined
scenes: { name: string; data: SceneData; }[]
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
ySortLayers: number | undefined
```
@@ -8595,7 +8595,7 @@ weight: number
```
ceiling: PowerLevel | null
fps: number
-reason: "none" | "battery" | "thermal" | "critical"
+reason: "battery" | "critical" | "none" | "thermal"
saving: boolean
```
@@ -8610,14 +8610,14 @@ ceiling: PowerLevel | undefined
fps: number | undefined
lowBattery: number | undefined
severe: "critical" | "never" | undefined
-thermal: "critical" | "serious" | "never" | undefined
+thermal: "critical" | "never" | "serious" | undefined
```
## PowerState — interface @experimental
```
charging: boolean | null
level: number | null
-thermal: "critical" | "serious" | "nominal" | "fair" | null
+thermal: "critical" | "fair" | "nominal" | "serious" | null
```
## PreSceneDrawCallback — type @experimental
@@ -8700,7 +8700,7 @@ componentType: string | undefined
metadataKey: string | undefined
prefabEntityId: string
propertyName: string | undefined
-type: "property" | "component_added" | "component_replaced" | "component_removed" | "name" | "visibility" | "parent" | "metadata_set" | "metadata_removed"
+type: "component_added" | "component_removed" | "component_replaced" | "metadata_removed" | "metadata_set" | "name" | "parent" | "property" | "visibility"
value: unknown
```
@@ -8993,7 +8993,7 @@ depthPrepass: boolean
detailScale: number
drawCallBudget: number
dynamicGIReduced: boolean
-lighting: "full" | "direct"
+lighting: "direct" | "full"
minRenderScale: number
msaaSamples: 2 | 1 | 4 | 8
particleLimit: number
@@ -9239,7 +9239,7 @@ version: number
## RecipeMember — interface @experimental
```
arc: readonly [number, number] | undefined
-attach: "upright" | "align" | undefined
+attach: "align" | "upright" | undefined
canopy: number | undefined
chance: number | undefined
count: readonly [number, number] | undefined
@@ -9740,7 +9740,7 @@ source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
steamAppId: number | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
worlds: WorldManifest[] | undefined
```
@@ -10289,7 +10289,7 @@ setContentSize: (size: Vec2) => void
background: UIVisualInit | undefined
contentSize: Vec2
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
node: UINodeInit | undefined
@@ -10420,7 +10420,7 @@ size: Vec2
deniedCasters: number
granted: number
reducedCasters: number
-refusal: "none" | "tile-budget" | "tile-too-large" | "atlas-full"
+refusal: "atlas-full" | "none" | "tile-budget" | "tile-too-large"
requested: number
```
@@ -11302,7 +11302,7 @@ VisibleOutside = 2
nestedAt: string | undefined
override: PrefabOverride
reason: string
-site: "variant" | "nested" | "instance"
+site: "instance" | "nested" | "variant"
```
## StaticBatch — const @experimental
@@ -12025,7 +12025,7 @@ region: ((x0: number, z0: number, spacing: number, count: number) => TerrainRegi
## TerrainStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## TerrainTileEntry — interface @experimental
@@ -12260,7 +12260,7 @@ static prototype: TextInputPlugin
```
horizontalOverflow: boolean
metrics: TextMetrics | null
-unsupported: "rich-text" | "custom-font" | "complex-script" | "invalid-box" | null
+unsupported: "complex-script" | "custom-font" | "invalid-box" | "rich-text" | null
verticalOverflow: boolean
```
@@ -12879,7 +12879,7 @@ duration: number | undefined
keepPersistent: boolean | undefined
onComplete: (() => void) | undefined
onStart: (() => void) | undefined
-transition: "none" | "fade" | undefined
+transition: "fade" | "none" | undefined
```
## TreeDataSource — interface @beta
@@ -12894,7 +12894,7 @@ subscribe: ((listener: () => void) => Unsubscribe) | undefined
## TreeDropRequest — interface @beta
```
-position: "before" | "inside" | "after"
+position: "after" | "before" | "inside"
source: TreeRow<T>
target: TreeRow<T>
```
@@ -13685,7 +13685,7 @@ type: DataType
## VibrationOptions — interface @experimental
```
-duration: "short" | "long" | undefined
+duration: "long" | "short" | undefined
intensity: VibrationIntensity | undefined
```
@@ -14434,7 +14434,7 @@ Generator<number, T, void>
```
@internal addressOfComponent: (component: AnyComponentDef, entity: Entity) => number | undefined
@internal addressResolver: (component: AnyComponentDef) => (entity: Entity) => number | undefined
-@internal advanceMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number, through: number) => void
+@internal advanceMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number, through: number) => void
@internal advanceRemovedCursorReader: (component: AnyComponentDef, readerId: number, through: number) => void
@internal advanceRemovedReader: (component: AnyComponentDef, readerId: number, lastRunTick: number) => void
@internal advanceTick: () => void
@@ -14453,7 +14453,7 @@ Generator<number, T, void>
@internal compositionChanges: () => CompositionDelta | null
@internal connectCpp: (cppRegistry: CppRegistry, module?: ESEngineModule, options?: BridgeConnectOptions) => void
@internal disconnectCpp: () => void
-@internal disposeMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => void
+@internal disposeMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => void
@internal disposeRemovedReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeTopologyReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeWriteReader: (component: AnyComponentDef, readerId: number) => void
@@ -14488,16 +14488,16 @@ Generator<number, T, void>
@internal isIterating: () => boolean
@internal layoutEpoch: () => number | null
@internal markChanged: (entity: Entity, component: AnyComponentDef) => void
-@internal mutationRevision: (component: AnyComponentDef, kind: "write" | "topology") => number
-@internal mutationSequence: (kind: "write" | "topology") => number
-@internal mutationsForCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => Entity[]
+@internal mutationRevision: (component: AnyComponentDef, kind: "topology" | "write") => number
+@internal mutationSequence: (kind: "topology" | "write") => number
+@internal mutationsForCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => Entity[]
@internal onCoreDisconnect: (dispose: () => void) => () => void
@internal openSpeculation: (log: { record(world: World, entity: Entity, component: AnyComponentDef): void; }) => void
@internal queries_: QueryCache
@internal queryCostEnabled: boolean
@internal queryEntities: (components: AnyComponentDef[], withFilters?: AnyComponentDef[], withoutFilters?: AnyComponentDef[], precomputedKey?: string, filter?: QueryFilter, precomputedDepIds?: symbol[]) => readonly Entity[]
@internal refreshBuiltinMembership: (entity: Entity, component: AnyComponentDef) => void
-@internal registerMutationCursor: (component: AnyComponentDef, kind: "write" | "topology") => number
+@internal registerMutationCursor: (component: AnyComponentDef, kind: "topology" | "write") => number
@internal registerRemovedCursorReader: (component: AnyComponentDef) => number
@internal registerRemovedReader: (component: AnyComponentDef) => number
@internal registerRemovedReaderFrom: (component: AnyComponentDef, retainFromTick: number) => number
@@ -14605,7 +14605,7 @@ ResourceDef<WorldGens>
```
layers: Record<string, ChunkLayerStatus>
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## WorldGens — class @experimental
@@ -14629,7 +14629,7 @@ static prototype: WorldGens
cellSize: number
cells: WorldCell[]
persistentRefs: number[]
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
scene: string
version: number
```
@@ -14641,7 +14641,7 @@ cells: PartitionedCell[]
errors: string[]
persistent: SceneData
persistentRefs: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
warnings: string[]
```
@@ -14704,7 +14704,7 @@ loadCount: number
loadingCells: string[]
persistentEntities: number
persistentHandles: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
prefetchCells: string[]
prefetchHits: number
prefetchMisses: number
@@ -16840,7 +16840,7 @@ InputRouter
## isDialogOpen — function @experimental
```
-(world: Pick<World, "has" | "get">, root: Entity): boolean
+(world: Pick<World, "get" | "has">, root: Entity): boolean
```
## isDropdownOpen — function @experimental
@@ -16890,7 +16890,7 @@ InputRouter
## isPointerBlockedInTree — function @experimental
```
-(world: Pick<World, "has" | "get" | "valid">, entity: Entity): boolean
+(world: Pick<World, "get" | "has" | "valid">, entity: Entity): boolean
```
## isPrefabEntry — function @experimental
@@ -17055,7 +17055,7 @@ Logger
## manifestPlane — function @experimental
```
-(manifest: { plane?: "xz" | "xy"; } | null): "xz" | "xy"
+(manifest: { plane?: "xy" | "xz"; } | null): "xy" | "xz"
```
## markThemed — function @experimental
@@ -17275,17 +17275,17 @@ MeshRendererPlugin
## packagedAppOptions — function @experimental
```
-(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples" | "quality">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces" | "neutral"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
+(config: Pick<PackagedGameConfig, "colorSpace" | "depthLayers" | "msaaSamples" | "outputTransform" | "quality" | "screenFit" | "ySortLayers">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "aces" | "neutral" | "none"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
```
## packagedRuntimeInit — function @experimental
```
-(config: Pick<PackagedGameConfig, "physicsEnabled" | "physicsConfig" | "physics3dBackend" | "physics3dWorld" | "audioConfig" | "uiTheme" | "uiThemeColors" | "achievements" | "steamAppId" | "screenFit" | "aot" | "debugChannel" | "runtime">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
+(config: Pick<PackagedGameConfig, "achievements" | "aot" | "audioConfig" | "debugChannel" | "physics3dBackend" | "physics3dWorld" | "physicsConfig" | "physicsEnabled" | "runtime" | "screenFit" | "steamAppId" | "uiTheme" | "uiThemeColors">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
```
## paintWeights — function @experimental
```
-(h: number, ny: number, t: Pick<TerrainData, "rockSlope" | "dirtHeight" | "snowHeight">): [number, number, number, number]
+(h: number, ny: number, t: Pick<TerrainData, "dirtHeight" | "rockSlope" | "snowHeight">): [number, number, number, number]
```
## panoramaDirection — function @experimental
@@ -17480,7 +17480,7 @@ ParticlePlugin
## planeSecond — function @experimental
```
-(position: { y: number; z?: number; }, plane: "xz" | "xy"): number
+(position: { y: number; z?: number; }, plane: "xy" | "xz"): number
```
## planetPlugin — const @experimental
@@ -17700,7 +17700,7 @@ PrefabsPlugin
## q — const @experimental
```
-{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "z" | "w">): number; scaled(a: Quat, t: number): Quat; }
+{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "w" | "z">): number; scaled(a: Quat, t: number): Quat; }
```
## quadraticBezier — function @experimental
@@ -18395,7 +18395,7 @@ ServicesPlugin
## setTreeViewData — function @beta
```
-<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "item" | "dragHandle" | "canDrop" | "onDrop">): () => void
+<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "canDrop" | "dragHandle" | "item" | "onDrop">): () => void
```
## setUIVisible — function @experimental
@@ -18920,7 +18920,7 @@ UIVisibilityPlugin
## updateAnimatorLayer — function @experimental
```
-(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "name" | "weight" | "blend" | "mask">): AnimatorControllerDef
+(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "blend" | "mask" | "name" | "weight">): AnimatorControllerDef
```
## updateAnimatorParam — function @experimental
diff --git a/sdk/etc/openpaas.api.md b/sdk/etc/openpaas.api.md
index c63d7d25b..c9f6c20dc 100644
--- a/sdk/etc/openpaas.api.md
+++ b/sdk/etc/openpaas.api.md
@@ -8,7 +8,7 @@ Symbols: 0 public · 0 beta · 4 experimental · 0 deprecated
WebAssembly: { instantiateFromFile?(path: string, imports: WebAssembly.Imports): Promise<WasmInstantiateResult>; }
WebSocket: { new (url: string | URL, protocols?: string | string[]): WebSocket; prototype: WebSocket; readonly CONNECTING: 0; readonly OPEN: 1; readonly CLOSING: 2; readonly CLOSED: 3; }
XMLHttpRequest: { new (): XMLHttpRequest; prototype: XMLHttpRequest; readonly UNSENT: 0; readonly OPENED: 1; readonly HEADERS_RECEIVED: 2; readonly LOADING: 3; readonly DONE: 4; }
-localStorage: Pick<Storage, "length" | "getItem" | "setItem" | "removeItem" | "key">
+localStorage: Pick<Storage, "getItem" | "key" | "length" | "removeItem" | "setItem">
sud: OpenPaaSHost
```
diff --git a/sdk/etc/physics3d.api.md b/sdk/etc/physics3d.api.md
index f1319380d..e9c2ddc03 100644
--- a/sdk/etc/physics3d.api.md
+++ b/sdk/etc/physics3d.api.md
@@ -124,7 +124,7 @@ restitution: number
```
halfExtents: Vec3 | undefined
halfHeight: number | undefined
-kind: "box" | "sphere" | "capsule"
+kind: "box" | "capsule" | "sphere"
position: Vec3
radius: number | undefined
rotation: Quat
diff --git a/sdk/etc/session.api.md b/sdk/etc/session.api.md
index b3a8d3f2e..05cc774e0 100644
--- a/sdk/etc/session.api.md
+++ b/sdk/etc/session.api.md
@@ -360,7 +360,7 @@ authenticate: (credentials: unknown, connection: AcceptedConnection) => Ctx | Pr
heartbeat: false | { intervalMs: number; timeoutMs: number; } | undefined
helloTimeoutMs: number | undefined
idempotency: IdempotencyStore | undefined
-limits: Pick<NetLimitOptions, "maxFrameBytes" | "messagesPerSecond" | "burst"> | undefined
+limits: Pick<NetLimitOptions, "burst" | "maxFrameBytes" | "messagesPerSecond"> | undefined
maxSessions: number | undefined
maxViolationsPerMinute: number | undefined
requestTimeoutMs: number | undefined
diff --git a/sdk/etc/sound.api.md b/sdk/etc/sound.api.md
index bcd754ff8..d869c058e 100644
--- a/sdk/etc/sound.api.md
+++ b/sdk/etc/sound.api.md
@@ -81,7 +81,7 @@ pedal: boolean | undefined
release: number | undefined
reverb: number | undefined
samples: readonly MusicSample[] | undefined
-scale: "pentatonic" | "pentatonicMinor" | "gong" | "shang" | "jue" | "zhi" | "yu" | "major" | "minor" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "harmonic" | undefined
+scale: "dorian" | "gong" | "harmonic" | "jue" | "lydian" | "major" | "minor" | "mixolydian" | "pentatonic" | "pentatonicMinor" | "phrygian" | "shang" | "yu" | "zhi" | undefined
```
## MusicPattern — interface @experimental
@@ -96,7 +96,7 @@ tracks: Readonly<Record<string, string>>
## MusicSample — interface @experimental
```
cutoff: number | undefined
-dynamic: "normal" | "soft" | "loud" | undefined
+dynamic: "loud" | "normal" | "soft" | undefined
file: string
gain: number | undefined
high: string | number | undefined
@@ -122,7 +122,7 @@ patterns: Readonly<Record<string, MusicPattern>>
rate: number | undefined
reverb: { size?: number; mix?: number; } | undefined
rubato: number | undefined
-scale: "pentatonic" | "pentatonicMinor" | "gong" | "shang" | "jue" | "zhi" | "yu" | "major" | "minor" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "harmonic" | undefined
+scale: "dorian" | "gong" | "harmonic" | "jue" | "lydian" | "major" | "minor" | "mixolydian" | "pentatonic" | "pentatonicMinor" | "phrygian" | "shang" | "yu" | "zhi" | undefined
seed: number | undefined
song: readonly SongPart[]
stems: boolean | undefined
@@ -239,7 +239,7 @@ number | readonly (readonly [number, number])[]
freq: SoundCurve
gain: number | undefined
q: number | undefined
-type: "lowpass" | "highpass" | "bandpass" | "notch" | "peak"
+type: "bandpass" | "highpass" | "lowpass" | "notch" | "peak"
```
## SoundJob — interface @experimental
@@ -253,7 +253,7 @@ source: string
```
attack: number | undefined
band: readonly [number, number] | undefined
-color: "white" | "pink" | "brown" | undefined
+color: "brown" | "pink" | "white" | undefined
decay: number | undefined
drive: number | undefined
file: string | undefined
@@ -272,7 +272,7 @@ release: number | undefined
repeat: { count: number; every: number; gain?: number; pitch?: number; jitter?: number; faster?: number; } | undefined
scatter: { count: number; over: number; early?: number; pitch?: readonly [number, number]; gain?: readonly [number, number]; pan?: number; fade?: number; } | undefined
seed: number | undefined
-source: "noise" | "square" | "group" | "sine" | "triangle" | "saw" | "modes" | "impulse" | "sample"
+source: "group" | "impulse" | "modes" | "noise" | "sample" | "saw" | "sine" | "square" | "triangle"
speed: number | undefined
start: number | undefined
tail: { decay: number; mix: number; } | undefined
@@ -398,7 +398,7 @@ octave: number
## placeResponse — function @experimental
```
-(rate: number, size: number, kind: "room" | "open", side: number): Float32Array
+(rate: number, size: number, kind: "open" | "room", side: number): Float32Array
```
## renderMusic — function @experimental
diff --git a/sdk/etc/spine.api.md b/sdk/etc/spine.api.md
index 08f58a202..2b1c959bc 100644
--- a/sdk/etc/spine.api.md
+++ b/sdk/etc/spine.api.md
@@ -71,7 +71,7 @@ minY: number
```
blockedBy: readonly SpineDeferralBlocker[]
entities: number
-envelope: "unknown" | "certified" | "observed"
+envelope: "certified" | "observed" | "unknown"
era: string
mayDefer: boolean
pair: SpinePair
diff --git a/sdk/etc/terrain.api.md b/sdk/etc/terrain.api.md
index 3d8978903..7412303db 100644
--- a/sdk/etc/terrain.api.md
+++ b/sdk/etc/terrain.api.md
@@ -53,13 +53,13 @@ paint: (x: number, z: number, h: number, ny: number) => LayerWeights
splats: () => { a: Splat | null; b: Splat | null; }
toData: () => FieldSourceData
static fromData: (d: FieldSourceData) => FieldSource
-static new (field: Heightfield, data: Pick<TerrainData, "sizeX" | "sizeZ" | "height" | "rockSlope" | "dirtHeight" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
+static new (field: Heightfield, data: Pick<TerrainData, "dirtHeight" | "height" | "rockSlope" | "sizeX" | "sizeZ" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
static prototype: FieldSource
```
## GroundEdit — class @experimental
```
-apply: (patch: GroundPatch, side: "before" | "after") => void
+apply: (patch: GroundPatch, side: "after" | "before") => void
area: { sizeX: number; sizeZ: number; }
begin: () => void
end: () => GroundPatch | null
@@ -351,7 +351,7 @@ paint: Float32Array<ArrayBufferLike> | undefined
## PlanetStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## Planets — class @experimental
@@ -420,7 +420,7 @@ step: number | undefined
cells: number
length: number
path: { x: number; y: number; z: number; }[]
-state: "noGround" | "reached" | "unreachable" | "exhausted"
+state: "exhausted" | "noGround" | "reached" | "unreachable"
```
## SculptDab — interface @experimental
@@ -620,7 +620,7 @@ region: ((x0: number, z0: number, spacing: number, count: number) => TerrainRegi
## TerrainStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## TerrainUnavailable — class @experimental
@@ -671,7 +671,7 @@ ResourceDef<Terrains>
## TiledGroundEdit — class @experimental
```
-apply: (patch: TiledGroundPatch, side: "before" | "after") => void
+apply: (patch: TiledGroundPatch, side: "after" | "before") => void
area: { sizeX: number; sizeZ: number; }
begin: () => void
end: () => TiledGroundPatch | null
@@ -840,7 +840,7 @@ tiles: Map<string, Arrays>
## paintWeights — function @experimental
```
-(h: number, ny: number, t: Pick<TerrainData, "rockSlope" | "dirtHeight" | "snowHeight">): [number, number, number, number]
+(h: number, ny: number, t: Pick<TerrainData, "dirtHeight" | "rockSlope" | "snowHeight">): [number, number, number, number]
```
## parentOf — function @experimental
diff --git a/sdk/etc/tilemap.api.md b/sdk/etc/tilemap.api.md
index abdd0039b..8d5495a8b 100644
--- a/sdk/etc/tilemap.api.md
+++ b/sdk/etc/tilemap.api.md
@@ -998,7 +998,7 @@ tileTerrain: Map<number, number>
## tiledCollisionMods — function @experimental
```
-(props: Array<Record<string, unknown>> | undefined): Partial<Pick<ResolvedTileCollision, "oneWay" | "sensor" | "density" | "friction" | "restitution">>
+(props: Array<Record<string, unknown>> | undefined): Partial<Pick<ResolvedTileCollision, "density" | "friction" | "oneWay" | "restitution" | "sensor">>
```
## tiledObjectgroupShape — function @experimental
diff --git a/sdk/etc/wechat.api.md b/sdk/etc/wechat.api.md
index 33db9a710..426924a7a 100644
--- a/sdk/etc/wechat.api.md
+++ b/sdk/etc/wechat.api.md
@@ -220,7 +220,7 @@ world: World
label: string | undefined
name: string
tooltip: string | undefined
-type: "string" | "number" | "bool" | "entity"
+type: "bool" | "entity" | "number" | "string"
```
## AiOutputs — type @experimental
@@ -238,7 +238,7 @@ options: readonly { label: string; value: string; }[] | undefined
optionsSource: string | undefined
step: number | undefined
tooltip: string | undefined
-type: "string" | "number" | "bool" | "enum"
+type: "bool" | "enum" | "number" | "string"
```
## AiParamValue — type @experimental
@@ -896,7 +896,7 @@ type: AssetFieldType
```
alwaysInclude: boolean | undefined
folder: string
-mode: "local" | "subpackage" | "remote"
+mode: "local" | "remote" | "subpackage"
```
## AssetGroupMode — type @experimental
@@ -1154,7 +1154,7 @@ ResourceDef<AudioAPI>
## AudioAPI — class @experimental
```
-@internal getVoiceState: (handle: AudioHandle) => "playing" | "paused" | "ended" | "stopped" | "untracked"
+@internal getVoiceState: (handle: AudioHandle) => "ended" | "paused" | "playing" | "stopped" | "untracked"
@internal onPlaybackStop: (callback: (generation: number) => void) => () => void
@internal playbackGeneration: number
baseUrl: string
@@ -2672,7 +2672,7 @@ loadRadius: number
make: (cx: number, cz: number, signal: AbortSignal) => T | null | Promise<T | null>
originX: number
originZ: number
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
publish: (cx: number, cz: number, value: T) => void
release: (cx: number, cz: number, value: T) => void
sizeX: number
@@ -3157,7 +3157,7 @@ ComponentDef<{}>
background: UIVisualInit | undefined
data: DataSource<T> | readonly T[]
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
item: ListItemTemplate<T> | Record<string, ListItemTemplate<T>>
@@ -4466,7 +4466,7 @@ paint: (x: number, z: number, h: number, ny: number) => LayerWeights
splats: () => { a: Splat | null; b: Splat | null; }
toData: () => FieldSourceData
static fromData: (d: FieldSourceData) => FieldSource
-static new (field: Heightfield, data: Pick<TerrainData, "sizeX" | "sizeZ" | "height" | "rockSlope" | "dirtHeight" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
+static new (field: Heightfield, data: Pick<TerrainData, "dirtHeight" | "height" | "rockSlope" | "sizeX" | "sizeZ" | "snowHeight">, splat: Splat | null, flow: Float32Array | null, range?: readonly [number, number], splat2?: Splat | null): FieldSource
static prototype: FieldSource
```
@@ -4489,7 +4489,7 @@ Top = 3
## FilterEffectDef — interface @experimental
```
-filter: "lowpass" | "highpass" | "bandpass" | "lowshelf" | "highshelf" | "peaking" | "notch"
+filter: "bandpass" | "highpass" | "highshelf" | "lowpass" | "lowshelf" | "notch" | "peaking"
frequency: number
gainDb: number | undefined
q: number | undefined
@@ -5963,7 +5963,7 @@ spacing: number
accepted: boolean
environmentSunAim: [number, number, number] | null
limit: number
-refusal: "none" | "capacity" | "no-environment-sun"
+refusal: "capacity" | "no-environment-sun" | "none"
refusedCount: number
requested: number
```
@@ -6097,7 +6097,7 @@ sceneName: string | undefined
source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
```
@@ -6755,7 +6755,7 @@ send: (data: string | ArrayBuffer) => void
## NodeParamSpec — interface @beta
```
key: string
-kind: "texture" | "text" | "bool" | "float" | "color" | "channel"
+kind: "bool" | "channel" | "color" | "float" | "text" | "texture"
label: string
```
@@ -6901,7 +6901,7 @@ entryScene: string
hotUpdate: { remoteRoot?: string; persistUpdateKey?: string; } | undefined
leaderboardEncryptionKey: string | undefined
msaaSamples: number | undefined
-outputTransform: "none" | "aces" | "neutral" | undefined
+outputTransform: "aces" | "neutral" | "none" | undefined
physics3dBackend: Physics3DBackend | undefined
physics3dWorld: Partial<Physics3DWorldConfig> | undefined
physicsConfig: Physics2DPluginConfig | undefined
@@ -6916,7 +6916,7 @@ sideModules: { id: string; file: string; globalName?: string; }[] | undefined
steamAppId: number | undefined
uiTheme: "light" | undefined
uiThemeColors: Record<string, string> | undefined
-webChannel: "poki" | "crazygames" | "youtube" | undefined
+webChannel: "crazygames" | "poki" | "youtube" | undefined
worlds: { scene: string; manifest: string; }[] | undefined
ySortLayers: number | undefined
```
@@ -6943,7 +6943,7 @@ used: number
## PageDef — interface @experimental
```
mount: number | (() => Entity) | undefined
-onClose: "keep" | "destroy" | undefined
+onClose: "destroy" | "keep" | undefined
overrides: PrefabOverride[] | undefined
parent: number | (() => Entity) | undefined
prefab: string
@@ -7009,7 +7009,7 @@ filter: "linear" | "nearest" | undefined
mipmaps: boolean | undefined
sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
srgb: boolean | undefined
-wrap: "repeat" | "clamp" | "mirror" | undefined
+wrap: "clamp" | "mirror" | "repeat" | undefined
```
## Particle — const @experimental
@@ -7587,7 +7587,7 @@ kind: string
## Placement — interface @experimental
```
-attach: "upright" | "align"
+attach: "align" | "upright"
biome: string
canopy: number
far: { u0: number; v0: number; u1: number; v1: number; tent?: boolean; } | null | undefined
@@ -7682,7 +7682,7 @@ bytes: number | undefined
draws: number | undefined
height: number | undefined
rejected: number | undefined
-state: "unavailable" | "inactive" | "budget-excluded" | "ready"
+state: "budget-excluded" | "inactive" | "ready" | "unavailable"
updated: boolean | undefined
width: number | undefined
```
@@ -7752,7 +7752,7 @@ world: string
## PlanetStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## Planets — class @experimental
@@ -7924,8 +7924,8 @@ title: string | undefined
```
body: string | ArrayBuffer | undefined
headers: Record<string, string> | undefined
-method: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "OPTIONS" | undefined
-responseType: "json" | "text" | "arraybuffer" | undefined
+method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "POST" | "PUT" | undefined
+responseType: "arraybuffer" | "json" | "text" | undefined
timeout: number | undefined
```
@@ -8068,7 +8068,7 @@ physicsEnabled: boolean | undefined
remoteRoot: string | undefined
runtime: RuntimeBuildConfig | undefined
sceneData: SceneData
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
wasmBaseUrl: string | undefined
```
@@ -8100,7 +8100,7 @@ physicsEnabled: boolean | undefined
prewarmShaders: { timeoutMs?: number; } | undefined
runtime: RuntimeBuildConfig | undefined
scenes: { name: string; data: SceneData; }[]
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
ySortLayers: number | undefined
```
@@ -8305,7 +8305,7 @@ weight: number
```
ceiling: PowerLevel | null
fps: number
-reason: "none" | "battery" | "thermal" | "critical"
+reason: "battery" | "critical" | "none" | "thermal"
saving: boolean
```
@@ -8320,14 +8320,14 @@ ceiling: PowerLevel | undefined
fps: number | undefined
lowBattery: number | undefined
severe: "critical" | "never" | undefined
-thermal: "critical" | "serious" | "never" | undefined
+thermal: "critical" | "never" | "serious" | undefined
```
## PowerState — interface @experimental
```
charging: boolean | null
level: number | null
-thermal: "critical" | "serious" | "nominal" | "fair" | null
+thermal: "critical" | "fair" | "nominal" | "serious" | null
```
## PreSceneDrawCallback — type @experimental
@@ -8410,7 +8410,7 @@ componentType: string | undefined
metadataKey: string | undefined
prefabEntityId: string
propertyName: string | undefined
-type: "property" | "component_added" | "component_replaced" | "component_removed" | "name" | "visibility" | "parent" | "metadata_set" | "metadata_removed"
+type: "component_added" | "component_removed" | "component_replaced" | "metadata_removed" | "metadata_set" | "name" | "parent" | "property" | "visibility"
value: unknown
```
@@ -8703,7 +8703,7 @@ depthPrepass: boolean
detailScale: number
drawCallBudget: number
dynamicGIReduced: boolean
-lighting: "full" | "direct"
+lighting: "direct" | "full"
minRenderScale: number
msaaSamples: 2 | 1 | 4 | 8
particleLimit: number
@@ -8949,7 +8949,7 @@ version: number
## RecipeMember — interface @experimental
```
arc: readonly [number, number] | undefined
-attach: "upright" | "align" | undefined
+attach: "align" | "upright" | undefined
canopy: number | undefined
chance: number | undefined
count: readonly [number, number] | undefined
@@ -9450,7 +9450,7 @@ source: RuntimeAssetSource
spineManager: SpineManager | null | undefined
spineModule: SpineWasmModule | null | undefined
steamAppId: number | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
worlds: WorldManifest[] | undefined
```
@@ -9999,7 +9999,7 @@ setContentSize: (size: Vec2) => void
background: UIVisualInit | undefined
contentSize: Vec2
decelerationRate: number | undefined
-direction: "vertical" | "horizontal" | "both" | undefined
+direction: "both" | "horizontal" | "vertical" | undefined
dragScroll: boolean | undefined
host: ListViewHost
node: UINodeInit | undefined
@@ -10130,7 +10130,7 @@ size: Vec2
deniedCasters: number
granted: number
reducedCasters: number
-refusal: "none" | "tile-budget" | "tile-too-large" | "atlas-full"
+refusal: "atlas-full" | "none" | "tile-budget" | "tile-too-large"
requested: number
```
@@ -11012,7 +11012,7 @@ VisibleOutside = 2
nestedAt: string | undefined
override: PrefabOverride
reason: string
-site: "variant" | "nested" | "instance"
+site: "instance" | "nested" | "variant"
```
## StaticBatch — const @experimental
@@ -11735,7 +11735,7 @@ region: ((x0: number, z0: number, spacing: number, count: number) => TerrainRegi
## TerrainStatus — interface @experimental
```
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## TerrainTileEntry — interface @experimental
@@ -11970,7 +11970,7 @@ static prototype: TextInputPlugin
```
horizontalOverflow: boolean
metrics: TextMetrics | null
-unsupported: "rich-text" | "custom-font" | "complex-script" | "invalid-box" | null
+unsupported: "complex-script" | "custom-font" | "invalid-box" | "rich-text" | null
verticalOverflow: boolean
```
@@ -12589,7 +12589,7 @@ duration: number | undefined
keepPersistent: boolean | undefined
onComplete: (() => void) | undefined
onStart: (() => void) | undefined
-transition: "none" | "fade" | undefined
+transition: "fade" | "none" | undefined
```
## TreeDataSource — interface @beta
@@ -12604,7 +12604,7 @@ subscribe: ((listener: () => void) => Unsubscribe) | undefined
## TreeDropRequest — interface @beta
```
-position: "before" | "inside" | "after"
+position: "after" | "before" | "inside"
source: TreeRow<T>
target: TreeRow<T>
```
@@ -13395,7 +13395,7 @@ type: DataType
## VibrationOptions — interface @experimental
```
-duration: "short" | "long" | undefined
+duration: "long" | "short" | undefined
intensity: VibrationIntensity | undefined
```
@@ -14028,7 +14028,7 @@ screenFit: { designWidth: number; designHeight: number; scaleMode: number; match
sideModuleFactories: Partial<Record<SideModuleId, EmscriptenFactory>> | undefined
sideModuleSuffix: string | undefined
sideModules: { id: string; file: string; globalName?: string; }[] | undefined
-uiTheme: "light" | "dark" | undefined
+uiTheme: "dark" | "light" | undefined
uiThemeOverrides: ThemeOverrides | undefined
ySortLayers: number | undefined
```
@@ -14165,7 +14165,7 @@ Generator<number, T, void>
```
@internal addressOfComponent: (component: AnyComponentDef, entity: Entity) => number | undefined
@internal addressResolver: (component: AnyComponentDef) => (entity: Entity) => number | undefined
-@internal advanceMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number, through: number) => void
+@internal advanceMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number, through: number) => void
@internal advanceRemovedCursorReader: (component: AnyComponentDef, readerId: number, through: number) => void
@internal advanceRemovedReader: (component: AnyComponentDef, readerId: number, lastRunTick: number) => void
@internal advanceTick: () => void
@@ -14184,7 +14184,7 @@ Generator<number, T, void>
@internal compositionChanges: () => CompositionDelta | null
@internal connectCpp: (cppRegistry: CppRegistry, module?: ESEngineModule, options?: BridgeConnectOptions) => void
@internal disconnectCpp: () => void
-@internal disposeMutationCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => void
+@internal disposeMutationCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => void
@internal disposeRemovedReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeTopologyReader: (component: AnyComponentDef, readerId: number) => void
@internal disposeWriteReader: (component: AnyComponentDef, readerId: number) => void
@@ -14219,16 +14219,16 @@ Generator<number, T, void>
@internal isIterating: () => boolean
@internal layoutEpoch: () => number | null
@internal markChanged: (entity: Entity, component: AnyComponentDef) => void
-@internal mutationRevision: (component: AnyComponentDef, kind: "write" | "topology") => number
-@internal mutationSequence: (kind: "write" | "topology") => number
-@internal mutationsForCursor: (component: AnyComponentDef, kind: "write" | "topology", reader: number) => Entity[]
+@internal mutationRevision: (component: AnyComponentDef, kind: "topology" | "write") => number
+@internal mutationSequence: (kind: "topology" | "write") => number
+@internal mutationsForCursor: (component: AnyComponentDef, kind: "topology" | "write", reader: number) => Entity[]
@internal onCoreDisconnect: (dispose: () => void) => () => void
@internal openSpeculation: (log: { record(world: World, entity: Entity, component: AnyComponentDef): void; }) => void
@internal queries_: QueryCache
@internal queryCostEnabled: boolean
@internal queryEntities: (components: AnyComponentDef[], withFilters?: AnyComponentDef[], withoutFilters?: AnyComponentDef[], precomputedKey?: string, filter?: QueryFilter, precomputedDepIds?: symbol[]) => readonly Entity[]
@internal refreshBuiltinMembership: (entity: Entity, component: AnyComponentDef) => void
-@internal registerMutationCursor: (component: AnyComponentDef, kind: "write" | "topology") => number
+@internal registerMutationCursor: (component: AnyComponentDef, kind: "topology" | "write") => number
@internal registerRemovedCursorReader: (component: AnyComponentDef) => number
@internal registerRemovedReader: (component: AnyComponentDef) => number
@internal registerRemovedReaderFrom: (component: AnyComponentDef, retainFromTick: number) => number
@@ -14336,7 +14336,7 @@ ResourceDef<WorldGens>
```
layers: Record<string, ChunkLayerStatus>
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## WorldGens — class @experimental
@@ -14360,7 +14360,7 @@ static prototype: WorldGens
cellSize: number
cells: WorldCell[]
persistentRefs: number[]
-plane: "xz" | "xy" | undefined
+plane: "xy" | "xz" | undefined
scene: string
version: number
```
@@ -14372,7 +14372,7 @@ cells: PartitionedCell[]
errors: string[]
persistent: SceneData
persistentRefs: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
warnings: string[]
```
@@ -14435,7 +14435,7 @@ loadCount: number
loadingCells: string[]
persistentEntities: number
persistentHandles: number[]
-plane: "xz" | "xy"
+plane: "xy" | "xz"
prefetchCells: string[]
prefetchHits: number
prefetchMisses: number
@@ -16566,7 +16566,7 @@ InputRouter
## isDialogOpen — function @experimental
```
-(world: Pick<World, "has" | "get">, root: Entity): boolean
+(world: Pick<World, "get" | "has">, root: Entity): boolean
```
## isDropdownOpen — function @experimental
@@ -16616,7 +16616,7 @@ InputRouter
## isPointerBlockedInTree — function @experimental
```
-(world: Pick<World, "has" | "get" | "valid">, entity: Entity): boolean
+(world: Pick<World, "get" | "has" | "valid">, entity: Entity): boolean
```
## isPrefabEntry — function @experimental
@@ -16781,7 +16781,7 @@ Logger
## manifestPlane — function @experimental
```
-(manifest: { plane?: "xz" | "xy"; } | null): "xz" | "xy"
+(manifest: { plane?: "xy" | "xz"; } | null): "xy" | "xz"
```
## markThemed — function @experimental
@@ -17001,17 +17001,17 @@ MeshRendererPlugin
## packagedAppOptions — function @experimental
```
-(config: Pick<PackagedGameConfig, "ySortLayers" | "depthLayers" | "colorSpace" | "outputTransform" | "screenFit" | "msaaSamples" | "quality">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "none" | "aces" | "neutral"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
+(config: Pick<PackagedGameConfig, "colorSpace" | "depthLayers" | "msaaSamples" | "outputTransform" | "quality" | "screenFit" | "ySortLayers">): { ySortLayers?: number; depthLayers?: number; colorSpace?: "gamma" | "linear"; outputTransform?: "aces" | "neutral" | "none"; msaaSamples?: number; quality?: QualityConfig; renderBackend?: "webgl2" | "webgpu"; screenFit?: PackagedGameConfig["screenFit"]; }
```
## packagedRuntimeInit — function @experimental
```
-(config: Pick<PackagedGameConfig, "physicsEnabled" | "physicsConfig" | "physics3dBackend" | "physics3dWorld" | "audioConfig" | "uiTheme" | "uiThemeColors" | "achievements" | "steamAppId" | "screenFit" | "aot" | "debugChannel" | "runtime">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
+(config: Pick<PackagedGameConfig, "achievements" | "aot" | "audioConfig" | "debugChannel" | "physics3dBackend" | "physics3dWorld" | "physicsConfig" | "physicsEnabled" | "runtime" | "screenFit" | "steamAppId" | "uiTheme" | "uiThemeColors">): { physicsEnabled?: boolean; physicsConfig?: Physics2DPluginConfig; physics3dBackend?: Physics3DBackend; physics3dWorld?: Partial<Physics3DWorldConfig>; audioConfig?: AudioProjectConfig; runtime?: RuntimeBuildConfig; uiTheme?: "light"; uiThemeOverrides?: ThemeOverrides; achievements?: string[]; steamAppId?: number; screenFit?: PackagedGameConfig["screenFit"]; aot?: PackagedGameConfig["aot"]; debugChannel?: DebugChannelConfig; }
```
## paintWeights — function @experimental
```
-(h: number, ny: number, t: Pick<TerrainData, "rockSlope" | "dirtHeight" | "snowHeight">): [number, number, number, number]
+(h: number, ny: number, t: Pick<TerrainData, "dirtHeight" | "rockSlope" | "snowHeight">): [number, number, number, number]
```
## panoramaDirection — function @experimental
@@ -17206,7 +17206,7 @@ ParticlePlugin
## planeSecond — function @experimental
```
-(position: { y: number; z?: number; }, plane: "xz" | "xy"): number
+(position: { y: number; z?: number; }, plane: "xy" | "xz"): number
```
## planetPlugin — const @experimental
@@ -17426,7 +17426,7 @@ PrefabsPlugin
## q — const @experimental
```
-{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "z" | "w">): number; scaled(a: Quat, t: number): Quat; }
+{ create(w?: number, x?: number, y?: number, z?: number): Quat; clone(a: Quat): Quat; mul(a: Quat, b: Quat): Quat; axis(axis: "x" | "y" | "z", rad: number): Quat; normalize(a: Quat): Quat; dot(a: Quat, b: Quat): number; neg(a: Quat): Quat; conjugate(a: Quat): Quat; rotate(a: Quat, v: Vec3): Vec3; toEuler(a: Quat): [number, number, number]; fromEuler(deg: readonly number[]): Quat; rotationTo(from: Vec3, to: Vec3): Quat; setAngleZ(a: Quat | undefined, deg: number): Quat; angleZ(a: Pick<Quat, "w" | "z">): number; scaled(a: Quat, t: number): Quat; }
```
## quadraticBezier — function @experimental
@@ -18121,7 +18121,7 @@ ServicesPlugin
## setTreeViewData — function @beta
```
-<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "item" | "dragHandle" | "canDrop" | "onDrop">): () => void
+<T>(world: World, entity: Entity, data: TreeDataSource<T>, options?: Pick<TreeViewOptions<T>, "canDrop" | "dragHandle" | "item" | "onDrop">): () => void
```
## setUIVisible — function @experimental
@@ -18646,7 +18646,7 @@ UIVisibilityPlugin
## updateAnimatorLayer — function @experimental
```
-(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "name" | "weight" | "blend" | "mask">): AnimatorControllerDef
+(def: AnimatorControllerDef, index: number, patch: Pick<Partial<AnimatorLayer>, "blend" | "mask" | "name" | "weight">): AnimatorControllerDef
```
## updateAnimatorParam — function @experimental
@@ -18926,7 +18926,7 @@ SystemDef
## wxReadTextFile — function @experimental
```
-(path: string, encoding?: "utf8" | "utf-8"): Promise<string>
+(path: string, encoding?: "utf-8" | "utf8"): Promise<string>
```
## wxWriteFile — function @experimental
diff --git a/sdk/etc/worldgen.api.md b/sdk/etc/worldgen.api.md
index 598729bcd..6e2e635bb 100644
--- a/sdk/etc/worldgen.api.md
+++ b/sdk/etc/worldgen.api.md
@@ -88,7 +88,7 @@ y: number
## GroundingOptions — interface @experimental
```
maxRelief: number | undefined
-mode: "highest" | "lowest" | "mean" | "center" | undefined
+mode: "center" | "highest" | "lowest" | "mean" | undefined
offset: number | undefined
samples: number | undefined
size: readonly [number, number]
@@ -125,7 +125,7 @@ kind: string
## Placement — interface @experimental
```
-attach: "upright" | "align"
+attach: "align" | "upright"
biome: string
canopy: number
far: { u0: number; v0: number; u1: number; v1: number; tent?: boolean; } | null | undefined
@@ -252,7 +252,7 @@ version: number
## RecipeMember — interface @experimental
```
arc: readonly [number, number] | undefined
-attach: "upright" | "align" | undefined
+attach: "align" | "upright" | undefined
canopy: number | undefined
chance: number | undefined
count: readonly [number, number] | undefined
@@ -362,7 +362,7 @@ ResourceDef<WorldGens>
```
layers: Record<string, ChunkLayerStatus>
reason: string | undefined
-state: "failed" | "ready" | "loading"
+state: "failed" | "loading" | "ready"
```
## WorldGens — class @experimental
diff --git a/tools/api-surface.mjs b/tools/api-surface.mjs
index c4fb4a19b..a1e689132 100644
--- a/tools/api-surface.mjs
+++ b/tools/api-surface.mjs
@@ -162,7 +162,8 @@ const FMT = ts.TypeFormatFlags.NoTruncation | ts.TypeFormatFlags.UseAliasDefined
function normalizeType(text) {
return text
.split(SDK.replace(/\\/g, '/')).join('~')
- .replace(/import\((['"]).*?\1\)\./g, '');
+ .replace(/import\((['"]).*?\1\)\./g, '')
+ .replace(/"[^"\\]*"(?: \| "[^"\\]*")+/g, (run) => run.split(' | ').sort().join(' | '));
}
const fileTagCache = new Map();