@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 cppctamber / CarbonEngineJS contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 cppctamber / CarbonEngineJS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -1,23 +1,23 @@
-carbonenginejs/runtime-utils
-============================
-
-A browser-safe foundation package for CarbonEngineJS projects. It contains
-neutral utilities; shared constant vocabularies; Carbon type, schema, model,
-document, and lifecycle primitives; and standalone math containers originally
-extracted from ccpwgl's `src/global/math` library.
-
-CarbonEngine and Fenris Creations (CCP Games) are named here for provenance,
-interoperability, and target-ecosystem context. This package contains no
-CarbonEngine or Fenris Creations (CCP Games) source files, tooling, proprietary
-documentation, shader source, or assets.
-
-Packed tangent-frame behavior is based on observed Fenris Creations
-(CCP Games) EVE/Carbon shader behavior and generated test vectors, not copied
-shader source.
-
-This package is not affiliated with or endorsed by CCP Games.
-
-CarbonEngineJS-facing code is copyright cppctamber / CarbonEngineJS
-contributors.
-
-Repository license: MIT. See LICENSE and THIRD-PARTY-NOTICES.md.
+carbonenginejs/runtime-utils
+============================
+
+A browser-safe foundation package for CarbonEngineJS projects. It contains
+neutral utilities; shared constant vocabularies; Carbon type, schema, model,
+document, and lifecycle primitives; and standalone math containers originally
+extracted from ccpwgl's `src/global/math` library.
+
+CarbonEngine and Fenris Creations (CCP Games) are named here for provenance,
+interoperability, and target-ecosystem context. This package contains no
+CarbonEngine or Fenris Creations (CCP Games) source files, tooling, proprietary
+documentation, shader source, or assets.
+
+Packed tangent-frame behavior is based on observed Fenris Creations
+(CCP Games) EVE/Carbon shader behavior and generated test vectors, not copied
+shader source.
+
+This package is not affiliated with or endorsed by CCP Games.
+
+CarbonEngineJS-facing code is copyright cppctamber / CarbonEngineJS
+contributors.
+
+Repository license: MIT. See LICENSE and THIRD-PARTY-NOTICES.md.

package/README.md

@@ -1,70 +1,70 @@
-# @carbonenginejs/runtime-utils
-
-Browser-safe foundations shared across CarbonEngineJS packages.
-
-The package owns:
-
-- neutral arrays, bytes, compression, JSON, lookup, paths, text, predicates,
-  validation, and structured operational errors;
-- scalar, vector, quaternion, matrix, geometry, mesh, tangent, curve, and
-  noise math;
-- shared media, graphics, render-context, audio, shader, D3D, and WebGPU
-  constants;
-- Carbon type descriptors, schema metadata, models, lifecycle state,
-  documents, hydration, and dehydration.
-
-Browser-client ownership is planned for `@carbonenginejs/tools-browser`; that
-package is not currently released. Node automation belongs in
+# @carbonenginejs/runtime-utils
+
+Browser-safe foundations shared across CarbonEngineJS packages.
+
+The package owns:
+
+- neutral arrays, bytes, compression, JSON, lookup, paths, text, predicates,
+  validation, and structured operational errors;
+- scalar, vector, quaternion, matrix, geometry, mesh, tangent, curve, and
+  noise math;
+- shared media, graphics, render-context, audio, shader, D3D, and WebGPU
+  constants;
+- Carbon type descriptors, schema metadata, models, lifecycle state,
+  documents, hydration, and dehydration.
+
+Browser clients, remote readers, inspectors, and browser integrations belong
+in `@carbonenginejs/tools-browser`. Node automation belongs in
 `@carbonenginejs/tools-core`.
