geom-center-and-normalize 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+# [2.3.0](https://github.com/vorg/geom-center-and-normalize/compare/v2.2.1...v2.3.0) (2026-10-12)
+
+### Bug Fixes
+
+* flip align sign so -1 aligns the bounding box min ([907727b](https://github.com/vorg/geom-center-and-normalize/commit/907727bf2c084058e251cb45d270aac497889a5c))
+
+### Features
+
+* add align option ([d0596b5](https://github.com/vorg/geom-center-and-normalize/commit/d0596b5a71b3a49c726ea382ffc8427eeb106149))
+
+## [2.2.1](https://github.com/vorg/geom-center-and-normalize/compare/v2.2.0...v2.2.1) (2025-09-21)
+
+
+### Bug Fixes
+
+* apply centering regardles of normalization ([b0d14a4](https://github.com/vorg/geom-center-and-normalize/commit/b0d14a464da927ec4a320b52ad03e55fb7d9d705)), closes [#11](https://github.com/vorg/geom-center-and-normalize/issues/11)
+
+
+
 # [2.2.0](https://github.com/vorg/geom-center-and-normalize/compare/v2.1.1...v2.2.0) (2024-04-16)
 
 

package/README.md

@@ -37,11 +37,15 @@ const normalizedPositions = centerAndNormalize(positions);
 
 - positions: `TypedArray | Array | Array<[x, y, z]>` – simplicial complex geometry positions (eg. `new Float32Array([x, y, z, x, y, z, ...])/new Array(x, y, z, x, y, z, ...)` or `new Array([x, y, z], [x, y, z], ...)`)
 
-- options: `{ center: boolean, normalize: boolean, normalizedSize: number }` – enable/disable centering/normalizing and control normalized scaling. `center` and `normalize` defaults to `true`. Scale defaults to `1`.
+- options: `object`
+  - `center: boolean` – move the bounding box center to `[0, 0, 0]`. Defaults to `true`.
+  - `normalize: boolean` – scale positions uniformly so that the bounding box largest side is `normalizedSize`. Defaults to `true`.
+  - `normalizedSize: number` – size of the bounding box largest side when normalizing. Defaults to `1`.
+  - `align: [x, y, z]` – per axis position on the bounding box, from `-1` (min) through `0` (center) to `1` (max), placed at the anchor: `[0, 0, 0]` when centering, the original bounding box center otherwise. Eg. `[0, -1, 0]` aligns the bounding box min y to the anchor. Defaults to `[0, 0, 0]`.
 
 **Returns**
 
-- positions: `TypedArray | Array | Array<[x, y, z]>` – The positions parameter array updated, centered at `[0, 0, 0]` and normalized to a bounding box of `normalizedSize` (`[-halfScale, -halfScale, -halfScale] x [halfScale, halfScale, halfScale]`).
+- positions: `TypedArray | Array | Array<[x, y, z]>` – The positions parameter array updated in place, by default centered at `[0, 0, 0]` with its bounding box largest side normalized to `normalizedSize`.
 
 ## License
 

package/index.js

@@ -5,33 +5,39 @@ const TEMP_VEC3 = vec3.create();
 
 function centerAndNormalize(
   positions,
-  { center = true, normalize = true, normalizedSize = 1 } = {},
+  {
+    center = true,
+    normalize = true,
+    normalizedSize = 1,
+    align = [0, 0, 0],
+  } = {},
 ) {
+  if (!center && !normalize && !align.some(Boolean)) return positions;
+
   const isFlatArray = !positions[0]?.length;
   const positionsCount = positions.length / (isFlatArray ? 3 : 1);
 
   const bbox = aabb.fromPoints(aabb.create(), positions);
   const bboxCenter = aabb.center(bbox);
+  const size = aabb.size(bbox);
 
-  if (normalize) {
-    const size = aabb.size(bbox);
-    normalizedSize = normalizedSize / (Math.max(...size) || 1);
-  }
+  const scale = normalize ? normalizedSize / (Math.max(...size) || 1) : 1;
+
+  const translation = bboxCenter.map(
+    (c, i) => (center ? 0 : c) - (align[i] * size[i] * scale) / 2,
+  );
+  const translate = translation.some(Boolean);
 
   for (let i = 0; i < positionsCount; i++) {
     if (isFlatArray) {
       avec3.sub(positions, i, bboxCenter, 0);
-      if (normalize) {
-        avec3.scale(positions, i, normalizedSize);
-        if (!center) avec3.add(positions, i, bboxCenter, 0);
-      }
+      if (normalize) avec3.scale(positions, i, scale);
+      if (translate) avec3.add(positions, i, translation, 0);
     } else {
       vec3.set(TEMP_VEC3, positions[i]);
       vec3.sub(TEMP_VEC3, bboxCenter);
-      if (normalize) {
-        vec3.scale(TEMP_VEC3, normalizedSize);
-        if (!center) vec3.add(TEMP_VEC3, bboxCenter);
-      }
+      if (normalize) vec3.scale(TEMP_VEC3, scale);
+      if (translate) vec3.add(TEMP_VEC3, translation);
       vec3.set(positions[i], TEMP_VEC3);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geom-center-and-normalize",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Center a simplicial complex geometry's positions in place and scale them to fill a defined bounding box.",
   "keywords": [
     "geom",
@@ -15,7 +15,10 @@
   ],
   "homepage": "https://github.com/vorg/geom-center-and-normalize",
   "bugs": "https://github.com/vorg/geom-center-and-normalize/issues",
-  "repository": "vorg/geom-center-and-normalize",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vorg/geom-center-and-normalize.git"
+  },
   "license": "MIT",
   "author": "Marcin Ignac <marcin.ignac@gmail.com> (https://github.com/vorg)",
   "contributors": [
@@ -23,20 +26,26 @@
   ],
   "sideEffects": false,
   "type": "module",
-  "exports": "./index.js",
-  "main": "index.js",
-  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "main": "./index.js",
+  "types": "./types/index.d.ts",
   "scripts": {
     "release": "snowdev release",
-    "test": "node --test",
-    "test:watch": "node --test --watch test"
+    "test": "node --experimental-test-coverage test",
+    "test:watch": "node --watch --experimental-test-coverage test"
   },
   "dependencies": {
-    "pex-geom": "^3.0.1",
-    "pex-math": "^4.1.0"
+    "pex-geom": "^3.1.2",
+    "pex-math": "^4.4.0"
   },
+  "packageManager": "npm@11.3.0",
   "engines": {
-    "node": ">=20.0.0",
-    "npm": ">=9.6.4"
+    "node": ">=24.0.0",
+    "snowdev": ">=3.0.0-alpha.3"
   }
 }

package/types/index.d.ts

@@ -1,6 +1,7 @@
 export default centerAndNormalize;
-declare function centerAndNormalize(positions: any, { center, normalize, normalizedSize }?: {
-    center?: boolean;
-    normalize?: boolean;
-    normalizedSize?: number;
+declare function centerAndNormalize(positions: any, { center, normalize, normalizedSize, align, }?: {
+    center?: boolean | undefined;
+    normalize?: boolean | undefined;
+    normalizedSize?: number | undefined;
+    align?: number[] | undefined;
 }): any;