@playcanvas/web-components 0.10.0 → 0.11.0

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.
Files changed (40) hide show
  1. package/dist/app.d.ts +151 -35
  2. package/dist/asset.d.ts +9 -0
  3. package/dist/async-element.d.ts +12 -2
  4. package/dist/components/camera-component.d.ts +13 -13
  5. package/dist/components/component.d.ts +5 -4
  6. package/dist/components/screen-component.d.ts +25 -4
  7. package/dist/components/scrollview-component.d.ts +6 -4
  8. package/dist/custom-elements.json +812 -196
  9. package/dist/entity.d.ts +18 -4
  10. package/dist/loading-bar.d.ts +35 -0
  11. package/dist/material.d.ts +8 -2
  12. package/dist/parse.d.ts +4 -2
  13. package/dist/pwc.cjs +661 -229
  14. package/dist/pwc.cjs.map +1 -1
  15. package/dist/pwc.js +661 -229
  16. package/dist/pwc.js.map +1 -1
  17. package/dist/pwc.min.js +1 -1
  18. package/dist/pwc.min.js.map +1 -1
  19. package/dist/pwc.min.mjs +1 -1
  20. package/dist/pwc.min.mjs.map +1 -1
  21. package/dist/pwc.mjs +662 -230
  22. package/dist/pwc.mjs.map +1 -1
  23. package/dist/scene.d.ts +11 -3
  24. package/dist/sky.d.ts +12 -11
  25. package/dist/vscode.html-custom-data.json +47 -22
  26. package/dist/web-types.json +384 -121
  27. package/package.json +1 -1
  28. package/src/app.ts +333 -124
  29. package/src/asset.ts +25 -0
  30. package/src/async-element.ts +14 -4
  31. package/src/components/camera-component.ts +31 -26
  32. package/src/components/component.ts +6 -5
  33. package/src/components/screen-component.ts +42 -12
  34. package/src/components/scrollview-component.ts +6 -4
  35. package/src/entity.ts +61 -27
  36. package/src/loading-bar.ts +122 -0
  37. package/src/material.ts +10 -4
  38. package/src/parse.ts +5 -3
  39. package/src/scene.ts +49 -19
  40. package/src/sky.ts +26 -25
package/dist/custom-elements.json CHANGED
@@ -50,7 +50,7 @@
50
50
  },
51
51
  {
52
52
  "kind": "field",
53
- "name": "_depth",
53
+ "name": "_depthBuffer",
54
54
  "type": {
55
55
  "text": "boolean"
56
56
  },
@@ -59,7 +59,7 @@
59
59
  },
60
60
  {
61
61
  "kind": "field",
62
- "name": "_stencil",
62
+ "name": "_stencilBuffer",
63
63
  "type": {
64
64
  "text": "boolean"
65
65
  },
@@ -68,13 +68,38 @@
68
68
  },
69
69
  {
70
70
  "kind": "field",
71
- "name": "_highResolution",
71
+ "name": "_maxPixelRatio",
72
+ "privacy": "private",
73
+ "default": "Infinity"
74
+ },
75
+ {
76
+ "kind": "field",
77
+ "name": "_loadingBar",
72
78
  "type": {
73
79
  "text": "boolean"
74
80
  },
75
81
  "privacy": "private",
76
82
  "default": "true"
77
83
  },
84
+ {
85
+ "kind": "field",
86
+ "name": "_optionsLocked",
87
+ "type": {
88
+ "text": "boolean"
89
+ },
90
+ "privacy": "private",
91
+ "default": "false",
92
+ "description": "Set once the graphics options above have been handed to `createGraphicsDevice`, after which\nwriting any of them changes nothing. Guards the warning in _warnIfBooted, and is\ncleared on disconnect so a re-connected element boots from its current attributes."
93
+ },
94
+ {
95
+ "kind": "field",
96
+ "name": "_bar",
97
+ "type": {
98
+ "text": "LoadingBar | null"
99
+ },
100
+ "privacy": "private",
101
+ "default": "null"
102
+ },
78
103
  {
79
104
  "kind": "field",
80
105
  "name": "_hierarchyReady",
@@ -84,6 +109,13 @@
84
109
  "privacy": "private",
85
110
  "default": "false"
86
111
  },
112
+ {
113
+ "kind": "field",
114
+ "name": "_entityElements",
115
+ "privacy": "private",
116
+ "default": "new Map<GraphNode, EntityElement>()",
117
+ "description": "The elements backing this application's entities, keyed by the entity itself. Registered\nby EntityElement at creation and removed when an entity is destroyed, this joins engine\nscene nodes back to their owning elements by identity - never by name."
118
+ },
87
119
  {
88
120
  "kind": "field",
89
121
  "name": "_picker",
@@ -111,6 +143,15 @@
111
143
  "privacy": "private",
112
144
  "default": "null"
113
145
  },
146
+ {
147
+ "kind": "field",
148
+ "name": "_pickToken",
149
+ "type": {
150
+ "text": "number"
151
+ },
152
+ "privacy": "private",
153
+ "default": "0"
154
+ },
114
155
  {
115
156
  "kind": "field",
116
157
  "name": "_pointerHandlers",
@@ -129,13 +170,36 @@
129
170
  "privacy": "private",
130
171
  "default": "null"
131
172
  },
173
+ {
174
+ "kind": "field",
175
+ "name": "_loadProgress",
176
+ "type": {
177
+ "text": "number"
178
+ },
179
+ "privacy": "private",
180
+ "default": "0"
181
+ },
132
182
  {
133
183
  "kind": "field",
134
184
  "name": "app",
135
185
  "type": {
136
- "text": "AppBase"
186
+ "text": "AppBase | null"
187
+ },
188
+ "description": "The PlayCanvas application instance. `null` until the element is ready, and again once it\nhas been removed from the document — await whenReady or the element's `ready()`\npromise before accessing it.",
189
+ "return": {
190
+ "type": {
191
+ "text": ""
192
+ }
193
+ },
194
+ "readonly": true
195
+ },
196
+ {
197
+ "kind": "field",
198
+ "name": "loadProgress",
199
+ "type": {
200
+ "text": "number"
137
201
  },
138
- "description": "The PlayCanvas application instance. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
202
+ "description": "The asset preload progress of the application, as a fraction from 0 to 1. It is 0 until\npreloading begins (and again once the element has been removed from the document), and 1\nonce preloading has finished — including when there was nothing to preload. Read this to\ninitialize a loading UI; subsequent updates arrive via the `progress` event.",
139
203
  "return": {
140
204
  "type": {
141
205
  "text": ""
@@ -155,6 +219,72 @@
155
219
  "kind": "method",
156
220
  "name": "_pickerDestroy"
157
221
  },
222
+ {
223
+ "kind": "method",
224
+ "name": "elementFromEntity",
225
+ "return": {
226
+ "type": {
227
+ "text": ""
228
+ }
229
+ },
230
+ "parameters": [
231
+ {
232
+ "name": "entity",
233
+ "type": {
234
+ "text": "Entity"
235
+ },
236
+ "description": "The entity to look up."
237
+ }
238
+ ],
239
+ "description": "Returns the `<pc-entity>` element whose backing entity is `entity`, or `null` if the\nentity was not created by an element of this application - for example, a node inside a\nmodel's instantiated hierarchy, or an entity created through the engine API."
240
+ },
241
+ {
242
+ "kind": "method",
243
+ "name": "_elementFromNode",
244
+ "privacy": "private",
245
+ "return": {
246
+ "type": {
247
+ "text": ""
248
+ }
249
+ },
250
+ "parameters": [
251
+ {
252
+ "name": "node",
253
+ "type": {
254
+ "text": "GraphNode | null"
255
+ },
256
+ "description": "The picked node, or `null`."
257
+ }
258
+ ],
259
+ "description": "Resolves the element that owns a picked node: the nearest node up the parent chain -\nstarting with the node itself - that was created by a `<pc-entity>` of this application.\nA hit inside a model's instantiated hierarchy therefore resolves to the element hosting\nthe model."
260
+ },
261
+ {
262
+ "kind": "method",
263
+ "name": "_elementWithListener",
264
+ "privacy": "private",
265
+ "return": {
266
+ "type": {
267
+ "text": ""
268
+ }
269
+ },
270
+ "parameters": [
271
+ {
272
+ "name": "node",
273
+ "type": {
274
+ "text": "GraphNode | null"
275
+ },
276
+ "description": "The picked node, or `null`."
277
+ },
278
+ {
279
+ "name": "type",
280
+ "type": {
281
+ "text": "string"
282
+ },
283
+ "description": "The pointer event type a listener is required for."
284
+ }
285
+ ],
286
+ "description": "Like _elementFromNode, but skips elements without a listener for `type`, so a hit\non an unlistened child still reaches a listening ancestor."
287
+ },
158
288
  {
159
289
  "kind": "method",
160
290
  "name": "_getPickerCoordinates",
@@ -173,6 +303,26 @@
173
303
  }
174
304
  ]
175
305
  },
