@intelligentelectron/universal-netlist 0.0.12

package/dist/parsers/altium/net-extractor.js

@@ -0,0 +1,295 @@
+/**
+ * Altium Net Extractor
+ *
+ * Extracts net information from Altium schematics by analyzing
+ * wires, pins, power ports, and net labels.
+ */
+import { RECORD_TYPES } from './types.js';
+import { findAllConnectedComponents } from './connectivity.js';
+import { findRecordByIndex } from './hierarchy.js';
+const COORDINATE_SCALE = 10000;
+const toNumber = (value) => {
+    if (value === undefined || value === null || value === '') {
+        return 0;
+    }
+    const parsed = Number(value);
+    return Number.isNaN(parsed) ? 0 : parsed;
+};
+const scaledCoordinate = (base, frac) => {
+    return Math.round(toNumber(base) * COORDINATE_SCALE + toNumber(frac));
+};
+const pinMatchesCurrentPart = (pin, schematic) => {
+    const ownerIndexValue = pin.OwnerIndex ?? pin.OWNERINDEX;
+    if (ownerIndexValue === undefined || ownerIndexValue === null || ownerIndexValue === '') {
+        return true;
+    }
+    const ownerIndex = parseInt(String(ownerIndexValue), 10);
+    const parent = findRecordByIndex(schematic, ownerIndex);
+    if (!parent) {
+        return true;
+    }
+    const parentPartId = parent.CURRENTPARTID ?? parent.CurrentPartId ?? parent.CurrentPartID;
+    const pinPartId = pin.OwnerPartId ?? pin.OWNERPARTID;
+    if (parentPartId === undefined ||
+        parentPartId === null ||
+        parentPartId === '' ||
+        pinPartId === undefined ||
+        pinPartId === null ||
+        pinPartId === '') {
+        return true;
+    }
+    return String(parentPartId) === String(pinPartId);
+};
+/**
+ * Find all devices that can be part of a net.
+ *
+ * These are: wires (27), pins (2), net labels (25), power ports (17)
+ */
+const findConnectableDevices = (schematic) => {
+    const devices = [];
+    const connectableTypes = new Set([
+        RECORD_TYPES.WIRE,
+        RECORD_TYPES.PIN,
+        RECORD_TYPES.NET_LABEL,
+        RECORD_TYPES.POWER_PORT,
+    ]);
+    const collectDevices = (records) => {
+        for (const record of records) {
+            if (record.RECORD === RECORD_TYPES.PIN && !pinMatchesCurrentPart(record, schematic)) {
+                continue;
+            }
+            if (record.RECORD && connectableTypes.has(record.RECORD)) {
+                devices.push(record);
+            }
+            if (record.children) {
+                collectDevices(record.children);
+            }
+        }
+    };
+    collectDevices(schematic.records);
+    return devices;
+};
+/**
+ * Calculate pin coordinates.
+ *
+ * Pin rotation is encoded in PINCONGLOMERATE (lower 2 bits * 90 degrees).
+ * The endpoint is calculated using: location + rotation * pin_length.
+ * We keep both the pin origin and endpoint so connectivity works at either end.
+ */
+const calculatePinCoordinates = (device) => {
+    const locationX = scaledCoordinate(device['Location.X'] ?? device['LOCATION.X'], device['Location.X_Frac'] ?? device['LOCATION.X_FRAC']);
+    const locationY = scaledCoordinate(device['Location.Y'] ?? device['LOCATION.Y'], device['Location.Y_Frac'] ?? device['LOCATION.Y_FRAC']);
+    const pinLength = scaledCoordinate(device['PinLength'] ?? device['PINLENGTH'], device['PinLength_Frac'] ?? device['PINLENGTH_FRAC']);
+    const pinConglomerate = parseInt(String(device['PinConglomerate'] || device['PINCONGLOMERATE'] || '0'), 10);
+    // Extract rotation from lower 2 bits (0-3 -> 0, 90, 180, 270 degrees)
+    const rotationIndex = pinConglomerate & 0x03;
+    const rotationDegrees = rotationIndex * 90;
+    const rotationRadians = (rotationDegrees / 180) * Math.PI;
+    // Calculate pin endpoint
+    const endX = Math.round(locationX + Math.cos(rotationRadians) * pinLength);
+    const endY = Math.round(locationY + Math.sin(rotationRadians) * pinLength);
+    device.coords = [
+        [locationX, locationY],
+        [endX, endY],
+    ];
+};
+/**
+ * Calculate wire coordinates.
+ *
+ * Wires have coordinates stored as X1,Y1,X2,Y2,... pairs.
+ */
+const calculateWireCoordinates = (device) => {
+    const coords = [];
+    // Pattern: X1, Y1, X2, Y2, etc.
+    const coordPattern = /^X(\d+)$/;
+    // Find all X coordinate keys and extract their indices
+    const indices = [];
+    for (const key of Object.keys(device)) {
+        const match = key.match(coordPattern);
+        if (match) {
+            indices.push(parseInt(match[1], 10));
+        }
+    }
+    // Sort indices and build coordinate array
+    indices.sort((a, b) => a - b);
+    for (const idx of indices) {
+        const x = scaledCoordinate(device[`X${idx}`], device[`X${idx}_Frac`] ?? device[`X${idx}_FRAC`]);
+        const y = scaledCoordinate(device[`Y${idx}`], device[`Y${idx}_Frac`] ?? device[`Y${idx}_FRAC`]);
+        coords.push([x, y]);
+    }
+    device.coords = coords;
+};
+/**
+ * Calculate simple location coordinates.
+ *
+ * Used for power ports, net labels, etc.
+ */
+const calculateSimpleCoordinates = (device) => {
+    const x = scaledCoordinate(device['Location.X'] ?? device['LOCATION.X'], device['Location.X_Frac'] ?? device['LOCATION.X_FRAC']);
+    const y = scaledCoordinate(device['Location.Y'] ?? device['LOCATION.Y'], device['Location.Y_Frac'] ?? device['LOCATION.Y_FRAC']);
+    device.coords = [[x, y]];
+};
+/**
+ * Calculate coordinates for a device.
+ *
+ * Different device types have coordinates stored differently:
+ * - Pins: calculated from location + rotation + pin length
+ * - Wires: multiple X/Y coordinate pairs (X1,Y1,X2,Y2,...)
+ * - Others: simple LOCATION.X and LOCATION.Y
+ */
+const calculateDeviceCoordinates = (device) => {
+    if (device.RECORD === RECORD_TYPES.PIN) {
+        calculatePinCoordinates(device);
+    }
+    else if (device.RECORD === RECORD_TYPES.WIRE) {
+        calculateWireCoordinates(device);
+    }
+    else {
+        calculateSimpleCoordinates(device);
+    }
+};
+const getPinNumber = (device) => {
+    const designator = device.Designator ?? device.DESIGNATOR;
+    if (designator !== undefined && designator !== null && designator !== '') {
+        return String(designator);
+    }
+    const name = device.Name ?? device.NAME;
+    if (name !== undefined && name !== null && name !== '') {
+        return String(name);
+    }
+    return null;
+};
+const getRefdesForPin = (device, schematic) => {
+    const ownerIndexValue = device.OwnerIndex ?? device.OWNERINDEX;
+    if (ownerIndexValue === undefined || ownerIndexValue === null || ownerIndexValue === '') {
+        return null;
+    }
+    const ownerIndex = parseInt(String(ownerIndexValue), 10);
+    const parent = findRecordByIndex(schematic, ownerIndex);
+    if (!parent?.children) {
+        return null;
+    }
+    for (const child of parent.children) {
+        if (child.RECORD !== RECORD_TYPES.DESIGNATOR) {
+            continue;
+        }
+        const textValue = child.Text ?? child.TEXT ?? child.Name ?? child.NAME;
+        if (textValue !== undefined && textValue !== null && textValue !== '') {
+            return String(textValue);
+        }
+    }
+    return null;
+};
+const comparePinNumbers = (a, b) => {
+    const aNum = Number.parseInt(a, 10);
+    const bNum = Number.parseInt(b, 10);
+    if (!Number.isNaN(aNum) && !Number.isNaN(bNum)) {
+        return aNum - bNum;
+    }
+    if (!Number.isNaN(aNum))
+        return -1;
+    if (!Number.isNaN(bNum))
+        return 1;
+    return a.localeCompare(b);
+};
+const collectPinCandidates = (net, schematic) => {
+    const refdesPins = new Map();
+    for (const device of net.devices) {
+        if (device.RECORD !== RECORD_TYPES.PIN) {
+            continue;
+        }
+        const refdes = getRefdesForPin(device, schematic);
+        const pinNumber = getPinNumber(device);
+        if (!refdes || !pinNumber) {
+            continue;
+        }
+        if (!refdesPins.has(refdes)) {
+            refdesPins.set(refdes, []);
+        }
+        const pins = refdesPins.get(refdes);
+        if (!pins.includes(pinNumber)) {
+            pins.push(pinNumber);
+        }
+    }
+    return refdesPins;
+};
+/**
+ * Assign a name to a net.
+ *
+ * Priority:
+ * 1. Power port TEXT value
+ * 2. Net label TEXT value
+ * 3. Pin-derived name (Net<Refdes>_<Pin>) using the lowest refdes/pin in the net
+ */
+const assignNetName = (net, schematic) => {
+    // Try power ports and net labels first
+    for (const device of net.devices) {
+        if ((device.RECORD === RECORD_TYPES.POWER_PORT || device.RECORD === RECORD_TYPES.NET_LABEL) &&
+            (device.Text !== undefined || device.TEXT !== undefined)) {
+            const textValue = device.Text ?? device.TEXT;
+            if (textValue !== undefined && textValue !== null && textValue !== '') {
+                net.name = String(textValue);
+                return;
+            }
+        }
+    }
+    const refdesPins = collectPinCandidates(net, schematic);
+    if (refdesPins.size === 0) {
+        return;
+    }
+    const sortedRefdes = Array.from(refdesPins.keys()).sort((a, b) => a.localeCompare(b));
+    const selectedRefdes = sortedRefdes[0];
+    const pinNumbers = refdesPins.get(selectedRefdes);
+    if (!pinNumbers || pinNumbers.length === 0) {
+        return;
+    }
+    pinNumbers.sort(comparePinNumbers);
+    const selectedPin = pinNumbers[0];
+    net.name = `Net${selectedRefdes}_${selectedPin}`;
+};
+/**
+ * Extract all nets from the schematic.
+ *
+ * This function:
+ * 1. Finds all connectable devices (wires, pins, labels, power ports)
+ * 2. Calculates coordinates for each device
+ * 3. Groups connected devices into nets
+ * 4. Assigns names to nets based on power ports, labels, or pin names
+ */
+export const extractNets = (schematic) => {
+    // Find all connectable devices
+    const devices = findConnectableDevices(schematic);
+    // Calculate coordinates for each device
+    for (const device of devices) {
+        calculateDeviceCoordinates(device);
+    }
+    // Group connected devices into nets using optimized algorithm
+    const components = findAllConnectedComponents(devices);
+    // Convert to AltiumNet objects
+    const nets = [];
+    for (const connectedDevices of components) {
+        // Sort by index for consistency
+        connectedDevices.sort((a, b) => a.index - b.index);
+        const net = {
+            name: null,
+            devices: connectedDevices,
+        };
+        nets.push(net);
+    }
+    // Assign names to nets
+    for (const net of nets) {
+        assignNetName(net, schematic);
+    }
+    return nets;
+};
+/**
+ * Get net list with schematic (for compatibility with Python API).
+ */
+export const determineNetList = (schematic) => {
+    const nets = extractNets(schematic);
+    return {
+        ...schematic,
+        nets,
+    };
+};
+//# sourceMappingURL=net-extractor.js.map

