psyq-asm 0.0.1

package/dist/asm/sections.js

@@ -0,0 +1,81 @@
+/** `.text` holds code; `.bss` and `.sbss` reserve space; everything else is data. */
+export function sectionKind(name) {
+    if (name === '.text')
+        return 'code';
+    if (name === '.bss' || name === '.sbss')
+        return 'bss';
+    return 'data';
+}
+/** Accumulates one section's contents during layout. */
+export class SectionBuilder {
+    name;
+    kind;
+    relocations = [];
+    data = [];
+    origins = [];
+    reserved = 0;
+    constructor(name) {
+        this.name = name;
+        this.kind = sectionKind(name);
+    }
+    /** The current size, in bytes. */
+    get offset() {
+        return this.kind === 'bss' ? this.reserved : this.data.length;
+    }
+    pushWord(word, origin) {
+        this.data.push(word & 0xff, (word >>> 8) & 0xff, (word >>> 16) & 0xff, word >>> 24);
+        this.origins.push(origin);
+    }
+    pushBytes(bytes, origin) {
+        for (const byte of bytes)
+            this.data.push(byte);
+        this.coverWithOrigin(origin);
+    }
+    /** Reserve zeroed space: nop words where code is word-aligned, zero bytes otherwise. */
+    pad(size, origin) {
+        if (this.kind === 'bss') {
+            this.reserved += size;
+            return;
+        }
+        let remaining = size;
+        if (this.kind === 'code' && this.data.length % 4 === 0) {
+            for (; remaining >= 4; remaining -= 4)
+                this.pushWord(0, origin);
+        }
+        this.pushBytes(new Uint8Array(remaining), origin);
+    }
+    coverWithOrigin(origin) {
+        if (this.kind !== 'code')
+            return;
+        while (this.origins.length * 4 < this.data.length)
+            this.origins.push(origin);
+    }
+    finish() {
+        if (this.kind === 'code') {
+            while (this.data.length % 4 !== 0)
+                this.data.push(0);
+            const bytes = Uint8Array.from(this.data);
+            const view = new DataView(bytes.buffer);
+            const words = new Uint32Array(bytes.length / 4);
+            for (let i = 0; i < words.length; i++)
+                words[i] = view.getUint32(i * 4, true);
+            return {
+                name: this.name,
+                kind: this.kind,
+                bytes,
+                size: bytes.length,
+                words,
+                relocations: this.relocations,
+                provenance: this.origins,
+            };
+        }
+        return {
+            name: this.name,
+            kind: this.kind,
+            bytes: Uint8Array.from(this.data),
+            size: this.offset,
+            relocations: this.relocations,
+        };
+    }
+}
+//# sourceMappingURL=sections.js.map

package/dist/asm/sections.js.map

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

package/dist/asm/stream.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The expanded stream: what the expansion pass produces, the nop pass edits,
+ * and the layout pass encodes. Instructions become groups of pending words
+ * whose symbolic operands are resolved only at layout.
+ */
+import type { Slot } from '../isa/fields.js';
+import type { IsaRow } from '../isa/table.js';
+import type { WordOriginKind } from '../public-types.js';
+import type { Directive } from './directives.js';
+import type { Expr } from './operands.js';
+/** An operand whose value may still depend on symbols or label addresses. */
+export type Pending = {
+    readonly kind: 'gpr';
+    readonly number: number;
+} | {
+    readonly kind: 'cop';
+    readonly number: number;
+    readonly unit: 0 | 2;
+    readonly space: 'data' | 'control';
+}
+/** Immediates, shift amounts, codes, and jump targets. */
+ | {
+    readonly kind: 'value';
+    readonly expr: Expr;
+} | {
+    readonly kind: 'mem';
+    readonly base: number;
+    readonly offset: Expr;
+} | {
+    readonly kind: 'branch';
+    readonly target: Expr;
+};
+export interface PendingArg {
+    readonly slot: Slot;
+    readonly value: Pending;
+}
+export interface PendingWord {
+    readonly row: IsaRow;
+    readonly args: readonly PendingArg[];
+    readonly origin: WordOriginKind;
+    readonly note?: string;
+}
+/** The words one source statement became. */
+export interface Group {
+    readonly kind: 'group';
+    readonly line: number;
+    readonly column: number;
+    readonly section: string;
+    /** Whether `.set reorder` was in effect. */
+    readonly reorder: boolean;
+    readonly words: readonly PendingWord[];
+    /** The macro mnemonic, when the statement expanded. */
+    readonly macro?: string;
+    /** For a `div`/`rem` expansion, the register its final `mflo`/`mfhi` writes. */
+    readonly divMove?: number;
+}
+export type Item = Group | {
+    readonly kind: 'label';
+    readonly name: string;
+    readonly line: number;
+    readonly column: number;
+    readonly transparent: boolean;
+}
+/** `.set` options: never end the nop pass's lookahead. */
+ | {
+    readonly kind: 'set';
+    readonly option: string;
+    readonly line: number;
+}
+/** Any other directive: ends the nop pass's lookahead. */
+ | {
+    readonly kind: 'directive';
+    readonly directive: Directive;
+    readonly line: number;
+    readonly column: number;
+};
+//# sourceMappingURL=stream.d.ts.map