306
+ {
307
+ "kind": "method",
308
+ "name": "_pickNode",
309
+ "privacy": "private",
310
+ "return": {
311
+ "type": {
312
+ "text": ""
313
+ }
314
+ },
315
+ "parameters": [
316
+ {
317
+ "name": "event",
318
+ "type": {
319
+ "text": "PointerEvent"
320
+ },
321
+ "description": "The pointer event to pick under."
322
+ }
323
+ ],
324
+ "description": "Picks the scene under the pointer and returns the graph node that was hit, or `null`.\n\nThe read back is asynchronous because the synchronous Picker.getSelection is not\nsupported on WebGPU, where it returns an empty selection rather than failing - which\nsilently disabled every `onpointer*` handler once WebGPU became the resolved backend. The\nasync variant works on both backends and does not block the main thread on a GPU read."
325
+ },
176
326
  {
177
327
  "kind": "method",
178
328
  "name": "_onPointerMove",
@@ -233,10 +383,25 @@
233
383
  }
234
384
  ]
235
385
  },
386
+ {
387
+ "kind": "method",
388
+ "name": "_warnIfBooted",
389
+ "privacy": "private",
390
+ "parameters": [
391
+ {
392
+ "name": "name",
393
+ "type": {
394
+ "text": "string"
395
+ },
396
+ "description": "The name of the option, as its attribute."
397
+ }
398
+ ],
399
+ "description": "Warns that a graphics option was written too late to have any effect. These options are read\nonce, when the element connects and creates its graphics device, so a later write updates\nonly the element's own property - silently, without this."
400
+ },
236
401
  {
237
402
  "kind": "field",
238
403
  "name": "alpha",
239
- "description": "Gets the alpha flag.",
404
+ "description": "Gets whether the frame buffer has an alpha channel.",
240
405
  "parameters": [
241
406
  {
242
407
  "description": "The alpha flag.",
@@ -252,7 +417,7 @@
252
417
  {
253
418
  "kind": "field",
254
419
  "name": "antialias",
255
- "description": "Gets the antialias flag.",
420
+ "description": "Gets whether the frame buffer is anti-aliased.",
256
421
  "parameters": [
257
422
  {
258
423
  "description": "The antialias flag.",
@@ -283,11 +448,27 @@
283
448
  },
284
449
  {
285
450
  "kind": "field",
286
- "name": "depth",
287
- "description": "Gets the depth flag.",
451
+ "name": "depthBuffer",
452
+ "description": "Gets whether the frame buffer has a depth buffer.",
453
+ "parameters": [
454
+ {
455
+ "description": "The depth buffer flag.",
456
+ "name": "value"
457
+ }
458
+ ],
459
+ "return": {
460
+ "type": {
461
+ "text": ""
462
+ }
463
+ }
464
+ },
465
+ {
466
+ "kind": "field",
467
+ "name": "loadingBar",
468
+ "description": "Gets whether the application shows its built-in loading bar while it boots and preloads\nits assets.",
288
469
  "parameters": [
289
470
  {
290
- "description": "The depth flag.",
471
+ "description": "The loading bar flag.",
291
472
  "name": "value"
292
473
  }
293
474
  ],
@@ -299,11 +480,11 @@
299
480
  },
300
481
  {
301
482
  "kind": "field",
302
- "name": "highResolution",
303
- "description": "Gets the high resolution flag.",
483
+ "name": "maxPixelRatio",
484
+ "description": "Gets the cap on the pixel ratio the application renders at.",
304
485
  "parameters": [
305
486
  {
306
- "description": "The high resolution flag.",
487
+ "description": "The maximum pixel ratio.",
307
488
  "name": "value"
308
489
  }
309
490
  ],
@@ -315,11 +496,11 @@
315
496
  },
316
497
  {
317
498
  "kind": "field",
318
- "name": "stencil",
319
- "description": "Gets the stencil flag.",
499
+ "name": "stencilBuffer",
500
+ "description": "Gets whether the frame buffer has a stencil buffer.",
320
501
  "parameters": [
321
502
  {
322
- "description": "The stencil flag.",
503
+ "description": "The stencil buffer flag.",
323
504
  "name": "value"
324
505
  }
325
506
  ],
@@ -358,7 +539,13 @@
358
539
  "kind": "field",
359
540
  "name": "closestApp",
360
541
  "type": {
361
- "text": "AppElement"
542
+ "text": "AppElement | null"
543
+ },
544
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
545
+ "return": {
546
+ "type": {
547
+ "text": ""
548
+ }
362
549
  },
363
550
  "readonly": true,
364
551
  "inheritedFrom": {
@@ -370,7 +557,13 @@
370
557
  "kind": "field",
371
558
  "name": "closestEntity",
372
559
  "type": {
373
- "text": "EntityElement"
560
+ "text": "EntityElement | null"
561
+ },
562
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
563
+ "return": {
564
+ "type": {
565
+ "text": ""
566
+ }
374
567
  },
375
568
  "readonly": true,
376
569
  "inheritedFrom": {
@@ -403,6 +596,26 @@
403
596
  }
404
597
  }
405
598
  ],
599
+ "events": [
600
+ {
601
+ "name": "progress",
602
+ "type": {
603
+ "text": "ProgressEvent"
604
+ },
605
+ "description": "Fired while the application preloads its assets. `loaded` and `total` are asset counts, not bytes, and an asset that fails to load still counts as loaded. Fired at least once per boot, and the final event always has `loaded` equal to `total`. Does not bubble."
606
+ },
607
+ {
608
+ "name": "ready",
609
+ "type": {
610
+ "text": "CustomEvent"
611
+ },
612
+ "description": "Fired once the element is fully initialized. Bubbles and is composed.",
613
+ "inheritedFrom": {
614
+ "name": "AsyncElement",
615
+ "module": "src/async-element.ts"
616
+ }
617
+ }
618
+ ],
406
619
  "attributes": [
407
620
  {
408
621
  "name": "alpha",
@@ -411,7 +624,7 @@
411
624
  },
412
625
  "fieldName": "alpha",
413
626
  "default": "true",
414
- "description": "The alpha flag."
627
+ "description": "Whether the frame buffer has an alpha channel."
415
628
  },
416
629
  {
417
630
  "name": "antialias",
@@ -420,7 +633,7 @@
420
633
  },
421
634
  "fieldName": "antialias",
422
635
  "default": "true",
423
- "description": "The antialias flag."
636
+ "description": "Whether the frame buffer is anti-aliased."
424
637
  },
425
638
  {
426
639
  "name": "backend",
@@ -432,31 +645,40 @@
432
645
  "description": "The graphics backend."
433
646
  },
434
647
  {
435
- "name": "depth",
648
+ "name": "depth-buffer",
436
649
  "type": {
437
650
  "text": "boolean"
438
651
  },
439
- "fieldName": "depth",
652
+ "fieldName": "depthBuffer",
440
653
  "default": "true",
441
- "description": "The depth flag."
654
+ "description": "Whether the frame buffer has a depth buffer."
442
655
  },
443
656
  {
444
- "name": "high-resolution",
657
+ "name": "loading-bar",
445
658
  "type": {
446
659
  "text": "boolean"
447
660
  },
448
- "fieldName": "highResolution",
661
+ "fieldName": "loadingBar",
449
662
  "default": "true",
450
- "description": "The high resolution flag."
663
+ "description": "Whether the application shows its built-in loading bar while it boots and preloads its assets."
664
+ },
665
+ {
666
+ "name": "max-pixel-ratio",
667
+ "type": {
668
+ "text": "number"
669
+ },
670
+ "fieldName": "maxPixelRatio",
671
+ "default": "Infinity",
672
+ "description": "The cap on the pixel ratio the application renders at."
451
673
  },
452
674
  {
453
- "name": "stencil",
675
+ "name": "stencil-buffer",
454
676
  "type": {
455
677
  "text": "boolean"
456
678
  },
457
- "fieldName": "stencil",
679
+ "fieldName": "stencilBuffer",
458
680
  "default": "true",
459
- "description": "The stencil flag."
681
+ "description": "Whether the frame buffer has a stencil buffer."
460
682
  }
461
683
  ],
462
684
  "superclass": {
@@ -464,20 +686,7 @@
464
686
  "module": "/src/async-element"
465
687
  },
466
688
  "tagName": "pc-app",
467
- "customElement": true,
468
- "events": [
469
- {
470
- "name": "ready",
471
- "type": {
472
- "text": "CustomEvent"
473
- },
474
- "description": "Fired once the element is fully initialized. Bubbles and is composed.",
475
- "inheritedFrom": {
476
- "name": "AsyncElement",
477
- "module": "src/async-element.ts"
478
- }
479
- }
480
- ]
689
+ "customElement": true
481
690
  }
482
691
  ],
483
692
  "exports": [
@@ -526,6 +735,24 @@
526
735
  "default": "null",
527
736
  "description": "The asset that is loaded. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it."
528
737
  },
738
+ {
739
+ "kind": "method",
740
+ "name": "_onAssetLoad",
741
+ "privacy": "private"
742
+ },
743
+ {
744
+ "kind": "method",
745
+ "name": "_onAssetError",
746
+ "privacy": "private",
747
+ "parameters": [
748
+ {
749
+ "name": "err",
750
+ "type": {
751
+ "text": "string | Error"
752
+ }
753
+ }
754
+ ]
755
+ },
529
756
  {
530
757
  "kind": "method",
531
758
  "name": "createAsset"
@@ -612,7 +839,13 @@
612
839
  "kind": "field",
613
840
  "name": "closestApp",
614
841
  "type": {
615
- "text": "AppElement"
842
+ "text": "AppElement | null"
843
+ },
844
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
845
+ "return": {
846
+ "type": {
847
+ "text": ""
848
+ }
616
849
  },
617
850
  "readonly": true,
618
851
  "inheritedFrom": {
@@ -624,7 +857,13 @@
624
857
  "kind": "field",
625
858
  "name": "closestEntity",
626
859
  "type": {
627
- "text": "EntityElement"
860
+ "text": "EntityElement | null"
861
+ },
862
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
863
+ "return": {
864
+ "type": {
865
+ "text": ""
866
+ }
628
867
  },
629
868
  "readonly": true,
630
869
  "inheritedFrom": {
@@ -657,6 +896,33 @@
657
896
  }
658
897
  }
659
898
  ],
899
+ "events": [
900
+ {
901
+ "name": "error",
902
+ "type": {
903
+ "text": "ErrorEvent"
904
+ },
905
+ "description": "Fired when the asset fails to load, with the engine's error in `message`. Does not bubble. The element still becomes ready — readiness means the load settled, not that it succeeded."
906
+ },
907
+ {
908
+ "name": "load",
909
+ "type": {
910
+ "text": "Event"
911
+ },
912
+ "description": "Fired each time the asset finishes loading, including a `lazy` asset loaded later and any subsequent reloads. Does not bubble — listen on this element, or use a capture-phase listener on an ancestor to observe every asset."
913
+ },
914
+ {
915
+ "name": "ready",
916
+ "type": {
917
+ "text": "CustomEvent"
918
+ },
919
+ "description": "Fired once the element is fully initialized. Bubbles and is composed.",
920
+ "inheritedFrom": {
921
+ "name": "AsyncElement",
922
+ "module": "src/async-element.ts"
923
+ }
924
+ }
925
+ ],
660
926
  "attributes": [
661
927
  {
662
928
  "type": {
@@ -729,20 +995,7 @@
729
995
  "module": "/src/async-element"
730
996
  },
731
997
  "tagName": "pc-asset",
732
- "customElement": true,
733
- "events": [
734
- {
735
- "name": "ready",
736
- "type": {
737
- "text": "CustomEvent"
738
- },
739
- "description": "Fired once the element is fully initialized. Bubbles and is composed.",
740
- "inheritedFrom": {
741
- "name": "AsyncElement",
742
- "module": "src/async-element.ts"
743
- }
744
- }
745
- ]
998
+ "customElement": true
746
999
  }
747
1000
  ],
748
1001
  "exports": [
@@ -794,7 +1047,13 @@
794
1047
  "kind": "field",
795
1048
  "name": "closestApp",
796
1049
  "type": {
797
- "text": "AppElement"
1050
+ "text": "AppElement | null"
1051
+ },
1052
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
1053
+ "return": {
1054
+ "type": {
1055
+ "text": ""
1056
+ }
798
1057
  },
799
1058
  "readonly": true
800
1059
  },
@@ -802,7 +1061,13 @@
802
1061
  "kind": "field",
803
1062
  "name": "closestEntity",
804
1063
  "type": {
805
- "text": "EntityElement"
1064
+ "text": "EntityElement | null"
1065
+ },
1066
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
1067
+ "return": {
1068
+ "type": {
1069
+ "text": ""
1070
+ }
806
1071
  },
807
1072
  "readonly": true
808
1073
  },
