@jhlagado/azm 0.2.0 → 0.2.2

package/dist/legacy-root-azm/src/lowering/emitPipeline.d.ts

@@ -1,121 +0,0 @@
-/**
- * Emit orchestration phases for `emitProgram`.
- *
- * Pipeline (conceptual):
- *
- * 1. **Workspace setup** — lives in `emit.ts`: placement byte maps, fixup queues, op registries,
- *    resolution helpers, and the program-lowering context (`createEmitProgramContext`). This
- *    phase wires mutable state and callbacks; it does not traverse the whole program yet.
- *
- * 2. **Prescan** — `runEmitPrescanPhase`: discover ops and
- *    raw-address names so later lowering can resolve symbols. Product: {@link PrescanResult}.
- *
- * 3. **Lowering** — `runEmitLoweringPhase`: traverse declarations and instruction streams, emit bytes
- *    into placement maps, enqueue fixups. Product: {@link LoweringResult}.
- *
- * 4. **Placement & artifacts** — `runEmitPlacementAndArtifactPhase`: fixup resolution,
- *    merged `EmittedByteMap`, symbol table, placed lowered-ASM program.
- *    Input: {@link EmitFinalizationContext} (built via {@link mergeEmitFinalizationContext}).
- *
- * Format writers stay in `compile.ts` / `PipelineDeps`; this module only produces the
- * in-memory products they consume.
- */
-import type { EmittedByteMap, SymbolEntry } from '../formats/types.js';
-import { type EmitFinalizationContext } from './emitFinalization.js';
-import type { LoweredAsmProgram, LoweredAsmStream } from './loweredAsmTypes.js';
-import type { PrescanResult } from './prescanTypes.js';
-import { type Context as ProgramLoweringContext, type LoweringResult, type PrescanContext } from './programLowering.js';
-type EmitPrescanPhaseContext = PrescanContext;
-type EmitPrescanPhaseResult = PrescanResult;
-type EmitLoweringPhaseContext = ProgramLoweringContext;
-interface EmitLoweringPhaseResult {
-    /** Next code-placement allocation offset after lowering. */
-    readonly codeOffset: LoweringResult['codeOffset'];
-    /** Next data-placement offset. */
-    readonly dataOffset: LoweringResult['dataOffset'];
-    /** Symbols still pending resolution. */
-    readonly pending: LoweringResult['pending'];
-    /** Emitted symbol table entries. */
-    readonly symbols: LoweringResult['symbols'];
-    /** Absolute-address symbols. */
-    readonly absoluteSymbols: LoweringResult['absoluteSymbols'];
-    /** Emitted code bytes map. */
-    readonly codeBytes: LoweringResult['codeBytes'];
-    /** Emitted data bytes map. */
-    readonly dataBytes: LoweringResult['dataBytes'];
-}
-/** Options for `emitProgram` (include paths, policy flags, listing sources). */
-export type EmitProgramOptions = {
-    /** Extra include directories for `include` / assets; omit for none. */
-    includeDirs?: string[];
-    /** Default code load address for placement; omit uses pipeline default. */
-    defaultCodeBase?: number;
-    /** Optional full source text per file for listings. */
-    sourceTexts?: Map<string, string>;
-    /** Optional line-end comments keyed by file and 1-based line. */
-    sourceLineComments?: Map<string, Map<number, string>>;
-};
-/** In-memory compile products passed to format writers (plus trace stream). */
-export type EmitProgramResult = {
-    /** Final merged address→byte map for writers. */
-    map: EmittedByteMap;
-    /** Resolved symbol table. */
-    symbols: SymbolEntry[];
-    /** Raw lowered asm trace from phase 1. */
-    loweredAsmStream: LoweredAsmStream;
-    /** Lowered asm after placement. */
-    placedLoweredAsmProgram: LoweredAsmProgram;
-};
-/** Finalization inputs that come from phase-1 wiring rather than phase-3 lowering. */
-export interface EmitFinalizationEnv {
-    /** Shared diagnostics buffer. */
-    readonly diagnostics: EmitFinalizationContext['diagnostics'];
-    /** File-level diagnostic helper. */
-    readonly diag: EmitFinalizationContext['diag'];
-    /** Span-level diagnostic helper. */
-    readonly diagAt: EmitFinalizationContext['diagAt'];
-    /** Primary source path for diagnostics. */
-    readonly primaryFile: EmitFinalizationContext['primaryFile'];
-    /** Code/data placement base imm expressions. */
-    readonly baseExprs: EmitFinalizationContext['baseExprs'];
-    /** Imm evaluator used during placement. */
-    readonly evalImmExpr: EmitFinalizationContext['evalImmExpr'];
-    /** Compile environment. */
-    readonly env: EmitFinalizationContext['env'];
-    /** Lowered asm stream to place. */
-    readonly loweredAsmStream: EmitFinalizationContext['loweredAsmStream'];
-    /** Pending abs16 fixups. */
-    readonly fixups: EmitFinalizationContext['fixups'];
-    /** Pending rel8 fixups. */
-    readonly rel8Fixups: EmitFinalizationContext['rel8Fixups'];
-    /** Working byte map before merge. */
-    readonly bytes: EmitFinalizationContext['bytes'];
-    /** Code source segments for rebasing. */
-    readonly codeSourceSegments: EmitFinalizationContext['codeSourceSegments'];
-    /** Byte alignment helper. */
-    readonly alignTo: EmitFinalizationContext['alignTo'];
-    /** Writes a byte-offset slice into the byte map. */
-    readonly writeBytePlacement: EmitFinalizationContext['writeBytePlacement'];
-    /** Computes written byte ranges for overlap checks. */
-    readonly computeWrittenRange: EmitFinalizationContext['computeWrittenRange'];
-    /** Rebases source map after placement moves. */
-    readonly rebaseCodeSourceSegments: EmitFinalizationContext['rebaseCodeSourceSegments'];
-    /** Optional default code base override. */
-    readonly defaultCodeBase?: number;
-}
-type EmitPlacementPhaseContext = EmitLoweringPhaseResult & EmitFinalizationEnv;
-type EmitPlacementPhaseResult = Omit<EmitProgramResult, 'loweredAsmStream'>;
-/**
- * Combine lowering output with placement/fixup inputs. `lowered` is the typed handoff from
- * the lowering phase; `env` holds shared refs (maps, diagnostics, helpers) held across phases.
- */
-export declare function mergeEmitFinalizationContext(lowered: EmitLoweringPhaseResult, env: EmitFinalizationEnv): EmitPlacementPhaseContext;
-/** Deterministic empty result when compilation aborts before lowering (e.g. no source files). */
-export declare function emitProgramEmptyResult(): EmitProgramResult;
-/** Phase 2 — prescan: build op candidate maps and alias metadata before emission. */
-export declare function runEmitPrescanPhase(ctx: EmitPrescanPhaseContext): EmitPrescanPhaseResult;
-/** Phase 3 — lowering: emit declarations and instruction streams into placement bytes and fixup queues. */
-export declare function runEmitLoweringPhase(ctx: EmitLoweringPhaseContext, prescan: EmitPrescanPhaseResult): EmitLoweringPhaseResult;
-/** Phase 4 — placement, fixups, merged map and placed lowered ASM. */
-export declare function runEmitPlacementAndArtifactPhase(context: EmitPlacementPhaseContext): EmitPlacementPhaseResult;
-export {};