-
-## Install
-
-```sh
-npm install @carbonenginejs/runtime-utils
-```
-
-## Quick start
-
-Prefer direct subpaths so unrelated families are not initialized:
-
-```js
-import { normalizePath } from "@carbonenginejs/runtime-utils/path";
-import { CjsError } from "@carbonenginejs/runtime-utils/errors";
-import { cross, normalize } from "@carbonenginejs/runtime-utils/vec3";
-import { PixelFormat } from "@carbonenginejs/runtime-utils/graphics";
-import { CjsSchema } from "@carbonenginejs/runtime-utils/schema";
-```
-
-Former package imports map as follows:
-
-- `@carbonenginejs/core-math` becomes
-  `@carbonenginejs/runtime-utils/math`;
-- `@carbonenginejs/core-math/<subpath>` becomes
-  `@carbonenginejs/runtime-utils/<subpath>`;
-- `@carbonenginejs/runtime-const` becomes
-  `@carbonenginejs/runtime-utils/const`;
-- `@carbonenginejs/runtime-const/<subpath>` becomes
-  `@carbonenginejs/runtime-utils/<subpath>`;
-- `@carbonenginejs/core-types/<subpath>` becomes the matching
-  `@carbonenginejs/runtime-utils/<subpath>`; replace former root imports with
-  the direct type/model/document subpaths they use.
-
-Carbon type and model primitives use `/types`, `/schema`, `/model`,
-`/document`, `/hydration`, and `/lifecycle`.
-
-The root export is intentionally limited to common neutral utilities, math,
-and non-conflicting constants. Import Carbon type/model/document families from
-their direct subpaths.
-
-## Documentation
-
-- [Package documentation](docs/README.md)
-- [Architecture and admission rules](docs/architecture.md)
-- [API reference](docs/reference/api.md)
-- [Foundation consolidation](docs/concepts/foundation-consolidation.md)
-- [Constant vocabulary notes](docs/const-kb.md)
-
-## License
-
-MIT. See [LICENSE](LICENSE), [NOTICE](NOTICE), and
-[THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).
+
+## Install
+
+```sh
+npm install @carbonenginejs/runtime-utils
+```
+
+## Quick start
+
+Prefer direct subpaths so unrelated families are not initialized:
+
+```js
+import { normalizePath } from "@carbonenginejs/runtime-utils/path";
+import { CjsError } from "@carbonenginejs/runtime-utils/errors";
+import { cross, normalize } from "@carbonenginejs/runtime-utils/vec3";
+import { PixelFormat } from "@carbonenginejs/runtime-utils/graphics";
+import { CjsSchema } from "@carbonenginejs/runtime-utils/schema";
+```
+
+Former package imports map as follows:
+
+- `@carbonenginejs/core-math` becomes
+  `@carbonenginejs/runtime-utils/math`;
+- `@carbonenginejs/core-math/<subpath>` becomes
+  `@carbonenginejs/runtime-utils/<subpath>`;
+- `@carbonenginejs/runtime-const` becomes
+  `@carbonenginejs/runtime-utils/const`;
+- `@carbonenginejs/runtime-const/<subpath>` becomes
+  `@carbonenginejs/runtime-utils/<subpath>`;
+- `@carbonenginejs/core-types/<subpath>` becomes the matching
+  `@carbonenginejs/runtime-utils/<subpath>`; replace former root imports with
+  the direct type/model/document subpaths they use.
+
+Carbon type and model primitives use `/types`, `/schema`, `/model`,
+`/document`, `/hydration`, and `/lifecycle`.
+
+The root export is intentionally limited to common neutral utilities, math,
+and non-conflicting constants. Import Carbon type/model/document families from
+their direct subpaths.
+
+## Documentation
+
+- [Package documentation](docs/README.md)
+- [Architecture and admission rules](docs/architecture.md)
+- [API reference](docs/reference/api.md)
+- [Foundation consolidation](docs/concepts/foundation-consolidation.md)
+- [Constant vocabulary notes](docs/const-kb.md)
+
+## License
+
+MIT. See [LICENSE](LICENSE), [NOTICE](NOTICE), and
+[THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).

package/THIRD-PARTY-NOTICES.md

