@circuit-forge/eda-core 1.0.0

package/dist/utils/unit-parser.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * SPICE Value Unit Parser
+ * Handles parsing and formatting of SPICE-style values with suffixes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSpiceValue = parseSpiceValue;
+exports.formatSpiceValue = formatSpiceValue;
+exports.normalizeValue = normalizeValue;
+exports.valuesEqual = valuesEqual;
+exports.parseTimeValue = parseTimeValue;
+exports.parseFrequencyValue = parseFrequencyValue;
+/**
+ * SPICE suffix multipliers
+ */
+const SPICE_SUFFIXES = {
+    // Standard SI prefixes
+    T: 1e12,
+    G: 1e9,
+    MEG: 1e6,
+    K: 1e3,
+    M: 1e-3,
+    U: 1e-6,
+    N: 1e-9,
+    P: 1e-12,
+    F: 1e-15,
+    // Alternative notations
+    MIL: 25.4e-6,
+};
+/**
+ * Unit abbreviations
+ */
+const UNIT_ABBREVS = {
+    OHM: 'Ω',
+    OHMS: 'Ω',
+    FARAD: 'F',
+    HENRY: 'H',
+    VOLT: 'V',
+    VOLTS: 'V',
+    AMP: 'A',
+    AMPS: 'A',
+    AMPERE: 'A',
+    AMPERES: 'A',
+    WATT: 'W',
+    WATTS: 'W',
+    HERTZ: 'Hz',
+    HZ: 'Hz',
+    SECOND: 's',
+    SECONDS: 's',
+    SEC: 's',
+};
+/**
+ * Parse a SPICE-style value string to a number
+ * Supports suffixes like K, MEG, M, U, N, P, F
+ *
+ * Examples:
+ * - "1K" -> 1000
+ * - "10MEG" -> 10000000
+ * - "100n" -> 0.0000001
+ * - "1.5u" -> 0.0000015
+ * - "47pF" -> 4.7e-11 (with unit 'F')
+ */
+function parseSpiceValue(input) {
+    const original = input.trim();
+    if (!original) {
+        return { value: 0, original, isValid: false, error: 'Empty value' };
+    }
+    // Handle pure numbers
+    const pureNumber = parseFloat(original);
+    if (!isNaN(pureNumber) && /^-?\d*\.?\d+$/.test(original)) {
+        return { value: pureNumber, original, isValid: true };
+    }
+    // Regex to match value with optional suffix and unit
+    // Examples: 1K, 10MEG, 100nF, 1.5uH, 47pF
+    const regex = /^(-?\d*\.?\d+)\s*([A-Za-z]+)?$/i;
+    const match = original.match(regex);
+    if (!match) {
+        return { value: 0, original, isValid: false, error: 'Invalid format' };
+    }
+    const numPart = parseFloat(match[1] || '0');
+    const suffixPart = (match[2] || '').toUpperCase();
+    if (isNaN(numPart)) {
+        return { value: 0, original, isValid: false, error: 'Invalid number' };
+    }
+    if (!suffixPart) {
+        return { value: numPart, original, isValid: true };
+    }
+    // Try to find a matching suffix
+    let multiplier = 1;
+    let unit;
+    // Check for MEG first (3 letters)
+    if (suffixPart.startsWith('MEG')) {
+        multiplier = SPICE_SUFFIXES['MEG'] || 1e6;
+        const remaining = suffixPart.slice(3);
+        if (remaining) {
+            unit = UNIT_ABBREVS[remaining] || remaining;
+        }
+    }
+    // Check for MIL
+    else if (suffixPart.startsWith('MIL')) {
+        multiplier = SPICE_SUFFIXES['MIL'] || 25.4e-6;
+        const remaining = suffixPart.slice(3);
+        if (remaining) {
+            unit = UNIT_ABBREVS[remaining] || remaining;
+        }
+    }
+    // Check single letter suffixes
+    else if (suffixPart.length >= 1) {
+        const firstChar = suffixPart[0] || '';
+        if (SPICE_SUFFIXES[firstChar] !== undefined) {
+            multiplier = SPICE_SUFFIXES[firstChar] || 1;
+            const remaining = suffixPart.slice(1);
+            if (remaining) {
+                unit = UNIT_ABBREVS[remaining] || remaining;
+            }
+        }
+        else {
+            // No suffix, entire thing is a unit
+            unit = UNIT_ABBREVS[suffixPart] || suffixPart;
+        }
+    }
+    return {
+        value: numPart * multiplier,
+        unit,
+        original,
+        isValid: true,
+    };
+}
+/**
+ * Format a number as a SPICE value string
+ */
+function formatSpiceValue(value, unit) {
+    if (value === 0) {
+        return unit ? `0${unit}` : '0';
+    }
+    const absValue = Math.abs(value);
+    const sign = value < 0 ? '-' : '';
+    let suffix = '';
+    let scaledValue = absValue;
+    if (absValue >= 1e12) {
+        suffix = 'T';
+        scaledValue = absValue / 1e12;
+    }
+    else if (absValue >= 1e9) {
+        suffix = 'G';
+        scaledValue = absValue / 1e9;
+    }
+    else if (absValue >= 1e6) {
+        suffix = 'MEG';
+        scaledValue = absValue / 1e6;
+    }
+    else if (absValue >= 1e3) {
+        suffix = 'K';
+        scaledValue = absValue / 1e3;
+    }
+    else if (absValue >= 1) {
+        suffix = '';
+        scaledValue = absValue;
+    }
+    else if (absValue >= 1e-3) {
+        suffix = 'm';
+        scaledValue = absValue / 1e-3;
+    }
+    else if (absValue >= 1e-6) {
+        suffix = 'u';
+        scaledValue = absValue / 1e-6;
+    }
+    else if (absValue >= 1e-9) {
+        suffix = 'n';
+        scaledValue = absValue / 1e-9;
+    }
+    else if (absValue >= 1e-12) {
+        suffix = 'p';
+        scaledValue = absValue / 1e-12;
+    }
+    else {
+        suffix = 'f';
+        scaledValue = absValue / 1e-15;
+    }
+    // Format number to reasonable precision
+    let formatted;
+    if (Number.isInteger(scaledValue)) {
+        formatted = scaledValue.toString();
+    }
+    else {
+        formatted = scaledValue.toPrecision(4).replace(/\.?0+$/, '');
+    }
+    return `${sign}${formatted}${suffix}${unit || ''}`;
+}
+/**
+ * Normalize a value to base units
+ */
+function normalizeValue(input) {
+    const parsed = parseSpiceValue(input);
+    return parsed.isValid ? parsed.value : 0;
+}
+/**
+ * Compare two SPICE values for equality (within tolerance)
+ */
+function valuesEqual(a, b, tolerance = 1e-9) {
+    const parsedA = parseSpiceValue(a);
+    const parsedB = parseSpiceValue(b);
+    if (!parsedA.isValid || !parsedB.isValid) {
+        return false;
+    }
+    const diff = Math.abs(parsedA.value - parsedB.value);
+    const maxVal = Math.max(Math.abs(parsedA.value), Math.abs(parsedB.value));
+    if (maxVal === 0) {
+        return diff === 0;
+    }
+    return diff / maxVal < tolerance;
+}
+/**
+ * Parse time value (handles s, ms, us, ns, ps)
+ */
+function parseTimeValue(input) {
+    const parsed = parseSpiceValue(input);
+    // Time values should be in seconds
+    return parsed.value;
+}
+/**
+ * Parse frequency value (handles Hz, kHz, MHz, GHz)
+ */
+function parseFrequencyValue(input) {
+    const parsed = parseSpiceValue(input);
+    // Frequency values should be in Hz
+    return parsed.value;
+}
+//# sourceMappingURL=unit-parser.js.map

