@faicad/faijs 0.13.0

package/dist/vendored/brepjs/gear/gearMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gearMath.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/gear/gearMath.ts"],"names":[],"mappings":"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"}

package/dist/vendored/brepjs/gear/gearMath.js

@@ -0,0 +1,195 @@
+import { ok, err, isErr } from '../core/result.js';
+import { validationError } from '../core/errors.js';
+export const DEFAULT_PRESSURE_ANGLE_DEG = 20;
+export const DEFAULT_CLEARANCE = 0.25;
+export const inv = (alpha) => Math.tan(alpha) - alpha;
+export function involutePoint(rb, alpha, theta0, sign) {
+    const r = rb / Math.cos(alpha);
+    const theta = theta0 + sign * (Math.tan(alpha) - alpha);
+    return [r * Math.cos(theta), r * Math.sin(theta), 0];
+}
+export function cosineSpaceFlankSamples(rb, alphaMax, theta0, count, sign) {
+    const pts = [];
+    for (let i = 0; i <= count; i++) {
+        const t = 0.5 - 0.5 * Math.cos((i / count) * Math.PI);
+        pts.push(involutePoint(rb, t * alphaMax, theta0, sign));
+    }
+    return pts;
+}
+export function adaptiveSampleCount(moduleSize) {
+    return Math.max(16, Math.round(8 * Math.sqrt(moduleSize)));
+}
+export function gearGeometry(z, moduleSize, alpha, shift, clearance, backlashHalf, isInternal) {
+    const rPitch = (z * moduleSize) / 2;
+    const rb = rPitch * Math.cos(alpha);
+    const addendum = moduleSize * (1 + shift);
+    const dedendum = moduleSize * (1 + clearance - shift);
+    const rTip = isInternal ? rPitch - moduleSize * (1 - shift) : rPitch + addendum;
+    const rRoot = isInternal ? rPitch + moduleSize * (1 + clearance + shift) : rPitch - dedendum;
+    const blAng = backlashHalf / rPitch;
+    const baseHalfToothAngle = (Math.PI / 2 + 2 * shift * Math.tan(alpha)) / z;
+    // Internal: backlash thins the space between ring teeth, equivalent to thickening the tooth.
+    const halfToothAngle = baseHalfToothAngle + (isInternal ? blAng : -blAng);
+    const rOuter = isInternal ? rRoot : rTip;
+    const alphaTip = rOuter <= rb ? 0 : Math.acos(Math.min(1, rb / rOuter));
+    return {
+        rPitch,
+        rb,
+        rTip,
+        rRoot,
+        alphaPitch: alpha,
+        halfToothAngle,
+        alphaTip,
+        toothPitch: (2 * Math.PI) / z,
+        isInternal,
+    };
+}
+/**
+ * Solve `inv(αw) = inv(α) + 2·(summedShift)·tan α / totalTeeth` by bisection.
+ *
+ * For external-external mesh: summedShift = x1 + x2, totalTeeth = z1 + z2.
+ * For external-internal mesh: summedShift = xInternal − xExternal, totalTeeth = zInternal − zExternal.
+ *
+ * Returns Err for shifts that push αw outside (epsilon, π/2).
+ */
+export function solveWorkingPressureAngle(alpha, summedShift, totalTeeth) {
+    if (summedShift === 0)
+        return ok(alpha);
+    const target = inv(alpha) + (2 * summedShift * Math.tan(alpha)) / totalTeeth;
+    const epsilon = 1e-4;
+    let lo, hi;
+    if (target > inv(alpha)) {
+        lo = alpha;
+        hi = Math.PI / 2 - 1e-6;
+    }
+    else {
+        lo = epsilon;
+        hi = alpha;
+    }
+    if (target > inv(hi) || target < inv(lo)) {
+        return err(validationError('GEAR_PA_OUT_OF_RANGE', `working pressure angle out of range — target inv(αw)=${target.toFixed(4)} not in [${inv(lo).toFixed(4)}, ${inv(hi).toFixed(4)}]`, undefined, { target, invLo: inv(lo), invHi: inv(hi) }));
+    }
+    for (let i = 0; i < 50; i++) {
+        const mid = 0.5 * (lo + hi);
+        if (inv(mid) < target)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    return ok(0.5 * (lo + hi));
+}
+/** Convenience: working PA for an external-external mesh (sun-planet). */
+export function solveSunPlanetWorkingPressureAngle(alpha, xSun, xPlanet, zSun, zPlanet) {
+    return solveWorkingPressureAngle(alpha, xSun + xPlanet, zSun + zPlanet);
+}
+/** Convenience: working PA for an external-internal mesh (planet-ring). */
+export function solvePlanetRingWorkingPressureAngle(alpha, xPlanet, xRing, zPlanet, zRing) {
+    return solveWorkingPressureAngle(alpha, xRing - xPlanet, zRing - zPlanet);
+}
+export function workingCenterDistance(zs, zp, moduleSize, alpha, alphaW) {
+    return ((zs + zp) * moduleSize * Math.cos(alpha)) / (2 * Math.cos(alphaW));
+}
+export function validatePlanetary(zs, zp, n, planetShift) {
+    if (!Number.isInteger(zs) || !Number.isInteger(zp) || !Number.isInteger(n))
+        return err(validationError('GEAR_NON_INTEGER_TEETH', 'tooth counts and planet count must be integers'));
+    if (zs < 4 || zp < 4 || n < 2)
+        return err(validationError('GEAR_TEETH_TOO_FEW', 'zs ≥ 4, zp ≥ 4, N ≥ 2 required'));
+    if ((2 * zs + 2 * zp) % n !== 0)
+        return err(validationError('GEAR_ASSEMBLY', `(2·zs + 2·zp) must be divisible by N — got ${2 * zs + 2 * zp} mod ${n} = ${(2 * zs + 2 * zp) % n}`));
+    const planetTipDiameter = zp + 2 + 2 * planetShift;
+    const minClearance = (zs + zp) * Math.sin(Math.PI / n);
+    if (minClearance <= planetTipDiameter)
+        return err(validationError('GEAR_PLANET_COLLISION', `planet tips would collide: (zs+zp)·sin(π/N) = ${minClearance.toFixed(3)} ≤ planet tip = ${planetTipDiameter.toFixed(3)}`));
+    return ok(undefined);
+}
+export function externalExternalContactRatio(ra1, rb1, ra2, rb2, centerDistance, moduleSize, alpha, alphaW) {
+    const lineOfAction = Math.sqrt(Math.max(0, ra1 * ra1 - rb1 * rb1)) +
+        Math.sqrt(Math.max(0, ra2 * ra2 - rb2 * rb2)) -
+        centerDistance * Math.sin(alphaW);
+    return lineOfAction / (Math.PI * moduleSize * Math.cos(alpha));
+}
+export function externalInternalContactRatio(ra_p, rb_p, ra_r, rb_r, centerDistance, moduleSize, alpha, alphaW) {
+    const lineOfAction = Math.sqrt(Math.max(0, ra_p * ra_p - rb_p * rb_p)) -
+        Math.sqrt(Math.max(0, ra_r * ra_r - rb_r * rb_r)) +
+        centerDistance * Math.sin(alphaW);
+    return lineOfAction / (Math.PI * moduleSize * Math.cos(alpha));
+}
+export function undercutMinimumShift(z, alpha) {
+    return 1 - (z * Math.sin(alpha) * Math.sin(alpha)) / 2;
+}
+export function undercutDeficit(z, alpha, shift) {
+    return Math.max(0, undercutMinimumShift(z, alpha) - shift);
+}
+export function lewisYFactor(z) {
+    if (z < 8)
+        return 0.2;
+    return 0.485 - 2.88 / z;
+}
+export function lewisRootStress(appliedTorqueNm, moduleSize, faceWidth, z) {
+    const torqueNmm = appliedTorqueNm * 1000;
+    const Y = lewisYFactor(z);
+    if (Y <= 0 || faceWidth <= 0 || moduleSize <= 0)
+        return Infinity;
+    return (2 * torqueNmm) / (z * moduleSize * moduleSize * faceWidth * Y);
+}
+/**
+ * Dolan-Broghamer fit is for *external* spur teeth. Set `isInternal=true` on
+ * ring gears to apply Niemann's 0.85× reduction — the concave root fillet has
+ * a gentler geometric riser (matches AGMA 908-B89 trend).
+ */
+export function filletStressConcentrationFactor(z, alpha, isInternal = false) {
+    const kf20 = 1.4 + 6.5 / z;
+    const alphaDeg = (alpha * 180) / Math.PI;
+    const kf = kf20 * Math.pow(20 / alphaDeg, 0.15);
+    return isInternal ? kf * 0.85 : kf;
+}
+export function lewisRootStressCorrected(appliedTorqueNm, moduleSize, faceWidth, z, alpha, isInternal = false) {
+    return (lewisRootStress(appliedTorqueNm, moduleSize, faceWidth, z) *
+        filletStressConcentrationFactor(z, alpha, isInternal));
+}
+export function backlashHalf(totalBacklash) {
+    return totalBacklash / 2;
+}
+export function ringTeeth(zs, zp) {
+    return zs + 2 * zp;
+}
+export function evenToothPhaseOffset(z) {
+    return z % 2 === 0 ? Math.PI / z : 0;
+}
+export function planetSelfRotationAngle(orbitalAngle, zs, zp) {
+    return orbitalAngle * (1 + zs / zp) + evenToothPhaseOffset(zp);
+}
+/**
+ * Compute the rigid placement of each planet without building any solid.
+ *
+ * Pairs with one materialized planet from `makeExternalGear` to support
+ * GPU-instanced rendering: mesh once, draw N times under these transforms.
+ * Defaults match {@link PlanetaryGearParams}.
+ */
+export function planetPlacements(params = {}) {
+    const moduleSize = params.moduleSize ?? 3;
+    const sunTeeth = params.sunTeeth ?? 15;
+    const planetTeeth = params.planetTeeth ?? 12;
+    const numPlanets = params.numPlanets ?? 3;
+    const alpha = ((params.pressureAngleDeg ?? DEFAULT_PRESSURE_ANGLE_DEG) * Math.PI) / 180;
+    const sunShift = params.sunShift ?? 0;
+    const planetShift = params.planetShift ?? 0;
+    const validation = validatePlanetary(sunTeeth, planetTeeth, numPlanets, planetShift);
+    if (isErr(validation))
+        return validation;
+    const sp = solveSunPlanetWorkingPressureAngle(alpha, sunShift, planetShift, sunTeeth, planetTeeth);
+    if (isErr(sp))
+        return sp;
+    const centerDistance = workingCenterDistance(sunTeeth, planetTeeth, moduleSize, alpha, sp.value);
+    const placements = [];
+    for (let i = 0; i < numPlanets; i++) {
+        const orbital = (i * 2 * Math.PI) / numPlanets;
+        const selfRot = planetSelfRotationAngle(orbital, sunTeeth, planetTeeth);
+        placements.push({
+            rotationDeg: (selfRot * 180) / Math.PI,
+            position: [centerDistance * Math.cos(orbital), centerDistance * Math.sin(orbital), 0],
+        });
+    }
+    return ok(placements);
+}
+//# sourceMappingURL=gearMath.js.map

package/dist/vendored/brepjs/gear/gearMath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gearMath.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/gear/gearMath.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAoBtC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AAEtE,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,KAAa,EAAE,MAAc,EAAE,IAAY;IACnF,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,EAAU,EACV,QAAgB,EAChB,MAAc,EACd,KAAa,EACb,IAAY;IAEZ,MAAM,GAAG,GAAW,EAAE,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QACtD,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAkBD,MAAM,UAAU,YAAY,CAC1B,CAAS,EACT,UAAkB,EAClB,KAAa,EACb,KAAa,EACb,SAAiB,EACjB,YAAoB,EACpB,UAAmB;IAEnB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC;IAChF,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC;IAE7F,MAAM,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;IACpC,MAAM,kBAAkB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3E,6FAA6F;IAC7F,MAAM,cAAc,GAAG,kBAAkB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAE1E,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IAExE,OAAO;QACL,MAAM;QACN,EAAE;QACF,IAAI;QACJ,KAAK;QACL,UAAU,EAAE,KAAK;QACjB,cAAc;QACd,QAAQ;QACR,UAAU,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;QAC7B,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAa,EACb,WAAmB,EACnB,UAAkB;IAElB,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAExC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC;IAErB,IAAI,EAAU,EAAE,EAAU,CAAC;IAC3B,IAAI,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,EAAE,GAAG,KAAK,CAAC;QACX,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,EAAE,GAAG,OAAO,CAAC;QACb,EAAE,GAAG,KAAK,CAAC;IACb,CAAC;IAED,IAAI,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzC,OAAO,GAAG,CACR,eAAe,CACb,sBAAsB,EACtB,wDAAwD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EACjI,SAAS,EACT,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAC3C,CACF,CAAC;IACJ,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5B,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM;YAAE,EAAE,GAAG,GAAG,CAAC;;YAC3B,EAAE,GAAG,GAAG,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kCAAkC,CAChD,KAAa,EACb,IAAY,EACZ,OAAe,EACf,IAAY,EACZ,OAAe;IAEf,OAAO,yBAAyB,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mCAAmC,CACjD,KAAa,EACb,OAAe,EACf,KAAa,EACb,OAAe,EACf,KAAa;IAEb,OAAO,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,EAAU,EACV,EAAU,EACV,UAAkB,EAClB,KAAa,EACb,MAAc;IAEd,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAU,EACV,EAAU,EACV,CAAS,EACT,WAAmB;IAEnB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACxE,OAAO,GAAG,CACR,eAAe,CAAC,wBAAwB,EAAE,gDAAgD,CAAC,CAC5F,CAAC;IACJ,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3B,OAAO,GAAG,CAAC,eAAe,CAAC,oBAAoB,EAAE,gCAAgC,CAAC,CAAC,CAAC;IACtF,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;QAC7B,OAAO,GAAG,CACR,eAAe,CACb,eAAe,EACf,8CAA8C,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CACpG,CACF,CAAC;IACJ,MAAM,iBAAiB,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;IACnD,MAAM,YAAY,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACvD,IAAI,YAAY,IAAI,iBAAiB;QACnC,OAAO,GAAG,CACR,eAAe,CACb,uBAAuB,EACvB,iDAAiD,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC1H,CACF,CAAC;IACJ,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,GAAW,EACX,GAAW,EACX,GAAW,EACX,GAAW,EACX,cAAsB,EACtB,UAAkB,EAClB,KAAa,EACb,MAAc;IAEd,MAAM,YAAY,GAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAC7C,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,YAAY,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,cAAsB,EACtB,UAAkB,EAClB,KAAa,EACb,MAAc;IAEd,MAAM,YAAY,GAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QACjD,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,YAAY,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAAS,EAAE,KAAa;IAC3D,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,KAAa,EAAE,KAAa;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtB,OAAO,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,eAAuB,EACvB,UAAkB,EAClB,SAAiB,EACjB,CAAS;IAET,MAAM,SAAS,GAAG,eAAe,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,CAAS,EACT,KAAa,EACb,UAAU,GAAG,KAAK;IAElB,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IAC3B,MAAM,QAAQ,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IACzC,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,eAAuB,EACvB,UAAkB,EAClB,SAAiB,EACjB,CAAS,EACT,KAAa,EACb,UAAU,GAAG,KAAK;IAElB,OAAO,CACL,eAAe,CAAC,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1D,+BAA+B,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,aAAqB;IAChD,OAAO,aAAa,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,EAAU;IAC9C,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAAS;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,YAAoB,EAAE,EAAU,EAAE,EAAU;IAClF,OAAO,YAAY,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAoBD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAgC,EAAE;IACjE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,gBAAgB,IAAI,0BAA0B,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACxF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAEzC,MAAM,EAAE,GAAG,kCAAkC,CAC3C,KAAK,EACL,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,CACZ,CAAC;IACF,IAAI,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,cAAc,GAAG,qBAAqB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAEjG,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;QAC/C,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACxE,UAAU,CAAC,IAAI,CAAC;YACd,WAAW,EAAE,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE;YACtC,QAAQ,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;SACtF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;AACxB,CAAC","sourcesContent":["import type { Vec3 } from '../core/types.js';\nimport { type Result, ok, err, isErr } from '../core/result.js';\nimport { validationError } from '../core/errors.js';\n\nexport const DEFAULT_PRESSURE_ANGLE_DEG = 20;\nexport const DEFAULT_CLEARANCE = 0.25;\n\nexport type GearDiagnosticSeverity = 'warning' | 'info';\n\nexport type GearDiagnosticCode =\n  | 'CONTACT_RATIO_LOW_SUN_PLANET'\n  | 'CONTACT_RATIO_LOW_PLANET_RING'\n  | 'UNDERCUT_RISK'\n  | 'UNDERCUT_RISK_SUN'\n  | 'UNDERCUT_RISK_PLANET'\n  | 'LEWIS_Y_SHIFT_UNCORRECTED'\n  | 'PLANETARY_SHIFT_KINEMATIC_MISMATCH';\n\nexport interface GearDiagnostic {\n  code: GearDiagnosticCode;\n  severity: GearDiagnosticSeverity;\n  message: string;\n  context?: Record<string, number | string>;\n}\n\nexport const inv = (alpha: number): number => Math.tan(alpha) - alpha;\n\nexport function involutePoint(rb: number, alpha: number, theta0: number, sign: 1 | -1): Vec3 {\n  const r = rb / Math.cos(alpha);\n  const theta = theta0 + sign * (Math.tan(alpha) - alpha);\n  return [r * Math.cos(theta), r * Math.sin(theta), 0];\n}\n\nexport function cosineSpaceFlankSamples(\n  rb: number,\n  alphaMax: number,\n  theta0: number,\n  count: number,\n  sign: 1 | -1\n): Vec3[] {\n  const pts: Vec3[] = [];\n  for (let i = 0; i <= count; i++) {\n    const t = 0.5 - 0.5 * Math.cos((i / count) * Math.PI);\n    pts.push(involutePoint(rb, t * alphaMax, theta0, sign));\n  }\n  return pts;\n}\n\nexport function adaptiveSampleCount(moduleSize: number): number {\n  return Math.max(16, Math.round(8 * Math.sqrt(moduleSize)));\n}\n\nexport interface GearGeometry {\n  rPitch: number;\n  rb: number;\n  /** Outer radius for external, inner for internal. */\n  rTip: number;\n  /** Inner radius for external, outer for internal. */\n  rRoot: number;\n  alphaPitch: number;\n  /** Half-tooth angular width at the pitch circle, with shift and flank thinning applied. */\n  halfToothAngle: number;\n  /** Involute parameter α at the radius the flank reaches (rTip ext, rRoot int). */\n  alphaTip: number;\n  toothPitch: number;\n  isInternal: boolean;\n}\n\nexport function gearGeometry(\n  z: number,\n  moduleSize: number,\n  alpha: number,\n  shift: number,\n  clearance: number,\n  backlashHalf: number,\n  isInternal: boolean\n): GearGeometry {\n  const rPitch = (z * moduleSize) / 2;\n  const rb = rPitch * Math.cos(alpha);\n  const addendum = moduleSize * (1 + shift);\n  const dedendum = moduleSize * (1 + clearance - shift);\n  const rTip = isInternal ? rPitch - moduleSize * (1 - shift) : rPitch + addendum;\n  const rRoot = isInternal ? rPitch + moduleSize * (1 + clearance + shift) : rPitch - dedendum;\n\n  const blAng = backlashHalf / rPitch;\n  const baseHalfToothAngle = (Math.PI / 2 + 2 * shift * Math.tan(alpha)) / z;\n  // Internal: backlash thins the space between ring teeth, equivalent to thickening the tooth.\n  const halfToothAngle = baseHalfToothAngle + (isInternal ? blAng : -blAng);\n\n  const rOuter = isInternal ? rRoot : rTip;\n  const alphaTip = rOuter <= rb ? 0 : Math.acos(Math.min(1, rb / rOuter));\n\n  return {\n    rPitch,\n    rb,\n    rTip,\n    rRoot,\n    alphaPitch: alpha,\n    halfToothAngle,\n    alphaTip,\n    toothPitch: (2 * Math.PI) / z,\n    isInternal,\n  };\n}\n\n/**\n * Solve `inv(αw) = inv(α) + 2·(summedShift)·tan α / totalTeeth` by bisection.\n *\n * For external-external mesh: summedShift = x1 + x2, totalTeeth = z1 + z2.\n * For external-internal mesh: summedShift = xInternal − xExternal, totalTeeth = zInternal − zExternal.\n *\n * Returns Err for shifts that push αw outside (epsilon, π/2).\n */\nexport function solveWorkingPressureAngle(\n  alpha: number,\n  summedShift: number,\n  totalTeeth: number\n): Result<number> {\n  if (summedShift === 0) return ok(alpha);\n\n  const target = inv(alpha) + (2 * summedShift * Math.tan(alpha)) / totalTeeth;\n  const epsilon = 1e-4;\n\n  let lo: number, hi: number;\n  if (target > inv(alpha)) {\n    lo = alpha;\n    hi = Math.PI / 2 - 1e-6;\n  } else {\n    lo = epsilon;\n    hi = alpha;\n  }\n\n  if (target > inv(hi) || target < inv(lo)) {\n    return err(\n      validationError(\n        'GEAR_PA_OUT_OF_RANGE',\n        `working pressure angle out of range — target inv(αw)=${target.toFixed(4)} not in [${inv(lo).toFixed(4)}, ${inv(hi).toFixed(4)}]`,\n        undefined,\n        { target, invLo: inv(lo), invHi: inv(hi) }\n      )\n    );\n  }\n\n  for (let i = 0; i < 50; i++) {\n    const mid = 0.5 * (lo + hi);\n    if (inv(mid) < target) lo = mid;\n    else hi = mid;\n  }\n  return ok(0.5 * (lo + hi));\n}\n\n/** Convenience: working PA for an external-external mesh (sun-planet). */\nexport function solveSunPlanetWorkingPressureAngle(\n  alpha: number,\n  xSun: number,\n  xPlanet: number,\n  zSun: number,\n  zPlanet: number\n): Result<number> {\n  return solveWorkingPressureAngle(alpha, xSun + xPlanet, zSun + zPlanet);\n}\n\n/** Convenience: working PA for an external-internal mesh (planet-ring). */\nexport function solvePlanetRingWorkingPressureAngle(\n  alpha: number,\n  xPlanet: number,\n  xRing: number,\n  zPlanet: number,\n  zRing: number\n): Result<number> {\n  return solveWorkingPressureAngle(alpha, xRing - xPlanet, zRing - zPlanet);\n}\n\nexport function workingCenterDistance(\n  zs: number,\n  zp: number,\n  moduleSize: number,\n  alpha: number,\n  alphaW: number\n): number {\n  return ((zs + zp) * moduleSize * Math.cos(alpha)) / (2 * Math.cos(alphaW));\n}\n\nexport function validatePlanetary(\n  zs: number,\n  zp: number,\n  n: number,\n  planetShift: number\n): Result<void> {\n  if (!Number.isInteger(zs) || !Number.isInteger(zp) || !Number.isInteger(n))\n    return err(\n      validationError('GEAR_NON_INTEGER_TEETH', 'tooth counts and planet count must be integers')\n    );\n  if (zs < 4 || zp < 4 || n < 2)\n    return err(validationError('GEAR_TEETH_TOO_FEW', 'zs ≥ 4, zp ≥ 4, N ≥ 2 required'));\n  if ((2 * zs + 2 * zp) % n !== 0)\n    return err(\n      validationError(\n        'GEAR_ASSEMBLY',\n        `(2·zs + 2·zp) must be divisible by N — got ${2 * zs + 2 * zp} mod ${n} = ${(2 * zs + 2 * zp) % n}`\n      )\n    );\n  const planetTipDiameter = zp + 2 + 2 * planetShift;\n  const minClearance = (zs + zp) * Math.sin(Math.PI / n);\n  if (minClearance <= planetTipDiameter)\n    return err(\n      validationError(\n        'GEAR_PLANET_COLLISION',\n        `planet tips would collide: (zs+zp)·sin(π/N) = ${minClearance.toFixed(3)} ≤ planet tip = ${planetTipDiameter.toFixed(3)}`\n      )\n    );\n  return ok(undefined);\n}\n\nexport function externalExternalContactRatio(\n  ra1: number,\n  rb1: number,\n  ra2: number,\n  rb2: number,\n  centerDistance: number,\n  moduleSize: number,\n  alpha: number,\n  alphaW: number\n): number {\n  const lineOfAction =\n    Math.sqrt(Math.max(0, ra1 * ra1 - rb1 * rb1)) +\n    Math.sqrt(Math.max(0, ra2 * ra2 - rb2 * rb2)) -\n    centerDistance * Math.sin(alphaW);\n  return lineOfAction / (Math.PI * moduleSize * Math.cos(alpha));\n}\n\nexport function externalInternalContactRatio(\n  ra_p: number,\n  rb_p: number,\n  ra_r: number,\n  rb_r: number,\n  centerDistance: number,\n  moduleSize: number,\n  alpha: number,\n  alphaW: number\n): number {\n  const lineOfAction =\n    Math.sqrt(Math.max(0, ra_p * ra_p - rb_p * rb_p)) -\n    Math.sqrt(Math.max(0, ra_r * ra_r - rb_r * rb_r)) +\n    centerDistance * Math.sin(alphaW);\n  return lineOfAction / (Math.PI * moduleSize * Math.cos(alpha));\n}\n\nexport function undercutMinimumShift(z: number, alpha: number): number {\n  return 1 - (z * Math.sin(alpha) * Math.sin(alpha)) / 2;\n}\n\nexport function undercutDeficit(z: number, alpha: number, shift: number): number {\n  return Math.max(0, undercutMinimumShift(z, alpha) - shift);\n}\n\nexport function lewisYFactor(z: number): number {\n  if (z < 8) return 0.2;\n  return 0.485 - 2.88 / z;\n}\n\nexport function lewisRootStress(\n  appliedTorqueNm: number,\n  moduleSize: number,\n  faceWidth: number,\n  z: number\n): number {\n  const torqueNmm = appliedTorqueNm * 1000;\n  const Y = lewisYFactor(z);\n  if (Y <= 0 || faceWidth <= 0 || moduleSize <= 0) return Infinity;\n  return (2 * torqueNmm) / (z * moduleSize * moduleSize * faceWidth * Y);\n}\n\n/**\n * Dolan-Broghamer fit is for *external* spur teeth. Set `isInternal=true` on\n * ring gears to apply Niemann's 0.85× reduction — the concave root fillet has\n * a gentler geometric riser (matches AGMA 908-B89 trend).\n */\nexport function filletStressConcentrationFactor(\n  z: number,\n  alpha: number,\n  isInternal = false\n): number {\n  const kf20 = 1.4 + 6.5 / z;\n  const alphaDeg = (alpha * 180) / Math.PI;\n  const kf = kf20 * Math.pow(20 / alphaDeg, 0.15);\n  return isInternal ? kf * 0.85 : kf;\n}\n\nexport function lewisRootStressCorrected(\n  appliedTorqueNm: number,\n  moduleSize: number,\n  faceWidth: number,\n  z: number,\n  alpha: number,\n  isInternal = false\n): number {\n  return (\n    lewisRootStress(appliedTorqueNm, moduleSize, faceWidth, z) *\n    filletStressConcentrationFactor(z, alpha, isInternal)\n  );\n}\n\nexport function backlashHalf(totalBacklash: number): number {\n  return totalBacklash / 2;\n}\n\nexport function ringTeeth(zs: number, zp: number): number {\n  return zs + 2 * zp;\n}\n\nexport function evenToothPhaseOffset(z: number): number {\n  return z % 2 === 0 ? Math.PI / z : 0;\n}\n\nexport function planetSelfRotationAngle(orbitalAngle: number, zs: number, zp: number): number {\n  return orbitalAngle * (1 + zs / zp) + evenToothPhaseOffset(zp);\n}\n\n/** Pure-kinematics inputs for {@link planetPlacements}; subset of `PlanetaryGearParams`. */\nexport interface PlanetPlacementParams {\n  moduleSize?: number;\n  sunTeeth?: number;\n  planetTeeth?: number;\n  numPlanets?: number;\n  pressureAngleDeg?: number;\n  sunShift?: number;\n  planetShift?: number;\n}\n\nexport interface PlanetPlacement {\n  /** Self-rotation around the planet's own Z axis, in degrees. */\n  rotationDeg: number;\n  /** Center of the planet in the assembly frame: `[x, y, 0]`. */\n  position: Vec3;\n}\n\n/**\n * Compute the rigid placement of each planet without building any solid.\n *\n * Pairs with one materialized planet from `makeExternalGear` to support\n * GPU-instanced rendering: mesh once, draw N times under these transforms.\n * Defaults match {@link PlanetaryGearParams}.\n */\nexport function planetPlacements(params: PlanetPlacementParams = {}): Result<PlanetPlacement[]> {\n  const moduleSize = params.moduleSize ?? 3;\n  const sunTeeth = params.sunTeeth ?? 15;\n  const planetTeeth = params.planetTeeth ?? 12;\n  const numPlanets = params.numPlanets ?? 3;\n  const alpha = ((params.pressureAngleDeg ?? DEFAULT_PRESSURE_ANGLE_DEG) * Math.PI) / 180;\n  const sunShift = params.sunShift ?? 0;\n  const planetShift = params.planetShift ?? 0;\n\n  const validation = validatePlanetary(sunTeeth, planetTeeth, numPlanets, planetShift);\n  if (isErr(validation)) return validation;\n\n  const sp = solveSunPlanetWorkingPressureAngle(\n    alpha,\n    sunShift,\n    planetShift,\n    sunTeeth,\n    planetTeeth\n  );\n  if (isErr(sp)) return sp;\n  const centerDistance = workingCenterDistance(sunTeeth, planetTeeth, moduleSize, alpha, sp.value);\n\n  const placements: PlanetPlacement[] = [];\n  for (let i = 0; i < numPlanets; i++) {\n    const orbital = (i * 2 * Math.PI) / numPlanets;\n    const selfRot = planetSelfRotationAngle(orbital, sunTeeth, planetTeeth);\n    placements.push({\n      rotationDeg: (selfRot * 180) / Math.PI,\n      position: [centerDistance * Math.cos(orbital), centerDistance * Math.sin(orbital), 0],\n    });\n  }\n  return ok(placements);\n}\n"]}

package/dist/vendored/brepjs/gear/gearProfile.d.ts

@@ -0,0 +1,17 @@
+import { type Result } from '../core/result.js';
+import type { ClosedWire, PlanarWire } from '../core/shapeTypes.js';
+export interface GearWireParams {
+    teeth: number;
+    moduleSize: number;
+    /** Pressure angle in radians. */
+    pressureAngle: number;
+    shift: number;
+    clearance: number;
+    /** Per-gear flank thinning (mm); see {@link ExternalGearParams.flankThinning}. */
+    flankThinning: number;
+    /** Override sample count per flank; defaults to adaptiveSampleCount(moduleSize). */
+    samples?: number;
+}
+export declare function makeExternalGearProfileWire(params: GearWireParams): Result<ClosedWire & PlanarWire>;
+export declare function makeInternalGearProfileWire(params: GearWireParams): Result<ClosedWire & PlanarWire>;
+//# sourceMappingURL=gearProfile.d.ts.map

package/dist/vendored/brepjs/gear/gearProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gearProfile.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/gear/gearProfile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,mBAAmB,CAAC;AAGhE,OAAO,KAAK,EAAE,UAAU,EAAQ,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAyF1E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,GACrB,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,CAEjC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,GACrB,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,CAEjC"}

package/dist/vendored/brepjs/gear/gearProfile.js

@@ -0,0 +1,159 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { ok, err, isErr } from '../core/result.js';
+import { validationError } from '../core/errors.js';
+import { DisposalScope } from '../core/disposal.js';
+import { assembleWire, makeBSplineInterpolation, makeLine, makeThreePointArc, } from '../topology/curveBuilders.js';
+import { firstOrThrow, lastOrThrow } from '../utils/arrayAccess.js';
+import { adaptiveSampleCount, cosineSpaceFlankSamples, gearGeometry, inv, } from './gearMath.js';
+function buildToothPeriodEdges(tm, toothIndex, totalTeeth, samples, scope) {
+    const center = toothIndex * tm.toothPitch;
+    const nextCenter = ((toothIndex + 1) % totalTeeth) * tm.toothPitch;
+    const invPitch = inv(tm.alphaPitch);
+    // θ(α) = θ0 + sign·inv(α); at α_pitch the involute must hit center ± halfToothAngle, so:
+    //   left:  θ0 = center − halfToothAngle − inv(α_pitch)   (sign=+1)
+    //   right: θ0 = center + halfToothAngle + inv(α_pitch)   (sign=-1)
+    const thetaLeft = center - tm.halfToothAngle - invPitch;
+    const thetaRight = center + tm.halfToothAngle + invPitch;
+    // Right flank reversed so the edge chain runs base→tip→base→nextBase in geometric order.
+    // Without this, the wire has a discontinuity that OCCT silently fixes via auto-reorientation
+    // but brepkit doesn't, producing a face with reversed orientation.
+    const leftFlank = cosineSpaceFlankSamples(tm.rb, tm.alphaTip, thetaLeft, samples, 1);
+    const rightFlank = cosineSpaceFlankSamples(tm.rb, tm.alphaTip, thetaRight, samples, -1).reverse();
+    const leftBase = firstOrThrow(leftFlank);
+    const leftTip = lastOrThrow(leftFlank);
+    const rightTip = firstOrThrow(rightFlank);
+    const rightBase = lastOrThrow(rightFlank);
+    const edges = [];
+    const push = (e) => {
+        scope.register(e);
+        edges.push(e);
+    };
+    // Root below base (external) or above it (internal): involute can't reach root; bridge radially.
+    const needsRadialBridge = tm.isInternal ? tm.rb < tm.rRoot : tm.rb > tm.rRoot;
+    if (needsRadialBridge) {
+        const rootPt = [tm.rRoot * Math.cos(thetaLeft), tm.rRoot * Math.sin(thetaLeft), 0];
+        push(makeLine(rootPt, leftBase));
+    }
+    const interpTol = tm.rPitch * 1e-5;
+    const leftEdge = makeBSplineInterpolation(leftFlank, { tolerance: interpTol });
+    if (isErr(leftEdge))
+        return leftEdge;
+    push(leftEdge.value);
+    const tipMid = [tm.rTip * Math.cos(center), tm.rTip * Math.sin(center), 0];
+    push(makeThreePointArc(leftTip, tipMid, rightTip));
+    const rightEdge = makeBSplineInterpolation(rightFlank, { tolerance: interpTol });
+    if (isErr(rightEdge))
+        return rightEdge;
+    push(rightEdge.value);
+    if (needsRadialBridge) {
+        const rootPt = [tm.rRoot * Math.cos(thetaRight), tm.rRoot * Math.sin(thetaRight), 0];
+        push(makeLine(rightBase, rootPt));
+    }
+    const rootEndAngle = nextCenter - tm.halfToothAngle - invPitch;
+    let midAngle = 0.5 * (thetaRight + rootEndAngle);
+    if (rootEndAngle < thetaRight)
+        midAngle += Math.PI; // CCW wrap on last tooth
+    const rootStart = needsRadialBridge
+        ? [tm.rRoot * Math.cos(thetaRight), tm.rRoot * Math.sin(thetaRight), 0]
+        : rightBase;
+    const rootMid = [tm.rRoot * Math.cos(midAngle), tm.rRoot * Math.sin(midAngle), 0];
+    const nextLeftStart = needsRadialBridge
+        ? [tm.rRoot * Math.cos(rootEndAngle), tm.rRoot * Math.sin(rootEndAngle), 0]
+        : [tm.rb * Math.cos(rootEndAngle), tm.rb * Math.sin(rootEndAngle), 0];
+    push(makeThreePointArc(rootStart, rootMid, nextLeftStart));
+    return ok(edges);
+}
+export function makeExternalGearProfileWire(params) {
+    return makeProfileWire(params, false);
+}
+export function makeInternalGearProfileWire(params) {
+    return makeProfileWire(params, true);
+}
+function makeProfileWire(params, isInternal) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const { teeth, moduleSize, pressureAngle, shift, clearance, flankThinning, samples = adaptiveSampleCount(moduleSize), } = params;
+        if (teeth < 4)
+            return err(validationError('GEAR_TEETH_TOO_FEW', `gear needs ≥ 4 teeth, got ${teeth}`));
+        if (moduleSize <= 0)
+            return err(validationError('GEAR_MODULE_NONPOSITIVE', `module must be > 0, got ${moduleSize}`));
+        const tm = gearGeometry(teeth, moduleSize, pressureAngle, shift, clearance, flankThinning, isInternal);
+        // Register every per-tooth edge with a disposal scope so a mid-loop failure
+        // doesn't leak orphaned WASM handles. assembleWire deep-copies into the wire,
+        // so disposing the registered edges after wire construction is safe.
+        const scope = __addDisposableResource(env_1, new DisposalScope(), false);
+        const allEdges = [];
+        for (let i = 0; i < teeth; i++) {
+            const periodEdges = buildToothPeriodEdges(tm, i, teeth, samples, scope);
+            if (isErr(periodEdges))
+                return periodEdges;
+            allEdges.push(...periodEdges.value);
+        }
+        const wireResult = assembleWire(allEdges);
+        if (isErr(wireResult))
+            return wireResult;
+        // Wire is closed and planar by construction (4·N edges chain end-to-end in XY);
+        // skipping smart-constructor validation here because brepkit's isPlanarWire builds
+        // a temporary face that interferes with the wire's downstream usability.
+        return ok(wireResult.value);
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
+}
+//# sourceMappingURL=gearProfile.js.map

package/dist/vendored/brepjs/gear/gearProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gearProfile.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/gear/gearProfile.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Vec3 } from '../core/types.js';\nimport { type Result, ok, err, isErr } from '../core/result.js';\nimport { validationError } from '../core/errors.js';\nimport { DisposalScope } from '../core/disposal.js';\nimport type { ClosedWire, Edge, PlanarWire } from '../core/shapeTypes.js';\nimport {\n  assembleWire,\n  makeBSplineInterpolation,\n  makeLine,\n  makeThreePointArc,\n} from '../topology/curveBuilders.js';\nimport { firstOrThrow, lastOrThrow } from '../utils/arrayAccess.js';\nimport {\n  type GearGeometry,\n  adaptiveSampleCount,\n  cosineSpaceFlankSamples,\n  gearGeometry,\n  inv,\n} from './gearMath.js';\n\nfunction buildToothPeriodEdges(\n  tm: GearGeometry,\n  toothIndex: number,\n  totalTeeth: number,\n  samples: number,\n  scope: DisposalScope\n): Result<Edge[]> {\n  const center = toothIndex * tm.toothPitch;\n  const nextCenter = ((toothIndex + 1) % totalTeeth) * tm.toothPitch;\n  const invPitch = inv(tm.alphaPitch);\n\n  // θ(α) = θ0 + sign·inv(α); at α_pitch the involute must hit center ± halfToothAngle, so:\n  //   left:  θ0 = center − halfToothAngle − inv(α_pitch)   (sign=+1)\n  //   right: θ0 = center + halfToothAngle + inv(α_pitch)   (sign=-1)\n  const thetaLeft = center - tm.halfToothAngle - invPitch;\n  const thetaRight = center + tm.halfToothAngle + invPitch;\n\n  // Right flank reversed so the edge chain runs base→tip→base→nextBase in geometric order.\n  // Without this, the wire has a discontinuity that OCCT silently fixes via auto-reorientation\n  // but brepkit doesn't, producing a face with reversed orientation.\n  const leftFlank = cosineSpaceFlankSamples(tm.rb, tm.alphaTip, thetaLeft, samples, 1);\n  const rightFlank = cosineSpaceFlankSamples(tm.rb, tm.alphaTip, thetaRight, samples, -1).reverse();\n  const leftBase = firstOrThrow(leftFlank);\n  const leftTip = lastOrThrow(leftFlank);\n  const rightTip = firstOrThrow(rightFlank);\n  const rightBase = lastOrThrow(rightFlank);\n\n  const edges: Edge[] = [];\n  const push = (e: Edge): void => {\n    scope.register(e);\n    edges.push(e);\n  };\n\n  // Root below base (external) or above it (internal): involute can't reach root; bridge radially.\n  const needsRadialBridge = tm.isInternal ? tm.rb < tm.rRoot : tm.rb > tm.rRoot;\n  if (needsRadialBridge) {\n    const rootPt: Vec3 = [tm.rRoot * Math.cos(thetaLeft), tm.rRoot * Math.sin(thetaLeft), 0];\n    push(makeLine(rootPt, leftBase));\n  }\n\n  const interpTol = tm.rPitch * 1e-5;\n  const leftEdge = makeBSplineInterpolation(leftFlank, { tolerance: interpTol });\n  if (isErr(leftEdge)) return leftEdge;\n  push(leftEdge.value);\n\n  const tipMid: Vec3 = [tm.rTip * Math.cos(center), tm.rTip * Math.sin(center), 0];\n  push(makeThreePointArc(leftTip, tipMid, rightTip));\n\n  const rightEdge = makeBSplineInterpolation(rightFlank, { tolerance: interpTol });\n  if (isErr(rightEdge)) return rightEdge;\n  push(rightEdge.value);\n\n  if (needsRadialBridge) {\n    const rootPt: Vec3 = [tm.rRoot * Math.cos(thetaRight), tm.rRoot * Math.sin(thetaRight), 0];\n    push(makeLine(rightBase, rootPt));\n  }\n\n  const rootEndAngle = nextCenter - tm.halfToothAngle - invPitch;\n  let midAngle = 0.5 * (thetaRight + rootEndAngle);\n  if (rootEndAngle < thetaRight) midAngle += Math.PI; // CCW wrap on last tooth\n\n  const rootStart: Vec3 = needsRadialBridge\n    ? [tm.rRoot * Math.cos(thetaRight), tm.rRoot * Math.sin(thetaRight), 0]\n    : rightBase;\n  const rootMid: Vec3 = [tm.rRoot * Math.cos(midAngle), tm.rRoot * Math.sin(midAngle), 0];\n  const nextLeftStart: Vec3 = needsRadialBridge\n    ? [tm.rRoot * Math.cos(rootEndAngle), tm.rRoot * Math.sin(rootEndAngle), 0]\n    : [tm.rb * Math.cos(rootEndAngle), tm.rb * Math.sin(rootEndAngle), 0];\n  push(makeThreePointArc(rootStart, rootMid, nextLeftStart));\n\n  return ok(edges);\n}\n\nexport interface GearWireParams {\n  teeth: number;\n  moduleSize: number;\n  /** Pressure angle in radians. */\n  pressureAngle: number;\n  shift: number;\n  clearance: number;\n  /** Per-gear flank thinning (mm); see {@link ExternalGearParams.flankThinning}. */\n  flankThinning: number;\n  /** Override sample count per flank; defaults to adaptiveSampleCount(moduleSize). */\n  samples?: number;\n}\n\nexport function makeExternalGearProfileWire(\n  params: GearWireParams\n): Result<ClosedWire & PlanarWire> {\n  return makeProfileWire(params, false);\n}\n\nexport function makeInternalGearProfileWire(\n  params: GearWireParams\n): Result<ClosedWire & PlanarWire> {\n  return makeProfileWire(params, true);\n}\n\nfunction makeProfileWire(\n  params: GearWireParams,\n  isInternal: boolean\n): Result<ClosedWire & PlanarWire> {\n  const {\n    teeth,\n    moduleSize,\n    pressureAngle,\n    shift,\n    clearance,\n    flankThinning,\n    samples = adaptiveSampleCount(moduleSize),\n  } = params;\n\n  if (teeth < 4)\n    return err(validationError('GEAR_TEETH_TOO_FEW', `gear needs ≥ 4 teeth, got ${teeth}`));\n  if (moduleSize <= 0)\n    return err(validationError('GEAR_MODULE_NONPOSITIVE', `module must be > 0, got ${moduleSize}`));\n\n  const tm = gearGeometry(\n    teeth,\n    moduleSize,\n    pressureAngle,\n    shift,\n    clearance,\n    flankThinning,\n    isInternal\n  );\n\n  // Register every per-tooth edge with a disposal scope so a mid-loop failure\n  // doesn't leak orphaned WASM handles. assembleWire deep-copies into the wire,\n  // so disposing the registered edges after wire construction is safe.\n  using scope = new DisposalScope();\n  const allEdges: Edge[] = [];\n  for (let i = 0; i < teeth; i++) {\n    const periodEdges = buildToothPeriodEdges(tm, i, teeth, samples, scope);\n    if (isErr(periodEdges)) return periodEdges;\n    allEdges.push(...periodEdges.value);\n  }\n\n  const wireResult = assembleWire(allEdges);\n  if (isErr(wireResult)) return wireResult;\n  // Wire is closed and planar by construction (4·N edges chain end-to-end in XY);\n  // skipping smart-constructor validation here because brepkit's isPlanarWire builds\n  // a temporary face that interferes with the wire's downstream usability.\n  return ok(wireResult.value as ClosedWire & PlanarWire);\n}\n"]}

package/dist/vendored/brepjs/gear/index.d.ts

@@ -0,0 +1,4 @@
+export { type GearDiagnostic, type GearDiagnosticCode, type GearDiagnosticSeverity, type GearGeometry, inv, involutePoint, cosineSpaceFlankSamples, adaptiveSampleCount, gearGeometry, solveWorkingPressureAngle, solveSunPlanetWorkingPressureAngle, solvePlanetRingWorkingPressureAngle, workingCenterDistance, validatePlanetary, externalExternalContactRatio, externalInternalContactRatio, undercutMinimumShift, undercutDeficit, lewisYFactor, lewisRootStress, lewisRootStressCorrected, filletStressConcentrationFactor, ringTeeth, evenToothPhaseOffset, planetSelfRotationAngle, planetPlacements, type PlanetPlacement, type PlanetPlacementParams, } from './gearMath.js';
+export { type GearWireParams, makeExternalGearProfileWire, makeInternalGearProfileWire, } from './gearProfile.js';
+export { type ExternalGearParams, type InternalGearParams, type PlanetaryGearParams, type GearResult, type PlanetaryGearAssembly, makeExternalGear, makeInternalGear, makePlanetaryGear, } from './gearFns.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/vendored/brepjs/gear/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/gear/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,GAAG,EACH,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,kCAAkC,EAClC,mCAAmC,EACnC,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,wBAAwB,EACxB,+BAA+B,EAC/B,SAAS,EACT,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,cAAc,EACnB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC"}

package/dist/vendored/brepjs/gear/index.js

@@ -0,0 +1,4 @@
+export { inv, involutePoint, cosineSpaceFlankSamples, adaptiveSampleCount, gearGeometry, solveWorkingPressureAngle, solveSunPlanetWorkingPressureAngle, solvePlanetRingWorkingPressureAngle, workingCenterDistance, validatePlanetary, externalExternalContactRatio, externalInternalContactRatio, undercutMinimumShift, undercutDeficit, lewisYFactor, lewisRootStress, lewisRootStressCorrected, filletStressConcentrationFactor, ringTeeth, evenToothPhaseOffset, planetSelfRotationAngle, planetPlacements, } from './gearMath.js';
+export { makeExternalGearProfileWire, makeInternalGearProfileWire, } from './gearProfile.js';
+export { makeExternalGear, makeInternalGear, makePlanetaryGear, } from './gearFns.js';
+//# sourceMappingURL=index.js.map

package/dist/vendored/brepjs/gear/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/gear/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,GAAG,EACH,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,kCAAkC,EAClC,mCAAmC,EACnC,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,wBAAwB,EACxB,+BAA+B,EAC/B,SAAS,EACT,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,GAGjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAML,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC","sourcesContent":["export {\n  type GearDiagnostic,\n  type GearDiagnosticCode,\n  type GearDiagnosticSeverity,\n  type GearGeometry,\n  inv,\n  involutePoint,\n  cosineSpaceFlankSamples,\n  adaptiveSampleCount,\n  gearGeometry,\n  solveWorkingPressureAngle,\n  solveSunPlanetWorkingPressureAngle,\n  solvePlanetRingWorkingPressureAngle,\n  workingCenterDistance,\n  validatePlanetary,\n  externalExternalContactRatio,\n  externalInternalContactRatio,\n  undercutMinimumShift,\n  undercutDeficit,\n  lewisYFactor,\n  lewisRootStress,\n  lewisRootStressCorrected,\n  filletStressConcentrationFactor,\n  ringTeeth,\n  evenToothPhaseOffset,\n  planetSelfRotationAngle,\n  planetPlacements,\n  type PlanetPlacement,\n  type PlanetPlacementParams,\n} from './gearMath.js';\n\nexport {\n  type GearWireParams,\n  makeExternalGearProfileWire,\n  makeInternalGearProfileWire,\n} from './gearProfile.js';\n\nexport {\n  type ExternalGearParams,\n  type InternalGearParams,\n  type PlanetaryGearParams,\n  type GearResult,\n  type PlanetaryGearAssembly,\n  makeExternalGear,\n  makeInternalGear,\n  makePlanetaryGear,\n} from './gearFns.js';\n"]}