psyq-asm 0.0.1

package/dist/public-types.d.ts

@@ -0,0 +1,253 @@
+/**
+ * The public type surface. Type-only: no runtime code lives here, which is why
+ * the module is excluded from coverage (see CONTRIBUTING.md).
+ */
+import type { TableMnemonic } from './isa/table.js';
+/** ASPSX versions this package emulates. */
+export type AspsxVersion = '2.81';
+/** Discriminant of every error thrown by psyq-asm. */
+export type ErrorCode = 'invalid-options' | 'invalid-instruction';
+/**
+ * Behaviour switches that the differential oracle has not yet settled. Each
+ * defaults to the value believed correct; overriding them is for fixture
+ * experiments and is not covered by semver.
+ */
+export interface ExperimentalBehaviours {
+    /**
+     * Treat `.extern sym,size` with `size <= gpSize` as small data, addressed
+     * through `$gp`. Default false, which is what ASPSX 2.81 does: it addresses
+     * external symbols with `lui`/`%lo` whatever their declared size.
+     */
+    readonly externSmallData: boolean;
+    /**
+     * Insert a nop after `mfc2`/`cfc2` when the next instruction reads the
+     * register just written. Default true, which is what ASPSX 2.81 does.
+     */
+    readonly copMoveDelayNop: boolean;
+}
+export interface AssembleOptions {
+    /**
+     * The small-data threshold, the -G value given to ASPSX. A non-negative
+     * integer; PsyQ builds use 0 or 8. Required; never guessed.
+     */
+    readonly gpSize: number;
+    /** Emulated assembler version. Only '2.81' is accepted. Default '2.81'. */
+    readonly aspsxVersion?: AspsxVersion;
+    /** Reproduce `ASPSX -0`: `div`/`rem` without divide-by-zero and overflow traps. Default false. */
+    readonly partialDivExpansion?: boolean;
+    /** Logical file name used in diagnostics. A single path segment. Default 'input.s'. */
+    readonly filename?: string;
+    /** Overrides for unsettled behaviours; see `ExperimentalBehaviours`. */
+    readonly experimental?: Partial<ExperimentalBehaviours>;
+}
+export type AssembleResult = AssembleSuccess | AssembleFailure;
+export interface AssembleSuccess {
+    readonly success: true;
+    readonly object: AssembledObject;
+    /** Warnings only. */
+    readonly diagnostics: readonly Diagnostic[];
+}
+export interface AssembleFailure {
+    readonly success: false;
+    /** At least one error, sorted by line. */
+    readonly diagnostics: readonly Diagnostic[];
+}
+export type DiagnosticCode = 'unknown-mnemonic' | 'unknown-directive' | 'unsupported-syntax' | 'invalid-operand' | 'invalid-directive' | 'undefined-label' | 'duplicate-label' | 'immediate-out-of-range' | 'branch-out-of-range' | 'ignored-directive' | 'function-mismatch';
+export interface Diagnostic {
+    readonly severity: 'error' | 'warning';
+    /** `AssembleOptions.filename`. */
+    readonly file: string;
+    /** 1-based source line. */
+    readonly line: number;
+    /** 1-based column of the statement, when known. */
+    readonly column?: number;
+    readonly code: DiagnosticCode;
+    readonly message: string;
+}
+/** A section name; the common ones are listed, but any name is allowed. */
+export type SectionName = '.text' | '.data' | '.rdata' | '.sdata' | '.sbss' | '.bss' | (string & Record<never, never>);
+export interface AssembledObject {
+    readonly info: {
+        readonly aspsxVersion: AspsxVersion;
+        readonly gpSize: number;
+        readonly partialDivExpansion: boolean;
+    };
+    /** In order of first appearance; `.comm` allocations create `.sbss`/`.bss` last. */
+    readonly sections: readonly Section[];
+    readonly symbols: readonly SymbolEntry[];
+    readonly functions: readonly FunctionRange[];
+    /** Symbols addressed through `$gp` at this -G value, with the reason. */
+    readonly smallData: readonly SmallDataEntry[];
+}
+export interface Section {
+    readonly name: SectionName;
+    readonly kind: 'code' | 'data' | 'bss';
+    /** Section contents; empty for bss. */
+    readonly bytes: Uint8Array;
+    /** Size in bytes, including reserved bss space. */
+    readonly size: number;
+    /** Code sections only: `bytes` as little-endian words. */
+    readonly words?: Uint32Array;
+    readonly relocations: readonly Relocation[];
+    /** Code sections only: where each word came from, one entry per word. */
+    readonly provenance?: readonly WordOrigin[];
+}
+export type RelocationKind = 'HI16' | 'LO16' | 'GPREL16' | 'MIPS26' | 'WORD32';
+export interface Relocation {
+    /** Byte offset of the patched word in its section. */
+    readonly offset: number;
+    readonly kind: RelocationKind;
+    /** Bits of the word the linker patches: 0xFFFF, 0x03FFFFFF, or 0xFFFFFFFF. */
+    readonly fieldMask: number;
+    readonly target: RelocationTarget;
+    /** The value already encoded in the patched field. */
+    readonly fieldValue: number;
+}
+export type RelocationTarget = {
+    readonly kind: 'symbol';
+    readonly name: string;
+    readonly addend: number;
+} | {
+    readonly kind: 'section';
+    readonly section: SectionName;
+    /** Offset in `section`, addend included. */
+    readonly offset: number;
+    readonly label?: string;
+};
+export interface SymbolEntry {
+    readonly name: string;
+    readonly binding: 'global' | 'local' | 'extern' | 'common';
+    /** Absent for extern symbols. */
+    readonly section?: SectionName;
+    readonly offset?: number;
+    /** From `.comm`, `.lcomm`, or `.extern`. */
+    readonly size?: number;
+}
+export interface FunctionRange {
+    /** From `.ent`. */
+    readonly name: string;
+    readonly section: '.text';
+    /** First word index. */
+    readonly start: number;
+    /** Word index at `.end`, exclusive. */
+    readonly end: number;
+    readonly frame?: {
+        readonly reg: number;
+        readonly size: number;
+        readonly returnReg: number;
+    };
+    readonly mask?: {
+        readonly bits: number;
+        readonly offset: number;
+    };
+    readonly fmask?: {
+        readonly bits: number;
+        readonly offset: number;
+    };
+}
+export type WordOriginKind = 'instruction' | 'macro' | 'branch-delay-nop' | 'load-delay-nop' | 'hilo-gap-nop' | 'cop-delay-nop' | 'align' | 'data';
+export interface WordOrigin {
+    /** Source line that produced the word. */
+    readonly line: number;
+    readonly kind: WordOriginKind;
+    /** The macro that expanded, e.g. 'li' or 'div'. */
+    readonly macro?: string;
+    /** Why the word exists, for inserted nops. */
+    readonly note?: string;
+}
+export interface SmallDataEntry {
+    readonly name: string;
+    /** Defined in `.sdata`/`.sbss`, declared by `.comm`/`.lcomm`, or (opt-in) by `.extern`. */
+    readonly reason: 'sdata' | 'sbss' | 'common' | 'extern';
+    readonly size?: number;
+}
+/** Every mnemonic in the R3000 instruction table. */
+export type Mnemonic = TableMnemonic;
+/** Encoding family: SPECIAL/R-type, immediate, jump, coprocessor move, GTE command. */
+export type InstructionFormat = 'R' | 'I' | 'J' | 'COP' | 'COP2CMD';
+/** How an instruction takes part in ASPSX's nop insertion. */
+export type HazardClass = 'none' | 'load' | 'branch' | 'jump' | 'mult' | 'div' | 'mflo' | 'mtlo' | 'cop-from' | 'cop-to';
+/** One operand, in assembly-syntax order. */
+export type Operand = 
+/** A general-purpose register, 0 to 31. */
+{
+    readonly kind: 'gpr';
+    readonly number: number;
+}
+/** A coprocessor register, 0 to 31, in the data or control space. */
+ | {
+    readonly kind: 'cop';
+    readonly number: number;
+    readonly unit: 0 | 2;
+    readonly space: 'data' | 'control';
+}
+/** An immediate or code field. `bits` is its width; `signed` whether it is sign-extended. */
+ | {
+    readonly kind: 'imm';
+    readonly value: number;
+    readonly bits: 10 | 16 | 20 | 25;
+    readonly signed: boolean;
+}
+/** A shift amount, 0 to 31. */
+ | {
+    readonly kind: 'shamt';
+    readonly value: number;
+}
+/** `offset(base)`, with a signed 16-bit offset. */
+ | {
+    readonly kind: 'mem';
+    readonly base: number;
+    readonly offset: number;
+}
+/** A branch displacement in instructions, relative to the delay slot (pc + 4). */
+ | {
+    readonly kind: 'branch';
+    readonly displacement: number;
+}
+/** The 26-bit index field of `j`/`jal`; the target address is `(pc & 0xF0000000) | index << 2`. */
+ | {
+    readonly kind: 'target';
+    readonly index: number;
+};
+/** A decoded (or encodable) R3000 instruction. */
+export interface Instruction {
+    readonly mnemonic: Mnemonic;
+    readonly format: InstructionFormat;
+    readonly operands: readonly Operand[];
+    /** General-purpose registers read, excluding `$0`. */
+    readonly reads: readonly number[];
+    /** General-purpose registers written, excluding `$0`. */
+    readonly writes: readonly number[];
+    readonly hazardClass: HazardClass;
+}
+/** What `encode` needs: the derived fields of `Instruction` are ignored. */
+export type EncodableInstruction = Pick<Instruction, 'mnemonic' | 'operands'>;
+/** A word that is not a valid R3000 instruction. */
+export interface UnknownInstruction {
+    readonly mnemonic: '.word';
+    readonly word: number;
+    readonly reason: string;
+}
+export interface FormatStyle {
+    /** `$v0` (default `'abi'`) or `$2` (`'numeric'`). Coprocessor registers are always numeric. */
+    readonly registers?: 'numeric' | 'abi';
+    /** Render `nop`, `move`, `beqz`, and `bnez` where they apply. Default false. */
+    readonly pseudo?: boolean;
+    /** Immediates, offsets, and targets in hexadecimal. Default true. */
+    readonly hex?: boolean;
+}
+export interface DecodeOptions {
+    /** Address of the first word: labels are named by address and jump targets resolved. */
+    readonly baseAddress?: number;
+    /** Prefix of synthetic label names. Default 'L'. */
+    readonly labelPrefix?: string;
+}
+export interface DecodedProgram {
+    readonly instructions: readonly (Instruction | UnknownInstruction)[];
+    /** Word index to synthetic label, for every branch (and jump) target inside the program. */
+    readonly labels: ReadonlyMap<number, string>;
+    /** Instruction index to target word index, for branches (and jumps) whose target is labelled. */
+    readonly branchTargets: ReadonlyMap<number, number>;
+    readonly baseAddress?: number;
+}
+//# sourceMappingURL=public-types.d.ts.map

