@faicad/faijs 0.31.1 → 0.32.2

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

@@ -1,148 +0,0 @@
-/**
- * Public gear API — external + internal spur gears, planetary assemblies.
- *
- * @example Single external gear
- * ```typescript
- * await initOC();
- * const result = makeExternalGear({ teeth: 24, moduleSize: 2, thickness: 8, bore: 6 });
- * if (isOk(result)) writeSTEP(result.value.solid, 'gear.step');
- * ```
- *
- * @example Planetary assembly
- * ```typescript
- * const planetary = makePlanetaryGear({ thickness: 10 });
- * if (isOk(planetary)) {
- *   const { sun, planets, ring, contactRatio } = planetary.value;
- * }
- * ```
- */
-import { type Result } from '../core/result.js';
-import type { ValidSolid } from '../core/shapeTypes.js';
-import { type GearDiagnostic } from './gearMath.js';
-export interface ExternalGearParams {
-    teeth: number;
-    moduleSize: number;
-    thickness: number;
-    pressureAngleDeg?: number;
-    shift?: number;
-    clearance?: number;
-    /**
-     * Per-gear flank thinning (mm); 0 = theoretical involute. For an equal-pair
-     * mesh, total mesh backlash is 2× this value.
-     */
-    flankThinning?: number;
-    /** Diameter (mm) of central bore; 0 or omitted = no bore. */
-    bore?: number;
-    /**
-     * Sample count per involute flank. Lower = faster mesh, coarser surface.
-     * Defaults to `adaptiveSampleCount(moduleSize)` (≈ 16 at module 2). Try
-     * 8 for previews, 24+ for 3D printing.
-     */
-    samples?: number;
-}
-export interface InternalGearParams {
-    teeth: number;
-    moduleSize: number;
-    thickness: number;
-    pressureAngleDeg?: number;
-    shift?: number;
-    clearance?: number;
-    flankThinning?: number;
-    /** Wall thickness from pitch radius outward; defaults to 2·moduleSize. */
-    ringWallThickness?: number;
-    /** See {@link ExternalGearParams.samples}. */
-    samples?: number;
-}
-export interface PlanetaryGearParams {
-    /** Extrusion thickness (mm). */
-    thickness: number;
-    moduleSize?: number;
-    sunTeeth?: number;
-    planetTeeth?: number;
-    numPlanets?: number;
-    pressureAngleDeg?: number;
-    clearance?: number;
-    /** Total mesh backlash (mm); split as b/2 per gear. */
-    backlash?: number;
-    sunShift?: number;
-    planetShift?: number;
-    ringShift?: number;
-    ringWallThickness?: number;
-    /** Diameter (mm) of central bore in the sun gear; 0 or omitted = no bore. */
-    sunBore?: number;
-    /** Diameter (mm) of central bore in each planet gear; 0 or omitted = no bore. */
-    planetBore?: number;
-    /**
-     * Applied torque on the SUN (input) shaft, in N·m. Planet and ring stresses
-     * are derived via force balance (shared tangential force at the mesh).
-     * When supplied, `lewisStress` and `stressConcentrationFactor` are computed.
-     */
-    appliedTorque?: number;
-    /** See {@link ExternalGearParams.samples}. Applied to sun, planet, and ring. */
-    samples?: number;
-}
-export interface GearResult {
-    solid: ValidSolid;
-    pitchDiameter: number;
-    baseDiameter: number;
-    tipDiameter: number;
-    rootDiameter: number;
-    /**
-     * Diagnostics specific to this gear in isolation (e.g. undercut risk for
-     * low-tooth-count gears with no profile shift). Empty when the gear is
-     * geometrically clean. Planetary assemblies emit additional cross-mesh
-     * diagnostics on `PlanetaryGearAssembly.diagnostics`.
-     */
-    diagnostics: GearDiagnostic[];
-}
-export interface PlanetaryGearAssembly {
-    sun: ValidSolid;
-    planets: ValidSolid[];
-    ring: ValidSolid;
-    ringTeeth: number;
-    /** Working pressure angle (radians) under the supplied profile shifts. */
-    workingPressureAngle: number;
-    /** True (working) center distance between sun and planet axes (mm). */
-    centerDistance: number;
-    /** Transverse contact ratios per mesh; ≥ 1.2 is industry-acceptable. */
-    contactRatio: {
-        sunPlanet: number;
-        planetRing: number;
-    };
-    /**
-     * Additional profile shift each gear needs to clear the undercut threshold.
-     * Positive = undercut risk; zero = clear.
-     */
-    undercutDeficit: {
-        sun: number;
-        planet: number;
-    };
-    /**
-     * Root bending stress (MPa) at each gear, with the fillet stress
-     * concentration factor applied: `σ = σ_Lewis · K_f`. Only present when
-     * `appliedTorque` was supplied. See {@link stressConcentrationFactor} for
-     * the K_f values used.
-     */
-    lewisStress?: {
-        sun: number;
-        planet: number;
-        ring: number;
-    };
-    /**
-     * Dolan-Broghamer stress concentration factor `K_f` at each gear's root
-     * fillet, the multiplier already folded into {@link lewisStress}. Exposed
-     * so callers can recover the raw Lewis stress (σ_Lewis = lewisStress / K_f)
-     * or compare against ISO 6336-3 `Y_F·Y_S` from an external check. The ring
-     * value uses the Niemann internal-gear reduction (concave fillet).
-     */
-    stressConcentrationFactor?: {
-        sun: number;
-        planet: number;
-        ring: number;
-    };
-    diagnostics: GearDiagnostic[];
-}
-export declare function makeExternalGear(params: ExternalGearParams): Result<GearResult>;
-export declare function makeInternalGear(params: InternalGearParams): Result<GearResult>;
-export declare function makePlanetaryGear(params: PlanetaryGearParams): Result<PlanetaryGearAssembly>;
-//# sourceMappingURL=gearFns.d.ts.map

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

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

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

