formulab 0.1.0 → 0.5.0

package/dist/machining/gaugeBlockStack.js

@@ -0,0 +1,138 @@
+import { roundTo } from '../utils.js';
+/**
+ * Metric 47-piece gauge block set (mm)
+ * Standard: Grade 1 metric set per ISO 3650
+ */
+const METRIC_47_SET = [
+    // Series 1: 1.001–1.009 (9 blocks, 0.001 steps)
+    1.001, 1.002, 1.003, 1.004, 1.005, 1.006, 1.007, 1.008, 1.009,
+    // Series 2: 1.01–1.49 (49 blocks → typically 1.01-1.09 step 0.01, then 1.10-1.49 step 0.10)
+    // Actually standard 47-set has:
+    // 9 × 0.001: 1.001-1.009
+    // 9 × 0.01: 1.01-1.09
+    // 9 × 0.10: 1.10-1.90 (but typically only up to 1.49 in some sets)
+    // Let's use the standard 47-piece metric set:
+    1.01, 1.02, 1.03, 1.04, 1.05, 1.06, 1.07, 1.08, 1.09,
+    // Series 3: 0.5 step
+    1.10, 1.20, 1.30, 1.40, 1.50, 1.60, 1.70, 1.80, 1.90,
+    // Series 4: whole mm
+    1, 2, 3, 4, 5, 6, 7, 8, 9,
+    // Series 5: tens
+    10, 20, 30, 40, 50, 60, 70, 80, 90, 100,
+];
+/**
+ * Metric 88-piece gauge block set (mm) — extended precision
+ */
+const METRIC_88_SET = [
+    // 0.001 step: 1.001-1.009
+    1.001, 1.002, 1.003, 1.004, 1.005, 1.006, 1.007, 1.008, 1.009,
+    // 0.01 step: 1.01-1.49
+    1.01, 1.02, 1.03, 1.04, 1.05, 1.06, 1.07, 1.08, 1.09,
+    1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19,
+    1.20, 1.21, 1.22, 1.23, 1.24, 1.25, 1.26, 1.27, 1.28, 1.29,
+    1.30, 1.31, 1.32, 1.33, 1.34, 1.35, 1.36, 1.37, 1.38, 1.39,
+    1.40, 1.41, 1.42, 1.43, 1.44, 1.45, 1.46, 1.47, 1.48, 1.49,
+    // whole mm: 1-9
+    1, 2, 3, 4, 5, 6, 7, 8, 9,
+    // tens: 10-100
+    10, 20, 30, 40, 50, 60, 70, 80, 90, 100,
+];
+/**
+ * Inch 81-piece gauge block set
+ */
+const INCH_81_SET = [
+    // 0.0001 step: 0.1001-0.1009
+    0.1001, 0.1002, 0.1003, 0.1004, 0.1005, 0.1006, 0.1007, 0.1008, 0.1009,
+    // 0.001 step: 0.101-0.149
+    0.101, 0.102, 0.103, 0.104, 0.105, 0.106, 0.107, 0.108, 0.109,
+    0.110, 0.111, 0.112, 0.113, 0.114, 0.115, 0.116, 0.117, 0.118, 0.119,
+    0.120, 0.121, 0.122, 0.123, 0.124, 0.125, 0.126, 0.127, 0.128, 0.129,
+    0.130, 0.131, 0.132, 0.133, 0.134, 0.135, 0.136, 0.137, 0.138, 0.139,
+    0.140, 0.141, 0.142, 0.143, 0.144, 0.145, 0.146, 0.147, 0.148, 0.149,
+    // 0.050 step: 0.050-0.950
+    0.050, 0.100, 0.150, 0.200, 0.250, 0.300, 0.350, 0.400, 0.450,
+    0.500, 0.550, 0.600, 0.650, 0.700, 0.750, 0.800, 0.850, 0.900, 0.950,
+    // whole: 1.000-4.000
+    1.000, 2.000, 3.000, 4.000,
+];
+const SETS = {
+    metric47: METRIC_47_SET,
+    metric88: METRIC_88_SET,
+    inch81: INCH_81_SET,
+};
+/**
+ * Build a gauge block stack using successive subtraction algorithm.
+ *
+ * The algorithm works from the smallest digit up:
+ * 1. Find a block that eliminates the least significant digit
+ * 2. Subtract it from the remaining target
+ * 3. Repeat until the remaining target is 0 or no suitable block is found
+ *
+ * @reference Oberg, E. et al. "Machinery's Handbook", 31st Ed. — Gauge blocks.
+ *
+ * @param input - Gauge block stack parameters
+ * @returns GaugeBlockStackResult with selected blocks and error
+ */
+export function gaugeBlockStack(input) {
+    const { targetDimension, availableSet = 'metric47' } = input;
+    const setBlocks = SETS[availableSet];
+    const used = new Set();
+    const blocks = [];
+    let remaining = roundTo(targetDimension, 4);
+    // Successive subtraction algorithm (Machinery's Handbook method):
+    // 1. Find a block that, when subtracted, eliminates the least significant non-zero digit
+    // 2. Prefer blocks that reduce the number of significant decimal places
+    // 3. Repeat until remaining is 0 or no suitable block found
+    for (let iter = 0; iter < 10 && remaining > 0.0005; iter++) {
+        let bestBlock = null;
+        let bestScore = -Infinity;
+        for (const block of setBlocks) {
+            if (used.has(block))
+                continue;
+            if (block > remaining + 0.00005)
+                continue;
+            const newRemaining = roundTo(remaining - block, 4);
+            if (newRemaining < -0.00005)
+                continue;
+            // Score: prefer blocks that eliminate more decimal places
+            // Count trailing zeros in newRemaining (fewer significant decimals = better)
+            const score = trailingZeroScore(newRemaining);
+            if (score > bestScore || (score === bestScore && block > (bestBlock ?? 0))) {
+                bestScore = score;
+                bestBlock = block;
+            }
+        }
+        if (bestBlock === null)
+            break;
+        used.add(bestBlock);
+        blocks.push(bestBlock);
+        remaining = roundTo(remaining - bestBlock, 4);
+    }
+    const totalDimension = roundTo(blocks.reduce((sum, b) => sum + b, 0), 4);
+    return {
+        targetDimension,
+        blocks: blocks.sort((a, b) => b - a),
+        totalDimension,
+        error: roundTo(Math.abs(targetDimension - totalDimension), 4),
+        blockCount: blocks.length,
+    };
+}
+/**
+ * Score how "clean" a number is — higher score means fewer significant decimal digits.
+ * 0 → score 4, X.X → score 3, X.XX → score 2, X.XXX → score 1, X.XXXX → score 0
+ */
+function trailingZeroScore(value) {
+    if (Math.abs(value) < 0.00005)
+        return 4;
+    const s = value.toFixed(4);
+    const decimals = s.split('.')[1] ?? '';
+    let zeros = 0;
+    for (let i = decimals.length - 1; i >= 0; i--) {
+        if (decimals[i] === '0')
+            zeros++;
+        else
+            break;
+    }
+    return zeros;
+}
+//# sourceMappingURL=gaugeBlockStack.js.map

