@circuit-forge/eda-core 1.0.0

package/dist/netlist/generator.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateNetlist = generateNetlist;
+exports.getNodeNames = getNodeNames;
+exports.validateNetlist = validateNetlist;
+const circuit_1 = require("../types/circuit");
+const analysis_1 = require("../types/analysis");
+const sanitizer_1 = require("./sanitizer");
+/**
+ * Default diode model for circuits without explicit model
+ */
+const DEFAULT_DIODE_MODEL = `.model DDEFAULT D(IS=1e-14 N=1.05 RS=10 BV=100 IBV=1e-10)`;
+/**
+ * Generate a complete SPICE netlist from circuit JSON
+ */
+function generateNetlist(circuit, analysis, options = {}) {
+    const lines = [];
+    // Title
+    const title = options.title || circuit.metadata?.name || 'Untitled Circuit';
+    lines.push(`* ${title}`);
+    lines.push(`* Generated by eda-core`);
+    lines.push(`* ${new Date().toISOString()}`);
+    lines.push('');
+    // Build node map
+    const nodeMap = buildNodeMap(circuit.nets);
+    // Check if we need default diode model
+    const needsDiodeModel = circuit.components.some((c) => c.type === 'diode' && !c.model);
+    if (needsDiodeModel) {
+        lines.push('* Default diode model');
+        lines.push(DEFAULT_DIODE_MODEL);
+        lines.push('');
+    }
+    // Include files (with validation)
+    if (options.includeFiles && options.includeFiles.length > 0) {
+        if (options.jobDir) {
+            (0, sanitizer_1.validateIncludePaths)(options.includeFiles, options.jobDir);
+        }
+        lines.push('* Include files');
+        for (const file of options.includeFiles) {
+            lines.push(`.include "${file}"`);
+        }
+        lines.push('');
+    }
+    // Components
+    lines.push('* Components');
+    for (const component of circuit.components) {
+        const spiceLine = componentToSpice(component, nodeMap);
+        if (spiceLine) {
+            lines.push(spiceLine);
+        }
+    }
+    lines.push('');
+    // Analysis
+    lines.push('* Analysis');
+    lines.push((0, analysis_1.analysisToSpice)(analysis));
+    lines.push('');
+    // Control block for output
+    const probes = options.probes || generateDefaultProbes(circuit, nodeMap);
+    lines.push('* Control block');
+    lines.push('.control');
+    lines.push('  set filetype=ascii');
+    lines.push('  run');
+    if (probes.length > 0) {
+        const probeList = probes.join(' ');
+        lines.push(`  wrdata output.csv ${probeList}`);
+    }
+    lines.push('  quit');
+    lines.push('.endc');
+    lines.push('');
+    lines.push('.end');
+    return lines.join('\n');
+}
+/**
+ * Build a map from net IDs to SPICE node names
+ */
+function buildNodeMap(nets) {
+    const nodeMap = new Map();
+    for (const net of nets) {
+        if (net.isGround) {
+            nodeMap.set(net.id, '0');
+        }
+        else {
+            nodeMap.set(net.id, (0, sanitizer_1.sanitizeNodeName)(net.id));
+        }
+    }
+    return nodeMap;
+}
+/**
+ * Convert a component to a SPICE line
+ */
+function componentToSpice(component, nodeMap) {
+    const { type, designator, value, model, pins } = component;
+    // Ground is not a real component
+    if (type === 'ground') {
+        return null;
+    }
+    const prefix = circuit_1.SPICE_PREFIXES[type];
+    if (!prefix) {
+        throw new Error(`Unknown component type: ${type}`);
+    }
+    // Get node names for pins
+    const nodes = pins.map((pin) => {
+        const node = nodeMap.get(pin.netId);
+        if (!node) {
+            throw new Error(`Net not found: ${pin.netId} for component ${designator}`);
+        }
+        return node;
+    });
+    // Generate SPICE line based on component type
+    switch (type) {
+        case 'resistor':
+        case 'capacitor':
+        case 'inductor':
+            return `${designator} ${nodes.join(' ')} ${value || '0'}`;
+        case 'voltage_source':
+        case 'current_source':
+            return `${designator} ${nodes.join(' ')} ${value || 'DC 0'}`;
+        case 'diode':
+            return `${designator} ${nodes.join(' ')} ${model || 'DDEFAULT'}`;
+        default:
+            throw new Error(`Unsupported component type: ${type}`);
+    }
+}
+/**
+ * Generate default probes (all node voltages)
+ */
+function generateDefaultProbes(circuit, nodeMap) {
+    const probes = [];
+    for (const net of circuit.nets) {
+        if (!net.isGround) {
+            const nodeName = nodeMap.get(net.id);
+            if (nodeName) {
+                probes.push(`v(${nodeName})`);
+            }
+        }
+    }
+    return probes;
+}
+/**
+ * Get all unique node names from a circuit
+ */
+function getNodeNames(circuit) {
+    const nodeMap = buildNodeMap(circuit.nets);
+    return Array.from(nodeMap.values());
+}
+/**
+ * Validate that a netlist is syntactically correct (basic check)
+ */
+function validateNetlist(netlist) {
+    const errors = [];
+    const lines = netlist.split('\n');
+    let hasEnd = false;
+    let hasAnalysis = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i]?.trim() || '';
+        // Skip comments and empty lines
+        if (line.startsWith('*') || line === '') {
+            continue;
+        }
+        // Check for .end
+        if (line.toLowerCase() === '.end') {
+            hasEnd = true;
+        }
+        // Check for analysis
+        if (line.toLowerCase().startsWith('.tran') ||
+            line.toLowerCase().startsWith('.ac') ||
+            line.toLowerCase().startsWith('.dc') ||
+            line.toLowerCase().startsWith('.op')) {
+            hasAnalysis = true;
+        }
+    }
+    if (!hasEnd) {
+        errors.push('Netlist missing .end statement');
+    }
+    if (!hasAnalysis) {
+        errors.push('Netlist missing analysis command (.tran, .ac, .dc, or .op)');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/netlist/generator.js.map

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

package/dist/netlist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Netlist Module Exports
+ */
+export { generateNetlist, getNodeNames, validateNetlist, type NetlistOptions, } from './generator';
+export { sanitizeNodeName, validateIncludePaths, validateIncludePath, sanitizeNetlist, sanitizeValue, validateDesignator, hasShellMetacharacters, SecurityError, } from './sanitizer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/netlist/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACH,eAAe,EACf,YAAY,EACZ,eAAe,EACf,KAAK,cAAc,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,GAChB,MAAM,aAAa,CAAC"}

package/dist/netlist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityError = exports.hasShellMetacharacters = exports.validateDesignator = exports.sanitizeValue = exports.sanitizeNetlist = exports.validateIncludePath = exports.validateIncludePaths = exports.sanitizeNodeName = exports.validateNetlist = exports.getNodeNames = exports.generateNetlist = void 0;
+/**
+ * Netlist Module Exports
+ */
+var generator_1 = require("./generator");
+Object.defineProperty(exports, "generateNetlist", { enumerable: true, get: function () { return generator_1.generateNetlist; } });
+Object.defineProperty(exports, "getNodeNames", { enumerable: true, get: function () { return generator_1.getNodeNames; } });
+Object.defineProperty(exports, "validateNetlist", { enumerable: true, get: function () { return generator_1.validateNetlist; } });
+var sanitizer_1 = require("./sanitizer");
+Object.defineProperty(exports, "sanitizeNodeName", { enumerable: true, get: function () { return sanitizer_1.sanitizeNodeName; } });
+Object.defineProperty(exports, "validateIncludePaths", { enumerable: true, get: function () { return sanitizer_1.validateIncludePaths; } });
+Object.defineProperty(exports, "validateIncludePath", { enumerable: true, get: function () { return sanitizer_1.validateIncludePath; } });
+Object.defineProperty(exports, "sanitizeNetlist", { enumerable: true, get: function () { return sanitizer_1.sanitizeNetlist; } });
+Object.defineProperty(exports, "sanitizeValue", { enumerable: true, get: function () { return sanitizer_1.sanitizeValue; } });
+Object.defineProperty(exports, "validateDesignator", { enumerable: true, get: function () { return sanitizer_1.validateDesignator; } });
+Object.defineProperty(exports, "hasShellMetacharacters", { enumerable: true, get: function () { return sanitizer_1.hasShellMetacharacters; } });
+Object.defineProperty(exports, "SecurityError", { enumerable: true, get: function () { return sanitizer_1.SecurityError; } });
+//# sourceMappingURL=index.js.map

package/dist/netlist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/netlist/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,yCAKqB;AAJjB,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,4GAAA,eAAe,OAAA;AAGnB,yCASqB;AARjB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AACnB,4GAAA,eAAe,OAAA;AACf,0GAAA,aAAa,OAAA;AACb,+GAAA,kBAAkB,OAAA;AAClB,mHAAA,sBAAsB,OAAA;AACtB,0GAAA,aAAa,OAAA"}

package/dist/netlist/sanitizer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Netlist Sanitization Utilities
+ * Security-focused input validation and path sanitization
+ */
+/**
+ * Sanitize a node name for SPICE compatibility
+ * - Removes special characters
+ * - Ensures it doesn't start with a number
+ * - Avoids reserved words
+ */
+export declare function sanitizeNodeName(name: string): string;
+/**
+ * Validate include paths to prevent path traversal attacks
+ * All paths must be relative and within the job directory
+ */
+export declare function validateIncludePaths(paths: string[], jobDir: string): void;
+/**
+ * Validate a single include path
+ */
+export declare function validateIncludePath(includePath: string, _jobDir: string): void;
+/**
+ * Sanitize netlist content for dangerous patterns
+ */
+export declare function sanitizeNetlist(netlist: string, jobDir: string): string;
+/**
+ * Security error class
+ */
+export declare class SecurityError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Sanitize a component value string
+ * Removes potentially dangerous characters while keeping valid SPICE syntax
+ */
+export declare function sanitizeValue(value: string): string;
+/**
+ * Validate a designator format
+ */
+export declare function validateDesignator(designator: string): boolean;
+/**
+ * Check if a string contains shell metacharacters
+ */
+export declare function hasShellMetacharacters(str: string): boolean;
+//# sourceMappingURL=sanitizer.d.ts.map

package/dist/netlist/sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/netlist/sanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBrD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgC9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BvE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK5C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI3D"}

package/dist/netlist/sanitizer.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Netlist Sanitization Utilities
+ * Security-focused input validation and path sanitization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityError = void 0;
+exports.sanitizeNodeName = sanitizeNodeName;
+exports.validateIncludePaths = validateIncludePaths;
+exports.validateIncludePath = validateIncludePath;
+exports.sanitizeNetlist = sanitizeNetlist;
+exports.sanitizeValue = sanitizeValue;
+exports.validateDesignator = validateDesignator;
+exports.hasShellMetacharacters = hasShellMetacharacters;
+/**
+ * Reserved SPICE words that cannot be used as node names
+ */
+const RESERVED_WORDS = new Set([
+    'all',
+    'none',
+    'in',
+    'out',
+    'vcc',
+    'vdd',
+    'vss',
+    'gnd',
+    'ground',
+]);
+/**
+ * Sanitize a node name for SPICE compatibility
+ * - Removes special characters
+ * - Ensures it doesn't start with a number
+ * - Avoids reserved words
+ */
+function sanitizeNodeName(name) {
+    // Remove special characters, keep alphanumeric and underscore
+    let sanitized = name.replace(/[^a-zA-Z0-9_]/g, '_');
+    // Ensure it doesn't start with a number
+    if (/^[0-9]/.test(sanitized)) {
+        sanitized = `n${sanitized}`;
+    }
+    // Prefix if it's a reserved word
+    if (RESERVED_WORDS.has(sanitized.toLowerCase())) {
+        sanitized = `x_${sanitized}`;
+    }
+    // Ensure not empty
+    if (sanitized === '') {
+        sanitized = 'node';
+    }
+    // Prefix with 'n' for clarity
+    if (!sanitized.startsWith('n') && !sanitized.startsWith('x_')) {
+        sanitized = `n${sanitized}`;
+    }
+    return sanitized;
+}
+/**
+ * Validate include paths to prevent path traversal attacks
+ * All paths must be relative and within the job directory
+ */
+function validateIncludePaths(paths, jobDir) {
+    for (const includePath of paths) {
+        validateIncludePath(includePath, jobDir);
+    }
+}
+/**
+ * Validate a single include path
+ */
+function validateIncludePath(includePath, _jobDir) {
+    // Reject absolute paths (Unix or Windows style)
+    if (includePath.startsWith('/') || /^[A-Za-z]:/.test(includePath)) {
+        throw new SecurityError(`Absolute include path not allowed: ${includePath}`, 'ABSOLUTE_PATH');
+    }
+    // Reject path traversal
+    if (includePath.includes('..')) {
+        throw new SecurityError(`Path traversal not allowed: ${includePath}`, 'PATH_TRAVERSAL');
+    }
+    // Reject paths starting with special characters
+    if (includePath.startsWith('~') || includePath.startsWith('$')) {
+        throw new SecurityError(`Special path prefix not allowed: ${includePath}`, 'SPECIAL_PREFIX');
+    }
+    // Validate characters (alphanumeric, underscore, dash, dot, slash)
+    if (!/^[a-zA-Z0-9_\-./]+$/.test(includePath)) {
+        throw new SecurityError(`Invalid characters in include path: ${includePath}`, 'INVALID_CHARS');
+    }
+}
+/**
+ * Sanitize netlist content for dangerous patterns
+ */
+function sanitizeNetlist(netlist, jobDir) {
+    const lines = netlist.split('\n');
+    const sanitized = [];
+    for (const line of lines) {
+        const trimmed = line.trim().toLowerCase();
+        // Validate .include statements
+        if (trimmed.startsWith('.include')) {
+            const match = line.match(/\.include\s+["']?([^"'\s]+)["']?/i);
+            if (match && match[1]) {
+                validateIncludePath(match[1], jobDir);
+            }
+        }
+        // Block potentially dangerous directives
+        if (trimmed.startsWith('.shell') || trimmed.startsWith('.system')) {
+            throw new SecurityError('Shell commands not allowed in netlist', 'SHELL_COMMAND');
+        }
+        sanitized.push(line);
+    }
+    return sanitized.join('\n');
+}
+/**
+ * Security error class
+ */
+class SecurityError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'SecurityError';
+        this.code = code;
+    }
+}
+exports.SecurityError = SecurityError;
+/**
+ * Sanitize a component value string
+ * Removes potentially dangerous characters while keeping valid SPICE syntax
+ */
+function sanitizeValue(value) {
+    // Allow: numbers, letters (for units), spaces, parentheses (for sources), +/-/.
+    const sanitized = value.replace(/[^a-zA-Z0-9\s()+\-.,_]/g, '');
+    return sanitized.trim();
+}
+/**
+ * Validate a designator format
+ */
+function validateDesignator(designator) {
+    // Must start with a letter, followed by alphanumeric, ending with a number
+    return /^[A-Za-z][A-Za-z0-9]*[0-9]+$/.test(designator);
+}
+/**
+ * Check if a string contains shell metacharacters
+ */
+function hasShellMetacharacters(str) {
+    // Characters that could be used for shell injection
+    const shellMeta = /[;&|`$<>\\!#{}[\]*?'"]/;
+    return shellMeta.test(str);
+}
+//# sourceMappingURL=sanitizer.js.map

package/dist/netlist/sanitizer.js.map

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

package/dist/parser/csv-parser.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CSV Parser for ngspice wrdata output
+ * Parses simulation output into structured JSON format
+ */
+import type { SimulationResult } from '../types/simulation';
+/**
+ * Parse ngspice wrdata CSV output to SimulationResult
+ *
+ * wrdata format:
+ * - Whitespace-separated values
+ * - First column is X axis (time, frequency, voltage depending on analysis)
+ * - Subsequent columns are Y values for each probe
+ */
+export declare function parseCsv(csvContent: string, probeNames: string[], analysisType?: string): SimulationResult;
+/**
+ * Parse ngspice raw ASCII format (alternative parser)
+ */
+export declare function parseRawAscii(rawContent: string, analysisType?: string): SimulationResult;
+/**
+ * Detect output format from content
+ */
+export declare function detectOutputFormat(content: string): 'csv' | 'raw' | 'unknown';
+/**
+ * Auto-parse output based on detected format
+ */
+export declare function parseSimulationOutput(content: string, probeNames: string[], analysisType?: string): SimulationResult;
+//# sourceMappingURL=csv-parser.d.ts.map

package/dist/parser/csv-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-parser.d.ts","sourceRoot":"","sources":["../../src/parser/csv-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAqC,MAAM,qBAAqB,CAAC;AAE/F;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACpB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,GAAE,MAAe,GAC9B,gBAAgB,CA6ClB;AAoDD;;GAEG;AACH,wBAAgB,aAAa,CACzB,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAe,GAC9B,gBAAgB,CAqElB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAkB7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,GAAE,MAAe,GAC9B,gBAAgB,CAWlB"}

package/dist/parser/csv-parser.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCsv = parseCsv;
+exports.parseRawAscii = parseRawAscii;
+exports.detectOutputFormat = detectOutputFormat;
+exports.parseSimulationOutput = parseSimulationOutput;
+/**
+ * Parse ngspice wrdata CSV output to SimulationResult
+ *
+ * wrdata format:
+ * - Whitespace-separated values
+ * - First column is X axis (time, frequency, voltage depending on analysis)
+ * - Subsequent columns are Y values for each probe
+ */
+function parseCsv(csvContent, probeNames, analysisType = 'tran') {
+    const lines = csvContent.trim().split('\n');
+    if (lines.length === 0) {
+        return createEmptyResult(analysisType);
+    }
+    // Initialize series for each probe
+    const series = probeNames.map((name) => ({
+        name,
+        points: [],
+    }));
+    // Parse each line.
+    // ngspice `wrdata` (ascii) repeats the scale (x) column BEFORE each vector, so a row
+    // for N probes is laid out as: x y1 x y2 x y3 ...  (2 columns per probe). We detect
+    // that interleaved layout by width and fall back to a single leading x column
+    // (x y1 y2 y3 ...) for other producers.
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === '' || trimmed.startsWith('#') || trimmed.startsWith('*')) {
+            continue; // Skip empty lines and comments
+        }
+        const values = trimmed.split(/\s+/).map(parseFloat);
+        if (values.length < 2) {
+            continue; // Need at least X and one Y value
+        }
+        const interleaved = values.length >= 2 * probeNames.length;
+        for (let i = 0; i < probeNames.length; i++) {
+            const x = interleaved ? values[2 * i] : values[0];
+            const y = interleaved ? values[2 * i + 1] : values[i + 1];
+            if (x !== undefined && y !== undefined && !isNaN(x) && !isNaN(y)) {
+                series[i]?.points.push({ x, y });
+            }
+        }
+    }
+    // Build metadata
+    const meta = buildMeta(analysisType, series);
+    return { meta, series };
+}
+/**
+ * Build result metadata
+ */
+function buildMeta(analysisType, series) {
+    const pointsCount = series[0]?.points.length || 0;
+    let xLabel = 'time';
+    let xUnit = 's';
+    switch (analysisType) {
+        case 'tran':
+            xLabel = 'time';
+            xUnit = 's';
+            break;
+        case 'ac':
+            xLabel = 'frequency';
+            xUnit = 'Hz';
+            break;
+        case 'dc':
+            xLabel = 'voltage';
+            xUnit = 'V';
+            break;
+        case 'op':
+            xLabel = 'point';
+            xUnit = undefined;
+            break;
+    }
+    return {
+        analysisType,
+        xLabel,
+        xUnit,
+        pointsCount,
+    };
+}
+/**
+ * Create an empty result
+ */
+function createEmptyResult(analysisType) {
+    return {
+        meta: {
+            analysisType,
+            xLabel: 'time',
+            pointsCount: 0,
+        },
+        series: [],
+    };
+}
+/**
+ * Parse ngspice raw ASCII format (alternative parser)
+ */
+function parseRawAscii(rawContent, analysisType = 'tran') {
+    const lines = rawContent.split('\n');
+    let inData = false;
+    let variables = [];
+    const dataBlocks = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Parse header
+        if (trimmed.startsWith('No. Variables:')) {
+            // Number of variables
+        }
+        else if (trimmed.startsWith('No. Points:')) {
+            // Parse number of points (for reference, not used directly)
+        }
+        else if (trimmed.startsWith('Variables:')) {
+            inData = false;
+            // Next lines will be variable names
+        }
+        else if (trimmed.match(/^\d+\s+[\w()]+/)) {
+            // Variable definition line: "0 time time"
+            const parts = trimmed.split(/\s+/);
+            if (parts[1]) {
+                variables.push(parts[1]);
+            }
+        }
+        else if (trimmed === 'Values:' || trimmed === 'Binary:') {
+            inData = true;
+        }
+        else if (inData && trimmed !== '') {
+            // Parse data values
+            const values = trimmed.split(/\s+/).map((v) => {
+                // Handle complex numbers (take real part)
+                if (v.includes(',')) {
+                    return parseFloat(v.split(',')[0] || '0');
+                }
+                return parseFloat(v);
+            });
+            if (values.length > 0 && !values.some(isNaN)) {
+                dataBlocks.push(values);
+            }
+        }
+    }
+    // Convert to series format
+    const series = [];
+    if (variables.length > 1 && dataBlocks.length > 0) {
+        // First variable is usually time/frequency
+        for (let i = 1; i < variables.length; i++) {
+            const points = [];
+            for (const block of dataBlocks) {
+                const x = block[0];
+                const y = block[i];
+                if (x !== undefined && y !== undefined) {
+                    points.push({ x, y });
+                }
+            }
+            series.push({
+                name: variables[i] || `var${i}`,
+                points,
+            });
+        }
+    }
+    return {
+        meta: buildMeta(analysisType, series),
+        series,
+    };
+}
+/**
+ * Detect output format from content
+ */
+function detectOutputFormat(content) {
+    const firstLines = content.split('\n').slice(0, 10).join('\n');
+    if (firstLines.includes('Plotname:') || firstLines.includes('No. Variables:')) {
+        return 'raw';
+    }
+    // CSV-like format (just numbers separated by whitespace)
+    const firstDataLine = content.split('\n').find((l) => {
+        const trimmed = l.trim();
+        return trimmed !== '' && !trimmed.startsWith('*') && !trimmed.startsWith('#');
+    });
+    if (firstDataLine && /^[\d.eE+\-\s]+$/.test(firstDataLine.trim())) {
+        return 'csv';
+    }
+    return 'unknown';
+}
+/**
+ * Auto-parse output based on detected format
+ */
+function parseSimulationOutput(content, probeNames, analysisType = 'tran') {
+    const format = detectOutputFormat(content);
+    switch (format) {
+        case 'csv':
+            return parseCsv(content, probeNames, analysisType);
+        case 'raw':
+            return parseRawAscii(content, analysisType);
+        default:
+            throw new Error(`Unknown output format. Content starts with: ${content.substring(0, 100)}`);
+    }
+}
+//# sourceMappingURL=csv-parser.js.map