@carbonenginejs/core-math 0.1.0

package/LICENSE

@@ -0,0 +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.

package/NOTICE

@@ -0,0 +1,24 @@
+carbonenginejs/core-math
+========================
+
+A browser-friendly gl-matrix based math package for CarbonEngineJS projects.
+It contains standalone math containers originally extracted from ccpwgl's
+`src/global/math` library, plus shared mesh and tangent helpers that replace
+duplicated code in the CarbonEngineJS format packages.
+
+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

@@ -0,0 +1,110 @@
+# @carbonenginejs/core-math
+
+Browser-friendly gl-matrix based math containers for CarbonEngineJS packages.
+The package exposes small parent containers such as `num`, `vec3`, `mat4`,
+`mesh`, and `tangent`, and also supports subpath imports so callers do not need
+to import the full math surface.
+
+CarbonEngine and Fenris Creations (CCP Games) are named for provenance and
+interoperability context. This package contains no CarbonEngine or Fenris
+Creations (CCP Games) source code, shader source, proprietary documentation,
+tools, or assets.
+
+## Package
+
+- npm: <https://www.npmjs.com/package/@carbonenginejs/core-math>
+- package: `@carbonenginejs/core-math`
+- version: `0.1.0`
+- license: `MIT`
+- runtime: modern browsers, Node `>=18`
+- module: ESM
+- dependency: `gl-matrix ^3.4.4`
+
+## Install
+
+```sh
+npm install @carbonenginejs/core-math
+```
+
+## Public API
+
+Prefer direct subpath imports when a package only needs a few math methods:
+
+```js
+import { cross, normalize } from "@carbonenginejs/core-math/vec3";
+
+const out = [0, 0, 0];
+cross(out, edgeA, edgeB);
+normalize(out, out);
+```
+
+Subpaths can also be imported as module namespaces:
+
+```js
+import * as vec3 from "@carbonenginejs/core-math/vec3";
+
+vec3.cross(out, edgeA, edgeB);
+vec3.normalize(out, out);
+```
+
+Existing container exports remain available from subpaths while callers migrate:
+
+```js
+import { vec3 } from "@carbonenginejs/core-math/vec3";
+import { mesh } from "@carbonenginejs/core-math/mesh";
+import { tangent } from "@carbonenginejs/core-math/tangent";
+
+vec3.cross(out, edgeA, edgeB);
+const n = mesh.generateNormals(positions, indices);
+const t = mesh.generateTangents(positions, n, uvs, indices);
+const b = mesh.generateBiNormals(n, t);
+const packed = tangent.packTangentFrames(n, t, b);
+```
+
+Use root imports when several namespaces are needed:
+
+```js
+import { num, vec3, mat4, mesh, tangent } from "@carbonenginejs/core-math";
+
+num.clamp(value, 0, 1);
+vec3.cross(out, a, b);
+vec3.normalize(out, out);
+mat4.identity(world);
+const packed = tangent.packTangentFrames(normals, tangents, binormals);
+```
+
+`vertex` is a legacy compatibility container backed by the shared mesh/tangent
+helpers. Its tangent generation intentionally does not preserve the older
+ccpwgl `vertex.js` implementation.
+
+## Containers
+
+- `num`: scalar helpers and color/angle conversion helpers.
+- `vec2`, `vec3`, `vec4`, `quat`, `mat3`, `mat4`: gl-matrix containers with
+  CarbonEngineJS additions.
+- `box3`, `tri3`, `lne3`, `pln`, `ray3`, `sph3`: spatial helper containers.
+- `pool`: typed-array buffer pool helper.
+- `noise`, `curve`: extracted ccpwgl math helpers.
+- `mesh`: shared mesh rebuild helpers used by format packages.
+- `tangent`: CarbonEngineJS/GR2 packed tangent-frame helpers.
+- `vertex`: compatibility names for mesh/tangent generation.
+- `geometry`: extracted procedural geometry helpers.
+
+## Browser Rules
+
+Runtime source is plain ESM and must not depend on Node built-ins, filesystem
+helpers, CLI tools, webpack aliases, or ccpwgl application globals. Tests may
+run in Node, but package code must remain browser-safe.
+
+## Tests
+
+```sh
+npm test
+```
+
+Tests are self-contained and do not require local asset folders, network
+access, or game files.
+
+## License
+
+MIT (see `LICENSE`, `NOTICE`, and `THIRD-PARTY-NOTICES.md`).

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,38 @@
+# 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.
+
+## 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 notes
+
+Some geometry helpers in the extracted ccpwgl math tree are marked as converted
+from Three.js-style algorithms. These are retained as source comments and should
+be reviewed before expanding the public geometry surface.
+
+## 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.
+

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@carbonenginejs/core-math",
+  "version": "0.1.0",
+  "description": "Browser-friendly gl-matrix based math containers and CarbonEngineJS mesh/tangent helpers.",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./num": "./src/num.js",
+    "./vec2": "./src/vec2.js",
+    "./vec3": "./src/vec3.js",
+    "./vec4": "./src/vec4.js",
+    "./quat": "./src/quat.js",
+    "./mat3": "./src/mat3.js",
+    "./mat4": "./src/mat4.js",
+    "./box3": "./src/box3.js",
+    "./tri3": "./src/tri3.js",
+    "./lne3": "./src/lne3.js",
+    "./pln": "./src/pln.js",
+    "./ray3": "./src/ray3.js",
+    "./sph3": "./src/sph3.js",
+    "./pool": "./src/pool.js",
+    "./noise": "./src/noise.js",
+    "./curve": "./src/curve.js",
+    "./vertex": "./src/vertex.js",
+    "./mesh": "./src/mesh.js",
+    "./tangent": "./src/tangent.js",
+    "./geometry": "./src/geometry/index.js"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test",
+    "lint": "eslint --ext .js,.mjs src test",
+    "lint:fix": "eslint --fix --ext .js,.mjs src test"
+  },
+  "keywords": [
+    "carbonenginejs",
+    "core-math",
+    "gl-matrix",
+    "geometry",
+    "tangent",
+    "mesh",
+    "browser"
+  ],
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "THIRD-PARTY-NOTICES.md"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "gl-matrix": "^3.4.4"
+  },
+  "devDependencies": {
+    "eslint": "^8.57.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/carbonenginejs/core-math.git"
+  },
+  "homepage": "https://github.com/carbonenginejs/core-math#readme",
+  "bugs": {
+    "url": "https://github.com/carbonenginejs/core-math/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}
+