package/dist/machining/gaugeBlockStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaugeBlockStack.js","sourceRoot":"","sources":["../../src/machining/gaugeBlockStack.ts"],"names":[],"mappings":"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"}

package/dist/machining/index.d.ts

@@ -0,0 +1,14 @@
+export type { TruePositionInput, TruePositionResult, BoltCircleInput, BoltHole, BoltCircleResult, SineBarHeightInput, SineBarHeightResult, RadialChipThinningInput, RadialChipThinningResult, ToolMaterial, ToolDeflectionInput, ToolDeflectionResult, CuspHeightInput, CuspHeightResult, EffectiveDiameterInput, EffectiveDiameterResult, BoringBarMaterial, BoringBarDeflectionInput, BoringBarDeflectionResult, ThreadAngle, ThreadOverWiresInput, ThreadOverWiresResult, GaugeBlockStackInput, GaugeBlockStackResult, TriangleSolverInput, TriangleSolverResult, CycleTimeOperation, CycleTimeEstimatorInput, CycleTimeEstimatorResult, } from './types.js';
+export { truePosition } from './truePosition.js';
+export { boltCircle } from './boltCircle.js';
+export { sineBarHeight } from './sineBarHeight.js';
+export { radialChipThinning } from './radialChipThinning.js';
+export { toolDeflection } from './toolDeflection.js';
+export { cuspHeight } from './cuspHeight.js';
+export { effectiveDiameter } from './effectiveDiameter.js';
+export { boringBarDeflection } from './boringBarDeflection.js';
+export { threadOverWires } from './threadOverWires.js';
+export { gaugeBlockStack } from './gaugeBlockStack.js';
+export { triangleSolver } from './triangleSolver.js';
+export { cycleTimeEstimator } from './cycleTimeEstimator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machining/index.ts"],"names":[],"mappings":"AACA,YAAY,EAEV,iBAAiB,EACjB,kBAAkB,EAElB,eAAe,EACf,QAAQ,EACR,gBAAgB,EAEhB,kBAAkB,EAClB,mBAAmB,EAEnB,uBAAuB,EACvB,wBAAwB,EAExB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EAEpB,eAAe,EACf,gBAAgB,EAEhB,sBAAsB,EACtB,uBAAuB,EAEvB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EAEzB,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EAErB,oBAAoB,EACpB,qBAAqB,EAErB,mBAAmB,EACnB,oBAAoB,EAEpB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/machining/index.js

