@faicad/faijs 0.31.1 → 0.32.2

package/dist/math3d/Vec3.js

@@ -0,0 +1,521 @@
+/**
+   * math3d/Vec3 — three.js r162 `Vector3` 的算法子集移植（可变类，与 three 逐位一致）。
+ *
+   * Ported from three.js r162 `src/math/Vector3.js` (MIT License, © 2010-2024
+   * three.js authors). 仅保留 core/extra 实际使用的方法；公式与运算顺序逐行照抄，
+   * 以保证与 three 的浮点结果逐位一致（parity 测试钉死）。**不得**顺手改写公式。
+ *
+   * 与 `api/geom-types/vecOps.ts`（compat 面 tuple 纯函数）职责分离：本类是 core
+   * 内部 three 替换用的可变向量类，不是公开 API 面的一部分。
+ */
+import { Quat } from './Quat.js';
+/** 3D vector/point (mutable), three.js `Vector3` subset. */
+export class Vec3 {
+    /** three 内部标记，供 Matrix4.setPosition / makeTranslation 的向量参数判定。 */
+    isVector3 = true;
+    /** X component. */
+    x;
+    /** Y component. */
+    y;
+    /** Z component. */
+    z;
+    /**
+     * @param x - X component.
+     * @param y - Y component.
+     * @param z - Z component.
+     */
+    constructor(x = 0, y = 0, z = 0) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    /**
+     * Set the component values.
+     * @param x - X component.
+     * @param y - Y component.
+     * @param z - Z component (kept when omitted, matching three's sprite.scale.set).
+     * @returns this
+     */
+    set(x, y, z) {
+        if (z === undefined)
+            z = this.z;
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        return this;
+    }
+    /**
+     * Set all components to the same scalar.
+     * @param scalar - value for all components.
+     * @returns this
+     */
+    setScalar(scalar) {
+        this.x = scalar;
+        this.y = scalar;
+        this.z = scalar;
+        return this;
+    }
+    /**
+     * Set the X component.
+     * @param x - X component.
+     * @returns this
+     */
+    setX(x) {
+        this.x = x;
+        return this;
+    }
+    /**
+     * Set the Y component.
+     * @param y - Y component.
+     * @returns this
+     */
+    setY(y) {
+        this.y = y;
+        return this;
+    }
+    /**
+     * Set the Z component.
+     * @param z - Z component.
+     * @returns this
+     */
+    setZ(z) {
+        this.z = z;
+        return this;
+    }
+    /**
+     * Return a new vector with the same components.
+     * @returns a new vector with the same components.
+     */
+    clone() {
+        return new Vec3(this.x, this.y, this.z);
+    }
+    /**
+     * Copy the components from another vector.
+     * @param v - source vector.
+     * @returns this
+     */
+    copy(v) {
+        this.x = v.x;
+        this.y = v.y;
+        this.z = v.z;
+        return this;
+    }
+    /**
+     * Add a vector component-wise.
+     * @param v - right operand.
+     * @returns this
+     */
+    add(v) {
+        this.x += v.x;
+        this.y += v.y;
+        this.z += v.z;
+        return this;
+    }
+    /**
+     * Add a scalar to every component.
+     * @param s - scalar.
+     * @returns this
+     */
+    addScalar(s) {
+        this.x += s;
+        this.y += s;
+        this.z += s;
+        return this;
+    }
+    /**
+     * Set this to a + b, component-wise.
+     * @param a - left operand.
+     * @param b - right operand.
+     * @returns this
+     */
+    addVectors(a, b) {
+        this.x = a.x + b.x;
+        this.y = a.y + b.y;
+        this.z = a.z + b.z;
+        return this;
+    }
+    /**
+     * Add v scaled by s, component-wise.
+     * @param v - source vector.
+     * @param s - scalar.
+     * @returns this
+     */
+    addScaledVector(v, s) {
+        this.x += v.x * s;
+        this.y += v.y * s;
+        this.z += v.z * s;
+        return this;
+    }
+    /**
+     * Subtract a vector component-wise.
+     * @param v - right operand.
+     * @returns this
+     */
+    sub(v) {
+        this.x -= v.x;
+        this.y -= v.y;
+        this.z -= v.z;
+        return this;
+    }
+    /**
+     * Subtract a scalar from every component.
+     * @param s - scalar.
+     * @returns this
+     */
+    subScalar(s) {
+        this.x -= s;
+        this.y -= s;
+        this.z -= s;
+        return this;
+    }
+    /**
+     * Set this to a - b, component-wise.
+     * @param a - left operand.
+     * @param b - right operand.
+     * @returns this
+     */
+    subVectors(a, b) {
+        this.x = a.x - b.x;
+        this.y = a.y - b.y;
+        this.z = a.z - b.z;
+        return this;
+    }
+    /**
+     * Multiply component-wise by a vector.
+     * @param v - right operand.
+     * @returns this
+     */
+    multiply(v) {
+        this.x *= v.x;
+        this.y *= v.y;
+        this.z *= v.z;
+        return this;
+    }
+    /**
+     * Multiply every component by a scalar.
+     * @param scalar - scalar factor.
+     * @returns this
+     */
+    multiplyScalar(scalar) {
+        this.x *= scalar;
+        this.y *= scalar;
+        this.z *= scalar;
+        return this;
+    }
+    /**
+     * Set this to a * b, component-wise.
+     * @param a - left operand.
+     * @param b - right operand.
+     * @returns this
+     */
+    multiplyVectors(a, b) {
+        this.x = a.x * b.x;
+        this.y = a.y * b.y;
+        this.z = a.z * b.z;
+        return this;
+    }
+    /**
+     * Rotate the vector by Euler angles (radians).
+     * @param euler - Euler angles (radians) with an order tag.
+     * @returns this
+     */
+    applyEuler(euler) {
+        return this.applyQuaternion(new Quat().setFromEuler(euler));
+    }
+    /**
+     * Rotate the vector around an axis by an angle (radians).
+     * @param axis - rotation axis (unit length assumed).
+     * @param angle - rotation angle in radians.
+     * @returns this
+     */
+    applyAxisAngle(axis, angle) {
+        return this.applyQuaternion(new Quat().setFromAxisAngle(axis, angle));
+    }
+    /**
+     * Transform the vector by a 4x4 matrix (as a point).
+     * @param m - affine 4x4 matrix (three column-major `elements` layout).
+     * @returns this
+     */
+    applyMatrix4(m) {
+        const x = this.x;
+        const y = this.y;
+        const z = this.z;
+        const e = m.elements;
+        const w = 1 / (e[3] * x + e[7] * y + e[11] * z + e[15]);
+        this.x = (e[0] * x + e[4] * y + e[8] * z + e[12]) * w;
+        this.y = (e[1] * x + e[5] * y + e[9] * z + e[13]) * w;
+        this.z = (e[2] * x + e[6] * y + e[10] * z + e[14]) * w;
+        return this;
+    }
+    /**
+     * Rotate the vector by a quaternion.
+     * @param q - unit quaternion.
+     * @returns this
+     */
+    applyQuaternion(q) {
+        const vx = this.x;
+        const vy = this.y;
+        const vz = this.z;
+        const qx = q.x;
+        const qy = q.y;
+        const qz = q.z;
+        const qw = q.w;
+        const tx = 2 * (qy * vz - qz * vy);
+        const ty = 2 * (qz * vx - qx * vz);
+        const tz = 2 * (qx * vy - qy * vx);
+        this.x = vx + qw * tx + qy * tz - qz * ty;
+        this.y = vy + qw * ty + qz * tx - qx * tz;
+        this.z = vz + qw * tz + qx * ty - qy * tx;
+        return this;
+    }
+    /**
+     * Divide component-wise by a vector.
+     * @param v - right operand.
+     * @returns this
+     */
+    divide(v) {
+        this.x /= v.x;
+        this.y /= v.y;
+        this.z /= v.z;
+        return this;
+    }
+    /**
+     * Divide every component by a scalar.
+     * @param scalar - scalar divisor.
+     * @returns this
+     */
+    divideScalar(scalar) {
+        return this.multiplyScalar(1 / scalar);
+    }
+    /**
+     * Negate every component.
+     * @returns this
+     */
+    negate() {
+        this.x = -this.x;
+        this.y = -this.y;
+        this.z = -this.z;
+        return this;
+    }
+    /**
+     * Return the dot product with another vector.
+     * @param v - right operand.
+     * @returns the dot product.
+     */
+    dot(v) {
+        return this.x * v.x + this.y * v.y + this.z * v.z;
+    }
+    /**
+     * Return the squared length.
+     * @returns the squared length.
+     */
+    lengthSq() {
+        return this.x * this.x + this.y * this.y + this.z * this.z;
+    }
+    /**
+     * Return the Euclidean length.
+     * @returns the Euclidean length.
+     */
+    length() {
+        return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z);
+    }
+    /**
+     * Scale to unit length (zero-length stays zero).
+     * @returns this
+     */
+    normalize() {
+        return this.divideScalar(this.length() || 1);
+    }
+    /**
+     * Scale to the given length.
+     * @param length - target length.
+     * @returns this
+     */
+    setLength(length) {
+        return this.normalize().multiplyScalar(length);
+    }
+    /**
+     * Interpolate towards v by t in [0, 1].
+     * @param v - target vector.
+     * @param alpha - interpolation factor.
+     * @returns this
+     */
+    lerp(v, alpha) {
+        this.x += (v.x - this.x) * alpha;
+        this.y += (v.y - this.y) * alpha;
+        this.z += (v.z - this.z) * alpha;
+        return this;
+    }
+    /**
+     * Set this to the linear interpolation of a and b.
+     * @param v1 - start vector.
+     * @param v2 - end vector.
+     * @param alpha - interpolation factor.
+     * @returns this
+     */
+    lerpVectors(v1, v2, alpha) {
+        this.x = v1.x + (v2.x - v1.x) * alpha;
+        this.y = v1.y + (v2.y - v1.y) * alpha;
+        this.z = v1.z + (v2.z - v1.z) * alpha;
+        return this;
+    }
+    /**
+     * Set this to the cross product with v.
+     * @param v - right operand.
+     * @returns this
+     */
+    cross(v) {
+        return this.crossVectors(this, v);
+    }
+    /**
+     * Set this to the cross product of a and b.
+     * @param a - left operand.
+     * @param b - right operand.
+     * @returns this
+     */
+    crossVectors(a, b) {
+        const ax = a.x;
+        const ay = a.y;
+        const az = a.z;
+        const bx = b.x;
+        const by = b.y;
+        const bz = b.z;
+        this.x = ay * bz - az * by;
+        this.y = az * bx - ax * bz;
+        this.z = ax * by - ay * bx;
+        return this;
+    }
+    /**
+     * Return the Euclidean distance to another vector.
+     * @param v - target vector.
+     * @returns the distance.
+     */
+    distanceTo(v) {
+        return Math.sqrt(this.distanceToSquared(v));
+    }
+    /**
+     * Return the squared distance to another vector.
+     * @param v - target vector.
+     * @returns the squared distance.
+     */
+    distanceToSquared(v) {
+        const dx = this.x - v.x;
+        const dy = this.y - v.y;
+        const dz = this.z - v.z;
+        return dx * dx + dy * dy + dz * dz;
+    }
+    /**
+     * Return the angle (radians) to another vector.
+     * @param v - target vector.
+     * @returns the unsigned angle in radians.
+     */
+    angleTo(v) {
+        const denominator = Math.sqrt(this.lengthSq() * v.lengthSq());
+        if (denominator === 0)
+            return Math.PI / 2;
+        const theta = this.dot(v) / denominator;
+        return Math.acos(Math.max(-1, Math.min(1, theta)));
+    }
+    /**
+     * Clamp each component to the per-component minimum with v.
+     * @param v - target vector (component-wise minimum).
+     * @returns this
+     */
+    min(v) {
+        this.x = Math.min(this.x, v.x);
+        this.y = Math.min(this.y, v.y);
+        this.z = Math.min(this.z, v.z);
+        return this;
+    }
+    /**
+     * Clamp each component to the per-component maximum with v.
+     * @param v - target vector (component-wise maximum).
+     * @returns this
+     */
+    max(v) {
+        this.x = Math.max(this.x, v.x);
+        this.y = Math.max(this.y, v.y);
+        this.z = Math.max(this.z, v.z);
+        return this;
+    }
+    /**
+     * Clamp every component into [min, max].
+     * @param minVal - lower clamp bound.
+     * @param maxVal - upper clamp bound.
+     * @returns this
+     */
+    clampScalar(minVal, maxVal) {
+        this.x = Math.max(minVal, Math.min(maxVal, this.x));
+        this.y = Math.max(minVal, Math.min(maxVal, this.y));
+        this.z = Math.max(minVal, Math.min(maxVal, this.z));
+        return this;
+    }
+    /**
+     * Set the components from the translation part of a matrix.
+     * @param m - matrix (column-major `elements`).
+     * @returns this
+     */
+    setFromMatrixPosition(m) {
+        const e = m.elements;
+        this.x = e[12];
+        this.y = e[13];
+        this.z = e[14];
+        return this;
+    }
+    /**
+     * Set the components from a matrix column.
+     * @param m - matrix (column-major `elements`).
+     * @param index - column index.
+     * @returns this
+     */
+    setFromMatrixColumn(m, index) {
+        return this.fromArray(m.elements, index * 4);
+    }
+    /**
+     * Set the components from the scale part of a matrix.
+     * @param m - matrix (column-major `elements`).
+     * @returns the column lengths as (x, y, z) scale factors.
+     */
+    setFromMatrixScale(m) {
+        const sx = this.setFromMatrixColumn(m, 0).length();
+        const sy = this.setFromMatrixColumn(m, 1).length();
+        const sz = this.setFromMatrixColumn(m, 2).length();
+        this.x = sx;
+        this.y = sy;
+        this.z = sz;
+        return this;
+    }
+    /**
+     * Load the components from an array-like.
+     * @param array - source array.
+     * @param offset - start offset.
+     * @returns this
+     */
+    fromArray(array, offset = 0) {
+        this.x = array[offset];
+        this.y = array[offset + 1];
+        this.z = array[offset + 2];
+        return this;
+    }
+    /**
+     * Write the components into an array.
+     * @param array - target array (created when omitted).
+     * @param offset - start offset.
+     * @returns the target array.
+     */
+    toArray(array = [], offset = 0) {
+        array[offset] = this.x;
+        array[offset + 1] = this.y;
+        array[offset + 2] = this.z;
+        return array;
+    }
+    /**
+     * Return true when all components are exactly equal.
+     * @param v - vector to compare with.
+     * @returns true when all components are strictly equal.
+     */
+    equals(v) {
+        return v.x === this.x && v.y === this.y && v.z === this.z;
+    }
+}
+//# sourceMappingURL=Vec3.js.map

