@jhlagado/azm 0.2.1 → 0.2.2

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

@@ -1,128 +0,0 @@
-import { DiagnosticIds } from '../diagnosticTypes.js';
-export function createAssemblerFlowSetupHelpers({ diagnostics, diagAt, diagAtWithId, getCurrentCodeSegmentTag, setCurrentCodeSegmentTag, taken, traceLabel, pending, getCodeOffset, emitInstr, generatedLabelCounterRef, formatAsmOperandForOpDiag, }) {
-    const currentOpExpansionFrame = (opExpansionStack) => opExpansionStack.length > 0 ? opExpansionStack[opExpansionStack.length - 1] : undefined;
-    const rootOpExpansionFrame = (opExpansionStack) => opExpansionStack.length > 0 ? opExpansionStack[0] : undefined;
-    const currentMacroCallSiteSpan = (opExpansionStack) => rootOpExpansionFrame(opExpansionStack)?.callSiteSpan;
-    const formatInstructionForOpExpansionDiag = (inst) => {
-        const ops = inst.operands.map(formatAsmOperandForOpDiag).join(', ');
-        return ops.length > 0 ? `${inst.head} ${ops}` : inst.head;
-    };
-    const appendInvalidOpExpansionDiagnostic = (inst, diagnosticsStart, opExpansionStack) => {
-        const frame = currentOpExpansionFrame(opExpansionStack);
-        if (!frame)
-            return;
-        const rootFrame = rootOpExpansionFrame(opExpansionStack);
-        const newDiagnostics = diagnostics.slice(diagnosticsStart);
-        const hasConcreteInstructionFailure = newDiagnostics.some((d) => d.severity === 'error' &&
-            (d.id === DiagnosticIds.EncodeError || d.id === DiagnosticIds.EmitError));
-        if (!hasConcreteInstructionFailure)
-            return;
-        if (newDiagnostics.some((d) => d.id === DiagnosticIds.OpInvalidExpansion ||
-            d.id === DiagnosticIds.OpArityMismatch ||
-            d.id === DiagnosticIds.OpNoMatchingOverload ||
-            d.id === DiagnosticIds.OpAmbiguousOverload ||
-            d.id === DiagnosticIds.OpExpansionCycle)) {
-            return;
-        }
-        const expansionChain = opExpansionStack
-            .map((entry) => `${entry.name} (${entry.declSpan.file}:${entry.declSpan.start.line})`)
-            .join(' -> ');
-        diagAtWithId(diagnostics, rootFrame?.callSiteSpan ?? frame.callSiteSpan, DiagnosticIds.OpInvalidExpansion, `Invalid op expansion in "${frame.name}" at call site.\n` +
-            `expanded instruction: ${formatInstructionForOpExpansionDiag(inst)}\n` +
-            `op definition: ${frame.declSpan.file}:${frame.declSpan.start.line}\n` +
-            `expansion chain: ${expansionChain}`);
-    };
-    const sourceTagForSpan = (span, opExpansionStack) => {
-        const macroCallSite = currentMacroCallSiteSpan(opExpansionStack);
-        const taggedSpan = macroCallSite ?? span;
-        return {
-            file: taggedSpan.file,
-            line: taggedSpan.start.line,
-            column: taggedSpan.start.column,
-            kind: macroCallSite ? 'macro' : 'code',
-            confidence: 'high',
-        };
-    };
-    const withCodeSourceTag = (tag, fn) => {
-        const prev = getCurrentCodeSegmentTag();
-        setCurrentCodeSegmentTag(tag);
-        try {
-            return fn();
-        }
-        finally {
-            setCurrentCodeSegmentTag(prev);
-        }
-    };
-    const syncFromFlow = (flow, tracked) => {
-        tracked.delta = flow.spDelta;
-        tracked.valid = flow.spValid;
-        tracked.invalid = flow.spInvalidDueToMutation;
-    };
-    const syncToFlow = (flow, tracked) => {
-        flow.spDelta = tracked.delta;
-        flow.spValid = tracked.valid;
-        flow.spInvalidDueToMutation = tracked.invalid;
-    };
-    const newHiddenLabel = (prefix) => {
-        let n = `${prefix}_${generatedLabelCounterRef.current++}`;
-        while (taken.has(n)) {
-            n = `${prefix}_${generatedLabelCounterRef.current++}`;
-        }
-        return n;
-    };
-    const defineCodeLabel = (name, span, scope) => {
-        if (taken.has(name)) {
-            diagAt(diagnostics, span, `Duplicate symbol name "${name}".`);
-            return;
-        }
-        taken.add(name);
-        traceLabel(getCodeOffset(), name, span);
-        pending.push({
-            kind: 'label',
-            name,
-            placement: 'code',
-            offset: getCodeOffset(),
-            file: span.file,
-            line: span.start.line,
-            scope,
-        });
-    };
-    const emitVirtualReg16Transfer = (asmItem) => {
-        if (asmItem.head.toLowerCase() !== 'ld' || asmItem.operands.length !== 2)
-            return false;
-        const dstOp = asmItem.operands[0];
-        const srcOp = asmItem.operands[1];
-        if (dstOp.kind !== 'Reg' || srcOp.kind !== 'Reg')
-            return false;
-        const dst = dstOp.name.toUpperCase();
-        const src = srcOp.name.toUpperCase();
-        const supported = new Set(['BC', 'DE', 'HL']);
-        if (!supported.has(dst) || !supported.has(src) || dst === src)
-            return false;
-        const hi = (reg16) => reg16 === 'BC' ? 'B' : reg16 === 'DE' ? 'D' : 'H';
-        const lo = (reg16) => reg16 === 'BC' ? 'C' : reg16 === 'DE' ? 'E' : 'L';
-        emitInstr('ld', [
-            { kind: 'Reg', span: asmItem.span, name: hi(dst) },
-            { kind: 'Reg', span: asmItem.span, name: hi(src) },
-        ], asmItem.span);
-        emitInstr('ld', [
-            { kind: 'Reg', span: asmItem.span, name: lo(dst) },
-            { kind: 'Reg', span: asmItem.span, name: lo(src) },
-        ], asmItem.span);
-        return true;
-    };
-    return {
-        currentOpExpansionFrame,
-        rootOpExpansionFrame,
-        currentMacroCallSiteSpan,
-        formatInstructionForOpExpansionDiag,
-        appendInvalidOpExpansionDiagnostic,
-        sourceTagForSpan,
-        withCodeSourceTag,
-        syncFromFlow,
-        syncToFlow,
-        newHiddenLabel,
-        defineCodeLabel,
-        emitVirtualReg16Transfer,
-    };
-}

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

