@dcl/playground-assets 7.13.1-19324737285.commit-cb42004 → 7.13.1-19516109426.commit-e1e79aa

package/dist/beta.d.ts

@@ -178,12 +178,33 @@ 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>;
 
 /** @public */
 export declare const AvatarEquippedData: LastWriteWinElementSetComponentDefinition<PBAvatarEquippedData>;
 
+/**
+ * @public
+ */
+export declare type AvatarEquippedDataComponentDefinitionExtended = LastWriteWinElementSetComponentDefinition<AvatarEquippedDataType>;
+
+export declare type AvatarEquippedDataType = Omit<PBAvatarEquippedData, 'forceRender'> & {
+    forceRender?: string[] | undefined;
+};
+
 /** @public */
 export declare const AvatarModifierArea: LastWriteWinElementSetComponentDefinition<PBAvatarModifierArea>;
 
@@ -198,9 +219,49 @@ 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>;
 
+/**
+ * @public
+ */
+export declare type AvatarShapeComponentDefinitionExtended = LastWriteWinElementSetComponentDefinition<AvatarShapeType>;
+
+export declare type AvatarShapeType = Omit<PBAvatarShape, 'forceRender'> & {
+    forceRender?: string[] | undefined;
+};
+
 /**
  * @public
  */
@@ -468,11 +529,19 @@ export declare interface ByteBuffer {
 }
 
 /**
- * Callback function to be triggered on a specified event
- * @public
+ * legacy Callback function
+ *
+ * @public @deprecated This type is no longer used in the sdk api, EventSystemCallback is
+ * used for listeners instead
  */
 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>;
 
@@ -530,6 +599,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
@@ -1304,12 +1406,17 @@ 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::GltfNodeModifiers": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfNodeModifiers>>;
+    "core::GltfNodeState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfNodeState>>;
     "core::InputModifier": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBInputModifier>>;
     "core::LightSource": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBLightSource>>;
     "core::MainCamera": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMainCamera>>;
