formulab 0.5.1 → 0.9.0

package/CHANGELOG.md

@@ -5,6 +5,90 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.0] - 2026-02-09
+
+### Added
+
+- **Type Guards** — 8 runtime type guard functions for discriminated union inputs ([#2](https://github.com/iyulab/formulab/issues/2)):
+  - `isCRateInput()` — battery domain (mode: currentToRate | rateToCurrent)
+  - `isDilutionInput()` — chemical domain (solveFor: c1 | v1 | c2 | v2)
+  - `isReactorInput()` — chemical domain (shape: cylindrical | spherical)
+  - `isHeatTransferInput()` — chemical domain (mode: conduction | convection | radiation)
+  - `isMomentOfInertiaInput()` — construction domain (shape: 7 variants)
+  - `isOhmsLawInput()` — electronics domain (solveFor: voltage | current | resistance | power)
+  - `isMetalWeightInput()` — metal domain (shape: plate | round | pipe | angle)
+  - `isBoltInput()` — metal domain (mode: torqueToPreload | preloadToTorque)
+
+- **Error Behavior Specification** — `ERRORS.md` documenting error policy and per-function error behavior ([#1](https://github.com/iyulab/formulab/issues/1)):
+  - Defined error policy: validation failures → throw RangeError
+  - Documented all 174 functions' error behavior (throw / NaN / Infinity / null / safe)
+  - Identified 6 legacy NaN/Infinity patterns with migration roadmap to v0.10.0
+
+### Changed
+
+- Total function count: 174 → 182 (+8 type guards)
+
+## [0.7.0] - 2026-02-07
+
+### Added
+
+- **Quality** (+4 functions, 14 → 18):
+  - `gageRR()` — Gage R&R repeatability/reproducibility analysis (AIAG MSA 4th Edition)
+  - `cmk()` — Machine capability index Cm/Cmk (threshold ≥ 1.67)
+  - `weibull()` — Weibull reliability analysis with median rank regression
+  - `paretoAnalysis()` — Pareto 80/20 ABC classification
+
+- **Safety** (+5 functions, 9 → 14):
+  - `thermalComfort()` — PMV/PPD thermal comfort (ISO 7730 Fanger model)
+  - `ergonomicRisk()` — REBA ergonomic risk assessment scoring
+  - `arcFlash()` — Arc flash incident energy & PPE category (IEEE 1584/NFPA 70E)
+  - `confinedSpace()` — Confined space atmospheric assessment (OSHA 29 CFR 1910.146)
+  - `lel()` — Lower explosive limit for mixed gases (Le Chatelier's rule)
+
+- **Energy** (+4 functions, 11 → 15):
+  - `heatPump()` — Heat pump COP & Carnot efficiency with annual savings
+  - `degreeDay()` — Heating/Cooling degree day calculation (HDD/CDD)
+  - `windOutput()` — Wind turbine output with Rayleigh capacity factor
+  - `cusum()` — CUSUM energy anomaly detection (Page's algorithm)
+
+- **Chemical** (+3 functions, 9 → 12):
+  - `flowControl()` — Control valve Cv/Kv sizing (ISA/IEC 60534)
+  - `reliefValve()` — Safety relief valve sizing (API 520/526)
+  - `pid()` — PID controller tuning (Ziegler-Nichols / Cohen-Coon)
+
+- **Logistics** (+1 function, 16 → 17):
+  - `abcAnalysis()` — ABC inventory classification by annual value
+
+- **Food** (+2 functions, 4 → 6):
+  - `waterActivity()` — Water activity microbial growth risk (HACCP)
+  - `stabilityStudy()` — Accelerated stability study with Arrhenius regression (ICH Q1A)
+
+- **Automotive** (+1 function, 8 → 9):
+  - `chargingLoss()` — EV charging loss/efficiency with temperature derating
+
+### Changed
+
+- Total function count: 154 → 174 (+20)
+- Total domains: 14 (unchanged)
+
+## [0.6.0] - 2026-02-07
+
+### Added
+
+- **Energy** (+4 functions, 7 → 11):
+  - `boilerEfficiency()` — Boiler thermal efficiency (direct input-output method)
+  - `transformerLoss()` — Transformer loss calculation with optimal load point
+  - `insulationRoi()` — Insulation ROI with payback period
+  - `ledRoi()` — LED lighting retrofit ROI with CO2 savings
+
+- **Safety** (+2 functions, 7 → 9):
+  - `ladderAngle()` — Ladder safety angle calculation (OSHA 4:1 rule, 70°–80° compliance)
+  - `illuminance()` — Workplace illuminance calculation (Lumen Method with CU lookup)
+
+- **Logistics** (+2 functions, 14 → 16):
+  - `inventoryTurnover()` — Inventory turnover ratio, days/weeks of supply, GMROII
+  - `loadCapacity()` — Forklift load capacity derating with attachment loss
+
 ## [0.5.0] - 2026-02-07
 
 ### Added

package/README.md

@@ -11,7 +11,7 @@ A comprehensive collection of engineering formulas and calculations for manufact
 
 ## Features
 
-- **146 industrial calculations** — OEE, Cpk, SPC control charts, metal weight, CNC machining, GD&T, pipe flow, CBM, NIOSH lifting, battery SOH, GHG emissions, and more
+- **174 industrial calculations** — OEE, Cpk, SPC control charts, Gage R&R, Weibull, metal weight, CNC machining, GD&T, pipe flow, CBM, NIOSH lifting, PMV/PPD, arc flash, battery SOH, GHG emissions, PID tuning, and more
 - **14 specialized domains** — Quality, Metal, Chemical, Electronics, Construction, Automotive, Logistics, Energy, Safety, Food, Utility, Battery, Environmental, Machining
 - **Zero dependencies** — Lightweight and fast
 - **TypeScript first** — Full type definitions included
@@ -23,16 +23,16 @@ A comprehensive collection of engineering formulas and calculations for manufact
 
 | Domain | Functions | Golden Tests | Key References |
 |--------|-----------|-------------|----------------|
-| Quality | 14 | oee, cpk, controlChart | ISO 22400-2, AIAG/ASTM E2587, JIPM |
+| Quality | 18 | oee, cpk, controlChart, gageRR | ISO 22400-2, AIAG/ASTM E2587, JIPM, AIAG MSA |
 | Metal | 25 | metalWeight | Machinery's Handbook, ASME B36.10/B16.5 |
-| Logistics | 14 | cbm | Physical formula |
-| Safety | 7 | nioshLifting | NIOSH 94-110 |
-| Chemical | 9 | — | Darcy-Weisbach, Fourier |
+| Logistics | 17 | cbm | Physical formula |
+| Safety | 14 | nioshLifting | NIOSH 94-110, ISO 7730, IEEE 1584, OSHA |
+| Chemical | 12 | — | Darcy-Weisbach, Fourier, API 520, ISA |
 | Electronics | 11 | — | IPC-2221 |
 | Construction | 12 | — | AISC, Timoshenko |
-| Automotive | 8 | — | AASHTO |
-| Energy | 7 | — | NREL PVWatts |
-| Food | 4 | — | HACCP |
+| Automotive | 9 | — | AASHTO, SAE J1772 |
+| Energy | 15 | — | NREL PVWatts, ISO 50001 |
+| Food | 6 | — | HACCP, ICH Q1A |
 | Utility | 3 | — | — |
 | Battery | 10 | — | IEEE 1188, IEC 62620, Battery University |
 | Environmental | 10 | — | GHG Protocol, IPCC AR6, IEA 2023 |
@@ -157,10 +157,10 @@ console.log(volume.totalCbm); // 0.96 m³
 
 ## Domains
 
-### Quality & Production (14 functions)
+### Quality & Production (18 functions)
 
 ```typescript
-import { oee, cpk, taktTime, dpmo, controlChart } from 'formulab/quality';
+import { oee, cpk, taktTime, dpmo, controlChart, gageRR, weibull } from 'formulab/quality';
 ```
 
 | Function | Description |
@@ -179,6 +179,10 @@ import { oee, cpk, taktTime, dpmo, controlChart } from 'formulab/quality';
 | `ppm()` | Parts Per Million conversion |
 | `rpn()` | Risk Priority Number (FMEA) |
 | `yieldCalc()` | First Pass Yield / RTY |
+| `gageRR()` | Gage R&R (AIAG MSA Average & Range) |
+| `cmk()` | Machine capability index Cm/Cmk |
+| `weibull()` | Weibull reliability analysis |
+| `paretoAnalysis()` | Pareto 80/20 ABC classification |
 
 ### Metal & Machining (25 functions)
 
@@ -214,10 +218,10 @@ import { metalWeight, bendAllowance, cutting, bearing } from 'formulab/metal';
 | `pipeSpec()` | ANSI/ASME pipe dimensions lookup |
 | `flangeSpec()` | ASME B16.5 flange dimensions lookup |
 
-### Chemical & Process (9 functions)
+### Chemical & Process (12 functions)
 
 ```typescript
-import { dilution, concentration, ph, reactor, pipeFlow, heatTransfer } from 'formulab/chemical';
+import { dilution, concentration, ph, reactor, pipeFlow, heatTransfer, flowControl, pid } from 'formulab/chemical';
 ```
 
 | Function | Description |
@@ -231,6 +235,9 @@ import { dilution, concentration, ph, reactor, pipeFlow, heatTransfer } from 'fo
 | `reactor()` | Reactor sizing |
 | `shelfLife()` | Shelf life prediction (Arrhenius) |
 | `injectionCycle()` | Injection molding cycle time |
+| `flowControl()` | Control valve Cv/Kv sizing (ISA/IEC 60534) |
+| `reliefValve()` | Safety relief valve sizing (API 520/526) |
+| `pid()` | PID controller tuning (Z-N / Cohen-Coon) |
 
 ### Electronics & SMT (11 functions)
 
@@ -273,10 +280,10 @@ import { concreteMix, rebarWeight, slope, stair, momentOfInertia } from 'formula
 | `roof()` | Roof calculation |
 | `stair()` | Stair dimension calculation |
 
-### Automotive (8 functions)
+### Automotive (9 functions)
 
 ```typescript
-import { batteryRuntime, evCharging, torque, brakingDistance } from 'formulab/automotive';
+import { batteryRuntime, evCharging, torque, brakingDistance, chargingLoss } from 'formulab/automotive';
 ```
 
 | Function | Description |
@@ -289,22 +296,26 @@ import { batteryRuntime, evCharging, torque, brakingDistance } from 'formulab/au
 | `tireCompare()` | Tire size comparison |
 | `torque()` | Torque conversion |
 | `power()` | Power conversion (HP, kW) |
+| `chargingLoss()` | EV charging loss/efficiency |
 
-### Logistics & Inventory (14 functions)
+### Logistics & Inventory (17 functions)
 
 ```typescript
-import { cbm, eoq, safetyStock, kanban } from 'formulab/logistics';
+import { cbm, eoq, safetyStock, kanban, inventoryTurnover, abcAnalysis } from 'formulab/logistics';
 ```
 
 | Function | Description |
 |----------|-------------|
+| `abcAnalysis()` | ABC inventory classification by annual value |
 | `cbm()` | Cubic meter calculation |
 | `containerFit()` | Container capacity estimation |
 | `dimWeight()` | Dimensional weight |
 | `eoq()` | Economic Order Quantity |
 | `fillRate()` | Fill rate calculation |
 | `freightClass()` | NMFC freight class |
+| `inventoryTurnover()` | Inventory turnover ratio & days of supply |
 | `kanban()` | Kanban quantity |
+| `loadCapacity()` | Forklift load capacity derating |
 | `pallet3d()` | 3D pallet loading heuristic (BLF + FFD) |
 | `palletStack()` | Pallet stacking calculation |
 | `pickTime()` | Picking time estimation |
@@ -313,42 +324,57 @@ import { cbm, eoq, safetyStock, kanban } from 'formulab/logistics';
 | `shipping()` | Shipping cost estimation |
 | `tsp()` | TSP heuristic (NN + 2-Opt; exact for n ≤ 10) |
 
-### Energy & Utilities (7 functions)
+### Energy & Utilities (15 functions)
 
 ```typescript
-import { powerCost, motorEfficiency, carbonFootprint, solarOutput } from 'formulab/energy';
+import { powerCost, motorEfficiency, carbonFootprint, solarOutput, boilerEfficiency, heatPump, cusum } from 'formulab/energy';
 ```
 
 | Function | Description |
 |----------|-------------|
-| `solarOutput()` | Solar panel output estimation (PVWatts-based) |
+| `boilerEfficiency()` | Boiler thermal efficiency (direct method) |
 | `carbonFootprint()` | Scope 2 emissions |
 | `compressedAirCost()` | Compressed air cost |
+| `cusum()` | CUSUM energy anomaly detection |
+| `degreeDay()` | Heating/Cooling degree days (HDD/CDD) |
+| `heatPump()` | Heat pump COP & Carnot efficiency |
+| `insulationRoi()` | Insulation ROI & payback |
+| `ledRoi()` | LED lighting retrofit ROI |
 | `motorEfficiency()` | Motor upgrade ROI |
 | `pfCorrection()` | Power factor correction |
 | `powerCost()` | Electricity cost with demand |
+| `solarOutput()` | Solar panel output estimation (PVWatts-based) |
+| `transformerLoss()` | Transformer loss & efficiency |
 | `vfdSavings()` | VFD energy savings |
+| `windOutput()` | Wind turbine output with Rayleigh CF |
 
-### Safety & Ergonomics (7 functions)
+### Safety & Ergonomics (14 functions)
 
 ```typescript
-import { nioshLifting, noiseExposure, wbgtCalculate, ventilationRate } from 'formulab/safety';
+import { nioshLifting, noiseExposure, wbgtCalculate, ventilationRate, thermalComfort, arcFlash, lel } from 'formulab/safety';
 ```
 
 | Function | Description |
 |----------|-------------|
-| `ventilationRate()` | Required ventilation ACH/CFM (ASHRAE/OSHA) |
+| `arcFlash()` | Arc flash incident energy & PPE (IEEE 1584) |
+| `confinedSpace()` | Confined space atmospheric assessment (OSHA) |
+| `ergonomicRisk()` | REBA ergonomic risk scoring |
 | `fallClearance()` | Fall protection clearance |
+| `havsCalculate()` | Hand-arm vibration exposure |
+| `illuminance()` | Workplace illuminance (Lumen Method) |
+| `ladderAngle()` | Ladder safety angle (OSHA 4:1) |
+| `lel()` | Mixed gas LEL (Le Chatelier's rule) |
 | `nioshLifting()` | NIOSH lifting equation |
 | `noiseExposure()` | TWA/Dose calculation |
-| `wbgtCalculate()` | WBGT heat stress index |
-| `havsCalculate()` | Hand-arm vibration exposure |
 | `respiratorCalculate()` | Respirator MUC calculation |
+| `thermalComfort()` | PMV/PPD thermal comfort (ISO 7730) |
+| `ventilationRate()` | Required ventilation ACH/CFM (ASHRAE/OSHA) |
+| `wbgtCalculate()` | WBGT heat stress index |
 
-### Food & HACCP (4 functions)
+### Food & HACCP (6 functions)
 
 ```typescript
-import { calorie, nutrition, haccp } from 'formulab/food';
+import { calorie, nutrition, haccp, waterActivity, stabilityStudy } from 'formulab/food';
 ```
 
 | Function | Description |
@@ -357,6 +383,8 @@ import { calorie, nutrition, haccp } from 'formulab/food';
 | `expiry()` | Expiry date calculation |
 | `nutrition()` | Nutrition facts calculation |
 | `haccp()` | HACCP checklist generation |
+| `waterActivity()` | Water activity microbial risk (HACCP) |
+| `stabilityStudy()` | Accelerated stability (Arrhenius, ICH Q1A) |
 
 ### Utility (3 functions)
 
@@ -499,6 +527,42 @@ console.log(result);
 // }
 ```
 
+## Type Guards for Discriminated Unions
+
+formulab provides runtime type guard functions for all [discriminated union](https://www.typescriptlang.org/docs/handbook/2/narrowing.html#discriminated-unions) input types. These enable type-safe integration when working with dynamic data (e.g., form inputs, API responses):
+
+```typescript
+import { isCRateInput, cRate } from 'formulab/battery';
+
+// Form data from user input (Record<string, unknown>)
+const formData: unknown = { mode: 'currentToRate', capacityAh: 100, currentA: 50 };
+
+if (isCRateInput(formData)) {
+  const result = cRate(formData); // Type-safe, no 'as any' needed
+}
+```
+
+### Available Type Guards
+
+| Guard | Domain | Discriminant | Variants |
+|-------|--------|-------------|----------|
+| `isCRateInput()` | battery | `mode` | currentToRate, rateToCurrent |
+| `isDilutionInput()` | chemical | `solveFor` | c1, v1, c2, v2 |
+| `isReactorInput()` | chemical | `shape` | cylindrical, spherical |
+| `isHeatTransferInput()` | chemical | `mode` | conduction, convection, radiation |
+| `isMomentOfInertiaInput()` | construction | `shape` | rectangle, circle, hollowRectangle, hollowCircle, iBeam, tSection, cChannel |
+| `isOhmsLawInput()` | electronics | `solveFor` | voltage, current, resistance, power |
+| `isMetalWeightInput()` | metal | `shape` | plate, round, pipe, angle |
+| `isBoltInput()` | metal | `mode` | torqueToPreload, preloadToTorque |
+
+## Error Handling
+
+See [ERRORS.md](./ERRORS.md) for the complete error behavior specification. Key points:
+
+- **Validation failures** throw `RangeError` with descriptive messages
+- **Legacy NaN/Infinity patterns** are documented and scheduled for migration
+- Each function's error behavior is documented in the specification
+
 ## Tree Shaking
 
 Import only what you need to minimize bundle size:

package/dist/automotive/chargingLoss.d.ts

@@ -0,0 +1,15 @@
+import type { ChargingLossInput, ChargingLossResult } from './types.js';
+/**
+ * EV Charging Loss Calculator
+ *
+ * @formula
+ *   - energyDelivered = batteryCapacity × (targetSoc − soc) / 100
+ *   - energyConsumed = energyDelivered / (chargerEff × batteryEff)
+ *   - totalLoss = energyConsumed − energyDelivered
+ *   - chargingTime = energyConsumed / effectivePower
+ *
+ * @reference SAE J1772 — Electric Vehicle Charging
+ * @reference IEC 61851 — Electric vehicle conductive charging system
+ */
+export declare function chargingLoss(input: ChargingLossInput): ChargingLossResult;
+//# sourceMappingURL=chargingLoss.d.ts.map

package/dist/automotive/chargingLoss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chargingLoss.d.ts","sourceRoot":"","sources":["../../src/automotive/chargingLoss.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASxE;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAiDzE"}

package/dist/automotive/chargingLoss.js

@@ -0,0 +1,62 @@
+import { roundTo } from '../utils.js';
+// Default charger efficiencies by type
+const DEFAULT_CHARGER_EFFICIENCY = {
+    ac_l1: 0.85,
+    ac_l2: 0.90,
+    dc_fast: 0.93,
+};
+/**
+ * EV Charging Loss Calculator
+ *
+ * @formula
+ *   - energyDelivered = batteryCapacity × (targetSoc − soc) / 100
+ *   - energyConsumed = energyDelivered / (chargerEff × batteryEff)
+ *   - totalLoss = energyConsumed − energyDelivered
+ *   - chargingTime = energyConsumed / effectivePower
+ *
+ * @reference SAE J1772 — Electric Vehicle Charging
+ * @reference IEC 61851 — Electric vehicle conductive charging system
+ */
+export function chargingLoss(input) {
+    const { batteryCapacity, chargerPower, chargerType, batteryEfficiency = 0.95, soc, ambientTemp, } = input;
+    const chargerEfficiency = input.chargerEfficiency ?? DEFAULT_CHARGER_EFFICIENCY[chargerType] ?? 0.90;
+    const targetSoc = input.targetSoc ?? (chargerType === 'dc_fast' ? 80 : 100);
+    // Temperature derating
+    let derating = 1.0;
+    if (ambientTemp != null) {
+        if (ambientTemp < 0) {
+            derating = 0.70; // Cold weather significant derating
+        }
+        else if (ambientTemp < 10) {
+            derating = 0.85;
+        }
+        else if (ambientTemp > 40) {
+            derating = 0.90;
+        }
+        else if (ambientTemp > 35) {
+            derating = 0.95;
+        }
+    }
+    const effectivePower = chargerPower * derating;
+    // Energy calculations
+    const energyDelivered = batteryCapacity * (targetSoc - soc) / 100;
+    const overallEff = chargerEfficiency * batteryEfficiency;
+    const energyConsumed = overallEff > 0 ? energyDelivered / overallEff : 0;
+    const totalLoss = energyConsumed - energyDelivered;
+    // Loss breakdown
+    const chargerLoss = energyConsumed * (1 - chargerEfficiency);
+    const batteryLoss = (energyConsumed - chargerLoss) * (1 - batteryEfficiency);
+    // Charging time
+    const chargingTime = effectivePower > 0 ? energyConsumed / effectivePower : 0;
+    return {
+        energyDelivered: roundTo(energyDelivered, 2),
+        energyConsumed: roundTo(energyConsumed, 2),
+        totalLoss: roundTo(totalLoss, 2),
+        overallEfficiency: roundTo(overallEff * 100, 2),
+        chargerLoss: roundTo(chargerLoss, 2),
+        batteryLoss: roundTo(batteryLoss, 2),
+        chargingTime: roundTo(chargingTime, 2),
+        effectivePower: roundTo(effectivePower, 2),
+    };
+}
+//# sourceMappingURL=chargingLoss.js.map

package/dist/automotive/chargingLoss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chargingLoss.js","sourceRoot":"","sources":["../../src/automotive/chargingLoss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,uCAAuC;AACvC,MAAM,0BAA0B,GAA2B;IACzD,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;CACd,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EACJ,eAAe,EAAE,YAAY,EAAE,WAAW,EAC1C,iBAAiB,GAAG,IAAI,EACxB,GAAG,EAAE,WAAW,GACjB,GAAG,KAAK,CAAC;IAEV,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,IAAI,0BAA0B,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;IACrG,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE5E,uBAAuB;IACvB,IAAI,QAAQ,GAAG,GAAG,CAAC;IACnB,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,CAAC,CAAC,oCAAoC;QACvD,CAAC;aAAM,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YAC5B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YAC5B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;YAC5B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,CAAC;IAE/C,sBAAsB;IACtB,MAAM,eAAe,GAAG,eAAe,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAClE,MAAM,UAAU,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;IACzD,MAAM,cAAc,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,cAAc,GAAG,eAAe,CAAC;IAEnD,iBAAiB;IACjB,MAAM,WAAW,GAAG,cAAc,GAAG,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAE7E,gBAAgB;IAChB,MAAM,YAAY,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC5C,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1C,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAChC,iBAAiB,EAAE,OAAO,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/automotive/index.d.ts

@@ -6,5 +6,6 @@ export { gearRatio } from './gearRatio.js';
 export { tireCompare } from './tireCompare.js';
 export { torque } from './torque.js';
 export { power } from './power.js';
-export type { BrakingDistanceInput, BrakingDistanceResult, BatteryInput, BatteryResult, ChargingInput, ChargingResult, FuelUnit, FuelInput, FuelResult, GearRatioInput, GearRatioResult, TireSpec, TireInput, TireData, TireResult, TorqueUnit, TorqueInput, TorqueResult, PowerUnit, PowerInput, PowerResult, } from './types.js';
+export { chargingLoss } from './chargingLoss.js';
+export type { BrakingDistanceInput, BrakingDistanceResult, BatteryInput, BatteryResult, ChargingInput, ChargingResult, FuelUnit, FuelInput, FuelResult, GearRatioInput, GearRatioResult, TireSpec, TireInput, TireData, TireResult, TorqueUnit, TorqueInput, TorqueResult, PowerUnit, PowerInput, PowerResult, ChargingLossInput, ChargingLossResult, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/automotive/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,YAAY,EAEV,oBAAoB,EACpB,qBAAqB,EAErB,YAAY,EACZ,aAAa,EAEb,aAAa,EACb,cAAc,EAEd,QAAQ,EACR,SAAS,EACT,UAAU,EAEV,cAAc,EACd,eAAe,EAEf,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EAEV,UAAU,EACV,WAAW,EACX,YAAY,EAEZ,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/automotive/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAEV,oBAAoB,EACpB,qBAAqB,EAErB,YAAY,EACZ,aAAa,EAEb,aAAa,EACb,cAAc,EAEd,QAAQ,EACR,SAAS,EACT,UAAU,EAEV,cAAc,EACd,eAAe,EAEf,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EAEV,UAAU,EACV,WAAW,EACX,YAAY,EAEZ,SAAS,EACT,UAAU,EACV,WAAW,EAEX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/automotive/index.js

@@ -7,4 +7,5 @@ export { gearRatio } from './gearRatio.js';
 export { tireCompare } from './tireCompare.js';
 export { torque } from './torque.js';
 export { power } from './power.js';
+export { chargingLoss } from './chargingLoss.js';
 //# sourceMappingURL=index.js.map

package/dist/automotive/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/automotive/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/automotive/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/automotive/types.d.ts

@@ -127,4 +127,27 @@ export interface PowerResult {
     HP: number;
     PS: number;
 }
+/**
+ * EV Charging Loss Calculator Types
+ */
+export interface ChargingLossInput {
+    batteryCapacity: number;
+    chargerPower: number;
+    chargerType: 'ac_l1' | 'ac_l2' | 'dc_fast';
+    chargerEfficiency?: number;
+    batteryEfficiency?: number;
+    soc: number;
+    targetSoc?: number;
+    ambientTemp?: number;
+}
+export interface ChargingLossResult {
+    energyDelivered: number;
+    energyConsumed: number;
+    totalLoss: number;
+    overallEfficiency: number;
+    chargerLoss: number;
+    batteryLoss: number;
+    chargingTime: number;
+    effectivePower: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/automotive/types.d.ts.map

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

package/dist/battery/guards.d.ts

@@ -0,0 +1,7 @@
+import type { CRateInput } from './types.js';
+/**
+ * Runtime type guard for {@link CRateInput} discriminated union.
+ * Validates the `mode` discriminant and required fields for each variant.
+ */
+export declare function isCRateInput(input: unknown): input is CRateInput;
+//# sourceMappingURL=guards.d.ts.map

package/dist/battery/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/battery/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAShE"}

package/dist/battery/guards.js

@@ -0,0 +1,17 @@
+/**
+ * Runtime type guard for {@link CRateInput} discriminated union.
+ * Validates the `mode` discriminant and required fields for each variant.
+ */
+export function isCRateInput(input) {
+    if (typeof input !== 'object' || input === null)
+        return false;
+    const o = input;
+    if (typeof o.capacityAh !== 'number')
+        return false;
+    switch (o.mode) {
+        case 'currentToRate': return typeof o.currentA === 'number';
+        case 'rateToCurrent': return typeof o.cRate === 'number';
+        default: return false;
+    }
+}
+//# sourceMappingURL=guards.js.map

package/dist/battery/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/battery/guards.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACnD,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,eAAe,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC5D,KAAK,eAAe,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;QACzD,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/battery/index.d.ts

@@ -1,4 +1,5 @@
 export type { BatteryChemistry, EnergyDensityInput, EnergyDensityResult, CRateMode, CRateInput, CRateResult, StateOfHealthInput, SohStatus, StateOfHealthResult, BatteryPackConfigInput, BatteryPackConfigResult, CycleLifeInput, CycleLifeResult, InternalResistanceInput, InternalResistanceResult, SelfDischargeInput, SelfDischargeResult, ThermalRunawayInput, ThermalRunawayResult, BmsBalancingInput, BmsBalancingResult, ChargingProfileInput, ChargingProfileResult, } from './types.js';
+export { isCRateInput } from './guards.js';
 export { energyDensity } from './energyDensity.js';
 export { cRate } from './cRate.js';
 export { stateOfHealth } from './stateOfHealth.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/battery/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/battery/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/battery/index.js

@@ -1,3 +1,5 @@
+// Guards
+export { isCRateInput } from './guards.js';
 // Functions
 export { energyDensity } from './energyDensity.js';
 export { cRate } from './cRate.js';

package/dist/battery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/battery/index.ts"],"names":[],"mappings":"AA2BA,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/battery/index.ts"],"names":[],"mappings":"AA2BA,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/chemical/flowControl.d.ts

@@ -0,0 +1,14 @@
+import type { FlowControlInput, FlowControlResult } from './types.js';
+/**
+ * Control Valve Cv Calculator
+ *
+ * @formula
+ *   - Liquid: Cv = Q × √(SG / ΔP)  (Q in GPM, ΔP in psi)
+ *   - Gas: Cv = Q / (N × P1) × √(SG × T / ΔP)
+ *   - Kv = 0.865 × Cv
+ *
+ * @reference ISA-75.01.01-2012 — Flow equations for sizing control valves
+ * @reference IEC 60534-2-1 — Industrial-process control valves
+ */
+export declare function flowControl(input: FlowControlInput): FlowControlResult;
+//# sourceMappingURL=flowControl.d.ts.map

package/dist/chemical/flowControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowControl.d.ts","sourceRoot":"","sources":["../../src/chemical/flowControl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAkEtE"}

package/dist/chemical/flowControl.js

@@ -0,0 +1,69 @@
+import { roundTo } from '../utils.js';
+/**
+ * Control Valve Cv Calculator
+ *
+ * @formula
+ *   - Liquid: Cv = Q × √(SG / ΔP)  (Q in GPM, ΔP in psi)
+ *   - Gas: Cv = Q / (N × P1) × √(SG × T / ΔP)
+ *   - Kv = 0.865 × Cv
+ *
+ * @reference ISA-75.01.01-2012 — Flow equations for sizing control valves
+ * @reference IEC 60534-2-1 — Industrial-process control valves
+ */
+export function flowControl(input) {
+    const { flowRate, inletPressure, outletPressure, fluidDensity, fluidType, temperature = 20, molecularWeight, specificHeatRatio = 1.4, } = input;
+    const pressureDrop = inletPressure - outletPressure; // kPa
+    // Reference density: water = 999 kg/m³
+    const sg = fluidDensity / 999;
+    const pressureRatio = pressureDrop / inletPressure;
+    let cv;
+    let isChoked = false;
+    if (fluidType === 'liquid') {
+        // ISA liquid sizing: Cv = Q(m³/h) × √(SG / ΔP(bar))
+        // Convert kPa to bar: 1 bar = 100 kPa
+        const dpBar = pressureDrop / 100;
+        if (dpBar <= 0) {
+            cv = 0;
+        }
+        else {
+            cv = flowRate * Math.sqrt(sg / dpBar);
+        }
+    }
+    else {
+        // Gas/Steam sizing
+        // Critical pressure ratio for choked flow
+        const xT = 0.7; // typical for globe valve
+        const Fk = specificHeatRatio / 1.4;
+        const xCritical = Fk * xT;
+        const x = pressureDrop / inletPressure;
+        if (x >= xCritical) {
+            isChoked = true;
+        }
+        const xEffective = Math.min(x, xCritical);
+        const p1Bar = inletPressure / 100;
+        const T = temperature + 273.15;
+        const MW = molecularWeight ?? 29; // default air
+        // N8 = 94.8 for metric (m³/h, bar, K)
+        const N8 = 94.8;
+        const Y = 1 - xEffective / (3 * xCritical); // Expansion factor
+        if (p1Bar <= 0 || xEffective <= 0) {
+            cv = 0;
+        }
+        else {
+            cv = flowRate / (N8 * p1Bar * Y) * Math.sqrt(MW * T / xEffective);
+        }
+    }
+    const kv = cv * 0.865;
+    // Estimate pipe velocity (assuming DN50 pipe)
+    const pipeArea = Math.PI * (0.05 / 2) ** 2; // m²
+    const velocity = (flowRate / 3600) / pipeArea; // m/s
+    return {
+        cv: roundTo(cv, 2),
+        kv: roundTo(kv, 2),
+        pressureDrop: roundTo(pressureDrop, 2),
+        pressureRatio: roundTo(pressureRatio, 4),
+        isChoked,
+        velocity: roundTo(velocity, 2),
+    };
+}
+//# sourceMappingURL=flowControl.js.map