@roomle/embedding-lib 4.38.0 → 4.41.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 (33) hide show
  1. package/docs/__sidebar__.json +14 -0
  2. package/docs/api/classes/exposed_analytics_callbacks.ExposedAnalyticsCallbacks.md +1 -1
  3. package/docs/api/classes/exposed_api.ExposedApi.md +11 -11
  4. package/docs/api/classes/exposed_callbacks.ExposedCallbacks.md +8 -8
  5. package/docs/api/classes/roomle_configurator_api.default.md +9 -9
  6. package/docs/api/enums/types.UI_BUTTON.md +33 -22
  7. package/docs/api/interfaces/exposed_callbacks.Labels.md +2 -2
  8. package/docs/api/interfaces/exposed_callbacks.Price.md +2 -2
  9. package/docs/api/interfaces/roomle_configurator_api.RoomleEmbeddingApiKeys.md +4 -4
  10. package/docs/api/interfaces/types.ConfiguratorSettings.md +5 -5
  11. package/docs/api/interfaces/types.EmbeddingSkin.md +5 -5
  12. package/docs/api/interfaces/types.UiInitData.md +31 -16
  13. package/docs/api/modules/roomle_configurator_api.md +3 -3
  14. package/docs/examples/11_light_settings.html +89 -62
  15. package/docs/examples/roomle-configurator-api.es.min.js +254 -58
  16. package/docs/hsp.md +61 -0
  17. package/docs/integration.md +1101 -0
  18. package/docs/md/web/ui/EMBEDDING-CHANGELOG.md +10 -37
  19. package/docs/migration-guides/v2-to-v3.md +2 -2
  20. package/docs/moc/index.md +86 -0
  21. package/docs/simple.md +1 -1
  22. package/package.json +2 -2
  23. package/types/index.d.ts +18 -6
  24. package/types/src/common/store/collection-view-state.d.ts +8 -3
  25. package/types/src/common/store/common-ui-state.d.ts +1 -1
  26. package/types/src/configurator/embedding/exposed-api.d.ts +0 -1
  27. package/types/src/configurator/embedding/types.d.ts +8 -1
  28. package/types/src/configurator/store/ui-state.d.ts +1 -0
  29. package/types/tests/helpers/dom.d.ts +1 -1
  30. package/types/tests/helpers/mocks/sdk-connector.d.ts +1 -0
  31. package/types/tests/integration/planner/components/utils/sidebar-nav/SidebarNav.spec.d.ts +1 -0
  32. package/types/tests/unit/configurator/components/utils/WordWrap.spec.d.ts +1 -0
  33. package/docs/index.md +0 -847