@@ -1327,17 +1434,20 @@ export declare const componentDefinitionByName: {
     "core::RealmInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRealmInfo>>;
     "core::SkyboxTime": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBSkyboxTime>>;
     "core::TextShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTextShape>>;
+    "core::TextureCamera": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTextureCamera>>;
     "core::TriggerArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTriggerArea>>;
     "core::TriggerAreaResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBTriggerAreaResult>>;
     "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>>;
@@ -1904,10 +2014,18 @@ export declare type EntityComponents = {
     uiBackground: PBUiBackground;
     uiInput: PBUiInput;
     uiDropdown: PBUiDropdown;
-    onMouseDown: Callback;
-    onMouseUp: Callback;
-    onMouseEnter: Callback;
-    onMouseLeave: Callback;
+    onMouseDown: EventSystemCallback;
+    onMouseUp: EventSystemCallback;
+    onMouseEnter: EventSystemCallback;
+    onMouseLeave: EventSystemCallback;
+    onMouseDrag: EventSystemCallback;
+    onMouseDragLocked: EventSystemCallback;
+    onMouseDragEnd: EventSystemCallback;
+    onInputDown: MultiCallback;
+    onInputUp: MultiCallback;
+    onInputDrag: MultiCallback;
+    onInputDragLocked: MultiCallback;
+    onInputDragEnd: MultiCallback;
 };
 
 /** @public */
@@ -1985,6 +2103,13 @@ export declare type EventSystemOptions = {
     showHighlight?: boolean;
 };
 
+/**
+ * @public
+ */
+export declare type EventSystemOptionsCallback = EventSystemOptions & {
+    cb: EventSystemCallback;
+};
+
 /**
  * Excludes property keys from T where the property is assignable to U
  * @public
@@ -2059,6 +2184,9 @@ export declare type GlobalDirectionRaycastSystemOptions = {
     direction?: PBVector3;
 };
 
+/** @public */
+export declare const GlobalLight: LastWriteWinElementSetComponentDefinition<PBGlobalLight>;
+
 export declare type GlobalTargetRaycastOptions = RaycastSystemOptions & GlobalTargetRaycastSystemOptions;
 
 export declare type GlobalTargetRaycastSystemOptions = {
@@ -2071,9 +2199,24 @@ export declare const GltfContainer: LastWriteWinElementSetComponentDefinition<PB
 /** @public */
 export declare const GltfContainerLoadingState: LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>;
 
+/** @public */
+export declare const GltfNode: LastWriteWinElementSetComponentDefinition<PBGltfNode>;
+
 /** @public */
 export declare const GltfNodeModifiers: LastWriteWinElementSetComponentDefinition<PBGltfNodeModifiers>;
 
+/** @public */
+export declare const GltfNodeState: LastWriteWinElementSetComponentDefinition<PBGltfNodeState>;
+
+/**
+ * @public
+ */
+export declare const enum GltfNodeStateValue {
+    GNSV_PENDING = 0,
+    GNSV_FAILED = 1,
+    GNSV_READY = 2
+}
+
 /**
  * @public
  */
@@ -2419,6 +2562,12 @@ export declare type IInputSystem = {
      * @returns the input command info or undefined if there is no command in the last tick-update
      */
     getInputCommand: (inputAction: InputAction, pointerEventType: PointerEventType, entity?: Entity) => PBPointerEventsResult | null;
+    /**
+     * @public
+     * Get an ordered iterator over events received within the current frame.
+     * @returns the iterator
+     */
+    getInputCommands: () => Generator<PBPointerEventsResult>;
 };
 
 /**
@@ -2714,13 +2863,29 @@ export declare interface LightSourceHelper {
  */
 export declare type Listeners = {
     /** triggered on mouse down event */
-    onMouseDown?: Callback;
+    onMouseDown?: EventSystemCallback;
     /** triggered on mouse up event */
-    onMouseUp?: Callback;
+    onMouseUp?: EventSystemCallback;
     /** triggered on mouse hover event */
-    onMouseEnter?: Callback;
+    onMouseEnter?: EventSystemCallback;
     /** triggered on mouse leave event */
-    onMouseLeave?: Callback;
+    onMouseLeave?: EventSystemCallback;
+    /** triggered on mouse drag event */
+    onMouseDrag?: EventSystemCallback;
+    /** triggered on mouse drag event */
+    onMouseDragLocked?: EventSystemCallback;
+    /** triggered on mouse drag event */
+    onMouseDragEnd?: EventSystemCallback;
+    /** triggered on input down event */
+    onInputDown?: MultiCallback;
+    /** triggered on input up event */
+    onInputUp?: MultiCallback;
+    /** triggered on input drag event */
+    onInputDrag?: MultiCallback;
+    /** triggered on input drag event */
+    onInputDragLocked?: MultiCallback;
+    /** triggered on input drag event */
+    onInputDragEnd?: MultiCallback;
 };
 
 /**
@@ -3589,6 +3754,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;
@@ -3625,6 +3798,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;
 }
 
 /* Excluded from this release type: MessageBus */
@@ -3662,6 +3843,19 @@ export declare namespace MoveContinuous {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): MoveContinuous;
 }
 
+/**
+ * a record object mapping `InputAction`s to functions.
+ *
+ * @example
+ * onInputDown={{
+ *   [InputAction.IA_PRIMARY]: (eventData) => { console.log("primary") },
+ *   [InputAction.IA_SECONDARY]: () => { console.log("secondary") },
+ * }}
+ *
+ * @public
+ */
+export declare type MultiCallback = Partial<Record<InputAction, EventSystemCallback>>;
+
 export declare const Name: NameComponent;
 
 export declare type NameComponent = LastWriteWinElementSetComponentDefinition<NameType>;
@@ -4034,6 +4228,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
@@ -4260,6 +4473,8 @@ export declare namespace PBAvatarEmoteCommand {
 export declare interface PBAvatarEquippedData {
     wearableUrns: string[];
     emoteUrns: string[];
+    /** slots that will render even if hidden */
+    forceRender: string[];
 }
 
 /**
@@ -4294,6 +4509,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;
 }
 
 /**
@@ -4352,6 +4570,8 @@ export declare interface PBAvatarShape {
     emotes: string[];
     /** hides the skin + hair + facial features (default: false) */
     showOnlyWearables?: boolean | undefined;
+    /** slots that will render even if hidden */
+    forceRender: string[];
 }
 
 /**
@@ -4386,6 +4606,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.
@@ -4408,7 +4673,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
@@ -4418,6 +4683,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
@@ -4427,6 +4694,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;
 }
 
 /**
@@ -4498,6 +4768,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.
  *
@@ -4533,6 +4836,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[];
 }
 
 /**
@@ -4543,6 +4865,57 @@ 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;
+}
+
 /**
  * GltfNodeModifiers component is to be used attached to entities that have the GltfContainer component.
  *
@@ -4588,6 +4961,26 @@ export declare namespace PBGltfNodeModifiers_GltfNodeModifier {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBGltfNodeModifiers_GltfNodeModifier;
 }
 
+/**
+ * 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
  */
@@ -4723,6 +5116,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;
 }
 
 /**
@@ -4733,6 +5134,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
  */