@@ -1,151 +0,0 @@
-import type { Diagnostic, DiagnosticId } from '../diagnosticTypes.js';
-import type { AsmInstructionNode, AsmOperandNode, EaExprNode, ImmExprNode, OpDeclNode, SourceSpan, TypeExprNode } from '../frontend/ast.js';
-import type { CompileEnv } from '../semantics/env.js';
-import type { PendingSymbol, ResolvedArrayType, SourceSegmentTag } from './loweringTypes.js';
-import type { OpOverloadSelection } from './opMatching.js';
-import type { EaResolution } from './eaResolution.js';
-import type { AggregateType, ScalarKind } from '../semantics/typeQueries.js';
-export type AssemblerLoweringDiagnosticsContext = {
-    /** Set by: emit/context construction. Mutated by: flow setup, op call expansion, asm instruction lowering, instruction-stream lowering. */
-    readonly diagnostics: Diagnostic[];
-    /** Set by: emit/context construction. Used by: flow setup. */
-    readonly diag: (diagnostics: Diagnostic[], file: string, message: string) => void;
-    /** Set by: emit/context construction. Used by: flow setup, op call expansion, asm instruction lowering, instruction-stream lowering. */
-    readonly diagAt: (diagnostics: Diagnostic[], span: SourceSpan, message: string) => void;
-    /** Set by: emit/context construction. Used by: flow setup, op call expansion. */
-    readonly diagAtWithId: (diagnostics: Diagnostic[], span: SourceSpan, id: DiagnosticId, message: string) => void;
-    /** Set by: emit/context construction. Used by: op call expansion, asm instruction lowering. */
-    readonly diagAtWithSeverityAndId: (diagnostics: Diagnostic[], span: SourceSpan, id: DiagnosticId, severity: 'error' | 'warning', message: string) => void;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly warnAt: (diagnostics: Diagnostic[], span: SourceSpan, message: string) => void;
-};
-export type AssemblerLoweringSymbolContext = {
-    /** Set by: emit/context construction. Mutated by: flow setup. Used by: flow setup. */
-    readonly taken: Set<string>;
-    /** Set by: emit/context construction. Mutated by: flow setup, instruction-stream lowering. Used by: flow setup, instruction-stream lowering. */
-    readonly pending: PendingSymbol[];
-    /** Set by: emit/context construction. Used by: flow setup. */
-    readonly traceComment: (offset: number, text: string) => void;
-    /** Set by: emit/context construction. Used by: flow setup, instruction-stream lowering. */
-    readonly traceLabel: (offset: number, name: string, span?: SourceSpan) => void;
-    /** Set by: emit/context construction. Mutated while lowering ASM source instructions and op expansions. */
-    readonly currentCodeSegmentTagRef: {
-        current: SourceSegmentTag | undefined;
-    };
-    /** Set by: emit/context construction. Mutated by: flow setup. Used by: flow setup. */
-    readonly generatedLabelCounterRef: {
-        current: number;
-    };
-};
-export type AssemblerLoweringSpTrackingContext = {
-    /** Set by: emit/context construction. Used by: flow setup. */
-    readonly bindSpTracking: (callbacks?: {
-        applySpTracking: (headRaw: string, operands: AsmOperandNode[]) => void;
-        invalidateSpTracking: () => void;
-    } | undefined) => void;
-};
-export type AssemblerLoweringEmissionContext = {
-    /** Set by: emit/context construction. Used by: flow setup. */
-    readonly getCodeOffset: () => number;
-    /** Set by: emit/context construction. Used by: asm preparation, flow setup, op call expansion, asm instruction lowering, instruction-stream lowering. */
-    readonly emitInstr: (head: string, operands: AsmOperandNode[], span: SourceSpan) => boolean;
-    /** Set by: emit/context construction. Used by: flow setup, op call expansion, asm instruction lowering. */
-    readonly emitRawCodeBytes: (bs: Uint8Array, file: string, traceText: string) => void;
-    /** Set by: emit/context construction. Used by: flow setup and op expansion. */
-    readonly emitAbs16Fixup: (opcode: number, baseLower: string, addend: number, span: SourceSpan, asmText?: string) => void;
-    /** Set by: emit/context construction. Used by: asm instruction lowering. */
-    readonly emitAbs16FixupPrefixed: (prefix: number, opcode2: number, baseLower: string, addend: number, span: SourceSpan, asmText?: string) => void;
-    /** Set by: emit/context construction. Used by: asm instruction lowering. */
-    readonly emitRel8Fixup: (opcode: number, baseLower: string, addend: number, span: SourceSpan, mnemonic: string) => void;
-};
-export type AssemblerLoweringConditionContext = {
-    /** Set by: emit/context construction. Used by: flow setup and asm instruction lowering. */
-    readonly conditionOpcodeFromName: (name: string) => number | undefined;
-    /** Set by: emit/context construction. Used by: flow setup. */
-    readonly conditionNameFromOpcode: (opcode: number) => string | undefined;
-    /** Set by: emit/context construction. Used by: asm instruction lowering. */
-    readonly callConditionOpcodeFromName: (name: string) => number | undefined;
-    /** Set by: emit/context construction. Used by: asm instruction lowering. */
-    readonly jrConditionOpcodeFromName: (name: string) => number | undefined;
-    /** Set by: emit/context construction. Used by: asm instruction lowering. */
-    readonly conditionOpcode: (operand: AsmOperandNode) => number | undefined;
-    /** Set by: emit/context construction. Used by: flow setup and op expansion. */
-    readonly inverseConditionName: (name: string) => string | undefined;
-    /** Set by: emit/context construction. Used by: asm preparation and asm instruction lowering. */
-    readonly symbolicTargetFromExpr: (expr: ImmExprNode) => {
-        baseLower: string;
-        addend: number;
-    } | undefined;
-};
-export type AssemblerLoweringTypeContext = {
-    /** Set by: emit/context construction. Used by: asm preparation, flow setup, op call expansion. */
-    readonly evalImmExpr: (expr: ImmExprNode, env: CompileEnv, diagnostics: Diagnostic[]) => number | undefined;
-    /** Set by: emit/context construction. Used by: asm preparation, flow setup, op call expansion. */
-    readonly env: CompileEnv;
-    /** Set by: emit/context construction. Used by: asm preparation, flow setup, op call expansion. */
-    readonly resolveScalarKind: (typeExpr: TypeExprNode) => ScalarKind | undefined;
-    /** Set by: emit/context construction. Used by: flow setup (layout pointer symbols). */
-    readonly resolveAggregateType: (typeExpr: TypeExprNode) => AggregateType | undefined;
-    /** Set by: emit/context construction. Used by: flow setup and op expansion. */
-    readonly resolveEaTypeExpr: (ea: EaExprNode) => TypeExprNode | undefined;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly resolveArrayType: (typeExpr: TypeExprNode, env?: CompileEnv) => ResolvedArrayType | undefined;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly typeDisplay: (typeExpr: TypeExprNode) => string;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly sameTypeShape: (left: TypeExprNode, right: TypeExprNode) => boolean;
-};
-export type AssemblerLoweringAddressingContext = {
-    /** Set by: emit/context construction. Used by: asm instruction lowering. */
-    readonly resolveEa: (ea: EaExprNode, span: SourceSpan) => EaResolution | undefined;
-    /** Set by: emit/context construction. Used by: asm instruction lowering. */
-    readonly lowerLdWithEa: (asmItem: AsmInstructionNode) => boolean;
-};
-export type AssemblerLoweringOpResolutionContext = {
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly resolveOpCandidates: (name: string, file: string) => OpDeclNode[] | undefined;
-};
-export type AssemblerLoweringOpOverloadContext = {
-    /** Set by: emit/context construction. Used by: flow setup and op expansion. */
-    readonly formatAsmOperandForOpDiag: (operand: AsmOperandNode) => string;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly selectOpOverload: (overloads: OpDeclNode[], operands: AsmOperandNode[]) => OpOverloadSelection;
-};
-export type AssemblerLoweringAstUtilityContext = {
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly cloneImmExpr: (expr: ImmExprNode) => ImmExprNode;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly cloneEaExpr: (expr: EaExprNode) => EaExprNode;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly cloneOperand: (operand: AsmOperandNode) => AsmOperandNode;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly flattenEaDottedName: (ea: EaExprNode) => string | undefined;
-    /** Set by: emit/context construction. Used by: op call expansion. */
-    readonly normalizeFixedToken: (operand: AsmOperandNode) => string | undefined;
-};
-export type AssemblerLoweringRegisterContext = {
-    /** Set by: emit/context construction. Used by: flow setup and op expansion. */
-    readonly reg8: Set<string>;
-    /** Set by: emit/context construction. Used by: op call expansion and asm instruction lowering. */
-    readonly reg16: Set<string>;
-};
-export type AssemblerLoweringSharedContext = AssemblerLoweringDiagnosticsContext & AssemblerLoweringSymbolContext & AssemblerLoweringSpTrackingContext & AssemblerLoweringEmissionContext & AssemblerLoweringConditionContext & AssemblerLoweringTypeContext & AssemblerLoweringAddressingContext & AssemblerLoweringOpResolutionContext & AssemblerLoweringOpOverloadContext & AssemblerLoweringAstUtilityContext & AssemblerLoweringRegisterContext;
-/**
- * The named slices that merge into {@link AssemblerLoweringSharedContext}. Emit wiring
- * (`emitContextBuilder`) and phase code pass these groups instead of a single flat field bag (#1316).
- */
-export type AssemblerLoweringComponentContexts = {
-    readonly diagnostics: AssemblerLoweringDiagnosticsContext;
-    readonly symbols: AssemblerLoweringSymbolContext;
-    readonly spTracking: AssemblerLoweringSpTrackingContext;
-    readonly emission: AssemblerLoweringEmissionContext;
-    readonly conditions: AssemblerLoweringConditionContext;
-    readonly types: AssemblerLoweringTypeContext;
-    readonly addressing: AssemblerLoweringAddressingContext;
-    readonly opResolution: AssemblerLoweringOpResolutionContext;
-    readonly opOverload: AssemblerLoweringOpOverloadContext;
-    readonly astUtilities: AssemblerLoweringAstUtilityContext;
-    readonly registers: AssemblerLoweringRegisterContext;
-};
-/** Merge named sub-contexts into the flat intersection used at lowering boundaries. */
-export declare function mergeAssemblerLoweringSharedContext(parts: Readonly<AssemblerLoweringComponentContexts>): AssemblerLoweringSharedContext;

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

