@intelligentelectron/universal-netlist 0.0.12

package/dist/parsers/altium/ole-reader.js

@@ -0,0 +1,304 @@
+/**
+ * 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.
+ */
+import { readFileSync } from 'fs';
+// OLE magic signature: D0 CF 11 E0 A1 B1 1A E1
+const OLE_MAGIC = Buffer.from([0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1]);
+// Header size is always 512 bytes
+const HEADER_SIZE = 512;
+// Directory entry size is always 128 bytes
+const DIR_ENTRY_SIZE = 128;
+// Special sector values
+const ENDOFCHAIN = 0xfffffffe;
+const FREESECT = 0xffffffff;
+const FATSECT = 0xfffffffd;
+const DIFSECT = 0xfffffffc;
+/**
+ * OLE/CFB file reader class
+ *
+ * Reads Microsoft Compound File Binary format files.
+ */
+export class OleReader {
+    buffer;
+    header;
+    fat;
+    miniFat;
+    directories;
+    miniStream;
+    /**
+     * Create a new OleReader instance for reading OLE compound files.
+     */
+    constructor(filePath) {
+        this.buffer = readFileSync(filePath);
+        this.validateMagic();
+        this.header = this.parseHeader();
+        this.fat = this.buildFat();
+        this.directories = this.readDirectories();
+        this.miniFat = this.buildMiniFat();
+        this.miniStream = this.readMiniStream();
+    }
+    /**
+     * Read a named stream from the OLE file.
+     */
+    readStream(name) {
+        const entry = this.findDirectoryEntry(name);
+        if (!entry) {
+            throw new Error(`Stream "${name}" not found in OLE file`);
+        }
+        return this.readStreamData(entry);
+    }
+    /**
+     * List all stream names in the file.
+     */
+    listStreams() {
+        return this.directories.filter((d) => d.type === 2).map((d) => d.name);
+    }
+    /**
+     * Validate the OLE magic signature.
+     */
+    validateMagic() {
+        const signature = this.buffer.subarray(0, 8);
+        if (!signature.equals(OLE_MAGIC)) {
+            throw new Error('Invalid OLE file: magic signature mismatch');
+        }
+    }
+    /**
+     * Parse the 512-byte header.
+     */
+    parseHeader() {
+        // Minor version at offset 24 (2 bytes) - not used
+        // Major version at offset 26 (2 bytes)
+        const majorVersion = this.buffer.readUInt16LE(26);
+        // Byte order at offset 28 should be 0xFFFE (little-endian)
+        const byteOrder = this.buffer.readUInt16LE(28);
+        if (byteOrder !== 0xfffe) {
+            throw new Error('Invalid OLE file: unexpected byte order');
+        }
+        // Sector size power at offset 30 (2 bytes)
+        const sectorSizePower = this.buffer.readUInt16LE(30);
+        const sectorSize = 1 << sectorSizePower;
+        // Mini sector size power at offset 32 (2 bytes)
+        const miniSectorSizePower = this.buffer.readUInt16LE(32);
+        const miniSectorSize = 1 << miniSectorSizePower;
+        // Mini stream cutoff at offset 56 (4 bytes)
+        const miniStreamCutoff = this.buffer.readUInt32LE(56);
+        // First directory sector at offset 48 (4 bytes)
+        const dirStartSector = this.buffer.readUInt32LE(48);
+        // First mini FAT sector at offset 60 (4 bytes)
+        const miniFatStartSector = this.buffer.readUInt32LE(60);
+        // Number of mini FAT sectors at offset 64 (4 bytes)
+        const numMiniFatSectors = this.buffer.readUInt32LE(64);
+        // First DIFAT sector at offset 68 (4 bytes)
+        const difatStartSector = this.buffer.readUInt32LE(68);
+        // Number of DIFAT sectors at offset 72 (4 bytes)
+        const numDifatSectors = this.buffer.readUInt32LE(72);
+        // FAT sector locations at offset 76 (109 entries * 4 bytes = 436 bytes)
+        const fatSectors = [];
+        for (let i = 0; i < 109; i++) {
+            const sector = this.buffer.readUInt32LE(76 + i * 4);
+            if (sector !== FREESECT) {
+                fatSectors.push(sector);
+            }
+        }
+        return {
+            majorVersion,
+            sectorSize,
+            miniSectorSize,
+            miniStreamCutoff,
+            dirStartSector,
+            miniFatStartSector,
+            numMiniFatSectors,
+            difatStartSector,
+            numDifatSectors,
+            fatSectors,
+        };
+    }
+    /**
+     * Build the complete FAT by reading all FAT sectors.
+     */
+    buildFat() {
+        const fat = [];
+        const entriesPerSector = this.header.sectorSize / 4;
+        // Read FAT sectors from header DIFAT
+        for (const sectorNum of this.header.fatSectors) {
+            const sectorData = this.readSector(sectorNum);
+            for (let i = 0; i < entriesPerSector; i++) {
+                fat.push(sectorData.readUInt32LE(i * 4));
+            }
+        }
+        // If there are additional DIFAT sectors, read them too
+        if (this.header.numDifatSectors > 0) {
+            let difatSector = this.header.difatStartSector;
+            for (let d = 0; d < this.header.numDifatSectors; d++) {
+                const difatData = this.readSector(difatSector);
+                // Each DIFAT sector has (sectorSize/4 - 1) FAT sector references
+                // and the last entry points to the next DIFAT sector
+                for (let i = 0; i < entriesPerSector - 1; i++) {
+                    const fatSectorNum = difatData.readUInt32LE(i * 4);
+                    if (fatSectorNum !== FREESECT) {
+                        const sectorData = this.readSector(fatSectorNum);
+                        for (let j = 0; j < entriesPerSector; j++) {
+                            fat.push(sectorData.readUInt32LE(j * 4));
+                        }
+                    }
+                }
+                // Next DIFAT sector
+                difatSector = difatData.readUInt32LE((entriesPerSector - 1) * 4);
+            }
+        }
+        return fat;
+    }
+    /**
+     * Build the mini FAT.
+     */
+    buildMiniFat() {
+        const miniFat = [];
+        if (this.header.miniFatStartSector === ENDOFCHAIN) {
+            return miniFat;
+        }
+        const entriesPerSector = this.header.sectorSize / 4;
+        const sectorChain = this.getSectorChain(this.header.miniFatStartSector);
+        for (const sectorNum of sectorChain) {
+            const sectorData = this.readSector(sectorNum);
+            for (let i = 0; i < entriesPerSector; i++) {
+                miniFat.push(sectorData.readUInt32LE(i * 4));
+            }
+        }
+        return miniFat;
+    }
+    /**
+     * Read the mini stream from the root entry.
+     */
+    readMiniStream() {
+        const rootEntry = this.directories[0];
+        if (!rootEntry || rootEntry.size === 0) {
+            return Buffer.alloc(0);
+        }
+        // Mini stream is stored as a regular stream in the root entry
+        return this.readRegularStream(rootEntry.startSector, rootEntry.size);
+    }
+    /**
+     * Read all directory entries.
+     */
+    readDirectories() {
+        const directories = [];
+        const entriesPerSector = this.header.sectorSize / DIR_ENTRY_SIZE;
+        const sectorChain = this.getSectorChain(this.header.dirStartSector);
+        for (const sectorNum of sectorChain) {
+            const sectorData = this.readSector(sectorNum);
+            for (let i = 0; i < entriesPerSector; i++) {
+                const entryOffset = i * DIR_ENTRY_SIZE;
+                const entry = this.parseDirectoryEntry(sectorData.subarray(entryOffset, entryOffset + DIR_ENTRY_SIZE));
+                if (entry.type !== 0) {
+                    directories.push(entry);
+                }
+            }
+        }
+        return directories;
+    }
+    /**
+     * Parse a single 128-byte directory entry.
+     */
+    parseDirectoryEntry(data) {
+        // Name is UTF-16LE, up to 64 bytes (32 chars), null-terminated
+        const nameLength = data.readUInt16LE(64);
+        const nameBytes = nameLength > 2 ? nameLength - 2 : 0;
+        const name = data.subarray(0, nameBytes).toString('utf16le');
+        // Entry type at offset 66 (1 byte)
+        const type = data.readUInt8(66);
+        // Starting sector at offset 116 (4 bytes)
+        const startSector = data.readUInt32LE(116);
+        // Size at offset 120 (8 bytes for v4, 4 bytes for v3)
+        // For v3, only first 4 bytes are used
+        const size = data.readUInt32LE(120);
+        return { name, type, startSector, size };
+    }
+    /**
+     * Find a directory entry by name.
+     */
+    findDirectoryEntry(name) {
+        return this.directories.find((d) => d.name.toLowerCase() === name.toLowerCase() && d.type === 2);
+    }
+    /**
+     * Read stream data from a directory entry.
+     */
+    readStreamData(entry) {
+        if (entry.size < this.header.miniStreamCutoff) {
+            return this.readMiniStreamData(entry.startSector, entry.size);
+        }
+        return this.readRegularStream(entry.startSector, entry.size);
+    }
+    /**
+     * Read a regular stream (>= 4096 bytes).
+     */
+    readRegularStream(startSector, size) {
+        const result = Buffer.alloc(size);
+        let offset = 0;
+        let sector = startSector;
+        while (sector !== ENDOFCHAIN && offset < size) {
+            const sectorData = this.readSector(sector);
+            const bytesToCopy = Math.min(this.header.sectorSize, size - offset);
+            sectorData.copy(result, offset, 0, bytesToCopy);
+            offset += bytesToCopy;
+            sector = this.fat[sector];
+        }
+        return result;
+    }
+    /**
+     * Read from mini stream (< 4096 bytes).
+     */
+    readMiniStreamData(startSector, size) {
+        const result = Buffer.alloc(size);
+        let offset = 0;
+        let sector = startSector;
+        while (sector !== ENDOFCHAIN && offset < size) {
+            const miniOffset = sector * this.header.miniSectorSize;
+            const bytesToCopy = Math.min(this.header.miniSectorSize, size - offset);
+            this.miniStream.copy(result, offset, miniOffset, miniOffset + bytesToCopy);
+            offset += bytesToCopy;
+            sector = this.miniFat[sector];
+        }
+        return result;
+    }
+    /**
+     * Read a sector by its index.
+     */
+    readSector(sectorNum) {
+        // Sectors start after the 512-byte header
+        const offset = HEADER_SIZE + sectorNum * this.header.sectorSize;
+        return this.buffer.subarray(offset, offset + this.header.sectorSize);
+    }
+    /**
+     * Get the chain of sectors for a stream.
+     */
+    getSectorChain(startSector) {
+        const chain = [];
+        let sector = startSector;
+        while (sector !== ENDOFCHAIN &&
+            sector !== FREESECT &&
+            sector !== FATSECT &&
+            sector !== DIFSECT) {
+            chain.push(sector);
+            sector = this.fat[sector];
+            // Safety check to prevent infinite loops
+            if (chain.length > 1000000) {
+                throw new Error('Sector chain too long, possible corruption');
+            }
+        }
+        return chain;
+    }
+}
+/**
+ * Read a stream from an OLE file.
+ */
+export const readOleStream = (filePath, streamName = 'FileHeader') => {
+    const ole = new OleReader(filePath);
+    return ole.readStream(streamName);
+};
+//# sourceMappingURL=ole-reader.js.map