@@ -1035,13 +1300,23 @@
1035
1300
  "privacy": "private",
1036
1301
  "default": "null"
1037
1302
  },
1303
+ {
1304
+ "kind": "field",
1305
+ "name": "_appElement",
1306
+ "type": {
1307
+ "text": "AppElement | null"
1308
+ },
1309
+ "privacy": "private",
1310
+ "default": "null",
1311
+ "description": "The application element this entity is registered with, cached at creation time so the\nentity can be unregistered even once this element has left the DOM."
1312
+ },
1038
1313
  {
1039
1314
  "kind": "field",
1040
1315
  "name": "entity",
1041
1316
  "type": {
1042
- "text": "Entity"
1317
+ "text": "Entity | null"
1043
1318
  },
1044
- "description": "The PlayCanvas entity instance. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
1319
+ "description": "The PlayCanvas entity instance. `null` until the element is ready, and again once it has\nbeen removed from the document — await whenReady or the element's `ready()`\npromise before accessing it.",
1045
1320
  "return": {
1046
1321
  "type": {
1047
1322
  "text": ""
@@ -1061,6 +1336,21 @@
1061
1336
  }
1062
1337
  ]
1063
1338
  },
1339
+ {
1340
+ "kind": "method",
1341
+ "name": "_onEntityDestroy",
1342
+ "privacy": "private",
1343
+ "parameters": [
1344
+ {
1345
+ "name": "entity",
1346
+ "type": {
1347
+ "text": "Entity"
1348
+ },
1349
+ "description": "The entity that was destroyed."
1350
+ }
1351
+ ],
1352
+ "description": "Handles the destruction of the backing entity. Resets the element so a later re-insertion\nstarts clean: `_built` must be cleared alongside `_entity`, or buildHierarchy would bail\nand a re-created entity would never be parented."
1353
+ },
1064
1354
  {
1065
1355
  "kind": "method",
1066
1356
  "name": "buildHierarchy",
@@ -1287,7 +1577,13 @@
1287
1577
  "kind": "field",
1288
1578
  "name": "closestApp",
1289
1579
  "type": {
1290
- "text": "AppElement"
1580
+ "text": "AppElement | null"
1581
+ },
1582
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
1583
+ "return": {
1584
+ "type": {
1585
+ "text": ""
1586
+ }
1291
1587
  },
1292
1588
  "readonly": true,
1293
1589
  "inheritedFrom": {
@@ -1299,7 +1595,13 @@
1299
1595
  "kind": "field",
1300
1596
  "name": "closestEntity",
1301
1597
  "type": {
1302
- "text": "EntityElement"
1598
+ "text": "EntityElement | null"
1599
+ },
1600
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
1601
+ "return": {
1602
+ "type": {
1603
+ "text": ""
1604
+ }
1303
1605
  },
1304
1606
  "readonly": true,
1305
1607
  "inheritedFrom": {
@@ -1762,7 +2064,7 @@
1762
2064
  "declarations": [
1763
2065
  {
1764
2066
  "kind": "class",
1765
- "description": "The MaterialElement interface provides properties and methods for manipulating\n[`<pc-material>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-material/) elements.\nThe MaterialElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nA `pc-material` must be a direct child of `pc-app` — elements placed elsewhere log a warning\nand never create a material. Elements inserted while the application is already running are\ncreated on insertion.\n\nThe element is metal/rough by default: unlike a bare `StandardMaterial` it enables the metalness\nworkflow, which is what the `metalness-*` attributes assume and what glTF means by PBR. The\n`roughness` and `roughness-map` attributes are aliases for `gloss` and `gloss-map` that\nadditionally invert the gloss channel; do not mix the two families on one element.\n\nThe two aliases are documented here rather than on an accessor, because they resolve to the\n`gloss` properties and would otherwise inherit gloss's description - which reads inverted.\n",
2067
+ "description": "The MaterialElement interface provides properties and methods for manipulating\n[`<pc-material>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-material/) elements.\nThe MaterialElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nA `pc-material` must be a direct child of `pc-app` — elements placed elsewhere log a warning\nand never create a material. Elements inserted while the application is already running are\ncreated on insertion.\n\nThe element is metal/rough by default: unlike a bare `StandardMaterial` it enables the metalness\nworkflow, which is what the `metalness-*` attributes assume and what glTF means by PBR. It also\ndefaults `metalness` to 0 rather than the engine's 1, because those two defaults have to be\nchosen together - the engine's 1 is unreachable under its own `useMetalness` of false, and with\nthe workflow on it would make every material fully metallic, so `<pc-material diffuse=\"crimson\">`\nwould render as dark tinted reflections of an environment that may not exist rather than as a\ncrimson surface. `metalness=\"1\"` remains one attribute away.\n\nThe `roughness` and `roughness-map` attributes are aliases for `gloss` and `gloss-map` that\nadditionally invert the gloss channel; do not mix the two families on one element.\n\nThe two aliases are documented here rather than on an accessor, because they resolve to the\n`gloss` properties and would otherwise inherit gloss's description - which reads inverted.\n",
1766
2068
  "name": "MaterialElement",
1767
2069
  "members": [
1768
2070
  {
@@ -2159,7 +2461,7 @@
2159
2461
  "text": "number"
2160
2462
  },
2161
2463
  "privacy": "private",
2162
- "default": "1"
2464
+ "default": "0"
2163
2465
  },
2164
2466
  {
2165
2467
  "kind": "field",
@@ -4315,7 +4617,7 @@
4315
4617
  "text": "number"
4316
4618
  },
4317
4619
  "fieldName": "metalness",
4318
- "default": "1",
4620
+ "default": "0",
4319
4621
  "description": "How metallic the surface is."
4320
4622
  },
4321
4623
  {
@@ -4745,7 +5047,13 @@
4745
5047
  "kind": "field",
4746
5048
  "name": "closestApp",
4747
5049
  "type": {
4748
- "text": "AppElement"
5050
+ "text": "AppElement | null"
5051
+ },
5052
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
5053
+ "return": {
5054
+ "type": {
5055
+ "text": ""
5056
+ }
4749
5057
  },
4750
5058
  "readonly": true,
4751
5059
  "inheritedFrom": {
@@ -4757,7 +5065,13 @@
4757
5065
  "kind": "field",
4758
5066
  "name": "closestEntity",
4759
5067
  "type": {
4760
- "text": "EntityElement"
5068
+ "text": "EntityElement | null"
5069
+ },
5070
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
5071
+ "return": {
5072
+ "type": {
5073
+ "text": ""
5074
+ }
4761
5075
  },
4762
5076
  "readonly": true,
4763
5077
  "inheritedFrom": {
@@ -5025,9 +5339,9 @@
5025
5339
  "kind": "field",
5026
5340
  "name": "scene",
5027
5341
  "type": {
5028
- "text": "Scene"
5342
+ "text": "Scene | null"
5029
5343
  },
5030
- "description": "The PlayCanvas scene instance. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
5344
+ "description": "The PlayCanvas scene instance. `null` until the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
5031
5345
  "return": {
5032
5346
  "type": {
5033
5347
  "text": ""
@@ -5039,6 +5353,21 @@
5039
5353
  "kind": "method",
5040
5354
  "name": "updateSceneSettings"
5041
5355
  },
5356
+ {
5357
+ "kind": "method",
5358
+ "name": "_applyGravity",
5359
+ "privacy": "private",
5360
+ "parameters": [
5361
+ {
5362
+ "name": "value",
5363
+ "type": {
5364
+ "text": "Vec3"
5365
+ },
5366
+ "description": "The gravity to apply."
5367
+ }
5368
+ ],
5369
+ "description": "Applies gravity to the rigid body system. Resolved through `closestApp` rather than\n`parentElement` so that a `<pc-scene>` nested inside a wrapper element behaves the same as\na direct child, matching how `connectedCallback` resolves the application."
5370
+ },
5042
5371
  {
5043
5372
  "kind": "field",
5044
5373
  "name": "fog",
@@ -5164,7 +5493,13 @@
5164
5493
  "kind": "field",
5165
5494
  "name": "closestApp",
5166
5495
  "type": {
5167
- "text": "AppElement"
5496
+ "text": "AppElement | null"
5497
+ },
5498
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
5499
+ "return": {
5500
+ "type": {
5501
+ "text": ""
5502
+ }
5168
5503
  },
5169
5504
  "readonly": true,
5170
5505
  "inheritedFrom": {
@@ -5176,7 +5511,13 @@
5176
5511
  "kind": "field",
5177
5512
  "name": "closestEntity",
5178
5513
  "type": {
5179
- "text": "EntityElement"
5514
+ "text": "EntityElement | null"
5515
+ },
5516
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
5517
+ "return": {
5518
+ "type": {
5519
+ "text": ""
5520
+ }
5180
5521
  },
5181
5522
  "readonly": true,
5182
5523
  "inheritedFrom": {
@@ -5346,7 +5687,7 @@
5346
5687
  },
5347
5688
  {
5348
5689
  "kind": "field",
5349
- "name": "_level",
5690
+ "name": "_mipLevel",
5350
5691
  "type": {
5351
5692
  "text": "number"
5352
5693
  },
@@ -5468,11 +5809,11 @@
5468
5809
  },
5469
5810
  {
5470
5811
  "kind": "field",
5471
- "name": "level",
5472
- "description": "Gets the mip level of the skybox.",
5812
+ "name": "lighting",
5813
+ "description": "Gets whether the skybox is used as a light source.",
5473
5814
  "parameters": [
5474
5815
  {
5475
- "description": "The mip level.",
5816
+ "description": "Whether to use lighting.",
5476
5817
  "name": "value"
5477
5818
  }
5478
5819
  ],
@@ -5484,11 +5825,11 @@
5484
5825
  },
5485
5826
  {
5486
5827
  "kind": "field",
5487
- "name": "lighting",
5488
- "description": "Gets whether the skybox is used as a light source.",
5828
+ "name": "mipLevel",
5829
+ "description": "Gets the mip level of the skybox.",
5489
5830
  "parameters": [
5490
5831
  {
5491
- "description": "Whether to use lighting.",
5832
+ "description": "The mip level.",
5492
5833
  "name": "value"
5493
5834
  }
5494
5835
  ],
@@ -5575,7 +5916,13 @@
5575
5916
  "kind": "field",
5576
5917
  "name": "closestApp",
5577
5918
  "type": {
5578
- "text": "AppElement"
5919
+ "text": "AppElement | null"
5920
+ },
5921
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
5922
+ "return": {
5923
+ "type": {
5924
+ "text": ""
5925
+ }
5579
5926
  },
5580
5927
  "readonly": true,
5581
5928
  "inheritedFrom": {
@@ -5587,7 +5934,13 @@
5587
5934
  "kind": "field",
5588
5935
  "name": "closestEntity",
5589
5936
  "type": {
5590
- "text": "EntityElement"
5937
+ "text": "EntityElement | null"
5938
+ },
5939
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
5940
+ "return": {
5941
+ "type": {
5942
+ "text": ""
5943
+ }
5591
5944
  },
5592
5945
  "readonly": true,
5593
5946
  "inheritedFrom": {
@@ -5647,15 +6000,6 @@
5647
6000
  "default": "1",
5648
6001
  "description": "The intensity of the skybox."
5649
6002
  },
5650
- {
5651
- "name": "level",
5652
- "type": {
5653
- "text": "number"
5654
- },
5655
- "fieldName": "level",
5656
- "default": "0",
5657
- "description": "The mip level of the skybox."
5658
- },
5659
6003
  {
5660
6004
  "name": "lighting",
5661
6005
  "type": {
@@ -5665,6 +6009,15 @@
5665
6009
  "default": "false",
5666
6010
  "description": "Whether the skybox is used as a light source."
5667
6011
  },
6012
+ {
6013
+ "name": "mip-level",
6014
+ "type": {
6015
+ "text": "number"
6016
+ },
6017
+ "fieldName": "mipLevel",
6018
+ "default": "0",
6019
+ "description": "The mip level of the skybox."
6020
+ },
5668
6021
  {
5669
6022
  "name": "rotation",
5670
6023
  "type": {
@@ -5868,7 +6221,7 @@
5868
6221
  "kind": "field",
5869
6222
  "name": "component",
5870
6223
  "type": {
5871
- "text": "Component"
6224
+ "text": "Component | null"
5872
6225
  },
5873
6226
  "description": "Gets the underlying PlayCanvas button component.",
5874
6227
  "return": {
@@ -6223,7 +6576,13 @@
6223
6576
  "kind": "field",
6224
6577
  "name": "closestApp",
6225
6578
  "type": {
6226
- "text": "AppElement"
6579
+ "text": "AppElement | null"
6580
+ },
6581
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
6582
+ "return": {
6583
+ "type": {
6584
+ "text": ""
6585
+ }
6227
6586
  },
6228
6587
  "readonly": true,
6229
6588
  "inheritedFrom": {
@@ -6235,7 +6594,13 @@
6235
6594
  "kind": "field",
6236
6595
  "name": "closestEntity",
6237
6596
  "type": {
6238
- "text": "EntityElement"
6597
+ "text": "EntityElement | null"
6598
+ },
6599
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
6600
+ "return": {
6601
+ "type": {
6602
+ "text": ""
6603
+ }
6239
6604
  },
6240
6605
  "readonly": true,
6241
6606
  "inheritedFrom": {
@@ -6561,12 +6926,12 @@
6561
6926
  },
6562
6927
  {
6563
6928
  "kind": "field",
6564
- "name": "_orthographic",
6929
+ "name": "_projection",
6565
6930
  "type": {
6566
- "text": "boolean"
6931
+ "text": "'perspective' | 'orthographic'"
6567
6932
  },
6568
6933
  "privacy": "private",
6569
- "default": "false"
6934
+ "default": "'perspective'"
6570
6935
  },
6571
6936
  {
6572
6937
  "kind": "field",
@@ -6650,7 +7015,7 @@
6650
7015
  "kind": "field",
6651
7016
  "name": "component",
6652
7017
  "type": {
6653
- "text": "Component"
7018
+ "text": "Component | null"
6654
7019
  },
6655
7020
  "description": "Gets the underlying PlayCanvas camera component.",
6656
7021
  "return": {
@@ -6894,17 +7259,14 @@
6894
7259
  },
6895
7260
  {
6896
7261
  "kind": "field",
6897
- "name": "orthographic",
6898
- "description": "Gets the orthographic projection of the camera.",
7262
+ "name": "orthoHeight",
7263
+ "description": "Gets the orthographic height of the camera.",
6899
7264
  "parameters": [
6900
7265
  {
6901
- "description": "The orthographic projection.",
7266
+ "description": "The orthographic height.",
6902
7267
  "name": "value"
6903
7268
  }
6904
7269
  ],
6905
- "type": {
6906
- "text": "boolean"
6907
- },
6908
7270
  "return": {
6909
7271
  "type": {
6910
7272
  "text": ""
@@ -6913,14 +7275,17 @@
6913
7275
  },
6914
7276
  {
6915
7277
  "kind": "field",
6916
- "name": "orthoHeight",
6917
- "description": "Gets the orthographic height of the camera.",
7278
+ "name": "priority",
7279
+ "description": "Gets the priority of the camera.",
6918
7280
  "parameters": [
6919
7281
  {
6920
- "description": "The orthographic height.",
7282
+ "description": "The priority.",
6921
7283
  "name": "value"
6922
7284
  }
6923
7285
  ],
7286
+ "type": {
7287
+ "text": "number"
7288
+ },
6924
7289
  "return": {
6925
7290
  "type": {
6926
7291
  "text": ""
@@ -6929,17 +7294,14 @@
6929
7294
  },
6930
7295
  {
6931
7296
  "kind": "field",
6932
- "name": "priority",
6933
- "description": "Gets the priority of the camera.",
7297
+ "name": "projection",
7298
+ "description": "Gets the projection of the camera.",
6934
7299
  "parameters": [
6935
7300
  {
6936
- "description": "The priority.",
7301
+ "description": "The projection ('perspective' or 'orthographic').",
6937
7302
  "name": "value"
6938
7303
  }
6939
7304
  ],
6940
- "type": {
6941
- "text": "number"
6942
- },
6943
7305
  "return": {
6944
7306
  "type": {
6945
7307
  "text": ""
@@ -7120,7 +7482,13 @@
7120
7482
  "kind": "field",
7121
7483
  "name": "closestApp",
7122
7484
  "type": {
7123
- "text": "AppElement"
7485
+ "text": "AppElement | null"
7486
+ },
7487
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
7488
+ "return": {
7489
+ "type": {
7490
+ "text": ""
7491
+ }
7124
7492
  },
7125
7493
  "readonly": true,
7126
7494
  "inheritedFrom": {
@@ -7132,7 +7500,13 @@
7132
7500
  "kind": "field",
7133
7501
  "name": "closestEntity",
7134
7502
  "type": {
7135
- "text": "EntityElement"
7503
+ "text": "EntityElement | null"
7504
+ },
7505
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
7506
+ "return": {
7507
+ "type": {
7508
+ "text": ""
7509
+ }
7136
7510
  },
7137
7511
  "readonly": true,
7138
7512
  "inheritedFrom": {
@@ -7296,15 +7670,6 @@
7296
7670
  "default": "10",
7297
7671
  "description": "The orthographic height of the camera."
7298
7672
  },
7299
- {
7300
- "name": "orthographic",
7301
- "type": {
7302
- "text": "boolean"
7303
- },
7304
- "fieldName": "orthographic",
7305
- "default": "false",
7306
- "description": "The orthographic projection of the camera."
7307
- },
7308
7673
  {
7309
7674
  "name": "priority",
7310
7675
  "type": {
@@ -7314,6 +7679,15 @@
7314
7679
  "default": "0",
7315
7680
  "description": "The priority of the camera."
7316
7681
  },
7682
+ {
7683
+ "name": "projection",
7684
+ "type": {
7685
+ "text": "'perspective' | 'orthographic'"
7686
+ },
7687
+ "fieldName": "projection",
7688
+ "default": "perspective",
7689
+ "description": "The projection of the camera."
7690
+ },
7317
7691
  {
7318
7692
  "name": "rect",
7319
7693
  "type": {
@@ -7475,7 +7849,7 @@
7475
7849
  "kind": "field",
7476
7850
  "name": "component",
7477
7851
  "type": {
7478
- "text": "Component"
7852
+ "text": "Component | null"
7479
7853
  },
7480
7854
  "description": "Gets the underlying PlayCanvas collision component.",
7481
7855
  "return": {
@@ -7638,7 +8012,13 @@
7638
8012
  "kind": "field",
7639
8013
  "name": "closestApp",
7640
8014
  "type": {
7641
- "text": "AppElement"
8015
+ "text": "AppElement | null"
8016
+ },
8017
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
8018
+ "return": {
8019
+ "type": {
8020
+ "text": ""
8021
+ }
7642
8022
  },
7643
8023
  "readonly": true,
7644
8024
  "inheritedFrom": {
@@ -7650,7 +8030,13 @@
7650
8030
  "kind": "field",
7651
8031
  "name": "closestEntity",
7652
8032
  "type": {
7653
- "text": "EntityElement"
8033
+ "text": "EntityElement | null"
8034
+ },
8035
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
8036
+ "return": {
8037
+ "type": {
8038
+ "text": ""
8039
+ }
7654
8040
  },
7655
8041
  "readonly": true,
7656
8042
  "inheritedFrom": {
@@ -7866,9 +8252,9 @@
7866
8252
  "kind": "field",
7867
8253
  "name": "component",
7868
8254
  "type": {
7869
- "text": "Component"
8255
+ "text": "Component | null"
7870
8256
  },
7871
- "description": "The PlayCanvas component instance. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
8257
+ "description": "The PlayCanvas component instance. `null` until the element is ready, and also for an\nelement that is not a descendant of a `<pc-entity>` — await whenReady or the\nelement's `ready()` promise before accessing it.",
7872
8258
  "return": {
7873
8259
  "type": {
7874
8260
  "text": ""
@@ -7921,7 +8307,13 @@
7921
8307
  "kind": "field",
7922
8308
  "name": "closestApp",
7923
8309
  "type": {
7924
- "text": "AppElement"
8310
+ "text": "AppElement | null"
8311
+ },
8312
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
8313
+ "return": {
8314
+ "type": {
8315
+ "text": ""
8316
+ }
7925
8317
  },
7926
8318
  "readonly": true,
7927
8319
  "inheritedFrom": {
@@ -7933,7 +8325,13 @@
7933
8325
  "kind": "field",
7934
8326
  "name": "closestEntity",
7935
8327
  "type": {
7936
- "text": "EntityElement"
8328
+ "text": "EntityElement | null"
8329
+ },
8330
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
8331
+ "return": {
8332
+ "type": {
8333
+ "text": ""
8334
+ }
7937
8335
  },
7938
8336
  "readonly": true,
7939
8337
  "inheritedFrom": {
@@ -8270,7 +8668,7 @@
8270
8668
  "kind": "field",
8271
8669
  "name": "component",
8272
8670
  "type": {
8273
- "text": "Component"
8671
+ "text": "Component | null"
8274
8672
  },
8275
8673
  "description": "Gets the underlying PlayCanvas element component.",
8276
8674
  "return": {
@@ -8812,7 +9210,13 @@
8812
9210
  "kind": "field",
8813
9211
  "name": "closestApp",
8814
9212
  "type": {
8815
- "text": "AppElement"
9213
+ "text": "AppElement | null"
9214
+ },
9215
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
9216
+ "return": {
9217
+ "type": {
9218
+ "text": ""
9219
+ }
8816
9220
  },
8817
9221
  "readonly": true,
8818
9222
  "inheritedFrom": {
@@ -8824,7 +9228,13 @@
8824
9228
  "kind": "field",
8825
9229
  "name": "closestEntity",
8826
9230
  "type": {
8827
- "text": "EntityElement"
9231
+ "text": "EntityElement | null"
9232
+ },
9233
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
9234
+ "return": {
9235
+ "type": {
9236
+ "text": ""
9237
+ }
8828
9238
  },
8829
9239
  "readonly": true,
8830
9240
  "inheritedFrom": {
@@ -9215,7 +9625,7 @@
9215
9625
  "kind": "field",
9216
9626
  "name": "component",
9217
9627
  "type": {
9218
- "text": "Component"
9628
+ "text": "Component | null"
9219
9629
  },
9220
9630
  "description": "Gets the underlying PlayCanvas gsplat component.",
9221
9631
  "return": {
@@ -9442,7 +9852,13 @@
9442
9852
  "kind": "field",
9443
9853
  "name": "closestApp",
9444
9854
  "type": {
9445
- "text": "AppElement"
9855
+ "text": "AppElement | null"
9856
+ },
9857
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
9858
+ "return": {
9859
+ "type": {
9860
+ "text": ""
9861
+ }
9446
9862
  },
9447
9863
  "readonly": true,
9448
9864
  "inheritedFrom": {
@@ -9454,7 +9870,13 @@
9454
9870
  "kind": "field",
9455
9871
  "name": "closestEntity",
9456
9872
  "type": {
9457
- "text": "EntityElement"
9873
+ "text": "EntityElement | null"
9874
+ },
9875
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
9876
+ "return": {
9877
+ "type": {
9878
+ "text": ""
9879
+ }
9458
9880
  },
9459
9881
  "readonly": true,
9460
9882
  "inheritedFrom": {
@@ -9679,7 +10101,7 @@
9679
10101
  "kind": "field",
9680
10102
  "name": "component",
9681
10103
  "type": {
9682
- "text": "Component"
10104
+ "text": "Component | null"
9683
10105
  },
9684
10106
  "description": "Gets the underlying PlayCanvas layout child component.",
9685
10107
  "return": {
@@ -9922,7 +10344,13 @@
9922
10344
  "kind": "field",
9923
10345
  "name": "closestApp",
9924
10346
  "type": {
9925
- "text": "AppElement"
10347
+ "text": "AppElement | null"
10348
+ },
10349
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
10350
+ "return": {
10351
+ "type": {
10352
+ "text": ""
10353
+ }
9926
10354
  },
9927
10355
  "readonly": true,
9928
10356
  "inheritedFrom": {
@@ -9934,7 +10362,13 @@
9934
10362
  "kind": "field",
9935
10363
  "name": "closestEntity",
9936
10364
  "type": {
9937
- "text": "EntityElement"
10365
+ "text": "EntityElement | null"
10366
+ },
10367
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
10368
+ "return": {
10369
+ "type": {
10370
+ "text": ""
10371
+ }
9938
10372
  },
9939
10373
  "readonly": true,
9940
10374
  "inheritedFrom": {
@@ -10176,7 +10610,7 @@
10176
10610
  "kind": "field",
10177
10611
  "name": "component",
10178
10612
  "type": {
10179
- "text": "Component"
10613
+ "text": "Component | null"
10180
10614
  },
10181
10615
  "description": "Gets the underlying PlayCanvas layout group component.",
10182
10616
  "return": {
@@ -10451,7 +10885,13 @@
10451
10885
  "kind": "field",
10452
10886
  "name": "closestApp",
10453
10887
  "type": {
10454
- "text": "AppElement"
10888
+ "text": "AppElement | null"
10889
+ },
10890
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
10891
+ "return": {
10892
+ "type": {
10893
+ "text": ""
10894
+ }
10455
10895
  },
10456
10896
  "readonly": true,
10457
10897
  "inheritedFrom": {
@@ -10463,7 +10903,13 @@
10463
10903
  "kind": "field",
10464
10904
  "name": "closestEntity",
10465
10905
  "type": {
10466
- "text": "EntityElement"
10906
+ "text": "EntityElement | null"
10907
+ },
10908
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
10909
+ "return": {
10910
+ "type": {
10911
+ "text": ""
10912
+ }
10467
10913
  },
10468
10914
  "readonly": true,
10469
10915
  "inheritedFrom": {
@@ -10821,7 +11267,7 @@
10821
11267
  "kind": "field",
10822
11268
  "name": "component",
10823
11269
  "type": {
10824
- "text": "Component"
11270
+ "text": "Component | null"
10825
11271
  },
10826
11272
  "description": "Gets the underlying PlayCanvas light component.",
10827
11273
  "return": {
@@ -11256,7 +11702,13 @@
11256
11702
  "kind": "field",
11257
11703
  "name": "closestApp",
11258
11704
  "type": {
11259
- "text": "AppElement"
11705
+ "text": "AppElement | null"
11706
+ },
11707
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
11708
+ "return": {
11709
+ "type": {
11710
+ "text": ""
11711
+ }
11260
11712
  },
11261
11713
  "readonly": true,
11262
11714
  "inheritedFrom": {
@@ -11268,7 +11720,13 @@
11268
11720
  "kind": "field",
11269
11721
  "name": "closestEntity",
11270
11722
  "type": {
11271
- "text": "EntityElement"
11723
+ "text": "EntityElement | null"
11724
+ },
11725
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
11726
+ "return": {
11727
+ "type": {
11728
+ "text": ""
11729
+ }
11272
11730
  },
11273
11731
  "readonly": true,
11274
11732
  "inheritedFrom": {
@@ -11540,7 +11998,7 @@
11540
11998
  "kind": "field",
11541
11999
  "name": "component",
11542
12000
  "type": {
11543
- "text": "Component"
12001
+ "text": "Component | null"
11544
12002
  },
11545
12003
  "description": "Gets the underlying PlayCanvas audio listener component.",
11546
12004
  "return": {
@@ -11679,7 +12137,13 @@
11679
12137
  "kind": "field",
11680
12138
  "name": "closestApp",
11681
12139
  "type": {
11682
- "text": "AppElement"
12140
+ "text": "AppElement | null"
12141
+ },
12142
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
12143
+ "return": {
12144
+ "type": {
12145
+ "text": ""
12146
+ }
11683
12147
  },
11684
12148
  "readonly": true,
11685
12149
  "inheritedFrom": {
@@ -11691,7 +12155,13 @@
11691
12155
  "kind": "field",
11692
12156
  "name": "closestEntity",
11693
12157
  "type": {
11694
- "text": "EntityElement"
12158
+ "text": "EntityElement | null"
12159
+ },
12160
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
12161
+ "return": {
12162
+ "type": {
12163
+ "text": ""
12164
+ }
11695
12165
  },
11696
12166
  "readonly": true,
11697
12167
  "inheritedFrom": {
@@ -11809,7 +12279,7 @@
11809
12279
  "kind": "field",
11810
12280
  "name": "component",
11811
12281
  "type": {
11812
- "text": "Component"
12282
+ "text": "Component | null"
11813
12283
  },
11814
12284
  "description": "Gets the underlying PlayCanvas particle system component.",
11815
12285
  "return": {
@@ -11997,7 +12467,13 @@
11997
12467
  "kind": "field",
11998
12468
  "name": "closestApp",
11999
12469
  "type": {
12000
- "text": "AppElement"
12470
+ "text": "AppElement | null"
12471
+ },
12472
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
12473
+ "return": {
12474
+ "type": {
12475
+ "text": ""
12476
+ }
12001
12477
  },
12002
12478
  "readonly": true,
12003
12479
  "inheritedFrom": {
@@ -12009,7 +12485,13 @@
12009
12485
  "kind": "field",
12010
12486
  "name": "closestEntity",
12011
12487
  "type": {
12012
- "text": "EntityElement"
12488
+ "text": "EntityElement | null"
12489
+ },
12490
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
12491
+ "return": {
12492
+ "type": {
12493
+ "text": ""
12494
+ }
12013
12495
  },
12014
12496
  "readonly": true,
12015
12497
  "inheritedFrom": {
@@ -12162,7 +12644,7 @@
12162
12644
  "kind": "field",
12163
12645
  "name": "component",
12164
12646
  "type": {
12165
- "text": "Component"
12647
+ "text": "Component | null"
12166
12648
  },
12167
12649
  "description": "Gets the underlying PlayCanvas render component.",
12168
12650
  "return": {
@@ -12366,7 +12848,13 @@
12366
12848
  "kind": "field",
12367
12849
  "name": "closestApp",
12368
12850
  "type": {
12369
- "text": "AppElement"
12851
+ "text": "AppElement | null"
12852
+ },
12853
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
12854
+ "return": {
12855
+ "type": {
12856
+ "text": ""
12857
+ }
12370
12858
  },
12371
12859
  "readonly": true,
12372
12860
  "inheritedFrom": {
@@ -12378,7 +12866,13 @@
12378
12866
  "kind": "field",
12379
12867
  "name": "closestEntity",
12380
12868
  "type": {
12381
- "text": "EntityElement"
12869
+ "text": "EntityElement | null"
12870
+ },
12871
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
12872
+ "return": {
12873
+ "type": {
12874
+ "text": ""
12875
+ }
12382
12876
  },
12383
12877
  "readonly": true,
12384
12878
  "inheritedFrom": {
@@ -12612,7 +13106,7 @@
12612
13106
  "kind": "field",
12613
13107
  "name": "component",
12614
13108
  "type": {
12615
- "text": "Component"
13109
+ "text": "Component | null"
12616
13110
  },
12617
13111
  "description": "Gets the underlying PlayCanvas rigidbody component.",
12618
13112
  "return": {
@@ -12779,7 +13273,13 @@
12779
13273
  "kind": "field",
12780
13274
  "name": "closestApp",
12781
13275
  "type": {
12782
- "text": "AppElement"
13276
+ "text": "AppElement | null"
13277
+ },
13278
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
13279
+ "return": {
13280
+ "type": {
13281
+ "text": ""
13282
+ }
12783
13283
  },
12784
13284
  "readonly": true,
12785
13285
  "inheritedFrom": {
@@ -12791,7 +13291,13 @@
12791
13291
  "kind": "field",
12792
13292
  "name": "closestEntity",
12793
13293
  "type": {
12794
- "text": "EntityElement"
13294
+ "text": "EntityElement | null"
13295
+ },
13296
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
13297
+ "return": {
13298
+ "type": {
13299
+ "text": ""
13300
+ }
12795
13301
  },
12796
13302
  "readonly": true,
12797
13303
  "inheritedFrom": {
@@ -13000,12 +13506,12 @@
13000
13506
  },
13001
13507
  {
13002
13508
  "kind": "field",
13003
- "name": "_blend",
13509
+ "name": "_scaleMode",
13004
13510
  "type": {
13005
- "text": "boolean"
13511
+ "text": "'none' | 'blend'"
13006
13512
  },
13007
13513
  "privacy": "private",
13008
- "default": "false"
13514
+ "default": "'none'"
13009
13515
  },
13010
13516
  {
13011
13517
  "kind": "field",
@@ -13028,7 +13534,7 @@
13028
13534
  "kind": "field",
13029
13535
  "name": "component",
13030
13536
  "type": {
13031
- "text": "Component"
13537
+ "text": "Component | null"
13032
13538
  },
13033
13539
  "description": "Gets the underlying PlayCanvas screen component.",
13034
13540
  "return": {
@@ -13056,11 +13562,35 @@
13056
13562
  },
13057
13563
  {
13058
13564
  "kind": "field",
13059
- "name": "scaleBlend"
13565
+ "name": "scaleBlend",
13566
+ "description": "Gets how the screen's resolutions are weighted against each other.",
13567
+ "parameters": [
13568
+ {
13569
+ "description": "The scale blend factor.",
13570
+ "name": "value"
13571
+ }
13572
+ ],
13573
+ "return": {
13574
+ "type": {
13575
+ "text": ""
13576
+ }
13577
+ }
13060
13578
  },
13061
13579
  {
13062
13580
  "kind": "field",
13063
- "name": "blend"
13581
+ "name": "scaleMode",
13582
+ "description": "Gets how the screen scales its contents.",
13583
+ "parameters": [
13584
+ {
13585
+ "description": "The scale mode ('none' or 'blend').",
13586
+ "name": "value"
13587
+ }
13588
+ ],
13589
+ "return": {
13590
+ "type": {
13591
+ "text": ""
13592
+ }
13593
+ }
13064
13594
  },
13065
13595
  {
13066
13596
  "kind": "field",
@@ -13183,7 +13713,13 @@
13183
13713
  "kind": "field",
13184
13714
  "name": "closestApp",
13185
13715
  "type": {
13186
- "text": "AppElement"
13716
+ "text": "AppElement | null"
13717
+ },
13718
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
13719
+ "return": {
13720
+ "type": {
13721
+ "text": ""
13722
+ }
13187
13723
  },
13188
13724
  "readonly": true,
13189
13725
  "inheritedFrom": {
@@ -13195,7 +13731,13 @@
13195
13731
  "kind": "field",
13196
13732
  "name": "closestEntity",
13197
13733
  "type": {
13198
- "text": "EntityElement"
13734
+ "text": "EntityElement | null"
13735
+ },
13736
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
13737
+ "return": {
13738
+ "type": {
13739
+ "text": ""
13740
+ }
13199
13741
  },
13200
13742
  "readonly": true,
13201
13743
  "inheritedFrom": {
@@ -13229,14 +13771,6 @@
13229
13771
  }
13230
13772
  ],
13231
13773
  "attributes": [
13232
- {
13233
- "name": "blend",
13234
- "type": {
13235
- "text": "boolean"
13236
- },
13237
- "fieldName": "blend",
13238
- "default": "false"
13239
- },
13240
13774
  {
13241
13775
  "name": "enabled",
13242
13776
  "type": {
@@ -13282,7 +13816,17 @@
13282
13816
  "text": "number"
13283
13817
  },
13284
13818
  "fieldName": "scaleBlend",
13285
- "default": "0.5"
13819
+ "default": "0.5",
13820
+ "description": "How the screen's resolutions are weighted against each other."
13821
+ },
13822
+ {
13823
+ "name": "scale-mode",
13824
+ "type": {
13825
+ "text": "'none' | 'blend'"
13826
+ },
13827
+ "fieldName": "scaleMode",
13828
+ "default": "none",
13829
+ "description": "How the screen scales its contents."
13286
13830
  },
13287
13831
  {
13288
13832
  "name": "screen-space",
@@ -13706,7 +14250,7 @@
13706
14250
  "kind": "field",
13707
14251
  "name": "component",
13708
14252
  "type": {
13709
- "text": "Component"
14253
+ "text": "Component | null"
13710
14254
  },
13711
14255
  "description": "Gets the underlying PlayCanvas script component.",
13712
14256
  "return": {
@@ -13837,7 +14381,13 @@
13837
14381
  "kind": "field",
13838
14382
  "name": "closestApp",
13839
14383
  "type": {
13840
- "text": "AppElement"
14384
+ "text": "AppElement | null"
14385
+ },
14386
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
14387
+ "return": {
14388
+ "type": {
14389
+ "text": ""
14390
+ }
13841
14391
  },
13842
14392
  "readonly": true,
13843
14393
  "inheritedFrom": {
@@ -13849,7 +14399,13 @@
13849
14399
  "kind": "field",
13850
14400
  "name": "closestEntity",
13851
14401
  "type": {
13852
- "text": "EntityElement"
14402
+ "text": "EntityElement | null"
14403
+ },
14404
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
14405
+ "return": {
14406
+ "type": {
14407
+ "text": ""
14408
+ }
13853
14409
  },
13854
14410
  "readonly": true,
13855
14411
  "inheritedFrom": {
@@ -14068,7 +14624,13 @@
14068
14624
  "kind": "field",
14069
14625
  "name": "closestApp",
14070
14626
  "type": {
14071
- "text": "AppElement"
14627
+ "text": "AppElement | null"
14628
+ },
14629
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
14630
+ "return": {
14631
+ "type": {
14632
+ "text": ""
14633
+ }
14072
14634
  },
14073
14635
  "readonly": true,
14074
14636
  "inheritedFrom": {
@@ -14080,7 +14642,13 @@
14080
14642
  "kind": "field",
14081
14643
  "name": "closestEntity",
14082
14644
  "type": {
14083
- "text": "EntityElement"
14645
+ "text": "EntityElement | null"
14646
+ },
14647
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
14648
+ "return": {
14649
+ "type": {
14650
+ "text": ""
14651
+ }
14084
14652
  },
14085
14653
  "readonly": true,
14086
14654
  "inheritedFrom": {
@@ -14258,7 +14826,7 @@
14258
14826
  "kind": "field",
14259
14827
  "name": "component",
14260
14828
  "type": {
14261
- "text": "Component"
14829
+ "text": "Component | null"
14262
14830
  },
14263
14831
  "description": "Gets the underlying PlayCanvas scrollbar component.",
14264
14832
  "return": {
@@ -14453,7 +15021,13 @@
14453
15021
  "kind": "field",
14454
15022
  "name": "closestApp",
14455
15023
  "type": {
14456
- "text": "AppElement"
15024
+ "text": "AppElement | null"
15025
+ },
15026
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
15027
+ "return": {
15028
+ "type": {
15029
+ "text": ""
15030
+ }
14457
15031
  },
14458
15032
  "readonly": true,
14459
15033
  "inheritedFrom": {
@@ -14465,7 +15039,13 @@
14465
15039
  "kind": "field",
14466
15040
  "name": "closestEntity",
14467
15041
  "type": {
14468
- "text": "EntityElement"
15042
+ "text": "EntityElement | null"
15043
+ },
15044
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
15045
+ "return": {
15046
+ "type": {
15047
+ "text": ""
15048
+ }
14469
15049
  },
14470
15050
  "readonly": true,
14471
15051
  "inheritedFrom": {
@@ -14723,7 +15303,7 @@
14723
15303
  "kind": "field",
14724
15304
  "name": "component",
14725
15305
  "type": {
14726
- "text": "Component"
15306
+ "text": "Component | null"
14727
15307
  },
14728
15308
  "description": "Gets the underlying PlayCanvas scroll view component.",
14729
15309
  "return": {
@@ -14740,7 +15320,7 @@
14740
15320
  {
14741
15321
  "kind": "field",
14742
15322
  "name": "horizontal",
14743
- "description": "Gets whether horizontal scrolling is enabled.",
15323
+ "description": "Gets whether scrolling along the horizontal axis is enabled.",
14744
15324
  "parameters": [
14745
15325
  {
14746
15326
  "description": "Whether horizontal scrolling is enabled.",
@@ -14756,7 +15336,7 @@
14756
15336
  {
14757
15337
  "kind": "field",
14758
15338
  "name": "vertical",
14759
- "description": "Gets whether vertical scrolling is enabled.",
15339
+ "description": "Gets whether scrolling along the vertical axis is enabled.",
14760
15340
  "parameters": [
14761
15341
  {
14762
15342
  "description": "Whether vertical scrolling is enabled.",
@@ -15062,7 +15642,13 @@
15062
15642
  "kind": "field",
15063
15643
  "name": "closestApp",
15064
15644
  "type": {
15065
- "text": "AppElement"
15645
+ "text": "AppElement | null"
15646
+ },
15647
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
15648
+ "return": {
15649
+ "type": {
15650
+ "text": ""
15651
+ }
15066
15652
  },
15067
15653
  "readonly": true,
15068
15654
  "inheritedFrom": {
@@ -15074,7 +15660,13 @@
15074
15660
  "kind": "field",
15075
15661
  "name": "closestEntity",
15076
15662
  "type": {
15077
- "text": "EntityElement"
15663
+ "text": "EntityElement | null"
15664
+ },
15665
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
15666
+ "return": {
15667
+ "type": {
15668
+ "text": ""
15669
+ }
15078
15670
  },
15079
15671
  "readonly": true,
15080
15672
  "inheritedFrom": {
@@ -15154,7 +15746,7 @@
15154
15746
  },
15155
15747
  "fieldName": "horizontal",
15156
15748
  "default": "true",
15157
- "description": "Whether horizontal scrolling is enabled."
15749
+ "description": "Whether scrolling along the horizontal axis is enabled."
15158
15750
  },
15159
15751
  {
15160
15752
  "name": "horizontal-scrollbar",
@@ -15207,7 +15799,7 @@
15207
15799
  },
15208
15800
  "fieldName": "vertical",
15209
15801
  "default": "true",
15210
- "description": "Whether vertical scrolling is enabled."
15802
+ "description": "Whether scrolling along the vertical axis is enabled."
15211
15803
  },
15212
15804
  {
15213
15805
  "name": "vertical-scrollbar",
@@ -15359,7 +15951,7 @@
15359
15951
  "kind": "field",
15360
15952
  "name": "component",
15361
15953
  "type": {
15362
- "text": "Component"
15954
+ "text": "Component | null"
15363
15955
  },
15364
15956
  "description": "Gets the underlying PlayCanvas sound component.",
15365
15957
  "return": {
@@ -15605,7 +16197,13 @@
15605
16197
  "kind": "field",
15606
16198
  "name": "closestApp",
15607
16199
  "type": {
15608
- "text": "AppElement"
16200
+ "text": "AppElement | null"
16201
+ },
16202
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
16203
+ "return": {
16204
+ "type": {
16205
+ "text": ""
16206
+ }
15609
16207
  },
15610
16208
  "readonly": true,
15611
16209
  "inheritedFrom": {
@@ -15617,7 +16215,13 @@
15617
16215
  "kind": "field",
15618
16216
  "name": "closestEntity",
15619
16217
  "type": {
15620
- "text": "EntityElement"
16218
+ "text": "EntityElement | null"
16219
+ },
16220
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
16221
+ "return": {
16222
+ "type": {
16223
+ "text": ""
16224
+ }
15621
16225
  },
15622
16226
  "readonly": true,
15623
16227
  "inheritedFrom": {
@@ -16062,7 +16666,13 @@
16062
16666
  "kind": "field",
16063
16667
  "name": "closestApp",
16064
16668
  "type": {
16065
- "text": "AppElement"
16669
+ "text": "AppElement | null"
16670
+ },
16671
+ "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
16672
+ "return": {
16673
+ "type": {
16674
+ "text": ""
16675
+ }
16066
16676
  },
16067
16677
  "readonly": true,
16068
16678
  "inheritedFrom": {
@@ -16074,7 +16684,13 @@
16074
16684
  "kind": "field",
16075
16685
  "name": "closestEntity",
16076
16686
  "type": {
16077
- "text": "EntityElement"
16687
+ "text": "EntityElement | null"
16688
+ },
16689
+ "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
16690
+ "return": {
16691
+ "type": {
16692
+ "text": ""
16693
+ }
16078
16694
  },
16079
16695
  "readonly": true,
16080
16696
  "inheritedFrom": {