formulab 0.1.0

package/dist/electronics/types.d.ts

@@ -0,0 +1,145 @@
+export type PasteType = 'sac305' | 'sn63pb37' | 'sac387' | 'snbi58';
+export interface ReflowInput {
+    pasteType: PasteType;
+}
+export interface ReflowResult {
+    pasteType: string;
+    meltingPoint: number;
+    preheatRate: string;
+    preheatTemp: string;
+    preheatTime: string;
+    soakTemp: string;
+    soakTime: string;
+    peakTemp: string;
+    timeAboveLiquidus: string;
+    coolingRate: string;
+    totalProfileTime: string;
+}
+export type BandCount = 4 | 5 | 6;
+export type ColorName = 'black' | 'brown' | 'red' | 'orange' | 'yellow' | 'green' | 'blue' | 'violet' | 'grey' | 'white' | 'gold' | 'silver';
+export interface ResistorBands {
+    bandCount: BandCount;
+    bands: ColorName[];
+}
+export interface ResistorResult {
+    resistance: number;
+    tolerance: number;
+    tempCoeff?: number;
+    formatted: string;
+}
+export interface SmtTaktInput {
+    placementRate: number;
+    componentsPerBoard: number;
+    boardsPerPanel: number;
+    setupTimeSec: number;
+    availableTimeMin: number;
+}
+export interface SmtTaktResult {
+    placementTimeSec: number;
+    totalCycleTimeSec: number;
+    boardsPerHour: number;
+    totalBoardsPerShift: number;
+    lineUtilization: number;
+}
+export interface SolderInput {
+    padCount: number;
+    avgPadArea: number;
+    stencilThickness: number;
+    transferEfficiency: number;
+    density: number;
+    boardsPerPanel: number;
+    panelCount: number;
+}
+export interface SolderResult {
+    volumePerBoard: number;
+    weightPerBoard: number;
+    totalVolume: number;
+    totalWeight: number;
+    totalWeightKg: number;
+}
+export type TraceLayer = 'external' | 'internal';
+export interface TraceInput {
+    current: number;
+    tempRise: number;
+    copperWeight: number;
+    layer: TraceLayer;
+}
+export interface TraceResult {
+    widthMils: number;
+    widthMm: number;
+    crossSection: number;
+    resistance: number;
+    voltageDrop: number;
+    powerLoss: number;
+}
+export type AwgMaterial = 'copper' | 'aluminum';
+export interface AwgInput {
+    awg: number;
+    material: AwgMaterial;
+    tempC: number;
+}
+export interface AwgResult {
+    diameterMm: number;
+    diameterMils: number;
+    areaMm2: number;
+    areaCircularMils: number;
+    resistancePerM: number;
+    resistancePerFt: number;
+    currentCapacity: number;
+}
+export interface CapacitorCodeInput {
+    code: string;
+}
+export interface CapacitorCodeResult {
+    picofarads: number;
+    nanofarads: number;
+    microfarads: number;
+    formatted: string;
+    significantFigures: number;
+    multiplier: number;
+}
+export interface LedResistorInput {
+    supplyVoltage: number;
+    forwardVoltage: number;
+    forwardCurrent: number;
+}
+export interface LedResistorResult {
+    resistance: number;
+    standardResistance: number;
+    powerDissipation: number;
+    actualCurrent: number;
+}
+export type ApertureShape = 'rectangle' | 'circle';
+export type ComponentType = 'bga' | 'qfp' | 'chip' | 'sot' | 'general';
+export interface StencilInput {
+    shape: ApertureShape;
+    apertureWidth: number;
+    apertureLength: number;
+    stencilThickness: number;
+    componentType: ComponentType;
+}
+export interface StencilResult {
+    apertureArea: number;
+    wallArea: number;
+    areaRatio: number;
+    aspectRatio: number;
+    areaRatioOk: boolean;
+    aspectRatioOk: boolean;
+    recommendedAreaRatio: number;
+    recommendedAspectRatio: number;
+    status: 'good' | 'marginal' | 'poor';
+}
+export interface ViaInput {
+    holeDiameter: number;
+    platingThickness: number;
+    viaLength: number;
+    tempRise: number;
+}
+export interface ViaResult {
+    currentCapacity: number;
+    crossSectionMm2: number;
+    thermalResistance: number;
+    resistanceMOhm: number;
+    powerDissipation: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/electronics/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/electronics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/electronics/types.ts"],"names":[],"mappings":""}

package/dist/electronics/via.d.ts

@@ -0,0 +1,12 @@
+import type { ViaInput, ViaResult } from './types.js';
+/**
+ * Calculate PCB via current capacity using IPC-2152 approximation
+ *
+ * The cross-sectional area is the copper ring: π × [(r_outer)² - (r_inner)²]
+ * Where r_outer = holeDiameter/2 + platingThickness and r_inner = holeDiameter/2
+ *
+ * @param input - Via hole diameter, plating thickness, via length, and temp rise
+ * @returns Via current capacity and related properties, or null if invalid
+ */
+export declare function viaCurrent(input: ViaInput): ViaResult | null;
+//# sourceMappingURL=via.d.ts.map

package/dist/electronics/via.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"via.d.ts","sourceRoot":"","sources":["../../src/electronics/via.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAoBtD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CA+C5D"}

package/dist/electronics/via.js

@@ -0,0 +1,63 @@
+/**
+ * Round to specified decimal places
+ */
+function roundTo(value, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(value * factor) / factor;
+}
+// Copper resistivity at 20°C in Ω·mm²/m
+const COPPER_RESISTIVITY = 0.01724;
+// IPC-2152 via current capacity constants
+// I = k × ΔT^b × A^c
+// For internal vias: k=0.048, b=0.44, c=0.725 (similar to internal traces)
+const IPC_K = 0.048;
+const IPC_B = 0.44;
+const IPC_C = 0.725;
+/**
+ * Calculate PCB via current capacity using IPC-2152 approximation
+ *
+ * The cross-sectional area is the copper ring: π × [(r_outer)² - (r_inner)²]
+ * Where r_outer = holeDiameter/2 + platingThickness and r_inner = holeDiameter/2
+ *
+ * @param input - Via hole diameter, plating thickness, via length, and temp rise
+ * @returns Via current capacity and related properties, or null if invalid
+ */
+export function viaCurrent(input) {
+    const { holeDiameter, platingThickness, viaLength, tempRise } = input;
+    // Validate inputs
+    if (holeDiameter <= 0 || platingThickness <= 0 || viaLength <= 0 || tempRise <= 0) {
+        return null;
+    }
+    // Convert plating thickness from μm to mm
+    const platingMm = platingThickness / 1000;
+    // Calculate inner and outer radii
+    const innerRadius = holeDiameter / 2;
+    const outerRadius = innerRadius + platingMm;
+    // Cross-sectional area of the copper ring (mm²)
+    const crossSectionMm2 = Math.PI * (outerRadius * outerRadius - innerRadius * innerRadius);
+    // For IPC-2152, convert area to mils² (1 mm = 39.37 mils)
+    const crossSectionMils2 = crossSectionMm2 * 39.37 * 39.37;
+    // Current capacity using IPC-2152 formula (similar to internal layer)
+    // I = k × ΔT^b × A^c
+    const currentCapacity = IPC_K * Math.pow(tempRise, IPC_B) * Math.pow(crossSectionMils2, IPC_C);
+    // Via resistance (Ω)
+    // R = ρ × L / A (where ρ is in Ω·mm²/m, L in m, A in mm²)
+    const viaLengthM = viaLength / 1000;
+    const resistance = (COPPER_RESISTIVITY * viaLengthM) / crossSectionMm2;
+    const resistanceMOhm = resistance * 1000; // Convert to mΩ
+    // Thermal resistance approximation (simplified)
+    // For a cylindrical via: Rth ≈ L / (k × A) where k is thermal conductivity
+    // Copper thermal conductivity ≈ 385 W/(m·K)
+    const COPPER_THERMAL_CONDUCTIVITY = 385;
+    const thermalResistance = viaLengthM / (COPPER_THERMAL_CONDUCTIVITY * crossSectionMm2 / 1000000);
+    // Power dissipation at maximum current (mW)
+    const powerDissipation = currentCapacity * currentCapacity * resistance * 1000;
+    return {
+        currentCapacity: roundTo(currentCapacity, 2),
+        crossSectionMm2: roundTo(crossSectionMm2, 5),
+        thermalResistance: roundTo(thermalResistance, 2),
+        resistanceMOhm: roundTo(resistanceMOhm, 4),
+        powerDissipation: roundTo(powerDissipation, 2),
+    };
+}
+//# sourceMappingURL=via.js.map

package/dist/electronics/via.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"via.js","sourceRoot":"","sources":["../../src/electronics/via.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,SAAS,OAAO,CAAC,KAAa,EAAE,QAAgB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC7C,CAAC;AAED,wCAAwC;AACxC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC,0CAA0C;AAC1C,qBAAqB;AACrB,2EAA2E;AAC3E,MAAM,KAAK,GAAG,KAAK,CAAC;AACpB,MAAM,KAAK,GAAG,IAAI,CAAC;AACnB,MAAM,KAAK,GAAG,KAAK,CAAC;AAEpB;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAEtE,kBAAkB;IAClB,IAAI,YAAY,IAAI,CAAC,IAAI,gBAAgB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAC1C,MAAM,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAE1C,kCAAkC;IAClC,MAAM,WAAW,GAAG,YAAY,GAAG,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IAE5C,gDAAgD;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;IAE1F,0DAA0D;IAC1D,MAAM,iBAAiB,GAAG,eAAe,GAAG,KAAK,GAAG,KAAK,CAAC;IAE1D,sEAAsE;IACtE,qBAAqB;IACrB,MAAM,eAAe,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAE/F,qBAAqB;IACrB,0DAA0D;IAC1D,MAAM,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;IACpC,MAAM,UAAU,GAAG,CAAC,kBAAkB,GAAG,UAAU,CAAC,GAAG,eAAe,CAAC;IACvE,MAAM,cAAc,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC,gBAAgB;IAE1D,gDAAgD;IAChD,2EAA2E;IAC3E,4CAA4C;IAC5C,MAAM,2BAA2B,GAAG,GAAG,CAAC;IACxC,MAAM,iBAAiB,GAAG,UAAU,GAAG,CAAC,2BAA2B,GAAG,eAAe,GAAG,OAAO,CAAC,CAAC;IAEjG,4CAA4C;IAC5C,MAAM,gBAAgB,GAAG,eAAe,GAAG,eAAe,GAAG,UAAU,GAAG,IAAI,CAAC;IAE/E,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC5C,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC5C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAChD,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/energy/carbonFootprint.d.ts

@@ -0,0 +1,13 @@
+import type { CarbonFootprintInput, CarbonFootprintResult } from './types.js';
+/**
+ * Calculate carbon footprint from electricity usage
+ *
+ * CO2 (kg) = electricity usage (kWh) * emission factor (g CO2/kWh) / 1000
+ * Trees equivalent = CO2 (kg) / 21.76 (kg CO2 absorbed per tree per year)
+ * Cars equivalent = CO2 (kg) / 4600 (kg CO2 emitted per car per year)
+ *
+ * @param input - Carbon footprint input parameters
+ * @returns Carbon footprint result with CO2 emissions and environmental equivalents
+ */
+export declare function carbonFootprint(input: CarbonFootprintInput): CarbonFootprintResult;
+//# sourceMappingURL=carbonFootprint.d.ts.map

package/dist/energy/carbonFootprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbonFootprint.d.ts","sourceRoot":"","sources":["../../src/energy/carbonFootprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ9E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CA4BlF"}

package/dist/energy/carbonFootprint.js

@@ -0,0 +1,41 @@
+// Constants for environmental equivalents
+// Average tree absorbs ~21.76 kg CO2 per year (EPA estimate)
+const KG_CO2_PER_TREE_PER_YEAR = 21.76;
+// Average passenger vehicle emits ~4,600 kg CO2 per year (EPA estimate)
+const KG_CO2_PER_CAR_PER_YEAR = 4600;
+/**
+ * Calculate carbon footprint from electricity usage
+ *
+ * CO2 (kg) = electricity usage (kWh) * emission factor (g CO2/kWh) / 1000
+ * Trees equivalent = CO2 (kg) / 21.76 (kg CO2 absorbed per tree per year)
+ * Cars equivalent = CO2 (kg) / 4600 (kg CO2 emitted per car per year)
+ *
+ * @param input - Carbon footprint input parameters
+ * @returns Carbon footprint result with CO2 emissions and environmental equivalents
+ */
+export function carbonFootprint(input) {
+    const { electricityUsage, emissionFactor } = input;
+    // Handle edge case - zero usage
+    if (electricityUsage <= 0) {
+        return {
+            co2Kg: 0,
+            co2Tonnes: 0,
+            treesEquivalent: 0,
+            carsEquivalent: 0,
+        };
+    }
+    // Calculate CO2 emissions
+    // emission factor is in g CO2/kWh, convert to kg
+    const co2Kg = (electricityUsage * emissionFactor) / 1000;
+    const co2Tonnes = co2Kg / 1000;
+    // Calculate environmental equivalents
+    const treesEquivalent = Math.round(co2Kg / KG_CO2_PER_TREE_PER_YEAR);
+    const carsEquivalent = co2Kg / KG_CO2_PER_CAR_PER_YEAR;
+    return {
+        co2Kg,
+        co2Tonnes,
+        treesEquivalent,
+        carsEquivalent,
+    };
+}
+//# sourceMappingURL=carbonFootprint.js.map

package/dist/energy/carbonFootprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbonFootprint.js","sourceRoot":"","sources":["../../src/energy/carbonFootprint.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,6DAA6D;AAC7D,MAAM,wBAAwB,GAAG,KAAK,CAAC;AACvC,wEAAwE;AACxE,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAEnD,gCAAgC;IAChC,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,CAAC;YACR,SAAS,EAAE,CAAC;YACZ,eAAe,EAAE,CAAC;YAClB,cAAc,EAAE,CAAC;SAClB,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,iDAAiD;IACjD,MAAM,KAAK,GAAG,CAAC,gBAAgB,GAAG,cAAc,CAAC,GAAG,IAAI,CAAC;IACzD,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;IAE/B,sCAAsC;IACtC,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,wBAAwB,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,KAAK,GAAG,uBAAuB,CAAC;IAEvD,OAAO;QACL,KAAK;QACL,SAAS;QACT,eAAe;QACf,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/energy/compressedAirCost.d.ts

@@ -0,0 +1,14 @@
+import type { CompressedAirCostInput, CompressedAirCostResult } from './types.js';
+/**
+ * Calculate compressed air production cost
+ *
+ * Electricity cost = compressor power (kW) * running hours * electricity rate ($/kWh)
+ * Total cost = electricity cost + maintenance cost
+ * Cost per m3 = total cost / air output (m3)
+ * Cost per CFM = cost per m3 / 35.3147 (m3 to CFM conversion)
+ *
+ * @param input - Compressed air cost input parameters
+ * @returns Compressed air cost result
+ */
+export declare function compressedAirCost(input: CompressedAirCostInput): CompressedAirCostResult;
+//# sourceMappingURL=compressedAirCost.d.ts.map

package/dist/energy/compressedAirCost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressedAirCost.d.ts","sourceRoot":"","sources":["../../src/energy/compressedAirCost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAKlF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CA6BxF"}

package/dist/energy/compressedAirCost.js

@@ -0,0 +1,39 @@
+// Conversion factor: 1 m3 = 35.3147 CFM (cubic feet per minute)
+const M3_TO_CFM = 35.3147;
+/**
+ * Calculate compressed air production cost
+ *
+ * Electricity cost = compressor power (kW) * running hours * electricity rate ($/kWh)
+ * Total cost = electricity cost + maintenance cost
+ * Cost per m3 = total cost / air output (m3)
+ * Cost per CFM = cost per m3 / 35.3147 (m3 to CFM conversion)
+ *
+ * @param input - Compressed air cost input parameters
+ * @returns Compressed air cost result
+ */
+export function compressedAirCost(input) {
+    const { compressorPower, runningHours, electricityRate, airOutput, maintenanceCost } = input;
+    // Handle edge case - invalid inputs
+    if (compressorPower <= 0 || runningHours <= 0 || airOutput <= 0) {
+        return {
+            electricityCost: 0,
+            totalCost: 0,
+            costPerM3: 0,
+            costPerCfm: 0,
+        };
+    }
+    // Calculate electricity cost
+    const electricityCost = compressorPower * runningHours * electricityRate;
+    // Calculate total cost
+    const totalCost = electricityCost + maintenanceCost;
+    // Calculate cost per unit volume
+    const costPerM3 = totalCost / airOutput;
+    const costPerCfm = costPerM3 / M3_TO_CFM;
+    return {
+        electricityCost,
+        totalCost,
+        costPerM3,
+        costPerCfm,
+    };
+}
+//# sourceMappingURL=compressedAirCost.js.map

package/dist/energy/compressedAirCost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressedAirCost.js","sourceRoot":"","sources":["../../src/energy/compressedAirCost.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,SAAS,GAAG,OAAO,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;IAE7F,oCAAoC;IACpC,IAAI,eAAe,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAChE,OAAO;YACL,eAAe,EAAE,CAAC;YAClB,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,MAAM,eAAe,GAAG,eAAe,GAAG,YAAY,GAAG,eAAe,CAAC;IAEzE,uBAAuB;IACvB,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;IAEpD,iCAAiC;IACjC,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAEzC,OAAO;QACL,eAAe;QACf,SAAS;QACT,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/energy/index.d.ts

@@ -0,0 +1,8 @@
+export { carbonFootprint } from './carbonFootprint.js';
+export { compressedAirCost } from './compressedAirCost.js';
+export { motorEfficiency } from './motorEfficiency.js';
+export { pfCorrection } from './pfCorrection.js';
+export { powerCost } from './powerCost.js';
+export { vfdSavings } from './vfdSavings.js';
+export type { CarbonFootprintInput, CarbonFootprintResult, CompressedAirCostInput, CompressedAirCostResult, MotorEfficiencyInput, MotorEfficiencyResult, PfCorrectionInput, PfCorrectionResult, PowerCostInput, PowerCostResult, VfdSavingsInput, VfdSavingsResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/energy/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,YAAY,EAEV,oBAAoB,EACpB,qBAAqB,EAErB,sBAAsB,EACtB,uBAAuB,EAEvB,oBAAoB,EACpB,qBAAqB,EAErB,iBAAiB,EACjB,kBAAkB,EAElB,cAAc,EACd,eAAe,EAEf,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/energy/index.js

@@ -0,0 +1,8 @@
+// Energy domain formulas
+export { carbonFootprint } from './carbonFootprint.js';
+export { compressedAirCost } from './compressedAirCost.js';
+export { motorEfficiency } from './motorEfficiency.js';
+export { pfCorrection } from './pfCorrection.js';
+export { powerCost } from './powerCost.js';
+export { vfdSavings } from './vfdSavings.js';
+//# sourceMappingURL=index.js.map

package/dist/energy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/energy/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/energy/motorEfficiency.d.ts

@@ -0,0 +1,14 @@
+import type { MotorEfficiencyInput, MotorEfficiencyResult } from './types.js';
+/**
+ * Calculate motor efficiency upgrade economics
+ *
+ * Annual energy = motor power (kW) * running hours * load factor / efficiency
+ * Annual cost = annual energy * electricity rate
+ * Annual savings = current annual cost - new annual cost
+ * Payback period = upgrade cost / annual savings
+ *
+ * @param input - Motor efficiency input parameters
+ * @returns Motor efficiency result with costs, savings, and payback period
+ */
+export declare function motorEfficiency(input: MotorEfficiencyInput): MotorEfficiencyResult;
+//# sourceMappingURL=motorEfficiency.d.ts.map

package/dist/energy/motorEfficiency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motorEfficiency.d.ts","sourceRoot":"","sources":["../../src/energy/motorEfficiency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAgDlF"}

package/dist/energy/motorEfficiency.js

@@ -0,0 +1,47 @@
+/**
+ * Calculate motor efficiency upgrade economics
+ *
+ * Annual energy = motor power (kW) * running hours * load factor / efficiency
+ * Annual cost = annual energy * electricity rate
+ * Annual savings = current annual cost - new annual cost
+ * Payback period = upgrade cost / annual savings
+ *
+ * @param input - Motor efficiency input parameters
+ * @returns Motor efficiency result with costs, savings, and payback period
+ */
+export function motorEfficiency(input) {
+    const { motorPower, runningHours, currentEfficiency, newEfficiency, electricityRate, loadFactor, upgradeCost, } = input;
+    // Handle edge case - invalid efficiency values
+    if (currentEfficiency <= 0 || newEfficiency <= 0) {
+        return {
+            currentAnnualCost: 0,
+            newAnnualCost: 0,
+            annualSavings: 0,
+            energySavings: 0,
+            paybackPeriod: null,
+        };
+    }
+    // Calculate annual energy consumption for each efficiency level
+    // Energy = Power * Hours * LoadFactor / Efficiency
+    const currentAnnualEnergy = (motorPower * runningHours * loadFactor) / currentEfficiency;
+    const newAnnualEnergy = (motorPower * runningHours * loadFactor) / newEfficiency;
+    // Calculate annual costs
+    const currentAnnualCost = currentAnnualEnergy * electricityRate;
+    const newAnnualCost = newAnnualEnergy * electricityRate;
+    // Calculate savings
+    const annualSavings = currentAnnualCost - newAnnualCost;
+    const energySavings = currentAnnualEnergy - newAnnualEnergy;
+    // Calculate payback period
+    let paybackPeriod = null;
+    if (upgradeCost !== undefined && upgradeCost > 0 && annualSavings > 0) {
+        paybackPeriod = upgradeCost / annualSavings;
+    }
+    return {
+        currentAnnualCost,
+        newAnnualCost,
+        annualSavings,
+        energySavings,
+        paybackPeriod,
+    };
+}
+//# sourceMappingURL=motorEfficiency.js.map

package/dist/energy/motorEfficiency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motorEfficiency.js","sourceRoot":"","sources":["../../src/energy/motorEfficiency.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,UAAU,EACV,WAAW,GACZ,GAAG,KAAK,CAAC;IAEV,+CAA+C;IAC/C,IAAI,iBAAiB,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO;YACL,iBAAiB,EAAE,CAAC;YACpB,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,IAAI;SACpB,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,mDAAmD;IACnD,MAAM,mBAAmB,GAAG,CAAC,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC,GAAG,iBAAiB,CAAC;IACzF,MAAM,eAAe,GAAG,CAAC,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC,GAAG,aAAa,CAAC;IAEjF,yBAAyB;IACzB,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAChE,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;IAExD,oBAAoB;IACpB,MAAM,aAAa,GAAG,iBAAiB,GAAG,aAAa,CAAC;IACxD,MAAM,aAAa,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAE5D,2BAA2B;IAC3B,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtE,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,iBAAiB;QACjB,aAAa;QACb,aAAa;QACb,aAAa;QACb,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/energy/pfCorrection.d.ts

@@ -0,0 +1,15 @@
+import type { PfCorrectionInput, PfCorrectionResult } from './types.js';
+/**
+ * Calculate power factor correction requirements and savings
+ *
+ * Formula: kVAR required = kW * (tan(arccos(PF_current)) - tan(arccos(PF_target)))
+ *
+ * Where:
+ * - kVA = kW / PF (apparent power)
+ * - tan(arccos(PF)) gives the reactive power factor
+ *
+ * @param input - Power factor correction input parameters
+ * @returns Power factor correction result with kVAR, costs, and savings
+ */
+export declare function pfCorrection(input: PfCorrectionInput): PfCorrectionResult;
+//# sourceMappingURL=pfCorrection.d.ts.map

package/dist/energy/pfCorrection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pfCorrection.d.ts","sourceRoot":"","sources":["../../src/energy/pfCorrection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA4DzE"}

package/dist/energy/pfCorrection.js

@@ -0,0 +1,56 @@
+/**
+ * Calculate power factor correction requirements and savings
+ *
+ * Formula: kVAR required = kW * (tan(arccos(PF_current)) - tan(arccos(PF_target)))
+ *
+ * Where:
+ * - kVA = kW / PF (apparent power)
+ * - tan(arccos(PF)) gives the reactive power factor
+ *
+ * @param input - Power factor correction input parameters
+ * @returns Power factor correction result with kVAR, costs, and savings
+ */
+export function pfCorrection(input) {
+    const { kW, currentPf, targetPf, electricityRate, monthlyUsageHours, pfPenaltyRate, pfPenaltyThreshold, capacitorCostPerKvar, } = input;
+    // Calculate current and target apparent power (kVA)
+    const currentKva = kW / currentPf;
+    const targetKva = kW / targetPf;
+    // Calculate required kVAR using the formula:
+    // kVAR = kW * (tan(arccos(PF_current)) - tan(arccos(PF_target)))
+    const currentAngle = Math.acos(currentPf);
+    const targetAngle = Math.acos(targetPf);
+    const kvarRequired = kW * (Math.tan(currentAngle) - Math.tan(targetAngle));
+    // Calculate capacitor cost
+    const capacitorCost = kvarRequired * capacitorCostPerKvar;
+    // Calculate monthly energy consumption (kWh)
+    const monthlyKwh = kW * monthlyUsageHours;
+    // Calculate PF penalty
+    // Penalty is typically applied when PF is below threshold
+    // Penalty = (threshold - actual PF) / 0.01 * penalty rate * energy cost
+    const calculatePenalty = (pf) => {
+        if (pf >= pfPenaltyThreshold)
+            return 0;
+        const penaltySteps = Math.floor((pfPenaltyThreshold - pf) * 100);
+        return penaltySteps * pfPenaltyRate * monthlyKwh * electricityRate;
+    };
+    const currentMonthlyPenalty = calculatePenalty(currentPf);
+    const newMonthlyPenalty = calculatePenalty(targetPf);
+    // Monthly savings from avoided penalties
+    const monthlySavings = currentMonthlyPenalty - newMonthlyPenalty;
+    // Annual savings
+    const annualSavings = monthlySavings * 12;
+    // Payback period in months (return 0 if no savings)
+    const paybackMonths = monthlySavings > 0 ? capacitorCost / monthlySavings : 0;
+    return {
+        currentKva,
+        targetKva,
+        kvarRequired,
+        capacitorCost,
+        currentMonthlyPenalty,
+        newMonthlyPenalty,
+        monthlySavings,
+        annualSavings,
+        paybackMonths,
+    };
+}
+//# sourceMappingURL=pfCorrection.js.map

package/dist/energy/pfCorrection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pfCorrection.js","sourceRoot":"","sources":["../../src/energy/pfCorrection.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EACJ,EAAE,EACF,SAAS,EACT,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GACrB,GAAG,KAAK,CAAC;IAEV,oDAAoD;IACpD,MAAM,UAAU,GAAG,EAAE,GAAG,SAAS,CAAC;IAClC,MAAM,SAAS,GAAG,EAAE,GAAG,QAAQ,CAAC;IAEhC,6CAA6C;IAC7C,iEAAiE;IACjE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3E,2BAA2B;IAC3B,MAAM,aAAa,GAAG,YAAY,GAAG,oBAAoB,CAAC;IAE1D,6CAA6C;IAC7C,MAAM,UAAU,GAAG,EAAE,GAAG,iBAAiB,CAAC;IAE1C,uBAAuB;IACvB,0DAA0D;IAC1D,wEAAwE;IACxE,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAU,EAAE;QAC9C,IAAI,EAAE,IAAI,kBAAkB;YAAE,OAAO,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,kBAAkB,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;QACjE,OAAO,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,eAAe,CAAC;IACrE,CAAC,CAAC;IAEF,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAErD,yCAAyC;IACzC,MAAM,cAAc,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;IAEjE,iBAAiB;IACjB,MAAM,aAAa,GAAG,cAAc,GAAG,EAAE,CAAC;IAE1C,oDAAoD;IACpD,MAAM,aAAa,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,OAAO;QACL,UAAU;QACV,SAAS;QACT,YAAY;QACZ,aAAa;QACb,qBAAqB;QACrB,iBAAiB;QACjB,cAAc;QACd,aAAa;QACb,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/energy/powerCost.d.ts

@@ -0,0 +1,15 @@
+import type { PowerCostInput, PowerCostResult } from './types.js';
+/**
+ * Calculate power cost including energy, demand, power factor penalty, and fixed charges
+ *
+ * Energy cost = energy consumption (kWh) * energy rate ($/kWh)
+ * Demand cost = demand peak (kW) * demand rate ($/kW)
+ * PF penalty = (threshold - actual PF) / 0.01 * penalty rate * (energy cost + demand cost)
+ *              (only if actual PF < threshold)
+ * Total cost = energy cost + demand cost + PF penalty + fixed charges
+ *
+ * @param input - Power cost input parameters
+ * @returns Power cost result with breakdown of all costs
+ */
+export declare function powerCost(input: PowerCostInput): PowerCostResult;
+//# sourceMappingURL=powerCost.d.ts.map

package/dist/energy/powerCost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerCost.d.ts","sourceRoot":"","sources":["../../src/energy/powerCost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAqChE"}

package/dist/energy/powerCost.js

@@ -0,0 +1,37 @@
+/**
+ * Calculate power cost including energy, demand, power factor penalty, and fixed charges
+ *
+ * Energy cost = energy consumption (kWh) * energy rate ($/kWh)
+ * Demand cost = demand peak (kW) * demand rate ($/kW)
+ * PF penalty = (threshold - actual PF) / 0.01 * penalty rate * (energy cost + demand cost)
+ *              (only if actual PF < threshold)
+ * Total cost = energy cost + demand cost + PF penalty + fixed charges
+ *
+ * @param input - Power cost input parameters
+ * @returns Power cost result with breakdown of all costs
+ */
+export function powerCost(input) {
+    const { energyConsumption, energyRate, demandPeak, demandRate, powerFactor, pfPenaltyThreshold, pfPenaltyRate, fixedCharges, } = input;
+    // Calculate energy cost
+    const energyCost = energyConsumption * energyRate;
+    // Calculate demand cost
+    const demandCost = demandPeak * demandRate;
+    // Calculate power factor penalty
+    let pfPenalty = 0;
+    if (powerFactor < pfPenaltyThreshold && pfPenaltyRate > 0) {
+        // Number of 0.01 steps below threshold
+        const stepsBelow = Math.round((pfPenaltyThreshold - powerFactor) / 0.01);
+        // Penalty is applied to energy + demand costs
+        pfPenalty = stepsBelow * pfPenaltyRate * (energyCost + demandCost);
+    }
+    // Calculate total cost
+    const totalCost = energyCost + demandCost + pfPenalty + fixedCharges;
+    return {
+        energyCost,
+        demandCost,
+        pfPenalty,
+        fixedCharges,
+        totalCost,
+    };
+}
+//# sourceMappingURL=powerCost.js.map

package/dist/energy/powerCost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerCost.js","sourceRoot":"","sources":["../../src/energy/powerCost.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EACJ,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,GAAG,KAAK,CAAC;IAEV,wBAAwB;IACxB,MAAM,UAAU,GAAG,iBAAiB,GAAG,UAAU,CAAC;IAElD,wBAAwB;IACxB,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IAE3C,iCAAiC;IACjC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,kBAAkB,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAC1D,uCAAuC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,kBAAkB,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;QACzE,8CAA8C;QAC9C,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IACrE,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;IAErE,OAAO;QACL,UAAU;QACV,UAAU;QACV,SAAS;QACT,YAAY;QACZ,SAAS;KACV,CAAC;AACJ,CAAC"}