@@ -1,16 +0,0 @@
-/** Merge named sub-contexts into the flat intersection used at lowering boundaries. */
-export function mergeAssemblerLoweringSharedContext(parts) {
-    return {
-        ...parts.diagnostics,
-        ...parts.symbols,
-        ...parts.spTracking,
-        ...parts.emission,
-        ...parts.conditions,
-        ...parts.types,
-        ...parts.addressing,
-        ...parts.opResolution,
-        ...parts.opOverload,
-        ...parts.astUtilities,
-        ...parts.registers,
-    };
-}

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

@@ -1,7 +0,0 @@
-/**
- * Split {@link AssemblerLoweringSharedContext} into named slices (#1316).
- * Lives in its own module so {@link import('./assemblerLoweringPhases.js')} can import without a
- * circular runtime dependency on {@link import('./assemblerLoweringContext.js')}.
- */
-import type { AssemblerLoweringComponentContexts, AssemblerLoweringSharedContext } from './assemblerLoweringContext.js';
-export declare function splitAssemblerLoweringSharedContext(shared: AssemblerLoweringSharedContext): AssemblerLoweringComponentContexts;

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

@@ -1,75 +0,0 @@
-/**
- * Split {@link AssemblerLoweringSharedContext} into named slices (#1316).
- * Lives in its own module so {@link import('./assemblerLoweringPhases.js')} can import without a
- * circular runtime dependency on {@link import('./assemblerLoweringContext.js')}.
- */
-export function splitAssemblerLoweringSharedContext(shared) {
-    return {
-        diagnostics: {
-            diagnostics: shared.diagnostics,
-            diag: shared.diag,
-            diagAt: shared.diagAt,
-            diagAtWithId: shared.diagAtWithId,
-            diagAtWithSeverityAndId: shared.diagAtWithSeverityAndId,
-            warnAt: shared.warnAt,
-        },
-        symbols: {
-            taken: shared.taken,
-            pending: shared.pending,
-            traceComment: shared.traceComment,
-            traceLabel: shared.traceLabel,
-            currentCodeSegmentTagRef: shared.currentCodeSegmentTagRef,
-            generatedLabelCounterRef: shared.generatedLabelCounterRef,
-        },
-        spTracking: { bindSpTracking: shared.bindSpTracking },
-        emission: {
-            getCodeOffset: shared.getCodeOffset,
-            emitInstr: shared.emitInstr,
-            emitRawCodeBytes: shared.emitRawCodeBytes,
-            emitAbs16Fixup: shared.emitAbs16Fixup,
-            emitAbs16FixupPrefixed: shared.emitAbs16FixupPrefixed,
-            emitRel8Fixup: shared.emitRel8Fixup,
-        },
-        conditions: {
-            conditionOpcodeFromName: shared.conditionOpcodeFromName,
-            conditionNameFromOpcode: shared.conditionNameFromOpcode,
-            callConditionOpcodeFromName: shared.callConditionOpcodeFromName,
-            jrConditionOpcodeFromName: shared.jrConditionOpcodeFromName,
-            conditionOpcode: shared.conditionOpcode,
-            inverseConditionName: shared.inverseConditionName,
-            symbolicTargetFromExpr: shared.symbolicTargetFromExpr,
-        },
-        types: {
-            evalImmExpr: shared.evalImmExpr,
-            env: shared.env,
-            resolveScalarKind: shared.resolveScalarKind,
-            resolveAggregateType: shared.resolveAggregateType,
-            resolveEaTypeExpr: shared.resolveEaTypeExpr,
-            resolveArrayType: shared.resolveArrayType,
-            typeDisplay: shared.typeDisplay,
-            sameTypeShape: shared.sameTypeShape,
-        },
-        addressing: {
-            resolveEa: shared.resolveEa,
-            lowerLdWithEa: shared.lowerLdWithEa,
-        },
-        opResolution: {
-            resolveOpCandidates: shared.resolveOpCandidates,
-        },
-        opOverload: {
-            formatAsmOperandForOpDiag: shared.formatAsmOperandForOpDiag,
-            selectOpOverload: shared.selectOpOverload,
-        },
-        astUtilities: {
-            cloneImmExpr: shared.cloneImmExpr,
-            cloneEaExpr: shared.cloneEaExpr,
-            cloneOperand: shared.cloneOperand,
-            flattenEaDottedName: shared.flattenEaDottedName,
-            normalizeFixedToken: shared.normalizeFixedToken,
-        },
-        registers: {
-            reg8: shared.reg8,
-            reg16: shared.reg16,
-        },
-    };
-}

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

