@dcl/playground-assets 7.31.1-40962203448.commit-c68a75f → 7.31.1-41498712919.commit-5e4cada

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/beta.d.ts CHANGED
@@ -245,6 +245,42 @@ export declare interface AudioStreamComponentDefinitionExtended extends LastWrit
245
245
  getAudioState(entity: Entity): PBAudioEvent | undefined;
246
246
  }
247
247
 
248
+ /**
249
+ * @public
250
+ */
251
+ export declare type AuthoritativePutComponentMessage = CrdtMessageHeader & AuthoritativePutComponentMessageBody;
252
+
253
+ /**
254
+ * Server authoritative message - identical to PutComponentMessageBody but with forced processing
255
+ * Min. length = header (8 bytes) + 16 bytes = 24 bytes
256
+ *
257
+ * @param entity - Uint32 number of the entity
258
+ * @param componentId - Uint32 number of id
259
+ * @param timestamp - Uint32 Lamport timestamp (server's authoritative timestamp)
260
+ * @param data - Uint8[] data of component => length(4 bytes) + block of bytes[0..length-1]
261
+ * @public
262
+ */
263
+ export declare type AuthoritativePutComponentMessageBody = {
264
+ type: CrdtMessageType.AUTHORITATIVE_PUT_COMPONENT;
265
+ entityId: Entity;
266
+ componentId: number;
267
+ timestamp: number;
268
+ data: Uint8Array;
269
+ };
270
+
271
+ /**
272
+ * @public
273
+ */
274
+ export declare namespace AuthoritativePutComponentOperation {
275
+ const MESSAGE_HEADER_LENGTH = 16;
276
+ /**
277
+ * Call this function for an optimal writing data passing the ByteBuffer
278
+ * already allocated
279
+ */
280
+ export function write(entity: Entity, timestamp: number, componentId: number, data: Uint8Array, buf: ByteBuffer): void;
281
+ export function read(buf: ByteBuffer): AuthoritativePutComponentMessage | null;
282
+ }
283
+
248
284
  /** AvatarAnchorPointType determines the part of the avatar's body that anchors the Entity. */
249
285
  /**
250
286
  * @public
@@ -420,6 +456,22 @@ export declare interface BaseComponent<T> {
420
456
  * If the value is undefined, the component was deleted.
421
457
  */
422
458
  onChange(entity: Entity, cb: (value: T | undefined) => void): void;
459
+ /**
460
+ * @public
461
+ *
462
+ */
463
+ validateBeforeChange(entity: Entity, cb: ValidateCallback<T>): void;
464
+ validateBeforeChange(cb: ValidateCallback<T>): void;
465
+ /**
466
+ * Get the CRDT state for an entity (serialized data and timestamp)
467
+ * @param entity - Entity to get the CRDT state for
468
+ * @returns Object with serialized data and timestamp, or null if entity doesn't have the component
469
+ * @public
470
+ */
471
+ getCrdtState(entity: Entity): {
472
+ data: Uint8Array;
473
+ timestamp: number;
474
+ } | null;
423
475
  }
424
476
 
425
477
  /** @public */
@@ -1387,44 +1439,6 @@ export declare type Color4Type = {
1387
1439
  a: number;
1388
1440
  };
1389
1441
 
1390
- /**
1391
- * Piecewise-linear, with keys interpolated in ascending order of `time`. Positions before the first key
1392
- * or after the last key take that key's color. No keys means the gradient is unset.
1393
- * If two keys have the same `time`, then the gradient keeps the key that comes later in `keys`.
1394
- */
1395
- /**
1396
- * @public
1397
- */
1398
- export declare interface ColorGradient {
1399
- keys: ColorKey[];
1400
- }
1401
-
1402
- /**
1403
- * @public
1404
- */
1405
- export declare namespace ColorGradient {
1406
- export function encode(message: ColorGradient, writer?: _m0.Writer): _m0.Writer;
1407
- export function decode(input: _m0.Reader | Uint8Array, length?: number): ColorGradient;
1408
- }
1409
-
1410
- /**
1411
- * @public
1412
- */
1413
- export declare interface ColorKey {
1414
- /** position along the gradient, from 0 to 1. Values outside that range clamp to it */
1415
- time: number;
1416
- /** linear color. Values above 1 are allowed (HDR) */
1417
- color: PBColor4 | undefined;
1418
- }
1419
-
1420
- /**
1421
- * @public
1422
- */
1423
- export declare namespace ColorKey {
1424
- export function encode(message: ColorKey, writer?: _m0.Writer): _m0.Writer;
1425
- export function decode(input: _m0.Reader | Uint8Array, length?: number): ColorKey;
1426
- }
1427
-
1428
1442
  /** A range of Color4 values. Randomized or lerped between start and end. */
