@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
package/package.json CHANGED
@@ -1,87 +1,87 @@
1
- {
2
- "name": "@combeenation/3d-viewer",
3
- "description": "Combeenation 3D Viewer",
4
- "version": "5.0.1",
5
- "homepage": "https://github.com/Combeenation/3d-viewer#readme",
6
- "keywords": [],
7
- "author": "",
8
- "license": "Apache 2.0",
9
- "contributors": [],
10
- "main": "dist/lib-cjs/index.js",
11
- "module": "dist/lib-cjs/index.js",
12
- "typings": "dist/lib-cjs/index.d.ts",
13
- "directories": {
14
- "doc": "docs"
15
- },
16
- "files": [
17
- "dist",
18
- "src"
19
- ],
20
- "repository": {
21
- "type": "git",
22
- "url": "git+https://github.com/Combeenation/3d-viewer.git"
23
- },
24
- "bugs": {
25
- "url": "https://github.com/Combeenation/3d-viewer/issues"
26
- },
27
- "scripts": {
28
- "dev": "cross-env NODE_ENV='dev' webpack-dev-server --config build/webpack.conf.js --progress --colors --debug --hot",
29
- "dist-full": "cross-env NODE_ENV='production' webpack --config build/webpack.conf.js --progress --colors && npm run replace-version",
30
- "dist-cjs": "tsc --project src/commonjs.tsconfig.json && npm run replace-version",
31
- "dist-es6": "tsc --project src/es6.tsconfig.json && npm run replace-version",
32
- "replace-version": "cross-env replace \"@VERSION@\" $npm_package_version dist -r",
33
- "generate-profile": "cross-env NODE_ENV='dev' webpack --config build/webpack.conf.js --profile --json > dist/webpack-stats.json",
34
- "bundle-analyzer": "npm generate-profile && webpack-bundle-analyzer --host 0.0.0.0 --port 8080 dist/webpack-stats.json",
35
- "docs-publish": "typedoc --tsconfig src/tsconfig.json --media doc/assets --out docs",
36
- "docs-local": "typedoc --tsconfig src/tsconfig.json --media doc/assets --out docs-local",
37
- "types": "tsc --project src/declaration.tsconfig.json",
38
- "pub-final": "npm run dist-cjs && npm publish",
39
- "pub-alpha": "npm run dist-cjs && npm publish --tag alpha",
40
- "pub-beta": "npm run dist-cjs && npm publish --tag beta",
41
- "pub-rc": "npm run dist-cjs && npm publish --tag rc",
42
- "pack": "npm run dist-cjs && npm pack",
43
- "format": "prettier --write ."
44
- },
45
- "dependencies": {
46
- "@babylonjs/core": "^5.6.0",
47
- "@babylonjs/inspector": "5.6.0",
48
- "@babylonjs/loaders": "5.6.0",
49
- "@babylonjs/materials": "5.6.0",
50
- "eventemitter3": "^4.0.0",
51
- "gsap": "^3.5.1",
52
- "lodash-es": "^4.17.15"
53
- },
54
- "devDependencies": {
55
- "@combeenation/prettier-config": "^0.0.1",
56
- "@types/lodash": "^4.14",
57
- "@types/lodash-es": "^4.17",
58
- "bundle-loader": "^0.5.6",
59
- "clean-webpack-plugin": "^3.0.0",
60
- "clipboard-polyfill": "^2.8.6",
61
- "copy-webpack-plugin": "^7.0.0",
62
- "cross-env": "^7.0.2",
63
- "css-loader": "^3.2.0",
64
- "extract-text-webpack-plugin": "^4.0.0-beta.0",
65
- "file-loader": "^4.2.0",
66
- "html-loader": "^0.5.5",
67
- "html-webpack-plugin": "^3.2.0",
68
- "prettier": "^2.5.1",
69
- "replace": "1.2.0",
70
- "source-map-loader": "^0.2.4",
71
- "style-loader": "^1.0.0",
72
- "ts-loader": "^6.2.2",
73
- "tslib": "^1.11.1",
74
- "typedoc": "^0.20",
75
- "typedoc-plugin-merge-modules": "^1.0.0",
76
- "typedoc-plugin-pages": "^1.1.0",
77
- "typescript": "^4.0.5",
78
- "uglifyjs-webpack-plugin": "^2.2.0",
79
- "url-loader": "^2.2.0",
80
- "webpack": "^4.42.1",
81
- "webpack-bundle-analyzer": "^3.6.0",
82
- "webpack-cli": "^3.3.11",
83
- "webpack-dev-server": "^3.11.2",
84
- "webpack-merge": "^4.2.2"
85
- },
86
- "prettier": "@combeenation/prettier-config"
87
- }
1
+ {
2
+ "name": "@combeenation/3d-viewer",
3
+ "description": "Combeenation 3D Viewer",
4
+ "version": "5.0.3-beta2",
5
+ "homepage": "https://github.com/Combeenation/3d-viewer#readme",
6
+ "keywords": [],
7
+ "author": "",
8
+ "license": "Apache 2.0",
9
+ "contributors": [],
10
+ "main": "dist/lib-cjs/index.js",
11
+ "module": "dist/lib-cjs/index.js",
12
+ "typings": "dist/lib-cjs/index.d.ts",
13
+ "directories": {
14
+ "doc": "docs"
15
+ },
16
+ "files": [
17
+ "dist",
18
+ "src"
19
+ ],
20
+ "repository": {
21
+ "type": "git",
22
+ "url": "git+https://github.com/Combeenation/3d-viewer.git"
23
+ },
24
+ "bugs": {
25
+ "url": "https://github.com/Combeenation/3d-viewer/issues"
26
+ },
27
+ "scripts": {
28
+ "dev": "cross-env NODE_ENV='dev' webpack-dev-server --config build/webpack.conf.js --progress --colors --debug --hot",
29
+ "dist-full": "cross-env NODE_ENV='production' webpack --config build/webpack.conf.js --progress --colors && npm run replace-version",
30
+ "dist-cjs": "tsc --project src/commonjs.tsconfig.json && npm run replace-version",
31
+ "dist-es6": "tsc --project src/es6.tsconfig.json && npm run replace-version",
32
+ "replace-version": "cross-env replace \"@VERSION@\" $npm_package_version dist -r",
33
+ "generate-profile": "cross-env NODE_ENV='dev' webpack --config build/webpack.conf.js --profile --json > dist/webpack-stats.json",
34
+ "bundle-analyzer": "npm generate-profile && webpack-bundle-analyzer --host 0.0.0.0 --port 8080 dist/webpack-stats.json",
35
+ "docs-publish": "typedoc --tsconfig src/tsconfig.json --media doc/assets --out docs",
36
+ "docs-local": "typedoc --tsconfig src/tsconfig.json --media doc/assets --out docs-local",
37
+ "types": "tsc --project src/declaration.tsconfig.json",
38
+ "pub-final": "npm run dist-cjs && npm publish",
39
+ "pub-alpha": "npm run dist-cjs && npm publish --tag alpha",
40
+ "pub-beta": "npm run dist-cjs && npm publish --tag beta",
41
+ "pub-rc": "npm run dist-cjs && npm publish --tag rc",
42
+ "pack": "npm run dist-cjs && npm pack",
43
+ "format": "prettier --write ."
44
+ },
45
+ "dependencies": {
46
+ "@babylonjs/core": "5.6.0",
47
+ "@babylonjs/loaders": "5.6.0",
48
+ "@babylonjs/materials": "5.6.0",
49
+ "@babylonjs/serializers": "5.6.0",
50
+ "eventemitter3": "^4.0.0",
51
+ "gsap": "^3.5.1",
52
+ "lodash-es": "^4.17.15"
53
+ },
54
+ "devDependencies": {
55
+ "@combeenation/prettier-config": "^0.0.1",
56
+ "@types/lodash": "^4.14",
57
+ "@types/lodash-es": "^4.17",
58
+ "bundle-loader": "^0.5.6",
59
+ "clean-webpack-plugin": "^3.0.0",
60
+ "clipboard-polyfill": "^2.8.6",
61
+ "copy-webpack-plugin": "^7.0.0",
62
+ "cross-env": "^7.0.2",
63
+ "css-loader": "^3.2.0",
64
+ "extract-text-webpack-plugin": "^4.0.0-beta.0",
65
+ "file-loader": "^4.2.0",
66
+ "html-loader": "^0.5.5",
67
+ "html-webpack-plugin": "^3.2.0",
68
+ "prettier": "^2.5.1",
69
+ "replace": "1.2.0",
70
+ "source-map-loader": "^0.2.4",
71
+ "style-loader": "^1.0.0",
72
+ "ts-loader": "^6.2.2",
73
+ "tslib": "^1.11.1",
74
+ "typedoc": "^0.20",
75
+ "typedoc-plugin-merge-modules": "^1.0.0",
76
+ "typedoc-plugin-pages": "^1.1.0",
77
+ "typescript": "^4.0.5",
78
+ "uglifyjs-webpack-plugin": "^2.2.0",
79
+ "url-loader": "^2.2.0",
80
+ "webpack": "^4.42.1",
81
+ "webpack-bundle-analyzer": "^3.6.0",
82
+ "webpack-cli": "^3.3.11",
83
+ "webpack-dev-server": "^3.11.2",
84
+ "webpack-merge": "^4.2.2"
85
+ },
86
+ "prettier": "@combeenation/prettier-config"
87
+ }
@@ -1,10 +1,10 @@
1
- /**
2
- * An Interface defining the basic functionality of an animation.
3
- */
4
- interface AnimationInterface {
5
- play(): Promise<AnimationInterface>;
6
-
7
- pause(): AnimationInterface;
8
-
9
- kill(): AnimationInterface;
10
- }
1
+ /**
2
+ * An Interface defining the basic functionality of an animation.
3
+ */
4
+ interface AnimationInterface {
5
+ play(): Promise<AnimationInterface>;
6
+
7
+ pause(): AnimationInterface;
8
+
9
+ kill(): AnimationInterface;
10
+ }
@@ -1,181 +1,181 @@
1
- export class DottedPath {
2
- static DELIMITER: string = '.';
3
-
4
- static SAFE_CHAR: string = '·';
5
-
6
- public parts: string[] = [];
7
-
8
- /**
9
- * Magic factory function that creates a DottedPath based on the argument type.
10
- */
11
- public static create(dottedPath?: DottedPathArgument): DottedPath {
12
- if (dottedPath?.constructor === DottedPath) {
13
- return (dottedPath as DottedPath).clone();
14
- }
15
- if (dottedPath?.constructor === String) {
16
- return DottedPath.createFromPath(dottedPath as string);
17
- }
18
- if (dottedPath?.constructor === Array) {
19
- return DottedPath.createFromParts(dottedPath as string[]);
20
- }
21
- return DottedPath.createEmpty();
22
- }
23
-
24
- /**
25
- * Creates a DottedPath from a string.
26
- * Allows patterns with unsafe characters wrapped in apostrophes or quotes.
27
- * E.g. "part1.part2.'part.3'.part_4"
28
- */
29
- public static createFromPath(path: string): DottedPath {
30
- if (path.length === 0) {
31
- return this.createEmpty();
32
- }
33
- if (path.indexOf("'") > -1 || path.indexOf('"') > -1) {
34
- const bd = '[\'|"]';
35
- const search = new RegExp(`${bd}(.*)${bd}`, 'g');
36
- let matches = search.exec(path);
37
- while (matches !== null) {
38
- const _search = new RegExp(`${bd}${matches[1]}${bd}`, 'g');
39
- path = path.replace(_search, this.sanitizePart(matches[1]));
40
- matches = search.exec(path);
41
- }
42
- }
43
- return this.createFromParts(path.split(DottedPath.DELIMITER));
44
- }
45
-
46
- /**
47
- * Creates a DottedPath from a string list.
48
- */
49
- public static createFromParts(parts: string[]): DottedPath {
50
- const dottedPath = new DottedPath();
51
- parts.forEach(part => dottedPath.addPart(part));
52
- return dottedPath;
53
- }
54
-
55
- /**
56
- * Creates an empty DottedPath.
57
- */
58
- public static createEmpty(): DottedPath {
59
- return new DottedPath();
60
- }
61
-
62
- /**
63
- * Sanitizes given part: replaces all characters like {@link DottedPath.DELIMITER}
64
- * with a "safe" character like {@link DottedPath.SAFE_CHAR}.
65
- * (i) Does not trim whitespace.
66
- */
67
- public static sanitizePart(part: string): string {
68
- return part.split(DottedPath.DELIMITER).join(DottedPath.SAFE_CHAR);
69
- }
70
-
71
- /**
72
- * Constructor
73
- */
74
- private constructor() {}
75
-
76
- /**
77
- * The path.
78
- * (i) Does not return an empty dot for no path.
79
- */
80
- get path(): string {
81
- return this.parts.length > 0 ? this.parts.join(DottedPath.DELIMITER) : '';
82
- }
83
-
84
- /**
85
- * The first part.
86
- */
87
- get firstPart(): string | null {
88
- if (this.parts.length > 0) {
89
- return this.parts[0];
90
- }
91
- return null;
92
- }
93
-
94
- /**
95
- * The last part.
96
- */
97
- get lastPart(): string | null {
98
- if (this.parts.length > 0) {
99
- return this.parts[this.parts.length - 1];
100
- }
101
- return null;
102
- }
103
-
104
- /**
105
- * Gets the tokens to each leaf of the DottedPath tree.
106
- * E.g. "part1.part2.part_3" will return an array like
107
- * ["part1", "part1.part2", "part1.part2.part_3"]
108
- */
109
- get leafTokens(): string[] {
110
- let parents: string[] = [];
111
- return this.parts.map(part => {
112
- parents.push(part);
113
- return DottedPath.create(parents).path;
114
- });
115
- }
116
-
117
- /**
118
- * Removes the first part and returns it.
119
- */
120
- public shiftPart(): string | undefined {
121
- return this.parts.shift();
122
- }
123
-
124
- /**
125
- * Adds part to the beginning of parts list.
126
- */
127
- public unshiftPart(part: string, duplicateCheck: boolean = false): DottedPath {
128
- part = DottedPath.sanitizePart(part);
129
- if (duplicateCheck && this.firstPart === part) {
130
- return this;
131
- }
132
- this.parts.unshift(part);
133
- return this;
134
- }
135
-
136
- /**
137
- * Adds part to the end of parts list.
138
- * (i) Does not add a part if the last char already is the delimiter or if an empty string was passed.
139
- */
140
- public addPart(part: string, duplicateCheck: boolean = false): DottedPath {
141
- if (part.length < 1 || this.lastPart === DottedPath.DELIMITER) {
142
- return this;
143
- }
144
- part = DottedPath.sanitizePart(part);
145
- if (duplicateCheck && this.lastPart === part) {
146
- return this;
147
- }
148
- this.parts.push(part);
149
- return this;
150
- }
151
-
152
- /**
153
- * Adds multiple parts to the end of parts list.
154
- */
155
- public addParts(parts: string[], duplicateCheck: boolean = false): DottedPath {
156
- parts.forEach(part => this.addPart(part, duplicateCheck));
157
- return this;
158
- }
159
-
160
- /**
161
- * Removes the last part and returns it.
162
- */
163
- public popPart(): string | undefined {
164
- return this.parts.pop();
165
- }
166
-
167
- public toString(): string {
168
- return this.path;
169
- }
170
-
171
- public valueOf(): string {
172
- return this.path;
173
- }
174
-
175
- /**
176
- * Clones the DottedPath.
177
- */
178
- public clone(): DottedPath {
179
- return DottedPath.createFromParts(this.parts);
180
- }
181
- }
1
+ export class DottedPath {
2
+ static DELIMITER: string = '.';
3
+
4
+ static SAFE_CHAR: string = '·';
5
+
6
+ public parts: string[] = [];
7
+
8
+ /**
9
+ * Magic factory function that creates a DottedPath based on the argument type.
10
+ */
11
+ public static create(dottedPath?: DottedPathArgument): DottedPath {
12
+ if (dottedPath?.constructor === DottedPath) {
13
+ return (dottedPath as DottedPath).clone();
14
+ }
15
+ if (dottedPath?.constructor === String) {
16
+ return DottedPath.createFromPath(dottedPath as string);
17
+ }
18
+ if (dottedPath?.constructor === Array) {
19
+ return DottedPath.createFromParts(dottedPath as string[]);
20
+ }
21
+ return DottedPath.createEmpty();
22
+ }
23
+
24
+ /**
25
+ * Creates a DottedPath from a string.
26
+ * Allows patterns with unsafe characters wrapped in apostrophes or quotes.
27
+ * E.g. "part1.part2.'part.3'.part_4"
28
+ */
29
+ public static createFromPath(path: string): DottedPath {
30
+ if (path.length === 0) {
31
+ return this.createEmpty();
32
+ }
33
+ if (path.indexOf("'") > -1 || path.indexOf('"') > -1) {
34
+ const bd = '[\'|"]';
35
+ const search = new RegExp(`${bd}(.*)${bd}`, 'g');
36
+ let matches = search.exec(path);
37
+ while (matches !== null) {
38
+ const _search = new RegExp(`${bd}${matches[1]}${bd}`, 'g');
39
+ path = path.replace(_search, this.sanitizePart(matches[1]));
40
+ matches = search.exec(path);
41
+ }
42
+ }
43
+ return this.createFromParts(path.split(DottedPath.DELIMITER));
44
+ }
45
+
46
+ /**
47
+ * Creates a DottedPath from a string list.
48
+ */
49
+ public static createFromParts(parts: string[]): DottedPath {
50
+ const dottedPath = new DottedPath();
51
+ parts.forEach(part => dottedPath.addPart(part));
52
+ return dottedPath;
53
+ }
54
+
55
+ /**
56
+ * Creates an empty DottedPath.
57
+ */
58
+ public static createEmpty(): DottedPath {
59
+ return new DottedPath();
60
+ }
61
+
62
+ /**
63
+ * Sanitizes given part: replaces all characters like {@link DottedPath.DELIMITER}
64
+ * with a "safe" character like {@link DottedPath.SAFE_CHAR}.
65
+ * (i) Does not trim whitespace.
66
+ */
67
+ public static sanitizePart(part: string): string {
68
+ return part.split(DottedPath.DELIMITER).join(DottedPath.SAFE_CHAR);
69
+ }
70
+
71
+ /**
72
+ * Constructor
73
+ */
74
+ private constructor() {}
75
+
76
+ /**
77
+ * The path.
78
+ * (i) Does not return an empty dot for no path.
79
+ */
80
+ get path(): string {
81
+ return this.parts.length > 0 ? this.parts.join(DottedPath.DELIMITER) : '';
82
+ }
83
+
84
+ /**
85
+ * The first part.
86
+ */
87
+ get firstPart(): string | null {
88
+ if (this.parts.length > 0) {
89
+ return this.parts[0];
90
+ }
91
+ return null;
92
+ }
93
+
94
+ /**
95
+ * The last part.
96
+ */
97
+ get lastPart(): string | null {
98
+ if (this.parts.length > 0) {
99
+ return this.parts[this.parts.length - 1];
100
+ }
101
+ return null;
102
+ }
103
+
104
+ /**
105
+ * Gets the tokens to each leaf of the DottedPath tree.
106
+ * E.g. "part1.part2.part_3" will return an array like
107
+ * ["part1", "part1.part2", "part1.part2.part_3"]
108
+ */
109
+ get leafTokens(): string[] {
110
+ let parents: string[] = [];
111
+ return this.parts.map(part => {
112
+ parents.push(part);
113
+ return DottedPath.create(parents).path;
114
+ });
115
+ }
116
+
117
+ /**
118
+ * Removes the first part and returns it.
119
+ */
120
+ public shiftPart(): string | undefined {
121
+ return this.parts.shift();
122
+ }
123
+
124
+ /**
125
+ * Adds part to the beginning of parts list.
126
+ */
127
+ public unshiftPart(part: string, duplicateCheck: boolean = false): DottedPath {
128
+ part = DottedPath.sanitizePart(part);
129
+ if (duplicateCheck && this.firstPart === part) {
130
+ return this;
131
+ }
132
+ this.parts.unshift(part);
133
+ return this;
134
+ }
135
+
136
+ /**
137
+ * Adds part to the end of parts list.
138
+ * (i) Does not add a part if the last char already is the delimiter or if an empty string was passed.
139
+ */
140
+ public addPart(part: string, duplicateCheck: boolean = false): DottedPath {
141
+ if (part.length < 1 || this.lastPart === DottedPath.DELIMITER) {
142
+ return this;
143
+ }
144
+ part = DottedPath.sanitizePart(part);
145
+ if (duplicateCheck && this.lastPart === part) {
146
+ return this;
147
+ }
148
+ this.parts.push(part);
149
+ return this;
150
+ }
151
+
152
+ /**
153
+ * Adds multiple parts to the end of parts list.
154
+ */
155
+ public addParts(parts: string[], duplicateCheck: boolean = false): DottedPath {
156
+ parts.forEach(part => this.addPart(part, duplicateCheck));
157
+ return this;
158
+ }
159
+
160
+ /**
161
+ * Removes the last part and returns it.
162
+ */
163
+ public popPart(): string | undefined {
164
+ return this.parts.pop();
165
+ }
166
+
167
+ public toString(): string {
168
+ return this.path;
169
+ }
170
+
171
+ public valueOf(): string {
172
+ return this.path;
173
+ }
174
+
175
+ /**
176
+ * Clones the DottedPath.
177
+ */
178
+ public clone(): DottedPath {
179
+ return DottedPath.createFromParts(this.parts);
180
+ }
181
+ }