@@ -1,66 +0,0 @@
-import type { SourceSegmentTag } from './loweringTypes.js';
-import { createAssemblerFlowSetupHelpers, type FlowState, type OpExpansionFrame } from './assemblerFlowSetup.js';
-import { createAsmInstructionStreamHelpers } from './asmInstructionStream.js';
-import type { AssemblerLoweringSharedContext } from './assemblerLoweringContext.js';
-export interface AssemblerInstructionSetup {
-    /** Shared assembler-lowering context. */
-    readonly ctx: AssemblerLoweringSharedContext;
-    /** Shared diagnostic list. */
-    readonly diagnostics: AssemblerLoweringSharedContext['diagnostics'];
-    /** Pending forward symbols. */
-    readonly pending: AssemblerLoweringSharedContext['pending'];
-    /** Trace hook for comments. */
-    readonly traceComment: AssemblerLoweringSharedContext['traceComment'];
-    /** Trace hook for labels. */
-    readonly traceLabel: AssemblerLoweringSharedContext['traceLabel'];
-    /** Registers SP tracking callbacks for asm emission. */
-    readonly bindSpTracking: AssemblerLoweringSharedContext['bindSpTracking'];
-    /** Current emitted code offset. */
-    readonly getCodeOffset: AssemblerLoweringSharedContext['getCodeOffset'];
-    /** General instruction emitter. */
-    readonly emitInstr: AssemblerLoweringSharedContext['emitInstr'];
-    /** Active source segment tag for listing, if any. */
-    readonly getCurrentCodeSegmentTag: () => SourceSegmentTag | undefined;
-    /** Sets active source segment tag; `undefined` clears. */
-    readonly setCurrentCodeSegmentTag: (tag: SourceSegmentTag | undefined) => void;
-}
-interface AssemblerFlowPhase {
-    /** SP tracking summary: `invalid` when analysis cannot trust SP. */
-    readonly trackedSp: {
-        valid: boolean;
-        delta: number;
-        invalid: boolean;
-    };
-    /** Nested op-expansion frames for inline op diagnostics. */
-    readonly opExpansionStack: OpExpansionFrame[];
-    /** Reads current flow state. */
-    readonly getFlow: () => FlowState;
-    /** Replaces flow state (e.g. after branches). */
-    readonly setFlow: (state: FlowState) => void;
-    /** Mutable ref to the active flow state. */
-    readonly flowRef: {
-        readonly current: FlowState;
-    };
-    /** Pulls flow-local flags from `flowRef` into lowering scratch state. */
-    readonly syncFromFlow: () => void;
-    /** Pushes lowering scratch state back into `flowRef`. */
-    readonly syncToFlow: () => void;
-    /** Emits diagnostic for invalid inline op expansion. */
-    readonly appendInvalidOpExpansionDiagnostic: ReturnType<typeof createAssemblerFlowSetupHelpers>['appendInvalidOpExpansionDiagnostic'];
-    /** Maps a source span to a segment tag for tracing. */
-    readonly sourceTagForSpan: ReturnType<typeof createAssemblerFlowSetupHelpers>['sourceTagForSpan'];
-    /** Runs a callback with a bound code-source tag. */
-    readonly withCodeSourceTag: ReturnType<typeof createAssemblerFlowSetupHelpers>['withCodeSourceTag'];
-    /** Allocates a fresh compiler-generated label name. */
-    readonly newHiddenLabel: ReturnType<typeof createAssemblerFlowSetupHelpers>['newHiddenLabel'];
-    /** Defines a code label at the current offset. */
-    readonly defineCodeLabel: ReturnType<typeof createAssemblerFlowSetupHelpers>['defineCodeLabel'];
-    /** Virtual 16-bit register move (lowering helper). */
-    readonly emitVirtualReg16Transfer: ReturnType<typeof createAssemblerFlowSetupHelpers>['emitVirtualReg16Transfer'];
-}
-export declare function prepareAssemblerInstructionSetupPhase(ctx: AssemblerLoweringSharedContext): AssemblerInstructionSetup;
-/** Flow helpers for explicit ASM source. */
-export declare function createAsmSourceFlowPhase(setup: AssemblerInstructionSetup): AssemblerFlowPhase;
-/** Instruction emitter bundle shared by op bodies and ASM source. */
-export declare function createAssemblerInstructionEmitters(setup: AssemblerInstructionSetup, flow: AssemblerFlowPhase): ReturnType<typeof createAsmInstructionStreamHelpers>;
-export {};

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