package/dist/parsers/altium/ole-reader.js.map

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

package/dist/parsers/altium/record-parser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Altium Record Parser
+ *
+ * Parses the binary FileHeader stream from Altium .SchDoc files
+ * into structured record objects.
+ *
+ * Based on the Python Altium-Schematic-Parser library parsing logic.
+ */
+import type { AltiumRecord, AltiumSchematic } from './types.js';
+/**
+ * Parse the FileHeader stream buffer into an AltiumSchematic structure.
+ *
+ * The stream format uses a 5-byte delimiter pattern: XXX\x00\x00|
+ * where XXX are 3 arbitrary bytes (length indicator).
+ */
+export declare const parseRecords: (buffer: Buffer) => AltiumSchematic;
+/**
+ * Find all records matching a key-value pair.
+ */
+export declare const findRecords: (schematic: AltiumSchematic, key: string, value: string) => AltiumRecord[];
+//# sourceMappingURL=record-parser.d.ts.map

package/dist/parsers/altium/record-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-parser.d.ts","sourceRoot":"","sources":["../../../src/parsers/altium/record-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAwEhE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,eA2B7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,eAAe,EAC1B,KAAK,MAAM,EACX,OAAO,MAAM,KACZ,YAAY,EAmBd,CAAC"}

package/dist/parsers/altium/record-parser.js

