// matrix.js —— 2D 仿射矩阵原语（纯函数，零依赖，最易测）。
// 移植自原型 evaluator.js 的 matFromTRS / matMul / decompose。
//
// 约定：point' = M·point，M = [[a,c,tx],[b,d,ty],[0,0,1]]。
// 部件均为均匀缩放、无切变（skew），所以 decompose 可忽略 skew 安全还原。

const DEG = Math.PI / 180

/** @type {import('./types.js').BoneOffset} 默认增量：无旋转 / 无位移 / 缩放 1。 */
export const PROP_DEFAULT = { drot: 0, dx: 0, dy: 0, dscale: 1 }

/**
 * 度 → 弧度。
 * @param {number} deg
 * @returns {number}
 */
export function degToRad(deg) {
  return deg * DEG
}

/**
 * 线性插值。
 * @param {number} a
 * @param {number} b
 * @param {number} t
 * @returns {number}
 */
export function lerp(a, b, t) {
  return a + (b - a) * t
}

/**
 * 由平移 / 旋转（弧度）/ 均匀缩放构造仿射矩阵。
 * @param {number} x
 * @param {number} y
 * @param {number} rotRad   旋转（弧度，顺时针为正，与屏幕坐标系一致）
 * @param {number} scale    均匀缩放
 * @returns {import('./types.js').Mat2D}
 */
export function fromTRS(x, y, rotRad, scale) {
  const cos = Math.cos(rotRad)
  const sin = Math.sin(rotRad)
  return {
    a: cos * scale,
    b: sin * scale,
    c: -sin * scale,
    d: cos * scale,
    tx: x,
    ty: y,
  }
}

/**
 * 矩阵相乘（父 × 子 = 子的世界变换；满足结合律）。
 * @param {import('./types.js').Mat2D} A
 * @param {import('./types.js').Mat2D} B
 * @returns {import('./types.js').Mat2D}
 */
export function mul(A, B) {
  return {
    a: A.a * B.a + A.c * B.b,
    b: A.b * B.a + A.d * B.b,
    c: A.a * B.c + A.c * B.d,
    d: A.b * B.c + A.d * B.d,
    tx: A.a * B.tx + A.c * B.ty + A.tx,
    ty: A.b * B.tx + A.d * B.ty + A.ty,
  }
}

/**
 * 把矩阵分解回 {x,y,rotation,scaleX,scaleY}（忽略 skew）。
 * 满足 decompose(fromTRS(x,y,r,s)) 还原（浮点容差内）。
 * @param {import('./types.js').Mat2D} M
 * @returns {{x:number,y:number,rotation:number,scaleX:number,scaleY:number}}
 */
export function decompose(M) {
  const scaleX = Math.hypot(M.a, M.b)
  const scaleY = Math.hypot(M.c, M.d)
  const rotation = Math.atan2(M.b, M.a)
  return { x: M.tx, y: M.ty, rotation, scaleX, scaleY }
}

/** §3 要求的 matrix 命名空间（也单独导出各函数）。 */
export const matrix = { fromTRS, mul, decompose }