@@ -0,0 +1,14 @@
+// Functions
+export { truePosition } from './truePosition.js';
+export { boltCircle } from './boltCircle.js';
+export { sineBarHeight } from './sineBarHeight.js';
+export { radialChipThinning } from './radialChipThinning.js';
+export { toolDeflection } from './toolDeflection.js';
+export { cuspHeight } from './cuspHeight.js';
+export { effectiveDiameter } from './effectiveDiameter.js';
+export { boringBarDeflection } from './boringBarDeflection.js';
+export { threadOverWires } from './threadOverWires.js';
+export { gaugeBlockStack } from './gaugeBlockStack.js';
+export { triangleSolver } from './triangleSolver.js';
+export { cycleTimeEstimator } from './cycleTimeEstimator.js';
+//# sourceMappingURL=index.js.map

package/dist/machining/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/machining/index.ts"],"names":[],"mappings":"AA6CA,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/machining/radialChipThinning.d.ts

@@ -0,0 +1,18 @@
+import type { RadialChipThinningInput, RadialChipThinningResult } from './types.js';
+/**
+ * Calculate adjusted feed per tooth to compensate for radial chip thinning.
+ *
+ * When ae < D/2, the actual chip thickness is less than the programmed fz.
+ * This function computes the adjusted (higher) fz needed to maintain the target chip load.
+ *
+ * @formula
+ *   chipThinningFactor = D / (2 × √(ae × (D − ae)))
+ *   adjustedFz = fz_target × chipThinningFactor
+ *
+ * @reference Harvey Tool — Radial Chip Thinning guide.
+ *
+ * @param input - Chip thinning parameters
+ * @returns RadialChipThinningResult with adjusted feed and thinning factor
+ */
+export declare function radialChipThinning(input: RadialChipThinningInput): RadialChipThinningResult;
+//# sourceMappingURL=radialChipThinning.d.ts.map

package/dist/machining/radialChipThinning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radialChipThinning.d.ts","sourceRoot":"","sources":["../../src/machining/radialChipThinning.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEpF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,wBAAwB,CAe3F"}

package/dist/machining/radialChipThinning.js