1429
1443
  /**
1430
1444
  * @public
@@ -1491,7 +1505,6 @@ export declare const componentDefinitionByName: {
1491
1505
  "core::CameraMode": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
1492
1506
  "core::CameraModeArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraModeArea>>;
1493
1507
  "core::EngineInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBEngineInfo>>;
1494
- "core::EnvironmentFog": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBEnvironmentFog>>;
1495
1508
  "core::ExplorerItemPurchaseResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>>;
1496
1509
  "core::ExplorerUiEventsResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerUiEventsResult>>;
1497
1510
  "core::GltfContainer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
@@ -1515,9 +1528,7 @@ export declare const componentDefinitionByName: {
1515
1528
  "core::Raycast": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycast>>;
1516
1529
  "core::RaycastResult": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycastResult>>;
1517
1530
  "core::RealmInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRealmInfo>>;
1518
- "core::Skybox": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBSkybox>>;
1519
1531
  "core::SkyboxTime": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBSkyboxTime>>;
1520
- "core::Sun": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBSun>>;
1521
1532
  "core::TextShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTextShape>>;
1522
1533
  "core::TouchScreenControls": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTouchScreenControls>>;
1523
1534
  "core::TriggerArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBTriggerArea>>;
@@ -1704,12 +1715,12 @@ export declare const CRDT_MESSAGE_HEADER_LENGTH = 8;
1704
1715
  /**
1705
1716
  * @public
1706
1717
  */
1707
- export declare type CrdtMessage = PutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
1718
+ export declare type CrdtMessage = PutComponentMessage | AuthoritativePutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
1708
1719
 
1709
1720
  /**
1710
1721
  * @public
1711
1722
  */
1712
- export declare type CrdtMessageBody = PutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
1723
+ export declare type CrdtMessageBody = PutComponentMessageBody | AuthoritativePutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
1713
1724
 
1714
1725
  /**
1715
1726
  * Min length = 8 bytes
@@ -1764,7 +1775,8 @@ export declare enum CrdtMessageType {
1764
1775
  PUT_COMPONENT_NETWORK = 5,
1765
1776
  DELETE_COMPONENT_NETWORK = 6,
1766
1777
  DELETE_ENTITY_NETWORK = 7,
1767
- MAX_MESSAGE_TYPE = 8
1778
+ AUTHORITATIVE_PUT_COMPONENT = 8,
1779
+ MAX_MESSAGE_TYPE = 9
1768
1780
  }
1769
1781
 
1770
1782
  /**
@@ -1772,6 +1784,8 @@ export declare enum CrdtMessageType {
1772
1784
  */
1773
1785
  export declare type CrdtNetworkMessageBody = PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody | DeleteEntityNetworkMessageBody;
1774
1786
 
1787
+ export declare const CreatedBy: ICreatedBy;
1788
+
1775
1789
  /**
1776
1790
  * @public
1777
1791
  */
@@ -2208,9 +2222,6 @@ export declare namespace EntityUtils {
2208
2222
  export function toEntityId(entityNumber: number, entityVersion: number): Entity;
2209
2223
  }
2210
2224
 
2211
- /** @public */
2212
- export declare const EnvironmentFog: LastWriteWinElementSetComponentDefinition<PBEnvironmentFog>;
2213
-
2214
2225
  /**
2215
2226
  * Constant used to define the minimal number value in Babylon.js
2216
2227
  * @public
@@ -2551,6 +2562,12 @@ export declare interface GrowOnlyValueSetComponentDefinition<T> extends BaseComp
2551
2562
 
2552
2563
  export declare type GSetComponentGetter<T extends GrowOnlyValueSetComponentDefinition<any>> = (engine: Pick<IEngine, 'defineValueSetComponentFromSchema'>) => T;
2553
2564
 
2565
+ export declare type ICreatedBy = LastWriteWinElementSetComponentDefinition<ICreatedByType>;
2566
+
2567
+ export declare interface ICreatedByType {
2568
+ address: string;
2569
+ }
2570
+
2554
2571
  /**
2555
2572
  * @public
2556
2573
  */
