@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

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 (104) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +23 -23
  3. package/README.md +69 -69
  4. package/THIRD-PARTY-NOTICES.md +64 -64
  5. package/docs/README.md +74 -73
  6. package/docs/architecture.md +101 -101
  7. package/docs/concepts/foundation-consolidation.md +85 -85
  8. package/docs/concepts/model-lifecycle.md +111 -0
  9. package/docs/const-kb.md +85 -87
  10. package/docs/core-types/DECORATOR-TODOS.md +25 -25
  11. package/docs/core-types/README.md +229 -168
  12. package/docs/reference/api.md +105 -102
  13. package/docs/reference/classes/README.md +135 -135
  14. package/package.json +139 -139
  15. package/src/arrays.js +5 -5
  16. package/src/audio/audioFormats.js +34 -34
  17. package/src/audio/index.js +1 -1
  18. package/src/box3.js +331 -331
  19. package/src/bytes.js +56 -56
  20. package/src/compression.js +56 -56
  21. package/src/constants/index.js +7 -7
  22. package/src/constants/trinity.js +13 -13
  23. package/src/constants.js +15 -15
  24. package/src/curve.js +79 -79
  25. package/src/d3d/dxgiFormats.js +46 -46
  26. package/src/d3d/index.js +2 -2
  27. package/src/d3d/primitiveTopology.js +11 -11
  28. package/src/document/CjsCarbonDocument.js +212 -212
  29. package/src/document/CjsClassRegistry.js +373 -373
  30. package/src/document/CjsDocumentDehydrator.js +142 -142
  31. package/src/document/CjsDocumentHydrator.js +156 -156
  32. package/src/document/CjsStructRegistry.js +348 -348
  33. package/src/document/hydrationAdapter.js +129 -129
  34. package/src/document/index.js +6 -6
  35. package/src/errors/CjsError.js +286 -286
  36. package/src/errors/index.js +5 -5
  37. package/src/geometry/box.js +22 -22
  38. package/src/geometry/cylinder.js +22 -22
  39. package/src/geometry/helpers/earcut.js +1 -1
  40. package/src/geometry/helpers/misc.js +3 -3
  41. package/src/geometry/index.js +8 -8
  42. package/src/geometry/json.js +67 -67
  43. package/src/geometry/lathe.js +44 -44
  44. package/src/geometry/plane.js +14 -14
  45. package/src/geometry/shape.js +4 -4
  46. package/src/geometry/sphere.js +24 -24
  47. package/src/geometry/torus.js +14 -14
  48. package/src/graphics/colorSpaces.js +22 -22
  49. package/src/graphics/index.js +4 -4
  50. package/src/graphics/pixelFormats.js +158 -158
  51. package/src/graphics/textureDimensions.js +22 -22
  52. package/src/graphics/trinityEnums.js +87 -87
  53. package/src/index.js +62 -62
  54. package/src/is.js +108 -46
  55. package/src/json.js +23 -23
  56. package/src/lifecycle/CjsLifecycleState.js +77 -77
  57. package/src/lifecycle/index.js +1 -1
  58. package/src/lne3.js +70 -70
  59. package/src/lookup.js +48 -48
  60. package/src/mat3.js +51 -51
  61. package/src/mat4.js +699 -699
  62. package/src/math/index.js +25 -25
  63. package/src/math/scalar.js +63 -63
  64. package/src/media/index.js +1 -1
  65. package/src/media/mediaTypes.js +50 -50
  66. package/src/mesh.js +424 -424
  67. package/src/model/CjsEventEmitter.js +333 -333
  68. package/src/model/CjsModel.js +1589 -1544
  69. package/src/model/CjsModelState.js +72 -72
  70. package/src/model/index.js +4 -4
  71. package/src/model/sourceRecordUtils.js +54 -54
  72. package/src/noise.js +310 -310
  73. package/src/num.js +827 -827
  74. package/src/object.js +39 -39
  75. package/src/path.js +53 -53
  76. package/src/pln.js +125 -125
  77. package/src/pool.js +9 -9
  78. package/src/quat.js +144 -144
  79. package/src/ray3.js +188 -188
  80. package/src/renderContext/formats.js +145 -145
  81. package/src/renderContext/index.js +5 -5
  82. package/src/renderContext/presentation.js +125 -125
  83. package/src/renderContext/resources.js +27 -27
  84. package/src/renderContext/upscaling.js +22 -22
  85. package/src/renderContext/window.js +20 -20
  86. package/src/runtime/CjsRuntimeState.js +50 -50
  87. package/src/schema/CjsSchema.js +555 -318
  88. package/src/schema/index.js +4 -4
  89. package/src/shader/index.js +1 -1
  90. package/src/shader/shaderStages.js +37 -37
  91. package/src/sph3.js +181 -181
  92. package/src/tangent.js +288 -288
  93. package/src/text.js +40 -40
  94. package/src/tri3.js +98 -98
  95. package/src/types/carbonTypes.js +635 -635
  96. package/src/types/index.js +2 -2
  97. package/src/utils.js +58 -58
  98. package/src/validation.js +46 -46
  99. package/src/vec2.js +229 -229
  100. package/src/vec3.js +1188 -1172
  101. package/src/vec4.js +347 -347
  102. package/src/vertex.js +108 -108
  103. package/src/webgpu/index.js +1 -1
  104. package/src/webgpu/textureFormats.js +121 -121