@@ -0,0 +1,30 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate adjusted feed per tooth to compensate for radial chip thinning.
+ *
+ * When ae < D/2, the actual chip thickness is less than the programmed fz.
+ * This function computes the adjusted (higher) fz needed to maintain the target chip load.
+ *
+ * @formula
+ *   chipThinningFactor = D / (2 × √(ae × (D − ae)))
+ *   adjustedFz = fz_target × chipThinningFactor
+ *
+ * @reference Harvey Tool — Radial Chip Thinning guide.
+ *
+ * @param input - Chip thinning parameters
+ * @returns RadialChipThinningResult with adjusted feed and thinning factor
+ */
+export function radialChipThinning(input) {
+    const { toolDiameter, radialDepthOfCut, chipLoadTarget } = input;
+    const D = toolDiameter;
+    const ae = radialDepthOfCut;
+    // Factor = D / (2 × √(ae × (D - ae)))
+    const factor = D / (2 * Math.sqrt(ae * (D - ae)));
+    const adjustedFz = chipLoadTarget * factor;
+    return {
+        adjustedFeedPerTooth: roundTo(adjustedFz, 4),
+        chipThinningFactor: roundTo(factor, 4),
+        effectiveChipLoad: roundTo(chipLoadTarget, 4),
+    };
+}
+//# sourceMappingURL=radialChipThinning.js.map

package/dist/machining/radialChipThinning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radialChipThinning.js","sourceRoot":"","sources":["../../src/machining/radialChipThinning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAEjE,MAAM,CAAC,GAAG,YAAY,CAAC;IACvB,MAAM,EAAE,GAAG,gBAAgB,CAAC;IAE5B,sCAAsC;IACtC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,cAAc,GAAG,MAAM,CAAC;IAE3C,OAAO;QACL,oBAAoB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5C,kBAAkB,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,iBAAiB,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/dist/machining/sineBarHeight.d.ts

@@ -0,0 +1,16 @@
+import type { SineBarHeightInput, SineBarHeightResult } from './types.js';
+/**
+ * Calculate the gauge block height for a sine bar setup.
+ *
+ * @formula
+ *   H = L × sin(θ)
+ *   actualAngle = arcsin(roundedH / L)
+ *   error = actualAngle − θ
+ *
+ * @reference Oberg, E. et al. "Machinery's Handbook", 31st Ed. — Sine Bar section.
+ *
+ * @param input - Sine bar parameters
+ * @returns SineBarHeightResult with exact and optionally rounded height
+ */
+export declare function sineBarHeight(input: SineBarHeightInput): SineBarHeightResult;
+//# sourceMappingURL=sineBarHeight.d.ts.map

package/dist/machining/sineBarHeight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sineBarHeight.d.ts","sourceRoot":"","sources":["../../src/machining/sineBarHeight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAqB5E"}

package/dist/machining/sineBarHeight.js

@@ -0,0 +1,32 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate the gauge block height for a sine bar setup.
+ *
+ * @formula
+ *   H = L × sin(θ)
+ *   actualAngle = arcsin(roundedH / L)
+ *   error = actualAngle − θ
+ *
+ * @reference Oberg, E. et al. "Machinery's Handbook", 31st Ed. — Sine Bar section.
+ *
+ * @param input - Sine bar parameters
+ * @returns SineBarHeightResult with exact and optionally rounded height
+ */
+export function sineBarHeight(input) {
+    const { angle, sineBarLength, roundToBlock } = input;
+    const angleRad = (angle * Math.PI) / 180;
+    const height = sineBarLength * Math.sin(angleRad);
+    const result = {
+        height: roundTo(height, 4),
+    };
+    if (roundToBlock !== undefined && roundToBlock > 0) {
+        const rounded = Math.round(height / roundToBlock) * roundToBlock;
+        result.roundedHeight = roundTo(rounded, 4);
+        const actualAngleRad = Math.asin(rounded / sineBarLength);
+        const actualAngleDeg = (actualAngleRad * 180) / Math.PI;
+        result.actualAngle = roundTo(actualAngleDeg, 6);
+        result.angleError = roundTo(actualAngleDeg - angle, 6);
+    }
+    return result;
+}
+//# sourceMappingURL=sineBarHeight.js.map

package/dist/machining/sineBarHeight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sineBarHeight.js","sourceRoot":"","sources":["../../src/machining/sineBarHeight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAErD,MAAM,QAAQ,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACzC,MAAM,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAElD,MAAM,MAAM,GAAwB;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC3B,CAAC;IAEF,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC;QACjE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAE3C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,cAAc,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/machining/threadOverWires.d.ts