@@ -3028,6 +3045,35 @@ export declare const enum InteractionType {
3028
3045
  PROXIMITY = 1
3029
3046
  }
3030
3047
 
3048
+ /**
3049
+ * Internal component interface that exposes all internal methods for SDK use
3050
+ * This is not exposed to users, only for internal SDK operations
3051
+ */
3052
+ export declare interface InternalBaseComponent<T> extends BaseComponent<T> {
3053
+ /**
3054
+ * @public
3055
+ * Dry run update to check if a CRDT message would be accepted without actually applying it
3056
+ */
3057
+ __dry_run_updateFromCrdt(body: CrdtMessageBody): ProcessMessageResultType;
3058
+ /**
3059
+ * @public
3060
+ * Get the iterator to every entity has the component
3061
+ */
3062
+ iterator(): Iterable<[Entity, any]>;
3063
+ /**
3064
+ * @public
3065
+ */
3066
+ dirtyIterator(): Iterable<Entity>;
3067
+ /**
3068
+ * @public
3069
+ */
3070
+ __onChangeCallbacks(entity: Entity, value: T): void;
3071
+ /**
3072
+ * @public
3073
+ */
3074
+ __run_validateBeforeChange(entity: Entity, newValue: T | undefined, senderAddress: string, createdBy: string): boolean;
3075
+ }
3076
+
3031
3077
  /**
3032
3078
  * @public
3033
3079
  */
@@ -5297,34 +5343,6 @@ export declare namespace PBEngineInfo {
5297
5343
  export function decode(input: _m0.Reader | Uint8Array, length?: number): PBEngineInfo;
5298
5344
  }
5299
5345
 
