@expofp/renderer 3.37.1 → 3.39.0

package/dist/utils/logging.js

@@ -3,20 +3,28 @@ import createLog from 'debug';
 import { isLayerDefs } from '../types/guards';
 const rootNamespace = 'efp:renderer';
 /**
- * Creates a logger with the given namespace.
- * @param namespace - The namespace to use for the logger.
- * @returns A logger with the given namespace.
+ * Creates a logger for one namespace, nested under the root namespace.
+ *
+ * Each level prints only if you enable its namespace, for example with
+ * `debug.enable('efp:renderer:*')`.
+ * @param namespace - The namespace to nest under the root namespace.
+ * @returns A logger with four levels, all under that namespace.
  */
 export function createLogger(namespace) {
     const fullNamespace = namespace ? `${rootNamespace}:${namespace}` : rootNamespace;
     const info = createLog(fullNamespace);
-    info.log = console.info.bind(console);
+    // Each wrapper reads the console method at call time, not at setup time. A plain
+    // `console.warn.bind(console)` freezes the method the console object held at that
+    // moment. A test can later replace `console.warn`, for example with
+    // `vi.spyOn(console, 'warn')`. The frozen copy still calls the old method, so the
+    // spy never sees the call.
+    info.log = (...args) => console.info(...args);
     const debug = info.extend('debug');
-    debug.log = console.debug.bind(console);
+    debug.log = (...args) => console.debug(...args);
     const warn = info.extend('warn');
-    warn.log = console.warn.bind(console);
+    warn.log = (...args) => console.warn(...args);
     const error = info.extend('error');
-    error.log = console.error.bind(console);
+    error.log = (...args) => console.error(...args);
     return {
         debug,
         info,

package/dist/utils/math.d.ts

@@ -1,3 +1,4 @@
+import { type Matrix4 } from 'three';
 /**
  * Holds a value inside an inclusive range.
  *
@@ -21,4 +22,14 @@ export declare function clamp(value: number, min: number, max: number): number;
  * @returns The value in `[0, modulus)`.
  */
 export declare function euclideanModulo(value: number, modulus: number): number;
+/**
+ * The length one unit along an axis is drawn at, which is the scale the matrix applies there.
+ *
+ * Reads the elements directly rather than through a vector, because picking calls this per instance
+ * per test and a scratch vector would be one more shared object to reason about.
+ * @param matrix - The matrix to measure.
+ * @param axis - Which axis. `0` is x, `1` is y and `2` is z.
+ * @returns The transformed axis's length.
+ */
+export declare function axisLength(matrix: Matrix4, axis: number): number;
 //# sourceMappingURL=math.d.ts.map

package/dist/utils/math.js

@@ -25,3 +25,17 @@ export function clamp(value, min, max) {
 export function euclideanModulo(value, modulus) {
     return ((value % modulus) + modulus) % modulus;
 }
+/**
+ * The length one unit along an axis is drawn at, which is the scale the matrix applies there.
+ *
+ * Reads the elements directly rather than through a vector, because picking calls this per instance
+ * per test and a scratch vector would be one more shared object to reason about.
+ * @param matrix - The matrix to measure.
+ * @param axis - Which axis. `0` is x, `1` is y and `2` is z.
+ * @returns The transformed axis's length.
+ */
+export function axisLength(matrix, axis) {
+    const elements = matrix.elements;
+    const at = axis * 4;
+    return Math.hypot(elements[at], elements[at + 1], elements[at + 2]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expofp/renderer",
-  "version": "3.37.1",
+  "version": "3.39.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/expofp/efp-app.git",
@@ -42,7 +42,7 @@
     "troika-three-text": "^0.52.5",
     "tslib": "^2.3.0",
     "webgl-memory": "^1.1.3",
-    "@expofp/geometry": "3.37.1"
+    "@expofp/geometry": "3.39.0"
   },
   "devDependencies": {
     "@react-three/test-renderer": "^9.1.0",