formulab 0.1.11 → 0.5.1

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

package/dist/battery/selfDischarge.d.ts

@@ -0,0 +1,10 @@
+import type { SelfDischargeInput, SelfDischargeResult } from './types.js';
+/**
+ * Calculate battery self-discharge rate
+ *
+ * @formula monthlyRate% = (ΔV / days) × 30 / Vnominal × 100
+ * @param input - Initial voltage, final voltage, elapsed days, nominal voltage
+ * @returns Daily and monthly self-discharge rates
+ */
+export declare function selfDischarge(input: SelfDischargeInput): SelfDischargeResult;
+//# sourceMappingURL=selfDischarge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selfDischarge.d.ts","sourceRoot":"","sources":["../../src/battery/selfDischarge.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,CAS5E"}

package/dist/battery/selfDischarge.js

@@ -0,0 +1,17 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate battery self-discharge rate
+ *
+ * @formula monthlyRate% = (ΔV / days) × 30 / Vnominal × 100
+ * @param input - Initial voltage, final voltage, elapsed days, nominal voltage
+ * @returns Daily and monthly self-discharge rates
+ */
+export function selfDischarge(input) {
+    const { initialVoltage, finalVoltage, days, nominalVoltage } = input;
+    const totalVoltageDrop = initialVoltage - finalVoltage;
+    const voltageDropPerDay = roundTo(totalVoltageDrop / days, 6);
+    const dailyRatePercent = roundTo((voltageDropPerDay / nominalVoltage) * 100, 4);
+    const monthlyRatePercent = roundTo(dailyRatePercent * 30, 2);
+    return { voltageDropPerDay, monthlyRatePercent, dailyRatePercent };
+}
+//# sourceMappingURL=selfDischarge.js.map

package/dist/battery/selfDischarge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfDischarge.js","sourceRoot":"","sources":["../../src/battery/selfDischarge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAErE,MAAM,gBAAgB,GAAG,cAAc,GAAG,YAAY,CAAC;IACvD,MAAM,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,OAAO,CAAC,CAAC,iBAAiB,GAAG,cAAc,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;IAChF,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAE7D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;AACrE,CAAC"}

package/dist/battery/stateOfHealth.d.ts

@@ -0,0 +1,11 @@
+import type { StateOfHealthInput, StateOfHealthResult } from './types.js';
+/**
+ * Calculate battery State of Health (SOH)
+ *
+ * @formula SOH% = (measured / rated) × 100
+ * @reference IEEE 1188, IEC 62620
+ * @param input - Measured and rated capacity
+ * @returns SOH percentage and degradation status
+ */
+export declare function stateOfHealth(input: StateOfHealthInput): StateOfHealthResult;
+//# sourceMappingURL=stateOfHealth.d.ts.map

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

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

package/dist/battery/stateOfHealth.js

@@ -0,0 +1,33 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate battery State of Health (SOH)
+ *
+ * @formula SOH% = (measured / rated) × 100
+ * @reference IEEE 1188, IEC 62620
+ * @param input - Measured and rated capacity
+ * @returns SOH percentage and degradation status
+ */
+export function stateOfHealth(input) {
+    const { measuredCapacityAh, ratedCapacityAh } = input;
+    const sohPercent = roundTo((measuredCapacityAh / ratedCapacityAh) * 100, 2);
+    const capacityLoss = roundTo(ratedCapacityAh - measuredCapacityAh, 2);
+    const capacityLossPercent = roundTo(100 - sohPercent, 2);
+    let status;
+    if (sohPercent >= 80) {
+        status = 'excellent';
+    }
+    else if (sohPercent >= 60) {
+        status = 'good';
+    }
+    else if (sohPercent >= 40) {
+        status = 'degraded';
+    }
+    else if (sohPercent >= 20) {
+        status = 'poor';
+    }
+    else {
+        status = 'endOfLife';
+    }
+    return { sohPercent, capacityLoss, capacityLossPercent, status };
+}
+//# sourceMappingURL=stateOfHealth.js.map

