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