5300
- /**
5301
- * PBEnvironmentFog overrides the environment fog while the player is inside the scene.
5302
- * Valid only on the scene root entity (`engine.RootEntity`).
5303
- *
5304
- * An unset field keeps the time-of-day default.
5305
- * Gradient `time` is the normalized time of day: 0 = 00:00, 0.5 = 12:00, 1 = 24:00.
5306
- * Gradients do not wrap around midnight.
5307
- * A scene cannot turn fog on or off. That is a user quality setting.
5308
- *
5309
- * While active, the overrides are global: they also change how neighbouring parcels look from inside the scene.
5310
- */
5311
- /**
5312
- * @public
5313
- */
5314
- export declare interface PBEnvironmentFog {
5315
- color?: ColorGradient | undefined;
5316
- /** default = 0.0005, per meter: fog = 1 - e^(-density * distance). Negative values clamp to 0 */
5317
- density?: number | undefined;
5318
- }
5319
-
5320
- /**
5321
- * @public
5322
- */
5323
- export declare namespace PBEnvironmentFog {
5324
- export function encode(message: PBEnvironmentFog, writer?: _m0.Writer): _m0.Writer;
5325
- export function decode(input: _m0.Reader | Uint8Array, length?: number): PBEnvironmentFog;
5326
- }
5327
-
5328
5346
  /**
5329
5347
  * Grow-only value set appended to the scene root entity.
5330
5348
  * Reports the outcome of an EU_ITEM_PURCHASE flow triggered via OpenExplorerUi.
@@ -6682,105 +6700,6 @@ export declare namespace PBRealmInfo {
6682
6700
  export function decode(input: _m0.Reader | Uint8Array, length?: number): PBRealmInfo;
6683
6701
  }
6684
6702
 
6685
- /**
6686
- * PBSkybox overrides the visible sky while the player is inside the scene.
6687
- * Valid only on the scene root entity (`engine.RootEntity`).
6688
- *
6689
- * An unset field keeps the time-of-day default.
6690
- * Gradient `time` is the normalized time of day: 0 = 00:00, 0.5 = 12:00, 1 = 24:00.
6691
- * Gradients do not wrap around midnight.
6692
- * The sun is controlled by `PBSun` and the fog by `PBEnvironmentFog`.
6693
- *
6694
- * While active, the overrides are global: they also change how neighbouring parcels look from inside the scene.
6695
- */
6696
- /**
6697
- * @public
6698
- */
6699
- export declare interface PBSkybox {
6700
- /**
6701
- * Replaces the visible sky with an image, given as its source path with the same rules as `Texture.src`.
6702
- * It must be an equirectangular (latitude-longitude) image with a 2:1 aspect ratio:
6703
- * the image centre faces +Z, the top row is the zenith and the bottom row the nadir.
6704
- * Cube cross, 3x2 and six-face layouts are not supported.
6705
- * The sun, the fog and the ambient lighting do not change: the ambient still follows `sky_colors`.
6706
- */
6707
- skyboxTexture?: string | undefined;
6708
- /**
6709
- * Procedural sky colors. They also drive the ambient lighting, also while `skybox_texture` is set.
6710
- * While `skybox_texture` is set they no longer color the visible sky.
6711
- */
6712
- skyColors?: PBSkybox_SkyColors | undefined;
6713
- /** Ignored while `skybox_texture` is set. */
6714
- clouds?: PBSkybox_Clouds | undefined;
6715
- /** Ignored while `skybox_texture` is set. */
6716
- stars?: PBSkybox_Stars | undefined;
6717
- }
6718
-
6719
- /**
6720
- * @public
6721
- */
6722
- export declare namespace PBSkybox {
6723
- export function encode(message: PBSkybox, writer?: _m0.Writer): _m0.Writer;
6724
- export function decode(input: _m0.Reader | Uint8Array, length?: number): PBSkybox;
6725
- }
6726
-
6727
- /**
6728
- * @public
6729
- */
6730
- export declare interface PBSkybox_Clouds {
6731
- /** default = 1, from 0 to 1 */
6732
- opacity?: number | undefined;
6733
- /** default = 0.01, in radians per second around the sky axis (0.01 is one turn every ~10 minutes). 0 = static, negative reverses the direction */
6734
- speed?: number | undefined;
6735
- color?: ColorGradient | undefined;
6736
- }
6737
-
6738
- /**
6739
- * @public
6740
- */
6741
- export declare namespace PBSkybox_Clouds {
6742
- export function encode(message: PBSkybox_Clouds, writer?: _m0.Writer): _m0.Writer;
6743
- export function decode(input: _m0.Reader | Uint8Array, length?: number): PBSkybox_Clouds;
6744
- }
6745
-
6746
- /**
6747
- * @public
6748
- */
6749
- export declare interface PBSkybox_SkyColors {
6750
- /** the sky straight up */
6751
- zenith?: ColorGradient | undefined;
6752
- /** the broad band of sky around the horizon */
6753
- horizon?: ColorGradient | undefined;
6754
- /** The sky below the horizon, visible wherever no terrain covers it (landscape disabled, high altitude). */
6755
- nadir?: ColorGradient | undefined;
6756
- /** Narrow glow right on the horizon line, like a sunset glow. Unset = follows `horizon` when that is set. */
6757
- rim?: ColorGradient | undefined;
6758
- }
6759
-
6760
- /**
6761
- * @public
6762
- */
6763
- export declare namespace PBSkybox_SkyColors {
6764
- export function encode(message: PBSkybox_SkyColors, writer?: _m0.Writer): _m0.Writer;
6765
- export function decode(input: _m0.Reader | Uint8Array, length?: number): PBSkybox_SkyColors;
6766
- }
6767
-
6768
- /**
6769
- * @public
6770
- */
6771
- export declare interface PBSkybox_Stars {
6772
- /** default = 4.62, multiplier on the star texture (1 = as authored, values above 1 are HDR). 0 hides the stars, negative values clamp to 0. Stars are visible only at night */
6773
- brightness?: number | undefined;
6774
- }
6775
-
6776
- /**
6777
- * @public
6778
- */
6779
- export declare namespace PBSkybox_Stars {
6780
- export function encode(message: PBSkybox_Stars, writer?: _m0.Writer): _m0.Writer;
6781
- export function decode(input: _m0.Reader | Uint8Array, length?: number): PBSkybox_Stars;
6782
- }
6783
-
6784
6703
  /**
6785
6704
  * The SkyboxTime component allows controlling the time of day for the skybox,
6786
6705
  * affecting the lighting and appearance of the sky in the scene.
@@ -6803,42 +6722,6 @@ export declare namespace PBSkyboxTime {
6803
6722
  export function decode(input: _m0.Reader | Uint8Array, length?: number): PBSkyboxTime;
6804
6723
  }
6805
6724
 
6806
- /**
6807
- * PBSun overrides the directional light (sun and moon) while the player is inside the scene.
6808
- * Valid only on the scene root entity (`engine.RootEntity`).
6809
- *
6810
- * An unset field keeps the time-of-day default.
6811
- * Gradient `time` is the normalized time of day: 0 = 00:00, 0.5 = 12:00, 1 = 24:00.
6812
- * Gradients do not wrap around midnight.
6813
- *
6814
- * While active, the overrides are global: they also change how neighbouring parcels look from inside the scene.
6815
- */
6816
- /**
6817
- * @public
6818
- */
6819
- export declare interface PBSun {
6820
- /** tints the directional light and the sun disc */
6821
- color?: ColorGradient | undefined;
6822
- /** default = true. false hides the sun and moon discs and the lens flare, but not their light */
6823
- visible?: boolean | undefined;
6824
- /** default = 1, multiplier on the renderer's time-of-day light intensity. Negative values clamp to 0 */
6825
- intensity?: number | undefined;
6826
- /**
6827
- * Direction the sunlight travels, in scene space: (0,-1,0) = sun straight overhead. Normalized by the renderer.
6828
- * Set = the sun stays fixed at every time of day; its color and intensity still follow the time of day.
6829
- * Unset or zero = the time-of-day path.
6830
- */
6831
- direction?: PBVector3 | undefined;
6832
- }
6833
-
6834
- /**
6835
- * @public
6836
- */
6837
- export declare namespace PBSun {
6838
- export function encode(message: PBSun, writer?: _m0.Writer): _m0.Writer;
6839
- export function decode(input: _m0.Reader | Uint8Array, length?: number): PBSun;
6840
- }
6841
-
6842
6725
  /**
6843
6726
  * The TextShape component renders customizable floating text.
6844
6727
  *
@@ -9271,9 +9154,6 @@ export declare interface SetMoveRotateScaleParams extends MoveRotateScaleModePar
9271
9154
  easingFunction?: EasingFunction;
9272
9155
  }
9273
9156
 
9274
- /** @public */
9275
- export declare const Skybox: LastWriteWinElementSetComponentDefinition<PBSkybox>;
9276
-
9277
9157
  /** @public */
