@isopodlabs/binary_libs 1.1.1 → 1.2.1

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Adrian Stephens
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,134 +1,137 @@
-# Binary Libs
-
-This package provides readers for various library formats, using the @isopodlabs/binary binary file loading library
-
-## ☕ Support My Work  
-If you use this package, consider [buying me a tea](https://coff.ee/adrianstephens) to support future updates!  
-
-## Supported File Types
-
-### elf
-ELF
-```typescript
-class ELFFile {
-    static check(data: Uint8Array): boolean;
-    segments: [string, Segment][];
-    sections: [string, Section][];
-    header: Header;
-    getSymbols(): [string, Symbol][];
-    getDynamicSymbols(): [string, Symbol][];
-    getSegmentByType(type: string): Segment | undefined;
-    getSectionByType(type: string): Section | undefined;
-}
-```
-
-### pe
-Portable Executable
-```typescript
-class PE {
-    static check(data: Uint8Array): boolean;
-    header: Header;
-    opt?:   OptHeader;
-    sections: Section[];
-    get directories(): {
-        [k: string]: any;
-    } | undefined;
-    FindSectionRVA(rva: number): Section | undefined;
-    FindSectionRaw(addr: number): Section | undefined;
-    GetDataRVA(rva: number, size?: number): binary.utils.MappedMemory | undefined;
-    GetDataRaw(addr: number, size: number): Uint8Array | undefined;
-    GetDataDir(dir: { VirtualAddress: number; Size: number; } & {}): binary.utils.MappedMemory | undefined;
-    ReadDirectory(name: string): any;
-}
-```
-
-### clr
-Common Language Runtime (embedded in pe files)
-```typescript
-class CLR {
-    header: Header;
-    table_info: TableInfo;
-    heaps: Uint8Array[];
-    tables: Record<TABLE, Table>;
-    Resources?: Uint8Array;
-    getEntry(t: TABLE, i: number): any;
-    getTable(t: TABLE): any;
-    getResources(block: string): Record<string, any> | undefined;
-    getResource(block: string, name: string): any;
-    allResources(): any;
-}
-```
-### mach
-Apple libraries
-```typescript
-interface Segment {
-    data: binary.utils.MappedMemory | undefined;
-    segname: string;
-    vmaddr: number | bigint;
-    vmsize: number | bigint;
-    fileoff: number | bigint;
-    filesize: number | bigint;
-    maxprot: number;
-    initprot: number;
-    nsects: number;
-    flags: Record<string, bigint | boolean> | Record<string, number | boolean>;
-    sections: Record<string, any> | undefined;
-};
-class MachFile {
-    static check(data: Uint8Array): boolean;
-    header: Header;
-    commands: { cmd: CMD; data: any; }[];
-    constructor(data: Uint8Array, mem?: binary.utils.memory);
-    getCommand(cmd: CMD): any;
-    getSegment(name: string): Segment;
-}
-class FATMachFile {
-    archs:  {
-        cputype: string;
-        cpusubtype: string | number;
-        offset: number;
-        size: number;
-        align: number;
-        contents: MachFile | undefined;
-    }[];
-    static check(data: Uint8Array): boolean;
-    constructor(data: Uint8Array, mem?: binary.utils.memory);
-    load(file: binary.stream_endian, mem?: binary.utils.memory): void;
-}
-```
-
-### arch
-Archive files for static linking
-
-```typescript
-declare class ArchFile {
-    static check(data: Uint8Array): boolean;
-    members: {
-        name: string;
-        date: number;
-        uid: number;
-        gid: number;
-        mode: number;
-        size: number;
-        fmag: string;
-        contents: any;
-    }[];
-    constructor(data: Uint8Array);
-}
-```
-
-### CompoundDocument
-Not a library format at all, but useful for loading some related files
-```typescript
-class Reader {
-    entries: DirEntry[];
-    private entry_chain;
-    constructor(sectors: Uint8Array, header: Header);
-    find(name: string, i?: number): DirEntry | undefined;
-    read(e: DirEntry): Uint8Array;
-    write(e: DirEntry, data: Uint8Array): void;
-}
-```
-## License
-
+# Binary Libs
+[![npm version](https://img.shields.io/npm/v/@isopodlabs/binary_libs.svg)](https://www.npmjs.com/package/@isopodlabs/binary_libs)
+[![GitHub stars](https://img.shields.io/github/stars/adrianstephens/binary_libs.svg?style=social)](https://github.com/adrianstephens/binary_libs)
+[![License](https://img.shields.io/npm/l/@isopodlabs/binary_libs.svg)](LICENSE.txt)
+
+This package provides readers for various library formats, using the @isopodlabs/binary binary file loading library
+
+## ☕ Support My Work  
+If you use this package, consider [buying me a cup of tea](https://coff.ee/adrianstephens) to support future updates!  
+
+## Supported File Types
+
+### elf
+ELF
+```typescript
+class ELFFile {
+    static check(data: Uint8Array): boolean;
+    segments: [string, Segment][];
+    sections: [string, Section][];
+    header: Header;
+    getSymbols(): [string, Symbol][];
+    getDynamicSymbols(): [string, Symbol][];
+    getSegmentByType(type: string): Segment | undefined;
+    getSectionByType(type: string): Section | undefined;
+}
+```
+
+### pe
+Portable Executable
+```typescript
+class PE {
+    static check(data: Uint8Array): boolean;
+    header: Header;
+    opt?:   OptHeader;
+    sections: Section[];
+    get directories(): {
+        [k: string]: any;
+    } | undefined;
+    FindSectionRVA(rva: number): Section | undefined;
+    FindSectionRaw(addr: number): Section | undefined;
+    GetDataRVA(rva: number, size?: number): binary.utils.MappedMemory | undefined;
+    GetDataRaw(addr: number, size: number): Uint8Array | undefined;
+    GetDataDir(dir: { VirtualAddress: number; Size: number; } & {}): binary.utils.MappedMemory | undefined;
+    ReadDirectory(name: string): any;
+}
+```
+
+### clr
+Common Language Runtime (embedded in pe files)
+```typescript
+class CLR {
+    header: Header;
+    table_info: TableInfo;
+    heaps: Uint8Array[];
+    tables: Record<TABLE, Table>;
+    Resources?: Uint8Array;
+    getEntry(t: TABLE, i: number): any;
+    getTable(t: TABLE): any;
+    getResources(block: string): Record<string, any> | undefined;
+    getResource(block: string, name: string): any;
+    allResources(): any;
+}
+```
+### mach
+Apple libraries
+```typescript
+interface Segment {
+    data: binary.utils.MappedMemory | undefined;
+    segname: string;
+    vmaddr: number | bigint;
+    vmsize: number | bigint;
+    fileoff: number | bigint;
+    filesize: number | bigint;
+    maxprot: number;
+    initprot: number;
+    nsects: number;
+    flags: Record<string, bigint | boolean> | Record<string, number | boolean>;
+    sections: Record<string, any> | undefined;
+};
+class MachFile {
+    static check(data: Uint8Array): boolean;
+    header: Header;
+    commands: { cmd: CMD; data: any; }[];
+    constructor(data: Uint8Array, mem?: binary.utils.memory);
+    getCommand(cmd: CMD): any;
+    getSegment(name: string): Segment;
+}
+class FATMachFile {
+    archs:  {
+        cputype: string;
+        cpusubtype: string | number;
+        offset: number;
+        size: number;
+        align: number;
+        contents: MachFile | undefined;
+    }[];
+    static check(data: Uint8Array): boolean;
+    constructor(data: Uint8Array, mem?: binary.utils.memory);
+    load(file: binary.stream_endian, mem?: binary.utils.memory): void;
+}
+```
+
+### arch
+Archive files for static linking
+
+```typescript
+declare class ArchFile {
+    static check(data: Uint8Array): boolean;
+    members: {
+        name: string;
+        date: number;
+        uid: number;
+        gid: number;
+        mode: number;
+        size: number;
+        fmag: string;
+        contents: any;
+    }[];
+    constructor(data: Uint8Array);
+}
+```
+
+### CompoundDocument
+Not a library format at all, but useful for loading some related files
+```typescript
+class Reader {
+    entries: DirEntry[];
+    private entry_chain;
+    constructor(sectors: Uint8Array, header: Header);
+    find(name: string, i?: number): DirEntry | undefined;
+    read(e: DirEntry): Uint8Array;
+    write(e: DirEntry, data: Uint8Array): void;
+}
+```
+## License
+
 This project is licensed under the MIT License. See the LICENSE file for more details.

package/dist/CompoundDocument.js

@@ -148,7 +148,7 @@ const COLOUR = {
     RED: 0, BLACK: 1
 };
 class DirEntry extends binary.Class({
-    name: binary.StringType(64, 'utf16le'),
+    name: binary.StringType(32, 'utf16le'),
     name_size: binary.UINT16_LE,
     type: binary.UINT8,
     colour: binary.UINT8,
@@ -298,3 +298,4 @@ class Reader extends Master {
     }
 }
 exports.Reader = Reader;
+//# sourceMappingURL=CompoundDocument.js.map

package/dist/arch.js

@@ -52,7 +52,9 @@ class ArchFile {
         const header = binary.read(s, binary.StringType(8));
         if (header !== '!<arch>\n')
             throw new Error('Invalid archive file format');
+        const nullTerminatedString = binary.NullTerminatedStringType();
         let long_names;
+        let blanks = 0;
         while (s.remaining() > 0) {
             const member = binary.read(s, _HEADER);
             const data = s.read_buffer(member.size);
@@ -67,16 +69,31 @@ class ArchFile {
             }
             if (member.name == '') {
                 const s2 = new binary.stream(data);
-                const offsets = binary.ArrayType(binary.INT32_BE, binary.INT32_BE).get(s2);
-                member.name = 'Symbols';
-                member.contents = offsets.map(offset => [
-                    binary.NullTerminatedStringType().get(s2),
-                    offset
-                ]);
+                switch (++blanks) {
+                    case 1: {
+                        const offsets = binary.ArrayType(binary.INT32_BE, binary.INT32_BE).get(s2);
+                        member.name = 'Symbols';
+                        member.contents = offsets.map(offset => [
+                            nullTerminatedString.get(s2),
+                            offset
+                        ]);
+                        break;
+                    }
+                    case 2: { // microsoft symbols
+                        const member_offsets = binary.ArrayType(binary.INT32_LE, binary.INT32_LE).get(s2);
+                        const indices = binary.ArrayType(binary.INT32_LE, binary.INT16_LE).get(s2);
+                        member.name = 'Symbols2';
+                        member.contents = indices.map(i => [
+                            nullTerminatedString.get(s2),
+                            i
+                        ]);
+                        break;
+                    }
+                }
             }
             else if (member.name == '/SYM') {
                 const s2 = new binary.stream(data);
-                const syms = binary.ArrayType(binary.INT32_BE, binary.NullTerminatedStringType()).get(s2);
+                const syms = binary.ArrayType(binary.INT32_BE, nullTerminatedString).get(s2);
                 member.contents = syms.map(name => ({
                     name,
                     offset: binary.INT32_BE.get(s2)
@@ -94,3 +111,4 @@ class ArchFile {
     }
 }
 exports.ArchFile = ArchFile;
+//# sourceMappingURL=arch.js.map

package/dist/clr.js

@@ -604,3 +604,4 @@ pe.DIRECTORIES.CLR_DESCRIPTOR.read = (pe, data) => {
     const clr = new CLR(pe, data.data);
     return Object.fromEntries(Object.entries(clr.tables).map(([k, v]) => [TABLE[+k], fix_names(clr.getTable(+k))]));
 };
+//# sourceMappingURL=clr.js.map

package/dist/cvinfo.d.ts

@@ -0,0 +1,26 @@
+import * as binary from '@isopodlabs/binary';
+declare const Decimal_base: (new (s: binary._stream) => {
+    reserved: number;
+    scale: number;
+    sign: number;
+    mhi: number;
+    mlo: bigint;
+} & {
+    write(w: binary._stream): void;
+}) & {
+    get: <X extends abstract new (...args: any) => any>(this: X, s: binary._stream) => InstanceType<X>;
+    put: (s: binary._stream, v: any) => void;
+};
+export declare class Decimal extends Decimal_base {
+    toNumber(): number;
+}
+export declare const CV_MMASK = 1792;
+export declare const CV_TMASK = 240;
+export declare const CV_SMASK = 15;
+export declare const CV_MSHIFT = 8;
+export declare const CV_TSHIFT = 4;
+export declare const CV_SSHIFT = 0;
+export declare function CV_MODE(typ: number): number;
+export declare function CV_TYPE(typ: number): number;
+export declare function CV_SUBT(typ: number): number;
+export {};