@roomle/embedding-lib 4.42.0 → 4.43.0-debug.1

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 (39) hide show
  1. package/.releaserc.json +2 -2
  2. package/docs/md/web/ui/EMBEDDING-CHANGELOG.md +119 -8
  3. package/package.json +1 -28
  4. package/types/index.d.ts +32 -10
  5. package/types/src/common/components/collection-view/-utils/types.d.ts +2 -2
  6. package/types/src/common/store/index.d.ts +4 -0
  7. package/types/src/common/utils/types.d.ts +4 -0
  8. package/types/src/configurator/business-logic/sdk-connector.d.ts +2 -1
  9. package/types/src/configurator/embedding/types.d.ts +5 -0
  10. package/types/src/configurator/store/ui-state.d.ts +3 -1
  11. package/types/src/planner/business-logic/general-room-parameters.d.ts +17 -0
  12. package/types/src/planner/business-logic/rooms.d.ts +27 -2
  13. package/types/src/planner/store/planner-core-data.d.ts +2 -2
  14. package/types/src/planner/store/planner-ui-state.d.ts +9 -2
  15. package/types/src/planner/utils/planner-sidebar.d.ts +1 -2
  16. package/types/tests/helpers/data/planObject.d.ts +134 -0
  17. package/types/tests/helpers/mocks/roomle-sdk-wrapper.d.ts +135 -0
  18. package/types/tests/integration/planner/components/{SelectionPreview.spec.d.ts → overlays/rooms/RoomGeneralSettings.spec.d.ts} +0 -0
  19. package/types/tests/integration/planner/components/overlays/rooms/RoomRangeParameter.spec.d.ts +1 -0
  20. package/docs/api/.nojekyll +0 -1
  21. package/docs/api/README.md +0 -9
  22. package/docs/api/classes/exposed_analytics_callbacks.ExposedAnalyticsCallbacks.md +0 -47
  23. package/docs/api/classes/exposed_api.ExposedApi.md +0 -255
  24. package/docs/api/classes/exposed_callbacks.ExposedCallbacks.md +0 -195
  25. package/docs/api/classes/roomle_configurator_api.default.md +0 -211
  26. package/docs/api/enums/types.UI_BUTTON.md +0 -263
  27. package/docs/api/interfaces/exposed_callbacks.Labels.md +0 -32
  28. package/docs/api/interfaces/exposed_callbacks.Price.md +0 -32
  29. package/docs/api/interfaces/roomle_configurator_api.RoomleEmbeddingApiKeys.md +0 -58
  30. package/docs/api/interfaces/types.ConfiguratorSettings.md +0 -150
  31. package/docs/api/interfaces/types.EmbeddingSkin.md +0 -65
  32. package/docs/api/interfaces/types.UiInitData.md +0 -1185
  33. package/docs/api/interfaces/types.VariantsMap.md +0 -9
  34. package/docs/api/modules/exposed_analytics_callbacks.md +0 -9
  35. package/docs/api/modules/exposed_api.md +0 -9
  36. package/docs/api/modules/exposed_callbacks.md +0 -14
  37. package/docs/api/modules/roomle_configurator_api.md +0 -49
  38. package/docs/api/modules/types.md +0 -16
  39. package/docs/api/modules.md +0 -13