package/dist/parsers/altium/net-extractor.js.map

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

package/dist/parsers/altium/ole-reader.d.ts

@@ -0,0 +1,91 @@
+/**
+ * OLE/CFB File Reader
+ *
+ * Custom implementation of Microsoft Compound File Binary (CFB) format parser.
+ * Based on MS-CFB specification:
+ * https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-cfb/
+ *
+ * Only implements the subset needed to read streams from Altium .SchDoc files.
+ */
+/**
+ * OLE/CFB file reader class
+ *
+ * Reads Microsoft Compound File Binary format files.
+ */
+export declare class OleReader {
+    private buffer;
+    private header;
+    private fat;
+    private miniFat;
+    private directories;
+    private miniStream;
+    /**
+     * Create a new OleReader instance for reading OLE compound files.
+     */
+    constructor(filePath: string);
+    /**
+     * Read a named stream from the OLE file.
+     */
+    readStream(name: string): Buffer;
+    /**
+     * List all stream names in the file.
+     */
+    listStreams(): string[];
+    /**
+     * Validate the OLE magic signature.
+     */
+    private validateMagic;
+    /**
+     * Parse the 512-byte header.
+     */
+    private parseHeader;
+    /**
+     * Build the complete FAT by reading all FAT sectors.
+     */
+    private buildFat;
+    /**
+     * Build the mini FAT.
+     */
+    private buildMiniFat;
+    /**
+     * Read the mini stream from the root entry.
+     */
+    private readMiniStream;
+    /**
+     * Read all directory entries.
+     */
+    private readDirectories;
+    /**
+     * Parse a single 128-byte directory entry.
+     */
+    private parseDirectoryEntry;
+    /**
+     * Find a directory entry by name.
+     */
+    private findDirectoryEntry;
+    /**
+     * Read stream data from a directory entry.
+     */
+    private readStreamData;
+    /**
+     * Read a regular stream (>= 4096 bytes).
+     */
+    private readRegularStream;
+    /**
+     * Read from mini stream (< 4096 bytes).
+     */
+    private readMiniStreamData;
+    /**
+     * Read a sector by its index.
+     */
+    private readSector;
+    /**
+     * Get the chain of sectors for a stream.
+     */
+    private getSectorChain;
+}
+/**
+ * Read a stream from an OLE file.
+ */
+export declare const readOleStream: (filePath: string, streamName?: string) => Buffer;
+//# sourceMappingURL=ole-reader.d.ts.map

package/dist/parsers/altium/ole-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ole-reader.d.ts","sourceRoot":"","sources":["../../../src/parsers/altium/ole-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,UAAU,CAAS;IAE3B;;OAEG;gBACS,QAAQ,EAAE,MAAM;IAU5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQhC;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,WAAW;IA4DnB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoChB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;OAEG;IACH,OAAO,CAAC,cAAc;CAqBvB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,mBAAyB,KAAG,MAG3E,CAAC"}