package/dist/math3d/Vec3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vec3.js","sourceRoot":"","sources":["../../src/math3d/Vec3.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n   * math3d/Vec3 — three.js r162 `Vector3` 的算法子集移植（可变类，与 three 逐位一致）。\r\n *\r\n   * Ported from three.js r162 `src/math/Vector3.js` (MIT License, © 2010-2024\r\n   * three.js authors). 仅保留 core/extra 实际使用的方法；公式与运算顺序逐行照抄，\r\n   * 以保证与 three 的浮点结果逐位一致（parity 测试钉死）。**不得**顺手改写公式。\r\n *\r\n   * 与 `api/geom-types/vecOps.ts`（compat 面 tuple 纯函数）职责分离：本类是 core\r\n   * 内部 three 替换用的可变向量类，不是公开 API 面的一部分。\r\n */\r\n\r\nimport { Quat } from './Quat'\r\n\r\n/** 3D vector/point (mutable), three.js `Vector3` subset. */\r\nexport class Vec3 {\r\n  /** three 内部标记，供 Matrix4.setPosition / makeTranslation 的向量参数判定。 */\r\n  readonly isVector3 = true\r\n\r\n  /** X component. */\n  x: number\r\n  /** Y component. */\n  y: number\r\n  /** Z component. */\n  z: number\r\n\r\n  /**\r\n   * @param x - X component.\r\n   * @param y - Y component.\r\n   * @param z - Z component.\r\n   */\r\n  constructor(x = 0, y = 0, z = 0) {\r\n    this.x = x\r\n    this.y = y\r\n    this.z = z\r\n  }\r\n\r\n  /**\r\n   * Set the component values.\n   * @param x - X component.\r\n   * @param y - Y component.\r\n   * @param z - Z component (kept when omitted, matching three's sprite.scale.set).\r\n   * @returns this\r\n   */\r\n  set(x: number, y: number, z?: number): this {\r\n    if (z === undefined) z = this.z\r\n    this.x = x\r\n    this.y = y\r\n    this.z = z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set all components to the same scalar.\n   * @param scalar - value for all components.\r\n   * @returns this\r\n   */\r\n  setScalar(scalar: number): this {\r\n    this.x = scalar\r\n    this.y = scalar\r\n    this.z = scalar\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set the X component.\n   * @param x - X component.\r\n   * @returns this\r\n   */\r\n  setX(x: number): this {\r\n    this.x = x\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set the Y component.\n   * @param y - Y component.\r\n   * @returns this\r\n   */\r\n  setY(y: number): this {\r\n    this.y = y\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set the Z component.\n   * @param z - Z component.\r\n   * @returns this\r\n   */\r\n  setZ(z: number): this {\r\n    this.z = z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Return a new vector with the same components.\n   * @returns a new vector with the same components.\r\n   */\r\n  clone(): Vec3 {\r\n    return new Vec3(this.x, this.y, this.z)\r\n  }\r\n\r\n  /**\r\n   * Copy the components from another vector.\n   * @param v - source vector.\r\n   * @returns this\r\n   */\r\n  copy(v: Vec3): this {\r\n    this.x = v.x\r\n    this.y = v.y\r\n    this.z = v.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Add a vector component-wise.\n   * @param v - right operand.\r\n   * @returns this\r\n   */\r\n  add(v: Vec3): this {\r\n    this.x += v.x\r\n    this.y += v.y\r\n    this.z += v.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Add a scalar to every component.\n   * @param s - scalar.\r\n   * @returns this\r\n   */\r\n  addScalar(s: number): this {\r\n    this.x += s\r\n    this.y += s\r\n    this.z += s\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set this to a + b, component-wise.\n   * @param a - left operand.\r\n   * @param b - right operand.\r\n   * @returns this\r\n   */\r\n  addVectors(a: Vec3, b: Vec3): this {\r\n    this.x = a.x + b.x\r\n    this.y = a.y + b.y\r\n    this.z = a.z + b.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Add v scaled by s, component-wise.\n   * @param v - source vector.\r\n   * @param s - scalar.\r\n   * @returns this\r\n   */\r\n  addScaledVector(v: Vec3, s: number): this {\r\n    this.x += v.x * s\r\n    this.y += v.y * s\r\n    this.z += v.z * s\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Subtract a vector component-wise.\n   * @param v - right operand.\r\n   * @returns this\r\n   */\r\n  sub(v: Vec3): this {\r\n    this.x -= v.x\r\n    this.y -= v.y\r\n    this.z -= v.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Subtract a scalar from every component.\n   * @param s - scalar.\r\n   * @returns this\r\n   */\r\n  subScalar(s: number): this {\r\n    this.x -= s\r\n    this.y -= s\r\n    this.z -= s\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set this to a - b, component-wise.\n   * @param a - left operand.\r\n   * @param b - right operand.\r\n   * @returns this\r\n   */\r\n  subVectors(a: Vec3, b: Vec3): this {\r\n    this.x = a.x - b.x\r\n    this.y = a.y - b.y\r\n    this.z = a.z - b.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Multiply component-wise by a vector.\n   * @param v - right operand.\r\n   * @returns this\r\n   */\r\n  multiply(v: Vec3): this {\r\n    this.x *= v.x\r\n    this.y *= v.y\r\n    this.z *= v.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Multiply every component by a scalar.\n   * @param scalar - scalar factor.\r\n   * @returns this\r\n   */\r\n  multiplyScalar(scalar: number): this {\r\n    this.x *= scalar\r\n    this.y *= scalar\r\n    this.z *= scalar\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set this to a * b, component-wise.\n   * @param a - left operand.\r\n   * @param b - right operand.\r\n   * @returns this\r\n   */\r\n  multiplyVectors(a: Vec3, b: Vec3): this {\r\n    this.x = a.x * b.x\r\n    this.y = a.y * b.y\r\n    this.z = a.z * b.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Rotate the vector by Euler angles (radians).\n   * @param euler - Euler angles (radians) with an order tag.\r\n   * @returns this\r\n   */\r\n  applyEuler(euler: { x: number; y: number; z: number; order: string }): this {\r\n    return this.applyQuaternion(new Quat().setFromEuler(euler))\r\n  }\r\n\r\n  /**\r\n   * Rotate the vector around an axis by an angle (radians).\n   * @param axis - rotation axis (unit length assumed).\r\n   * @param angle - rotation angle in radians.\r\n   * @returns this\r\n   */\r\n  applyAxisAngle(axis: Vec3, angle: number): this {\r\n    return this.applyQuaternion(new Quat().setFromAxisAngle(axis, angle))\r\n  }\r\n\r\n  /**\r\n   * Transform the vector by a 4x4 matrix (as a point).\n   * @param m - affine 4x4 matrix (three column-major `elements` layout).\r\n   * @returns this\r\n   */\r\n  applyMatrix4(m: { elements: number[] }): this {\r\n    const x = this.x\r\n    const y = this.y\r\n    const z = this.z\r\n    const e = m.elements\r\n    const w = 1 / (e[3] * x + e[7] * y + e[11] * z + e[15])\r\n    this.x = (e[0] * x + e[4] * y + e[8] * z + e[12]) * w\r\n    this.y = (e[1] * x + e[5] * y + e[9] * z + e[13]) * w\r\n    this.z = (e[2] * x + e[6] * y + e[10] * z + e[14]) * w\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Rotate the vector by a quaternion.\n   * @param q - unit quaternion.\r\n   * @returns this\r\n   */\r\n  applyQuaternion(q: { x: number; y: number; z: number; w: number }): this {\r\n    const vx = this.x\r\n    const vy = this.y\r\n    const vz = this.z\r\n    const qx = q.x\r\n    const qy = q.y\r\n    const qz = q.z\r\n    const qw = q.w\r\n    const tx = 2 * (qy * vz - qz * vy)\r\n    const ty = 2 * (qz * vx - qx * vz)\r\n    const tz = 2 * (qx * vy - qy * vx)\r\n    this.x = vx + qw * tx + qy * tz - qz * ty\r\n    this.y = vy + qw * ty + qz * tx - qx * tz\r\n    this.z = vz + qw * tz + qx * ty - qy * tx\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Divide component-wise by a vector.\n   * @param v - right operand.\r\n   * @returns this\r\n   */\r\n  divide(v: Vec3): this {\r\n    this.x /= v.x\r\n    this.y /= v.y\r\n    this.z /= v.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Divide every component by a scalar.\n   * @param scalar - scalar divisor.\r\n   * @returns this\r\n   */\r\n  divideScalar(scalar: number): this {\r\n    return this.multiplyScalar(1 / scalar)\r\n  }\r\n\r\n  /**\r\n   * Negate every component.\n   * @returns this\r\n   */\r\n  negate(): this {\r\n    this.x = -this.x\r\n    this.y = -this.y\r\n    this.z = -this.z\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Return the dot product with another vector.\n   * @param v - right operand.\r\n   * @returns the dot product.\r\n   */\r\n  dot(v: Vec3): number {\r\n    return this.x * v.x + this.y * v.y + this.z * v.z\r\n  }\r\n\r\n  /**\r\n   * Return the squared length.\n   * @returns the squared length.\r\n   */\r\n  lengthSq(): number {\r\n    return this.x * this.x + this.y * this.y + this.z * this.z\r\n  }\r\n\r\n  /**\r\n   * Return the Euclidean length.\n   * @returns the Euclidean length.\r\n   */\r\n  length(): number {\r\n    return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z)\r\n  }\r\n\r\n  /**\r\n   * Scale to unit length (zero-length stays zero).\n   * @returns this\r\n   */\r\n  normalize(): this {\r\n    return this.divideScalar(this.length() || 1)\r\n  }\r\n\r\n  /**\r\n   * Scale to the given length.\n   * @param length - target length.\r\n   * @returns this\r\n   */\r\n  setLength(length: number): this {\r\n    return this.normalize().multiplyScalar(length)\r\n  }\r\n\r\n  /**\r\n   * Interpolate towards v by t in [0, 1].\n   * @param v - target vector.\r\n   * @param alpha - interpolation factor.\r\n   * @returns this\r\n   */\r\n  lerp(v: Vec3, alpha: number): this {\r\n    this.x += (v.x - this.x) * alpha\r\n    this.y += (v.y - this.y) * alpha\r\n    this.z += (v.z - this.z) * alpha\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set this to the linear interpolation of a and b.\n   * @param v1 - start vector.\r\n   * @param v2 - end vector.\r\n   * @param alpha - interpolation factor.\r\n   * @returns this\r\n   */\r\n  lerpVectors(v1: Vec3, v2: Vec3, alpha: number): this {\r\n    this.x = v1.x + (v2.x - v1.x) * alpha\r\n    this.y = v1.y + (v2.y - v1.y) * alpha\r\n    this.z = v1.z + (v2.z - v1.z) * alpha\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set this to the cross product with v.\n   * @param v - right operand.\r\n   * @returns this\r\n   */\r\n  cross(v: Vec3): this {\r\n    return this.crossVectors(this, v)\r\n  }\r\n\r\n  /**\r\n   * Set this to the cross product of a and b.\n   * @param a - left operand.\r\n   * @param b - right operand.\r\n   * @returns this\r\n   */\r\n  crossVectors(a: Vec3, b: Vec3): this {\r\n    const ax = a.x\r\n    const ay = a.y\r\n    const az = a.z\r\n    const bx = b.x\r\n    const by = b.y\r\n    const bz = b.z\r\n    this.x = ay * bz - az * by\r\n    this.y = az * bx - ax * bz\r\n    this.z = ax * by - ay * bx\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Return the Euclidean distance to another vector.\n   * @param v - target vector.\r\n   * @returns the distance.\r\n   */\r\n  distanceTo(v: Vec3): number {\r\n    return Math.sqrt(this.distanceToSquared(v))\r\n  }\r\n\r\n  /**\r\n   * Return the squared distance to another vector.\n   * @param v - target vector.\r\n   * @returns the squared distance.\r\n   */\r\n  distanceToSquared(v: Vec3): number {\r\n    const dx = this.x - v.x\r\n    const dy = this.y - v.y\r\n    const dz = this.z - v.z\r\n    return dx * dx + dy * dy + dz * dz\r\n  }\r\n\r\n  /**\r\n   * Return the angle (radians) to another vector.\n   * @param v - target vector.\r\n   * @returns the unsigned angle in radians.\r\n   */\r\n  angleTo(v: Vec3): number {\r\n    const denominator = Math.sqrt(this.lengthSq() * v.lengthSq())\r\n    if (denominator === 0) return Math.PI / 2\r\n    const theta = this.dot(v) / denominator\r\n    return Math.acos(Math.max(-1, Math.min(1, theta)))\r\n  }\r\n\r\n  /**\r\n   * Clamp each component to the per-component minimum with v.\n   * @param v - target vector (component-wise minimum).\r\n   * @returns this\r\n   */\r\n  min(v: Vec3): this {\r\n    this.x = Math.min(this.x, v.x)\r\n    this.y = Math.min(this.y, v.y)\r\n    this.z = Math.min(this.z, v.z)\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Clamp each component to the per-component maximum with v.\n   * @param v - target vector (component-wise maximum).\r\n   * @returns this\r\n   */\r\n  max(v: Vec3): this {\r\n    this.x = Math.max(this.x, v.x)\r\n    this.y = Math.max(this.y, v.y)\r\n    this.z = Math.max(this.z, v.z)\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Clamp every component into [min, max].\n   * @param minVal - lower clamp bound.\r\n   * @param maxVal - upper clamp bound.\r\n   * @returns this\r\n   */\r\n  clampScalar(minVal: number, maxVal: number): this {\r\n    this.x = Math.max(minVal, Math.min(maxVal, this.x))\r\n    this.y = Math.max(minVal, Math.min(maxVal, this.y))\r\n    this.z = Math.max(minVal, Math.min(maxVal, this.z))\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set the components from the translation part of a matrix.\n   * @param m - matrix (column-major `elements`).\r\n   * @returns this\r\n   */\r\n  setFromMatrixPosition(m: { elements: number[] }): this {\r\n    const e = m.elements\r\n    this.x = e[12]\r\n    this.y = e[13]\r\n    this.z = e[14]\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Set the components from a matrix column.\n   * @param m - matrix (column-major `elements`).\r\n   * @param index - column index.\r\n   * @returns this\r\n   */\r\n  setFromMatrixColumn(m: { elements: number[] }, index: number): this {\r\n    return this.fromArray(m.elements, index * 4)\r\n  }\r\n\r\n  /**\r\n   * Set the components from the scale part of a matrix.\n   * @param m - matrix (column-major `elements`).\r\n   * @returns the column lengths as (x, y, z) scale factors.\r\n   */\r\n  setFromMatrixScale(m: { elements: number[] }): this {\r\n    const sx = this.setFromMatrixColumn(m, 0).length()\r\n    const sy = this.setFromMatrixColumn(m, 1).length()\r\n    const sz = this.setFromMatrixColumn(m, 2).length()\r\n    this.x = sx\r\n    this.y = sy\r\n    this.z = sz\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Load the components from an array-like.\n   * @param array - source array.\r\n   * @param offset - start offset.\r\n   * @returns this\r\n   */\r\n  fromArray(array: ArrayLike<number>, offset = 0): this {\r\n    this.x = array[offset]\r\n    this.y = array[offset + 1]\r\n    this.z = array[offset + 2]\r\n    return this\r\n  }\r\n\r\n  /**\r\n   * Write the components into an array.\n   * @param array - target array (created when omitted).\r\n   * @param offset - start offset.\r\n   * @returns the target array.\r\n   */\r\n  toArray(array: number[] = [], offset = 0): number[] {\r\n    array[offset] = this.x\r\n    array[offset + 1] = this.y\r\n    array[offset + 2] = this.z\r\n    return array\r\n  }\r\n\r\n  /**\r\n   * Return true when all components are exactly equal.\n   * @param v - vector to compare with.\r\n   * @returns true when all components are strictly equal.\r\n   */\r\n  equals(v: Vec3): boolean {\r\n    return v.x === this.x && v.y === this.y && v.z === this.z\r\n  }\r\n}"]}

package/dist/math3d/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * math3d — three.js math 子集的零依赖移植层（L0 数学层）。
+ *
+ * 用途：替换 core / `@faicad/faijs-extra` 对 three.js `Vector2` / `Vector3` /
+ * `Matrix4` / `Quaternion` / `Euler` / `Plane` / `Box3` 的依赖。所有类的公式与
+ * 运算顺序逐行移植自 three r162（MIT License, © 2010-2024 three.js authors），
+ * 由 `test/math3d/three-parity.test.ts` 逐位对照钉死。
+ *
+ * 与 `api/geom-types/vecOps.ts`（compat 面 tuple 纯函数，面向库开发者）职责分离：
+ * 本层是 core 内部的 three 替换，不进入包级公开 API 面。
+ */
+export { Vec3 } from './Vec3.js';
+export { Vec2 } from './Vec2.js';
+export { Quat } from './Quat.js';
+export { Mat4, type MatrixLike } from './Mat4.js';
+export { Euler, type EulerOrder } from './Euler.js';
+export { Plane } from './Plane.js';
+export { Box3 } from './Box3.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/math3d/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/math3d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA"}

package/dist/math3d/index.js

@@ -0,0 +1,19 @@
+/**
+ * math3d — three.js math 子集的零依赖移植层（L0 数学层）。
+ *
+ * 用途：替换 core / `@faicad/faijs-extra` 对 three.js `Vector2` / `Vector3` /
+ * `Matrix4` / `Quaternion` / `Euler` / `Plane` / `Box3` 的依赖。所有类的公式与
+ * 运算顺序逐行移植自 three r162（MIT License, © 2010-2024 three.js authors），
+ * 由 `test/math3d/three-parity.test.ts` 逐位对照钉死。
+ *
+ * 与 `api/geom-types/vecOps.ts`（compat 面 tuple 纯函数，面向库开发者）职责分离：
+ * 本层是 core 内部的 three 替换，不进入包级公开 API 面。
+ */
+export { Vec3 } from './Vec3.js';
+export { Vec2 } from './Vec2.js';
+export { Quat } from './Quat.js';
+export { Mat4 } from './Mat4.js';
+export { Euler } from './Euler.js';
+export { Plane } from './Plane.js';
+export { Box3 } from './Box3.js';
+//# sourceMappingURL=index.js.map

package/dist/math3d/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/math3d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,IAAI,EAAmB,MAAM,QAAQ,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAmB,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA","sourcesContent":["/**\r\n * math3d — three.js math 子集的零依赖移植层（L0 数学层）。\r\n *\r\n * 用途：替换 core / `@faicad/faijs-extra` 对 three.js `Vector2` / `Vector3` /\r\n * `Matrix4` / `Quaternion` / `Euler` / `Plane` / `Box3` 的依赖。所有类的公式与\r\n * 运算顺序逐行移植自 three r162（MIT License, © 2010-2024 three.js authors），\r\n * 由 `test/math3d/three-parity.test.ts` 逐位对照钉死。\r\n *\r\n * 与 `api/geom-types/vecOps.ts`（compat 面 tuple 纯函数，面向库开发者）职责分离：\r\n * 本层是 core 内部的 three 替换，不进入包级公开 API 面。\r\n */\r\n\r\nexport { Vec3 } from './Vec3'\r\nexport { Vec2 } from './Vec2'\r\nexport { Quat } from './Quat'\r\nexport { Mat4, type MatrixLike } from './Mat4'\r\nexport { Euler, type EulerOrder } from './Euler'\r\nexport { Plane } from './Plane'\r\nexport { Box3 } from './Box3'"]}

package/dist/mesh/decoration-provider.d.ts

@@ -12,7 +12,7 @@
  * (OCCT `textToSolid` / `svgToSolid`, zero three); only the **mesh** path needs
  * a provider, and it reports a precise error instead of failing obscurely.
  */
-import type * as THREE from 'three';
+import type { Shape } from './types.js';
 /** Decoration inputs `cad.engrave` passes to the provider. */
 export interface EngraveDecorationParams {
     /** Text to engrave (mutually exclusive with `svg`). */
@@ -34,7 +34,7 @@ export interface EngraveDecorationParams {
  * Produces the decoration geometry (local space, `+Z` = extrusion direction) for
  * `cad.engrave`'s mesh path.
  */
-export type EngraveDecorationProvider = (params: EngraveDecorationParams) => Promise<THREE.BufferGeometry>;
+export type EngraveDecorationProvider = (params: EngraveDecorationParams) => Promise<Shape>;
 /**
  * Install (or clear, with `null`) the mesh-decoration provider.
  * @param next - the provider, or null to uninstall.

package/dist/mesh/decoration-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decoration-provider.d.ts","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;AAIlC;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAEzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,GAAG,IAAI,CAE/E"}
+{"version":3,"file":"decoration-provider.d.ts","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,KAAK,CAAC,CAAA;AAInB;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAEzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,GAAG,IAAI,CAE/E"}

package/dist/mesh/decoration-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"decoration-provider.js","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AA0CA,IAAI,QAAQ,GAAqC,IAAI,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAsC;IACjF,QAAQ,GAAG,IAAI,CAAA;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,QAAQ,CAAA;AACjB,CAAC","sourcesContent":["/**\n * decoration-provider — host-injectable text/SVG decoration geometry.\n *\n * The `cad.engrave` op is a platform op (plan §4.2 C) but its decoration input\n * is text or SVG, whose mesh geometry is produced by three's non-basic chain\n * (`Shape` / `ExtrudeGeometry` / `SVGLoader`). That chain now lives in\n * `@faicad/faijs-extra`, so core asks the host for the decoration geometry\n * instead of importing it — the same capability-injection shape as\n * `setFontLoader` / `setKnurlTextureLoader`.\n *\n * With no provider installed, `cad.engrave` still works on its BREP path\n * (OCCT `textToSolid` / `svgToSolid`, zero three); only the **mesh** path needs\n * a provider, and it reports a precise error instead of failing obscurely.\n */\nimport type * as THREE from 'three'\n\n/** Decoration inputs `cad.engrave` passes to the provider. */\nexport interface EngraveDecorationParams {\n  /** Text to engrave (mutually exclusive with `svg`). */\n  text?: string\n  /** Text size in mm. */\n  textSize?: number\n  /** SVG source text (mutually exclusive with `text`). */\n  svg?: string\n  /** SVG long-side target size in mm. */\n  svgSize?: number\n  /** SVG logical width, used for the scale factor. */\n  svgNaturalWidth?: number\n  /** SVG logical height, used for the scale factor. */\n  svgNaturalHeight?: number\n  /** Extrusion depth in mm. */\n  depth: number\n}\n\n/**\n * Produces the decoration geometry (local space, `+Z` = extrusion direction) for\n * `cad.engrave`'s mesh path.\n */\nexport type EngraveDecorationProvider = (\n  params: EngraveDecorationParams,\n) => Promise<THREE.BufferGeometry>\n\nlet provider: EngraveDecorationProvider | null = null\n\n/**\n * Install (or clear, with `null`) the mesh-decoration provider.\n * @param next - the provider, or null to uninstall.\n */\nexport function setEngraveDecorationProvider(next: EngraveDecorationProvider | null): void {\n  provider = next\n}\n\n/**\n * Read the installed mesh-decoration provider.\n *\n * `cad.engrave`'s mesh path calls this; a null result means the host installed\n * no provider and the op reports the precise \"install a provider\" error rather\n * than failing obscurely.\n *\n * @returns the installed mesh-decoration provider, or null when none is set.\n */\nexport function getEngraveDecorationProvider(): EngraveDecorationProvider | null {\n  return provider\n}\n"]}
+{"version":3,"file":"decoration-provider.js","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AA0CA,IAAI,QAAQ,GAAqC,IAAI,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAsC;IACjF,QAAQ,GAAG,IAAI,CAAA;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,QAAQ,CAAA;AACjB,CAAC","sourcesContent":["/**\n * decoration-provider — host-injectable text/SVG decoration geometry.\n *\n * The `cad.engrave` op is a platform op (plan §4.2 C) but its decoration input\n * is text or SVG, whose mesh geometry is produced by three's non-basic chain\n * (`Shape` / `ExtrudeGeometry` / `SVGLoader`). That chain now lives in\n * `@faicad/faijs-extra`, so core asks the host for the decoration geometry\n * instead of importing it — the same capability-injection shape as\n * `setFontLoader` / `setKnurlTextureLoader`.\n *\n * With no provider installed, `cad.engrave` still works on its BREP path\n * (OCCT `textToSolid` / `svgToSolid`, zero three); only the **mesh** path needs\n * a provider, and it reports a precise error instead of failing obscurely.\n */\nimport type { Shape } from './types'\n\n/** Decoration inputs `cad.engrave` passes to the provider. */\nexport interface EngraveDecorationParams {\n  /** Text to engrave (mutually exclusive with `svg`). */\n  text?: string\n  /** Text size in mm. */\n  textSize?: number\n  /** SVG source text (mutually exclusive with `text`). */\n  svg?: string\n  /** SVG long-side target size in mm. */\n  svgSize?: number\n  /** SVG logical width, used for the scale factor. */\n  svgNaturalWidth?: number\n  /** SVG logical height, used for the scale factor. */\n  svgNaturalHeight?: number\n  /** Extrusion depth in mm. */\n  depth: number\n}\n\n/**\n * Produces the decoration geometry (local space, `+Z` = extrusion direction) for\n * `cad.engrave`'s mesh path.\n */\nexport type EngraveDecorationProvider = (\n  params: EngraveDecorationParams,\n) => Promise<Shape>\n\nlet provider: EngraveDecorationProvider | null = null\n\n/**\n * Install (or clear, with `null`) the mesh-decoration provider.\n * @param next - the provider, or null to uninstall.\n */\nexport function setEngraveDecorationProvider(next: EngraveDecorationProvider | null): void {\n  provider = next\n}\n\n/**\n * Read the installed mesh-decoration provider.\n *\n * `cad.engrave`'s mesh path calls this; a null result means the host installed\n * no provider and the op reports the precise \"install a provider\" error rather\n * than failing obscurely.\n *\n * @returns the installed mesh-decoration provider, or null when none is set.\n */\nexport function getEngraveDecorationProvider(): EngraveDecorationProvider | null {\n  return provider\n}\n"]}

package/dist/mesh/engrave.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engrave.d.ts","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEhE;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAyDjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA8E7E"}
+{"version":3,"file":"engrave.d.ts","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEhE;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CA0DjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA4E7E"}