package/dist/legacy-root-azm/src/lowering/emitPipeline.js

@@ -1,57 +0,0 @@
-/**
- * Emit orchestration phases for `emitProgram`.
- *
- * Pipeline (conceptual):
- *
- * 1. **Workspace setup** — lives in `emit.ts`: placement byte maps, fixup queues, op registries,
- *    resolution helpers, and the program-lowering context (`createEmitProgramContext`). This
- *    phase wires mutable state and callbacks; it does not traverse the whole program yet.
- *
- * 2. **Prescan** — `runEmitPrescanPhase`: discover ops and
- *    raw-address names so later lowering can resolve symbols. Product: {@link PrescanResult}.
- *
- * 3. **Lowering** — `runEmitLoweringPhase`: traverse declarations and instruction streams, emit bytes
- *    into placement maps, enqueue fixups. Product: {@link LoweringResult}.
- *
- * 4. **Placement & artifacts** — `runEmitPlacementAndArtifactPhase`: fixup resolution,
- *    merged `EmittedByteMap`, symbol table, placed lowered-ASM program.
- *    Input: {@link EmitFinalizationContext} (built via {@link mergeEmitFinalizationContext}).
- *
- * Format writers stay in `compile.ts` / `PipelineDeps`; this module only produces the
- * in-memory products they consume.
- */
-import { finalizeEmitProgram } from './emitFinalization.js';
-import { preScanProgramDeclarations } from './programPrescan.js';
-import { lowerProgramDeclarations } from './programLoweringTraversal.js';
-// --- Phase handoff: merge lowering output with finalization inputs ---
-/**
- * Combine lowering output with placement/fixup inputs. `lowered` is the typed handoff from
- * the lowering phase; `env` holds shared refs (maps, diagnostics, helpers) held across phases.
- */
-export function mergeEmitFinalizationContext(lowered, env) {
-    return { ...lowered, ...env };
-}
-/** Deterministic empty result when compilation aborts before lowering (e.g. no source files). */
-export function emitProgramEmptyResult() {
-    return {
-        map: { bytes: new Map() },
-        symbols: [],
-        loweredAsmStream: { blocks: [] },
-        placedLoweredAsmProgram: { blocks: [] },
-    };
-}
-// --- Phase 2: prescan (ops) ---
-/** Phase 2 — prescan: build op candidate maps and alias metadata before emission. */
-export function runEmitPrescanPhase(ctx) {
-    return preScanProgramDeclarations(ctx);
-}
-// --- Phase 3: lowering (emit bytes, fixups, lowered ASM stream) ---
-/** Phase 3 — lowering: emit declarations and instruction streams into placement bytes and fixup queues. */
-export function runEmitLoweringPhase(ctx, prescan) {
-    return lowerProgramDeclarations({ ...ctx, prescan });
-}
-// --- Phase 4: finalization (placement, fixups, artifact assembly) ---
-/** Phase 4 — placement, fixups, merged map and placed lowered ASM. */
-export function runEmitPlacementAndArtifactPhase(context) {
-    return finalizeEmitProgram(context);
-}

