formulab 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,144 @@
+# Changelog
+
+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.1.0] - 2025-02-05
+
+### Added
+
+Initial release with 103 calculation functions across 11 domains.
+
+#### Quality & Production (13 functions)
+- `oee()` - Overall Equipment Effectiveness calculation
+- `cpk()` - Process Capability Index
+- `cycleTime()` - Cycle Time analysis
+- `taktTime()` - Takt Time calculation
+- `aql()` - AQL sampling inspection (ISO 2859-1)
+- `downtime()` - Downtime analysis
+- `dpmo()` - Defects Per Million Opportunities
+- `lineBalancing()` - Line balancing optimization
+- `mtbf()` - Mean Time Between Failures
+- `ppk()` - Process Performance Index
+- `ppm()` - Parts Per Million conversion
+- `rpn()` - Risk Priority Number (FMEA)
+- `yieldCalc()` - First Pass Yield / RTY
+
+#### Metal & Machining (22 functions)
+- `metalWeight()` - Weight calculation for various shapes
+- `bendAllowance()` - Sheet metal bend allowance
+- `flatPattern()` - Flat pattern length calculation
+- `kFactorReverse()` - K-factor reverse engineering
+- `pressTonnage()` - Press brake tonnage
+- `bearing()` - L10 bearing life calculation
+- `bolt()` - Bolt torque and preload
+- `cutting()` - Cutting speed, feed rate, RPM
+- `cuttingStock()` - 1D cutting optimization
+- `gear()` - Gear module calculation
+- `hardness()` - Hardness conversion (HRC, HB, HV)
+- `material()` - Material properties lookup
+- `pressFit()` - Press fit interference
+- `roughness()` - Surface roughness conversion
+- `screw()` - Screw specification
+- `spring()` - Spring design calculation
+- `tap()` - Tap drill size
+- `thread()` - Thread dimensions
+- `tolerance()` - ISO tolerance (IT grades)
+- `vibration()` - Natural frequency analysis
+- `weldHeat()` - Weld heat input calculation
+- `welding()` - Welding parameters
+
+#### Chemical & Process (7 functions)
+- `batch()` - Batch scaling calculation
+- `concentration()` - Concentration unit conversion
+- `dilution()` - Dilution calculation (C1V1 = C2V2)
+- `ph()` - pH and buffer calculations
+- `reactor()` - Reactor sizing
+- `shelfLife()` - Shelf life prediction (Arrhenius)
+- `injectionCycle()` - Injection molding cycle time
+
+#### Electronics & SMT (10 functions)
+- `reflowProfile()` - Reflow temperature profile
+- `resistorDecode()` - Resistor color code decoder
+- `smtTakt()` - SMT line takt time
+- `solderPaste()` - Solder paste volume calculation
+- `traceWidth()` - PCB trace width (IPC-2221)
+- `awgProperties()` - AWG wire properties
+- `capacitorDecode()` - Capacitor code decoder
+- `ledResistor()` - LED resistor calculation
+- `stencilAperture()` - Stencil aperture design
+- `viaCurrent()` - Via current capacity
+
+#### Construction (11 functions)
+- `beamLoad()` - Beam load calculation
+- `concreteMix()` - Concrete mix ratio
+- `earthwork()` - Earthwork volume
+- `formwork()` - Formwork area calculation
+- `rebarWeight()` - Rebar weight by size
+- `slope()` - Slope conversion (%, degree, ratio)
+- `aggregate()` - Aggregate volume calculation
+- `brick()` - Brick quantity estimation
+- `pert()` - PERT schedule analysis
+- `roof()` - Roof calculation
+- `stair()` - Stair dimension calculation
+
+#### Automotive (7 functions)
+- `batteryRuntime()` - Battery capacity/runtime
+- `evCharging()` - EV charging time estimation
+- `fuelEconomy()` - Fuel economy conversion
+- `gearRatio()` - Gear ratio calculation
+- `tireCompare()` - Tire size comparison
+- `torque()` - Torque conversion
+- `power()` - Power conversion (HP, kW)
+
+#### Logistics & Inventory (14 functions)
+- `cbm()` - Cubic meter calculation
+- `containerFit()` - Container capacity estimation
+- `dimWeight()` - Dimensional weight
+- `eoq()` - Economic Order Quantity
+- `fillRate()` - Fill rate calculation
+- `freightClass()` - NMFC freight class
+- `kanban()` - Kanban quantity
+- `pallet3d()` - 3D pallet optimization
+- `palletStack()` - Pallet stacking calculation
+- `pickTime()` - Picking time estimation
+- `safetyStock()` - Safety stock calculation
+- `serviceLevel()` - Service level calculation
+- `shipping()` - Shipping cost estimation
+- `tsp()` - Traveling salesman problem
+
+#### Energy & Utilities (6 functions)
+- `carbonFootprint()` - Scope 2 emissions
+- `compressedAirCost()` - Compressed air cost
+- `motorEfficiency()` - Motor upgrade ROI
+- `pfCorrection()` - Power factor correction
+- `powerCost()` - Electricity cost with demand
+- `vfdSavings()` - VFD energy savings
+
+#### Safety & Ergonomics (6 functions)
+- `fallClearance()` - Fall protection clearance
+- `nioshLifting()` - NIOSH lifting equation (1991 revised)
+- `noiseExposure()` - TWA/Dose calculation (OSHA)
+- `wbgtCalculate()` - WBGT heat stress index
+- `havsCalculate()` - Hand-arm vibration exposure
+- `respiratorCalculate()` - Respirator MUC calculation
+
+#### Food & HACCP (4 functions)
+- `calorie()` - Calorie requirement (BMR/TDEE)
+- `expiry()` - Expiry date calculation
+- `nutrition()` - Nutrition facts calculation
+- `haccp()` - HACCP checklist generation
+
+#### Utility (3 functions)
+- `solveAssignment()` - Hungarian algorithm optimization
+- `calculateUnit()` - Unit conversion
+- `getCategories()` - Get unit categories
+
+### Technical Features
+- Zero dependencies
+- Full TypeScript support with detailed type definitions
+- Tree-shakeable ESM exports
+- Subpath exports for each domain (`formulab/quality`, `formulab/metal`, etc.)
+- Node.js 18+ support

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iyulab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,403 @@
+# formulab
+
+> Industrial & manufacturing calculation library for engineers
+
+[![npm version](https://img.shields.io/npm/v/formulab.svg)](https://www.npmjs.com/package/formulab)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
+A comprehensive collection of engineering formulas and calculations for manufacturing, quality control, logistics, and industrial applications. Zero dependencies, fully typed, tree-shakeable.
+
+## Features
+
+- **100+ industrial calculations** — OEE, Cpk, metal weight, CBM, NIOSH lifting, and more
+- **11 specialized domains** — Quality, Metal, Chemical, Electronics, Construction, Automotive, Logistics, Energy, Safety, Food, Utility
+- **Zero dependencies** — Lightweight and fast
+- **TypeScript first** — Full type definitions included
+- **Tree-shakeable** — Import only what you need
+- **Well tested** — Comprehensive test coverage
+- **Research-based** — Built on industry standards (ISO, OSHA, NIOSH, IPC)
+
+## Installation
+
+```bash
+npm install formulab
+```
+
+```bash
+pnpm add formulab
+```
+
+## Quick Start
+
+```typescript
+import { oee, metalWeight, cbm } from 'formulab';
+
+// Calculate OEE (Overall Equipment Effectiveness)
+const result = oee({
+  availability: 0.90,
+  performance: 0.95,
+  quality: 0.99
+});
+console.log(result.oee); // 0.846 (84.6%)
+
+// Calculate metal weight
+const weight = metalWeight({
+  material: 'steel',
+  shape: 'plate',
+  dimensions: { length: 1000, width: 500, thickness: 10 },
+});
+console.log(weight.weight); // 39.25 kg
+
+// Calculate CBM
+const volume = cbm({
+  length: 120,
+  width: 80,
+  height: 100,
+  unit: 'cm'
+});
+console.log(volume.cbm); // 0.96 m³
+```
+
+## Domains
+
+### Quality & Production (13 functions)
+
+```typescript
+import { oee, cpk, taktTime, dpmo } from 'formulab/quality';
+```
+
+| Function | Description |
+|----------|-------------|
+| `oee()` | Overall Equipment Effectiveness |
+| `cpk()` | Process Capability Index |
+| `cycleTime()` | Cycle Time analysis |
+| `taktTime()` | Takt Time calculation |
+| `aql()` | AQL sampling inspection |
+| `downtime()` | Downtime analysis |
+| `dpmo()` | Defects Per Million Opportunities |
+| `lineBalancing()` | Line balancing optimization |
+| `mtbf()` | Mean Time Between Failures |
+| `ppk()` | Process Performance Index |
+| `ppm()` | Parts Per Million conversion |
+| `rpn()` | Risk Priority Number (FMEA) |
+| `yieldCalc()` | First Pass Yield / RTY |
+
+### Metal & Machining (22 functions)
+
+```typescript
+import { metalWeight, bendAllowance, cutting, bearing } from 'formulab/metal';
+```
+
+| Function | Description |
+|----------|-------------|
+| `metalWeight()` | Weight calculation for various shapes |
+| `bendAllowance()` | Sheet metal bend allowance |
+| `flatPattern()` | Flat pattern length calculation |
+| `kFactorReverse()` | K-factor reverse engineering |
+| `pressTonnage()` | Press brake tonnage |
+| `bearing()` | L10 bearing life calculation |
+| `bolt()` | Bolt torque and preload |
+| `cutting()` | Cutting speed, feed rate, RPM |
+| `cuttingStock()` | 1D cutting optimization |
+| `gear()` | Gear module calculation |
+| `hardness()` | Hardness conversion (HRC, HB, HV) |
+| `material()` | Material properties lookup |
+| `pressFit()` | Press fit interference |
+| `roughness()` | Surface roughness conversion |
+| `screw()` | Screw specification |
+| `spring()` | Spring design calculation |
+| `tap()` | Tap drill size |
+| `thread()` | Thread dimensions |
+| `tolerance()` | ISO tolerance (IT grades) |
+| `vibration()` | Natural frequency analysis |
+| `weldHeat()` | Weld heat input calculation |
+| `welding()` | Welding parameters |
+
+### Chemical & Process (7 functions)
+
+```typescript
+import { dilution, concentration, ph, reactor } from 'formulab/chemical';
+```
+
+| Function | Description |
+|----------|-------------|
+| `batch()` | Batch scaling calculation |
+| `concentration()` | Concentration conversion |
+| `dilution()` | Dilution (C1V1 = C2V2) |
+| `ph()` | pH and buffer calculations |
+| `reactor()` | Reactor sizing |
+| `shelfLife()` | Shelf life prediction (Arrhenius) |
+| `injectionCycle()` | Injection molding cycle time |
+
+### Electronics & SMT (10 functions)
+
+```typescript
+import { traceWidth, solderPaste, resistorDecode } from 'formulab/electronics';
+```
+
+| Function | Description |
+|----------|-------------|
+| `reflowProfile()` | Reflow temperature profile |
+| `resistorDecode()` | Resistor color code decoder |
+| `smtTakt()` | SMT line takt time |
+| `solderPaste()` | Solder paste volume calculation |
+| `traceWidth()` | PCB trace width (IPC-2221) |
+| `awgProperties()` | AWG wire properties |
+| `capacitorDecode()` | Capacitor code decoder |
+| `ledResistor()` | LED resistor calculation |
+| `stencilAperture()` | Stencil aperture design |
+| `viaCurrent()` | Via current capacity |
+
+### Construction (11 functions)
+
+```typescript
+import { concreteMix, rebarWeight, slope, stair } from 'formulab/construction';
+```
+
+| Function | Description |
+|----------|-------------|
+| `beamLoad()` | Beam load calculation |
+| `concreteMix()` | Concrete mix ratio |
+| `earthwork()` | Earthwork volume |
+| `formwork()` | Formwork area calculation |
+| `rebarWeight()` | Rebar weight by size |
+| `slope()` | Slope conversion (%, degree, ratio) |
+| `aggregate()` | Aggregate volume calculation |
+| `brick()` | Brick quantity estimation |
+| `pert()` | PERT schedule analysis |
+| `roof()` | Roof calculation |
+| `stair()` | Stair dimension calculation |
+
+### Automotive (7 functions)
+
+```typescript
+import { batteryRuntime, evCharging, torque } from 'formulab/automotive';
+```
+
+| Function | Description |
+|----------|-------------|
+| `batteryRuntime()` | Battery capacity/runtime |
+| `evCharging()` | EV charging time estimation |
+| `fuelEconomy()` | Fuel economy conversion |
+| `gearRatio()` | Gear ratio calculation |
+| `tireCompare()` | Tire size comparison |
+| `torque()` | Torque conversion |
+| `power()` | Power conversion (HP, kW) |
+
+### Logistics & Inventory (14 functions)
+
+```typescript
+import { cbm, eoq, safetyStock, kanban } from 'formulab/logistics';
+```
+
+| Function | Description |
+|----------|-------------|
+| `cbm()` | Cubic meter calculation |
+| `containerFit()` | Container capacity estimation |
+| `dimWeight()` | Dimensional weight |
+| `eoq()` | Economic Order Quantity |
+| `fillRate()` | Fill rate calculation |
+| `freightClass()` | NMFC freight class |
+| `kanban()` | Kanban quantity |
+| `pallet3d()` | 3D pallet optimization |
+| `palletStack()` | Pallet stacking calculation |
+| `pickTime()` | Picking time estimation |
+| `safetyStock()` | Safety stock calculation |
+| `serviceLevel()` | Service level calculation |
+| `shipping()` | Shipping cost estimation |
+| `tsp()` | Traveling salesman problem |
+
+### Energy & Utilities (6 functions)
+
+```typescript
+import { powerCost, motorEfficiency, carbonFootprint } from 'formulab/energy';
+```
+
+| Function | Description |
+|----------|-------------|
+| `carbonFootprint()` | Scope 2 emissions |
+| `compressedAirCost()` | Compressed air cost |
+| `motorEfficiency()` | Motor upgrade ROI |
+| `pfCorrection()` | Power factor correction |
+| `powerCost()` | Electricity cost with demand |
+| `vfdSavings()` | VFD energy savings |
+
+### Safety & Ergonomics (6 functions)
+
+```typescript
+import { nioshLifting, noiseExposure, wbgtCalculate } from 'formulab/safety';
+```
+
+| Function | Description |
+|----------|-------------|
+| `fallClearance()` | Fall protection clearance |
+| `nioshLifting()` | NIOSH lifting equation |
+| `noiseExposure()` | TWA/Dose calculation |
+| `wbgtCalculate()` | WBGT heat stress index |
+| `havsCalculate()` | Hand-arm vibration exposure |
+| `respiratorCalculate()` | Respirator MUC calculation |
+
+### Food & HACCP (4 functions)
+
+```typescript
+import { calorie, nutrition, haccp } from 'formulab/food';
+```
+
+| Function | Description |
+|----------|-------------|
+| `calorie()` | Calorie requirement (BMR/TDEE) |
+| `expiry()` | Expiry date calculation |
+| `nutrition()` | Nutrition facts calculation |
+| `haccp()` | HACCP checklist generation |
+
+### Utility (3 functions)
+
+```typescript
+import { solveAssignment, calculateUnit } from 'formulab/utility';
+```
+
+| Function | Description |
+|----------|-------------|
+| `solveAssignment()` | Hungarian algorithm optimization |
+| `calculateUnit()` | Unit conversion |
+| `getCategories()` | Get unit categories |
+
+## API Examples
+
+### OEE Calculation
+
+```typescript
+import { oee } from 'formulab/quality';
+
+const result = oee({
+  plannedTime: 480,      // minutes
+  operatingTime: 420,
+  totalPieces: 1000,
+  goodPieces: 990,
+  idealCycleTime: 0.5,
+});
+
+console.log(result);
+// {
+//   oee: 0.846,
+//   availability: 0.875,
+//   performance: 0.952,
+//   quality: 0.99,
+// }
+```
+
+### NIOSH Lifting Equation
+
+```typescript
+import { nioshLifting } from 'formulab/safety';
+
+const result = nioshLifting({
+  loadWeight: 23,
+  horizontalDistance: 25,
+  verticalLocation: 75,
+  verticalTravel: 25,
+  asymmetryAngle: 0,
+  couplingQuality: 'good',
+  frequency: 1,
+  duration: 'moderate',
+});
+
+console.log(result);
+// {
+//   rwl: 23.0,              // Recommended Weight Limit (kg)
+//   liftingIndex: 1.0,      // LI = Load / RWL
+//   riskLevel: 'low',
+//   multipliers: { hm: 1.0, vm: 1.0, dm: 0.93, am: 1.0, fm: 0.94, cm: 1.0 }
+// }
+```
+
+### Dimensional Weight
+
+```typescript
+import { dimWeight } from 'formulab/logistics';
+
+const result = dimWeight({
+  length: 60,
+  width: 40,
+  height: 30,
+  unit: 'cm',
+  carrier: 'international',
+});
+
+console.log(result);
+// {
+//   dimWeight: 14.4,
+//   actualVolume: 0.072,
+//   cbm: 0.072,
+// }
+```
+
+## Tree Shaking
+
+Import only what you need to minimize bundle size:
+
+```typescript
+// Recommended - domain-specific import
+import { oee } from 'formulab/quality';
+import { metalWeight } from 'formulab/metal';
+
+// Also works - main entry point (tree-shakeable)
+import { oee, metalWeight } from 'formulab';
+
+// Avoid - imports entire module
+import * as formulab from 'formulab';
+```
+
+## TypeScript Support
+
+Full TypeScript support with detailed type definitions:
+
+```typescript
+import type {
+  OeeInput,
+  OeeResult,
+  CpkInput,
+  CpkResult,
+  MetalWeightInput,
+  MetalWeightResult,
+} from 'formulab';
+```
+
+## Browser Support
+
+formulab works in all modern browsers and Node.js:
+
+- Node.js 18+
+- Chrome 80+
+- Firefox 75+
+- Safari 13+
+- Edge 80+
+
+## Contributing
+
+Contributions are welcome! Please see our [GitHub repository](https://github.com/iyulab/formulab).
+
+```bash
+# Clone the repository
+git clone https://github.com/iyulab/formulab.git
+
+# Install dependencies
+pnpm install
+
+# Run tests
+pnpm test
+
+# Build
+pnpm build
+```
+
+## License
+
+MIT © [iyulab](https://github.com/iyulab)
+
+---
+
+<p align="center">
+  Made with engineering precision by <a href="https://github.com/iyulab">iyulab</a>
+</p>

package/dist/automotive/batteryRuntime.d.ts

@@ -0,0 +1,14 @@
+import type { BatteryInput, BatteryResult } from './types.js';
+/**
+ * Calculate battery runtime based on capacity, voltage, and load
+ *
+ * Formula:
+ * - Energy (Wh) = Capacity (Ah) x Voltage (V)
+ * - Runtime (h) = Energy (Wh) x Efficiency / Load (W)
+ * - Current Draw (A) = Load (W) / Voltage (V)
+ *
+ * @param input - Battery parameters
+ * @returns Battery result with energy and runtime
+ */
+export declare function batteryRuntime(input: BatteryInput): BatteryResult;
+//# sourceMappingURL=batteryRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batteryRuntime.d.ts","sourceRoot":"","sources":["../../src/automotive/batteryRuntime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA2BjE"}

package/dist/automotive/batteryRuntime.js

@@ -0,0 +1,38 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate battery runtime based on capacity, voltage, and load
+ *
+ * Formula:
+ * - Energy (Wh) = Capacity (Ah) x Voltage (V)
+ * - Runtime (h) = Energy (Wh) x Efficiency / Load (W)
+ * - Current Draw (A) = Load (W) / Voltage (V)
+ *
+ * @param input - Battery parameters
+ * @returns Battery result with energy and runtime
+ */
+export function batteryRuntime(input) {
+    const { capacityAh, voltageV, loadW, efficiency } = input;
+    // Handle edge cases
+    if (voltageV <= 0 || loadW <= 0) {
+        return {
+            energyWh: voltageV > 0 ? roundTo(capacityAh * voltageV, 2) : 0,
+            energyKwh: voltageV > 0 ? roundTo((capacityAh * voltageV) / 1000, 2) : 0,
+            runtimeHours: 0,
+            runtimeMinutes: 0,
+            currentDraw: 0,
+        };
+    }
+    const energyWh = capacityAh * voltageV;
+    const energyKwh = energyWh / 1000;
+    const runtimeHours = (energyWh * efficiency) / loadW;
+    const runtimeMinutes = runtimeHours * 60;
+    const currentDraw = loadW / voltageV;
+    return {
+        energyWh: roundTo(energyWh, 2),
+        energyKwh: roundTo(energyKwh, 2),
+        runtimeHours: roundTo(runtimeHours, 2),
+        runtimeMinutes: roundTo(runtimeMinutes, 2),
+        currentDraw: roundTo(currentDraw, 2),
+    };
+}
+//# sourceMappingURL=batteryRuntime.js.map

package/dist/automotive/batteryRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batteryRuntime.js","sourceRoot":"","sources":["../../src/automotive/batteryRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAE1D,oBAAoB;IACpB,IAAI,QAAQ,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,QAAQ,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,SAAS,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,CAAC;YACjB,WAAW,EAAE,CAAC;SACf,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACvC,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;IAClC,MAAM,YAAY,GAAG,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC;IACrD,MAAM,cAAc,GAAG,YAAY,GAAG,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;IAErC,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1C,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/automotive/evCharging.d.ts

@@ -0,0 +1,14 @@
+import type { ChargingInput, ChargingResult } from './types.js';
+/**
+ * Calculate EV charging time and energy requirements
+ *
+ * Formula:
+ * - Energy Needed (kWh) = Battery Capacity x (SOC End - SOC Start) / 100
+ * - Energy From Grid (kWh) = Energy Needed / Efficiency
+ * - Charging Time (h) = Energy From Grid / Charger Power
+ *
+ * @param input - Charging parameters
+ * @returns Charging result with energy and time
+ */
+export declare function evCharging(input: ChargingInput): ChargingResult;
+//# sourceMappingURL=evCharging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evCharging.d.ts","sourceRoot":"","sources":["../../src/automotive/evCharging.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAuC/D"}

package/dist/automotive/evCharging.js

@@ -0,0 +1,48 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate EV charging time and energy requirements
+ *
+ * Formula:
+ * - Energy Needed (kWh) = Battery Capacity x (SOC End - SOC Start) / 100
+ * - Energy From Grid (kWh) = Energy Needed / Efficiency
+ * - Charging Time (h) = Energy From Grid / Charger Power
+ *
+ * @param input - Charging parameters
+ * @returns Charging result with energy and time
+ */
+export function evCharging(input) {
+    const { batteryCapacityKwh, chargerPowerKw, socStartPercent, socEndPercent, efficiency } = input;
+    // Handle edge cases - no charging needed or invalid
+    if (socEndPercent <= socStartPercent) {
+        return {
+            energyNeeded: 0,
+            energyFromGrid: 0,
+            chargingTimeHours: 0,
+            chargingTimeMinutes: 0,
+        };
+    }
+    // Handle zero charger power
+    if (chargerPowerKw <= 0) {
+        const socDiff = (socEndPercent - socStartPercent) / 100;
+        const energyNeeded = batteryCapacityKwh * socDiff;
+        const energyFromGrid = energyNeeded / efficiency;
+        return {
+            energyNeeded: roundTo(energyNeeded, 2),
+            energyFromGrid: roundTo(energyFromGrid, 2),
+            chargingTimeHours: 0,
+            chargingTimeMinutes: 0,
+        };
+    }
+    const socDiff = (socEndPercent - socStartPercent) / 100;
+    const energyNeeded = batteryCapacityKwh * socDiff;
+    const energyFromGrid = energyNeeded / efficiency;
+    const chargingTimeHours = energyFromGrid / chargerPowerKw;
+    const chargingTimeMinutes = chargingTimeHours * 60;
+    return {
+        energyNeeded: roundTo(energyNeeded, 2),
+        energyFromGrid: roundTo(energyFromGrid, 2),
+        chargingTimeHours: roundTo(chargingTimeHours, 2),
+        chargingTimeMinutes: roundTo(chargingTimeMinutes, 2),
+    };
+}
+//# sourceMappingURL=evCharging.js.map