9278
9158
  export declare const SkyboxTime: LastWriteWinElementSetComponentDefinition<PBSkyboxTime>;
9279
9159
 
@@ -9284,9 +9164,6 @@ export declare interface Spec {
9284
9164
  [key: string]: ISchema;
9285
9165
  }
9286
9166
 
9287
- /** @public */
9288
- export declare const Sun: LastWriteWinElementSetComponentDefinition<PBSun>;
9289
-
9290
9167
  /* Excluded from this release type: SyncComponents */
9291
9168
 
9292
9169
  /**
@@ -9723,6 +9600,16 @@ export declare type Transport = {
9723
9600
  onmessage?(message: Uint8Array): void;
9724
9601
  filter(message: Omit<TransportMessage, 'messageBuffer'>): boolean;
9725
9602
  type?: string;
9603
+ /**
9604
+ * Whether this transport is allowed to mutate reserved-range entities
9605
+ * (root/player/camera + avatars, entity number below `RESERVED_STATIC_ENTITIES`).
9606
+ * Only the trusted host/renderer transport sets this. An inbound DELETE_ENTITY
9607
+ * or component operation (PUT_COMPONENT, DELETE_COMPONENT, APPEND_VALUE,
9608
+ * AUTHORITATIVE_PUT_COMPONENT) on a reserved entity from a transport without
9609
+ * this flag (a comms peer, or any scene-added transport) is rejected — see
9610
+ * `receiveMessages`.
9611
+ */
9612
+ allowReservedEntities?: boolean;
9726
9613
  };
9727
9614
 
9728
9615
  /**
@@ -10304,6 +10191,14 @@ export declare interface UiTransformProps {
10304
10191
  */
10305
10192
  export declare type Unpacked<T> = T extends (infer U)[] ? U : T;
10306
10193
 
10194
+ export declare type ValidateCallback<T> = (value: {
10195
+ entity: Entity;
10196
+ currentValue: T | undefined;
10197
+ newValue: T | undefined;
10198
+ senderAddress: string;
10199
+ createdBy: string;
10200
+ }) => boolean;
10201
+
10307
10202
  /**
10308
10203
  * @public
10309
10204
  */