package/dist/legacy-root-azm/src/lowering/emitProgramContext.d.ts

@@ -1,39 +0,0 @@
-/**
- * Emit program context wiring (#1084, #1316)
- *
- * Callers pass named bundles aligned with {@link AssemblerLoweringComponentContexts}; the builder
- * forwards them without flattening to {@link createEmitLoweringContexts}.
- */
-import type { AssemblerLoweringAstUtilityContext, AssemblerLoweringConditionContext, AssemblerLoweringDiagnosticsContext, AssemblerLoweringEmissionContext, AssemblerLoweringAddressingContext, AssemblerLoweringOpOverloadContext, AssemblerLoweringOpResolutionContext, AssemblerLoweringRegisterContext, AssemblerLoweringSpTrackingContext, AssemblerLoweringSymbolContext, AssemblerLoweringTypeContext } from './assemblerLoweringContext.js';
-import type { EmitProgramLoweringContextInputs } from './emitContextBuilder.js';
-type EmitDiagnosticsBundle = AssemblerLoweringDiagnosticsContext;
-type EmitSymbolsAndTraceBundle = AssemblerLoweringSymbolContext;
-type EmitSpTrackingBundle = AssemblerLoweringSpTrackingContext;
-type EmitEmissionBundle = AssemblerLoweringEmissionContext;
-type EmitConditionsBundle = AssemblerLoweringConditionContext;
-type EmitTypesBundle = AssemblerLoweringTypeContext;
-type EmitAddressingBundle = AssemblerLoweringAddressingContext;
-type EmitOpResolutionBundle = AssemblerLoweringOpResolutionContext;
-type EmitOpOverloadBundle = AssemblerLoweringOpOverloadContext;
-type EmitAstUtilitiesBundle = AssemblerLoweringAstUtilityContext;
-type EmitRegistersBundle = AssemblerLoweringRegisterContext;
-/** Named bundles passed from `emitProgram` into lowering context construction. */
-type EmitProgramContextBundles = {
-    readonly diagnostics: Readonly<EmitDiagnosticsBundle>;
-    readonly symbolsAndTrace: Readonly<EmitSymbolsAndTraceBundle>;
-    readonly spTracking: Readonly<EmitSpTrackingBundle>;
-    readonly emission: Readonly<EmitEmissionBundle>;
-    readonly conditions: Readonly<EmitConditionsBundle>;
-    readonly types: Readonly<EmitTypesBundle>;
-    readonly addressing: Readonly<EmitAddressingBundle>;
-    readonly opResolution: Readonly<EmitOpResolutionBundle>;
-    readonly opOverload: Readonly<EmitOpOverloadBundle>;
-    readonly astUtilities: Readonly<EmitAstUtilitiesBundle>;
-    readonly registers: Readonly<EmitRegistersBundle>;
-    readonly program: Readonly<EmitProgramLoweringContextInputs>;
-};
-export declare function createEmitProgramContext(bundles: Readonly<EmitProgramContextBundles>): {
-    assemblerLoweringSharedContext: import("./assemblerLoweringContext.js").AssemblerLoweringSharedContext;
-    programLoweringContext: import("./programLowering.js").Context;
-};
-export {};

