@faicad/faijs-fcstd 0.17.0

package/dist/placement.js

@@ -0,0 +1,117 @@
+/**
+ * Extract a Placement from a PropertyPlacement element (or missing → identity).
+ *
+ * @param prop - the Placement property (App::PropertyPlacement) or undefined.
+ * @returns the parsed placement; identity when `prop` is missing.
+ */
+export function placementOfProp(prop) {
+    const el = prop?.children[0];
+    const a = el?.attributes ?? {};
+    return {
+        p: [Number(a['Px'] ?? 0), Number(a['Py'] ?? 0), Number(a['Pz'] ?? 0)],
+        q: [Number(a['Q0'] ?? 0), Number(a['Q1'] ?? 0), Number(a['Q2'] ?? 0), Number(a['Q3'] ?? 1)],
+    };
+}
+/**
+ * Convenience: the object's Placement property (identity when absent).
+ *
+ * @param obj - the FCStd object to read.
+ * @returns the object's placement, or identity when it has none.
+ */
+export function placementOf(obj) {
+    return placementOfProp(obj.properties.get('Placement'));
+}
+/**
+ * 3×3 row-major rotation matrix from a (x,y,z,w) quaternion.
+ *
+ * @param q - the quaternion in (x, y, z, w) order.
+ * @returns the 3×3 row-major rotation matrix (9 entries).
+ * @throws when the quaternion has a zero/non-finite norm.
+ */
+export function quatToMatrix(q) {
+    const [x, y, z, w] = q;
+    const n = Math.hypot(x, y, z, w);
+    if (!Number.isFinite(n) || n === 0)
+        throw new Error(`invalid quaternion norm: ${n}`);
+    const nx = x / n, ny = y / n, nz = z / n, nw = w / n;
+    const s = 2; // components are already normalized; scale factor is exactly 2
+    return [
+        1 - s * (ny * ny + nz * nz), s * (nx * ny - nw * nz), s * (nx * nz + nw * ny),
+        s * (nx * ny + nw * nz), 1 - s * (nx * nx + nz * nz), s * (ny * nz - nw * nx),
+        s * (nx * nz - nw * ny), s * (ny * nz + nw * nx), 1 - s * (nx * nx + ny * ny),
+    ];
+}
+/**
+ * Apply placement (rotate then translate) to a point.
+ *
+ * @param pl - the placement to apply.
+ * @param w - the world-space input point (mm).
+ * @returns the transformed point (mm).
+ */
+export function applyPlacement(pl, w) {
+    const m = quatToMatrix(pl.q);
+    const r = (i) => m[i * 3] * w[0] + m[i * 3 + 1] * w[1] + m[i * 3 + 2] * w[2];
+    return [r(0) + pl.p[0], r(1) + pl.p[1], r(2) + pl.p[2]];
+}
+/**
+ * Apply the inverse placement (translate back, rotate by conjugate).
+ *
+ * @param pl - the placement whose inverse is applied.
+ * @param w - the world-space input point (mm).
+ * @returns the point mapped into the placement-local frame (mm).
+ */
+export function invertApplyPlacement(pl, w) {
+    const d = [w[0] - pl.p[0], w[1] - pl.p[1], w[2] - pl.p[2]];
+    const inv = { p: [0, 0, 0], q: [-pl.q[0], -pl.q[1], -pl.q[2], pl.q[3]] };
+    return applyPlacement(inv, d);
+}
+/**
+ * M8.3 — quaternion → XYZ euler angles in DEGREES, matching the convention of
+ * `rotateBrep` (brep/brep-ops.ts): THREE.Euler(order 'XYZ'), i.e. the rotation
+ * matrix is RX·RY·RZ (column vectors; Z applied first). Pinned against THREE
+ * itself in placement.test.ts — not from memory.
+ *
+ * @param q - the quaternion in (x, y, z, w) order.
+ * @returns (x, y, z) euler angles in degrees.
+ */
+export function quatToEulerXYZDeg(q) {
+    const m = quatToMatrix(q);
+    // M = RX·RY·RZ (row-major 3×3): m[2] = +sinY, m[5] = -sinX·cosY, m[8] = cosX·cosY
+    const sy = m[2];
+    const y = Math.asin(Math.max(-1, Math.min(1, sy)));
+    if (Math.abs(sy) < 1 - 1e-9) {
+        const x = Math.atan2(-m[5], m[8]);
+        const z = Math.atan2(-m[1], m[0]);
+        return [(x * 180) / Math.PI, (y * 180) / Math.PI, (z * 180) / Math.PI];
+    }
+    // gimbal lock: Y = ±90°, X and Z are coupled — set Z = 0; x from m[3]/m[4]
+    const x = Math.atan2(m[3], m[4]);
+    return [(x * 180) / Math.PI, (y * 180) / Math.PI, 0];
+}
+/**
+ * True when the placement is (approximately) the identity — no transform needed.
+ *
+ * @param pl - the placement to test.
+ * @param eps - tolerance for both translation and quaternion components.
+ * @returns true when the placement is within `eps` of identity.
+ */
+export function isIdentityPlacement(pl, eps = 1e-9) {
+    return (Math.abs(pl.p[0]) < eps && Math.abs(pl.p[1]) < eps && Math.abs(pl.p[2]) < eps &&
+        Math.abs(pl.q[0]) < eps && Math.abs(pl.q[1]) < eps && Math.abs(pl.q[2]) < eps &&
+        Math.abs(Math.abs(pl.q[3]) - 1) < eps);
+}
+/**
+ * M8.3 — orthonormal sketch-plane basis (u, v) from the placement rotation:
+ * u = rotated X axis, v = rotated Y axis, normal = rotated Z. Points on the
+ * sketch plane (z≈0 in local coords) map to global as p·u + q·v.
+ *
+ * @param pl - the placement whose rotation defines the plane.
+ * @returns the rotated X axis (u), Y axis (v) and plane normal (n).
+ */
+export function planeBasis(pl) {
+    const m = quatToMatrix(pl.q);
+    // column i of the matrix = image of the i-th basis vector
+    const col = (i) => [m[i], m[i + 3], m[i + 6]];
+    return { u: col(0), v: col(1), n: col(2) };
+}
+//# sourceMappingURL=placement.js.map