package/dist/utils/unit-parser.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+    "name": "@circuit-forge/eda-core",
+    "version": "1.0.0",
+    "description": "Circuit manipulation, netlist generation, and SPICE parsing library",
+    "license": "MIT",
+    "author": "Abdulberk",
+    "homepage": "https://github.com/Abdulberk/circuit-forge/tree/main/packages/eda-core#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Abdulberk/circuit-forge.git",
+        "directory": "packages/eda-core"
+    },
+    "bugs": {
+        "url": "https://github.com/Abdulberk/circuit-forge/issues"
+    },
+    "keywords": [
+        "spice",
+        "ngspice",
+        "netlist",
+        "circuit",
+        "eda",
+        "schematic",
+        "simulation",
+        "zod"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "prepublishOnly": "npm run build",
+        "dev": "tsc --watch",
+        "lint": "eslint src --ext .ts",
+        "lint:fix": "eslint src --ext .ts --fix",
+        "test": "jest",
+        "test:cov": "jest --coverage",
+        "clean": "rm -rf dist coverage",
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "zod": "^3.22.4"
+    },
+    "devDependencies": {
+        "@types/jest": "^29.5.11",
+        "@types/node": "^20.11.0",
+        "jest": "^29.7.0",
+        "ts-jest": "^29.1.1",
+        "typescript": "^5.3.3"
+    },
+    "peerDependencies": {
+        "typescript": "^5.0.0"
+    }
+}