package/dist/legacy-root-azm/src/lowering/emitProgramContext.js

@@ -1,29 +0,0 @@
-/**
- * Emit program context wiring (#1084, #1316)
- *
- * Callers pass named bundles aligned with {@link AssemblerLoweringComponentContexts}; the builder
- * forwards them without flattening to {@link createEmitLoweringContexts}.
- */
-import { createEmitLoweringContexts } from './emitContextBuilder.js';
-function emitProgramBundlesToLoweringBuilderInput(b) {
-    const assemblerLowering = {
-        diagnostics: b.diagnostics,
-        symbols: b.symbolsAndTrace,
-        spTracking: b.spTracking,
-        emission: b.emission,
-        conditions: b.conditions,
-        types: b.types,
-        addressing: b.addressing,
-        opResolution: b.opResolution,
-        opOverload: b.opOverload,
-        astUtilities: b.astUtilities,
-        registers: b.registers,
-    };
-    return {
-        assemblerLowering,
-        programLowering: b.program,
-    };
-}
-export function createEmitProgramContext(bundles) {
-    return createEmitLoweringContexts(emitProgramBundlesToLoweringBuilderInput(bundles));
-}

package/dist/legacy-root-azm/src/lowering/emitState.d.ts

@@ -1,90 +0,0 @@
-import type { EmittedSourceSegment } from '../formats/types.js';
-import type { SourceSpan, ImmExprNode } from '../frontend/ast.js';
-import type { PlacementKind, SourceSegmentTag } from './loweringTypes.js';
-import type { LoweredAsmStream, LoweredAsmStreamBlock } from './loweredAsmTypes.js';
-type EmitStateContext = {
-    /** Full source text per file for listings. */
-    sourceTexts?: Map<string, string>;
-    /** Line-end comments keyed by file and line. */
-    sourceLineComments?: Map<string, Map<number, string>>;
-    /** Code-placement byte map. */
-    codeBytes: Map<number, number>;
-    /** Source segment ranges for code bytes. */
-    codeSourceSegments: EmittedSourceSegment[];
-    /** Pending abs16 fixups. */
-    fixups: Array<{
-        offset: number;
-        baseLower: string;
-        addend: number;
-        file: string;
-    }>;
-    /** Pending rel8 fixups. */
-    rel8Fixups: Array<{
-        offset: number;
-        origin: number;
-        baseLower: string;
-        addend: number;
-        file: string;
-        mnemonic: string;
-    }>;
-    /** Lowered asm trace stream. */
-    loweredAsmStream: LoweredAsmStream;
-    /** Lowered asm blocks keyed for random access. */
-    loweredAsmBlocksByKey: Map<string, LoweredAsmStreamBlock>;
-    /** Alignment helper. */
-    alignTo: (n: number, alignment: number) => number;
-    /** Best-effort imm evaluation. */
-    evalImmNoDiag: (expr: ImmExprNode) => number | undefined;
-    /** Parses simple symbolic targets; `undefined` if not symbolic. */
-    symbolicTargetFromExpr: (expr: ImmExprNode) => {
-        baseLower: string;
-        addend: number;
-    } | undefined;
-    /** Formats an imm for lowered asm text. */
-    formatImmExprForAsm: (expr: ImmExprNode) => string;
-    /** Pretty-prints a type for traces. */
-    typeDisplay: (typeExpr: import('../frontend/ast.js').TypeExprNode) => string;
-};
-export declare function createEmitStateHelpers(ctx: EmitStateContext): {
-    activePlacementRef: {
-        current: PlacementKind;
-    };
-    codeOffsetRef: {
-        current: number;
-    };
-    dataOffsetRef: {
-        current: number;
-    };
-    currentCodeSegmentTagRef: {
-        current: SourceSegmentTag | undefined;
-    };
-    generatedLabelCounterRef: {
-        current: number;
-    };
-    getCurrentCodeOffset: () => number;
-    setCurrentCodeOffset: (value: number) => void;
-    setCurrentCodeByte: (offset: number, value: number) => void;
-    pushCurrentFixup: (fixup: {
-        offset: number;
-        baseLower: string;
-        addend: number;
-        file: string;
-    }) => void;
-    pushCurrentRel8Fixup: (fixup: {
-        offset: number;
-        origin: number;
-        baseLower: string;
-        addend: number;
-        file: string;
-        mnemonic: string;
-    }) => void;
-    recordCodeSourceRange: (start: number, end: number) => void;
-    traceLabel: (_offset: number, name: string, span?: SourceSpan) => void;
-    traceComment: (_offset: number, text: string) => void;
-    advanceAlign: (a: number) => void;
-    flushTrailingUserComments: () => void;
-    lowerImmExprForLoweredAsm: (expr: ImmExprNode) => import("./loweredAsmTypes.js").LoweredImmExpr;
-    lowerOperandForLoweredAsm: (operand: import("../frontend/ast.js").AsmOperandNode) => import("./loweredAsmTypes.js").LoweredOperand;
-    recordLoweredAsmItem: (item: import("./loweredAsmTypes.js").LoweredAsmItem, span?: SourceSpan) => void;
-};
-export {};