@@ -43,6 +43,7 @@
43
43
  - [isItem](types.UiInitData.md#isitem)
44
44
  - [locale](types.UiInitData.md#locale)
45
45
  - [ls](types.UiInitData.md#ls)
46
+ - [materialMultiSelect](types.UiInitData.md#materialmultiselect)
46
47
  - [maxHorizontalCameraAngle](types.UiInitData.md#maxhorizontalcameraangle)
47
48
  - [maxVerticalCameraAngle](types.UiInitData.md#maxverticalcameraangle)
48
49
  - [meshSelection](types.UiInitData.md#meshselection)
@@ -127,7 +128,7 @@ to view 3d content. Imagine it then as a <img> tag for 3d content
127
128
 
128
129
  #### Defined in
129
130
 
130
- [src/configurator/embedding/types.ts:90](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L90)
131
+ [src/configurator/embedding/types.ts:92](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L92)
131
132
 
132
133
  ___
133
134
 
@@ -144,7 +145,7 @@ InitDataDefinition.applyCurrentGlobalParameters
144
145
 
145
146
  #### Defined in
146
147
 
147
- [src/configurator/embedding/types.ts:137](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L137)
148
+ [src/configurator/embedding/types.ts:139](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L139)
148
149
 
149
150
  ___
150
151
 
@@ -209,12 +210,13 @@ ___
209
210
  | `resetcamera?` | false \| true |
210
211
  | `savedraft?` | false \| true |
211
212
  | `snapping?` | false \| true |
213
+ | `startPlanner?` | false \| true |
212
214
  | `startconfigure?` | false \| true |
213
215
  | `undo?` | false \| true |
214
216
 
215
217
  #### Defined in
216
218
 
217
- [src/configurator/embedding/types.ts:39](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L39)
219
+ [src/configurator/embedding/types.ts:40](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L40)
218
220
 
219
221
  ___
220
222
 
@@ -345,7 +347,7 @@ usage: http://www.example.com/configurator?id=#CONFIGURATIONID#
345
347
 
346
348
  #### Defined in
347
349
 
348
- [src/configurator/embedding/types.ts:77](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L77)
350
+ [src/configurator/embedding/types.ts:79](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L79)
349
351
 
350
352
  ___
351
353
 
@@ -410,7 +412,7 @@ an e-mail
410
412
 
411
413
  #### Defined in
412
414
 
413
- [src/configurator/embedding/types.ts:95](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L95)
415
+ [src/configurator/embedding/types.ts:97](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L97)
414
416
 
415
417
  ___
416
418
 
@@ -424,7 +426,7 @@ so that we can ensure a smooth transition between different versions of our conf
424
426
 
425
427
  #### Defined in
426
428
 
427
- [src/configurator/embedding/types.ts:111](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L111)
429
+ [src/configurator/embedding/types.ts:113](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L113)
428
430
 
429
431
  ___
430
432
 
@@ -452,7 +454,7 @@ set this flag to false if the user did not give the consent to Analytics
452
454
 
453
455
  #### Defined in
454
456
 
455
- [src/configurator/embedding/types.ts:115](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L115)
457
+ [src/configurator/embedding/types.ts:117](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L117)
456
458
 
457
459
  ___
458
460
 
@@ -464,7 +466,7 @@ set this flag to true if you want to group the part list by main components
464
466
 
465
467
  #### Defined in
466
468
 
467
- [src/configurator/embedding/types.ts:105](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L105)
469
+ [src/configurator/embedding/types.ts:107](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L107)
468
470
 
469
471
  ___
470
472
 
@@ -552,6 +554,19 @@ node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:20
552
554
 
553
555
  ___
554
556
 
557
+ ### materialMultiSelect
558
+
559
+ • `Optional` **materialMultiSelect**: false \| true
560
+
561
+ set this flag to true if you want that a user can select more than one material category at once
562
+ default: false
563
+
564
+ #### Defined in
565
+
566
+ [src/configurator/embedding/types.ts:144](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L144)
567
+
568
+ ___
569
+
555
570
  ### maxHorizontalCameraAngle
556
571
 
557
572
  • `Optional` **maxHorizontalCameraAngle**: `number`
@@ -651,7 +666,7 @@ small div
651
666
 
652
667
  #### Defined in
653
668
 
654
- [src/configurator/embedding/types.ts:101](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L101)
669
+ [src/configurator/embedding/types.ts:103](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L103)
655
670
 
656
671
  ___
657
672
 
@@ -772,7 +787,7 @@ ___
772
787
 
773
788
  #### Defined in
774
789
 
775
- [src/configurator/embedding/types.ts:63](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L63)
790
+ [src/configurator/embedding/types.ts:65](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L65)
776
791
 
777
792
  ___
778
793
 
@@ -887,7 +902,7 @@ for details see deeplink, the only change is that the placeholder is <CONF_ID> h
887
902
 
888
903
  #### Defined in
889
904
 
890
- [src/configurator/embedding/types.ts:68](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L68)
905
+ [src/configurator/embedding/types.ts:70](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L70)
891
906
 
892
907
  ___
893
908
 
@@ -949,7 +964,7 @@ ___
949
964
 
950
965
  #### Defined in
951
966
 
952
- [src/configurator/embedding/types.ts:60](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L60)
967
+ [src/configurator/embedding/types.ts:62](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L62)
953
968
 
954
969
  ___
955
970
 
@@ -1007,7 +1022,7 @@ You can find all labels here: [Base.json](../../../ui/base.json)
1007
1022
 
1008
1023
  #### Defined in
1009
1024
 
1010
- [src/configurator/embedding/types.ts:132](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L132)
1025
+ [src/configurator/embedding/types.ts:134](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L134)
1011
1026
 
1012
1027
  ___
1013
1028
 
@@ -1088,7 +1103,7 @@ ___
1088
1103
 
1089
1104
  #### Defined in
1090
1105
 
1091
- [src/configurator/embedding/types.ts:62](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L62)
1106
+ [src/configurator/embedding/types.ts:64](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L64)
1092
1107
 
1093
1108
  ___
1094
1109
 
@@ -1139,7 +1154,7 @@ usm:frame is loaded all the items from the tag "DB_Start_ohne_Element" are now s
1139
1154
 
1140
1155
  #### Defined in
1141
1156
 
1142
- [src/configurator/embedding/types.ts:84](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L84)
1157
+ [src/configurator/embedding/types.ts:86](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L86)
1143
1158
 
1144
1159
  ___
1145
1160
 
@@ -1149,7 +1164,7 @@ ___
1149
1164
 
1150
1165
  #### Defined in
1151
1166
 
1152
- [src/configurator/embedding/types.ts:61](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/types.ts#L61)
1167
+ [src/configurator/embedding/types.ts:63](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L63)
1153
1168
 
1154
1169
  ___
1155
1170
 
@@ -26,7 +26,7 @@
26
26
 
27
27
  #### Defined in
28
28
 
29
- [src/configurator/embedding/roomle-configurator-api.ts:70](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/roomle-configurator-api.ts#L70)
29
+ [src/configurator/embedding/roomle-configurator-api.ts:70](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/roomle-configurator-api.ts#L70)
30
30
 
31
31
  ___
32
32
 
@@ -36,7 +36,7 @@ ___
36
36
 
37
37
  #### Defined in
38
38
 
39
- [src/configurator/embedding/roomle-configurator-api.ts:72](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/roomle-configurator-api.ts#L72)
39
+ [src/configurator/embedding/roomle-configurator-api.ts:72](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/roomle-configurator-api.ts#L72)
40
40
 
41
41
  ___
42
42
 
@@ -46,4 +46,4 @@ ___
46
46
 
47
47
  #### Defined in
48
48
 
49
- [src/configurator/embedding/roomle-configurator-api.ts:71](https://gitlab.com/roomle/web/roomle-ui/-/blob/69e35fbb/src/configurator/embedding/roomle-configurator-api.ts#L71)
49
+ [src/configurator/embedding/roomle-configurator-api.ts:71](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/roomle-configurator-api.ts#L71)
@@ -6,31 +6,36 @@
6
6
  padding: 0;
7
7
  overflow: hidden;
8
8
  }
9
+
9
10
  .ls, .product {
10
- width: 70px;
11
- height: 70px;
12
- margin: 10px;
13
- background-color:azure;
14
- border: 1px solid blue;
15
- color: #090909;
16
- text-align: center;
17
- display: flex;
18
- align-items: center;
19
- cursor: pointer;
11
+ width: 70px;
12
+ height: 70px;
13
+ margin: 10px;
14
+ background-color: azure;
15
+ border: 1px solid blue;
16
+ color: #090909;
17
+ text-align: center;
18
+ display: flex;
19
+ align-items: center;
20
+ cursor: pointer;
20
21
  }
22
+
21
23
  .product {
22
- width: 70px;
23
- height: 70px;
24
- margin: 10px;
25
- background-color:rgb(232, 254, 232);
26
- border: 1px solid green;
24
+ width: 70px;
25
+ height: 70px;
26
+ margin: 10px;
27
+ background-color: rgb(232, 254, 232);
28
+ border: 1px solid green;
27
29
  }
30
+
28
31
  .ls div, .product div {
29
- width: 100%;
32
+ width: 100%;
30
33
  }
34
+
31
35
  .container {
32
- display: flex;
36
+ display: flex;
33
37
  }
38
+
34
39
  #configurator-container {
35
40
  width: 1024px;
36
41
  height: 600px;
@@ -40,60 +45,82 @@
40
45
 
41
46
  <body>
42
47
  <div class="container">
43
- <div class="product" data-roomle-id="usm:frame:1E13940F850F734EDF5ADF48191E9ACDAD93BEC0BE757F89E78807A5DA0FAD8C"><div>Shelf</div></div>
44
- <div class="product" data-roomle-id="musterring:Felicia_Sofa:7698BEE48226BBB1E0AF93F342018DC1FC269242F02D1F0C9367414A26CA3425"><div>Sofa</div></div>
45
- <div class="product" data-roomle-id="hussl:ST6N:C39C46D1AD6F8BC9E3F778A6F92CB017B785CE960D8D4C7146223348A9B70590"><div>Chair</div></div>
48
+ <div class="product"
49
+ data-roomle-id="usm:frame:1E13940F850F734EDF5ADF48191E9ACDAD93BEC0BE757F89E78807A5DA0FAD8C">
50
+ <div>Shelf</div>
51
+ </div>
52
+ <div class="product"
53
+ data-roomle-id="musterring:Felicia_Sofa:7698BEE48226BBB1E0AF93F342018DC1FC269242F02D1F0C9367414A26CA3425">
54
+ <div>Sofa</div>
55
+ </div>
56
+ <div class="product"
57
+ data-roomle-id="hussl:ST6N:C39C46D1AD6F8BC9E3F778A6F92CB017B785CE960D8D4C7146223348A9B70590">
58
+ <div>Chair</div>
59
+ </div>
46
60
  </div>
47
61
  <div class="container">
48
- <div class="ls" data-roomle-ls="sofa"><div>Sofa<br>Light</div></div>
49
- <div class="ls" data-roomle-ls="shelf"><div>Shelf<br>Light</div></div>
50
- <div class="ls" data-roomle-ls="shelf_front"><div>Shelf Front<br>Light</div></div>
51
- <div class="ls" data-roomle-ls="equal"><div>Equal<br>Light</div></div>
52
- <div class="ls" data-roomle-ls="camera"><div>Camera<br>Light</div></div>
53
- <div class="ls" data-roomle-ls="baked"><div>Baked<br>Light</div></div>
62
+ <div class="ls" data-roomle-ls="sofa">
63
+ <div>Sofa<br>Light</div>
64
+ </div>
65
+ <div class="ls" data-roomle-ls="shelf">
66
+ <div>Shelf<br>Light</div>
67
+ </div>
68
+ <div class="ls" data-roomle-ls="shelf_front">
69
+ <div>Shelf Front<br>Light</div>
70
+ </div>
71
+ <div class="ls" data-roomle-ls="equal">
72
+ <div>Equal<br>Light</div>
73
+ </div>
74
+ <div class="ls" data-roomle-ls="camera">
75
+ <div>Camera<br>Light</div>
76
+ </div>
77
+ <div class="ls" data-roomle-ls="baked">
78
+ <div>Baked<br>Light</div>
79
+ </div>
54
80
  </div>
55
81
  <div id="configurator-container"></div>
56
82
  <script src="./roomle-configurator-api.es.min.js" type="module"></script>
57
83
  <script type="module">
58
- import RoomleConfiguratorApi from './roomle-configurator-api.es.min.js';
59
- (async ()=> {
60
- const options = {
61
- id: 'usm:frame:1E13940F850F734EDF5ADF48191E9ACDAD93BEC0BE757F89E78807A5DA0FAD8C'
62
- };
63
- const configurator = await RoomleConfiguratorApi.createConfigurator(
64
- 'demoConfigurator',
65
- document.getElementById('configurator-container'),
66
- options,
67
- );
84
+ import RoomleConfiguratorApi from './roomle-configurator-api.es.min.js';
85
+
86
+ (async () => {
87
+ const options = {
88
+ id: 'usm:frame:1E13940F850F734EDF5ADF48191E9ACDAD93BEC0BE757F89E78807A5DA0FAD8C',
89
+ };
90
+ const configurator = await RoomleConfiguratorApi.createConfigurator(
91
+ 'demoConfigurator',
92
+ document.getElementById('configurator-container'),
93
+ options,
94
+ );
68
95
 
69
- [...document.querySelectorAll('.ls')].forEach((button) => {
70
- button.addEventListener('click', (productDomNode) => {
71
- const target = productDomNode.target;
72
- let roomleLs = target.getAttribute('data-roomle-ls') || target.parentElement.getAttribute('data-roomle-ls');
73
- if(!roomleLs) {
74
- return;
75
- }
76
- // this is obfuscated on purpose because it uses internal API functions
77
- // which are not meant to be used! This example should only demonstrate
78
- // the different light settings. Sure it's easy to decode the string but
79
- // please do not copy and paste the decoded code into your production app
80
- // unless you know what you do :-)
81
- eval(atob('Y29uZmlndXJhdG9yLmV4dGVuZGVkLmxvYWREeW5hbWljTGlnaHRTZXR0aW5nKHtsczogcm9vbWxlTHN9KQ=='));
82
- });
83
- });
96
+ [...document.querySelectorAll('.ls')].forEach((button) => {
97
+ button.addEventListener('click', (productDomNode) => {
98
+ const target = productDomNode.target;
99
+ let roomleLs = target.getAttribute('data-roomle-ls') || target.parentElement.getAttribute('data-roomle-ls');
100
+ if (!roomleLs) {
101
+ return;
102
+ }
103
+ // this is obfuscated on purpose because it uses internal API functions
104
+ // which are not meant to be used! This example should only demonstrate
105
+ // the different light settings. Sure it's easy to decode the string but
106
+ // please do not copy and paste the decoded code into your production app
107
+ // unless you know what you do :-)
108
+ eval(atob('Y29uZmlndXJhdG9yLmV4dGVuZGVkLmxvYWREeW5hbWljTGlnaHRTZXR0aW5nKHtsczogcm9vbWxlTHN9KQ=='));
109
+ });
110
+ });
84
111
 
85
- [...document.querySelectorAll('.product')].forEach((button) => {
86
- button.addEventListener('click', (productDomNode) => {
87
- const target = productDomNode.target;
88
- let roomleId = target.getAttribute('data-roomle-id') || target.parentElement.getAttribute('data-roomle-id');
89
- if(!roomleId) {
90
- return;
91
- }
92
- configurator.ui.loadObject(roomleId);
93
- });
94
- });
95
- })();
112
+ [...document.querySelectorAll('.product')].forEach((button) => {
113
+ button.addEventListener('click', (productDomNode) => {
114
+ const target = productDomNode.target;
96
115
  let roomleId = target.getAttribute('data-roomle-id') || target.parentElement.getAttribute('data-roomle-id');
116
+ if (!roomleId) {
117
+ return;
118
+ }
119
+ configurator.ui.loadObject(roomleId);
120
+ });
121
+ });
122
+ })();
123
+ let roomleId = target.getAttribute('data-roomle-id') || target.parentElement.getAttribute('data-roomle-id');
97
124
  </script>
98
125
  </body>
99
126
  </html>