@@ -1,166 +0,0 @@
-import { evalImmExpr as evalImmExprWithEnv } from '../semantics/env.js';
-import { createAsmInstructionLoweringHelpers } from './asmInstructionLowering.js';
-import { createAssemblerFlowSetupHelpers, } from './assemblerFlowSetup.js';
-import { createAsmInstructionStreamHelpers } from './asmInstructionStream.js';
-import { splitAssemblerLoweringSharedContext } from './assemblerLoweringContextSplit.js';
-import { placementAddressAtOffset } from './asmDirectiveTraversal.js';
-export function prepareAssemblerInstructionSetupPhase(ctx) {
-    const { diagnostics, pending, traceComment, traceLabel, currentCodeSegmentTagRef, bindSpTracking, getCodeOffset, emitInstr: emitInstrBase, } = ctx;
-    let currentCodeSegmentTag = currentCodeSegmentTagRef.current;
-    const setCurrentCodeSegmentTag = (tag) => {
-        currentCodeSegmentTag = tag;
-        currentCodeSegmentTagRef.current = tag;
-    };
-    const emitInstr = emitInstrBase;
-    return {
-        ctx,
-        diagnostics,
-        pending,
-        traceComment,
-        traceLabel,
-        bindSpTracking,
-        getCodeOffset,
-        emitInstr,
-        getCurrentCodeSegmentTag: () => currentCodeSegmentTag,
-        setCurrentCodeSegmentTag,
-    };
-}
-function buildAssemblerFlowPhase(setup, flowInit) {
-    const { ctx: { diagnostics, diagAt, diagAtWithId, formatAsmOperandForOpDiag, generatedLabelCounterRef, taken, }, pending, traceLabel, getCodeOffset, emitInstr, getCurrentCodeSegmentTag, setCurrentCodeSegmentTag, } = setup;
-    const { trackedSp } = flowInit;
-    let flow = {
-        reachable: true,
-        spDelta: 0,
-        spValid: true,
-        spInvalidDueToMutation: false,
-    };
-    const flowRef = {
-        get current() {
-            return flow;
-        },
-    };
-    const opExpansionStack = [];
-    const { appendInvalidOpExpansionDiagnostic, sourceTagForSpan, withCodeSourceTag, syncFromFlow: syncFromFlowBase, syncToFlow: syncToFlowBase, newHiddenLabel, defineCodeLabel, emitVirtualReg16Transfer, } = createAssemblerFlowSetupHelpers({
-        diagnostics,
-        diagAt,
-        diagAtWithId,
-        getCurrentCodeSegmentTag,
-        setCurrentCodeSegmentTag,
-        taken,
-        traceLabel,
-        pending,
-        getCodeOffset,
-        emitInstr,
-        generatedLabelCounterRef,
-        formatAsmOperandForOpDiag,
-    });
-    const syncFromFlow = () => {
-        syncFromFlowBase(flow, trackedSp);
-    };
-    const syncToFlow = () => {
-        syncToFlowBase(flow, trackedSp);
-    };
-    return {
-        trackedSp,
-        opExpansionStack,
-        getFlow: () => flow,
-        setFlow: (state) => {
-            flow = state;
-        },
-        flowRef,
-        syncFromFlow,
-        syncToFlow,
-        appendInvalidOpExpansionDiagnostic,
-        sourceTagForSpan,
-        withCodeSourceTag,
-        newHiddenLabel,
-        defineCodeLabel,
-        emitVirtualReg16Transfer,
-    };
-}
-/** Flow helpers for explicit ASM source. */
-export function createAsmSourceFlowPhase(setup) {
-    setup.bindSpTracking(undefined);
-    return buildAssemblerFlowPhase(setup, {
-        trackedSp: { delta: 0, valid: true, invalid: false },
-    });
-}
-/** Instruction emitter bundle shared by op bodies and ASM source. */
-export function createAssemblerInstructionEmitters(setup, flow) {
-    const fp = splitAssemblerLoweringSharedContext(setup.ctx);
-    const { emitInstr, getCurrentCodeSegmentTag, setCurrentCodeSegmentTag } = setup;
-    const diagnostics = fp.diagnostics.diagnostics;
-    const currentInstructionAddress = () => {
-        const maybeLoweringContext = setup.ctx;
-        if (maybeLoweringContext.baseExprs) {
-            return placementAddressAtOffset(maybeLoweringContext, 'code', setup.getCodeOffset()) ?? setup.getCodeOffset();
-        }
-        return setup.getCodeOffset();
-    };
-    const { lowerAsmInstructionDispatcher } = createAsmInstructionLoweringHelpers({
-        ...fp.diagnostics,
-        ...fp.emission,
-        ...fp.conditions,
-        ...fp.types,
-        ...fp.addressing,
-        ...fp.opResolution,
-        ...fp.opOverload,
-        ...fp.astUtilities,
-        ...fp.registers,
-        emitInstr,
-        symbolicTargetFromExpr: fp.conditions.symbolicTargetFromExpr,
-        evalImmExpr: (expr) => fp.types.evalImmExpr(expr, fp.types.env, diagnostics),
-        currentAddress: currentInstructionAddress,
-        evalCurrentTarget: (expr) => {
-            const currentLocation = currentInstructionAddress();
-            const target = evalImmExprWithEnv(expr, fp.types.env, diagnostics, { currentLocation });
-            return target;
-        },
-        resolveRawAliasTargetName: () => undefined,
-        resolveEa: fp.addressing.resolveEa,
-        diagIfRetStackImbalanced: (span, mnemonic) => {
-            if (flow.trackedSp.valid && flow.trackedSp.delta !== 0) {
-                fp.diagnostics.diagAt(diagnostics, span, `${mnemonic ?? 'ret'} with non-zero tracked stack delta (${flow.trackedSp.delta}); assembler stack is imbalanced.`);
-                return;
-            }
-            return;
-        },
-        diagIfCallStackUnverifiable: (options) => {
-            void options;
-        },
-        emitVirtualReg16Transfer: flow.emitVirtualReg16Transfer,
-        syncToFlow: flow.syncToFlow,
-        flowRef: flow.flowRef,
-    });
-    return createAsmInstructionStreamHelpers({
-        diagnostics,
-        asmItemSpanSourceTag: (span) => flow.sourceTagForSpan(span, flow.opExpansionStack),
-        getCurrentCodeSegmentTag,
-        setCurrentCodeSegmentTag,
-        appendInvalidOpExpansionDiagnostic: flow.appendInvalidOpExpansionDiagnostic,
-        addressing: {
-            flattenEaDottedName: fp.astUtilities.flattenEaDottedName,
-        },
-        diagAt: fp.diagnostics.diagAt,
-        diagAtWithSeverityAndId: fp.diagnostics.diagAtWithSeverityAndId,
-        env: fp.types.env,
-        emitInstr,
-        emitAbs16Fixup: fp.emission.emitAbs16Fixup,
-        syncToFlow: flow.syncToFlow,
-        resolveOpCandidates: fp.opResolution.resolveOpCandidates,
-        opExpansionStack: flow.opExpansionStack,
-        diagAtWithId: fp.diagnostics.diagAtWithId,
-        formatAsmOperandForOpDiag: (operand) => fp.opOverload.formatAsmOperandForOpDiag(operand) ?? '?',
-        selectOpOverload: fp.opOverload.selectOpOverload,
-        cloneImmExpr: fp.astUtilities.cloneImmExpr,
-        cloneEaExpr: fp.astUtilities.cloneEaExpr,
-        cloneOperand: fp.astUtilities.cloneOperand,
-        normalizeFixedToken: fp.astUtilities.normalizeFixedToken,
-        inverseConditionName: fp.conditions.inverseConditionName,
-        newHiddenLabel: flow.newHiddenLabel,
-        lowerAsmInstructionDispatcher,
-        defineCodeLabel: flow.defineCodeLabel,
-        flowRef: flow.flowRef,
-        syncFromFlow: flow.syncFromFlow,
-    });
-}

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