package/dist/legacy-root-azm/src/lowering/emitState.js

@@ -1,124 +0,0 @@
-import { createLoweredAsmStreamRecordingHelpers } from './loweredAsmStreamRecording.js';
-export function createEmitStateHelpers(ctx) {
-    let activePlacement = 'code';
-    let codeOffset = 0;
-    let dataOffset = 0;
-    let currentCodeSegmentTag;
-    let generatedLabelCounter = 0;
-    const sameSourceTag = (x, y) => x.file === y.file &&
-        x.line === y.line &&
-        x.column === y.column &&
-        x.kind === y.kind &&
-        x.confidence === y.confidence;
-    const recordCodeSourceRange = (start, end) => {
-        if (!currentCodeSegmentTag || end <= start)
-            return;
-        const segments = ctx.codeSourceSegments;
-        const last = segments[segments.length - 1];
-        if (last && last.end === start && sameSourceTag(last, currentCodeSegmentTag)) {
-            last.end = end;
-            return;
-        }
-        segments.push({ ...currentCodeSegmentTag, start, end });
-    };
-    const activePlacementRef = {
-        get current() {
-            return activePlacement;
-        },
-        set current(value) {
-            activePlacement = value;
-        },
-    };
-    const codeOffsetRef = {
-        get current() {
-            return codeOffset;
-        },
-        set current(value) {
-            codeOffset = value;
-        },
-    };
-    const dataOffsetRef = {
-        get current() {
-            return dataOffset;
-        },
-        set current(value) {
-            dataOffset = value;
-        },
-    };
-    const currentCodeSegmentTagRef = {
-        get current() {
-            return currentCodeSegmentTag;
-        },
-        set current(value) {
-            currentCodeSegmentTag = value;
-        },
-    };
-    const generatedLabelCounterRef = {
-        get current() {
-            return generatedLabelCounter;
-        },
-        set current(value) {
-            generatedLabelCounter = value;
-        },
-    };
-    const getCurrentCodeOffset = () => codeOffset;
-    const setCurrentCodeOffset = (value) => {
-        codeOffset = value;
-    };
-    const setCurrentCodeByte = (offset, value) => {
-        ctx.codeBytes.set(offset, value);
-    };
-    const pushCurrentFixup = (fixup) => {
-        ctx.fixups.push(fixup);
-    };
-    const pushCurrentRel8Fixup = (fixup) => {
-        ctx.rel8Fixups.push(fixup);
-    };
-    const advanceAlign = (a) => {
-        switch (activePlacement) {
-            case 'code':
-                codeOffset = ctx.alignTo(codeOffset, a);
-                return;
-            case 'data':
-                dataOffset = ctx.alignTo(dataOffset, a);
-                return;
-        }
-    };
-    const { flushTrailingUserComments, lowerImmExprForLoweredAsm, lowerOperandForLoweredAsm, recordLoweredAsmItem, } = createLoweredAsmStreamRecordingHelpers({
-        activePlacementRef,
-        loweredAsmBlocksByKey: ctx.loweredAsmBlocksByKey,
-        loweredAsmStream: ctx.loweredAsmStream,
-        ...(ctx.sourceLineComments ? { sourceLineComments: ctx.sourceLineComments } : {}),
-        ...(ctx.sourceTexts ? { sourceTexts: ctx.sourceTexts } : {}),
-        evalImmNoDiag: ctx.evalImmNoDiag,
-        symbolicTargetFromExpr: ctx.symbolicTargetFromExpr,
-        formatImmExprForAsm: ctx.formatImmExprForAsm,
-        typeDisplay: ctx.typeDisplay,
-    });
-    const traceLabel = (_offset, name, span) => {
-        recordLoweredAsmItem({ kind: 'label', name }, span);
-    };
-    const traceComment = (_offset, text) => {
-        recordLoweredAsmItem({ kind: 'comment', text, origin: 'generated' });
-    };
-    return {
-        activePlacementRef,
-        codeOffsetRef,
-        dataOffsetRef,
-        currentCodeSegmentTagRef,
-        generatedLabelCounterRef,
-        getCurrentCodeOffset,
-        setCurrentCodeOffset,
-        setCurrentCodeByte,
-        pushCurrentFixup,
-        pushCurrentRel8Fixup,
-        recordCodeSourceRange,
-        traceLabel,
-        traceComment,
-        advanceAlign,
-        flushTrailingUserComments,
-        lowerImmExprForLoweredAsm,
-        lowerOperandForLoweredAsm,
-        recordLoweredAsmItem,
-    };
-}

