@combeenation/3d-viewer 5.0.1 → 5.0.3-beta2

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 (109) hide show
  1. package/README.md +111 -114
  2. package/dist/lib-cjs/api/classes/animationInterface.d.ts +8 -8
  3. package/dist/lib-cjs/api/classes/animationInterface.js +1 -1
  4. package/dist/lib-cjs/api/classes/dottedPath.d.ts +79 -79
  5. package/dist/lib-cjs/api/classes/dottedPath.js +187 -187
  6. package/dist/lib-cjs/api/classes/element.d.ts +139 -139
  7. package/dist/lib-cjs/api/classes/element.js +794 -794
  8. package/dist/lib-cjs/api/classes/element.js.map +1 -1
  9. package/dist/lib-cjs/api/classes/elementParameterizable.d.ts +14 -0
  10. package/dist/lib-cjs/api/classes/elementParameterizable.js +135 -0
  11. package/dist/lib-cjs/api/classes/elementParameterizable.js.map +1 -0
  12. package/dist/lib-cjs/api/classes/event.d.ts +326 -326
  13. package/dist/lib-cjs/api/classes/event.js +371 -371
  14. package/dist/lib-cjs/api/classes/eventBroadcaster.d.ts +26 -26
  15. package/dist/lib-cjs/api/classes/eventBroadcaster.js +53 -53
  16. package/dist/lib-cjs/api/classes/parameter.d.ts +316 -259
  17. package/dist/lib-cjs/api/classes/parameter.js +451 -388
  18. package/dist/lib-cjs/api/classes/parameter.js.map +1 -1
  19. package/dist/lib-cjs/api/classes/parameterObservable.d.ts +36 -36
  20. package/dist/lib-cjs/api/classes/parameterObservable.js +101 -101
  21. package/dist/lib-cjs/api/classes/parameterizable.d.ts +15 -15
  22. package/dist/lib-cjs/api/classes/parameterizable.js +149 -149
  23. package/dist/lib-cjs/api/classes/placementAnimation.d.ts +44 -44
  24. package/dist/lib-cjs/api/classes/placementAnimation.js +163 -163
  25. package/dist/lib-cjs/api/classes/variant.d.ts +234 -234
  26. package/dist/lib-cjs/api/classes/variant.js +1154 -1154
  27. package/dist/lib-cjs/api/classes/variantInstance.d.ts +45 -45
  28. package/dist/lib-cjs/api/classes/variantInstance.js +108 -108
  29. package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
  30. package/dist/lib-cjs/api/classes/variantParameterizable.js +99 -99
  31. package/dist/lib-cjs/api/classes/viewer.d.ts +177 -175
  32. package/dist/lib-cjs/api/classes/viewer.js +717 -701
  33. package/dist/lib-cjs/api/classes/viewer.js.map +1 -1
  34. package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -66
  35. package/dist/lib-cjs/api/classes/viewerLight.js +392 -392
  36. package/dist/lib-cjs/api/internal/debugViewer.d.ts +13 -13
  37. package/dist/lib-cjs/api/internal/debugViewer.js +86 -86
  38. package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
  39. package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
  40. package/dist/lib-cjs/api/internal/sceneSetup.d.ts +13 -10
  41. package/dist/lib-cjs/api/internal/sceneSetup.js +238 -234
  42. package/dist/lib-cjs/api/internal/sceneSetup.js.map +1 -1
  43. package/dist/lib-cjs/api/manager/animationManager.d.ts +29 -29
  44. package/dist/lib-cjs/api/manager/animationManager.js +130 -130
  45. package/dist/lib-cjs/api/manager/gltfExportManager.d.ts +65 -65
  46. package/dist/lib-cjs/api/manager/gltfExportManager.js +223 -222
  47. package/dist/lib-cjs/api/manager/gltfExportManager.js.map +1 -1
  48. package/dist/lib-cjs/api/manager/sceneManager.d.ts +31 -32
  49. package/dist/lib-cjs/api/manager/sceneManager.js +153 -132
  50. package/dist/lib-cjs/api/manager/sceneManager.js.map +1 -1
  51. package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +92 -92
  52. package/dist/lib-cjs/api/manager/variantInstanceManager.js +335 -335
  53. package/dist/lib-cjs/api/store/specStorage.d.ts +24 -24
  54. package/dist/lib-cjs/api/store/specStorage.js +51 -51
  55. package/dist/lib-cjs/api/util/babylonHelper.d.ts +174 -166
  56. package/dist/lib-cjs/api/util/babylonHelper.js +575 -497
  57. package/dist/lib-cjs/api/util/babylonHelper.js.map +1 -1
  58. package/dist/lib-cjs/api/util/globalTypes.d.ts +366 -356
  59. package/dist/lib-cjs/api/util/globalTypes.js +1 -1
  60. package/dist/lib-cjs/api/util/resourceHelper.d.ts +58 -53
  61. package/dist/lib-cjs/api/util/resourceHelper.js +257 -242
  62. package/dist/lib-cjs/api/util/resourceHelper.js.map +1 -1
  63. package/dist/lib-cjs/api/util/stringHelper.d.ts +9 -9
  64. package/dist/lib-cjs/api/util/stringHelper.js +25 -25
  65. package/dist/lib-cjs/api/util/structureHelper.d.ts +9 -9
  66. package/dist/lib-cjs/api/util/structureHelper.js +48 -44
  67. package/dist/lib-cjs/api/util/structureHelper.js.map +1 -1
  68. package/dist/lib-cjs/buildinfo.json +3 -3
  69. package/dist/lib-cjs/index.d.ts +49 -49
  70. package/dist/lib-cjs/index.js +89 -89
  71. package/dist/webpack-stats.json +0 -0
  72. package/package.json +87 -87
  73. package/src/api/classes/animationInterface.ts +10 -10
  74. package/src/api/classes/dottedPath.ts +181 -181
  75. package/src/api/classes/element.ts +690 -692
  76. package/src/api/classes/event.ts +367 -367
  77. package/src/api/classes/eventBroadcaster.ts +52 -52
  78. package/src/api/classes/parameter.ts +474 -405
  79. package/src/api/classes/parameterObservable.ts +100 -100
  80. package/src/api/classes/parameterizable.ts +87 -87
  81. package/src/api/classes/placementAnimation.ts +160 -160
  82. package/src/api/classes/variant.ts +845 -845
  83. package/src/api/classes/variantInstance.ts +97 -97
  84. package/src/api/classes/variantParameterizable.ts +85 -85
  85. package/src/api/classes/viewer.ts +650 -624
  86. package/src/api/classes/viewerLight.ts +334 -334
  87. package/src/api/internal/debugViewer.ts +90 -90
  88. package/src/api/internal/lensRendering.ts +10 -10
  89. package/src/api/internal/sceneSetup.ts +204 -201
  90. package/src/api/manager/animationManager.ts +142 -142
  91. package/src/api/manager/gltfExportManager.ts +191 -191
  92. package/src/api/manager/sceneManager.ts +128 -102
  93. package/src/api/manager/variantInstanceManager.ts +265 -265
  94. package/src/api/store/specStorage.ts +51 -51
  95. package/src/api/util/babylonHelper.ts +628 -538
  96. package/src/api/util/globalTypes.ts +413 -402
  97. package/src/api/util/resourceHelper.ts +189 -173
  98. package/src/api/util/stringHelper.ts +23 -23
  99. package/src/api/util/structureHelper.ts +49 -43
  100. package/src/buildinfo.json +3 -3
  101. package/src/commonjs.tsconfig.json +10 -10
  102. package/src/declaration.tsconfig.json +8 -8
  103. package/src/dev.ts +42 -42
  104. package/src/es6.tsconfig.json +10 -10
  105. package/src/index.ts +94 -94
  106. package/src/pagesconfig.json +77 -73
  107. package/src/tsconfig.json +32 -32
  108. package/src/tsconfig.types.json +9 -9
  109. package/src/types.d.ts +3 -3