@@ -1,1185 +0,0 @@
1
- [Embedding API Reference](../README.md) / [Modules](../modules.md) / [types](../modules/types.md) / UiInitData
2
-
3
- # Interface: UiInitData
4
-
5
- [types](../modules/types.md).UiInitData
6
-
7
- ## Hierarchy
8
-
9
- - `InitDataDefinition`
10
-
11
- - `GlobalInitDataDefinition`
12
-
13
- ↳ **`UiInitData`**
14
-
15
- ## Table of contents
16
-
17
- ### Properties
18
-
19
- - [\_measureTraffic](types.UiInitData.md#_measuretraffic)
20
- - [alwaysUseCache](types.UiInitData.md#alwaysusecache)
21
- - [api](types.UiInitData.md#api)
22
- - [applyCurrentGlobalParameters](types.UiInitData.md#applycurrentglobalparameters)
23
- - [autoQuality](types.UiInitData.md#autoquality)
24
- - [bananaForScale](types.UiInitData.md#bananaforscale)
25
- - [buttons](types.UiInitData.md#buttons)
26
- - [cameraRestriction](types.UiInitData.md#camerarestriction)
27
- - [cameraSpacing](types.UiInitData.md#cameraspacing)
28
- - [colors](types.UiInitData.md#colors)
29
- - [configuratorId](types.UiInitData.md#configuratorid)
30
- - [customApiUrl](types.UiInitData.md#customapiurl)
31
- - [debug](types.UiInitData.md#debug)
32
- - [deeplink](types.UiInitData.md#deeplink)
33
- - [disableEnvMap](types.UiInitData.md#disableenvmap)
34
- - [dls](types.UiInitData.md#dls)
35
- - [edit](types.UiInitData.md#edit)
36
- - [emails](types.UiInitData.md#emails)
37
- - [featureFlags](types.UiInitData.md#featureflags)
38
- - [floorMaterialsTag](types.UiInitData.md#floormaterialstag)
39
- - [gaConsent](types.UiInitData.md#gaconsent)
40
- - [groupPartList](types.UiInitData.md#grouppartlist)
41
- - [id](types.UiInitData.md#id)
42
- - [initialFloorMaterial](types.UiInitData.md#initialfloormaterial)
43
- - [isItem](types.UiInitData.md#isitem)
44
- - [locale](types.UiInitData.md#locale)
45
- - [ls](types.UiInitData.md#ls)
46
- - [materialMultiSelect](types.UiInitData.md#materialmultiselect)
47
- - [maxHorizontalCameraAngle](types.UiInitData.md#maxhorizontalcameraangle)
48
- - [maxVerticalCameraAngle](types.UiInitData.md#maxverticalcameraangle)
49
- - [meshSelection](types.UiInitData.md#meshselection)
50
- - [minHorizontalCameraAngle](types.UiInitData.md#minhorizontalcameraangle)
51
- - [minVerticalCameraAngle](types.UiInitData.md#minverticalcameraangle)
52
- - [mobileLandscape](types.UiInitData.md#mobilelandscape)
53
- - [moc](types.UiInitData.md#moc)
54
- - [mode](types.UiInitData.md#mode)
55
- - [offlineSync](types.UiInitData.md#offlinesync)
56
- - [offset](types.UiInitData.md#offset)
57
- - [overrideCountry](types.UiInitData.md#overridecountry)
58
- - [overrideRapi](types.UiInitData.md#overriderapi)
59
- - [overrideServerUrl](types.UiInitData.md#overrideserverurl)
60
- - [overrideTenant](types.UiInitData.md#overridetenant)
61
- - [precisionCm](types.UiInitData.md#precisioncm)
62
- - [precisionInch](types.UiInitData.md#precisioninch)
63
- - [preloadHint](types.UiInitData.md#preloadhint)
64
- - [preloadId](types.UiInitData.md#preloadid)
65
- - [shareUrl](types.UiInitData.md#shareurl)
66
- - [showArButton](types.UiInitData.md#showarbutton)
67
- - [showInfos](types.UiInitData.md#showinfos)
68
- - [showPrice](types.UiInitData.md#showprice)
69
- - [skin](types.UiInitData.md#skin)
70
- - [startTag](types.UiInitData.md#starttag)
71
- - [stats](types.UiInitData.md#stats)
72
- - [translations](types.UiInitData.md#translations)
73
- - [transparentHighlighting](types.UiInitData.md#transparenthighlighting)
74
- - [typeChangeTag](types.UiInitData.md#typechangetag)
75
- - [unit](types.UiInitData.md#unit)
76
- - [unitStringType](types.UiInitData.md#unitstringtype)
77
- - [useLocalRoomle](types.UiInitData.md#uselocalroomle)
78
- - [usePriceService](types.UiInitData.md#usepriceservice)
79
- - [useRoomlePrice](types.UiInitData.md#useroomleprice)
80
- - [variants](types.UiInitData.md#variants)
81
- - [zIndex](types.UiInitData.md#zindex)
82
- - [zoomDistance](types.UiInitData.md#zoomdistance)
83
-
84
- ## Properties
85
-
86
- ### \_measureTraffic
87
-
88
- • `Optional` **\_measureTraffic**: false \| true
89
-
90
- **`internal`**
91
- Enable service worker which tracks performance and request size (content, materials, etc)
92
-
93
- #### Inherited from
94
-
95
- InitDataDefinition.\_measureTraffic
96
-
97
- #### Defined in
98
-
99
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:165
100
-
101
- ___
102
-
103
- ### alwaysUseCache
104
-
105
- • `Optional` **alwaysUseCache**: false \| true
106
-
107
- when set to true and assets were prechaced by the asset loader they are returned from cache. Otherwise we always return a fresh copy from network
108
- usage: alwaysUseCache=true
109
- default: not set -> assets fetched from url, set -> assets from cache
110
-
111
- #### Inherited from
112
-
113
- GlobalInitDataDefinition.alwaysUseCache
114
-
115
- #### Defined in
116
-
117
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:48
118
-
119
- ___
120
-
121
- ### api
122
-
123
- • `Optional` **api**: false \| true
124
-
125
- if set to true you can load the configurator in an iframe.src but without any embedding lib
126
- This is needed if you do not want to interact with the configurator and only want to use it
127
- to view 3d content. Imagine it then as a <img> tag for 3d content
128
-
129
- #### Defined in
130
-
131
- [src/configurator/embedding/types.ts:92](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L92)
132
-
133
- ___
134
-
135
- ### applyCurrentGlobalParameters
136
-
137
- • `Optional` **applyCurrentGlobalParameters**: false \| true
138
-
139
- set this flag to false and global parameters are not applied when switching variants
140
- default: true
141
-
142
- #### Overrides
143
-
144
- InitDataDefinition.applyCurrentGlobalParameters
145
-
146
- #### Defined in
147
-
148
- [src/configurator/embedding/types.ts:139](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L139)
149
-
150
- ___
151
-
152
- ### autoQuality
153
-
154
- • `Optional` **autoQuality**: false \| true
155
-
156
- If set to true the configurator will make sure every device has great user experience with fluid frame rate.
157
- If set to false the configurator will always show the highest quality possible.
158
- That could lead to stutter and other problems on low-end devices. We advise you to only turn off "autoQuality" if you really know what you are doing.
159
- default: true
160
- usage: autoQuality=false
161
-
162
- #### Inherited from
163
-
164
- InitDataDefinition.autoQuality
165
-
166
- #### Defined in
167
-
168
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:66
169
-
170
- ___
171
-
172
- ### bananaForScale
173
-
174
- • `Optional` **bananaForScale**: false \| true
175
-
176
- Easter Egg
177
-
178
- #### Inherited from
179
-
180
- InitDataDefinition.bananaForScale
181
-
182
- #### Defined in
183
-
184
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:242
185
-
186
- ___
187
-
188
- ### buttons
189
-
190
- • `Optional` **buttons**: `Object`
191
-
192
- #### Type declaration
193
-
194
- | Name | Type |
195
- | :------ | :------ |
196
- | `2dview?` | false \| true |
197
- | `add_room?` | false \| true |
198
- | `addons?` | false \| true |
199
- | `ar?` | false \| true |
200
- | `dimensions?` | false \| true |
201
- | `export3d?` | false \| true |
202
- | `fullscreen?` | false \| true |
203
- | `multiselect?` | false \| true |
204
- | `partlist?` | false \| true |
205
- | `partlist_planner?` | false \| true |
206
- | `pauseconfigure?` | false \| true |
207
- | `redo?` | false \| true |
208
- | `renderimage?` | false \| true |
209
- | `requestproduct?` | false \| true |
210
- | `resetcamera?` | false \| true |
211
- | `savedraft?` | false \| true |
212
- | `snapping?` | false \| true |
213
- | `startPlanner?` | false \| true |
214
- | `startconfigure?` | false \| true |
215
- | `undo?` | false \| true |
216
-
217
- #### Defined in
218
-
219
- [src/configurator/embedding/types.ts:40](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L40)
220
-
221
- ___
222
-
223
- ### cameraRestriction
224
-
225
- • `Optional` **cameraRestriction**: `number`
226
-
227
- When set this param restricts the camera rotation to the given angle (e.g. 45 degree), this overrides minHorizontalCameraAngle and maxHorizontalCameraAngle
228
- default: not set -> no camera restriction
229
- usage: cameraRestriction=45
230
-
231
- #### Inherited from
232
-
233
- InitDataDefinition.cameraRestriction
234
-
235
- #### Defined in
236
-
237
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:216
238
-
239
- ___
240
-
241
- ### cameraSpacing
242
-
243
- • `Optional` **cameraSpacing**: `number`
244
-
245
- Adds the given spacing (in centimeters) to the loaded object. This is then used to calculate the initial camera distance
246
- default: object size itself
247
- usage: cameraSpacing=100
248
-
249
- #### Inherited from
250
-
251
- InitDataDefinition.cameraSpacing
252
-
253
- #### Defined in
254
-
255
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:268
256
-
257
- ___
258
-
259
- ### colors
260
-
261
- • `Optional` **colors**: `Object`
262
-
263
- Can be used to personalize colors used in the 3D scene
264
-
265
- #### Type declaration
266
-
267
- | Name | Type |
268
- | :------ | :------ |
269
- | `DEFAULT_BACKGROUND` | `string` |
270
- | `ON_PRIMARY` | `string` |
271
- | `PRIMARY` | `string` |
272
- | `SELECTION` | `string` |
273
-
274
- #### Inherited from
275
-
276
- InitDataDefinition.colors
277
-
278
- #### Defined in
279
-
280
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:68
281
-
282
- ___
283
-
284
- ### configuratorId
285
-
286
- • `Optional` **configuratorId**: `string`
287
-
288
- The id which should be used for this configurator instance.
289
- When this id is set all InitData parameter can be set and changed in Rubens Admin.
290
- This is the way we recommend to set init data params.
291
- Ask your Roomle contact for your configuratorId.
292
-
293
- #### Inherited from
294
-
295
- GlobalInitDataDefinition.configuratorId
296
-
297
- #### Defined in
298
-
299
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:42
300
-
301
- ___
302
-
303
- ### customApiUrl
304
-
305
- • `Optional` **customApiUrl**: `string`
306
-
307
- Set which RAPI (Roomle API) backend should be used
308
- usage: customApiUrl=https://www.roomle.com/api/v2
309
-
310
- #### Inherited from
311
-
312
- GlobalInitDataDefinition.customApiUrl
313
-
314
- #### Defined in
315
-
316
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:53
317
-
318
- ___
319
-
320
- ### debug
321
-
322
- • `Optional` **debug**: false \| true
323
-
324
- This flag enables:
325
- - Scripter debug logs (e.g. which parameter is not assigned to a parameter group)
326
- - Free camera movement (no restrictions, camera stays after reload, panning using Shift key)
327
-
328
- #### Inherited from
329
-
330
- InitDataDefinition.debug
331
-
332
- #### Defined in
333
-
334
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:171
335
-
336
- ___
337
-
338
- ### deeplink
339
-
340
- • `Optional` **deeplink**: `string`
341
-
342
- Set this parameter to use your custom share url.
343
- The provided url has to contain a configuration id parameter (`#CONFIGURATIONID#`) which will be replaced with the real
344
- configuration id.
345
- default: not set -> use Roomle short url service (linking to roomle.com domain)
346
- usage: http://www.example.com/configurator?id=#CONFIGURATIONID#
347
-
348
- #### Defined in
349
-
350
- [src/configurator/embedding/types.ts:79](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L79)
351
-
352
- ___
353
-
354
- ### disableEnvMap
355
-
356
- • `Optional` **disableEnvMap**: false \| true
357
-
358
- **`internal`**
359
- If set to true, it will disable the environment map completely
360
-
361
- #### Inherited from
362
-
363
- InitDataDefinition.disableEnvMap
364
-
365
- #### Defined in
366
-
367
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:181
368
-
369
- ___
370
-
371
- ### dls
372
-
373
- • `Optional` **dls**: `string`
374
-
375
- **`internal`**
376
- Load a light setting using an URL.
377
- Check lights in {@link SceneSettings} for an example.
378
-
379
- #### Inherited from
380
-
381
- InitDataDefinition.dls
382
-
383
- #### Defined in
384
-
385
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:199
386
-
387
- ___
388
-
389
- ### edit
390
-
391
- • `Optional` **edit**: false \| true
392
-
393
- **`internal`**
394
- If set to true the plan can be edited.
395
-
396
- #### Inherited from
397
-
398
- InitDataDefinition.edit
399
-
400
- #### Defined in
401
-
402
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:287
403
-
404
- ___
405
-
406
- ### emails
407
-
408
- • `Optional` **emails**: false \| true
409
-
410
- if this is set to true the "save draft" will be done by sending
411
- an e-mail
412
-
413
- #### Defined in
414
-
415
- [src/configurator/embedding/types.ts:97](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L97)
416
-
417
- ___
418
-
419
- ### featureFlags
420
-
421
- • `Optional` **featureFlags**: `FeatureFlags`
422
-
423
- **`internal`**
424
- this is an object which is for Roomle internal usage, we can set feature flags
425
- so that we can ensure a smooth transition between different versions of our configurator
426
-
427
- #### Defined in
428
-
429
- [src/configurator/embedding/types.ts:113](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L113)
430
-
431
- ___
432
-
433
- ### floorMaterialsTag
434
-
435
- • `Optional` **floorMaterialsTag**: `string`
436
-
437
- **`deprecated`**
438
-
439
- #### Inherited from
440
-
441
- InitDataDefinition.floorMaterialsTag
442
-
443
- #### Defined in
444
-
445
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:204
446
-
447
- ___
448
-
449
- ### gaConsent
450
-
451
- • `Optional` **gaConsent**: false \| true
452
-
453
- set this flag to false if the user did not give the consent to Analytics
454
-
455
- #### Defined in
456
-
457
- [src/configurator/embedding/types.ts:117](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L117)
458
-
459
- ___
460
-
461
- ### groupPartList
462
-
463
- • `Optional` **groupPartList**: false \| true
464
-
465
- set this flag to true if you want to group the part list by main components
466
-
467
- #### Defined in
468
-
469
- [src/configurator/embedding/types.ts:107](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L107)
470
-
471
- ___
472
-
473
- ### id
474
-
475
- • `Optional` **id**: `string`
476
-
477
- The item id or configuration id of the item which should be loaded.
478
- Examples:
479
- Configuration id: usm:frame:2449773A7F54278EBB61A67A10EF6A10E8BB6F38BE775B028AC050B438414507
480
- Item id: usm:frame
481
-
482
- #### Inherited from
483
-
484
- InitDataDefinition.id
485
-
486
- #### Defined in
487
-
488
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:81
489
-
490
- ___
491
-
492
- ### initialFloorMaterial
493
-
494
- • `Optional` **initialFloorMaterial**: `string`
495
-
496
- Set the floor material which is used when loading the configurator
497
- For different options see {@link EnvironmentSetting}
498
-
499
- #### Inherited from
500
-
501
- InitDataDefinition.initialFloorMaterial
502
-
503
- #### Defined in
504
-
505
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:193
506
-
507
- ___
508
-
509
- ### isItem
510
-
511
- • `Optional` **isItem**: false \| true
512
-
513
- **`deprecated`**
514
- Set if the currently loaded id is an item or a configuration.
515
- In the new configurator UI this is determined automatically based on the id.
516
-
517
- #### Inherited from
518
-
519
- InitDataDefinition.isItem
520
-
521
- #### Defined in
522
-
523
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:74
524
-
525
- ___
526
-
527
- ### locale
528
-
529
- • `Optional` **locale**: `string`
530
-
531
- Set the language/locale which should be used, for example 'de' or 'en'
532
-
533
- #### Inherited from
534
-
535
- GlobalInitDataDefinition.locale
536
-
537
- #### Defined in
538
-
539
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:16
540
-
541
- ___
542
-
543
- ### ls
544
-
545
- • `Optional` **ls**: `string`
546
-
547
- #### Inherited from
548
-
549
- InitDataDefinition.ls
550
-
551
- #### Defined in
552
-
553
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:200
554
-
555
- ___
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/e86e4e35/src/configurator/embedding/types.ts#L144)
567
-
568
- ___
569
-
570
- ### maxHorizontalCameraAngle
571
-
572
- • `Optional` **maxHorizontalCameraAngle**: `number`
573
-
574
- When set this param restricts the right/horizontal camera rotation to the given angle (e.g. 45 degree)
575
- default: not set -> no camera angle restriction
576
- usage: maxHorizontalCameraAngle=45
577
-
578
- #### Inherited from
579
-
580
- InitDataDefinition.maxHorizontalCameraAngle
581
-
582
- #### Defined in
583
-
584
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:240
585
-
586
- ___
587
-
588
- ### maxVerticalCameraAngle
589
-
590
- • `Optional` **maxVerticalCameraAngle**: `number`
591
-
592
- When set this param restricts the up/vertical camera rotation to the given angle (e.g. 45 degree)
593
- default: not set -> no camera angle restriction
594
- usage: maxVerticalCameraAngle=45
595
-
596
- #### Inherited from
597
-
598
- InitDataDefinition.maxVerticalCameraAngle
599
-
600
- #### Defined in
601
-
602
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:228
603
-
604
- ___
605
-
606
- ### meshSelection
607
-
608
- • `Optional` **meshSelection**: false \| true
609
-
610
- When mesh selection is enabled, the meshes of the object are used directly for highlighting.
611
- Setting it to false could be useful for square/rectangular (shelf) items.
612
-
613
- #### Inherited from
614
-
615
- InitDataDefinition.meshSelection
616
-
617
- #### Defined in
618
-
619
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:158
620
-
621
- ___
622
-
623
- ### minHorizontalCameraAngle
624
-
625
- • `Optional` **minHorizontalCameraAngle**: `number`
626
-
627
- When set this param restricts the left/horizontal camera rotation to the given angle (e.g. 45 degree)
628
- default: not set -> no camera angle restriction
629
- usage: minHorizontalCameraAngle=45
630
-
631
- #### Inherited from
632
-
633
- InitDataDefinition.minHorizontalCameraAngle
634
-
635
- #### Defined in
636
-
637
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:234
638
-
639
- ___
640
-
641
- ### minVerticalCameraAngle
642
-
643
- • `Optional` **minVerticalCameraAngle**: `number`
644
-
645
- When set this param restricts the down/vertical camera rotation to the given angle (e.g. 45 degree)
646
- default: not set -> no camera angle restriction
647
- usage: minVerticalCameraAngle=45
648
-
649
- #### Inherited from
650
-
651
- InitDataDefinition.minVerticalCameraAngle
652
-
653
- #### Defined in
654
-
655
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:222
656
-
657
- ___
658
-
659
- ### mobileLandscape
660
-
661
- • `Optional` **mobileLandscape**: false \| true
662
-
663
- set this flag to true if you want to configure on small devices in landscape as well
664
- this is relevant for things like Rubens Admin, where the configurator is embedded into a very
665
- small div
666
-
667
- #### Defined in
668
-
669
- [src/configurator/embedding/types.ts:103](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L103)
670
-
671
- ___
672
-
673
- ### moc
674
-
675
- • `Optional` **moc**: false \| true
676
-
677
- If set to true it will treat the planner as a multi object configurator (moc).
678
- This means:
679
- - do not merge geometries
680
- - set configurator environment & lights in planner
681
- - reduce initial spacing of camera (higher zoom)
682
-
683
- #### Inherited from
684
-
685
- InitDataDefinition.moc
686
-
687
- #### Defined in
688
-
689
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:295
690
-
691
- ___
692
-
693
- ### mode
694
-
695
- • `Optional` **mode**: `CAMERA_2D` \| `CAMERA_3D` \| `CAMERA_FP`
696
-
697
- Select with which camera mode to start initially.
698
- default: 3D
699
- usage: mode=2D
700
- options: 2D, 3D, FP
701
-
702
- #### Inherited from
703
-
704
- InitDataDefinition.mode
705
-
706
- #### Defined in
707
-
708
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:282
709
-
710
- ___
711
-
712
- ### offlineSync
713
-
714
- • `Optional` **offlineSync**: `string`
715
-
716
- **`deprecated`**
717
- Download all necessary files to run the configurator in offline mode
718
-
719
- #### Inherited from
720
-
721
- InitDataDefinition.offlineSync
722
-
723
- #### Defined in
724
-
725
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:188
726
-
727
- ___
728
-
729
- ### offset
730
-
731
- • `Optional` **offset**: `CanvasOffset`
732
-
733
- **`deprecated`**
734
- Change the offset of the camera. For example if you add a margin left (0.1 means 10%) then
735
- the item moves to the right.
736
- This value is overridden in the new configurator UI.
737
-
738
- #### Inherited from
739
-
740
- InitDataDefinition.offset
741
-
742
- #### Defined in
743
-
744
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:148
745
-
746
- ___
747
-
748
- ### overrideCountry
749
-
750
- • `Optional` **overrideCountry**: `string`
751
-
752
- Set country to use for the Roomle price service.
753
- If not used the customer IP address will be used to determine the location.
754
- usage: overrideCountry=de
755
-
756
- #### Inherited from
757
-
758
- GlobalInitDataDefinition.overrideCountry
759
-
760
- #### Defined in
761
-
762
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:29
763
-
764
- ___
765
-
766
- ### overrideRapi
767
-
768
- • `Optional` **overrideRapi**: ``"live"`` \| ``"test"``
769
-
770
- **`internal`**
771
- Set which RAPI (Roomle API) backend should be used
772
- options: live, test
773
-
774
- #### Inherited from
775
-
776
- GlobalInitDataDefinition.overrideRapi
777
-
778
- #### Defined in
779
-
780
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:35
781
-
782
- ___
783
-
784
- ### overrideServerUrl
785
-
786
- • `Optional` **overrideServerUrl**: `string`
787
-
788
- #### Defined in
789
-
790
- [src/configurator/embedding/types.ts:65](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L65)
791
-
792
- ___
793
-
794
- ### overrideTenant
795
-
796
- • `Optional` **overrideTenant**: `number`
797
-
798
- **`internal`**
799
-
800
- **`deprecated`**
801
- Can be used for content testing
802
- default: 9
803
-
804
- #### Inherited from
805
-
806
- GlobalInitDataDefinition.overrideTenant
807
-
808
- #### Defined in
809
-
810
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:23
811
-
812
- ___
813
-
814
- ### precisionCm
815
-
816
- • `Optional` **precisionCm**: `string`
817
-
818
- Set how many positions after the decimal point should be shown.
819
- For example:
820
- 123,45 -> precisionCm=2 -> 123,45
821
- 123,45 -> precisionCm=1 -> 123,5
822
- 123,45 -> precisionCm=0 -> 124
823
-
824
- #### Inherited from
825
-
826
- InitDataDefinition.precisionCm
827
-
828
- #### Defined in
829
-
830
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:118
831
-
832
- ___
833
-
834
- ### precisionInch
835
-
836
- • `Optional` **precisionInch**: `string`
837
-
838
- Set how many positions after the decimal point should be shown.
839
- For example:
840
- 8' 1.68" -> precisionCm=2 -> 8' 1.68"
841
- 8' 1.68" -> precisionCm=1 -> 8' 1.7"
842
- 8' 1.68" -> precisionCm=0 -> 8' 2"
843
-
844
- #### Inherited from
845
-
846
- InitDataDefinition.precisionInch
847
-
848
- #### Defined in
849
-
850
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:110
851
-
852
- ___
853
-
854
- ### preloadHint
855
-
856
- • `Optional` **preloadHint**: `string`
857
-
858
- **`deprecated`**
859
-
860
- **`internal`**
861
- Same as preloadId, both call getPreloadForItem or getPreloadForConfiguration to pre load things needed
862
- for the configuration so that there are less XHR calls and the cache is pre-warmed
863
- Will no longer be used in the new configurator UI.
864
-
865
- #### Inherited from
866
-
867
- InitDataDefinition.preloadHint
868
-
869
- #### Defined in
870
-
871
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:141
872
-
873
- ___
874
-
875
- ### preloadId
876
-
877
- • `Optional` **preloadId**: `string`
878
-
879
- **`deprecated`**
880
-
881
- **`internal`**
882
- Same as preloadHint, both call getPreloadForItem or getPreloadForConfiguration to pre load things needed
883
- for the configuration so that there are less XHR calls and the cache is pre-warmed
884
- Will no longer be used in the new configurator UI.
885
-
886
- #### Inherited from
887
-
888
- InitDataDefinition.preloadId
889
-
890
- #### Defined in
891
-
892
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:89
893
-
894
- ___
895
-
896
- ### shareUrl
897
-
898
- • `Optional` **shareUrl**: `string`
899
-
900
- **`deprecated`**
901
- for details see deeplink, the only change is that the placeholder is <CONF_ID> here instead of #CONFIGURATIONID#
902
-
903
- #### Defined in
904
-
905
- [src/configurator/embedding/types.ts:70](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L70)
906
-
907
- ___
908
-
909
- ### showArButton
910
-
911
- • `Optional` **showArButton**: false \| true
912
-
913
- **`deprecated`**
914
- Set if the AR button should be shown.
915
- In the new configurator UI this is in the configurator settings object called buttons.
916
-
917
- #### Inherited from
918
-
919
- InitDataDefinition.showArButton
920
-
921
- #### Defined in
922
-
923
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:95
924
-
925
- ___
926
-
927
- ### showInfos
928
-
929
- • `Optional` **showInfos**: false \| true
930
-
931
- **`deprecated`**
932
- Shows partlist if there are no prices
933
-
934
- #### Inherited from
935
-
936
- InitDataDefinition.showInfos
937
-
938
- #### Defined in
939
-
940
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:253
941
-
942
- ___
943
-
944
- ### showPrice
945
-
946
- • `Optional` **showPrice**: false \| true
947
-
948
- **`deprecated`**
949
- Show price label using prices from configuration script
950
-
951
- #### Inherited from
952
-
953
- InitDataDefinition.showPrice
954
-
955
- #### Defined in
956
-
957
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:258
958
-
959
- ___
960
-
961
- ### skin
962
-
963
- • `Optional` **skin**: [`EmbeddingSkin`](types.EmbeddingSkin.md)
964
-
965
- #### Defined in
966
-
967
- [src/configurator/embedding/types.ts:62](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L62)
968
-
969
- ___
970
-
971
- ### startTag
972
-
973
- • `Optional` **startTag**: `string`
974
-
975
- **`deprecated`**
976
- Add a tag id which is used to show different variations when opening the configurator
977
-
978
- #### Inherited from
979
-
980
- InitDataDefinition.startTag
981
-
982
- #### Defined in
983
-
984
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:153
985
-
986
- ___
987
-
988
- ### stats
989
-
990
- • `Optional` **stats**: false \| true
991
-
992
- if set to true it shows a little overlay with performance stats
993
-
994
- #### Inherited from
995
-
996
- InitDataDefinition.stats
997
-
998
- #### Defined in
999
-
1000
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:160
1001
-
1002
- ___
1003
-
1004
- ### translations
1005
-
1006
- • `Optional` **translations**: `any`
1007
-
1008
- override translations to change labels for some or all languages.
1009
- Example:
1010
-
1011
- ```
1012
- "translations": {
1013
- "en": {
1014
- "params": {
1015
- "request-product": "Add to cart",
1016
- }
1017
- }
1018
- }
1019
- ```
1020
-
1021
- You can find all labels here: [Base.json](../../../ui/base.json)
1022
-
1023
- #### Defined in
1024
-
1025
- [src/configurator/embedding/types.ts:134](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L134)
1026
-
1027
- ___
1028
-
1029
- ### transparentHighlighting
1030
-
1031
- • `Optional` **transparentHighlighting**: false \| true
1032
-
1033
- If set to true, components which are between the camera and the selected component/preview will be rendered transparent
1034
- default: false
1035
- usage: transparentHighlighting=true
1036
-
1037
- #### Inherited from
1038
-
1039
- InitDataDefinition.transparentHighlighting
1040
-
1041
- #### Defined in
1042
-
1043
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:248
1044
-
1045
- ___
1046
-
1047
- ### typeChangeTag
1048
-
1049
- • `Optional` **typeChangeTag**: `string`
1050
-
1051
- Add a tag id which is used to show different variations for the current item/configuration
1052
-
1053
- #### Inherited from
1054
-
1055
- InitDataDefinition.typeChangeTag
1056
-
1057
- #### Defined in
1058
-
1059
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:133
1060
-
1061
- ___
1062
-
1063
- ### unit
1064
-
1065
- • `Optional` **unit**: `string`
1066
-
1067
- Defines which unit should be used for measurements/dimensions
1068
- Options: 'cm', 'mm', 'inchfeet'
1069
-
1070
- #### Inherited from
1071
-
1072
- InitDataDefinition.unit
1073
-
1074
- #### Defined in
1075
-
1076
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:123
1077
-
1078
- ___
1079
-
1080
- ### unitStringType
1081
-
1082
- • `Optional` **unitStringType**: `string`
1083
-
1084
- How the current unit should be formatted
1085
- Options:
1086
- 'none': No unit string added, for example '200'
1087
- 'long': Long unit string, for example '200 meters'
1088
- 'short': Short unit string, for example '200 m'
1089
-
1090
- #### Inherited from
1091
-
1092
- InitDataDefinition.unitStringType
1093
-
1094
- #### Defined in
1095
-
1096
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:131
1097
-
1098
- ___
1099
-
1100
- ### useLocalRoomle
1101
-
1102
- • `Optional` **useLocalRoomle**: false \| true
1103
-
1104
- #### Defined in
1105
-
1106
- [src/configurator/embedding/types.ts:64](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L64)
1107
-
1108
- ___
1109
-
1110
- ### usePriceService
1111
-
1112
- • `Optional` **usePriceService**: false \| true
1113
-
1114
- If set to true, prices are calculated using the Roomle price service.
1115
- For more information ask your Roomle contact.
1116
-
1117
- #### Inherited from
1118
-
1119
- InitDataDefinition.usePriceService
1120
-
1121
- #### Defined in
1122
-
1123
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:176
1124
-
1125
- ___
1126
-
1127
- ### useRoomlePrice
1128
-
1129
- • `Optional` **useRoomlePrice**: false \| true
1130
-
1131
- **`internal`**
1132
-
1133
- **`deprecated`**
1134
- Use prices which are hardcoded in the configuration script.
1135
- Only used for trade show demos.
1136
-
1137
- #### Inherited from
1138
-
1139
- InitDataDefinition.useRoomlePrice
1140
-
1141
- #### Defined in
1142
-
1143
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:102
1144
-
1145
- ___
1146
-
1147
- ### variants
1148
-
1149
- • `Optional` **variants**: [`VariantsMap`](types.VariantsMap.md)
1150
-
1151
- Define to which variants you can switch from which root component id. This is a simple JS object which is
1152
- used like a map, e.g.: { "usm:frame": "DB_Start_ohne_Element" } now if a configuration with root component
1153
- usm:frame is loaded all the items from the tag "DB_Start_ohne_Element" are now shown as variants
1154
-
1155
- #### Defined in
1156
-
1157
- [src/configurator/embedding/types.ts:86](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L86)
1158
-
1159
- ___
1160
-
1161
- ### zIndex
1162
-
1163
- • `Optional` **zIndex**: `number`
1164
-
1165
- #### Defined in
1166
-
1167
- [src/configurator/embedding/types.ts:63](https://gitlab.com/roomle/web/roomle-ui/-/blob/e86e4e35/src/configurator/embedding/types.ts#L63)
1168
-
1169
- ___
1170
-
1171
- ### zoomDistance
1172
-
1173
- • `Optional` **zoomDistance**: `number`
1174
-
1175
- Set the distance to which the user can zoom (in centimeters).
1176
- default: object size divided by 10 or 10 cm
1177
- usage: zoomDistance=3
1178
-
1179
- #### Inherited from
1180
-
1181
- InitDataDefinition.zoomDistance
1182
-
1183
- #### Defined in
1184
-
1185
- node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:210