package/dist/asm/stream.d.ts.map

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

package/dist/asm/stream.js

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

package/dist/asm/stream.js.map

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

package/dist/asm/symbols.d.ts

@@ -0,0 +1,42 @@
+/** Pass 1: symbol definitions, bindings, common and extern sizes, and small data. */
+import type { SmallDataEntry } from '../public-types.js';
+import type { Diagnostics } from './diagnostics.js';
+import type { Statement } from './parser.js';
+export interface CommonSymbol {
+    readonly name: string;
+    readonly size: number;
+    readonly align: number | undefined;
+    readonly local: boolean;
+}
+export interface SymbolTable {
+    /** Every symbol and label name, in order of first appearance. */
+    readonly order: readonly string[];
+    /** Labels by name, with the section they were defined in. */
+    readonly labels: ReadonlyMap<string, {
+        readonly section: string;
+        readonly line: number;
+    }>;
+    readonly globals: ReadonlySet<string>;
+    readonly externs: ReadonlyMap<string, number | undefined>;
+    readonly commons: ReadonlyMap<string, CommonSymbol>;
+}
+/**
+ * Compiler-generated labels that are not symbols: `$L12`, `$LC0`, and `L`
+ * followed by a non-digit (`LM439`, debugging line markers). They are resolved
+ * against their section rather than exported.
+ */
+export declare function isLocalLabel(name: string): boolean;
+/**
+ * Labels the nop pass looks past, as maspsx does: numbered code labels (`$L12`,
+ * `$Lb3`, `$Le3`) and `L`-plus-non-digit markers. Any other label ends the
+ * lookahead.
+ */
+export declare function isTransparentLabel(name: string): boolean;
+export declare function collectSymbols(statements: readonly Statement[], diagnostics: Diagnostics): SymbolTable;
+/**
+ * The symbols ASPSX addresses through `$gp` at this -G value: labels in
+ * `.sdata`/`.sbss`, commons no larger than the threshold, and (only with
+ * `experimental.externSmallData`) externs declared no larger than it.
+ */
+export declare function classifySmallData(table: SymbolTable, gpSize: number, externSmallData: boolean): Map<string, SmallDataEntry>;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/asm/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/asm/symbols.ts"],"names":[],"mappings":"AACA,qFAAqF;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1F,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,WAAW,EAAE,WAAW,GACvB,WAAW,CA8Eb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,OAAO,GACvB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAmB7B"}

package/dist/asm/symbols.js