@@ -0,0 +1,21 @@
+import type { ThreadOverWiresInput, ThreadOverWiresResult } from './types.js';
+/**
+ * Calculate thread measurement over wires (3-wire method).
+ *
+ * @formula (for 60° thread angle — metric/unified):
+ *   bestWire = P / √3 ≈ 0.57735 × P
+ *   d₂ = d − 0.6495 × P  (pitch diameter for 60°)
+ *   M = d₂ + 3W − 1.5155 × P
+ *
+ * General formula:
+ *   bestWire = P / (2 × cos(α/2))
+ *   For 55° (Whitworth): bestWire = P / (2 × cos(27.5°))
+ *   For 29° (Acme): bestWire = P / (2 × cos(14.5°))
+ *
+ * @reference Oberg, E. et al. "Machinery's Handbook", 31st Ed. — Thread measurement.
+ *
+ * @param input - Thread over wires parameters
+ * @returns ThreadOverWiresResult with measurement, best wire, and pitch diameter
+ */
+export declare function threadOverWires(input: ThreadOverWiresInput): ThreadOverWiresResult;
+//# sourceMappingURL=threadOverWires.d.ts.map

package/dist/machining/threadOverWires.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadOverWires.d.ts","sourceRoot":"","sources":["../../src/machining/threadOverWires.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAmClF"}

package/dist/machining/threadOverWires.js

@@ -0,0 +1,54 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate thread measurement over wires (3-wire method).
+ *
+ * @formula (for 60° thread angle — metric/unified):
+ *   bestWire = P / √3 ≈ 0.57735 × P
+ *   d₂ = d − 0.6495 × P  (pitch diameter for 60°)
+ *   M = d₂ + 3W − 1.5155 × P
+ *
+ * General formula:
+ *   bestWire = P / (2 × cos(α/2))
+ *   For 55° (Whitworth): bestWire = P / (2 × cos(27.5°))
+ *   For 29° (Acme): bestWire = P / (2 × cos(14.5°))
+ *
+ * @reference Oberg, E. et al. "Machinery's Handbook", 31st Ed. — Thread measurement.
+ *
+ * @param input - Thread over wires parameters
+ * @returns ThreadOverWiresResult with measurement, best wire, and pitch diameter
+ */
+export function threadOverWires(input) {
+    const { majorDiameter, pitch, threadAngle = 60 } = input;
+    const halfAngleRad = ((threadAngle / 2) * Math.PI) / 180;
+    const cosHalfAngle = Math.cos(halfAngleRad);
+    // Best wire size
+    const bestWire = pitch / (2 * cosHalfAngle);
+    const wireSize = input.wireSize ?? bestWire;
+    // Pitch diameter
+    let pitchDiameter;
+    if (threadAngle === 60) {
+        pitchDiameter = majorDiameter - 0.6495 * pitch;
+    }
+    else if (threadAngle === 55) {
+        pitchDiameter = majorDiameter - 0.6403 * pitch;
+    }
+    else if (threadAngle === 29) {
+        pitchDiameter = majorDiameter - 0.5 * pitch;
+    }
+    else {
+        // 30° (trapezoidal)
+        pitchDiameter = majorDiameter - 0.5 * pitch;
+    }
+    // Measurement over wires (M)
+    // General: M = d₂ + W × (1 + 1/sin(α/2)) - P × cot(α/2) / 2
+    // For 60°: M = d₂ + 3W - 1.5155P
+    const sinHalfAngle = Math.sin(halfAngleRad);
+    const M = pitchDiameter + wireSize * (1 + 1 / sinHalfAngle) - (pitch * cosHalfAngle) / (2 * sinHalfAngle);
+    return {
+        measurementOverWires: roundTo(M, 4),
+        bestWireSize: roundTo(bestWire, 4),
+        pitchDiameter: roundTo(pitchDiameter, 4),
+        wireSize: roundTo(wireSize, 4),
+    };
+}
+//# sourceMappingURL=threadOverWires.js.map

