add mat4Persp + mat4Ortho to @nakednous/tree and p5.tree bridge

deps/tree/src/form.js:
  - remove mat4Perspective (symmetric fov+aspect is user-space sugar)
  - rename mat4Frustum → mat4Persp (general off-centre perspective)

src/matrix.js:
  - mat4Proj remains pure live-state reader (persp or ortho)
  - add mat4Persp(out, l,r,b,t,near,far) standalone constructor
  - add mat4Ortho(out, l,r,b,t,near,far) standalone constructor
  - both auto-supply NDC convention via getNdcZ()

src/visibility.js:
  - update sign contract comment: mat4Frustum → mat4Persp

Author: nakednous

README.md

@@ -244,12 +244,14 @@ Accepted types for `out` and override params: `Float32Array` | `ArrayLike` | `p5
 **Simple queries** — read from live renderer state:
 
 ```js
-mat4Eye(out)                                   // eye matrix (inverse view) — eye→world
-mat4Eye(out, ex,ey,ez, cx,cy,cz, ux,uy,uz)    // standalone lookat eye — no camera state
-mat4Proj(out)                                  // projection matrix
-mat4View(out)                                  // view matrix — world→eye
-mat4View(out, ex,ey,ez, cx,cy,cz, ux,uy,uz)   // standalone lookat view — no camera state
-mat4Model(out)                                 // model matrix — local→world
+mat4Model(out)                               // model matrix — local→world
+mat4View(out)                                // view matrix — world→eye
+mat4View(out, ex,ey,ez, cx,cy,cz, ux,uy,uz)  // standalone lookat view — no camera state
+mat4Eye(out)                                 // eye matrix (inverse view) — eye→world
+mat4Eye(out, ex,ey,ez, cx,cy,cz, ux,uy,uz)   // standalone lookat eye — no camera state
+mat4Proj(out)                                // projection matrix (live state — persp or ortho)
+mat4Persp(out, l,r,b,t, near,far)            // standalone perspective (general frustum)
+mat4Ortho(out, l,r,b,t, near,far)            // standalone orthographic
 ```
 
 **Composite queries** — `out` first, optional overrides in an opts object:
@@ -607,7 +609,7 @@ Both accept the same options object:
 # Utilities
 
 ```js
-p5.Tree.VERSION   // '0.0.36'
+p5.Tree.VERSION   // '0.0.37'
 ```
 
 ## Shader helpers
@@ -682,9 +684,9 @@ Latest:
 
 Tagged:
 
-* [https://cdn.jsdelivr.net/npm/p5.tree@0.0.36/dist/p5.tree.js](https://cdn.jsdelivr.net/npm/p5.tree@0.0.36/dist/p5.tree.js)
-* [https://cdn.jsdelivr.net/npm/p5.tree@0.0.36/dist/p5.tree.min.js](https://cdn.jsdelivr.net/npm/p5.tree@0.0.36/dist/p5.tree.min.js)
-* [https://cdn.jsdelivr.net/npm/p5.tree@0.0.36/dist/p5.tree.esm.js](https://cdn.jsdelivr.net/npm/p5.tree@0.0.36/dist/p5.tree.esm.js)
+* [https://cdn.jsdelivr.net/npm/p5.tree@0.0.37/dist/p5.tree.js](https://cdn.jsdelivr.net/npm/p5.tree@0.0.37/dist/p5.tree.js)
+* [https://cdn.jsdelivr.net/npm/p5.tree@0.0.37/dist/p5.tree.min.js](https://cdn.jsdelivr.net/npm/p5.tree@0.0.37/dist/p5.tree.min.js)
+* [https://cdn.jsdelivr.net/npm/p5.tree@0.0.37/dist/p5.tree.esm.js](https://cdn.jsdelivr.net/npm/p5.tree@0.0.37/dist/p5.tree.esm.js)
 
 ---
 

deps/tree/README.md

@@ -320,9 +320,8 @@ mat4Eye              — eye matrix (eye→world) from lookat params
 mat4FromTRS          — column-major mat4 from flat TRS scalars
 mat4FromTranslation  — translation-only mat4
 mat4FromScale        — scale-only mat4
-mat4Perspective      — perspective projection  (ndcZMin, ndcYSign)
-mat4Ortho            — orthographic projection (ndcZMin, ndcYSign)
-mat4Frustum          — off-centre perspective  (ndcZMin, ndcYSign)
+mat4Persp            — perspective projection, general frustum (ndcZMin, ndcYSign)
+mat4Ortho            — orthographic projection                 (ndcZMin, ndcYSign)
 mat4Bias             — NDC→texture/UV remap [0,1] for shadow mapping
 mat4Reflect          — reflection across a plane
 ```