package/dist/legacy-root-azm/src/lowering/fixupBaseResolution.d.ts

@@ -1,7 +0,0 @@
-import type { CompileEnv } from '../semantics/env.js';
-type FixupBaseResolver = (nameLower: string, visiting?: Set<string>) => number | undefined;
-export declare function createFixupBaseResolver(args: {
-    env: CompileEnv;
-    addrByNameLower: Map<string, number>;
-}): FixupBaseResolver;
-export {};

package/dist/legacy-root-azm/src/lowering/fixupBaseResolution.js

@@ -1,23 +0,0 @@
-import { parseNumberLiteral } from '../frontend/parseImm.js';
-import { resolveAsmEquSymbol } from './asmEquResolution.js';
-export function createFixupBaseResolver(args) {
-    const { env, addrByNameLower } = args;
-    return (nameLower, visiting = new Set()) => {
-        const sym = addrByNameLower.get(nameLower);
-        if (sym !== undefined)
-            return sym;
-        const literal = parseNumberLiteral(nameLower);
-        if (literal !== undefined)
-            return literal;
-        if (/^-?[0-9]+$/.test(nameLower))
-            return Number.parseInt(nameLower, 10);
-        return resolveAsmEquSymbol(nameLower, {
-            env,
-            lookupSymbol: (name) => addrByNameLower.get(name),
-            cacheResolved: (name, value) => {
-                addrByNameLower.set(name, value);
-                env.equates.set(name, value);
-            },
-        }, visiting);
-    };
-}