@@ -1,100 +1,100 @@
1
- import { merge } from 'lodash-es';
2
- import { uuidv4 } from '../util/stringHelper';
3
- import { EventBroadcaster } from './eventBroadcaster';
4
-
5
- export abstract class ParameterObservable extends EventBroadcaster {
6
- public readonly uuid: string;
7
-
8
- public readonly parameters: ParameterBag = {};
9
-
10
- protected readonly parameterDeclaration: ParameterDeclarations = {};
11
-
12
- protected parameterObservers: Map<string, ParameterObserver[]> = new Map();
13
-
14
- protected constructor(parameterDeclaration: ParameterDeclarations = {}, parameters: ParameterBag = {}) {
15
- super();
16
- this.uuid = uuidv4();
17
- this.parameterDeclaration = merge(this.parameterDeclaration, parameterDeclaration);
18
- this.parameters = merge(this.parameters, parameters);
19
- }
20
-
21
- /**
22
- * The uuid (if not overloaded).
23
- */
24
- get id(): string {
25
- return this.uuid;
26
- }
27
-
28
- /**
29
- * Adds an observer function for parameter changes.
30
- * The {@link ParameterObserver} gets 3 parameters: the {@link ParameterObservable}, the old {@link ParameterValue}
31
- * and the new {@link ParameterValue}.
32
- *
33
- * See {@page Parameters} for an example.
34
- */
35
- public addParameterObserver(parameter: string, observer: ParameterObserver): ParameterObservable {
36
- if (this.parameterObservers.has(parameter)) {
37
- this.parameterObservers.get(parameter)!.push(observer);
38
- return this;
39
- }
40
- this.parameterObservers.set(parameter, [observer]);
41
- return this;
42
- }
43
-
44
- /**
45
- * Removes all {@link ParameterObserver}s for given parameter.
46
- */
47
- public removeParameterObservers(parameter: string): ParameterObservable {
48
- this.parameterObservers.delete(parameter);
49
- return this;
50
- }
51
-
52
- /**
53
- * Invoke parameter observers for given parameter.
54
- */
55
- public async commitParameter(parameter: string, value: ParameterValue): Promise<ParameterObservable> {
56
- const parameters: ParameterBag = {};
57
- parameters[parameter] = value;
58
- return this.commitParameters(parameters);
59
- }
60
-
61
- /**
62
- * Invoke parameter observers for given parameters.
63
- */
64
- public abstract commitParameters(parameters?: ParameterBag): Promise<ParameterObservable>;
65
-
66
- /**
67
- * Asserts whether given parameter is declared and valid.
68
- */
69
- public assertParameter(parameterDeclaration: ParameterDeclarations, parameter: string, value: ParameterValue) {
70
- if (!(parameter in parameterDeclaration)) {
71
- // This is a valid case since we are not able to check parameters that are not declared.
72
- // We just ignore parameters that are not declared.
73
- return;
74
- }
75
- const declaration = parameterDeclaration[parameter];
76
- const genericError =
77
- `"${value}" is not a valid value for parameter "${parameter}" of type. ` +
78
- `"${declaration.type}" for ${this.constructor.name} "${this.id}".`;
79
- if (declaration.parser) {
80
- try {
81
- declaration.parser(value);
82
- } catch (e) {
83
- throw Error(genericError + e.message);
84
- }
85
- }
86
- switch (declaration.type) {
87
- case 'select':
88
- if (!declaration.options) {
89
- throw Error(
90
- `No options defined for parameter declaration "${parameter}"` +
91
- `of type "${declaration.type}" for ${this.constructor.name} "${this.id}".`
92
- );
93
- }
94
- if (declaration.options.indexOf(value) === -1) {
95
- throw Error(genericError + ` Valid values are: "${declaration.options.join('", "')}".`);
96
- }
97
- break;
98
- }
99
- }
100
- }
1
+ import { merge } from 'lodash-es';
2
+ import { uuidv4 } from '../util/stringHelper';
3
+ import { EventBroadcaster } from './eventBroadcaster';
4
+
5
+ export abstract class ParameterObservable extends EventBroadcaster {
6
+ public readonly uuid: string;
7
+
8
+ public readonly parameters: ParameterBag = {};
9
+
10
+ protected readonly parameterDeclaration: ParameterDeclarations = {};
11
+
12
+ protected parameterObservers: Map<string, ParameterObserver[]> = new Map();
13
+
14
+ protected constructor(parameterDeclaration: ParameterDeclarations = {}, parameters: ParameterBag = {}) {
15
+ super();
16
+ this.uuid = uuidv4();
17
+ this.parameterDeclaration = merge(this.parameterDeclaration, parameterDeclaration);
18
+ this.parameters = merge(this.parameters, parameters);
19
+ }
20
+
21
+ /**
22
+ * The uuid (if not overloaded).
23
+ */
24
+ get id(): string {
25
+ return this.uuid;
26
+ }
27
+
28
+ /**
29
+ * Adds an observer function for parameter changes.
30
+ * The {@link ParameterObserver} gets 3 parameters: the {@link ParameterObservable}, the old {@link ParameterValue}
31
+ * and the new {@link ParameterValue}.
32
+ *
33
+ * See {@page Parameters} for an example.
34
+ */
35
+ public addParameterObserver(parameter: string, observer: ParameterObserver): ParameterObservable {
36
+ if (this.parameterObservers.has(parameter)) {
37
+ this.parameterObservers.get(parameter)!.push(observer);
38
+ return this;
39
+ }
40
+ this.parameterObservers.set(parameter, [observer]);
41
+ return this;
42
+ }
43
+
44
+ /**
45
+ * Removes all {@link ParameterObserver}s for given parameter.
46
+ */
47
+ public removeParameterObservers(parameter: string): ParameterObservable {
48
+ this.parameterObservers.delete(parameter);
49
+ return this;
50
+ }
51
+
52
+ /**
53
+ * Invoke parameter observers for given parameter.
54
+ */
55
+ public async commitParameter(parameter: string, value: ParameterValue): Promise<ParameterObservable> {
56
+ const parameters: ParameterBag = {};
57
+ parameters[parameter] = value;
58
+ return this.commitParameters(parameters);
59
+ }
60
+
61
+ /**
62
+ * Invoke parameter observers for given parameters.
63
+ */
64
+ public abstract commitParameters(parameters?: ParameterBag): Promise<ParameterObservable>;
65
+
66
+ /**
67
+ * Asserts whether given parameter is declared and valid.
68
+ */
69
+ public assertParameter(parameterDeclaration: ParameterDeclarations, parameter: string, value: ParameterValue) {
70
+ if (!(parameter in parameterDeclaration)) {
71
+ // This is a valid case since we are not able to check parameters that are not declared.
72
+ // We just ignore parameters that are not declared.
73
+ return;
74
+ }
75
+ const declaration = parameterDeclaration[parameter];
76
+ const genericError =
77
+ `"${value}" is not a valid value for parameter "${parameter}" of type. ` +
78
+ `"${declaration.type}" for ${this.constructor.name} "${this.id}".`;
79
+ if (declaration.parser) {
80
+ try {
81
+ declaration.parser(value);
82
+ } catch (e) {
83
+ throw Error(genericError + e.message);
84
+ }
85
+ }
86
+ switch (declaration.type) {
87
+ case 'select':
88
+ if (!declaration.options) {
89
+ throw Error(
90
+ `No options defined for parameter declaration "${parameter}"` +
91
+ `of type "${declaration.type}" for ${this.constructor.name} "${this.id}".`
92
+ );
93
+ }
94
+ if (declaration.options.indexOf(value) === -1) {
95
+ throw Error(genericError + ` Valid values are: "${declaration.options.join('", "')}".`);
96
+ }
97
+ break;
98
+ }
99
+ }
100
+ }
@@ -1,87 +1,87 @@
1
- import { Parameter } from './parameter';
2
- import { ParameterObservable } from './parameterObservable';
3
-
4
- export abstract class Parameterizable extends ParameterObservable {
5
- protected parameterDeclaration: ParameterDeclarations = Parameter.declarations;
6
-
7
- get visible(): boolean | undefined {
8
- if (!(Parameter.VISIBLE in this.parameters)) {
9
- return undefined;
10
- }
11
- try {
12
- return Parameter.parseBoolean(this.parameters[Parameter.VISIBLE]);
13
- } catch (e) {
14
- return undefined;
15
- }
16
- }
17
-
18
- get highlighted(): boolean | undefined {
19
- if (!(Parameter.HIGHLIGHTED in this.parameters)) {
20
- return undefined;
21
- }
22
- try {
23
- return Parameter.parseBoolean(this.parameters[Parameter.HIGHLIGHTED]);
24
- } catch (e) {
25
- return undefined;
26
- }
27
- }
28
-
29
- get material(): string | undefined {
30
- if (!(Parameter.MATERIAL in this.parameters)) {
31
- return undefined;
32
- }
33
- return this.parameters[Parameter.MATERIAL].toString();
34
- }
35
-
36
- get scaling(): string | undefined {
37
- if (!(Parameter.SCALING in this.parameters)) {
38
- return undefined;
39
- }
40
- return this.parameters[Parameter.SCALING].toString();
41
- }
42
-
43
- get position(): string | undefined {
44
- if (!(Parameter.POSITION in this.parameters)) {
45
- return undefined;
46
- }
47
- return this.parameters[Parameter.POSITION].toString();
48
- }
49
-
50
- get rotation(): string | undefined {
51
- if (!(Parameter.ROTATION in this.parameters)) {
52
- return undefined;
53
- }
54
- return this.parameters[Parameter.ROTATION].toString();
55
- }
56
-
57
- get castShadow(): boolean | undefined {
58
- if (!(Parameter.CAST_SHADOW in this.parameters)) {
59
- return undefined;
60
- }
61
- try {
62
- return Parameter.parseBoolean(this.parameters[Parameter.CAST_SHADOW]);
63
- } catch (e) {
64
- return undefined;
65
- }
66
- }
67
-
68
- public async show(): Promise<ParameterObservable> {
69
- await this.commitParameter(Parameter.VISIBLE, true);
70
- return this;
71
- }
72
-
73
- public async hide(): Promise<ParameterObservable> {
74
- await this.commitParameter(Parameter.VISIBLE, false);
75
- return this;
76
- }
77
-
78
- public async toggle(): Promise<ParameterObservable> {
79
- await this.commitParameter(Parameter.VISIBLE, !this.visible);
80
- return this;
81
- }
82
-
83
- public async toggleHighlight(): Promise<ParameterObservable> {
84
- await this.commitParameter(Parameter.HIGHLIGHTED, !this.highlighted);
85
- return this;
86
- }
87
- }
1
+ import { Parameter } from './parameter';
2
+ import { ParameterObservable } from './parameterObservable';
3
+
4
+ export abstract class Parameterizable extends ParameterObservable {
5
+ protected parameterDeclaration: ParameterDeclarations = Parameter.declarations;
6
+
7
+ get visible(): boolean | undefined {
8
+ if (!(Parameter.VISIBLE in this.parameters)) {
9
+ return undefined;
10
+ }
11
+ try {
12
+ return Parameter.parseBoolean(this.parameters[Parameter.VISIBLE]);
13
+ } catch (e) {
14
+ return undefined;
15
+ }
16
+ }
17
+
18
+ get highlighted(): boolean | undefined {
19
+ if (!(Parameter.HIGHLIGHTED in this.parameters)) {
20
+ return undefined;
21
+ }
22
+ try {
23
+ return Parameter.parseBoolean(this.parameters[Parameter.HIGHLIGHTED]);
24
+ } catch (e) {
25
+ return undefined;
26
+ }
27
+ }
28
+
29
+ get material(): string | undefined {
30
+ if (!(Parameter.MATERIAL in this.parameters)) {
31
+ return undefined;
32
+ }
33
+ return this.parameters[Parameter.MATERIAL].toString();
34
+ }
35
+
36
+ get scaling(): string | undefined {
37
+ if (!(Parameter.SCALING in this.parameters)) {
38
+ return undefined;
39
+ }
40
+ return this.parameters[Parameter.SCALING].toString();
41
+ }
42
+
43
+ get position(): string | undefined {
44
+ if (!(Parameter.POSITION in this.parameters)) {
45
+ return undefined;
46
+ }
47
+ return this.parameters[Parameter.POSITION].toString();
48
+ }
49
+
50
+ get rotation(): string | undefined {
51
+ if (!(Parameter.ROTATION in this.parameters)) {
52
+ return undefined;
53
+ }
54
+ return this.parameters[Parameter.ROTATION].toString();
55
+ }
56
+
57
+ get castShadow(): boolean | undefined {
58
+ if (!(Parameter.CAST_SHADOW in this.parameters)) {
59
+ return undefined;
60
+ }
61
+ try {
62
+ return Parameter.parseBoolean(this.parameters[Parameter.CAST_SHADOW]);
63
+ } catch (e) {
64
+ return undefined;
65
+ }
66
+ }
67
+
68
+ public async show(): Promise<ParameterObservable> {
69
+ await this.commitParameter(Parameter.VISIBLE, true);
70
+ return this;
71
+ }
72
+
73
+ public async hide(): Promise<ParameterObservable> {
74
+ await this.commitParameter(Parameter.VISIBLE, false);
75
+ return this;
76
+ }
77
+
78
+ public async toggle(): Promise<ParameterObservable> {
79
+ await this.commitParameter(Parameter.VISIBLE, !this.visible);
80
+ return this;
81
+ }
82
+
83
+ public async toggleHighlight(): Promise<ParameterObservable> {
84
+ await this.commitParameter(Parameter.HIGHLIGHTED, !this.highlighted);
85
+ return this;
86
+ }
87
+ }