deps/tree/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nakednous/tree",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "tree — pure numeric core. Zero dependencies.",
   "type": "module",
   "main": "dist/index.js",

deps/tree/src/form.js

@@ -164,30 +164,6 @@ export function mat4FromScale(out, sx,sy,sz) {
 // Projection construction
 // =========================================================================
 
-/**
- * Perspective projection matrix.
- *
- * @param {Float32Array|number[]} out  16-element destination.
- * @param {number} fov       Vertical field of view (radians).
- * @param {number} aspect    Width / height.
- * @param {number} near      Near plane distance (positive).
- * @param {number} far       Far plane distance (positive, > near).
- * @param {number} ndcZMin   −1 (WEBGL) or 0 (WEBGPU).
- * @param {number} [ndcYSign=1]  +1 = NDC y-up (default); −1 = NDC y-down (native Vulkan).
- */
-export function mat4Perspective(out, fov, aspect, near, far, ndcZMin, ndcYSign=1) {
-  const f = 1 / Math.tan(fov * 0.5);
-  out[0]=f/aspect;       out[1]=0;              out[2]=0;  out[3]=0;
-  out[4]=0;              out[5]=ndcYSign*f;     out[6]=0;  out[7]=0;
-  out[8]=0;              out[9]=0;
-  out[10]=(ndcZMin*near-far)/(far-near);
-  out[11]=-1;
-  out[12]=0; out[13]=0;
-  out[14]=(ndcZMin-1)*far*near/(far-near);
-  out[15]=0;
-  return out;
-}
-
 /**
  * Orthographic projection matrix.
  *
@@ -209,15 +185,18 @@ export function mat4Ortho(out, left, right, bottom, top, near, far, ndcZMin, ndc
 }
 
 /**
- * Frustum (off-centre perspective) projection matrix.
+ * Perspective projection matrix (general / off-centre frustum).
+ * Symmetric case: left=-right, bottom=-top — derive from fov+aspect in user space:
+ *   top = near * Math.tan(fov / 2);  right = top * aspect
+ *   mat4Persp(out, -right, right, -top, top, near, far, ndcZMin)
  *
  * @param {Float32Array|number[]} out  16-element destination.
- * @param {number} left,right,bottom,top  Near-plane extents.
+ * @param {number} left,right,bottom,top  Near-plane extents (signed, y-up: top>0, bottom<0).
  * @param {number} near,far              Clip plane distances (positive).
  * @param {number} ndcZMin               −1 (WEBGL) or 0 (WEBGPU).
  * @param {number} [ndcYSign=1]          +1 = NDC y-up (default); −1 = NDC y-down (native Vulkan).
  */
-export function mat4Frustum(out, left, right, bottom, top, near, far, ndcZMin, ndcYSign=1) {
+export function mat4Persp(out, left, right, bottom, top, near, far, ndcZMin, ndcYSign=1) {
   const rl=1/(right-left), tb=1/(top-bottom);
   out[0]=2*near*rl;        out[1]=0;                          out[2]=0;  out[3]=0;
   out[4]=0;                out[5]=ndcYSign*2*near*tb;         out[6]=0;  out[7]=0;

deps/tree/src/track.js

@@ -121,13 +121,13 @@ export const hermiteVec3 = (out, p0, m0, p1, m1, t) => {
 };
 
 // Centripetal CR outgoing tangent at p1 for segment p1→p2, scaled by dt1.
-const _crTanOut = (out, p0, p1, p2, p3) => {
+const _crTanOut = (out, p0, p1, p2) => {
   const dt0=Math.pow(_dist3(p0,p1),0.5)||1, dt1=Math.pow(_dist3(p1,p2),0.5)||1;
   for (let i=0;i<3;i++) out[i]=((p1[i]-p0[i])/dt0-(p2[i]-p0[i])/(dt0+dt1)+(p2[i]-p1[i])/dt1)*dt1;
   return out;
 };
 
-const _crTanIn = (out, p0, p1, p2, p3) => {
+const _crTanIn = (out, p1, p2, p3) => {
   const dt1=Math.pow(_dist3(p1,p2),0.5)||1, dt2=Math.pow(_dist3(p2,p3),0.5)||1;
   for (let i=0;i<3;i++) out[i]=((p2[i]-p1[i])/dt1-(p3[i]-p1[i])/(dt1+dt2)+(p3[i]-p2[i])/dt2)*dt1;
   return out;

package.json

@@ -1,6 +1,6 @@
 {
   "name": "p5.tree",
-  "version": "0.0.36",
+  "version": "0.0.37",
   "description": "Render pipeline for p5.js v2 — pose and camera interpolation, space transforms, frustum visibility, HUD, post-processing pipe, picking, and declarative control panels.",
   "type": "module",
   "main": "dist/p5.tree.esm.js",
@@ -49,7 +49,7 @@
     "p5": "^2.2.3"
   },
   "dependencies": {
-    "@nakednous/tree": "^0.0.17",
+    "@nakednous/tree": "^0.0.18",
     "@nakednous/ui": "^0.0.9"
   },
   "devDependencies": {

src/constants.js

@@ -12,7 +12,7 @@ export function installConstants(p5) {
   const CONST = value => ({ value, writable: false, enumerable: true, configurable: false });
 
   Object.defineProperties(p5.Tree, {
-    VERSION: CONST('0.0.36'),
+    VERSION: CONST('0.0.37'),
     NONE: CONST(0),
 
     // Core constants (spaces, visibility, NDC, basis vectors)

src/gizmos.js

@@ -18,7 +18,6 @@ import {
 } from '@nakednous/tree';
 
 import { getNdcZ } from './matrix.js';
-import { computePlanes } from './visibility.js';
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Module-level working buffers — never returned to caller

src/matrix.js

@@ -34,6 +34,8 @@ import {
   pixelRatio as corePixelRatio,
   mat4View  as _mat4View,
   mat4Eye   as _mat4Eye,
+  mat4Persp as _mat4Persp,
+  mat4Ortho as _mat4Ortho,
   mat4ToTranslation,
   mat4ToScale,
   mat4ToRotation,
@@ -102,14 +104,37 @@ export function installMatrix(p5, fn) {
   // ── Simple matrix queries ─────────────────────────────────────────────────
   //   out: Float32Array | ArrayLike | p5.Matrix — 16-element destination.
 
-  /** Projection matrix (eye → clip). */
+  /** Projection matrix (eye → clip) — reads live renderer state (perspective or ortho). */
   p5.Renderer3D.prototype.mat4Proj = function (out) {
     const buf = _rawMat4(out), s = _projMat4(this);
     for (let i = 0; i < 16; i++) buf[i] = s[i];
     return out;
   };
   fn.mat4Proj = function (out) { return this._renderer.mat4Proj(out); };
 
+  /**
+   * Perspective projection matrix (standalone constructor, general frustum).
+   * mat4Persp(out, left, right, bottom, top, near, far[, ndcZMin[, ndcYSign]])
+   * Symmetric: left=-right, bottom=-top — derive from fov+aspect in user space.
+   * @param {Float32Array|ArrayLike|p5.Matrix} out
+   */
+  fn.mat4Persp = function (out, ...args) {
+    if (args[6] == null) args[6] = _ndcZ;
+    _mat4Persp(_rawMat4(out), ...args);
+    return out;
+  };
+
+  /**
+   * Orthographic projection matrix (standalone constructor).
+   * mat4Ortho(out, left, right, bottom, top, near, far[, ndcZMin[, ndcYSign]])
+   * @param {Float32Array|ArrayLike|p5.Matrix} out
+   */
+  fn.mat4Ortho = function (out, ...args) {
+    if (args[6] == null) args[6] = _ndcZ;
+    _mat4Ortho(_rawMat4(out), ...args);
+    return out;
+  };
+
   /** Model matrix (local → world). */
   p5.Renderer3D.prototype.mat4Model = function (out) {
     const buf = _rawMat4(out), s = _modelMat4(this);

src/panel.js

@@ -31,7 +31,7 @@ import {
   mapLocation as coreMapLocation,
   mat4Mul, mat4Invert,
 } from '@nakednous/tree';
-import { registerPlayer, unregisterPlayer } from './track.js';
+import { registerPlayer } from './track.js';
 import { CameraTrack } from '@nakednous/tree';
 
 // ── Module-level scratch (allocated once at import time) ──────────────────────