package/dist/legacy-root-azm/src/lowering/fixupEmission.d.ts

@@ -1,64 +0,0 @@
-import type { AsmOperandNode, ImmExprNode, SourceSpan } from '../frontend/ast.js';
-type FixupRecord = {
-    /** Patch offset in code. */
-    offset: number;
-    /** Target symbol (lowercased). */
-    baseLower: string;
-    /** Byte addend. */
-    addend: number;
-    /** Owning file. */
-    file: string;
-};
-type Rel8FixupRecord = {
-    /** Patch offset. */
-    offset: number;
-    /** Branch origin. */
-    origin: number;
-    /** Target symbol. */
-    baseLower: string;
-    /** Addend. */
-    addend: number;
-    /** Owning file. */
-    file: string;
-    /** Mnemonic for diagnostics. */
-    mnemonic: string;
-};
-type EvalImmExpr = (expr: ImmExprNode) => number | undefined;
-type TraceInstruction = (start: number, bytes: Uint8Array, asmText: string) => void;
-type FixupEmissionContext = {
-    /** Current code offset. */
-    getCodeOffset: () => number;
-    /** Sets code offset. */
-    setCodeOffset: (value: number) => void;
-    /** Writes a code byte. */
-    setCodeByte: (offset: number, value: number) => void;
-    /** Records source range for listing. */
-    recordCodeSourceRange: (start: number, end: number) => void;
-    /** Enqueues abs16 fixup. */
-    pushFixup: (fixup: FixupRecord) => void;
-    /** Enqueues rel8 fixup. */
-    pushRel8Fixup: (fixup: Rel8FixupRecord) => void;
-    /** Trace hook for raw emission. */
-    traceInstruction: TraceInstruction;
-    /** Optional lowered-instr recorder for asm trace. */
-    recordLoweredInstr?: (bytes: Uint8Array, asmText: string, span: SourceSpan) => void;
-    /** Const imm evaluation. */
-    evalImmExpr: EvalImmExpr;
-};
-export declare function createFixupEmissionHelpers(ctx: FixupEmissionContext): {
-    callConditionOpcodeFromName: (nameRaw: string) => number | undefined;
-    conditionNameFromOpcode: (opcode: number) => string | undefined;
-    conditionOpcode: (op: AsmOperandNode) => number | undefined;
-    conditionOpcodeFromName: (nameRaw: string) => number | undefined;
-    emitAbs16Fixup: (opcode: number, baseLower: string, addend: number, span: SourceSpan, asmText?: string) => void;
-    emitAbs16FixupEd: (opcode2: number, baseLower: string, addend: number, span: SourceSpan, asmText?: string) => void;
-    emitAbs16FixupPrefixed: (prefix: number, opcode2: number, baseLower: string, addend: number, span: SourceSpan, asmText?: string) => void;
-    emitRel8Fixup: (opcode: number, baseLower: string, addend: number, span: SourceSpan, mnemonic: string, asmText?: string) => void;
-    inverseConditionName: (nameRaw: string) => string | undefined;
-    jrConditionOpcodeFromName: (nameRaw: string) => number | undefined;
-    symbolicTargetFromExpr: (expr: ImmExprNode) => {
-        baseLower: string;
-        addend: number;
-    } | undefined;
-};
-export {};