@dcl/playground-assets 7.7.9-13728708694.commit-5b19f0f → 7.7.10-13856045106.commit-7f23e37

package/dist/alpha.d.ts

@@ -178,6 +178,18 @@ export declare const AvatarAttach: LastWriteWinElementSetComponentDefinition<PBA
 /** @public */
 export declare const AvatarBase: LastWriteWinElementSetComponentDefinition<PBAvatarBase>;
 
+/**
+ * @public
+ */
+export declare const enum AvatarControlType {
+    /** CCT_NONE - avatar cannot move */
+    CCT_NONE = 0,
+    /** CCT_RELATIVE - avatar moves relative to the camera origin */
+    CCT_RELATIVE = 1,
+    /** CCT_TANK - avatar moves like a tank: left/right rotate the player, forward/backward advance/retreat the player */
+    CCT_TANK = 2
+}
+
 /** @public */
 export declare const AvatarEmoteCommand: GrowOnlyValueSetComponentDefinition<PBAvatarEmoteCommand>;
 
@@ -198,6 +210,37 @@ export declare const enum AvatarModifierType {
     AMT_DISABLE_PASSPORTS = 1
 }
 
+/**
+ * @public
+ */
+export declare interface AvatarMovementSettings {
+    controlMode?: AvatarControlType | undefined;
+    /** if not explicitly set, the following properties default to user's preference settings */
+    runSpeed?: number | undefined;
+    /** how fast the player gets up to speed or comes to rest. higher = more responsive */
+    friction?: number | undefined;
+    /** how fast the player accelerates vertically when not on a solid surface, in m/s. should normally be negative */
+    gravity?: number | undefined;
+    /** how high the player can jump, in meters. should normally be positive. gravity must have the same sign for jumping to be possible */
+    jumpHeight?: number | undefined;
+    /** max fall speed in m/s. should normally be negative */
+    maxFallSpeed?: number | undefined;
+    /** speed the player turns in tank mode, in radians/s */
+    turnSpeed?: number | undefined;
+    /** speed the player walks at, in m/s */
+    walkSpeed?: number | undefined;
+    /** whether to allow player to move at a slower speed (e.g. with a walk-key or when using a gamepad/joystick). defaults to true */
+    allowWeightedMovement?: boolean | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace AvatarMovementSettings {
+    export function encode(message: AvatarMovementSettings, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): AvatarMovementSettings;
+}
+
 /** @public */
 export declare const AvatarShape: LastWriteWinElementSetComponentDefinition<PBAvatarShape>;
 
@@ -462,6 +505,12 @@ export declare interface ByteBuffer {
  */
 export declare type Callback = () => void;
 
+/** @public */
+export declare const CameraLayer: LastWriteWinElementSetComponentDefinition<PBCameraLayer>;
+
+/** @public */
+export declare const CameraLayers: LastWriteWinElementSetComponentDefinition<PBCameraLayers>;
+
 /** @public */
 export declare const CameraMode: LastWriteWinElementSetComponentDefinition<PBCameraMode>;
 
@@ -519,6 +568,39 @@ export declare const enum CameraType {
 
 export declare type Children = ReactEcs.JSX.ReactNode;
 
+/**
+ * @public
+ */
+export declare interface CinematicSettings {
+    /** Entity that defines the cinematic camera transform. */
+    cameraEntity: number;
+    /**
+     * Position -> camera's position
+     * Rotation -> camera's direction
+     * scale.z -> zoom level
+     * scale.x and scale.y -> unused
+     */
+    allowManualRotation?: boolean | undefined;
+    /** how far the camera can rotate around the y-axis / look left/right, in radians. default unrestricted */
+    yawRange?: number | undefined;
+    /** how far the camera can rotate around the x-axis / look up-down, in radians. default unrestricted */
+    pitchRange?: number | undefined;
+    /** note: cameras can never look up/down further than Vec3::Y */
+    rollRange?: number | undefined;
+    /** minimum zoom level. must be greater than 0. defaults to the input zoom level */
+    zoomMin?: number | undefined;
+    /** maximum zoom level. must be greater than 0. defaults to the input zoom level */
+    zoomMax?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace CinematicSettings {
+    export function encode(message: CinematicSettings, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): CinematicSettings;
+}
+
 /** ColliderLayer determines the kind of collision to detect, in OR-able bit flag form. */
 /**
  * @public
@@ -1292,12 +1374,18 @@ export declare const componentDefinitionByName: {
     "core::AvatarModifierArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarModifierArea>>;
     "core::AvatarShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarShape>>;
     "core::Billboard": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBBillboard>>;
+    "core::CameraLayer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraLayer>>;
+    "core::CameraLayers": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraLayers>>;
     "core::CameraMode": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
     "core::CameraModeArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraModeArea>>;
     "core::EngineInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBEngineInfo>>;
+    "core::GlobalLight": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGlobalLight>>;
     "core::GltfContainer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
     "core::GltfContainerLoadingState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>>;
+    "core::GltfNode": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfNode>>;
+    "core::GltfNodeState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfNodeState>>;
     "core::InputModifier": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBInputModifier>>;
+    "core::Light": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBLight>>;
     "core::MainCamera": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMainCamera>>;
     "core::Material": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMaterial>>;
     "core::MeshCollider": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMeshCollider>>;
@@ -1307,19 +1395,24 @@ export declare const componentDefinitionByName: {
     "core::PointerEvents": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPointerEvents>>;
     "core::PointerEventsResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBPointerEventsResult>>;
     "core::PointerLock": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPointerLock>>;
+    "core::PrimaryPointerInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPrimaryPointerInfo>>;
     "core::Raycast": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycast>>;
     "core::RaycastResult": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycastResult>>;
     "core::RealmInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRealmInfo>>;
+    "core::Spotlight": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBSpotlight>>;
     "core::TextShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTextShape>>;
+    "core::TextureCamera": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTextureCamera>>;
     "core::Tween": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTween>>;
     "core::TweenSequence": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTweenSequence>>;
     "core::TweenState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTweenState>>;
     "core::UiBackground": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiBackground>>;
+    "core::UiCanvas": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiCanvas>>;
     "core::UiCanvasInformation": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiCanvasInformation>>;
     "core::UiDropdown": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiDropdown>>;
     "core::UiDropdownResult": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiDropdownResult>>;
     "core::UiInput": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiInput>>;
     "core::UiInputResult": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiInputResult>>;
+    "core::UiScrollResult": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiScrollResult>>;
     "core::UiText": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiText>>;
     "core::UiTransform": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBUiTransform>>;
     "core::VideoEvent": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBVideoEvent>>;
@@ -1890,6 +1983,9 @@ export declare type EntityComponents = {
     onMouseUp: Callback;
     onMouseEnter: Callback;
     onMouseLeave: Callback;
+    onMouseDrag: Callback;
+    onMouseDragLocked: Callback;
+    onMouseDragEnd: Callback;
 };
 
 /** @public */
@@ -2041,6 +2137,9 @@ export declare type GlobalDirectionRaycastSystemOptions = {
     direction?: PBVector3;
 };
 
+/** @public */
+export declare const GlobalLight: LastWriteWinElementSetComponentDefinition<PBGlobalLight>;
+
 export declare type GlobalTargetRaycastOptions = RaycastSystemOptions & GlobalTargetRaycastSystemOptions;
 
 export declare type GlobalTargetRaycastSystemOptions = {
@@ -2053,6 +2152,21 @@ export declare const GltfContainer: LastWriteWinElementSetComponentDefinition<PB
 /** @public */
 export declare const GltfContainerLoadingState: LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>;
 
+/** @public */
+export declare const GltfNode: LastWriteWinElementSetComponentDefinition<PBGltfNode>;
+
+/** @public */
+export declare const GltfNodeState: LastWriteWinElementSetComponentDefinition<PBGltfNodeState>;
+
+/**
+ * @public
+ */
+export declare const enum GltfNodeStateValue {
+    GNSV_PENDING = 0,
+    GNSV_FAILED = 1,
+    GNSV_READY = 2
+}
+
 /**
  * @public
  */
@@ -2656,6 +2770,9 @@ export declare interface LastWriteWinElementSetComponentDefinition<T> extends Ba
     getOrCreateMutable(entity: Entity, initialValue?: T): T;
 }
 
+/** @public */
+export declare const Light: LastWriteWinElementSetComponentDefinition<PBLight>;
+
 /**
  * User key event Listeners
  * @public
@@ -2669,6 +2786,12 @@ export declare type Listeners = {
     onMouseEnter?: Callback;
     /** triggered on mouse leave event */
     onMouseLeave?: Callback;
+    /** triggered on mouse drag event */
+    onMouseDrag?: Callback;
+    /** triggered on mouse drag event */
+    onMouseDragLocked?: Callback;
+    /** triggered on mouse drag event */
+    onMouseDragEnd?: Callback;
 };
 
 /**
@@ -3537,6 +3660,14 @@ export declare interface MeshColliderComponentDefinitionExtended extends LastWri
      * @param colliderMask - the set of layer where the collider reacts, default: Physics and Pointer
      */
     setSphere(entity: Entity, colliderLayers?: ColliderLayer | ColliderLayer[]): void;
+    /**
+     * @public
+     * Set a gltf internal mesh in the MeshCollider component
+     * @param entity - entity to create or replace the MeshRenderer component
+     * @param source - the path to the gltf
+     * @param meshName - the name of the mesh in the gltf
+     */
+    setGltfMesh(entity: Entity, source: string, meshName: string, colliderLayers?: ColliderLayer | ColliderLayer[]): void;
 }
 
 export declare const MeshRenderer: MeshRendererComponentDefinitionExtended;
@@ -3573,6 +3704,14 @@ export declare interface MeshRendererComponentDefinitionExtended extends LastWri
      * @param entity - entity to create or replace the MeshRenderer component
      */
     setSphere(entity: Entity): void;
+    /**
+     * @public
+     * Set a gltf internal mesh in the MeshRenderer component
+     * @param entity - entity to create or replace the MeshRenderer component
+     * @param source - the path to the gltf
+     * @param meshName - the name of the mesh in the gltf
+     */
+    setGltfMesh(entity: Entity, source: string, meshName: string): void;
 }
 
 /**
@@ -3985,6 +4124,25 @@ export declare const onVideoEvent: Observable<{
     totalVideoLength: number;
 }>;
 
+/**
+ * @public
+ */
+export declare interface Orthographic {
+    /**
+     * vertical extent of the visible range in meters
+     * defaults to 4m
+     */
+    verticalRange?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace Orthographic {
+    export function encode(message: Orthographic, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): Orthographic;
+}
+
 /**
  * @public
  * The overflow property controls what happens to content that is too big to fit into an area
@@ -4211,6 +4369,8 @@ export declare namespace PBAvatarEmoteCommand {
 export declare interface PBAvatarEquippedData {
     wearableUrns: string[];
     emoteUrns: string[];
+    /** slots that will render even if hidden */
+    forceRender: string[];
 }
 
 /**
@@ -4245,6 +4405,9 @@ export declare interface PBAvatarModifierArea {
     excludeIds: string[];
     /** list of modifiers to apply */
     modifiers: AvatarModifierType[];
+    movementSettings?: AvatarMovementSettings | undefined;
+    /** if true, the player will be considered inside the area when they are within 0.3m of the area. default true */
+    useColliderRange?: boolean | undefined;
 }
 
 /**
@@ -4301,6 +4464,8 @@ export declare interface PBAvatarShape {
     wearables: string[];
     /** available emotes (default empty) */
     emotes: string[];