@@ -4829,6 +5246,9 @@ export declare interface PBMeshCollider {
     } | {
         $case: "plane";
         plane: PBMeshCollider_PlaneMesh;
+    } | {
+        $case: "gltf";
+        gltf: PBMeshCollider_GltfMesh;
     } | undefined;
 }
 
@@ -4874,6 +5294,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
@@ -4906,13 +5345,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
@@ -4930,6 +5367,9 @@ export declare interface PBMeshRenderer {
     } | {
         $case: "plane";
         plane: PBMeshRenderer_PlaneMesh;
+    } | {
+        $case: "gltf";
+        gltf: PBMeshRenderer_GltfMesh;
     } | undefined;
 }
 
@@ -4977,6 +5417,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
@@ -5225,7 +5684,10 @@ export declare interface PBPrimaryPointerInfo {
     screenCoordinates?: PBVector2 | undefined;
     /** Movement since last frame (pixels) */
     screenDelta?: PBVector2 | undefined;
-    /** Direction vector for 3D ray casting */
+    /**
+     * ray direction that can be used with the primary camera origin for
+     * raycasting from the cursor into the world
+     */
     worldRayDirection?: PBVector3 | undefined;
 }
 
@@ -5451,6 +5913,46 @@ 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;
+    /**
+     * controls whether this camera acts as a receiver for audio on sources with matching `PBCameraLayers`.
+     * range: 0 (off) - 1 (full volume)
+     * default: 0
+     */
+    volume?: number | 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;
+}
+
 /**
  * The PBTriggerArea component is used to raise collision triggering events (through the TriggerAreaResult component)
  * when entities enter this component's defined area.
@@ -5629,6 +6131,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
@@ -5745,6 +6266,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
  */
@@ -5761,6 +6297,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;
 }
 
 /**
@@ -5888,6 +6428,12 @@ export declare interface PBUiTransform {
     borderRightColor?: PBColor4 | undefined;
     /** default: 1 */
     opacity?: number | undefined;
+    /** reference for scroll_position. default empty */
+    elementId?: string | undefined;
+    /** default position=(0,0) */
+    scrollPosition?: ScrollPositionValue | undefined;
+    /** default ShowScrollBar.SSB_BOTH */
+    scrollVisible?: ShowScrollBar | undefined;
     /** default: 0 — controls render stacking order. Higher values appear in front of lower values. */
     zIndex?: number | undefined;
 }
