@dcl/playground-assets 7.6.8-12354882097.commit-0c727b8 → 7.6.8-12529128672.commit-d6adcb3

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>;
 
@@ -519,6 +562,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
@@ -1295,9 +1371,13 @@ export declare const componentDefinitionByName: {
     "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>>;
@@ -1310,16 +1390,19 @@ export declare const componentDefinitionByName: {
     "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::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>>;
@@ -2036,6 +2119,9 @@ export declare type GlobalDirectionRaycastSystemOptions = {
     direction?: PBVector3;
 };
 
+/** @public */
+export declare const GlobalLight: LastWriteWinElementSetComponentDefinition<PBGlobalLight>;
+
 export declare type GlobalTargetRaycastOptions = RaycastSystemOptions & GlobalTargetRaycastSystemOptions;
 
 export declare type GlobalTargetRaycastSystemOptions = {
@@ -2048,6 +2134,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
  */
@@ -2651,6 +2752,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
@@ -3532,6 +3636,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;
@@ -3568,6 +3680,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;
 }
 
 /**
@@ -4240,6 +4360,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,7 +4475,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
@@ -4362,6 +4485,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
@@ -4371,6 +4496,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;
 }
 
 /**
@@ -4442,6 +4570,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.
  *
@@ -4477,6 +4638,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[];
 }
 
 /**
@@ -4487,6 +4667,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
  */
@@ -4526,6 +4777,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
@@ -4557,6 +4864,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;
 }
 
 /**
@@ -4567,6 +4882,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
  */
@@ -4579,9 +4910,9 @@ export declare interface PBMaterial_PbrMaterial {
     castShadows?: boolean | undefined;
     /** @deprecated Alpha textures are no longer supported on PBRMaterial and UnlitMaterial.alphaTexture should be used instead. */
     alphaTexture?: TextureUnion | undefined;
-    /** default = null */
+    /** default = null. Note that tilling and offset properties are ignored for this texture. */
     emissiveTexture?: TextureUnion | undefined;
-    /** default = null */
+    /** default = null. Note that tilling and offset properties are ignored for this texture. */
     bumpTexture?: TextureUnion | undefined;
     /** default = white; */
     albedoColor?: PBColor4 | undefined;
@@ -4623,7 +4954,7 @@ export declare interface PBMaterial_UnlitMaterial {
     castShadows?: boolean | undefined;
     /** default = white; */
     diffuseColor?: PBColor4 | undefined;
-    /** default = null */
+    /** default = null. Note that tilling and offset properties are ignored for this texture. */
     alphaTexture?: TextureUnion | undefined;
 }
 
@@ -4663,6 +4994,9 @@ export declare interface PBMeshCollider {
     } | {
         $case: "plane";
         plane: PBMeshCollider_PlaneMesh;
+    } | {
+        $case: "gltf";
+        gltf: PBMeshCollider_GltfMesh;
     } | undefined;
 }
 
@@ -4708,6 +5042,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
@@ -4740,13 +5093,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
@@ -4764,6 +5115,9 @@ export declare interface PBMeshRenderer {
     } | {
         $case: "plane";
         plane: PBMeshRenderer_PlaneMesh;
+    } | {
+        $case: "gltf";
+        gltf: PBMeshRenderer_GltfMesh;
     } | undefined;
 }
 
@@ -4811,6 +5165,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
@@ -5150,6 +5523,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.
  *
@@ -5230,6 +5636,9 @@ export declare interface PBTween {
     } | {
         $case: "scale";
         scale: Scale;
+    } | {
+        $case: "textureMove";
+        textureMove: TextureMove;
     } | undefined;
     /** default true (pause or running) */
     playing?: boolean | undefined;
@@ -5300,6 +5709,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
@@ -5416,6 +5844,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
  */
@@ -5432,6 +5875,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;
 }
 
 /**
@@ -5528,6 +5975,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;
 }
 
 /**
@@ -6493,6 +6950,7 @@ export declare type RaycastSystemOptions = {
 export declare interface ReactBasedUiSystem {
     destroy(): void;
     setUiRenderer(ui: UiComponent): void;
+    setTextureRenderer(entity: Entity, ui: UiComponent): void;
 }
 
 /**
@@ -6946,6 +7404,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
  */
@@ -6953,6 +7448,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.
@@ -7013,12 +7511,9 @@ export declare interface Texture {
     wrapMode?: TextureWrapMode | undefined;
     /** default = FilterMode.Bilinear */
     filterMode?: TextureFilterMode | undefined;
-    /**
-     * Final uv = offset + (input_uv * tiling)
-     * Offset for texture positioning.
-     */
+    /** Final uv = offset + (input_uv * tiling) */
     offset?: PBVector2 | undefined;
-    /** Tiling multiplier for texture repetition. */
+    /** default = Vector2.One; Tiling multiplier for texture repetition, only works for the texture property in PbrMaterial or UnlitMaterial. */
     tiling?: PBVector2 | undefined;
 }
 
@@ -7078,6 +7573,37 @@ export declare interface TextureHelper {
  */
 export declare type TextureMode = 'nine-slices' | 'center' | 'stretch';
 
+/**
+ * This tween mode allows to move the texture of a PbrMaterial or UnlitMaterial.
+ * You can also specify the movement type (offset or tiling)
+ */
+/**
+ * @public
+ */
+export declare interface TextureMove {
+    start: PBVector2 | undefined;
+    end: PBVector2 | undefined;
+    /** default = TextureMovementType.TMT_OFFSET */
+    movementType?: TextureMovementType | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace TextureMove {
+    export function encode(message: TextureMove, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): TextureMove;
+}
+
+/**
+ * @public
+ */
+export declare const enum TextureMovementType {
+    /** TMT_OFFSET - default = TextureMovementType.TMT_OFFSET */
+    TMT_OFFSET = 0,
+    TMT_TILING = 1
+}
+
 /**
  * @public
  */
@@ -7091,6 +7617,9 @@ export declare interface TextureUnion {
     } | {
         $case: "videoTexture";
         videoTexture: VideoTexture;
+    } | {
+        $case: "uiTexture";
+        uiTexture: UiCanvasTexture;
     } | undefined;
 }
 
@@ -7309,9 +7838,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
  */
@@ -7381,6 +7932,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;
 }
@@ -7390,6 +7945,9 @@ export declare interface UiLabelProps {
  */
 export declare type uint32 = number;
 
+/** @public */
+export declare const UiScrollResult: LastWriteWinElementSetComponentDefinition<PBUiScrollResult>;
+
 /** @public */
 export declare const UiText: LastWriteWinElementSetComponentDefinition<PBUiText>;
 
@@ -7462,6 +8020,16 @@ 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;
 }
 
 /**