package/dist/placement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.js","sourceRoot":"","sources":["../src/placement.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAoF;IAClH,MAAM,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,IAAI,EAAE,CAAC;IAC/B,OAAO;QACL,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;KAC5F,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAgB;IAC1C,OAAO,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,CAAmC;IAC9D,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACrF,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,+DAA+D;IAC5E,OAAO;QACL,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC7E,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC7E,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,EAAa,EAAE,CAA2B;IACvE,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAa,EAAE,CAA2B;IAC7E,MAAM,CAAC,GAA6B,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,GAAG,GAAc,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAmC;IACnE,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1B,kFAAkF;IAClF,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACjB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,2EAA2E;IAC3E,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAa,EAAE,GAAG,GAAG,IAAI;IAC3D,OAAO,CACL,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;QAC7E,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;QAC7E,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CACtC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,EAAa;IACtC,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,MAAM,GAAG,GAAG,CAAC,CAAS,EAA4B,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;IACnF,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC","sourcesContent":["/**\n * M8.1 — PropertyPlacement parsing and quaternion math.\n *\n * FCStd stores placements as `<Property name=\"Placement\"\n * type=\"App::PropertyPlacement\"><PropertyPlacement Px=\"..\" Py=\"..\" Pz=\"..\"\n * Q0=\"..\" Q1=\"..\" Q2=\"..\" Q3=\"..\"/></Property>` where (Q0,Q1,Q2,Q3) is the\n * rotation quaternion in (x,y,z,w) order — Q3 is the scalar component\n * (identity = 0,0,0,1; calibrated against FreeCAD sources and pinned by\n * placement.test.ts analytical solutions).\n *\n * AttachmentOffset uses the same nested element shape inside\n * `App::PropertyPlacementSub`-style properties.\n */\nimport type { FcstdObject } from './document.js';\n\n/**\n * A placement: translation plus rotation quaternion (x, y, z, w).\n */\nexport interface Placement {\n  /** translation (mm) */\n  p: [number, number, number];\n  /** rotation quaternion (x, y, z, w) */\n  q: [number, number, number, number];\n}\n\n/**\n * Extract a Placement from a PropertyPlacement element (or missing → identity).\n *\n * @param prop - the Placement property (App::PropertyPlacement) or undefined.\n * @returns the parsed placement; identity when `prop` is missing.\n */\nexport function placementOfProp(prop: FcstdObject['properties'] extends Map<string, infer V> ? V | undefined : never): Placement {\n  const el = prop?.children[0];\n  const a = el?.attributes ?? {};\n  return {\n    p: [Number(a['Px'] ?? 0), Number(a['Py'] ?? 0), Number(a['Pz'] ?? 0)],\n    q: [Number(a['Q0'] ?? 0), Number(a['Q1'] ?? 0), Number(a['Q2'] ?? 0), Number(a['Q3'] ?? 1)],\n  };\n}\n\n/**\n * Convenience: the object's Placement property (identity when absent).\n *\n * @param obj - the FCStd object to read.\n * @returns the object's placement, or identity when it has none.\n */\nexport function placementOf(obj: FcstdObject): Placement {\n  return placementOfProp(obj.properties.get('Placement'));\n}\n\n/**\n * 3×3 row-major rotation matrix from a (x,y,z,w) quaternion.\n *\n * @param q - the quaternion in (x, y, z, w) order.\n * @returns the 3×3 row-major rotation matrix (9 entries).\n * @throws when the quaternion has a zero/non-finite norm.\n */\nexport function quatToMatrix(q: [number, number, number, number]): number[] {\n  const [x, y, z, w] = q;\n  const n = Math.hypot(x, y, z, w);\n  if (!Number.isFinite(n) || n === 0) throw new Error(`invalid quaternion norm: ${n}`);\n  const nx = x / n, ny = y / n, nz = z / n, nw = w / n;\n  const s = 2; // components are already normalized; scale factor is exactly 2\n  return [\n    1 - s * (ny * ny + nz * nz), s * (nx * ny - nw * nz), s * (nx * nz + nw * ny),\n    s * (nx * ny + nw * nz), 1 - s * (nx * nx + nz * nz), s * (ny * nz - nw * nx),\n    s * (nx * nz - nw * ny), s * (ny * nz + nw * nx), 1 - s * (nx * nx + ny * ny),\n  ];\n}\n\n/**\n * Apply placement (rotate then translate) to a point.\n *\n * @param pl - the placement to apply.\n * @param w - the world-space input point (mm).\n * @returns the transformed point (mm).\n */\nexport function applyPlacement(pl: Placement, w: [number, number, number]): [number, number, number] {\n  const m = quatToMatrix(pl.q);\n  const r = (i: number): number => m[i * 3]! * w[0] + m[i * 3 + 1]! * w[1] + m[i * 3 + 2]! * w[2];\n  return [r(0) + pl.p[0], r(1) + pl.p[1], r(2) + pl.p[2]];\n}\n\n/**\n * Apply the inverse placement (translate back, rotate by conjugate).\n *\n * @param pl - the placement whose inverse is applied.\n * @param w - the world-space input point (mm).\n * @returns the point mapped into the placement-local frame (mm).\n */\nexport function invertApplyPlacement(pl: Placement, w: [number, number, number]): [number, number, number] {\n  const d: [number, number, number] = [w[0] - pl.p[0], w[1] - pl.p[1], w[2] - pl.p[2]];\n  const inv: Placement = { p: [0, 0, 0], q: [-pl.q[0], -pl.q[1], -pl.q[2], pl.q[3]] };\n  return applyPlacement(inv, d);\n}\n\n/**\n * M8.3 — quaternion → XYZ euler angles in DEGREES, matching the convention of\n * `rotateBrep` (brep/brep-ops.ts): THREE.Euler(order 'XYZ'), i.e. the rotation\n * matrix is RX·RY·RZ (column vectors; Z applied first). Pinned against THREE\n * itself in placement.test.ts — not from memory.\n *\n * @param q - the quaternion in (x, y, z, w) order.\n * @returns (x, y, z) euler angles in degrees.\n */\nexport function quatToEulerXYZDeg(q: [number, number, number, number]): [number, number, number] {\n  const m = quatToMatrix(q);\n  // M = RX·RY·RZ (row-major 3×3): m[2] = +sinY, m[5] = -sinX·cosY, m[8] = cosX·cosY\n  const sy = m[2]!;\n  const y = Math.asin(Math.max(-1, Math.min(1, sy)));\n  if (Math.abs(sy) < 1 - 1e-9) {\n    const x = Math.atan2(-m[5]!, m[8]!);\n    const z = Math.atan2(-m[1]!, m[0]!);\n    return [(x * 180) / Math.PI, (y * 180) / Math.PI, (z * 180) / Math.PI];\n  }\n  // gimbal lock: Y = ±90°, X and Z are coupled — set Z = 0; x from m[3]/m[4]\n  const x = Math.atan2(m[3]!, m[4]!);\n  return [(x * 180) / Math.PI, (y * 180) / Math.PI, 0];\n}\n\n/**\n * True when the placement is (approximately) the identity — no transform needed.\n *\n * @param pl - the placement to test.\n * @param eps - tolerance for both translation and quaternion components.\n * @returns true when the placement is within `eps` of identity.\n */\nexport function isIdentityPlacement(pl: Placement, eps = 1e-9): boolean {\n  return (\n    Math.abs(pl.p[0]) < eps && Math.abs(pl.p[1]) < eps && Math.abs(pl.p[2]) < eps &&\n    Math.abs(pl.q[0]) < eps && Math.abs(pl.q[1]) < eps && Math.abs(pl.q[2]) < eps &&\n    Math.abs(Math.abs(pl.q[3]) - 1) < eps\n  );\n}\n\n/**\n * M8.3 — orthonormal sketch-plane basis (u, v) from the placement rotation:\n * u = rotated X axis, v = rotated Y axis, normal = rotated Z. Points on the\n * sketch plane (z≈0 in local coords) map to global as p·u + q·v.\n *\n * @param pl - the placement whose rotation defines the plane.\n * @returns the rotated X axis (u), Y axis (v) and plane normal (n).\n */\nexport function planeBasis(pl: Placement): { u: [number, number, number]; v: [number, number, number]; n: [number, number, number] } {\n  const m = quatToMatrix(pl.q);\n  // column i of the matrix = image of the i-th basis vector\n  const col = (i: number): [number, number, number] => [m[i]!, m[i + 3]!, m[i + 6]!];\n  return { u: col(0), v: col(1), n: col(2) };\n}\n"]}

package/dist/planegcs-backend.d.ts

@@ -0,0 +1,34 @@
+import type { GcsWrapper } from '@salusoft89/planegcs';
+import { type Result } from '@faicad/faijs/api/result';
+import type { SketchGeom, SketchCon } from './sketch-parse.js';
+import type { SolveOutcome, SketchSolver } from './sketch-solver.js';
+/**
+ * Resolve the planegcs WASM binary path from the installed package.
+ *
+ * @returns the absolute path of `planegcs.wasm` inside `@salusoft89/planegcs`.
+ */
+export declare function planegcsWasmPath(): string;
+/**
+ * Instantiate the planegcs WASM solver.
+ *
+ * @returns a `SketchSolver` backed by the planegcs WASM module.
+ */
+export declare function createPlanegcsSolver(): Promise<SketchSolver>;
+/**
+ * planegcs WASM implementation of the `SketchSolver` interface (M3.2–M3.4):
+ * pushes geometry/constraints into the GCS, solves, and pulls the solved
+ * parameters back into `SketchGeom` values.
+ */
+export declare class PlanegcsSolver implements SketchSolver {
+    private wrapper;
+    constructor(wrapper: GcsWrapper);
+    solve(geoms: SketchGeom[], constraints: SketchCon[], external?: import('./sketch-solver.js').ExternalFixedSeg[]): Promise<Result<SolveOutcome, never>>;
+    private constraintToPrimitives;
+    private pullBack;
+    /** Read a point's solved coordinates from the sketch index.
+     * apply_solution() already pulled every primitive's solved values back into
+     * sketch_index (gcs_wrapper.js:104-108), so get_primitive is authoritative. */
+    private readPoint;
+    private readCircleRadius;
+}
+//# sourceMappingURL=planegcs-backend.d.ts.map

package/dist/planegcs-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planegcs-backend.d.ts","sourceRoot":"","sources":["../src/planegcs-backend.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQrE;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC,CAGlE;AAOD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,YAAY;IACrC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,UAAU;IAEjC,KAAK,CACT,KAAK,EAAE,UAAU,EAAE,EACnB,WAAW,EAAE,SAAS,EAAE,EACxB,QAAQ,CAAC,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,EAAE,GACzD,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IA8OvC,OAAO,CAAC,sBAAsB;IAyR9B,OAAO,CAAC,QAAQ;IA0EhB;;mFAE+E;IAC/E,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,gBAAgB;CAIzB"}