package/dist/machining/threadOverWires.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadOverWires.js","sourceRoot":"","sources":["../../src/machining/threadOverWires.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;IAEzD,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE5C,iBAAiB;IACjB,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAE5C,iBAAiB;IACjB,IAAI,aAAqB,CAAC;IAC1B,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACvB,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;IACjD,CAAC;SAAM,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QAC9B,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;IACjD,CAAC;SAAM,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QAC9B,aAAa,GAAG,aAAa,GAAG,GAAG,GAAG,KAAK,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,oBAAoB;QACpB,aAAa,GAAG,aAAa,GAAG,GAAG,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED,6BAA6B;IAC7B,4DAA4D;IAC5D,iCAAiC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,aAAa,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;IAE1G,OAAO;QACL,oBAAoB,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QACnC,YAAY,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/machining/toolDeflection.d.ts

@@ -0,0 +1,16 @@
+import type { ToolDeflectionInput, ToolDeflectionResult } from './types.js';
+/**
+ * Calculate end mill deflection using cantilever beam theory.
+ *
+ * @formula
+ *   I = π × d⁴ / 64
+ *   δ = F × L³ / (3 × E × I)
+ *   k = F / δ
+ *
+ * @reference Oberg, E. et al. "Machinery's Handbook", 31st Ed. — Beam deflection.
+ *
+ * @param input - Tool deflection parameters
+ * @returns ToolDeflectionResult with deflection, inertia, and stiffness
+ */
+export declare function toolDeflection(input: ToolDeflectionInput): ToolDeflectionResult;
+//# sourceMappingURL=toolDeflection.d.ts.map

package/dist/machining/toolDeflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDeflection.d.ts","sourceRoot":"","sources":["../../src/machining/toolDeflection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAgB,MAAM,YAAY,CAAC;AAU1F;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAgB/E"}

package/dist/machining/toolDeflection.js

@@ -0,0 +1,36 @@
+import { roundTo } from '../utils.js';
+/**
+ * Young's modulus for common tool materials (GPa)
+ */
+const TOOL_MODULUS = {
+    carbide: 550,
+    hss: 200,
+};
+/**
+ * Calculate end mill deflection using cantilever beam theory.
+ *
+ * @formula
+ *   I = π × d⁴ / 64
+ *   δ = F × L³ / (3 × E × I)
+ *   k = F / δ
+ *
+ * @reference Oberg, E. et al. "Machinery's Handbook", 31st Ed. — Beam deflection.
+ *
+ * @param input - Tool deflection parameters
+ * @returns ToolDeflectionResult with deflection, inertia, and stiffness
+ */
+export function toolDeflection(input) {
+    const { toolDiameter, stickout, cuttingForce, material = 'carbide' } = input;
+    const E = input.youngsModulus ?? TOOL_MODULUS[material];
+    const E_MPa = E * 1000; // GPa → MPa (N/mm²)
+    const I = (Math.PI * Math.pow(toolDiameter, 4)) / 64;
+    const delta = (cuttingForce * Math.pow(stickout, 3)) / (3 * E_MPa * I);
+    const stiffness = delta > 0 ? cuttingForce / delta : Infinity;
+    return {
+        deflection: roundTo(delta, 6),
+        momentOfInertia: roundTo(I, 4),
+        stiffness: roundTo(stiffness, 2),
+        youngsModulus: E,
+    };
+}
+//# sourceMappingURL=toolDeflection.js.map

package/dist/machining/toolDeflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDeflection.js","sourceRoot":"","sources":["../../src/machining/toolDeflection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;GAEG;AACH,MAAM,YAAY,GAAiC;IACjD,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;CACT,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IAE7E,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,oBAAoB;IAE5C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE9D,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7B,eAAe,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAChC,aAAa,EAAE,CAAC;KACjB,CAAC;AACJ,CAAC"}

package/dist/machining/triangleSolver.d.ts