@@ -1,64 +1,64 @@
-# Third-Party Notices
-
-## gl-matrix
-
-This package depends on `gl-matrix` and extends its vector, quaternion, and
-matrix containers with CarbonEngineJS helpers.
-
-- Project: <https://github.com/toji/gl-matrix>
-- License: MIT
-
-## ccpwgl math extraction
-
-Most container modules in `src` were extracted from ccpwgl's
-`src/global/math` library and converted to standalone ESM with package-local
-imports. The code remains MIT-licensed under the CarbonEngineJS/ccpwgl project
-license.
-
-- Project: <https://github.com/cppctamber/ccpwgl2>
-- Copyright: 2020 ccpgames rawrafox cppctamber
-- License: MIT; terms reproduced below
-
-## Mapbox earcut helper
-
-`src/geometry/helpers/earcut.js` is an embedded copy of an Earcut-style
-triangulation helper from the ccpwgl math tree.
-
-- Copyright: 2016, Mapbox
-- License: ISC
-- Local license copy: `src/geometry/helpers/LICENSE`
-
-## Three.js-derived geometry helpers
-
-Math and geometry helpers in the extracted ccpwgl tree retain source comments
-attributing conversions to Three.js authors.
-
-- Project: <https://github.com/mrdoob/three.js>
-- Copyright: 2010-2026 three.js authors
-- License: MIT; terms reproduced below
-
-## Fenris Creations / CCP Games tangent behavior
-
-`src/tangent.js` implements CarbonEngineJS/GR2 packed tangent-frame behavior
-derived from observed EVE/Carbon shader behavior and generated test vectors.
-No Fenris Creations (CCP Games) shader source, tools, or assets are included.
-
-## MIT terms for ccpwgl and Three.js material
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software is furnished to do so,
-subject to the following conditions:
-
-The above copyright notices and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+# Third-Party Notices
+
+## gl-matrix
+
+This package depends on `gl-matrix` and extends its vector, quaternion, and
+matrix containers with CarbonEngineJS helpers.
+
+- Project: <https://github.com/toji/gl-matrix>
+- License: MIT
+
+## ccpwgl math extraction
+
+Most container modules in `src` were extracted from ccpwgl's
+`src/global/math` library and converted to standalone ESM with package-local
+imports. The code remains MIT-licensed under the CarbonEngineJS/ccpwgl project
+license.
+
+- Project: <https://github.com/cppctamber/ccpwgl2>
+- Copyright: 2020 ccpgames rawrafox cppctamber
+- License: MIT; terms reproduced below
+
+## Mapbox earcut helper
+
+`src/geometry/helpers/earcut.js` is an embedded copy of an Earcut-style
+triangulation helper from the ccpwgl math tree.
+
+- Copyright: 2016, Mapbox
+- License: ISC
+- Local license copy: `src/geometry/helpers/LICENSE`
+
+## Three.js-derived geometry helpers
+
+Math and geometry helpers in the extracted ccpwgl tree retain source comments
+attributing conversions to Three.js authors.
+
+- Project: <https://github.com/mrdoob/three.js>
+- Copyright: 2010-2026 three.js authors
+- License: MIT; terms reproduced below
+
+## Fenris Creations / CCP Games tangent behavior
+
+`src/tangent.js` implements CarbonEngineJS/GR2 packed tangent-frame behavior
+derived from observed EVE/Carbon shader behavior and generated test vectors.
+No Fenris Creations (CCP Games) shader source, tools, or assets are included.
+
+## MIT terms for ccpwgl and Three.js material
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notices and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/docs/README.md