package/src/quat.js CHANGED
@@ -1,144 +1,144 @@
1
- import * as glQuat from "gl-matrix/esm/quat.js";
2
- import { EPSILON } from "./num.js";
3
- import { pool } from "./pool.js";
4
-
5
- const quat = { ...glQuat };
6
-
7
- export { quat };
8
-
9
- /**
10
- * Allocates a pooled vec4
11
- * @returns {Float32Array|quat}
12
- */
13
- quat.alloc = function()
14
- {
15
- return pool.allocF32(4);
16
- };
17
-
18
- /**
19
- * Unallocates a pooled vec4
20
- * @param {Float32Array|quat} a
21
- */
22
- quat.unalloc = function(a)
23
- {
24
- pool.freeType(a);
25
- };
26
-
27
- /**
28
- * Creates a quat from unit vectors
29
- *
30
- * @param {quat} out
31
- * @param {vec3} from
32
- * @param {vec3} to
33
- * @returns {quat}
34
- */
35
- quat.fromUnitVectors = function(out, from, to)
36
- {
37
- const
38
- fromX = from[0],
39
- fromY = from[1],
40
- fromZ = from[2],
41
- toX = to[0],
42
- toY = to[1],
43
- toZ = to[2];
44
-
45
- let r = fromX * toX + fromY * toY + fromZ * toZ + 1;
46
- if (r < EPSILON)
47
- {
48
- r = 0;
49
- if (Math.abs(fromX) > Math.abs(fromZ))
50
- {
51
- out[0] = -fromY;
52
- out[1] = fromX;
53
- out[2] = 0;
54
- out[3] = r;
55
- }
56
- else
57
- {
58
- out[0] = 0;
59
- out[1] = -fromZ;
60
- out[2] = fromY;
61
- out[3] = r;
62
- }
63
- }
64
- else
65
- {
66
- out[0] = fromY * toZ - fromZ * toY;
67
- out[1] = fromZ * toX - fromX * toZ;
68
- out[2] = fromX * toY - fromY * toX;
69
- out[3] = r;
70
- }
71
- return quat.normalize(out, out);
72
- };
73
-
74
- /**
75
- * Creates a Carbon yaw/pitch/roll quaternion.
76
- *
77
- * @param {quat} out
78
- * @param {number} yaw
79
- * @param {number} pitch
80
- * @param {number} roll
81
- * @returns {quat}
82
- */
83
- quat.fromYawPitchRoll = function(out, yaw, pitch, roll)
84
- {
85
- const
86
- sinYaw = Math.sin(yaw / 2),
87
- cosYaw = Math.cos(yaw / 2),
88
- sinPitch = Math.sin(pitch / 2),
89
- cosPitch = Math.cos(pitch / 2),
90
- sinRoll = Math.sin(roll / 2),
91
- cosRoll = Math.cos(roll / 2);
92
-
93
- out[0] = sinYaw * cosPitch * sinRoll + cosYaw * sinPitch * cosRoll;
94
- out[1] = sinYaw * cosPitch * cosRoll - cosYaw * sinPitch * sinRoll;
95
- out[2] = cosYaw * cosPitch * sinRoll - sinYaw * sinPitch * cosRoll;
96
- out[3] = cosYaw * cosPitch * cosRoll + sinYaw * sinPitch * sinRoll;
97
- return out;
98
- };
99
-
100
- export const {
101
- add,
102
- calculateW,
103
- clone,
104
- conjugate,
105
- copy,
106
- create,
107
- dot,
108
- equals,
109
- exactEquals,
110
- exp,
111
- fromEuler,
112
- fromMat3,
113
- fromValues,
114
- getAngle,
115
- getAxisAngle,
116
- identity,
117
- invert,
118
- len,
119
- length,
120
- lerp,
121
- ln,
122
- mul,
123
- multiply,
124
- normalize,
125
- pow,
126
- random,
127
- rotateX,
128
- rotateY,
129
- rotateZ,
130
- rotationTo,
131
- scale,
132
- set,
133
- setAxes,
134
- setAxisAngle,
135
- slerp,
136
- sqlerp,
137
- sqrLen,
138
- squaredLength,
139
- str,
140
- alloc,
141
- unalloc,
142
- fromUnitVectors,
143
- fromYawPitchRoll
144
- } = quat;
1
+ import * as glQuat from "gl-matrix/esm/quat.js";
2
+ import { EPSILON } from "./num.js";
3
+ import { pool } from "./pool.js";
4
+
5
+ const quat = { ...glQuat };
6
+
7
+ export { quat };
8
+
9
+ /**
10
+ * Allocates a pooled vec4
11
+ * @returns {Float32Array|quat}
12
+ */
13
+ quat.alloc = function()
14
+ {
15
+ return pool.allocF32(4);
16
+ };
17
+
18
+ /**
19
+ * Unallocates a pooled vec4
20
+ * @param {Float32Array|quat} a
21
+ */
22
+ quat.unalloc = function(a)
23
+ {
24
+ pool.freeType(a);
25
+ };
26
+
27
+ /**
28
+ * Creates a quat from unit vectors
29
+ *
30
+ * @param {quat} out
31
+ * @param {vec3} from
32
+ * @param {vec3} to
33
+ * @returns {quat}
34
+ */
35
+ quat.fromUnitVectors = function(out, from, to)
36
+ {
37
+ const
38
+ fromX = from[0],
39
+ fromY = from[1],
40
+ fromZ = from[2],
41
+ toX = to[0],
42
+ toY = to[1],
43
+ toZ = to[2];
44
+
45
+ let r = fromX * toX + fromY * toY + fromZ * toZ + 1;
46
+ if (r < EPSILON)
47
+ {
48
+ r = 0;
49
+ if (Math.abs(fromX) > Math.abs(fromZ))
50
+ {
51
+ out[0] = -fromY;
52
+ out[1] = fromX;
53
+ out[2] = 0;
54
+ out[3] = r;
55
+ }
56
+ else
57
+ {
58
+ out[0] = 0;
59
+ out[1] = -fromZ;
60
+ out[2] = fromY;
61
+ out[3] = r;
62
+ }
63
+ }
64
+ else
65
+ {
66
+ out[0] = fromY * toZ - fromZ * toY;
67
+ out[1] = fromZ * toX - fromX * toZ;
68
+ out[2] = fromX * toY - fromY * toX;
69
+ out[3] = r;
70
+ }
71
+ return quat.normalize(out, out);
72
+ };
73
+
74
+ /**
75
+ * Creates a Carbon yaw/pitch/roll quaternion.
76
+ *
77
+ * @param {quat} out
78
+ * @param {number} yaw
79
+ * @param {number} pitch
80
+ * @param {number} roll
81
+ * @returns {quat}
82
+ */
83
+ quat.fromYawPitchRoll = function(out, yaw, pitch, roll)
84
+ {
85
+ const
86
+ sinYaw = Math.sin(yaw / 2),
87
+ cosYaw = Math.cos(yaw / 2),
88
+ sinPitch = Math.sin(pitch / 2),
89
+ cosPitch = Math.cos(pitch / 2),
90
+ sinRoll = Math.sin(roll / 2),
91
+ cosRoll = Math.cos(roll / 2);
92
+
93
+ out[0] = sinYaw * cosPitch * sinRoll + cosYaw * sinPitch * cosRoll;
94
+ out[1] = sinYaw * cosPitch * cosRoll - cosYaw * sinPitch * sinRoll;
95
+ out[2] = cosYaw * cosPitch * sinRoll - sinYaw * sinPitch * cosRoll;
96
+ out[3] = cosYaw * cosPitch * cosRoll + sinYaw * sinPitch * sinRoll;
97
+ return out;
98
+ };
99
+
100
+ export const {
101
+ add,
102
+ calculateW,
103
+ clone,
104
+ conjugate,
105
+ copy,
106
+ create,
107
+ dot,
108
+ equals,
109
+ exactEquals,
110
+ exp,
111
+ fromEuler,
112
+ fromMat3,
113
+ fromValues,
114
+ getAngle,
115
+ getAxisAngle,
116
+ identity,
117
+ invert,
118
+ len,
119
+ length,
120
+ lerp,
121
+ ln,
122
+ mul,
123
+ multiply,
124
+ normalize,
125
+ pow,
126
+ random,
127
+ rotateX,
128
+ rotateY,
129
+ rotateZ,
130
+ rotationTo,
131
+ scale,
132
+ set,
133
+ setAxes,
134
+ setAxisAngle,
135
+ slerp,
136
+ sqlerp,
137
+ sqrLen,
138
+ squaredLength,
139
+ str,
140
+ alloc,
141
+ unalloc,
142
+ fromUnitVectors,
143
+ fromYawPitchRoll
144
+ } = quat;