formulab 0.1.0 → 0.5.0

package/dist/automotive/brakingDistance.js

@@ -0,0 +1,47 @@
+import { roundTo } from '../utils.js';
+/**
+ * Braking Distance Calculator (AASHTO method)
+ *
+ * Calculates stopping distance based on:
+ * - Reaction distance: d_r = v × t_reaction
+ * - Braking distance: d_b = v² / (2 × g × (f ± G))
+ *   where G = grade/100 (positive uphill, negative downhill)
+ *
+ * Reference: AASHTO "A Policy on Geometric Design of Highways and Streets"
+ *
+ * @param input - speed, friction, reaction time, grade
+ * @returns stopping distance components
+ */
+export function brakingDistance(input) {
+    const { speed, friction, reactionTime, grade } = input;
+    if (speed <= 0)
+        throw new Error('Speed must be positive');
+    if (friction <= 0)
+        throw new Error('Friction coefficient must be positive');
+    if (reactionTime < 0)
+        throw new Error('Reaction time must be non-negative');
+    const g = 9.81; // m/s²
+    const speedMps = speed / 3.6; // km/h → m/s
+    const gradeDecimal = grade / 100; // % → decimal
+    // Reaction distance: d = v × t
+    const reactionDist = speedMps * reactionTime;
+    // Effective friction considering grade
+    // Uphill (positive grade) helps braking, downhill (negative) hinders
+    const effectiveFriction = friction + gradeDecimal;
+    if (effectiveFriction <= 0) {
+        throw new Error('Effective friction (friction + grade) must be positive — vehicle cannot stop on this grade');
+    }
+    // Deceleration: a = g × (f ± G)
+    const deceleration = g * effectiveFriction;
+    // Braking distance: d = v² / (2 × a)
+    const brakingDist = (speedMps * speedMps) / (2 * deceleration);
+    const totalStoppingDistance = reactionDist + brakingDist;
+    return {
+        reactionDistance: roundTo(reactionDist, 2),
+        brakingDistance: roundTo(brakingDist, 2),
+        totalStoppingDistance: roundTo(totalStoppingDistance, 2),
+        speedMps: roundTo(speedMps, 2),
+        deceleration: roundTo(deceleration, 2),
+    };
+}
+//# sourceMappingURL=brakingDistance.js.map

package/dist/automotive/brakingDistance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brakingDistance.js","sourceRoot":"","sources":["../../src/automotive/brakingDistance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAEvD,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,IAAI,QAAQ,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC5E,IAAI,YAAY,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAE5E,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO;IACvB,MAAM,QAAQ,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,aAAa;IAC3C,MAAM,YAAY,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,cAAc;IAEhD,+BAA+B;IAC/B,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;IAE7C,uCAAuC;IACvC,qEAAqE;IACrE,MAAM,iBAAiB,GAAG,QAAQ,GAAG,YAAY,CAAC;IAElD,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;IAChH,CAAC;IAED,gCAAgC;IAChC,MAAM,YAAY,GAAG,CAAC,GAAG,iBAAiB,CAAC;IAE3C,qCAAqC;IACrC,MAAM,WAAW,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;IAE/D,MAAM,qBAAqB,GAAG,YAAY,GAAG,WAAW,CAAC;IAEzD,OAAO;QACL,gBAAgB,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC1C,eAAe,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACxC,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACxD,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9B,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/automotive/gearRatio.d.ts

@@ -1,4 +1,4 @@
-import type { GearInput, GearResult } from './types.js';
+import type { GearRatioInput, GearRatioResult } from './types.js';
 /**
  * Calculate gear ratio and output characteristics
  *
@@ -11,5 +11,5 @@ import type { GearInput, GearResult } from './types.js';
  * @param input - Gear parameters
  * @returns Gear result with ratio, speed, and torque
  */
-export declare function gearRatio(input: GearInput): GearResult;
+export declare function gearRatio(input: GearRatioInput): GearRatioResult;
 //# sourceMappingURL=gearRatio.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gearRatio.d.ts","sourceRoot":"","sources":["../../src/automotive/gearRatio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CA2BtD"}