@@ -0,0 +1,122 @@
+/**
+ * Compiler-generated labels that are not symbols: `$L12`, `$LC0`, and `L`
+ * followed by a non-digit (`LM439`, debugging line markers). They are resolved
+ * against their section rather than exported.
+ */
+export function isLocalLabel(name) {
+    return name.startsWith('$L') || /^L[^0-9]/.test(name);
+}
+/**
+ * Labels the nop pass looks past, as maspsx does: numbered code labels (`$L12`,
+ * `$Lb3`, `$Le3`) and `L`-plus-non-digit markers. Any other label ends the
+ * lookahead.
+ */
+export function isTransparentLabel(name) {
+    return /^\$L[be]?\d+$/.test(name) || /^L[^0-9]/.test(name);
+}
+export function collectSymbols(statements, diagnostics) {
+    const order = [];
+    const seen = new Set();
+    const labels = new Map();
+    const globals = new Set();
+    const externs = new Map();
+    const commons = new Map();
+    let section = '.text';
+    const note = (name) => {
+        if (seen.has(name))
+            return;
+        seen.add(name);
+        order.push(name);
+    };
+    const noteExpr = (expr) => {
+        if (expr.kind === 'symbol')
+            note(expr.name);
+        else if (expr.kind === 'reloc' && expr.inner.kind === 'symbol')
+            note(expr.inner.name);
+    };
+    for (const statement of statements) {
+        switch (statement.kind) {
+            case 'label': {
+                const previous = labels.get(statement.name);
+                if (previous !== undefined) {
+                    diagnostics.error(statement, 'duplicate-label', `${statement.name} is already defined on line ${String(previous.line)}.`);
+                }
+                else {
+                    labels.set(statement.name, { section, line: statement.line });
+                }
+                note(statement.name);
+                break;
+            }
+            case 'instruction':
+                for (const operand of statement.operands) {
+                    if (operand.kind === 'expr')
+                        noteExpr(operand.expr);
+                    else if (operand.kind === 'mem')
+                        noteExpr(operand.offset);
+                }
+                break;
+            case 'directive': {
+                const d = statement.directive;
+                switch (d.kind) {
+                    case 'section':
+                        section = d.name;
+                        break;
+                    case 'globl':
+                        globals.add(d.name);
+                        note(d.name);
+                        break;
+                    case 'extern':
+                        externs.set(d.name, d.size);
+                        note(d.name);
+                        break;
+                    case 'common':
+                        if (commons.has(d.name)) {
+                            diagnostics.error(statement, 'duplicate-label', `${d.name} is already a common symbol.`);
+                        }
+                        else {
+                            commons.set(d.name, { name: d.name, size: d.size, align: d.align, local: d.local });
+                        }
+                        note(d.name);
+                        break;
+                    case 'values':
+                        d.values.forEach(noteExpr);
+                        break;
+                    default:
+                        break;
+                }
+                break;
+            }
+        }
+    }
+    return { order, labels, globals, externs, commons };
+}
+/**
+ * The symbols ASPSX addresses through `$gp` at this -G value: labels in
+ * `.sdata`/`.sbss`, commons no larger than the threshold, and (only with
+ * `experimental.externSmallData`) externs declared no larger than it.
+ */
+export function classifySmallData(table, gpSize, externSmallData) {
+    const small = new Map();
+    if (gpSize === 0)
+        return small;
+    for (const name of table.order) {
+        const label = table.labels.get(name);
+        const common = table.commons.get(name);
+        const externSize = table.externs.get(name);
+        if (label !== undefined) {
+            if (label.section === '.sdata' || label.section === '.sbss') {
+                small.set(name, { name, reason: label.section === '.sdata' ? 'sdata' : 'sbss' });
+            }
+        }
+        else if (common !== undefined) {
+            if (common.size <= gpSize)
+                small.set(name, { name, reason: 'common', size: common.size });
+        }
+        else if (externSmallData && externSize !== undefined && externSize <= gpSize) {
+            // Off by default: ASPSX 2.81, like maspsx, ignores .extern sizes.
+            small.set(name, { name, reason: 'extern', size: externSize });
+        }
+    }
+    return small;
+}
+//# sourceMappingURL=symbols.js.map