+    /** slots that will render even if hidden */
+    forceRender: string[];
 }
 
 /**
@@ -4335,6 +4500,51 @@ export declare namespace PBBillboard {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBBillboard;
 }
 
+/**
+ * @public
+ */
+export declare interface PBCameraLayer {
+    /**
+     * layer to which these settings apply. must be > 0
+     * Layer 0 is the default "real world" layer viewed by the player and cannot be modified.
+     */
+    layer: number;
+    /** should the sun light affect this layer? default false */
+    directionalLight?: boolean | undefined;
+    /** should this layer show player avatars? default false */
+    showAvatars?: boolean | undefined;
+    /** should this layer show the sky? default false */
+    showSkybox?: boolean | undefined;
+    /** should this layer show distance fog? default false */
+    showFog?: boolean | undefined;
+    /** ambient light overrides for this layer. default -> use same as main camera */
+    ambientColorOverride?: PBColor3 | undefined;
+    ambientBrightnessOverride?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBCameraLayer {
+    export function encode(message: PBCameraLayer, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBCameraLayer;
+}
+
+/**
+ * @public
+ */
+export declare interface PBCameraLayers {
+    layers: number[];
+}
+
+/**
+ * @public
+ */
+export declare namespace PBCameraLayers {
+    export function encode(message: PBCameraLayers, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBCameraLayers;
+}
+
 /**
  * The CameraMode component can be used to determine whether the player is using a first-person o
  * third-person view.
@@ -4357,7 +4567,7 @@ export declare namespace PBCameraMode {
 
 /**
  * The CameraModeArea component can be attached to an Entity to define a region of space where
- * the player's camera mode (1st-person or 3rd-person) is overridden.
+ * the player's camera mode (1st-person, 3rd-person or cinematic) is overridden.
  *
  * The Entity's Transform position determines the center-point of the region, while its size is
  * given as a vector in the `area` property below. The Transform rotation is applied, but the scale
@@ -4367,6 +4577,8 @@ export declare namespace PBCameraMode {
  *
  * Note that, while commonly used to delineate a 2D area in a scene (hence the name), the region
  * is actually a 3D volume.
+ *
+ * When mode is set to CtCinematic, the cinematic_settings field must also be provided.
  */
 /**
  * @public
@@ -4376,6 +4588,9 @@ export declare interface PBCameraModeArea {
     area: PBVector3 | undefined;
     /** the camera mode to enforce */
     mode: CameraType;
+    cinematicSettings?: CinematicSettings | undefined;
+    /** if true, the player will be considered inside the area when they are within 0.3m of the area. default true */
+    useColliderRange?: boolean | undefined;
 }
 
 /**
@@ -4447,6 +4662,39 @@ export declare namespace PBEngineInfo {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBEngineInfo;
 }
 
+/**
+ * defines the global scene light settings. must be added to the scene root.
+ * to control sunlight color, intensity, shadows etc, you can also add a PBLight to the scene root.
+ */
+/**
+ * @public
+ */
+export declare interface PBGlobalLight {
+    /**
+     * the direction the directional light shines in.
+     * default depends on time of day and explorer implementation
+     */
+    direction?: PBVector3 | undefined;
+    /**
+     * ambient light color
+     * default: White
+     */
+    ambientColor?: PBColor3 | undefined;
+    /**
+     * ambient light intensity. the explorer default ambient brightness is multiplied by this non-physical quantity.
+     * default 1
+     */
+    ambientBrightness?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBGlobalLight {
+    export function encode(message: PBGlobalLight, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBGlobalLight;
+}
+
 /**
  * GltfContainer loads a GLTF file (and any additional files packaged inside) attached to an Entity.
  *
@@ -4482,6 +4730,25 @@ export declare namespace PBGltfContainer {
  */
 export declare interface PBGltfContainerLoadingState {
     currentState: LoadingState;
+    /** all node paths in the gltf, which can be used with a GltfNode to inspect and modify the gltf contents */
+    nodePaths: string[];
+    /** all meshes in the gltf. unnamed meshes will be auto-assigned a name of the form `MeshX` or `MeshX/PrimitiveY` */
+    meshNames: string[];
+    /**
+     * where X is the mesh index and Y is the primitive index (and there is more than 1 primitive). note this may
+     * conflict with manually named meshes - to avoid any issues make sure all your meshes are explicitly named.
+     */
+    materialNames: string[];
+    /**
+     * X is the material index. note this may conflict with manually named materials - to avoid any issues make
+     * sure all your materials are explicitly named.
+     */
+    skinNames: string[];
+    /**
+     * X is the skin index. note this may conflict with manually named skins - to avoid any issues make sure all
+     * your skins are explicitly named.
+     */
+    animationNames: string[];
 }
 
 /**
@@ -4492,6 +4759,77 @@ export declare namespace PBGltfContainerLoadingState {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBGltfContainerLoadingState;
 }
 
+/**
+ * a GltfNode links a scene entity with a node from within a gltf, allowing the scene to inspect it or modify it.
+ * This component must be added to a direct child of an entity with a PBGltfContainer component, or
+ * to a direct child of another entity with a GltfNode component, and the referenced gltf node must be a descendent of the gltf node
+ * in the parent.
+ * The name must match the path of one of the nodes within the Gltf. These are available on the GltfContainerLoadingState component.
+ *
+ * The renderer will attach a PBGltfNodeState to the entity describing the state. Once the state is `GNS_READY`,
+ * - the `Transform` will be updated to match the position of the node within the gltf (relative to the gltf root, or the parent node),
+ * - a `MeshRenderer` with a GltfMesh mesh type will be added (if the gltf node has a mesh).
+ * - a `MeshCollider` with a GltfMesh mesh type will be added (if the gltf node has a collider).
+ * - a `Material` component including a GltfMaterial reference will be added (if the gltf node has a material).
+ *
+ * After creation, if an animation moves the node, the `Transform` will be updated.
+ *
+ * From the scene, you can modify various components to alter the gltf node:
+ * - modifying the `Transform` position/rotation/scale will move the node. The position is interpreted relative to the gltf root (or parent node),
+ *   regardless of any intermediate gltf node hierarchy.
+ *   If an animation is playing, the animation takes priority and the scene entity's position will be updated to match the animation.
+ * - `Visibility` can be added to hide or show the node and it's children in the gltf hierarchy.
+ * - `MeshRenderer` can be added/modified/removed to create/modify/remove a mesh on the node.
+ * - `MeshCollider` can be added/modified/removed to create/modify/remove a collider on the node.
+ * - `Material` can be added or modified to change the material properties. If the gltf node has a material, the original material will be
+ *   used as a base, and any gltf features (e.g. occlusion maps) from the gtlf spec that the renderer supports but that are not exposed in the
+ *   PBMaterial will be maintained.
+ *
+ * The scene can add additional entities as children to the gltf node, but structural modifications of the gltf are not possible:
+ * - changing the scene hierarchy will not change the gltf node hierarchy. Moving the entity out of the gltf will sever the link and
+ *   change the state to `GNS_FAILED`.
+ * - deleting the scene entity will not delete the gltf node.
+ *
+ * Removing the GltfNode will revert any changes to the original gltf. If the GltfNode component is removed and the mesh/collider/material
+ * are not removed, this will result in a duplication of these components as the previously-linked entity will retain it's components and
+ * the gltf node will also be displayed.
+ */
+/**
+ * @public
+ */
+export declare interface PBGltfNode {
+    /** the path of the target node in the Gltf. */
+    path: string;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBGltfNode {
+    export function encode(message: PBGltfNode, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBGltfNode;
+}
+
+/**
+ * The state of a linked gltf node.
+ * If the state is GNSV_FAILED, the renderer may describe the failure in the error string.
+ */
+/**
+ * @public
+ */
+export declare interface PBGltfNodeState {
+    state: GltfNodeStateValue;
+    error?: string | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBGltfNodeState {
+    export function encode(message: PBGltfNodeState, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBGltfNodeState;
+}
+
 /**
  * @public
  */
@@ -4531,6 +4869,62 @@ export declare namespace PBInputModifier_StandardInput {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBInputModifier_StandardInput;
 }
 
+/**
+ * defines a light source.
+ * the world has a default directional light (like sunlight) which can be overridden by adding the light component to the scene root.
+ * a PBGlobalLight component can also be added to the root to control the directional light direction.
+ * point lights (lightbulbs) or spotlights can be created by attaching the light component to non-root entities.
+ */
+/**
+ * @public
+ */
+export declare interface PBLight {
+    /**
+     * whether the light is on
+     * default true
+     */
+    enabled?: boolean | undefined;
+    /**
+     * light brightness in lux (lumens/m^2).
+     *
+     * for global directional light, this applies as a constant value at all surfaces and distances (though the effect on the surface still depends on incidence angle).
+     * the default global light illuminance varies from 400 (sunrise/sunset) to 10,000 (midday).
+     * for typical values, see https://en.wikipedia.org/wiki/Lux#Illuminance
+     *
+     * for point and spot lights, this is the lumens/m^2 at 1m distance from the light. to transform from raw lumens,
+     * divide lumens by ~12 (4*pi).
+     * e.g. a 100w household bulb with 1200 lumens would have an illuminance of ~100.
+     * a lighthouse bulb with 200,000 lumens would have an illuminance of ~15,000 (ignoring beam reflections)
+     *
+     * default
+     * for point/spotlights: 10,000
+     * for global directional light: depends on explorer implementation. may vary on light direction, time of day, etc
+     */
+    illuminance?: number | undefined;
+    /**
+     * whether the light should cast shadows.
+     * note: even when set to true the engine may not display shadows, or may only show shadows for a limited number
+     * of lights depending on the implementation, platform, and user settings.
+     * default
+     * for point/spotlights: false / off
+     * for global directional light: true / on
+     */
+    shadows?: boolean | undefined;
+    /**
+     * light color
+     * default White
+     */
+    color?: PBColor3 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBLight {
+    export function encode(message: PBLight, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBLight;
+}
+
 /**
  * PBMainCamera.virtualCameraEntity defines which VirtualCamera entity is active at the moment.
  * This component may hold 'repeated common.CameraTransition' transitionOverrides in the future
@@ -4562,6 +4956,14 @@ export declare interface PBMaterial {
         $case: "pbr";
         pbr: PBMaterial_PbrMaterial;
     } | undefined;
+    /**
+     * A gltf material that may provide additional features not supported by the PbMaterial fields.
+     * If both gltf and material fields are provided, the gltf will be used only for extended features not
+     * supported by the PbMaterial.
+     * If this is provided and the `material` field is not provided, the renderer will update the material
+     * field with data that reflects the gltf material once it is loaded.
+     */
+    gltf?: PBMaterial_GltfMaterial | undefined;
 }
 
 /**
@@ -4572,6 +4974,22 @@ export declare namespace PBMaterial {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBMaterial;
 }
 
+/**
+ * @public
+ */
+export declare interface PBMaterial_GltfMaterial {
+    gltfSrc: string;
+    name: string;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBMaterial_GltfMaterial {
+    export function encode(message: PBMaterial_GltfMaterial, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBMaterial_GltfMaterial;
+}
+
 /**
  * @public
  */
@@ -4668,6 +5086,9 @@ export declare interface PBMeshCollider {
     } | {
         $case: "plane";
         plane: PBMeshCollider_PlaneMesh;
+    } | {
+        $case: "gltf";
+        gltf: PBMeshCollider_GltfMesh;
     } | undefined;
 }
 
@@ -4713,6 +5134,25 @@ export declare namespace PBMeshCollider_CylinderMesh {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBMeshCollider_CylinderMesh;
 }
 
+/** A collider constructed from a Gltf Mesh. */
+/**
+ * @public
+ */
+export declare interface PBMeshCollider_GltfMesh {
+    /** the GLTF file path as listed in the scene's manifest. */
+    gltfSrc: string;
+    /** the name of the mesh asset */
+    name: string;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBMeshCollider_GltfMesh {
+    export function encode(message: PBMeshCollider_GltfMesh, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBMeshCollider_GltfMesh;
+}
+
 /** PlaneMesh is a 2D rectangle described by the Entity's Transform. */
 /**
  * @public
@@ -4745,13 +5185,11 @@ export declare namespace PBMeshCollider_SphereMesh {
 
 /**
  * The MeshRenderer component renders a basic geometric shape for an Entity. It can be a cube, a
- * plane, a sphere or a cylinder.
+ * plane, a sphere, a cylinder, or a Gltf mesh.
  *
  * The cube and plane variants can include a UV texture mapping, so specific areas of a material
  * texture are rendered on different faces of the shape. They are serialized as a sequence of 2D
  * `float` coordinates, one for each corner of each side of each face.
- *
- * More complex shapes require the use of a `GltfContainer` component.
  */
 /**
  * @public
@@ -4769,6 +5207,9 @@ export declare interface PBMeshRenderer {
     } | {
         $case: "plane";
         plane: PBMeshRenderer_PlaneMesh;
+    } | {
+        $case: "gltf";
+        gltf: PBMeshRenderer_GltfMesh;
     } | undefined;
 }
 
@@ -4816,6 +5257,25 @@ export declare namespace PBMeshRenderer_CylinderMesh {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBMeshRenderer_CylinderMesh;
 }
 
+/** A mesh from a Gltf. */
+/**
+ * @public
+ */
+export declare interface PBMeshRenderer_GltfMesh {
+    /** the GLTF file path as listed in the scene's manifest. */
+    gltfSrc: string;
+    /** the name of the mesh asset */
+    name: string;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBMeshRenderer_GltfMesh {
+    export function encode(message: PBMeshRenderer_GltfMesh, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBMeshRenderer_GltfMesh;
+}
+
 /** PlaneMesh renders a 2D rectangular shape. */
 /**
  * @public
@@ -5034,6 +5494,30 @@ export declare namespace PBPosition {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBPosition;
 }
 
+/**
+ * @public
+ */
+export declare interface PBPrimaryPointerInfo {
+    pointerType?: PointerType | undefined;
+    /** in pixels */
+    screenCoordinates?: PBVector2 | undefined;
+    /** in pixels */
+    screenDelta?: PBVector2 | undefined;
+    /**
+     * ray direction that can be used with the primary camera origin for
+     * raycasting from the cursor into the world
+     */
+    worldRayDirection?: PBVector3 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBPrimaryPointerInfo {
+    export function encode(message: PBPrimaryPointerInfo, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBPrimaryPointerInfo;
+}
+
 /**
  * @public
  */
@@ -5155,6 +5639,39 @@ export declare namespace PBRealmInfo {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBRealmInfo;
 }
 
+/**
+ * defines a spotlight.
+ * spotlights are point lights that emit light only in a cone around the transform's forward direction.
+ * add this component together with the PBLight component to transform a point light into a spotlight.
+ * note that spotlights do not model any internal reflections / focus, they only restrict the area of effect.
+ * so for e.g. a torch beam, the bulb illuminance should be multiplied by the solid angle.
+ * a typical torch with a beam width of 15 degrees would use outer angle of 0.15 (7.5 degrees in radians),
+ * and an illuminance approximately equal to the bulb's lumens, e.g. 1200.
+ */
+/**
+ * @public
+ */
+export declare interface PBSpotlight {
+    /**
+     * the cone radius in radians. distance away from forward in which the light is visible.
+     * for a torch a value around 0.15 is appropriate.
+     */
+    angle: number;
+    /**
+     * optional angle at which the light is brightest. should be <= outer angle.
+     * if specified, the light will fall off smoothly between `inner_angle` and `angle`.
+     */
+    innerAngle?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBSpotlight {
+    export function encode(message: PBSpotlight, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBSpotlight;
+}
+
 /**
  * The TextShape component renders customizable floating text.
  *
@@ -5219,6 +5736,40 @@ export declare namespace PBTextShape {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBTextShape;
 }
 
+/**
+ * @public
+ */
+export declare interface PBTextureCamera {
+    /** rendered texture width */
+    width?: number | undefined;
+    /** rendered texture height */
+    height?: number | undefined;
+    /**
+     * which layer of entities to render. entity layers can be specified by adding PBCameraLayers to target entities.
+     * defaults to 0
+     */
+    layer?: number | undefined;
+    /** default black */
+    clearColor?: PBColor4 | undefined;
+    /** default infinity */
+    farPlane?: number | undefined;
+    mode?: {
+        $case: "perspective";
+        perspective: Perspective;
+    } | {
+        $case: "orthographic";
+        orthographic: Orthographic;
+    } | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBTextureCamera {
+    export function encode(message: PBTextureCamera, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBTextureCamera;
+}
+
 /**
  * @public
  */
@@ -5308,6 +5859,25 @@ export declare namespace PBUiBackground {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBUiBackground;
 }
 
+/** The UiCanvas component can be attached to a ui root entity to specify properties of the ui texture. */
+/**
+ * @public
+ */
+export declare interface PBUiCanvas {
+    width: number;
+    height: number;
+    /** default = (0.0, 0.0, 0.0, 0.0) / transparent */
+    color?: PBColor4 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBUiCanvas {
+    export function encode(message: PBUiCanvas, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBUiCanvas;
+}
+
 /** This component is created by the renderer and used by the scenes to know the resolution of the UI canvas */
 /**
  * @public
@@ -5424,6 +5994,21 @@ export declare namespace PBUiInputResult {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBUiInputResult;
 }
 
+/**
+ * @public
+ */
+export declare interface PBUiScrollResult {
+    value: PBVector2 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBUiScrollResult {
+    export function encode(message: PBUiScrollResult, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBUiScrollResult;
+}
+
 /**
  * @public
  */
@@ -5440,6 +6025,10 @@ export declare interface PBUiText {
     fontSize?: number | undefined;
     /** wrap text when the border is reached (default: TW_WRAP) */
     textWrap?: TextWrap | undefined;
+    /** width of the outline (default: 0) */
+    outlineWidth?: number | undefined;
+    /** RGBA color of the outline (default: opaque black) */
+    outlineColor?: PBColor4 | undefined;
 }
 
 /**
@@ -5536,6 +6125,16 @@ export declare interface PBUiTransform {
     paddingBottom: number;
     /** default: PointerFilterMode.PFM_NONE */
     pointerFilter?: PointerFilterMode | undefined;
+    /** default: 1 */
+    opacity?: number | undefined;
+    /** default empty */
+    elementId?: string | undefined;
+    /** default position=(0,0) */
+    scrollPosition?: ScrollPositionValue | undefined;
+    /** default ShowScrollBar.SSB_BOTH */
+    scrollVisible?: ShowScrollBar | undefined;
+    /** default 0 */
+    zIndex?: number | undefined;
 }
 
 /**
@@ -5665,6 +6264,25 @@ export declare namespace PBVisibilityComponent {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBVisibilityComponent;
 }
 
+/**
+ * @public
+ */
+export declare interface Perspective {
+    /**
+     * vertical field of view in radians
+     * defaults to pi/4 = 45 degrees
+     */
+    fieldOfView?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace Perspective {
+    export function encode(message: Perspective, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): Perspective;
+}
+
 /**
  * Represens a plane by the equation ax + by + cz + d = 0
  * @public
@@ -5820,6 +6438,24 @@ export declare interface PointerEventsSystem {
      * @param entity - Entity where the callback was attached
      */
     removeOnPointerHoverLeave(entity: Entity): void;
+    /**
+     * @public
+     * Remove the callback for onPointerDrag event
+     * @param entity - Entity where the callback was attached
+     */
+    removeOnPointerDrag(entity: Entity): void;
+    /**
+     * @public
+     * Remove the callback for onPointerDragLocked event
+     * @param entity - Entity where the callback was attached
+     */
+    removeOnPointerDragLocked(entity: Entity): void;
+    /**
+     * @public
+     * Remove the callback for onPointerDragEnd event
+     * @param entity - Entity where the callback was attached
+     */
+    removeOnPointerDragEnd(entity: Entity): void;
     /**
      * @public
      * Execute callback when the user press the InputButton pointing at the entity
@@ -5874,6 +6510,37 @@ export declare interface PointerEventsSystem {
         entity: Entity;
         opts?: Partial<EventSystemOptions>;
     }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callback when the user clicks and drags the pointer from inside the entity
+     * @param pointerData - Entity to attach the callback - Opts to trigger Feedback and Button
+     * @param cb - Function to execute when click fires
+     */
+    onPointerDrag(pointerData: {
+        entity: Entity;
+        opts?: Partial<EventSystemOptions>;
+    }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callback when the user clicks and drags the pointer from inside the entity,
+     * locking the cursor in place
+     * @param pointerData - Entity to attach the callback - Opts to trigger Feedback and Button
+     * @param cb - Function to execute when click fires
+     */
+    onPointerDragLocked(pointerData: {
+        entity: Entity;
+        opts?: Partial<EventSystemOptions>;
+    }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callback when the user releases the button after a drag
+     * @param pointerData - Entity to attach the callback - Opts to trigger Feedback and Button
+     * @param cb - Function to execute when click fires
+     */
+    onPointerDragEnd(pointerData: {
+        entity: Entity;
+        opts?: Partial<EventSystemOptions>;
+    }, cb: EventSystemCallback): void;
 }
 
 /**
@@ -5890,7 +6557,10 @@ export declare const enum PointerEventType {
     PET_UP = 0,
     PET_DOWN = 1,
     PET_HOVER_ENTER = 2,
-    PET_HOVER_LEAVE = 3
+    PET_HOVER_LEAVE = 3,
+    PET_DRAG_LOCKED = 4,
+    PET_DRAG = 5,
+    PET_DRAG_END = 6
 }
 
 /**
@@ -5910,6 +6580,17 @@ export declare type PointerFilterType = 'none' | 'block';
 /** @public */
 export declare const PointerLock: LastWriteWinElementSetComponentDefinition<PBPointerLock>;
 
+/**
+ * @public
+ */
+export declare const enum PointerType {
+    POT_NONE = 0,
+    POT_MOUSE = 1,
+    POT_PAD = 2,
+    POT_TOUCH = 3,
+    POT_WAND = 4
+}
+
 /**
  * Type used for defining the position of the element. i.e. margin, padding
  * @public
@@ -5947,6 +6628,9 @@ export declare type PositionType = 'absolute' | 'relative';
  */
 export declare type PositionUnit = `${number}px` | `${number}%` | number | `${number}` | ScaleUnit;
 
+/** @public */
+export declare const PrimaryPointerInfo: LastWriteWinElementSetComponentDefinition<PBPrimaryPointerInfo>;
+
 export declare enum ProcessMessageResultType {
     /**
      * Typical message and new state set.
@@ -6501,6 +7185,7 @@ export declare type RaycastSystemOptions = {
 export declare interface ReactBasedUiSystem {
     destroy(): void;
     setUiRenderer(ui: UiComponent): void;
+    setTextureRenderer(entity: Entity, ui: UiComponent): void;
 }
 
 /**
@@ -6954,6 +7639,43 @@ export declare namespace Schemas {
     }) => void;
 }
 
+/**
+ * @public
+ */
+export declare interface ScrollPositionValue {
+    value?: {
+        $case: "position";
+        position: PBVector2;
+    } | {
+        $case: "reference";
+        reference: string;
+    } | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace ScrollPositionValue {
+    export function encode(message: ScrollPositionValue, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): ScrollPositionValue;
+}
+
+/**
+ * @public
+ * The scroll-visible determines if the scrollbars are shown when the scroll overflow is enabled
+ */
+export declare type ScrollVisibleType = 'horizontal' | 'vertical' | 'both' | 'hidden';
+
+/**
+ * @public
+ */
+export declare const enum ShowScrollBar {
+    SSB_BOTH = 0,
+    SSB_ONLY_VERTICAL = 1,
+    SSB_ONLY_HORIZONTAL = 2,
+    SSB_HIDDEN = 3
+}
+
 /**
  * @public
  */
@@ -6961,6 +7683,9 @@ export declare interface Spec {
     [key: string]: ISchema;
 }
 
+/** @public */
+export declare const Spotlight: LastWriteWinElementSetComponentDefinition<PBSpotlight>;
+
 /**
  * @alpha
  * This is going to be used for sync components through a server.
@@ -7035,6 +7760,9 @@ export declare namespace Texture {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): Texture;
 }
 
+/** @public */
+export declare const TextureCamera: LastWriteWinElementSetComponentDefinition<PBTextureCamera>;
+
 /**
  * @public
  */
@@ -7127,6 +7855,9 @@ export declare interface TextureUnion {
     } | {
         $case: "videoTexture";
         videoTexture: VideoTexture;
+    } | {
+        $case: "uiTexture";
+        uiTexture: UiCanvasTexture;
     } | undefined;
 }
 
@@ -7334,6 +8065,8 @@ export declare interface UiBackgroundProps {
     uvs?: number[];
     /** AvatarTexture for the background */
     avatarTexture?: UiAvatarTexture;
+    /** VideoTexture for the background */
+    videoTexture?: UiVideoTexture;
     /** Texture for the background */
     texture?: UiTexture;
 }
@@ -7353,9 +8086,31 @@ export declare interface UiButtonProps extends UiLabelProps, EntityPropTypes {
     disabled?: boolean;
 }
 
+/** @public */
+export declare const UiCanvas: LastWriteWinElementSetComponentDefinition<PBUiCanvas>;
+
 /** @public */
 export declare const UiCanvasInformation: LastWriteWinElementSetComponentDefinition<PBUiCanvasInformation>;
 
+/**
+ * @public
+ */
+export declare interface UiCanvasTexture {
+    uiCanvasEntity: number;
+    /** default = TextureWrapMode.Clamp */
+    wrapMode?: TextureWrapMode | undefined;
+    /** default = FilterMode.Bilinear */
+    filterMode?: TextureFilterMode | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace UiCanvasTexture {
+    export function encode(message: UiCanvasTexture, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): UiCanvasTexture;
+}
+
 /**
  * @public
  */
@@ -7425,6 +8180,10 @@ export declare interface UiLabelProps {
     textAlign?: TextAlignType | undefined;
     /** Label font type. @defaultValue 'sans-serif' */
     font?: UiFontType | undefined;
+    /** Outline width of the text. @defaultValue 0 */
+    outlineWidth?: number | undefined;
+    /** Outline color of the text. @defaultValue `{ r: 0, g: 0, b: 0, a: 1 }` */
+    outlineColor?: PBColor4 | undefined;
     /** Behaviour when text reached. @defaultValue 'wrap' */
     textWrap?: UiTextWrapType | undefined;
 }
@@ -7434,6 +8193,9 @@ export declare interface UiLabelProps {
  */
 export declare type uint32 = number;
 
+/** @public */
+export declare const UiScrollResult: LastWriteWinElementSetComponentDefinition<PBUiScrollResult>;
+
 /** @public */
 export declare const UiText: LastWriteWinElementSetComponentDefinition<PBUiText>;
 
@@ -7506,6 +8268,26 @@ export declare interface UiTransformProps {
     overflow?: OverflowType;
     /** The pointer filter property determines if the ui element blocks the pointer or not (elements with pointer events always block the pointer regardless of this property) **/
     pointerFilter?: PointerFilterType;
+    /** The opacity property sets the opacity level for an element, it's accumulated across children @defaultValue 1 */
+    opacity?: number;
+    /** A reference value to identify the element, default empty */
+    elementId?: string;
+    /** default position=(0,0) if it aplies, a vector or a reference-id */
+    scrollPosition?: PBVector2 | string;
+    /** default ShowScrollBar.SSB_BOTH */
+    scrollVisible?: ScrollVisibleType;
+    /** default 0 */
+    zIndex?: number;
+}
+
+/**
+ * Texture
+ * @public
+ */
+export declare interface UiVideoTexture {
+    videoPlayerEntity: Entity;
+    wrapMode?: TextureWrapType;
+    filterMode?: TextureFilterType;
 }
 
 /**