@@ -0,0 +1,117 @@
+/**
+ * Altium Record Parser
+ *
+ * Parses the binary FileHeader stream from Altium .SchDoc files
+ * into structured record objects.
+ *
+ * Based on the Python Altium-Schematic-Parser library parsing logic.
+ */
+/**
+ * Split buffer by the 5-byte delimiter pattern.
+ *
+ * The pattern is: XXX\x00\x00| where XXX are any 3 bytes
+ * We look for the \x00\x00| sequence and include the 3 bytes before it
+ */
+const splitByDelimiter = (buffer) => {
+    const segments = [];
+    let start = 0;
+    for (let i = 0; i < buffer.length - 2; i++) {
+        // Look for \x00\x00|
+        if (buffer[i] === 0x00 &&
+            buffer[i + 1] === 0x00 &&
+            buffer[i + 2] === 0x7c // '|'
+        ) {
+            // The delimiter includes 3 bytes before \x00\x00|
+            // So we capture up to i-3 (or start if we're at the beginning)
+            const delimiterStart = Math.max(start, i - 3);
+            if (delimiterStart > start) {
+                segments.push(buffer.subarray(start, delimiterStart));
+            }
+            // Skip past the delimiter (3 bytes + \x00\x00|)
+            start = i + 3;
+            i = start - 1; // Will be incremented by loop
+        }
+    }
+    // Add the last segment
+    if (start < buffer.length) {
+        segments.push(buffer.subarray(start));
+    }
+    return segments;
+};
+/**
+ * Parse a single segment into a record object.
+ *
+ * Format: KEY=VALUE|KEY=VALUE|...
+ */
+const parseSegment = (segment, index) => {
+    const record = { index };
+    // Convert to string, handling potential encoding issues
+    const str = segment.toString('utf-8');
+    // Split by pipe character
+    const pairs = str.split('|');
+    for (const pair of pairs) {
+        if (!pair)
+            continue;
+        // Split by first equals sign only (value may contain '=')
+        const eqIndex = pair.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = pair.substring(0, eqIndex).trim();
+        const value = pair.substring(eqIndex + 1);
+        if (key) {
+            // Store with original key casing
+            record[key] = value;
+        }
+    }
+    return record;
+};
+/**
+ * Parse the FileHeader stream buffer into an AltiumSchematic structure.
+ *
+ * The stream format uses a 5-byte delimiter pattern: XXX\x00\x00|
+ * where XXX are 3 arbitrary bytes (length indicator).
+ */
+export const parseRecords = (buffer) => {
+    // Skip first 5 bytes and last byte (as per Python implementation)
+    const trimmedBuffer = buffer.subarray(5, buffer.length - 1);
+    // Split by the delimiter pattern: .{3}\x00\x00|
+    // This pattern is: 3 bytes (length) + 2 null bytes + pipe
+    const segments = splitByDelimiter(trimmedBuffer);
+    // Parse each segment into a record
+    const datums = [];
+    for (let i = 0; i < segments.length; i++) {
+        const segment = segments[i];
+        if (segment.length === 0)
+            continue;
+        const record = parseSegment(segment, i);
+        if (Object.keys(record).length > 1) {
+            // Has more than just index
+            datums.push(record);
+        }
+    }
+    // Separate header records from other records
+    const header = datums.filter((d) => 'HEADER' in d);
+    const records = datums.filter((d) => 'RECORD' in d);
+    return { header, records };
+};
+/**
+ * Find all records matching a key-value pair.
+ */
+export const findRecords = (schematic, key, value) => {
+    const found = [];
+    const searchRecord = (record) => {
+        if (record[key] === value) {
+            found.push(record);
+        }
+        if (record.children) {
+            for (const child of record.children) {
+                searchRecord(child);
+            }
+        }
+    };
+    for (const record of schematic.records) {
+        searchRecord(record);
+    }
+    return found;
+};
+//# sourceMappingURL=record-parser.js.map

package/dist/parsers/altium/record-parser.js.map

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