package/dist/battery/stateOfHealth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateOfHealth.js","sourceRoot":"","sources":["../../src/battery/stateOfHealth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,kBAAkB,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;IAEtD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,kBAAkB,GAAG,eAAe,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,GAAG,kBAAkB,EAAE,CAAC,CAAC,CAAC;IACtE,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;IAEzD,IAAI,MAAiB,CAAC;IACtB,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QACrB,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;SAAM,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;SAAM,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,UAAU,CAAC;IACtB,CAAC;SAAM,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC;AACnE,CAAC"}

package/dist/battery/thermalRunaway.d.ts

@@ -0,0 +1,11 @@
+import type { ThermalRunawayInput, ThermalRunawayResult } from './types.js';
+/**
+ * Calculate thermal runaway safety margin
+ *
+ * @formula Tss = Tamb + I²R/(hA), margin = Trunaway - Tss
+ * @reference SAE J2464, UN 38.3
+ * @param input - Ambient temp, current, IR, heat transfer parameters, runaway onset temp
+ * @returns Steady-state temperature, safety margin, and safety status
+ */
+export declare function thermalRunaway(input: ThermalRunawayInput): ThermalRunawayResult;
+//# sourceMappingURL=thermalRunaway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thermalRunaway.d.ts","sourceRoot":"","sources":["../../src/battery/thermalRunaway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CA0B/E"}

package/dist/battery/thermalRunaway.js

@@ -0,0 +1,28 @@
+import { roundTo } from '../utils.js';
+/**
+ * Calculate thermal runaway safety margin
+ *
+ * @formula Tss = Tamb + I²R/(hA), margin = Trunaway - Tss
+ * @reference SAE J2464, UN 38.3
+ * @param input - Ambient temp, current, IR, heat transfer parameters, runaway onset temp
+ * @returns Steady-state temperature, safety margin, and safety status
+ */
+export function thermalRunaway(input) {
+    const { ambientTempC, currentA, internalResistanceOhm, heatTransferCoeff, surfaceAreaM2, runawayTempC, } = input;
+    const heatGenerationW = roundTo(currentA * currentA * internalResistanceOhm, 4);
+    const hA = heatTransferCoeff * surfaceAreaM2;
+    const temperatureRiseC = roundTo(heatGenerationW / hA, 2);
+    const steadyStateTempC = roundTo(ambientTempC + temperatureRiseC, 2);
+    const heatDissipationW = roundTo(hA * temperatureRiseC, 4);
+    const safetyMarginC = roundTo(runawayTempC - steadyStateTempC, 2);
+    const isSafe = safetyMarginC > 0;
+    return {
+        steadyStateTempC,
+        temperatureRiseC,
+        heatGenerationW,
+        heatDissipationW,
+        safetyMarginC,
+        isSafe,
+    };
+}
+//# sourceMappingURL=thermalRunaway.js.map

package/dist/battery/thermalRunaway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thermalRunaway.js","sourceRoot":"","sources":["../../src/battery/thermalRunaway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EACJ,YAAY,EACZ,QAAQ,EACR,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,GAAG,KAAK,CAAC;IAEV,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,GAAG,qBAAqB,EAAE,CAAC,CAAC,CAAC;IAChF,MAAM,EAAE,GAAG,iBAAiB,GAAG,aAAa,CAAC;IAC7C,MAAM,gBAAgB,GAAG,OAAO,CAAC,eAAe,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,gBAAgB,GAAG,OAAO,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,aAAa,GAAG,CAAC,CAAC;IAEjC,OAAO;QACL,gBAAgB;QAChB,gBAAgB;QAChB,eAAe;QACf,gBAAgB;QAChB,aAAa;QACb,MAAM;KACP,CAAC;AACJ,CAAC"}