@@ -1,479 +0,0 @@
-/**
- * Public gear API — external + internal spur gears, planetary assemblies.
- *
- * @example Single external gear
- * ```typescript
- * await initOC();
- * const result = makeExternalGear({ teeth: 24, moduleSize: 2, thickness: 8, bore: 6 });
- * if (isOk(result)) writeSTEP(result.value.solid, 'gear.step');
- * ```
- *
- * @example Planetary assembly
- * ```typescript
- * const planetary = makePlanetaryGear({ thickness: 10 });
- * if (isOk(planetary)) {
- *   const { sun, planets, ring, contactRatio } = planetary.value;
- * }
- * ```
- */
-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 { makeCircle, assembleWire } from '../topology/curveBuilders.js';
-import { makeFace } from '../topology/surfaceBuilders.js';
-import { DisposalScope } from '../core/disposal.js';
-import { rotate, translate } from '../topology/transformFns.js';
-import { cut } from '../topology/booleanFns.js';
-import { extrude } from '../operations/extrudeFns.js';
-import { DEFAULT_CLEARANCE, DEFAULT_PRESSURE_ANGLE_DEG, backlashHalf, evenToothPhaseOffset, externalExternalContactRatio, externalInternalContactRatio, filletStressConcentrationFactor, gearGeometry, lewisRootStressCorrected, planetSelfRotationAngle, ringTeeth, solvePlanetRingWorkingPressureAngle, solveSunPlanetWorkingPressureAngle, undercutDeficit, validatePlanetary, workingCenterDistance, } from './gearMath.js';
-import { makeExternalGearProfileWire, makeInternalGearProfileWire } from './gearProfile.js';
-export function makeExternalGear(params) {
-    const { teeth, moduleSize, thickness, pressureAngleDeg = DEFAULT_PRESSURE_ANGLE_DEG, shift = 0, clearance = DEFAULT_CLEARANCE, flankThinning = 0, bore = 0, samples, } = params;
-    if (thickness <= 0)
-        return err(validationError('GEAR_THICKNESS_NONPOSITIVE', 'thickness must be > 0'));
-    if (samples !== undefined && (!Number.isInteger(samples) || samples < 1))
-        return err(validationError('GEAR_SAMPLES_INVALID', `samples must be a positive integer; got ${String(samples)}`));
-    const alpha = (pressureAngleDeg * Math.PI) / 180;
-    const geom = gearGeometry(teeth, moduleSize, alpha, shift, clearance, flankThinning, false);
-    if (bore > 0 && bore >= 2 * geom.rRoot)
-        return err(validationError('GEAR_BORE_TOO_LARGE', `bore diameter ${bore.toFixed(2)} ≥ root diameter ${(2 * geom.rRoot).toFixed(2)} — would erase the gear teeth`));
-    const wireResult = makeExternalGearProfileWire({
-        teeth,
-        moduleSize,
-        pressureAngle: alpha,
-        shift,
-        clearance,
-        flankThinning,
-        ...(samples !== undefined ? { samples } : {}),
-    });
-    if (isErr(wireResult))
-        return wireResult;
-    const diagnostics = externalGearDiagnostics(teeth, alpha, shift);
-    return finalizeExternalSolid(wireResult.value, thickness, bore, geom, diagnostics);
-}
-export function makeInternalGear(params) {
-    const { teeth, moduleSize, thickness, pressureAngleDeg = DEFAULT_PRESSURE_ANGLE_DEG, shift = 0, clearance = DEFAULT_CLEARANCE, flankThinning = 0, ringWallThickness = 2 * params.moduleSize, samples, } = params;
-    if (thickness <= 0)
-        return err(validationError('GEAR_THICKNESS_NONPOSITIVE', 'thickness must be > 0'));
-    if (ringWallThickness <= 0)
-        return err(validationError('GEAR_WALL_NONPOSITIVE', 'ringWallThickness must be > 0'));
-    if (samples !== undefined && (!Number.isInteger(samples) || samples < 1))
-        return err(validationError('GEAR_SAMPLES_INVALID', `samples must be a positive integer; got ${String(samples)}`));
-    const alpha = (pressureAngleDeg * Math.PI) / 180;
-    const innerWireResult = makeInternalGearProfileWire({
-        teeth,
-        moduleSize,
-        pressureAngle: alpha,
-        shift,
-        clearance,
-        flankThinning,
-        ...(samples !== undefined ? { samples } : {}),
-    });
-    if (isErr(innerWireResult))
-        return innerWireResult;
-    const geom = gearGeometry(teeth, moduleSize, alpha, shift, clearance, flankThinning, true);
-    const outerRadius = geom.rPitch + ringWallThickness;
-    const outerWireResult = makeOuterCircleWire(outerRadius);
-    if (isErr(outerWireResult))
-        return outerWireResult;
-    // Internal gears use a different undercut criterion (involute-cutter geometry,
-    // shift sign inverted), so the rack-cut formula that drives external-gear
-    // diagnostics doesn't apply here. Leave diagnostics empty until a ring-specific
-    // check exists.
-    return finalizeInternalSolid(outerWireResult.value, innerWireResult.value, thickness, geom, []);
-}
-/** Diagnostics for an external (rack-cut) gear in isolation. Not valid for internal gears. */
-function externalGearDiagnostics(teeth, alpha, shift) {
-    const deficit = undercutDeficit(teeth, alpha, shift);
-    if (deficit <= 0)
-        return [];
-    return [
-        {
-            code: 'UNDERCUT_RISK',
-            severity: 'warning',
-            message: `gear is undercut: increase shift by ${deficit.toFixed(3)} to avoid (z=${teeth})`,
-            context: { deficit, teeth },
-        },
-    ];
-}
-export function makePlanetaryGear(params) {
-    const resolved = resolvePlanetaryParams(params);
-    if (isErr(resolved))
-        return resolved;
-    const cfg = resolved.value;
-    const stages = buildPlanetaryStages(cfg);
-    if (isErr(stages))
-        return stages;
-    const { sun, planet, ring } = stages.value;
-    // Compute metrics before disposing `planet.solid` — the function only reads
-    // scalar fields off GearResult so the order is technically irrelevant today,
-    // but it leaves a footgun for anyone adding a solid-touching read later.
-    const metrics = computeMeshMetrics(cfg, sun, planet, ring);
-    const planets = placePlanets(planet.solid, cfg);
-    planet.solid.delete();
-    const ringPhased = applyRingPhase(ring.solid, cfg.zr);
-    const diagnostics = collectDiagnostics(cfg, metrics);
-    return ok({
-        sun: sun.solid,
-        planets,
-        ring: ringPhased,
-        ringTeeth: cfg.zr,
-        workingPressureAngle: cfg.alphaW_sp,
-        centerDistance: cfg.centerDistance,
-        contactRatio: { sunPlanet: metrics.crSunPlanet, planetRing: metrics.crPlanetRing },
-        undercutDeficit: { sun: metrics.undercutSun, planet: metrics.undercutPlanet },
-        ...(metrics.lewisStress ? { lewisStress: metrics.lewisStress } : {}),
-        ...(metrics.stressConcentrationFactor
-            ? { stressConcentrationFactor: metrics.stressConcentrationFactor }
-            : {}),
-        diagnostics,
-    });
-}
-function buildPlanetaryStages(cfg) {
-    const samplesField = cfg.samples !== undefined ? { samples: cfg.samples } : {};
-    const common = {
-        moduleSize: cfg.moduleSize,
-        thickness: cfg.thickness,
-        pressureAngleDeg: cfg.pressureAngleDeg,
-        clearance: cfg.clearance,
-        flankThinning: cfg.bHalf,
-        ...samplesField,
-    };
-    const sun = makeExternalGear({
-        ...common,
-        teeth: cfg.sunTeeth,
-        shift: cfg.sunShift,
-        bore: cfg.sunBore,
-    });
-    if (isErr(sun))
-        return sun;
-    const planet = makeExternalGear({
-        ...common,
-        teeth: cfg.planetTeeth,
-        shift: cfg.planetShift,
-        bore: cfg.planetBore,
-    });
-    if (isErr(planet)) {
-        sun.value.solid.delete();
-        return planet;
-    }
-    const ring = makeInternalGear({
-        ...common,
-        teeth: cfg.zr,
-        shift: cfg.ringShift,
-        ringWallThickness: cfg.ringWallThickness,
-    });
-    if (isErr(ring)) {
-        sun.value.solid.delete();
-        planet.value.solid.delete();
-        return ring;
-    }
-    return ok({ sun: sun.value, planet: planet.value, ring: ring.value });
-}
-function resolvePlanetaryParams(params) {
-    const moduleSize = params.moduleSize ?? 3;
-    const sunTeeth = params.sunTeeth ?? 15;
-    const planetTeeth = params.planetTeeth ?? 12;
-    const numPlanets = params.numPlanets ?? 3;
-    const pressureAngleDeg = params.pressureAngleDeg ?? DEFAULT_PRESSURE_ANGLE_DEG;
-    const alpha = (pressureAngleDeg * Math.PI) / 180;
-    const sunShift = params.sunShift ?? 0;
-    const planetShift = params.planetShift ?? 0;
-    const ringShift = params.ringShift ?? 0;
-    if (params.thickness <= 0)
-        return err(validationError('GEAR_THICKNESS_NONPOSITIVE', 'thickness must be > 0'));
-    const validation = validatePlanetary(sunTeeth, planetTeeth, numPlanets, planetShift);
-    if (isErr(validation))
-        return validation;
-    const zr = ringTeeth(sunTeeth, planetTeeth);
-    const sp = solveSunPlanetWorkingPressureAngle(alpha, sunShift, planetShift, sunTeeth, planetTeeth);
-    if (isErr(sp))
-        return sp;
-    const pr = solvePlanetRingWorkingPressureAngle(alpha, planetShift, ringShift, planetTeeth, zr);
-    if (isErr(pr))
-        return pr;
-    const centerDistance = workingCenterDistance(sunTeeth, planetTeeth, moduleSize, alpha, sp.value);
-    return ok({
-        moduleSize,
-        sunTeeth,
-        planetTeeth,
-        numPlanets,
-        pressureAngleDeg,
-        alpha,
-        alphaW_sp: sp.value,
-        alphaW_pr: pr.value,
-        clearance: params.clearance ?? DEFAULT_CLEARANCE,
-        bHalf: backlashHalf(params.backlash ?? 0),
-        sunShift,
-        planetShift,
-        ringShift,
-        ringWallThickness: params.ringWallThickness ?? 2 * moduleSize,
-        thickness: params.thickness,
-        sunBore: params.sunBore ?? 0,
-        planetBore: params.planetBore ?? 0,
-        ...(params.appliedTorque !== undefined ? { appliedTorque: params.appliedTorque } : {}),
-        ...(params.samples !== undefined ? { samples: params.samples } : {}),
-        zr,
-        centerDistance,
-    });
-}
-function makeOuterCircleWire(radius) {
-    const env_1 = { stack: [], error: void 0, hasError: false };
-    try {
-        const scope = __addDisposableResource(env_1, new DisposalScope(), false);
-        const circleEdge = scope.register(makeCircle(radius, [0, 0, 0], [0, 0, 1]));
-        const wireResult = assembleWire([circleEdge]);
-        if (isErr(wireResult))
-            return wireResult;
-        // A single-edge circle wire is closed and planar by construction; brand once.
-        return ok(wireResult.value);
-    }
-    catch (e_1) {
-        env_1.error = e_1;
-        env_1.hasError = true;
-    }
-    finally {
-        __disposeResources(env_1);
-    }
-}
-function finalizeExternalSolid(wire, thickness, bore, geom, diagnostics) {
-    const env_2 = { stack: [], error: void 0, hasError: false };
-    try {
-        // The profile wire and its face are consumed by makeFace/extrude (which share
-        // their refcounted TShape); dispose them once the solid is built. The solid is
-        // NOT registered here — it is the returned value on the no-bore path.
-        const profileScope = __addDisposableResource(env_2, new DisposalScope(), false);
-        profileScope.register(wire);
-        const faceResult = makeFace(wire);
-        if (isErr(faceResult))
-            return faceResult;
-        profileScope.register(faceResult.value);
-        const solidResult = extrude(faceResult.value, [0, 0, thickness]);
-        if (isErr(solidResult))
-            return solidResult;
-        if (bore <= 0)
-            return ok(buildGearResult(solidResult.value, geom, diagnostics));
-        // Bore overshoots both ends (z = -0.5 to thickness + 0.5) so no faces are coplanar.
-        const boreScope = __addDisposableResource(env_2, new DisposalScope(), false);
-        boreScope.register(solidResult.value); // un-bored gear, consumed by cut below
-        const boreFaceResult = makeBoreFace(bore / 2);
-        if (isErr(boreFaceResult))
-            return boreFaceResult;
-        boreScope.register(boreFaceResult.value);
-        const boreRaw = extrude(boreFaceResult.value, [0, 0, thickness + 1]);
-        if (isErr(boreRaw))
-            return boreRaw;
-        boreScope.register(boreRaw.value);
-        const boreSolid = boreScope.register(translate(boreRaw.value, [0, 0, -0.5]));
-        const cutResult = cut(solidResult.value, boreSolid);
-        if (isErr(cutResult))
-            return cutResult;
-        return ok(buildGearResult(cutResult.value, geom, diagnostics));
-    }
-    catch (e_2) {
-        env_2.error = e_2;
-        env_2.hasError = true;
-    }
-    finally {
-        __disposeResources(env_2);
-    }
-}
-function makeBoreFace(radius) {
-    const wireResult = makeOuterCircleWire(radius);
-    if (isErr(wireResult))
-        return wireResult;
-    return makeFace(wireResult.value);
-}
-function finalizeInternalSolid(outerWire, innerToothedWire, thickness, geom, diagnostics) {
-    const faceResult = makeFace(outerWire, [innerToothedWire]);
-    if (isErr(faceResult))
-        return faceResult;
-    const solidResult = extrude(faceResult.value, [0, 0, thickness]);
-    if (isErr(solidResult))
-        return solidResult;
-    return ok(buildGearResult(solidResult.value, geom, diagnostics));
-}
-function buildGearResult(solid, geom, diagnostics = []) {
-    return {
-        solid,
-        diagnostics,
-        pitchDiameter: 2 * geom.rPitch,
-        baseDiameter: 2 * geom.rb,
-        tipDiameter: 2 * geom.rTip,
-        rootDiameter: 2 * geom.rRoot,
-    };
-}
-function placePlanets(planetProto, cfg) {
-    const planets = [];
-    try {
-        for (let i = 0; i < cfg.numPlanets; i++) {
-            const orbital = (i * 2 * Math.PI) / cfg.numPlanets;
-            const selfRot = planetSelfRotationAngle(orbital, cfg.sunTeeth, cfg.planetTeeth);
-            const rotated = rotate(planetProto, (selfRot * 180) / Math.PI);
-            try {
-                const offset = [
-                    cfg.centerDistance * Math.cos(orbital),
-                    cfg.centerDistance * Math.sin(orbital),
-                    0,
-                ];
-                planets.push(translate(rotated, offset));
-            }
-            finally {
-                rotated.delete();
-            }
-        }
-        return planets;
-    }
-    catch (e) {
-        // Mid-loop failure: clean up the planets that did succeed before rethrowing.
-        for (const p of planets)
-            p.delete();
-        throw e;
-    }
-}
-function applyRingPhase(ring, zr) {
-    const phaseRad = evenToothPhaseOffset(zr);
-    if (phaseRad === 0)
-        return ring;
-    const rotated = rotate(ring, (phaseRad * 180) / Math.PI);
-    ring.delete();
-    return rotated;
-}
-function computeMeshMetrics(cfg, sun, planet, ring) {
-    const crSunPlanet = externalExternalContactRatio(sun.tipDiameter / 2, sun.baseDiameter / 2, planet.tipDiameter / 2, planet.baseDiameter / 2, cfg.centerDistance, cfg.moduleSize, cfg.alpha, cfg.alphaW_sp);
-    const crPlanetRing = externalInternalContactRatio(planet.tipDiameter / 2, planet.baseDiameter / 2, ring.tipDiameter / 2, ring.baseDiameter / 2, cfg.centerDistance, cfg.moduleSize, cfg.alpha, cfg.alphaW_pr);
-    const undercutSun = undercutDeficit(cfg.sunTeeth, cfg.alpha, cfg.sunShift);
-    const undercutPlanet = undercutDeficit(cfg.planetTeeth, cfg.alpha, cfg.planetShift);
-    const metrics = { crSunPlanet, crPlanetRing, undercutSun, undercutPlanet };
-    if (cfg.appliedTorque !== undefined) {
-        // Force balance: W_t is shared at each mesh, so each gear's own-pitch torque
-        // is T_eff = T_sun · z / z_sun (preserves W_t through Lewis's 2T/(z·m) term).
-        const tSun = cfg.appliedTorque;
-        metrics.lewisStress = {
-            sun: lewisRootStressCorrected(tSun, cfg.moduleSize, cfg.thickness, cfg.sunTeeth, cfg.alpha),
-            planet: lewisRootStressCorrected((tSun * cfg.planetTeeth) / cfg.sunTeeth, cfg.moduleSize, cfg.thickness, cfg.planetTeeth, cfg.alpha),
-            ring: lewisRootStressCorrected((tSun * cfg.zr) / cfg.sunTeeth, cfg.moduleSize, cfg.thickness, cfg.zr, cfg.alpha, true),
-        };
-        metrics.stressConcentrationFactor = {
-            sun: filletStressConcentrationFactor(cfg.sunTeeth, cfg.alpha),
-            planet: filletStressConcentrationFactor(cfg.planetTeeth, cfg.alpha),
-            ring: filletStressConcentrationFactor(cfg.zr, cfg.alpha, true),
-        };
-    }
-    return metrics;
-}
-function collectDiagnostics(cfg, metrics) {
-    const diagnostics = [];
-    if (metrics.crSunPlanet < 1.2) {
-        diagnostics.push({
-            code: 'CONTACT_RATIO_LOW_SUN_PLANET',
-            severity: 'warning',
-            message: `sun-planet contact ratio ${metrics.crSunPlanet.toFixed(2)} is below 1.2 — may run unevenly`,
-            context: { value: metrics.crSunPlanet },
-        });
-    }
-    if (metrics.crPlanetRing < 1.2) {
-        diagnostics.push({
-            code: 'CONTACT_RATIO_LOW_PLANET_RING',
-            severity: 'warning',
-            message: `planet-ring contact ratio ${metrics.crPlanetRing.toFixed(2)} is below 1.2 — may run unevenly`,
-            context: { value: metrics.crPlanetRing },
-        });
-    }
-    if (metrics.undercutSun > 0) {
-        diagnostics.push({
-            code: 'UNDERCUT_RISK_SUN',
-            severity: 'warning',
-            message: `sun gear is undercut: increase sunShift by ${metrics.undercutSun.toFixed(3)} to avoid`,
-            context: { deficit: metrics.undercutSun, sunTeeth: cfg.sunTeeth },
-        });
-    }
-    if (metrics.undercutPlanet > 0) {
-        diagnostics.push({
-            code: 'UNDERCUT_RISK_PLANET',
-            severity: 'warning',
-            message: `planet gear is undercut: increase planetShift by ${metrics.undercutPlanet.toFixed(3)} to avoid`,
-            context: { deficit: metrics.undercutPlanet, planetTeeth: cfg.planetTeeth },
-        });
-    }
-    // Only emit when shifts are large enough to matter. The diagnostic exists to
-    // warn that Lewis Y(z) uses unshifted geometry — at ~0.05 of profile shift
-    // the error is under 2.5%, well within engineering noise for a strength
-    // estimate, so don't pester users on canonical setups with small shifts.
-    const totalShiftMagnitude = Math.abs(cfg.sunShift) + Math.abs(cfg.planetShift) + Math.abs(cfg.ringShift);
-    if (cfg.appliedTorque !== undefined && totalShiftMagnitude > 0.05) {
-        diagnostics.push({
-            code: 'LEWIS_Y_SHIFT_UNCORRECTED',
-            severity: 'info',
-            message: 'Lewis stress uses unshifted Y(z) and K_f approximations; expect ±5% per 0.1 of profile shift',
-        });
-    }
-    // Kinematic compatibility: x_ring should equal x_sun + 2·x_planet for both meshes to share αw.
-    const kinematicError = cfg.ringShift - (cfg.sunShift + 2 * cfg.planetShift);
-    if (Math.abs(kinematicError) > 1e-6) {
-        diagnostics.push({
-            code: 'PLANETARY_SHIFT_KINEMATIC_MISMATCH',
-            severity: 'warning',
-            message: `ringShift should equal sunShift + 2·planetShift for both meshes to share working PA; off by ${kinematicError.toFixed(3)}`,
-            context: {
-                kinematicError,
-                sunShift: cfg.sunShift,
-                planetShift: cfg.planetShift,
-                ringShift: cfg.ringShift,
-            },
-        });
-    }
-    return diagnostics;
-}
-//# sourceMappingURL=gearFns.js.map