+{"version":3,"file":"gearRatio.d.ts","sourceRoot":"","sources":["../../src/automotive/gearRatio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CA2BhE"}

package/dist/automotive/gearRatio.js

@@ -27,7 +27,7 @@ export function gearRatio(input) {
     const outputSpeed = inputSpeed / ratio;
     const outputTorque = inputTorque * ratio * efficiency;
     const speedReduction = ratio > 1;
-    const mechanicalAdvantage = outputTorque / inputTorque;
+    const mechanicalAdvantage = inputTorque === 0 ? 0 : outputTorque / inputTorque;
     return {
         gearRatio: roundTo(ratio, 2),
         outputSpeed: roundTo(outputSpeed, 2),

package/dist/automotive/gearRatio.js.map

@@ -1 +1 @@
-{"version":3,"file":"gearRatio.js","sourceRoot":"","sources":["../../src/automotive/gearRatio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgB;IACxC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAEjF,wCAAwC;IACxC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,KAAK;YACrB,mBAAmB,EAAE,CAAC;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,GAAG,YAAY,CAAC;IACzC,MAAM,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;IACvC,MAAM,YAAY,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,MAAM,cAAc,GAAG,KAAK,GAAG,CAAC,CAAC;IACjC,MAAM,mBAAmB,GAAG,YAAY,GAAG,WAAW,CAAC;IAEvD,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACtC,cAAc;QACd,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"gearRatio.js","sourceRoot":"","sources":["../../src/automotive/gearRatio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAEjF,wCAAwC;IACxC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,KAAK;YACrB,mBAAmB,EAAE,CAAC;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,GAAG,YAAY,CAAC;IACzC,MAAM,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;IACvC,MAAM,YAAY,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,MAAM,cAAc,GAAG,KAAK,GAAG,CAAC,CAAC;IACjC,MAAM,mBAAmB,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,WAAW,CAAC;IAE/E,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACtC,cAAc;QACd,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/automotive/index.d.ts

@@ -1,3 +1,4 @@
+export { brakingDistance } from './brakingDistance.js';
 export { batteryRuntime } from './batteryRuntime.js';
 export { evCharging } from './evCharging.js';
 export { fuelEconomy } from './fuelEconomy.js';
@@ -5,5 +6,5 @@ export { gearRatio } from './gearRatio.js';
 export { tireCompare } from './tireCompare.js';
 export { torque } from './torque.js';
 export { power } from './power.js';
-export type { BatteryInput, BatteryResult, ChargingInput, ChargingResult, FuelUnit, FuelInput, FuelResult, GearInput, GearResult, TireSpec, TireInput, TireData, TireResult, TorqueUnit, TorqueInput, TorqueResult, PowerUnit, PowerInput, PowerResult, } from './types.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';
 //# 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,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,YAAY,EACZ,aAAa,EAEb,aAAa,EACb,cAAc,EAEd,QAAQ,EACR,SAAS,EACT,UAAU,EAEV,SAAS,EACT,UAAU,EAEV,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;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"}

package/dist/automotive/index.js

@@ -1,4 +1,5 @@
 // Automotive domain formulas
+export { brakingDistance } from './brakingDistance.js';
 export { batteryRuntime } from './batteryRuntime.js';
 export { evCharging } from './evCharging.js';
 export { fuelEconomy } from './fuelEconomy.js';

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,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"}

package/dist/automotive/types.d.ts

@@ -47,14 +47,14 @@ export interface FuelResult {
 /**
  * Gear Ratio Calculator Types
  */
-export interface GearInput {
+export interface GearRatioInput {
     drivingTeeth: number;
     drivenTeeth: number;
     inputSpeed: number;
     inputTorque: number;
     efficiency: number;
 }
-export interface GearResult {
+export interface GearRatioResult {
     gearRatio: number;
     outputSpeed: number;
     outputTorque: number;
@@ -98,6 +98,22 @@ export interface TorqueResult {
     kgfm: number;
     ftlbf: number;
 }
+/**
+ * Braking Distance Calculator Types (AASHTO)
+ */
+export interface BrakingDistanceInput {
+    speed: number;
+    friction: number;
+    reactionTime: number;
+    grade: number;
+}
+export interface BrakingDistanceResult {
+    reactionDistance: number;
+    brakingDistance: number;
+    totalStoppingDistance: number;
+    speedMps: number;
+    deceleration: number;
+}
 /**
  * Power Converter Types
  */

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/batteryPackConfig.d.ts

@@ -0,0 +1,10 @@
+import type { BatteryPackConfigInput, BatteryPackConfigResult } from './types.js';
+/**
+ * Calculate battery pack series/parallel cell configuration
+ *
+ * @formula S = ceil(Vtarget / Vcell), P = ceil(Ahtarget / Ahcell)
+ * @param input - Cell specs and target pack specs
+ * @returns Series/parallel count, actual voltage/capacity, total energy
+ */
+export declare function batteryPackConfig(input: BatteryPackConfigInput): BatteryPackConfigResult;
+//# sourceMappingURL=batteryPackConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batteryPackConfig.d.ts","sourceRoot":"","sources":["../../src/battery/batteryPackConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CAqBxF"}

package/dist/battery/batteryPackConfig.js

@@ -0,0 +1,28 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate battery pack series/parallel cell configuration
+ *
+ * @formula S = ceil(Vtarget / Vcell), P = ceil(Ahtarget / Ahcell)
+ * @param input - Cell specs and target pack specs
+ * @returns Series/parallel count, actual voltage/capacity, total energy
+ */
+export function batteryPackConfig(input) {
+    const { cellVoltage, cellCapacityAh, targetVoltage, targetCapacityAh } = input;
+    const seriesCells = Math.ceil(targetVoltage / cellVoltage);
+    const parallelCells = Math.ceil(targetCapacityAh / cellCapacityAh);
+    const totalCells = seriesCells * parallelCells;
+    const actualVoltage = roundTo(seriesCells * cellVoltage, 2);
+    const actualCapacityAh = roundTo(parallelCells * cellCapacityAh, 2);
+    const totalEnergyWh = roundTo(actualVoltage * actualCapacityAh, 2);
+    const totalEnergyKWh = roundTo(totalEnergyWh / 1000, 3);
+    return {
+        seriesCells,
+        parallelCells,
+        totalCells,
+        actualVoltage,
+        actualCapacityAh,
+        totalEnergyWh,
+        totalEnergyKWh,
+    };
+}
+//# sourceMappingURL=batteryPackConfig.js.map

package/dist/battery/batteryPackConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batteryPackConfig.js","sourceRoot":"","sources":["../../src/battery/batteryPackConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAE/E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAG,cAAc,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;IAE/C,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,OAAO,CAAC,aAAa,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAExD,OAAO;QACL,WAAW;QACX,aAAa;QACb,UAAU;QACV,aAAa;QACb,gBAAgB;QAChB,aAAa;QACb,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/battery/bmsBalancing.d.ts

@@ -0,0 +1,11 @@
+import type { BmsBalancingInput, BmsBalancingResult } from './types.js';
+/**
+ * Calculate BMS cell balancing time
+ *
+ * @formula time = (ΔV/Vavg × Ah × 1000) / ImA (minutes)
+ * @reference BMS design guidelines, passive balancing
+ * @param input - Cell voltages array, balancing current, cell capacity
+ * @returns Balancing time estimates and cell-level details
+ */
+export declare function bmsBalancing(input: BmsBalancingInput): BmsBalancingResult;
+//# sourceMappingURL=bmsBalancing.d.ts.map

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

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

package/dist/battery/bmsBalancing.js

@@ -0,0 +1,47 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate BMS cell balancing time
+ *
+ * @formula time = (ΔV/Vavg × Ah × 1000) / ImA (minutes)
+ * @reference BMS design guidelines, passive balancing
+ * @param input - Cell voltages array, balancing current, cell capacity
+ * @returns Balancing time estimates and cell-level details
+ */
+export function bmsBalancing(input) {
+    const { cellVoltages, balancingCurrentMA, cellCapacityAh } = input;
+    const maxVoltage = Math.max(...cellVoltages);
+    const minVoltage = Math.min(...cellVoltages);
+    const voltageDelta = roundTo(maxVoltage - minVoltage, 4);
+    const averageVoltage = roundTo(cellVoltages.reduce((sum, v) => sum + v, 0) / cellVoltages.length, 4);
+    // Balance threshold: 10mV
+    const isBalanced = voltageDelta <= 0.01;
+    const cellDetails = cellVoltages.map((voltage, index) => {
+        const deltaFromAvg = roundTo((voltage - averageVoltage) * 1000, 2); // mV
+        // Only cells above average need balancing (discharge excess energy)
+        let balancingTimeMin = 0;
+        if (deltaFromAvg > 0) {
+            // Energy to remove: ΔV/Vavg × Ah (in mAh), time = mAh / mA × 60
+            const excessMah = (deltaFromAvg / 1000) / averageVoltage * cellCapacityAh * 1000;
+            balancingTimeMin = roundTo(excessMah / balancingCurrentMA * 60, 1);
+        }
+        return {
+            cellIndex: index,
+            voltage: roundTo(voltage, 4),
+            deltaFromAvg,
+            balancingTimeMin,
+        };
+    });
+    const maxBalancingTimeMin = roundTo(Math.max(...cellDetails.map(c => c.balancingTimeMin)), 1);
+    const maxBalancingTimeH = roundTo(maxBalancingTimeMin / 60, 2);
+    return {
+        maxVoltage: roundTo(maxVoltage, 4),
+        minVoltage: roundTo(minVoltage, 4),
+        voltageDelta,
+        averageVoltage,
+        maxBalancingTimeMin,
+        maxBalancingTimeH,
+        isBalanced,
+        cellDetails,
+    };
+}
+//# sourceMappingURL=bmsBalancing.js.map

package/dist/battery/bmsBalancing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bmsBalancing.js","sourceRoot":"","sources":["../../src/battery/bmsBalancing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAEnE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,OAAO,CAC5B,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,EACjE,CAAC,CACF,CAAC;IAEF,0BAA0B;IAC1B,MAAM,UAAU,GAAG,YAAY,IAAI,IAAI,CAAC;IAExC,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtD,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,OAAO,GAAG,cAAc,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK;QACzE,oEAAoE;QACpE,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,gEAAgE;YAChE,MAAM,SAAS,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,cAAc,GAAG,IAAI,CAAC;YACjF,gBAAgB,GAAG,OAAO,CAAC,SAAS,GAAG,kBAAkB,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5B,YAAY;YACZ,gBAAgB;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,OAAO,CACjC,IAAI,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,EACrD,CAAC,CACF,CAAC;IACF,MAAM,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAE/D,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAClC,YAAY;QACZ,cAAc;QACd,mBAAmB;QACnB,iBAAiB;QACjB,UAAU;QACV,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/battery/cRate.d.ts

@@ -0,0 +1,10 @@
+import type { CRateInput, CRateResult } from './types.js';
+/**
+ * Calculate C-rate ↔ current/time conversion
+ *
+ * @formula C = I / Ah, time = 1/C hours
+ * @param input - Battery capacity with either current or C-rate
+ * @returns C-rate, current, and theoretical charge/discharge time
+ */
+export declare function cRate(input: CRateInput): CRateResult;
+//# sourceMappingURL=cRate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cRate.d.ts","sourceRoot":"","sources":["../../src/battery/cRate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAqBpD"}

package/dist/battery/cRate.js

@@ -0,0 +1,29 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate C-rate ↔ current/time conversion
+ *
+ * @formula C = I / Ah, time = 1/C hours
+ * @param input - Battery capacity with either current or C-rate
+ * @returns C-rate, current, and theoretical charge/discharge time
+ */
+export function cRate(input) {
+    let cRateValue;
+    let currentA;
+    if (input.mode === 'currentToRate') {
+        currentA = input.currentA;
+        cRateValue = currentA / input.capacityAh;
+    }
+    else {
+        cRateValue = input.cRate;
+        currentA = cRateValue * input.capacityAh;
+    }
+    const theoreticalTimeH = 1 / cRateValue;
+    const theoreticalTimeMin = theoreticalTimeH * 60;
+    return {
+        cRate: roundTo(cRateValue, 4),
+        currentA: roundTo(currentA, 2),
+        theoreticalTimeH: roundTo(theoreticalTimeH, 2),
+        theoreticalTimeMin: roundTo(theoreticalTimeMin, 1),
+    };
+}
+//# sourceMappingURL=cRate.js.map

package/dist/battery/cRate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cRate.js","sourceRoot":"","sources":["../../src/battery/cRate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,IAAI,UAAkB,CAAC;IACvB,IAAI,QAAgB,CAAC;IAErB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACnC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC1B,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED,MAAM,gBAAgB,GAAG,CAAC,GAAG,UAAU,CAAC;IACxC,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,EAAE,CAAC;IAEjD,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC9C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/battery/chargingProfile.d.ts

@@ -0,0 +1,11 @@
+import type { ChargingProfileInput, ChargingProfileResult } from './types.js';
+/**
+ * Calculate CC-CV charging profile timing
+ *
+ * @formula CC: t = ccAh / I, CV: t ≈ cvAh / ((Icc + Icut) / 2)
+ * @reference Li-ion CC-CV charging protocol
+ * @param input - Battery capacity, charging current, cutoff current, CC end SOC
+ * @returns Phase durations, Ah delivered per phase, average C-rate
+ */
+export declare function chargingProfile(input: ChargingProfileInput): ChargingProfileResult;
+//# sourceMappingURL=chargingProfile.d.ts.map

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

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

package/dist/battery/chargingProfile.js

@@ -0,0 +1,38 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate CC-CV charging profile timing
+ *
+ * @formula CC: t = ccAh / I, CV: t ≈ cvAh / ((Icc + Icut) / 2)
+ * @reference Li-ion CC-CV charging protocol
+ * @param input - Battery capacity, charging current, cutoff current, CC end SOC
+ * @returns Phase durations, Ah delivered per phase, average C-rate
+ */
+export function chargingProfile(input) {
+    const { capacityAh, chargingCurrentA, cutoffCurrentA, ccEndSocPercent = 80, } = input;
+    // CC phase delivers ccEndSocPercent of capacity
+    const ccPhaseAh = roundTo(capacityAh * (ccEndSocPercent / 100), 2);
+    const cvPhaseAh = roundTo(capacityAh - ccPhaseAh, 2);
+    // CC phase time = Ah / current
+    const ccPhaseTimeH = roundTo(ccPhaseAh / chargingCurrentA, 2);
+    const ccPhaseTimeMin = roundTo(ccPhaseTimeH * 60, 1);
+    // CV phase time approximation: average current = (Icc + Icut) / 2
+    const avgCvCurrent = (chargingCurrentA + cutoffCurrentA) / 2;
+    const cvPhaseTimeH = roundTo(cvPhaseAh / avgCvCurrent, 2);
+    const cvPhaseTimeMin = roundTo(cvPhaseTimeH * 60, 1);
+    const totalTimeH = roundTo(ccPhaseTimeH + cvPhaseTimeH, 2);
+    const totalTimeMin = roundTo(totalTimeH * 60, 1);
+    // Average C-rate over entire charge
+    const averageCRate = roundTo(capacityAh / (totalTimeH * capacityAh), 4);
+    return {
+        ccPhaseTimeH,
+        ccPhaseTimeMin,
+        cvPhaseTimeH,
+        cvPhaseTimeMin,
+        totalTimeH,
+        totalTimeMin,
+        ccPhaseAh,
+        cvPhaseAh,
+        averageCRate,
+    };
+}
+//# sourceMappingURL=chargingProfile.js.map

package/dist/battery/chargingProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chargingProfile.js","sourceRoot":"","sources":["../../src/battery/chargingProfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,GAAG,EAAE,GACrB,GAAG,KAAK,CAAC;IAEV,gDAAgD;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;IAErD,+BAA+B;IAC/B,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAErD,kEAAkE;IAClE,MAAM,YAAY,GAAG,CAAC,gBAAgB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAErD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAEjD,oCAAoC;IACpC,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAExE,OAAO;QACL,YAAY;QACZ,cAAc;QACd,YAAY;QACZ,cAAc;QACd,UAAU;QACV,YAAY;QACZ,SAAS;QACT,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/battery/cycleLife.d.ts

@@ -0,0 +1,11 @@
+import type { CycleLifeInput, CycleLifeResult } from './types.js';
+/**
+ * Estimate battery cycle life based on chemistry, DOD, and temperature
+ *
+ * @formula cycles = baseCycles × dodFactor × temperatureFactor
+ * @reference Battery University, manufacturer datasheets
+ * @param input - Chemistry type, DOD percentage, temperature
+ * @returns Estimated cycle count with adjustment factors
+ */
+export declare function cycleLife(input: CycleLifeInput): CycleLifeResult;
+//# sourceMappingURL=cycleLife.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cycleLife.d.ts","sourceRoot":"","sources":["../../src/battery/cycleLife.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA6CpF;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAgBhE"}

package/dist/battery/cycleLife.js

@@ -0,0 +1,70 @@
+import { roundTo } from '../utils.js';
+/**
+ * Base cycle life by battery chemistry (at ~80% DOD, 25°C)
+ * @reference Manufacturer datasheets, Battery University
+ */
+const BASE_CYCLE_LIFE = {
+    LFP: 3500,
+    NMC: 1500,
+    NCA: 1000,
+    LTO: 15000,
+    LCO: 800,
+    LeadAcid: 500,
+    NiMH: 600,
+};
+/**
+ * DOD factor: how depth of discharge affects cycle life
+ * ≤50% → 1.5, 50-80% → 1.0, >80% → 0.7 (with linear interpolation)
+ */
+function getDodFactor(dod) {
+    if (dod <= 50) {
+        // Linear from 1.5 at 0% to 1.5 at 50%
+        return 1.5;
+    }
+    else if (dod <= 80) {
+        // Linear from 1.5 at 50% to 1.0 at 80%
+        return 1.5 - ((dod - 50) / 30) * 0.5;
+    }
+    else {
+        // Linear from 1.0 at 80% to 0.7 at 100%
+        return 1.0 - ((dod - 80) / 20) * 0.3;
+    }
+}
+/**
+ * Temperature factor: how temperature affects cycle life
+ * <0°C → 0.5, 0-15 → 0.8, 15-35 → 1.0, 35-45 → 0.8, >45 → 0.5
+ */
+function getTemperatureFactor(tempC) {
+    if (tempC < 0)
+        return 0.5;
+    if (tempC < 15)
+        return 0.8;
+    if (tempC <= 35)
+        return 1.0;
+    if (tempC <= 45)
+        return 0.8;
+    return 0.5;
+}
+/**
+ * Estimate battery cycle life based on chemistry, DOD, and temperature
+ *
+ * @formula cycles = baseCycles × dodFactor × temperatureFactor
+ * @reference Battery University, manufacturer datasheets
+ * @param input - Chemistry type, DOD percentage, temperature
+ * @returns Estimated cycle count with adjustment factors
+ */
+export function cycleLife(input) {
+    const { chemistry, depthOfDischarge, temperatureC } = input;
+    const baseCycles = BASE_CYCLE_LIFE[chemistry];
+    const dodFactor = getDodFactor(depthOfDischarge);
+    const temperatureFactor = getTemperatureFactor(temperatureC);
+    const estimatedCycles = roundTo(baseCycles * dodFactor * temperatureFactor, 0);
+    return {
+        estimatedCycles,
+        baseCycles,
+        dodFactor: roundTo(dodFactor, 4),
+        temperatureFactor,
+        chemistry,
+    };
+}
+//# sourceMappingURL=cycleLife.js.map

package/dist/battery/cycleLife.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycleLife.js","sourceRoot":"","sources":["../../src/battery/cycleLife.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;GAGG;AACH,MAAM,eAAe,GAAqC;IACxD,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,GAAG;IACR,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;CACV,CAAC;AAEF;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QACd,sCAAsC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;SAAM,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QACrB,uCAAuC;QACvC,OAAO,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,wCAAwC;QACxC,OAAO,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,KAAa;IACzC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC;IAC3B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAE5D,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACjD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAE7D,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAE/E,OAAO;QACL,eAAe;QACf,UAAU;QACV,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAChC,iBAAiB;QACjB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/battery/energyDensity.d.ts

@@ -0,0 +1,10 @@
+import type { EnergyDensityInput, EnergyDensityResult } from './types.js';
+/**
+ * Calculate battery energy density (gravimetric and volumetric)
+ *
+ * @formula Wh = Ah × V, Wh/kg = Wh / mass, Wh/L = Wh / volume
+ * @param input - Battery capacity, voltage, and optionally mass/volume
+ * @returns Energy in Wh, gravimetric (Wh/kg), and volumetric (Wh/L) density
+ */
+export declare function energyDensity(input: EnergyDensityInput): EnergyDensityResult;
+//# sourceMappingURL=energyDensity.d.ts.map

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

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

package/dist/battery/energyDensity.js

@@ -0,0 +1,20 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate battery energy density (gravimetric and volumetric)
+ *
+ * @formula Wh = Ah × V, Wh/kg = Wh / mass, Wh/L = Wh / volume
+ * @param input - Battery capacity, voltage, and optionally mass/volume
+ * @returns Energy in Wh, gravimetric (Wh/kg), and volumetric (Wh/L) density
+ */
+export function energyDensity(input) {
+    const { capacityAh, nominalVoltage, massKg, volumeL } = input;
+    const energyWh = roundTo(capacityAh * nominalVoltage, 2);
+    const gravimetricWhPerKg = massKg != null && massKg > 0
+        ? roundTo(energyWh / massKg, 2)
+        : null;
+    const volumetricWhPerL = volumeL != null && volumeL > 0
+        ? roundTo(energyWh / volumeL, 2)
+        : null;
+    return { energyWh, gravimetricWhPerKg, volumetricWhPerL };
+}
+//# sourceMappingURL=energyDensity.js.map

package/dist/battery/energyDensity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"energyDensity.js","sourceRoot":"","sources":["../../src/battery/energyDensity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAE9D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,kBAAkB,GAAG,MAAM,IAAI,IAAI,IAAI,MAAM,GAAG,CAAC;QACrD,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,gBAAgB,GAAG,OAAO,IAAI,IAAI,IAAI,OAAO,GAAG,CAAC;QACrD,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,OAAO,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC;IAET,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;AAC5D,CAAC"}

package/dist/battery/index.d.ts

@@ -0,0 +1,12 @@
+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 { energyDensity } from './energyDensity.js';
+export { cRate } from './cRate.js';
+export { stateOfHealth } from './stateOfHealth.js';
+export { batteryPackConfig } from './batteryPackConfig.js';
+export { cycleLife } from './cycleLife.js';
+export { internalResistance } from './internalResistance.js';
+export { selfDischarge } from './selfDischarge.js';
+export { thermalRunaway } from './thermalRunaway.js';
+export { bmsBalancing } from './bmsBalancing.js';
+export { chargingProfile } from './chargingProfile.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/battery/index.js

@@ -0,0 +1,12 @@
+// Functions
+export { energyDensity } from './energyDensity.js';
+export { cRate } from './cRate.js';
+export { stateOfHealth } from './stateOfHealth.js';
+export { batteryPackConfig } from './batteryPackConfig.js';
+export { cycleLife } from './cycleLife.js';
+export { internalResistance } from './internalResistance.js';
+export { selfDischarge } from './selfDischarge.js';
+export { thermalRunaway } from './thermalRunaway.js';
+export { bmsBalancing } from './bmsBalancing.js';
+export { chargingProfile } from './chargingProfile.js';
+//# sourceMappingURL=index.js.map

package/dist/battery/index.js.map

@@ -0,0 +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"}

package/dist/battery/internalResistance.d.ts

@@ -0,0 +1,11 @@
+import type { InternalResistanceInput, InternalResistanceResult } from './types.js';
+/**
+ * Calculate battery internal resistance from OCV and load voltage
+ *
+ * @formula R = (OCV - Vload) / I
+ * @reference IEC 61960, direct current internal resistance (DCIR)
+ * @param input - Open circuit voltage, load voltage, and load current
+ * @returns Resistance in Ohm and mOhm, voltage drop, and power loss
+ */
+export declare function internalResistance(input: InternalResistanceInput): InternalResistanceResult;
+//# sourceMappingURL=internalResistance.d.ts.map

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

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

package/dist/battery/internalResistance.js

@@ -0,0 +1,18 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate battery internal resistance from OCV and load voltage
+ *
+ * @formula R = (OCV - Vload) / I
+ * @reference IEC 61960, direct current internal resistance (DCIR)
+ * @param input - Open circuit voltage, load voltage, and load current
+ * @returns Resistance in Ohm and mOhm, voltage drop, and power loss
+ */
+export function internalResistance(input) {
+    const { openCircuitVoltage, loadVoltage, loadCurrentA } = input;
+    const voltageDrop = roundTo(openCircuitVoltage - loadVoltage, 4);
+    const resistanceOhm = roundTo(voltageDrop / loadCurrentA, 6);
+    const resistanceMilliOhm = roundTo(resistanceOhm * 1000, 3);
+    const powerLossW = roundTo(loadCurrentA * loadCurrentA * resistanceOhm, 4);
+    return { resistanceOhm, resistanceMilliOhm, voltageDrop, powerLossW };
+}
+//# sourceMappingURL=internalResistance.js.map

package/dist/battery/internalResistance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalResistance.js","sourceRoot":"","sources":["../../src/battery/internalResistance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAEhE,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,kBAAkB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,YAAY,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC;IAE3E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACxE,CAAC"}