@dcl/playground-assets 7.0.6-4153633895.commit-4aad233 → 7.0.6-4180146485.commit-9a7dde9

package/dist/alpha.d.ts

@@ -8,7 +8,7 @@ export declare const Animator: AnimatorComponentDefinitionExtended;
 /**
  * @public
  */
-export declare interface AnimatorComponentDefinitionExtended extends ComponentDefinition<PBAnimator> {
+export declare interface AnimatorComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBAnimator> {
     /**
      * @public
      *
@@ -48,11 +48,33 @@ export declare interface AnimatorComponentDefinitionExtended extends ComponentDe
     stopAllAnimations(entity: Entity, resetCursor?: boolean): boolean;
 }
 
+/**
+ * @public
+ */
+export declare type AppendValueMessage = CrdtMessageHeader & AppendValueMessageBody;
+
+/**
+ * Min. length = header (8 bytes) + 16 bytes = 24 bytes
+ *
+ * @param entity - Uint32 number of the entity
+ * @param componentId - Uint32 number of id
+ * @param timestamp - Uint32 timestamp
+ * @param data - Uint8[] data of component => length(4 bytes) + block of bytes[0..length-1]
+ * @public
+ */
+export declare type AppendValueMessageBody = {
+    type: CrdtMessageType.APPEND_VALUE;
+    entityId: Entity;
+    componentId: number;
+    timestamp: number;
+    data: Uint8Array;
+};
+
 /** @public */
-export declare const AudioSource: ComponentDefinition<PBAudioSource>;
+export declare const AudioSource: LastWriteWinElementSetComponentDefinition<PBAudioSource>;
 
 /** @public */
-export declare const AudioStream: ComponentDefinition<PBAudioStream>;
+export declare const AudioStream: LastWriteWinElementSetComponentDefinition<PBAudioStream>;
 
 /**
  * @public
@@ -65,10 +87,10 @@ export declare const enum AvatarAnchorPointType {
 }
 
 /** @public */
-export declare const AvatarAttach: ComponentDefinition<PBAvatarAttach>;
+export declare const AvatarAttach: LastWriteWinElementSetComponentDefinition<PBAvatarAttach>;
 
 /** @public */
-export declare const AvatarModifierArea: ComponentDefinition<PBAvatarModifierArea>;
+export declare const AvatarModifierArea: LastWriteWinElementSetComponentDefinition<PBAvatarModifierArea>;
 
 /**
  * @public
@@ -79,7 +101,7 @@ export declare const enum AvatarModifierType {
 }
 
 /** @public */
-export declare const AvatarShape: ComponentDefinition<PBAvatarShape>;
+export declare const AvatarShape: LastWriteWinElementSetComponentDefinition<PBAvatarShape>;
 
 /**
  * @public
@@ -116,8 +138,52 @@ export declare const enum BackgroundTextureMode {
     STRETCH = 2
 }
 
+/**
+ * @public
+ */
+export declare interface BaseComponent<T> {
+    readonly componentId: number;
+    readonly componentName: string;
+    readonly componentType: ComponentType;
+    readonly schema: ISchema<T>;
+    /**
+     * This function receives a CRDT update and returns a touple with a "conflict
+     * resoluton" message, in case of the sender being updated or null in case of noop/accepted
+     * change. The second element of the touple is the modified/changed/deleted value.
+     * @public
+     */
+    updateFromCrdt(body: CrdtMessageBody): [null | ConflictResolutionMessage, T | undefined];
+    /**
+     * This function returns an iterable with all the CRDT updates that need to be
+     * broadcasted to other actors in the system. After returning, this function
+     * clears the internal dirty state. Updates are produced only once.
+     * @public
+     */
+    getCrdtUpdates(): Iterable<CrdtMessageBody>;
+    /**
+     * @public
+     * Marks the entity as deleted and signals it cannot be used ever again. It must
+     * clear the component internal state, produces a synchronization message to remove
+     * the component from the entity.
+     * @param entity - Entity ID that was deleted.
+     */
+    entityDeleted(entity: Entity, markAsDirty: boolean): void;
+    /**
+     * Get if the entity has this component
+     * @param entity - entity to test
+     */
+    has(entity: Entity): boolean;
+    /**
+     * Get the readonly component of the entity (to mutate it, use getMutable instead),
+     * throws an error if the entity doesn't have the component.
+     * @param entity - Entity that will be used to get the component
+     * @returns
+     */
+    get(entity: Entity): any;
+}
+
 /** @public */
-export declare const Billboard: ComponentDefinition<PBBillboard>;
+export declare const Billboard: LastWriteWinElementSetComponentDefinition<PBBillboard>;
 
 /**
  * @public
@@ -267,10 +333,10 @@ export declare interface ByteBuffer {
 export declare type Callback = () => void;
 
 /** @public */
-export declare const CameraMode: ComponentDefinition<PBCameraMode>;
+export declare const CameraMode: LastWriteWinElementSetComponentDefinition<PBCameraMode>;
 
 /** @public */
-export declare const CameraModeArea: ComponentDefinition<PBCameraModeArea>;
+export declare const CameraModeArea: LastWriteWinElementSetComponentDefinition<PBCameraModeArea>;
 
 /**
  * @public
@@ -999,94 +1065,23 @@ export declare type Color4Type = {
 /**
  * @public
  */
-export declare interface ComponentDefinition<T> {
-    readonly componentId: number;
-    readonly componentName: string;
-    /**
-     * Return the default value of the current component
-     */
-    default(): DeepReadonly<T>;
-    /**
-     * Get if the entity has this component
-     * @param entity - entity to test
-     */
-    has(entity: Entity): boolean;
-    /**
-     * Get the readonly component of the entity (to mutate it, use getMutable instead), throw an error if the entity doesn't have the component.
-     * @param entity - Entity that will be used to get the component
-     * @returns
-     */
-    get(entity: Entity): DeepReadonly<T>;
-    /**
-     * Get the readonly component of the entity (to mutate it, use getMutable instead), or null if the entity doesn't have the component.
-     * @param entity - Entity that will be used to try to get the component
-     */
-    getOrNull(entity: Entity): DeepReadonly<T> | null;
-    /**
-     * Add the current component to an entity, throw an error if the component already exists (use `createOrReplace` instead).
-     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
-     * @param entity - Entity that will be used to create the component
-     * @param val - The initial value
-     */
-    create(entity: Entity, val?: T): T;
-    /**
-     * Add the current component to an entity or replace the content if the entity already has the component
-     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
-     * @param entity - Entity that will be used to create or replace the component
-     * @param val - The initial or new value
-     */
-    createOrReplace(entity: Entity, val?: T): T;
-    /**
-     * @public
-     * Delete the current component to an entity, return null if the entity doesn't have the current component.
-     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
-     * @param entity - Entity to delete the component from
-     */
-    deleteFrom(entity: Entity): T | null;
-    /**
-     * @public
-     * Marks the entity as deleted and signals it cannot be used ever again. It must
-     * clear the component internal state, produces a synchronization message to remove
-     * the component from the entity.
-     * @param entity - Entity to delete the component from
-     */
-    entityDeleted(entity: Entity, markAsDirty: boolean): void;
-    /**
-     * Get the mutable component of the entity, throw an error if the entity doesn't have the component.
-     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
-     * @param entity - Entity to get the component from
-     */
-    getMutable(entity: Entity): T;
-    /**
-     * Get the mutable component of the entity, return null if the entity doesn't have the component.
-     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
-     * @param entity - Entity to get the component from
-     */
-    getMutableOrNull(entity: Entity): T | null;
-    /**
-     * This function receives a CRDT update and returns a touple with a "conflict
-     * resoluton" message, in case of the sender being updated or null in case of noop/accepted
-     * change. The second element of the touple is the modified/changed/deleted value.
-     * @public
-     */
-    updateFromCrdt(body: CrdtMessageBody): [null | PutComponentMessageBody | DeleteComponentMessageBody, T | null];
-    /**
-     * This function returns an iterable with all the CRDT updates that need to be
-     * broadcasted to other actors in the system. After returning, this function
-     * clears the internal dirty state. Updates are produced only once.
-     * @public
-     */
-    getCrdtUpdates(): Iterable<CrdtMessageBody>;
-}
+export declare type ComponentDefinition<T> = LastWriteWinElementSetComponentDefinition<T> | GrowOnlyValueSetComponentDefinition<T>;
 
-export declare type ComponentGetter<T extends ComponentDefinition<any>> = (engine: Pick<IEngine, 'defineComponentFromSchema'>) => T;
+/**
+ * Component types are used to pick the wire protocol and the conflict resolution algorithm
+ * @public
+ */
+export declare const enum ComponentType {
+    LastWriteWinElementSet = 0,
+    GrowOnlyValueSet = 1
+}
 
 /**
+ * A conflict resolution message is the response to an outdated or invalid state
+ * in the CRDT.
  * @public
  */
-export declare type ComponentSchema<T extends [ComponentDefinition<any>, ...ComponentDefinition<any>[]]> = {
-    [K in keyof T]: T[K] extends ComponentDefinition<any> ? ReturnType<T[K]['getMutable']> : never;
-};
+export declare type ConflictResolutionMessage = PutComponentMessageBody | DeleteComponentMessageBody;
 
 /**
  * @public
@@ -1096,12 +1091,12 @@ export declare const CRDT_MESSAGE_HEADER_LENGTH = 8;
 /**
  * @public
  */
-export declare type CrdtMessage = PutComponentMessage | DeleteComponentMessage | DeleteEntityMessage;
+export declare type CrdtMessage = PutComponentMessage | DeleteComponentMessage | DeleteEntityMessage | AppendValueMessage;
 
 /**
  * @public
  */
-export declare type CrdtMessageBody = PutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody;
+export declare type CrdtMessageBody = PutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody;
 
 /**
  * Min length = 8 bytes
@@ -1123,7 +1118,8 @@ export declare enum CrdtMessageType {
     PUT_COMPONENT = 1,
     DELETE_COMPONENT = 2,
     DELETE_ENTITY = 3,
-    MAX_MESSAGE_TYPE = 4
+    APPEND_VALUE = 4,
+    MAX_MESSAGE_TYPE = 5
 }
 
 export declare function createEthereumProvider(): {
@@ -1131,10 +1127,6 @@ export declare function createEthereumProvider(): {
     sendAsync(message: RPCSendableMessage, callback: (error: Error | null, result?: any) => void): void;
 };
 
-export declare function createGetCrdtMessages(componentId: number, timestamps: Map<Entity, number>, dirtyIterator: Set<Entity>, schema: Pick<ISchema<any>, 'serialize'>, data: Map<Entity, unknown>): () => Generator<PutComponentMessageBody | DeleteComponentMessageBody, void, unknown>;
-
-export declare function createUpdateFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (msg: CrdtMessageBody) => [null | PutComponentMessageBody | DeleteComponentMessageBody, any];
-
 /**
  * Transform parenting: cyclic dependency checker
  * It checks only in modified Transforms
@@ -1155,12 +1147,12 @@ export declare function cyclicParentingChecker(engine: IEngine): () => void;
 /**
  * @public
  */
-export declare type DeepReadonly<T> = T extends ReadonlyPrimitive ? T : T extends Map<infer K, infer V> ? DeepReadonlyMap<K, V> : T extends Set<infer M> ? DeepReadonlySet<M> : DeepReadonlyObject<T>;
+export declare type DeepReadonly<T> = T extends ReadonlyPrimitive ? T : T extends Array<infer K> ? ReadonlyArray<DeepReadonly<K>> : T extends Map<infer K, infer V> ? DeepReadonlyMap<K, V> : T extends Set<infer M> ? DeepReadonlySet<M> : DeepReadonlyObject<T>;
 
 /**
  * @public
  */
-export declare type DeepReadonlyMap<K, V> = ReadonlyMap<DeepReadonly<K>, DeepReadonly<V>>;
+export declare type DeepReadonlyMap<K, V> = ReadonlyMap<K, DeepReadonly<V>>;
 
 /**
  * @public
@@ -1349,7 +1341,7 @@ export declare const Epsilon = 0.000001;
 /**
  * @public
  */
-export declare type EventSystemCallback = (event: PBPointerEventsResult_PointerCommand) => void;
+export declare type EventSystemCallback = (event: PBPointerEventsResult) => void;
 
 /**
  * @public
@@ -1418,7 +1410,30 @@ export declare type GlobalInputEventResult = InputEventResult & {
 };
 
 /** @public */
-export declare const GltfContainer: ComponentDefinition<PBGltfContainer>;
+export declare const GltfContainer: LastWriteWinElementSetComponentDefinition<PBGltfContainer>;
+
+/**
+ * @public
+ */
+export declare interface GrowOnlyValueSetComponentDefinition<T> extends BaseComponent<T> {
+    readonly componentType: ComponentType.GrowOnlyValueSet;
+    /**
+     * Appends an element to the set.
+     * @param entity - Entity that will host the value
+     * @param val - The final value. The Set will freeze the value, it won't be editable from
+     * the script.
+     */
+    addValue(entity: Entity, val: DeepReadonly<T>): DeepReadonlySet<T>;
+    /**
+     * Get the readonly component of the entity (to mutate it, use getMutable instead),
+     * throws an error if the entity doesn't have the component.
+     * @param entity - Entity that will be used to get the component
+     * @returns
+     */
+    get(entity: Entity): DeepReadonlySet<T>;
+}
+
+export declare type GSetComponentGetter<T extends GrowOnlyValueSetComponentDefinition<any>> = (engine: Pick<IEngine, 'defineValueSetComponentFromSchema'>) => T;
 
 /**
  * @public
@@ -1513,7 +1528,21 @@ export declare interface IEngine {
      * const StateComponent = engine.defineComponentFromSchema("my-lib::VisibleComponent", Schemas.Bool)
      * ```
      */
-    defineComponentFromSchema<T>(componentName: string, spec: ISchema<T>): ComponentDefinition<T>;
+    defineComponentFromSchema<T>(componentName: string, spec: ISchema<T>): LastWriteWinElementSetComponentDefinition<T>;
+    /**
+     * @public
+     * Defines a value set component.
+     * @param componentName - unique name to identify the component, a hash is calculated for it, it will fail if the hash has collisions.
+     * @param spec - An object with schema fields
+     * @returns The component definition
+     *
+     * @example
+     * ```ts
+     * const StateComponentId = 10023
+     * const StateComponent = engine.defineValueSetComponentFromSchema("my-lib::VisibleComponent", Schemas.Int)
+     * ```
+     */
+    defineValueSetComponentFromSchema<T>(componentName: string, spec: ISchema<T>, options: ValueSetOptions<T>): GrowOnlyValueSetComponentDefinition<T>;
     /**
      * @public
      * Get the component definition from the component id.
@@ -1733,7 +1762,7 @@ export declare type IInputSystem = {
      * @param entity - the entity to query, ignore for global
      * @returns boolean
      */
-    isTriggered: (inputAction: InputAction, pointerEventType: PointerEventType, entity?: Entity) => boolean;
+    isTriggered: (inputAction: InputAction, pointerEventType: PointerEventType, entity: Entity) => boolean;
     /**
      * @public
      * Check if an input action is currently being pressed.
@@ -1749,7 +1778,7 @@ export declare type IInputSystem = {
      * @param entity - the entity to query, ignore for global
      * @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_PointerCommand | null;
+    getInputCommand: (inputAction: InputAction, pointerEventType: PointerEventType, entity: Entity) => PBPointerEventsResult | null;
 };
 
 /**
@@ -1760,8 +1789,6 @@ export declare type IncludeUndefined<T> = {
     [P in keyof T]: undefined extends T[P] ? P : never;
 }[keyof T];
 
-export declare function incrementTimestamp(entity: Entity, timestamps: Map<Entity, number>): number;
-
 /**
  * @public
  * Input component
@@ -1829,10 +1856,10 @@ export declare const inputSystem: IInputSystem;
  * @public
  */
 export declare interface ISchema<T = any> {
-    serialize(value: T, builder: ByteBuffer): void;
+    serialize(value: DeepReadonly<T>, builder: ByteBuffer): void;
     deserialize(reader: ByteBuffer): T;
     create(): T;
-    extend?: (base?: T) => T;
+    extend?: (base: Partial<DeepReadonly<T>> | undefined) => T;
 }
 
 /**
@@ -1871,6 +1898,58 @@ export declare type Key = number | string;
  */
 export declare function Label(props: EntityPropTypes & UiLabelProps): ReactEcs.JSX.Element;
 
+/**
+ * @public
+ */
+export declare interface LastWriteWinElementSetComponentDefinition<T> extends BaseComponent<T> {
+    readonly componentType: ComponentType.LastWriteWinElementSet;
+    /**
+     * Get the readonly component of the entity (to mutate it, use getMutable instead),
+     * throws an error if the entity doesn't have the component.
+     * @param entity - Entity that will be used to get the component
+     * @returns
+     */
+    get(entity: Entity): DeepReadonly<T>;
+    /**
+     * Get the readonly component of the entity (to mutate it, use getMutable instead), or null if the entity doesn't have the component.
+     * @param entity - Entity that will be used to try to get the component
+     */
+    getOrNull(entity: Entity): DeepReadonly<T> | null;
+    /**
+     * Add the current component to an entity, throw an error if the component already exists (use `createOrReplace` instead).
+     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
+     * @param entity - Entity that will be used to create the component
+     * @param val - The initial value
+     */
+    create(entity: Entity, val?: T): T;
+    /**
+     * Add the current component to an entity or replace the content if the entity already has the component
+     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
+     * @param entity - Entity that will be used to create or replace the component
+     * @param val - The initial or new value
+     */
+    createOrReplace(entity: Entity, val?: T): T;
+    /**
+     * @public
+     * Delete the current component to an entity, return null if the entity doesn't have the current component.
+     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
+     * @param entity - Entity to delete the component from
+     */
+    deleteFrom(entity: Entity): T | null;
+    /**
+     * Get the mutable component of the entity, throw an error if the entity doesn't have the component.
+     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
+     * @param entity - Entity to get the component from
+     */
+    getMutable(entity: Entity): T;
+    /**
+     * Get the mutable component of the entity, return null if the entity doesn't have the component.
+     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
+     * @param entity - Entity to get the component from
+     */
+    getMutableOrNull(entity: Entity): T | null;
+}
+
 /**
  * User key event Listeners
  * @public
@@ -1882,11 +1961,13 @@ export declare type Listeners = {
     onMouseUp?: Callback;
 };
 
+export declare type LwwComponentGetter<T extends LastWriteWinElementSetComponentDefinition<any>> = (engine: Pick<IEngine, 'defineComponentFromSchema'>) => T;
+
 /**
  * @public
  * Overrides component definition to support partial default values
  */
-export declare interface MapComponentDefinition<T> extends ComponentDefinition<T> {
+export declare interface MapComponentDefinition<T> extends LastWriteWinElementSetComponentDefinition<T> {
     /**
      * Add the current component to an entity, throw an error if the component already exists (use `createOrReplace` instead).
      * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
@@ -1915,7 +1996,7 @@ export declare const Material: MaterialComponentDefinitionExtended;
 /**
  * @public
  */
-export declare interface MaterialComponentDefinitionExtended extends ComponentDefinition<PBMaterial> {
+export declare interface MaterialComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBMaterial> {
     /**
      * Texture helpers with constructor
      */
@@ -2681,7 +2762,7 @@ export declare const MeshCollider: MeshColliderComponentDefinitionExtended;
 /**
  * @public
  */
-export declare interface MeshColliderComponentDefinitionExtended extends ComponentDefinition<PBMeshCollider> {
+export declare interface MeshColliderComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBMeshCollider> {
     /**
      * @public
      * Set a box in the MeshCollider component
@@ -2719,7 +2800,7 @@ export declare const MeshRenderer: MeshRendererComponentDefinitionExtended;
 /**
  * @public
  */
-export declare interface MeshRendererComponentDefinitionExtended extends ComponentDefinition<PBMeshRenderer> {
+export declare interface MeshRendererComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBMeshRenderer> {
     /**
      * @public
      * Set a box in the MeshRenderer component
@@ -2789,7 +2870,7 @@ export declare const enum NftFrameType {
 }
 
 /** @public */
-export declare const NftShape: ComponentDefinition<PBNftShape>;
+export declare const NftShape: LastWriteWinElementSetComponentDefinition<PBNftShape>;
 
 export declare class Observable<T> {
     private _observers;
@@ -2833,7 +2914,7 @@ export declare class ObserverEventState {
 /**
  * @public
  */
-export declare type OnChangeFunction = (entity: Entity, operation: CrdtMessageType, component?: ComponentDefinition<any>) => void;
+export declare type OnChangeFunction = (entity: Entity, operation: CrdtMessageType, component?: ComponentDefinition<any>, componentValue?: any) => void;
 
 export declare const onCommsMessage: Observable<{
     sender: string;
@@ -3271,20 +3352,11 @@ export declare interface PBPointerEvents_Info {
     showFeedback?: boolean | undefined;
 }
 
-/** the renderer will set this component to the root entity once per frame with all the events */
+/** renderer append a new object of this in each command, there can be many commands per frames */
 /**
  * @public
  */
 export declare interface PBPointerEventsResult {
-    /** a list of the last N pointer commands (from the engine) */
-    commands: PBPointerEventsResult_PointerCommand[];
-}
-
-/** this message represents a pointer event, used both for UP and DOWN actions */
-/**
- * @public
- */
-export declare interface PBPointerEventsResult_PointerCommand {
     /** identifier of the input */
     button: InputAction;
     hit: RaycastHit | undefined;
@@ -3698,10 +3770,10 @@ export declare namespace Plane {
 }
 
 /** @public */
-export declare const PointerEvents: ComponentDefinition<PBPointerEvents>;
+export declare const PointerEvents: LastWriteWinElementSetComponentDefinition<PBPointerEvents>;
 
 /** @public */
-export declare const PointerEventsResult: ComponentDefinition<PBPointerEventsResult>;
+export declare const PointerEventsResult: GrowOnlyValueSetComponentDefinition<PBPointerEventsResult>;
 
 /**
  * @public
@@ -3754,7 +3826,7 @@ export declare const enum PointerEventType {
 }
 
 /** @public */
-export declare const PointerLock: ComponentDefinition<PBPointerLock>;
+export declare const PointerLock: LastWriteWinElementSetComponentDefinition<PBPointerLock>;
 
 /**
  * Type used for defining the position of the element. i.e. margin, padding
@@ -3767,6 +3839,20 @@ export declare interface Position {
     left: PositionUnit;
 }
 
+/**
+ * The values are in clockwise order, beginning at the top: top, right, bottom, then left
+
+ * When one value is specified, it applies the same margin to all four sides.
+ *
+ * When two values are specified, the first margin applies to the top and bottom, the second to the left and right.
+ *
+ * When three values are specified, the first margin applies to the top, the second to the left and right, the third to the bottom.
+ *
+ When four values are specified, the margins apply to the top, right, bottom, and left in that order (clockwise).
+ * @public
+ */
+export declare type PositionShorthand = PositionUnit | `${PositionUnit} ${PositionUnit}` | `${PositionUnit} ${PositionUnit} ${PositionUnit}` | `${PositionUnit} ${PositionUnit} ${PositionUnit} ${PositionUnit}`;
+
 /**
  * @public
  * The position property specifies the type of positioning method used for an element
@@ -3774,11 +3860,10 @@ export declare interface Position {
 export declare type PositionType = 'absolute' | 'relative';
 
 /**
- * Position unit for the user.
- * i.e. width="100", width="100%", width="100px"
+ * unit value specified. i.e. 1 || '100%' || '1px'
  * @public
  */
-export declare type PositionUnit = `${number}px` | `${number}%` | number;
+export declare type PositionUnit = `${number}px` | `${number}%` | number | `${number}`;
 
 export declare enum ProcessMessageResultType {
     /**
@@ -4111,7 +4196,7 @@ export declare type QuaternionType = {
 export declare const RAD2DEG: number;
 
 /** @public */
-export declare const Raycast: ComponentDefinition<PBRaycast>;
+export declare const Raycast: LastWriteWinElementSetComponentDefinition<PBRaycast>;
 
 /** Position will be relative to the scene */
 /**
@@ -4142,7 +4227,7 @@ export declare type RaycastResponsePayload<T> = {
 };
 
 /** @public */
-export declare const RaycastResult: ComponentDefinition<PBRaycastResult>;
+export declare const RaycastResult: LastWriteWinElementSetComponentDefinition<PBRaycastResult>;
 
 /**
  * @public
@@ -4491,7 +4576,7 @@ export declare const enum TextAlignMode {
 export declare type TextAlignType = 'top-left' | 'top-center' | 'top-right' | 'middle-left' | 'middle-center' | 'middle-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
 
 /** @public */
-export declare const TextShape: ComponentDefinition<PBTextShape>;
+export declare const TextShape: LastWriteWinElementSetComponentDefinition<PBTextShape>;
 
 /**
  * @public
@@ -4605,7 +4690,7 @@ export declare const Transform: TransformComponentExtended;
 /**
  * @public
  */
-export declare type TransformComponent = ComponentDefinition<TransformType>;
+export declare type TransformComponent = LastWriteWinElementSetComponentDefinition<TransformType>;
 
 /**
  * @public
@@ -4668,7 +4753,7 @@ export declare interface UiAvatarTexture {
 }
 
 /** @public */
-export declare const UiBackground: ComponentDefinition<PBUiBackground>;
+export declare const UiBackground: LastWriteWinElementSetComponentDefinition<PBUiBackground>;
 
 /**
  * @public
@@ -4706,7 +4791,7 @@ export declare interface UiButtonProps extends UiLabelProps, EntityPropTypes {
 export declare type UiComponent = () => ReactEcs.JSX.Element;
 
 /** @public */
-export declare const UiDropdown: ComponentDefinition<PBUiDropdown>;
+export declare const UiDropdown: LastWriteWinElementSetComponentDefinition<PBUiDropdown>;
 
 /**
  * @public
@@ -4719,13 +4804,15 @@ export declare interface UiDropdownProps extends EntityPropTypes, Omit<Partial<P
 }
 
 /** @public */
-export declare const UiDropdownResult: ComponentDefinition<PBUiDropdownResult>;
+export declare const UiDropdownResult: LastWriteWinElementSetComponentDefinition<PBUiDropdownResult>;
 
 /**
  * @public
  * @category Component
  */
-export declare function UiEntity(props: EntityPropTypes): ReactEcs.JSX.Element;
+export declare function UiEntity(props: EntityPropTypes & {
+    uiText?: UiLabelProps;
+}): ReactEcs.JSX.Element;
 
 /**
  * @public
@@ -4733,7 +4820,7 @@ export declare function UiEntity(props: EntityPropTypes): ReactEcs.JSX.Element;
 export declare type UiFontType = 'sans-serif' | 'serif' | 'monospace';
 
 /** @public */
-export declare const UiInput: ComponentDefinition<PBUiInput>;
+export declare const UiInput: LastWriteWinElementSetComponentDefinition<PBUiInput>;
 
 /**
  * @public
@@ -4746,7 +4833,7 @@ export declare interface UiInputProps extends Omit<PBUiInput, 'font' | 'textAlig
 }
 
 /** @public */
-export declare const UiInputResult: ComponentDefinition<PBUiInputResult>;
+export declare const UiInputResult: LastWriteWinElementSetComponentDefinition<PBUiInputResult>;
 
 /**
  * Label component props
@@ -4771,7 +4858,7 @@ export declare interface UiLabelProps {
 export declare type uint32 = number;
 
 /** @public */
-export declare const UiText: ComponentDefinition<PBUiText>;
+export declare const UiText: LastWriteWinElementSetComponentDefinition<PBUiText>;
 
 /**
  * Texture
@@ -4784,7 +4871,7 @@ export declare type UiTexture = {
 };
 
 /** @public */
-export declare const UiTransform: ComponentDefinition<PBUiTransform>;
+export declare const UiTransform: LastWriteWinElementSetComponentDefinition<PBUiTransform>;
 
 /**
  * Layout props to position things in the canvas
@@ -4808,11 +4895,11 @@ export declare interface UiTransformProps {
     /** The flex-direction property sets how flex items are placed in the flex container defining the main axis and the direction (normal or reversed). */
     flexDirection?: FlexDirectionType;
     /** The position property sets how an element is positioned in a document. The top, right, bottom, and left properties determine the final location of positioned elements. */
-    position?: Partial<Position>;
+    position?: Partial<Position> | PositionShorthand;
     /** The padding shorthand property sets the padding area on all four sides of an element at once. */
-    padding?: Partial<Position>;
+    padding?: Partial<Position> | PositionShorthand;
     /** The margin shorthand property sets the margin area on all four sides of an element. */
-    margin?: Partial<Position>;
+    margin?: Partial<Position> | PositionShorthand;
     /** The width property specifies the width of an element. */
     width?: PositionUnit;
     /** The height property specifies the height of an element. */
@@ -4842,6 +4929,14 @@ export declare interface UiTransformProps {
  */
 export declare type Unpacked<T> = T extends (infer U)[] ? U : T;
 
+/**
+ * @public
+ */
+export declare type ValueSetOptions<T> = {
+    timestampFunction: (value: DeepReadonly<T>) => number;
+    maxElements: number;
+};
+
 /**
  * @public
  * Vector3 is a type and a namespace.
@@ -5446,7 +5541,7 @@ export declare type Vector3Type = {
 };
 
 /** @public */
-export declare const VideoPlayer: ComponentDefinition<PBVideoPlayer>;
+export declare const VideoPlayer: LastWriteWinElementSetComponentDefinition<PBVideoPlayer>;
 
 /**
  * @public
@@ -5460,7 +5555,7 @@ export declare interface VideoTexture {
 }
 
 /** @public */
-export declare const VisibilityComponent: ComponentDefinition<PBVisibilityComponent>;
+export declare const VisibilityComponent: LastWriteWinElementSetComponentDefinition<PBVisibilityComponent>;
 
 /**
  * @public