@@ -0,0 +1,21 @@
+import type { TriangleSolverInput, TriangleSolverResult } from './types.js';
+/**
+ * Solve a triangle given at least 3 known values (sides/angles).
+ *
+ * Supported cases:
+ * - SSS: three sides → law of cosines
+ * - SAS: two sides + included angle → law of cosines
+ * - ASA/AAS: two angles + one side → law of sines
+ * - SSA: two sides + non-included angle → law of sines (ambiguous case)
+ *
+ * @formula
+ *   Law of cosines: c² = a² + b² − 2ab·cos(C)
+ *   Law of sines: a/sin(A) = b/sin(B) = c/sin(C)
+ *   Area (Heron): √(s(s−a)(s−b)(s−c)), s = (a+b+c)/2
+ *
+ * @param input - Triangle sides and/or angles (degrees)
+ * @returns TriangleSolverResult with all sides, angles, area, and perimeter
+ * @throws Error if insufficient or invalid input
+ */
+export declare function triangleSolver(input: TriangleSolverInput): TriangleSolverResult;
+//# sourceMappingURL=triangleSolver.d.ts.map

package/dist/machining/triangleSolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triangleSolver.d.ts","sourceRoot":"","sources":["../../src/machining/triangleSolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAK5E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CA2F/E"}

package/dist/machining/triangleSolver.js