@@ -1,84 +1,85 @@
-# Runtime utilities documentation
-
-Status: Evolving
-Scope: `@carbonenginejs/runtime-utils`
-Audience: Runtime authors, integrators, and maintainers
-Summary: Explains the consolidated shared runtime foundation and its public families.
-
-## Purpose
-
-`@carbonenginejs/runtime-utils` is the bottom shared layer of the
-CarbonEngineJS runtime dependency graph. It owns browser-safe primitives that
-are useful across runtime libraries and do not depend on another
-CarbonEngineJS package.
-
-The package is deliberately strict about what enters this layer so it can
-remain stable and low-changing after the Carbon-to-JavaScript conversion.
-
-## Use this package when
-
-Use `runtime-utils` when code:
-
-- is a general runtime primitive used by more than one package;
-- has stable behavior that can be described without domain policy;
-- is safe in browsers and does not import Node built-ins;
-- can remain independent of every other CarbonEngineJS package.
-
+# Runtime utilities documentation
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime-utils`
+Audience: Runtime authors, integrators, and maintainers
+Summary: Explains the consolidated shared runtime foundation and its public families.
+
+## Purpose
+
+`@carbonenginejs/runtime-utils` is the bottom shared layer of the
+CarbonEngineJS runtime dependency graph. It owns browser-safe primitives that
+are useful across runtime libraries and do not depend on another
+CarbonEngineJS package.
+
+The package is deliberately strict about what enters this layer so it can
+remain stable and low-changing after the Carbon-to-JavaScript conversion.
+
+## Use this package when
+
+Use `runtime-utils` when code:
+
+- is a general runtime primitive used by more than one package;
+- has stable behavior that can be described without domain policy;
+- is safe in browsers and does not import Node built-ins;
+- can remain independent of every other CarbonEngineJS package.
+
 Do not use it merely as a convenient home for code without an owner.
 Browser-facing demos, clients, inspectors, and usable application helpers have
-the planned owner `@carbonenginejs/tools-browser`; that package is not
-currently released.
-
-## Where it fits
-
-The package has no organization dependencies. It uses `gl-matrix` for the math
-families; its subpaths remain side-effect-free and independently importable.
-The `/errors` family supplies coded operational failures without defining
-logging, transport, HTTP, or retry policy.
-
+the current owner `@carbonenginejs/tools-browser`.
+
+## Where it fits
+
+The package has no organization dependencies. It uses `gl-matrix` for the math
+families; its subpaths remain side-effect-free and independently importable.
+The `/errors` family supplies coded operational failures without defining
+logging, transport, HTTP, or retry policy.
+
 ```text
-runtime libraries       tools-browser (planned; unreleased)
-        \                    /
-         \                  /
-          v                v
+runtime libraries       tools-browser
+        \                   /
+         \                 /
+          v               v
              runtime-utils
                   |
                   v
       Web-standard platform APIs
 ```
 
-Runtime packages consume this foundation directly. The planned, unreleased
-`tools-browser` package will do the same. Math, constant, type, schema, model,
-document, hydration, and lifecycle ownership is consolidated here.
-
-## Start here
-
-Use the root export when a library consumes several utility families:
-
-```js
-import {
-    encodeJson,
-    isPlainObject,
-    normalizePath
-} from "@carbonenginejs/runtime-utils";
-```
-
-Use a public subpath when a consumer needs one focused family:
-
-```js
-import { asUint8Array } from "@carbonenginejs/runtime-utils/bytes";
-```
-
-## Documentation map
-
-- [Architecture and admission rules](architecture.md) defines dependency
-  direction, ownership, and the test for adding code.
-- [Current API reference](reference/api.md) lists the implemented subpaths and
-  exports.
-- [Class reference](reference/classes/README.md) catalogs maintained Carbon
-  foundation classes.
+Runtime packages and tools-browser consume this foundation directly. Math,
+constant, type, schema, model, document, hydration, and lifecycle ownership is
+consolidated here.
+
+## Start here
+
+Use the root export when a library consumes several utility families:
+
+```js
+import {
+    encodeJson,
+    isPlainObject,
+    normalizePath
+} from "@carbonenginejs/runtime-utils";
+```
+
+Use a public subpath when a consumer needs one focused family:
+
+```js
+import { asUint8Array } from "@carbonenginejs/runtime-utils/bytes";
+```
+
+## Documentation map
+
+- [Architecture and admission rules](architecture.md) defines dependency
+  direction, ownership, and the test for adding code.
+- [Current API reference](reference/api.md) lists the implemented subpaths and
+  exports.
+- [Class reference](reference/classes/README.md) catalogs maintained Carbon
+  foundation classes.
 - [Foundation consolidation](concepts/foundation-consolidation.md) records the
   implemented ownership move and consumer migration map.
-
-The Carbon type/model/document guide is retained under
-[core-types/README.md](core-types/README.md) with updated package paths.
+- [Model lifecycle](concepts/model-lifecycle.md) defines dirty settlement,
+  initialization, traversal, resources, and optional lifecycle state.
+
+The Carbon type/model/document guide is retained under
+[core-types/README.md](core-types/README.md) with updated package paths.