@@ -5986,7 +6532,6 @@ export declare namespace PBVideoPlayer {
  * an 'instant' transition (like using speed/time = 0)
  * * The lookAtEntity defines to which entity the Camera has to look at constantly (independent from
  * the holding entity transform).
- * * The fov defines the Field of View of the virtual camera
  */
 /**
  * @public
@@ -5994,8 +6539,6 @@ export declare namespace PBVideoPlayer {
 export declare interface PBVirtualCamera {
     defaultTransition?: CameraTransition | undefined;
     lookAtEntity?: number | undefined;
-    /** default: 60 */
-    fov?: number | undefined;
 }
 
 /**
@@ -6022,6 +6565,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
@@ -6177,11 +6739,37 @@ 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 callbacks when the user presses one of the InputButtons pointing at the entity
+     * @param pointerData - Entity to attach the callbacks, list of options to trigger Feedback, Button, and Callback
+     */
+    onPointerDown(pointerData: {
+        entity: Entity;
+        optsList: EventSystemOptionsCallback[];
+    }): void;
     /**
      * @public
      * Execute callback when the user press the InputButton pointing at the entity
      * @param pointerData - Entity to attach the callback, Opts to trigger Feedback and Button
-     * @param cb - Function to execute when click fires
      */
     onPointerDown(pointerData: {
         entity: Entity;
@@ -6194,6 +6782,15 @@ export declare interface PointerEventsSystem {
      * @param opts - Opts to trigger Feedback and Button
      */
     onPointerDown(entity: Entity, cb: EventSystemCallback, opts?: Partial<EventSystemOptions>): void;
+    /**
+     * @public
+     * Execute callbacks when the user releases one of the InputButtons pointing at the entity
+     * @param pointerData - Entity to attach the callbacks, list of options to trigger Feedback, Button, and Callback
+     */
+    onPointerUp(pointerData: {
+        entity: Entity;
+        optsList: EventSystemOptionsCallback[];
+    }): void;
     /**
      * @public
      * Execute callback when the user releases the InputButton pointing at the entity
@@ -6231,6 +6828,64 @@ export declare interface PointerEventsSystem {
         entity: Entity;
         opts?: Partial<EventSystemOptions>;
     }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callbacks when the user drags the pointer from inside the entity
+     * @param pointerData - Entity to attach the callbacks, list of options to trigger Feedback, Button, and Callback
+     */
+    onPointerDrag(pointerData: {
+        entity: Entity;
+        optsList: EventSystemOptionsCallback[];
+    }): 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 callbacks when the user drags the pointer from inside the entity, locking the cursor in place.
+     * @param pointerData - Entity to attach the callbacks, list of options to trigger Feedback, Button, and Callback
+     */
+    onPointerDragLocked(pointerData: {
+        entity: Entity;
+        optsList: EventSystemOptionsCallback[];
+    }): 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 callbacks when the user releases a button after a drag
+     * @param pointerData - Entity to attach the callbacks, list of options to trigger Feedback, Button, and Callback
+     */
+    onPointerDragEnd(pointerData: {
+        entity: Entity;
+        optsList: EventSystemOptionsCallback[];
+    }): 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;
 }
 
 /**
@@ -6247,7 +6902,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
 }
 
 /**
@@ -6278,7 +6936,10 @@ export declare const enum PointerType {
     /** POT_NONE - No pointer input */
     POT_NONE = 0,
     /** POT_MOUSE - Traditional mouse input */
-    POT_MOUSE = 1
+    POT_MOUSE = 1,
+    POT_PAD = 2,
+    POT_TOUCH = 3,
+    POT_WAND = 4
 }
 
 /**
@@ -6875,6 +7536,7 @@ export declare type RaycastSystemOptions = {
 export declare interface ReactBasedUiSystem {
     destroy(): void;
     setUiRenderer(ui: UiComponent): void;
+    setTextureRenderer(entity: Entity, ui: UiComponent): void;
 }
 
 /**
@@ -7353,6 +8015,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 */
 export declare const SkyboxTime: LastWriteWinElementSetComponentDefinition<PBSkyboxTime>;
 
@@ -7459,6 +8158,9 @@ export declare namespace Texture {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): Texture;
 }
 
+/** @public */
+export declare const TextureCamera: LastWriteWinElementSetComponentDefinition<PBTextureCamera>;
+
 /**
  * @public
  */
@@ -7569,6 +8271,9 @@ export declare interface TextureUnion {
     } | {
         $case: "videoTexture";
         videoTexture: VideoTexture;
+    } | {
+        $case: "uiTexture";
+        uiTexture: UiCanvasTexture;
     } | undefined;
 }
 
@@ -7941,7 +8646,7 @@ export declare type TweenSystem = {
 
 /**
  * @public
- * Register callback functions to a particular entity on tween events.
+ * Register callback functions to a particular entity on video events.
  */
 export declare const tweenSystem: TweenSystem;
 
@@ -7973,6 +8678,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;
 }
@@ -7992,9 +8699,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
  */
@@ -8064,6 +8793,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;
 }
@@ -8073,6 +8806,9 @@ export declare interface UiLabelProps {
  */
 export declare type uint32 = number;
 
+/** @public */
+export declare const UiScrollResult: LastWriteWinElementSetComponentDefinition<PBUiScrollResult>;
+
 /** @public */
 export declare const UiText: LastWriteWinElementSetComponentDefinition<PBUiText>;
 
@@ -8150,10 +8886,26 @@ export declare interface UiTransformProps {
     borderWidth?: Partial<Position> | PositionUnit;
     /** 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;
+}
+
 /**
  * @public
  */