@@ -1,7 +0,0 @@
-import type { AddressRange, EmittedSourceSegment } from '../formats/types.js';
-type LayoutDiag = (message: string) => void;
-export declare function alignTo(n: number, alignment: number): number;
-export declare function writeBytePlacement(base: number, byteOffsets: Map<number, number>, bytes: Map<number, number>, report: LayoutDiag): void;
-export declare function computeWrittenRange(bytes: Map<number, number>): AddressRange;
-export declare function rebaseCodeSourceSegments(codeBase: number, segments: EmittedSourceSegment[]): EmittedSourceSegment[];
-export {};

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

@@ -1,37 +0,0 @@
-export function alignTo(n, alignment) {
-    return alignment <= 0 ? n : Math.ceil(n / alignment) * alignment;
-}
-export function writeBytePlacement(base, byteOffsets, bytes, report) {
-    for (const [offset, value] of byteOffsets) {
-        const addr = base + offset;
-        if (addr < 0 || addr > 0xffff) {
-            report(`Emitted byte address out of range: ${addr}.`);
-            continue;
-        }
-        if (bytes.has(addr)) {
-            report(`Byte overlap at address ${addr}.`);
-            continue;
-        }
-        bytes.set(addr, value);
-    }
-}
-export function computeWrittenRange(bytes) {
-    let min = Number.POSITIVE_INFINITY;
-    let max = Number.NEGATIVE_INFINITY;
-    for (const addr of bytes.keys()) {
-        min = Math.min(min, addr);
-        max = Math.max(max, addr);
-    }
-    return Number.isFinite(min) && Number.isFinite(max)
-        ? { start: min, end: max + 1 }
-        : { start: 0, end: 0 };
-}
-export function rebaseCodeSourceSegments(codeBase, segments) {
-    return segments
-        .map((segment) => ({
-        ...segment,
-        start: codeBase + segment.start,
-        end: codeBase + segment.end,
-    }))
-        .filter((segment) => segment.start >= 0 && segment.end <= 0x10000 && segment.end > segment.start);
-}