package/dist/public-types.d.ts.map

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

package/dist/public-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public-types.js.map

package/dist/public-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-types.js","sourceRoot":"","sources":["../src/public-types.ts"],"names":[],"mappings":""}

package/dist/util.d.ts

@@ -0,0 +1,3 @@
+/** Pair up two lists element by element, stopping at the shorter one. */
+export declare function zip<A, B>(first: readonly A[], second: readonly B[]): [A, B][];
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAO7E"}

package/dist/util.js

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: MIT
+/** Pair up two lists element by element, stopping at the shorter one. */
+export function zip(first, second) {
+    const pairs = [];
+    const length = Math.min(first.length, second.length);
+    for (let i = 0; i < length; i++) {
+        pairs.push([first[i], second[i]]);
+    }
+    return pairs;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,yEAAyE;AACzE,MAAM,UAAU,GAAG,CAAO,KAAmB,EAAE,MAAoB;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,MAAM,CAAC,CAAC,CAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "psyq-asm",
+  "version": "0.0.1",
+  "description": "ASPSX 2.81-compatible assembler and R3000 encoder/decoder in TypeScript, for PlayStation 1 matching-decompilation tooling in the browser and Node.js",
+  "keywords": [
+    "psyq",
+    "aspsx",
+    "maspsx",
+    "mips",
+    "r3000",
+    "playstation",
+    "ps1",
+    "psx",
+    "decompilation",
+    "assembler",
+    "disassembler"
+  ],
+  "homepage": "https://github.com/jaysonvirissimo/psyq-asm#readme",
+  "bugs": {
+    "url": "https://github.com/jaysonvirissimo/psyq-asm/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaysonvirissimo/psyq-asm.git"
+  },
+  "license": "MIT",
+  "author": "Jayson Virissimo",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "LICENSE",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "psyq-asm": "./bin/psyq-asm.mjs"
+  },
+  "scripts": {
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --project unit",
+    "test:watch": "vitest --project unit",
+    "test:coverage": "vitest run --project unit --coverage",
+    "test:differential": "vitest run --project differential",
+    "test:browser": "playwright test",
+    "test:package": "node test/package/run.mjs",
+    "build": "tsc -p tsconfig.build.json",
+    "check": "npm run format:check && npm run lint && npm run typecheck && npm run test:coverage",
+    "bench": "node scripts/bench.mjs",
+    "serve": "node scripts/serve.mjs"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@playwright/test": "^1.63.0",
+    "@types/node": "^26.0.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "eslint": "^10.10.0",
+    "eslint-config-prettier": "^10.1.8",
+    "fast-check": "^4.9.0",
+    "globals": "^17.12.0",
+    "prettier": "^3.9.6",
+    "psyq-wasm": "^1.0.0",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.69.0",
+    "vite": "^8.0.0",
+    "vitest": "^5.0.0"
+  }
+}