@@ -0,0 +1,120 @@
+import { roundTo } from '../utils.js';
+const DEG = Math.PI / 180;
+const RAD = 180 / Math.PI;
+/**
+ * Solve a triangle given at least 3 known values (sides/angles).
+ *
+ * Supported cases:
+ * - SSS: three sides → law of cosines
+ * - SAS: two sides + included angle → law of cosines
+ * - ASA/AAS: two angles + one side → law of sines
+ * - SSA: two sides + non-included angle → law of sines (ambiguous case)
+ *
+ * @formula
+ *   Law of cosines: c² = a² + b² − 2ab·cos(C)
+ *   Law of sines: a/sin(A) = b/sin(B) = c/sin(C)
+ *   Area (Heron): √(s(s−a)(s−b)(s−c)), s = (a+b+c)/2
+ *
+ * @param input - Triangle sides and/or angles (degrees)
+ * @returns TriangleSolverResult with all sides, angles, area, and perimeter
+ * @throws Error if insufficient or invalid input
+ */
+export function triangleSolver(input) {
+    let { a, b, c, A, B, C } = input;
+    // Count known values
+    const knownSides = [a, b, c].filter(v => v !== undefined).length;
+    const knownAngles = [A, B, C].filter(v => v !== undefined).length;
+    // If two angles known, compute the third
+    if (knownAngles === 2) {
+        if (A === undefined)
+            A = 180 - B - C;
+        else if (B === undefined)
+            B = 180 - A - C;
+        else if (C === undefined)
+            C = 180 - A - B;
+    }
+    // SSS: three sides known
+    if (knownSides === 3 && a !== undefined && b !== undefined && c !== undefined) {
+        A = Math.acos((b * b + c * c - a * a) / (2 * b * c)) * RAD;
+        B = Math.acos((a * a + c * c - b * b) / (2 * a * c)) * RAD;
+        C = 180 - A - B;
+    }
+    // SAS: two sides + included angle
+    else if (knownSides === 2 && knownAngles >= 1) {
+        if (a !== undefined && b !== undefined && C !== undefined) {
+            c = Math.sqrt(a * a + b * b - 2 * a * b * Math.cos(C * DEG));
+            A = Math.asin((a * Math.sin(C * DEG)) / c) * RAD;
+            B = 180 - A - C;
+        }
+        else if (a !== undefined && c !== undefined && B !== undefined) {
+            b = Math.sqrt(a * a + c * c - 2 * a * c * Math.cos(B * DEG));
+            A = Math.asin((a * Math.sin(B * DEG)) / b) * RAD;
+            C = 180 - A - B;
+        }
+        else if (b !== undefined && c !== undefined && A !== undefined) {
+            a = Math.sqrt(b * b + c * c - 2 * b * c * Math.cos(A * DEG));
+            B = Math.asin((b * Math.sin(A * DEG)) / a) * RAD;
+            C = 180 - A - B;
+        }
+        // SSA (ambiguous): two sides + non-included angle
+        else if (a !== undefined && b !== undefined && A !== undefined) {
+            const sinB = (b * Math.sin(A * DEG)) / a;
+            if (sinB > 1)
+                throw new Error('No valid triangle exists');
+            B = Math.asin(sinB) * RAD;
+            C = 180 - A - B;
+            c = (a * Math.sin(C * DEG)) / Math.sin(A * DEG);
+        }
+        else if (a !== undefined && c !== undefined && A !== undefined) {
+            const sinC = (c * Math.sin(A * DEG)) / a;
+            if (sinC > 1)
+                throw new Error('No valid triangle exists');
+            C = Math.asin(sinC) * RAD;
+            B = 180 - A - C;
+            b = (a * Math.sin(B * DEG)) / Math.sin(A * DEG);
+        }
+        else if (b !== undefined && c !== undefined && B !== undefined) {
+            const sinC = (c * Math.sin(B * DEG)) / b;
+            if (sinC > 1)
+                throw new Error('No valid triangle exists');
+            C = Math.asin(sinC) * RAD;
+            A = 180 - B - C;
+            a = (b * Math.sin(A * DEG)) / Math.sin(B * DEG);
+        }
+    }
+    // ASA/AAS: two angles + one side (third angle already computed above)
+    else if (knownSides === 1 && knownAngles >= 2) {
+        if (A !== undefined && B !== undefined && C !== undefined) {
+            if (a !== undefined) {
+                b = (a * Math.sin(B * DEG)) / Math.sin(A * DEG);
+                c = (a * Math.sin(C * DEG)) / Math.sin(A * DEG);
+            }
+            else if (b !== undefined) {
+                a = (b * Math.sin(A * DEG)) / Math.sin(B * DEG);
+                c = (b * Math.sin(C * DEG)) / Math.sin(B * DEG);
+            }
+            else if (c !== undefined) {
+                a = (c * Math.sin(A * DEG)) / Math.sin(C * DEG);
+                b = (c * Math.sin(B * DEG)) / Math.sin(C * DEG);
+            }
+        }
+    }
+    if (a === undefined || b === undefined || c === undefined ||
+        A === undefined || B === undefined || C === undefined) {
+        throw new Error('Insufficient data to solve triangle');
+    }
+    // Heron's formula for area
+    const s = (a + b + c) / 2;
+    const area = Math.sqrt(s * (s - a) * (s - b) * (s - c));
+    return {
+        a: roundTo(a, 4),
+        b: roundTo(b, 4),
+        c: roundTo(c, 4),
+        A: roundTo(A, 4),
+        B: roundTo(B, 4),
+        C: roundTo(C, 4),
+        area: roundTo(area, 4),
+        perimeter: roundTo(a + b + c, 4),
+    };
+}
+//# sourceMappingURL=triangleSolver.js.map

package/dist/machining/triangleSolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triangleSolver.js","sourceRoot":"","sources":["../../src/machining/triangleSolver.ts"],"names":[],"mappings":"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"}

package/dist/machining/truePosition.d.ts

@@ -0,0 +1,19 @@
+import type { TruePositionInput, TruePositionResult } from './types.js';
+/**
+ * Calculate GD&T True Position (diametral method).
+ *
+ * @formula
+ *   Δx = actualX − nominalX
+ *   Δy = actualY − nominalY
+ *   radial = √(Δx² + Δy²)
+ *   TP = 2 × radial
+ *   MMC bonus = featureSize − mmcSize (when feature is larger than MMC)
+ *   effectiveTol = tolerance + bonus
+ *
+ * @reference ASME Y14.5-2018 — Positional tolerance.
+ *
+ * @param input - True position parameters
+ * @returns TruePositionResult with TP value and optional tolerance evaluation
+ */
+export declare function truePosition(input: TruePositionInput): TruePositionResult;
+//# sourceMappingURL=truePosition.d.ts.map

package/dist/machining/truePosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truePosition.d.ts","sourceRoot":"","sources":["../../src/machining/truePosition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA6BzE"}