@carbonenginejs/runtime-utils 0.1.2 → 0.1.4

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 +154 -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 +241 -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 +117 -117
  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 +1744 -1463
  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 +141 -23
  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 -1188
  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/package.json CHANGED
@@ -1,139 +1,139 @@
1
- {
2
- "name": "@carbonenginejs/runtime-utils",
3
- "version": "0.1.2",
4
- "description": "Browser-safe shared utilities, math, constants, Carbon types, schemas, documents, and runtime model primitives.",
5
- "type": "module",
6
- "main": "src/index.js",
7
- "exports": {
8
- ".": "./src/index.js",
9
- "./arrays": "./src/arrays.js",
10
- "./bytes": "./src/bytes.js",
11
- "./compression": "./src/compression.js",
12
- "./const": "./src/constants/index.js",
13
- "./const/trinity": "./src/constants/trinity.js",
14
- "./const/media": "./src/media/index.js",
15
- "./const/graphics": "./src/graphics/index.js",
16
- "./const/render-context": "./src/renderContext/index.js",
17
- "./const/audio": "./src/audio/index.js",
18
- "./const/shader": "./src/shader/index.js",
19
- "./const/d3d": "./src/d3d/index.js",
20
- "./const/webgpu": "./src/webgpu/index.js",
21
- "./media": "./src/media/index.js",
22
- "./graphics": "./src/graphics/index.js",
23
- "./render-context": "./src/renderContext/index.js",
24
- "./audio": "./src/audio/index.js",
25
- "./shader": "./src/shader/index.js",
26
- "./d3d": "./src/d3d/index.js",
27
- "./webgpu": "./src/webgpu/index.js",
28
- "./document": "./src/document/index.js",
29
- "./errors": "./src/errors/index.js",
30
- "./hydration": "./src/document/hydrationAdapter.js",
31
- "./lifecycle": "./src/lifecycle/index.js",
32
- "./schema": "./src/schema/index.js",
33
- "./types": "./src/types/index.js",
34
- "./model": "./src/model/index.js",
35
- "./is": "./src/is.js",
36
- "./json": "./src/json.js",
37
- "./lookup": "./src/lookup.js",
38
- "./object": "./src/object.js",
39
- "./math": "./src/math/index.js",
40
- "./math/scalar": "./src/math/scalar.js",
41
- "./math/num": "./src/num.js",
42
- "./math/vec2": "./src/vec2.js",
43
- "./math/vec3": "./src/vec3.js",
44
- "./math/vec4": "./src/vec4.js",
45
- "./math/quat": "./src/quat.js",
46
- "./math/mat3": "./src/mat3.js",
47
- "./math/mat4": "./src/mat4.js",
48
- "./math/box3": "./src/box3.js",
49
- "./math/tri3": "./src/tri3.js",
50
- "./math/lne3": "./src/lne3.js",
51
- "./math/pln": "./src/pln.js",
52
- "./math/ray3": "./src/ray3.js",
53
- "./math/sph3": "./src/sph3.js",
54
- "./math/pool": "./src/pool.js",
55
- "./math/utils": "./src/utils.js",
56
- "./math/noise": "./src/noise.js",
57
- "./math/curve": "./src/curve.js",
58
- "./math/vertex": "./src/vertex.js",
59
- "./math/mesh": "./src/mesh.js",
60
- "./math/tangent": "./src/tangent.js",
61
- "./math/geometry": "./src/geometry/index.js",
62
- "./num": "./src/num.js",
63
- "./vec2": "./src/vec2.js",
64
- "./vec3": "./src/vec3.js",
65
- "./vec4": "./src/vec4.js",
66
- "./quat": "./src/quat.js",
67
- "./mat3": "./src/mat3.js",
68
- "./mat4": "./src/mat4.js",
69
- "./box3": "./src/box3.js",
70
- "./tri3": "./src/tri3.js",
71
- "./lne3": "./src/lne3.js",
72
- "./pln": "./src/pln.js",
73
- "./ray3": "./src/ray3.js",
74
- "./sph3": "./src/sph3.js",
75
- "./pool": "./src/pool.js",
76
- "./utils": "./src/utils.js",
77
- "./noise": "./src/noise.js",
78
- "./curve": "./src/curve.js",
79
- "./vertex": "./src/vertex.js",
80
- "./mesh": "./src/mesh.js",
81
- "./tangent": "./src/tangent.js",
82
- "./geometry": "./src/geometry/index.js",
83
- "./path": "./src/path.js",
84
- "./text": "./src/text.js",
85
- "./validation": "./src/validation.js"
86
- },
87
- "sideEffects": false,
88
- "engines": {
89
- "node": ">=18"
90
- },
91
- "scripts": {
92
- "test": "node --test",
93
- "lint": "eslint --ext .js,.mjs src test",
94
- "lint:fix": "eslint --fix --ext .js,.mjs src test",
95
- "check": "npm run lint && npm test"
96
- },
97
- "keywords": [
98
- "carbonenginejs",
99
- "runtime",
100
- "utilities",
101
- "gl-matrix",
102
- "constants",
103
- "schema",
104
- "types",
105
- "errors",
106
- "geometry",
107
- "tangent",
108
- "browser"
109
- ],
110
- "files": [
111
- "src",
112
- "docs",
113
- "README.md",
114
- "LICENSE",
115
- "NOTICE",
116
- "THIRD-PARTY-NOTICES.md"
117
- ],
118
- "license": "MIT",
119
- "dependencies": {
120
- "gl-matrix": "^3.4.4"
121
- },
122
- "devDependencies": {
123
- "eslint": "^8.57.1"
124
- },
125
- "repository": {
126
- "type": "git",
127
- "url": "git+https://github.com/carbonenginejs/runtime-utils.git"
128
- },
129
- "homepage": "https://github.com/carbonenginejs/runtime-utils#readme",
130
- "bugs": {
131
- "url": "https://github.com/carbonenginejs/runtime-utils/issues"
132
- },
133
- "publishConfig": {
134
- "access": "public"
135
- },
136
- "overrides": {
137
- "brace-expansion": "^5.0.8"
138
- }
139
- }
1
+ {
2
+ "name": "@carbonenginejs/runtime-utils",
3
+ "version": "0.1.4",
4
+ "description": "Browser-safe shared utilities, math, constants, Carbon types, schemas, documents, and runtime model primitives.",
5
+ "type": "module",
6
+ "main": "src/index.js",
7
+ "exports": {
8
+ ".": "./src/index.js",
9
+ "./arrays": "./src/arrays.js",
10
+ "./bytes": "./src/bytes.js",
11
+ "./compression": "./src/compression.js",
12
+ "./const": "./src/constants/index.js",
13
+ "./const/trinity": "./src/constants/trinity.js",
14
+ "./const/media": "./src/media/index.js",
15
+ "./const/graphics": "./src/graphics/index.js",
16
+ "./const/render-context": "./src/renderContext/index.js",
17
+ "./const/audio": "./src/audio/index.js",
18
+ "./const/shader": "./src/shader/index.js",
19
+ "./const/d3d": "./src/d3d/index.js",
20
+ "./const/webgpu": "./src/webgpu/index.js",
21
+ "./media": "./src/media/index.js",
22
+ "./graphics": "./src/graphics/index.js",
23
+ "./render-context": "./src/renderContext/index.js",
24
+ "./audio": "./src/audio/index.js",
25
+ "./shader": "./src/shader/index.js",
26
+ "./d3d": "./src/d3d/index.js",
27
+ "./webgpu": "./src/webgpu/index.js",
28
+ "./document": "./src/document/index.js",
29
+ "./errors": "./src/errors/index.js",
30
+ "./hydration": "./src/document/hydrationAdapter.js",
31
+ "./lifecycle": "./src/lifecycle/index.js",
32
+ "./schema": "./src/schema/index.js",
33
+ "./types": "./src/types/index.js",
34
+ "./model": "./src/model/index.js",
35
+ "./is": "./src/is.js",
36
+ "./json": "./src/json.js",
37
+ "./lookup": "./src/lookup.js",
38
+ "./object": "./src/object.js",
39
+ "./math": "./src/math/index.js",
40
+ "./math/scalar": "./src/math/scalar.js",
41
+ "./math/num": "./src/num.js",
42
+ "./math/vec2": "./src/vec2.js",
43
+ "./math/vec3": "./src/vec3.js",
44
+ "./math/vec4": "./src/vec4.js",
45
+ "./math/quat": "./src/quat.js",
46
+ "./math/mat3": "./src/mat3.js",
47
+ "./math/mat4": "./src/mat4.js",
48
+ "./math/box3": "./src/box3.js",
49
+ "./math/tri3": "./src/tri3.js",
50
+ "./math/lne3": "./src/lne3.js",
51
+ "./math/pln": "./src/pln.js",
52
+ "./math/ray3": "./src/ray3.js",
53
+ "./math/sph3": "./src/sph3.js",
54
+ "./math/pool": "./src/pool.js",
55
+ "./math/utils": "./src/utils.js",
56
+ "./math/noise": "./src/noise.js",
57
+ "./math/curve": "./src/curve.js",
58
+ "./math/vertex": "./src/vertex.js",
59
+ "./math/mesh": "./src/mesh.js",
60
+ "./math/tangent": "./src/tangent.js",
61
+ "./math/geometry": "./src/geometry/index.js",
62
+ "./num": "./src/num.js",
63
+ "./vec2": "./src/vec2.js",
64
+ "./vec3": "./src/vec3.js",
65
+ "./vec4": "./src/vec4.js",
66
+ "./quat": "./src/quat.js",
67
+ "./mat3": "./src/mat3.js",
68
+ "./mat4": "./src/mat4.js",
69
+ "./box3": "./src/box3.js",
70
+ "./tri3": "./src/tri3.js",
71
+ "./lne3": "./src/lne3.js",
72
+ "./pln": "./src/pln.js",
73
+ "./ray3": "./src/ray3.js",
74
+ "./sph3": "./src/sph3.js",
75
+ "./pool": "./src/pool.js",
76
+ "./utils": "./src/utils.js",
77
+ "./noise": "./src/noise.js",
78
+ "./curve": "./src/curve.js",
79
+ "./vertex": "./src/vertex.js",
80
+ "./mesh": "./src/mesh.js",
81
+ "./tangent": "./src/tangent.js",
82
+ "./geometry": "./src/geometry/index.js",
83
+ "./path": "./src/path.js",
84
+ "./text": "./src/text.js",
85
+ "./validation": "./src/validation.js"
86
+ },
87
+ "sideEffects": false,
88
+ "engines": {
89
+ "node": ">=18"
90
+ },
91
+ "scripts": {
92
+ "test": "node --test",
93
+ "lint": "eslint --ext .js,.mjs src test",
94
+ "lint:fix": "eslint --fix --ext .js,.mjs src test",
95
+ "check": "npm run lint && npm test"
96
+ },
97
+ "keywords": [
98
+ "carbonenginejs",
99
+ "runtime",
100
+ "utilities",
101
+ "gl-matrix",
102
+ "constants",
103
+ "schema",
104
+ "types",
105
+ "errors",
106
+ "geometry",
107
+ "tangent",
108
+ "browser"
109
+ ],
110
+ "files": [
111
+ "src",
112
+ "docs",
113
+ "README.md",
114
+ "LICENSE",
115
+ "NOTICE",
116
+ "THIRD-PARTY-NOTICES.md"
117
+ ],
118
+ "license": "MIT",
119
+ "dependencies": {
120
+ "gl-matrix": "^3.4.4"
121
+ },
122
+ "devDependencies": {
123
+ "eslint": "^8.57.1"
124
+ },
125
+ "repository": {
126
+ "type": "git",
127
+ "url": "git+https://github.com/carbonenginejs/runtime-utils.git"
128
+ },
129
+ "homepage": "https://github.com/carbonenginejs/runtime-utils#readme",
130
+ "bugs": {
131
+ "url": "https://github.com/carbonenginejs/runtime-utils/issues"
132
+ },
133
+ "publishConfig": {
134
+ "access": "public"
135
+ },
136
+ "overrides": {
137
+ "brace-expansion": "^5.0.8"
138
+ }
139
+ }
package/src/arrays.js CHANGED
@@ -1,5 +1,5 @@
1
- export {
2
- toArray,
3
- copyArrayLike,
4
- fillArrayLike
5
- } from "./utils.js";
1
+ export {
2
+ toArray,
3
+ copyArrayLike,
4
+ fillArrayLike
5
+ } from "./utils.js";
@@ -1,34 +1,34 @@
1
- /**
2
- * Canonical audio sample format tokens.
3
- */
4
- export const AudioSampleFormat = Object.freeze({
5
- UNKNOWN: "unknown",
6
- U8: "u8",
7
- S16: "s16",
8
- S24: "s24",
9
- S32: "s32",
10
- F32: "f32",
11
- F64: "f64"
12
- });
13
-
14
- /**
15
- * Canonical audio channel layout tokens.
16
- */
17
- export const AudioChannelLayout = Object.freeze({
18
- UNKNOWN: "unknown",
19
- MONO: "mono",
20
- STEREO: "stereo",
21
- SURROUND_5_1: "5.1",
22
- SURROUND_7_1: "7.1"
23
- });
24
-
25
- /**
26
- * Normalize an audio sample format token.
27
- *
28
- * @param {string} format Audio sample format token.
29
- * @returns {string} Canonical lowercase token.
30
- */
31
- export function normalizeAudioSampleFormat(format)
32
- {
33
- return format ? String(format).trim().toLowerCase() : AudioSampleFormat.UNKNOWN;
34
- }
1
+ /**
2
+ * Canonical audio sample format tokens.
3
+ */
4
+ export const AudioSampleFormat = Object.freeze({
5
+ UNKNOWN: "unknown",
6
+ U8: "u8",
7
+ S16: "s16",
8
+ S24: "s24",
9
+ S32: "s32",
10
+ F32: "f32",
11
+ F64: "f64"
12
+ });
13
+
14
+ /**
15
+ * Canonical audio channel layout tokens.
16
+ */
17
+ export const AudioChannelLayout = Object.freeze({
18
+ UNKNOWN: "unknown",
19
+ MONO: "mono",
20
+ STEREO: "stereo",
21
+ SURROUND_5_1: "5.1",
22
+ SURROUND_7_1: "7.1"
23
+ });
24
+
25
+ /**
26
+ * Normalize an audio sample format token.
27
+ *
28
+ * @param {string} format Audio sample format token.
29
+ * @returns {string} Canonical lowercase token.
30
+ */
31
+ export function normalizeAudioSampleFormat(format)
32
+ {
33
+ return format ? String(format).trim().toLowerCase() : AudioSampleFormat.UNKNOWN;
34
+ }
@@ -1 +1 @@
1
- export * from "./audioFormats.js";
1
+ export * from "./audioFormats.js";