package/dist/asm/symbols.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+import type { ErrorCode } from './public-types.js';
+/**
+ * Base class of every error thrown by psyq-asm. Problems in the assembly input
+ * are diagnostics in a failed result, not errors; errors are reserved for
+ * caller mistakes.
+ *
+ * Each subclass redeclares `code` as its own literal, so `code` is a
+ * discriminant. The redeclarations are `declare`-only; the base constructor is
+ * what assigns the value. A generic base would read better but would make
+ * `code` `any` after `x instanceof PsyqAsmError`, since instanceof narrowing
+ * fills a generic class's type arguments with `any`.
+ */
+export declare class PsyqAsmError extends Error {
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message: string, options?: ErrorOptions);
+}
+/** Options given to `assemble`, `decodeWords`, or `format` are malformed. */
+export declare class InvalidOptionsError extends PsyqAsmError {
+    readonly code: 'invalid-options';
+    constructor(message: string);
+}
+/** `encode` was given an instruction whose operands cannot be encoded. */
+export declare class InvalidInstructionError extends PsyqAsmError {
+    readonly code: 'invalid-instruction';
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAEb,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKrE;AAED,6EAA6E;AAC7E,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,SAAiB,IAAI,EAAE,iBAAiB,CAAC;gBAE7B,OAAO,EAAE,MAAM;CAI5B;AAED,0EAA0E;AAC1E,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,SAAiB,IAAI,EAAE,qBAAqB,CAAC;gBAEjC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,34 @@
+/**
+ * Base class of every error thrown by psyq-asm. Problems in the assembly input
+ * are diagnostics in a failed result, not errors; errors are reserved for
+ * caller mistakes.
+ *
+ * Each subclass redeclares `code` as its own literal, so `code` is a
+ * discriminant. The redeclarations are `declare`-only; the base constructor is
+ * what assigns the value. A generic base would read better but would make
+ * `code` `any` after `x instanceof PsyqAsmError`, since instanceof narrowing
+ * fills a generic class's type arguments with `any`.
+ */
+export class PsyqAsmError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'PsyqAsmError';
+    }
+}
+/** Options given to `assemble`, `decodeWords`, or `format` are malformed. */
+export class InvalidOptionsError extends PsyqAsmError {
+    constructor(message) {
+        super('invalid-options', message);
+        this.name = 'InvalidOptionsError';
+    }
+}
+/** `encode` was given an instruction whose operands cannot be encoded. */
+export class InvalidInstructionError extends PsyqAsmError {
+    constructor(message) {
+        super('invalid-instruction', message);
+        this.name = 'InvalidInstructionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAY;IAEzB,YAAY,IAAe,EAAE,OAAe,EAAE,OAAsB;QAClE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IAGnD,YAAY,OAAe;QACzB,KAAK,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IAGvD,YAAY,OAAe;QACzB,KAAK,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * psyq-asm: an ASPSX 2.81-compatible assembler and R3000 encoder/decoder.
+ */
+export type { AspsxVersion, AssembledObject, AssembleFailure, AssembleOptions, AssembleResult, AssembleSuccess, DecodedProgram, DecodeOptions, Diagnostic, DiagnosticCode, EncodableInstruction, ErrorCode, ExperimentalBehaviours, FormatStyle, FunctionRange, HazardClass, Instruction, InstructionFormat, Mnemonic, Operand, Relocation, RelocationKind, RelocationTarget, Section, SectionName, SmallDataEntry, SymbolEntry, UnknownInstruction, WordOrigin, WordOriginKind, } from './public-types.js';
+export { InvalidInstructionError, InvalidOptionsError, PsyqAsmError } from './errors.js';
+export { DEFAULT_EXPERIMENTAL, SUPPORTED_ASPSX_VERSIONS } from './options.js';
+export { assemble } from './asm/assemble.js';
+export { decode } from './isa/decode.js';
+export { encode } from './isa/encode.js';
+export { format } from './isa/format.js';
+export { REGISTER_NAMES, parseRegister } from './isa/registers.js';
+export { decodeWords } from './program/decode-words.js';
+export { formatProgram } from './program/format-program.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,YAAY,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { InvalidInstructionError, InvalidOptionsError, PsyqAsmError } from './errors.js';
+export { DEFAULT_EXPERIMENTAL, SUPPORTED_ASPSX_VERSIONS } from './options.js';
+export { assemble } from './asm/assemble.js';
+export { decode } from './isa/decode.js';
+export { encode } from './isa/encode.js';
+export { format } from './isa/format.js';
+export { REGISTER_NAMES, parseRegister } from './isa/registers.js';
+export { decodeWords } from './program/decode-words.js';
+export { formatProgram } from './program/format-program.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/isa/decode.d.ts

@@ -0,0 +1,8 @@
+import type { Instruction, UnknownInstruction } from '../public-types.js';
+/**
+ * Decode one R3000 word. Reserved and unknown encodings return an
+ * `UnknownInstruction` rather than throwing. Throws `InvalidInstructionError`
+ * only when `word` is not a 32-bit integer (signed or unsigned).
+ */
+export declare function decode(word: number): Instruction | UnknownInstruction;
+//# sourceMappingURL=decode.d.ts.map

package/dist/isa/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/isa/decode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAW,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAiFnF;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,kBAAkB,CAiBrE"}

package/dist/isa/decode.js

@@ -0,0 +1,92 @@
+// SPDX-License-Identifier: MIT
+import { InvalidInstructionError } from '../errors.js';
+import { COP_SLOTS, signExtend16 } from './fields.js';
+import { buildInstruction, reservedBits } from './instruction.js';
+import { ISA_ROWS } from './table.js';
+/** Rows grouped by primary opcode, each with its reserved bits precomputed. */
+const BY_OPCODE = (() => {
+    const map = new Map();
+    for (const row of ISA_ROWS) {
+        const op = row.value >>> 26;
+        const bucket = map.get(op) ?? [];
+        bucket.push({ row, reserved: reservedBits(row) });
+        map.set(op, bucket);
+    }
+    return map;
+})();
+function hex(value, digits) {
+    return `0x${value.toString(16).toUpperCase().padStart(digits, '0')}`;
+}
+function operandFor(slot, word) {
+    switch (slot) {
+        case 'rd':
+            return { kind: 'gpr', number: (word >>> 11) & 31 };
+        case 'rs':
+            return { kind: 'gpr', number: (word >>> 21) & 31 };
+        case 'rt':
+            return { kind: 'gpr', number: (word >>> 16) & 31 };
+        case 'sa':
+            return { kind: 'shamt', value: (word >>> 6) & 31 };
+        case 'imm16s':
+            return { kind: 'imm', value: signExtend16(word), bits: 16, signed: true };
+        case 'imm16u':
+            return { kind: 'imm', value: word & 0xffff, bits: 16, signed: false };
+        case 'mem':
+            return { kind: 'mem', base: (word >>> 21) & 31, offset: signExtend16(word) };
+        case 'branch':
+            return { kind: 'branch', displacement: signExtend16(word) };
+        case 'target':
+            return { kind: 'target', index: word & 0x03ffffff };
+        case 'code20':
+            return { kind: 'imm', value: (word >>> 6) & 0xfffff, bits: 20, signed: false };
+        case 'code10hi':
+            return { kind: 'imm', value: (word >>> 16) & 0x3ff, bits: 10, signed: false };
+        case 'code10':
+            return { kind: 'imm', value: (word >>> 6) & 0x3ff, bits: 10, signed: false };
+        case 'imm25':
+            return { kind: 'imm', value: word & 0x01ffffff, bits: 25, signed: false };
+        case 'cop0':
+        case 'cop2d':
+        case 'cop2c':
+        case 'cop2dRt': {
+            const { unit, space, shift } = COP_SLOTS[slot];
+            return { kind: 'cop', number: (word >>> shift) & 31, unit, space };
+        }
+    }
+}
+function unknownReason(word) {
+    const op = word >>> 26;
+    switch (op) {
+        case 0x00:
+            return `unknown SPECIAL function ${hex(word & 0x3f, 2)}`;
+        case 0x01:
+            return `unknown REGIMM condition ${hex((word >>> 16) & 31, 2)}`;
+        case 0x10:
+            return 'unknown coprocessor 0 operation';
+        case 0x12:
+            return 'unknown coprocessor 2 operation';
+        default:
+            return `unknown opcode ${hex(op, 2)}`;
+    }
+}
+/**
+ * Decode one R3000 word. Reserved and unknown encodings return an
+ * `UnknownInstruction` rather than throwing. Throws `InvalidInstructionError`
+ * only when `word` is not a 32-bit integer (signed or unsigned).
+ */
+export function decode(word) {
+    if (!Number.isInteger(word) || word < -0x80000000 || word > 0xffffffff) {
+        throw new InvalidInstructionError(`word must be a 32-bit integer, not ${String(word)}.`);
+    }
+    const w = word >>> 0;
+    for (const { row: r, reserved } of BY_OPCODE.get(w >>> 26) ?? []) {
+        if ((w & r.mask) >>> 0 !== r.value)
+            continue;
+        if ((w & reserved) >>> 0 !== 0) {
+            return { mnemonic: '.word', word: w, reason: `${r.mnemonic} with reserved bits set` };
+        }
+        return buildInstruction(r, r.syntax.map((slot) => operandFor(slot, w)), w);
+    }
+    return { mnemonic: '.word', word: w, reason: unknownReason(w) };
+}
+//# sourceMappingURL=decode.js.map

package/dist/isa/decode.js.map

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

package/dist/isa/encode.d.ts

@@ -0,0 +1,9 @@
+import type { EncodableInstruction } from '../public-types.js';
+/**
+ * Encode one instruction. The operands are in assembly order, as `decode`
+ * produces them; `jalr rs` may omit the link register and `syscall`, `break`,
+ * and `tge` may omit their code. Throws `InvalidInstructionError` for an
+ * unknown mnemonic or an operand that does not fit.
+ */
+export declare function encode(instruction: EncodableInstruction): number;
+//# sourceMappingURL=encode.d.ts.map

package/dist/isa/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/isa/encode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAW,MAAM,oBAAoB,CAAC;AAwGxE;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,CAmChE"}