@jhlagado/azm 0.1.1 → 0.2.1

package/dist/src/cli.js

@@ -1,526 +1,25 @@
 #!/usr/bin/env node
-import { mkdir, writeFile } from 'node:fs/promises';
-import { dirname, extname, resolve } from 'node:path';
+import { realpathSync } from 'node:fs';
+import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { compile } from './compile.js';
-import { isSupportedSourcePath, sourceExtensions } from './frontend/sourceExtensions.js';
-import { defaultFormatWriters } from './formats/index.js';
-import { normalizePathForCompare } from './pathCompare.js';
-import { readPackageVersion } from './packageInfo.js';
-function usage() {
-    return [
-        'azm [options] <entry.asm|entry.z80>',
-        '',
-        'Options:',
-        '  -o, --output <file>   Primary output path (must match --type extension)',
-        '  -t, --type <type>     Primary output type: hex|bin (default: hex)',
-        '  -n, --nolist          Suppress .lst',
-        '      --nobin           Suppress .bin',
-        '      --nohex           Suppress .hex',
-        '      --nod8m           Suppress .d8.json',
-        '      --asm80           Emit assembler-valid lowered source (.z80)',
-        '      --source-root <d> Normalize D8 source paths relative to this directory',
-        '      --case-style <m>  Case-style lint mode: off|upper|lower|consistent',
-        '      --rc <m>            Register-care mode: off|audit|warn|error|strict',
-        '      --reg-report       Emit .regcare.txt report',
-        '      --reg-interface    Emit inferred register-care interface (.asmi)',
-        '      --fix             Apply conservative register-care source fixes',
-        '      --contracts       Update source AZM contract blocks in place',
-        '      --accept-out <r:c> Promote inferred output candidate while annotating',
-        '      --interface <file> Load register-care interface contracts',
-        '      --reg-profile <p> Register-care profile: mon3',
-        '      --aliases <file>  Load project directive alias JSON (repeatable)',
-        '  -I, --include <dir>   Add include search path (repeatable)',
-        '  -V, --version         Print version',
-        '  -h, --help            Show help',
-        '',
-        'Notes:',
-        '  - <entry.asm|entry.z80> must be the last argument (assembler-style).',
-        '  - Output artifacts are written next to the primary output using the artifact base name.',
-        '',
-    ].join('\n');
-}
-function fail(message) {
-    throw Object.assign(new Error(message), { name: 'CliError' });
-}
-function createDefaultCliState() {
-    return {
-        outputPath: undefined,
-        outputType: 'hex',
-        emitBin: true,
-        emitHex: true,
-        emitD8m: true,
-        emitListing: true,
-        emitAsm80: false,
-        caseStyle: 'off',
-        includeDirs: [],
-        directiveAliasFiles: [],
-        entryFile: undefined,
-        registerCare: 'off',
-        emitRegisterReport: false,
-        emitRegisterInterface: false,
-        annotateRegisterContracts: false,
-        fixRegisterContracts: false,
-        acceptRegisterOutputCandidates: [],
-        registerCareInterfaces: [],
-    };
-}
-function parseDirectiveAliasFileArg(arg, argv, indexRef, state) {
-    if (arg !== '--aliases' && !arg.startsWith('--aliases='))
-        return false;
-    const value = arg.includes('=')
-        ? arg.slice(arg.indexOf('=') + 1)
-        : readFlagValue(argv, indexRef, '--aliases');
-    if (!value)
-        fail(`--aliases expects a value`);
-    state.directiveAliasFiles.push(value);
-    return true;
-}
-function readFlagValue(argv, indexRef, flag) {
-    const value = argv[++indexRef.current];
-    if (!value)
-        fail(`${flag} expects a value`);
-    return value;
-}
-function readMatchedFlagValue(arg, argv, indexRef, flags) {
-    const flag = flags.find((candidate) => arg === candidate || arg.startsWith(`${candidate}=`)) ?? undefined;
-    if (!flag)
-        return undefined;
-    const value = arg.startsWith(`${flag}=`)
-        ? arg.slice(flag.length + 1)
-        : readFlagValue(argv, indexRef, flag);
-    if (!value)
-        fail(`${flag} expects a value`);
-    return { flag, value };
-}
-function parseOutputPathArg(arg, argv, indexRef, state) {
-    if (arg !== '-o' && arg !== '--output' && !arg.startsWith('--output='))
-        return false;
-    if (arg.startsWith('--output=')) {
-        const value = arg.slice('--output='.length);
-        if (!value)
-            fail(`--output expects a value`);
-        state.outputPath = value;
-        return true;
-    }
-    state.outputPath = readFlagValue(argv, indexRef, arg);
-    return true;
-}
-function parseOutputTypeArg(arg, argv, indexRef, state) {
-    if (arg !== '-t' && arg !== '--type' && !arg.startsWith('--type='))
-        return false;
-    const value = arg.startsWith('--type=')
-        ? arg.slice('--type='.length)
-        : readFlagValue(argv, indexRef, arg);
-    if (!value)
-        fail(`--type expects a value`);
-    if (value !== 'hex' && value !== 'bin')
-        fail(`Unsupported --type "${value}" (expected hex|bin)`);
-    state.outputType = value;
-    return true;
-}
-function parseCaseStyleArg(arg, argv, indexRef, state) {
-    if (arg !== '--case-style' && !arg.startsWith('--case-style='))
-        return false;
-    const value = arg.startsWith('--case-style=')
-        ? arg.slice('--case-style='.length)
-        : readFlagValue(argv, indexRef, '--case-style');
-    if (!value)
-        fail(`--case-style expects a value`);
-    if (value !== 'off' && value !== 'upper' && value !== 'lower' && value !== 'consistent') {
-        fail(`Unsupported --case-style "${value}" (expected off|upper|lower|consistent)`);
-    }
-    state.caseStyle = value;
-    return true;
-}
-function parseSourceRootArg(arg, argv, indexRef, state) {
-    const parsed = readMatchedFlagValue(arg, argv, indexRef, ['--source-root', '--map-root']);
-    if (!parsed)
-        return false;
-    state.sourceRoot = parsed.value;
-    return true;
-}
-function parseRegisterCareArg(arg, argv, indexRef, state) {
-    const parsed = readMatchedFlagValue(arg, argv, indexRef, ['--register-care', '--rc']);
-    if (!parsed)
-        return false;
-    const { flag, value } = parsed;
-    if (value !== 'off' &&
-        value !== 'audit' &&
-        value !== 'warn' &&
-        value !== 'error' &&
-        value !== 'strict') {
-        fail(`Unsupported ${flag} "${value}" (expected off|audit|warn|error|strict)`);
-    }
-    state.registerCare = value;
-    return true;
-}
-function parseRegisterProfileArg(arg, argv, indexRef, state) {
-    const parsed = readMatchedFlagValue(arg, argv, indexRef, ['--register-profile', '--reg-profile']);
-    if (!parsed)
-        return false;
-    const { flag, value } = parsed;
-    if (value !== 'mon3') {
-        fail(`Unsupported ${flag} "${value}" (expected mon3)`);
-    }
-    state.registerCareProfile = value;
-    return true;
-}
-function parseRegisterInterfaceInputArg(arg, argv, indexRef, state) {
-    if (arg !== '--interface' && !arg.startsWith('--interface='))
-        return false;
-    const value = arg.includes('=')
-        ? arg.slice(arg.indexOf('=') + 1)
-        : readFlagValue(argv, indexRef, '--interface');
-    if (!value)
-        fail(`--interface expects a value`);
-    state.registerCareInterfaces.push(value);
-    return true;
-}
-function parseAcceptRegisterOutputArg(arg, argv, indexRef, state) {
-    const parsed = readMatchedFlagValue(arg, argv, indexRef, [
-        '--accept-register-output',
-        '--accept-out',
-    ]);
-    if (!parsed)
-        return false;
-    const { value } = parsed;
-    state.acceptRegisterOutputCandidates.push(value);
-    return true;
-}
-function parseIncludeArg(arg, argv, indexRef, state) {
-    if (arg !== '-I' && arg !== '--include' && !arg.startsWith('--include='))
-        return false;
-    if (arg.startsWith('--include=')) {
-        const value = arg.slice('--include='.length);
-        if (!value)
-            fail(`--include expects a value`);
-        state.includeDirs.push(value);
-        return true;
-    }
-    state.includeDirs.push(readFlagValue(argv, indexRef, arg));
-    return true;
-}
-function handleCliFastPath(arg) {
-    if (arg === '-h' || arg === '--help') {
-        process.stdout.write(usage());
-        return { code: 0 };
-    }
-    if (arg === '-V' || arg === '--version') {
-        process.stdout.write(`${readPackageVersion()}\n`);
-        return { code: 0 };
-    }
-    return undefined;
-}
-function finalizeCliOptions(state) {
-    if (!state.entryFile) {
-        fail(`Expected exactly one <entry.asm|entry.z80> argument (and it must be last)`);
-    }
-    if (!isSupportedSourcePath(state.entryFile)) {
-        const ext = extname(state.entryFile).toLowerCase() || '<none>';
-        fail(`Unsupported entry extension "${ext}" (expected ${sourceExtensions.join(', ')})`);
-    }
-    const emitsRegisterCareArtifact = state.emitRegisterReport ||
-        state.emitRegisterInterface ||
-        state.annotateRegisterContracts ||
-        state.fixRegisterContracts ||
-        state.acceptRegisterOutputCandidates.length > 0 ||
-        state.registerCareInterfaces.length > 0;
-    if (state.outputType === 'hex' && !state.emitHex && !emitsRegisterCareArtifact) {
-        fail(`--type hex requires HEX output to be enabled`);
-    }
-    if (state.outputType === 'bin' && !state.emitBin && !emitsRegisterCareArtifact) {
-        fail(`--type bin requires BIN output to be enabled`);
-    }
-    if (state.outputPath) {
-        const ext = extname(state.outputPath).toLowerCase();
-        const wantExt = state.outputType === 'hex' ? '.hex' : '.bin';
-        if (ext !== wantExt) {
-            fail(`--output must end with "${wantExt}" when --type is "${state.outputType}"`);
-        }
-    }
-    return {
-        entryFile: state.entryFile,
-        ...(state.outputPath ? { outputPath: state.outputPath } : {}),
-        outputType: state.outputType,
-        ...(state.sourceRoot !== undefined ? { sourceRoot: state.sourceRoot } : {}),
-        emitBin: state.emitBin,
-        emitHex: state.emitHex,
-        emitD8m: state.emitD8m,
-        emitListing: state.emitListing,
-        emitAsm80: state.emitAsm80,
-        caseStyle: state.caseStyle,
-        includeDirs: state.includeDirs,
-        directiveAliasFiles: state.directiveAliasFiles,
-        registerCare: state.registerCare,
-        emitRegisterReport: state.emitRegisterReport,
-        emitRegisterInterface: state.emitRegisterInterface,
-        annotateRegisterContracts: state.annotateRegisterContracts,
-        fixRegisterContracts: state.fixRegisterContracts,
-        acceptRegisterOutputCandidates: state.acceptRegisterOutputCandidates,
-        registerCareInterfaces: state.registerCareInterfaces,
-        ...(state.registerCareProfile !== undefined
-            ? { registerCareProfile: state.registerCareProfile }
-            : {}),
-    };
-}
-export function parseCliArgs(argv) {
-    const state = createDefaultCliState();
-    const indexRef = { current: 0 };
-    for (; indexRef.current < argv.length; indexRef.current++) {
-        const arg = argv[indexRef.current];
-        const fastPath = handleCliFastPath(arg);
-        if (fastPath)
-            return fastPath;
-        if (parseOutputPathArg(arg, argv, indexRef, state))
-            continue;
-        if (parseOutputTypeArg(arg, argv, indexRef, state))
-            continue;
-        if (arg === '-n' || arg === '--nolist') {
-            state.emitListing = false;
-            continue;
-        }
-        if (arg === '--nobin') {
-            state.emitBin = false;
-            continue;
-        }
-        if (arg === '--nohex') {
-            state.emitHex = false;
-            continue;
-        }
-        if (arg === '--nod8m') {
-            state.emitD8m = false;
-            continue;
-        }
-        if (arg === '--asm80') {
-            state.emitAsm80 = true;
-            continue;
-        }
-        if (parseCaseStyleArg(arg, argv, indexRef, state))
-            continue;
-        if (parseSourceRootArg(arg, argv, indexRef, state))
-            continue;
-        if (parseDirectiveAliasFileArg(arg, argv, indexRef, state))
-            continue;
-        if (parseRegisterCareArg(arg, argv, indexRef, state))
-            continue;
-        if (arg === '--emit-register-report' || arg === '--reg-report') {
-            state.emitRegisterReport = true;
-            continue;
-        }
-        if (arg === '--emit-register-interface' || arg === '--reg-interface') {
-            state.emitRegisterInterface = true;
-            continue;
-        }
-        if (arg === '--fix') {
-            state.fixRegisterContracts = true;
-            state.annotateRegisterContracts = true;
-            continue;
-        }
-        if (arg === '--annotate-register-contracts' || arg === '--contracts') {
-            state.annotateRegisterContracts = true;
-            continue;
-        }
-        if (parseAcceptRegisterOutputArg(arg, argv, indexRef, state))
-            continue;
-        if (parseRegisterInterfaceInputArg(arg, argv, indexRef, state))
-            continue;
-        if (parseRegisterProfileArg(arg, argv, indexRef, state))
-            continue;
-        if (parseIncludeArg(arg, argv, indexRef, state))
-            continue;
-        if (arg.startsWith('-')) {
-            fail(`Unknown option "${arg}"`);
-        }
-        if (state.entryFile !== undefined) {
-            fail(`Expected exactly one <entry.asm|entry.z80> argument (and it must be last)`);
-        }
-        if (indexRef.current !== argv.length - 1) {
-            fail(`Expected exactly one <entry.asm|entry.z80> argument (and it must be last)`);
-        }
-        state.entryFile = arg;
-    }
-    return finalizeCliOptions(state);
-}
-function artifactBase(entryFile, outputType, outputPath) {
-    if (outputPath) {
-        const resolved = resolve(outputPath);
-        const ext = extname(resolved);
-        return ext.length > 0 ? resolved.slice(0, -ext.length) : resolved;
-    }
-    const entry = resolve(entryFile);
-    const ext = extname(entry);
-    const stem = ext.length > 0 ? entry.slice(0, -ext.length) : entry;
-    // Default primary output path is sibling of entry with extension derived from outputType.
-    return stem;
-}
-async function writeArtifacts(base, artifacts, outputType) {
-    const byKind = new Map();
-    for (const a of artifacts)
-        byKind.set(a.kind, a);
-    const hexPath = `${base}.hex`;
-    const binPath = `${base}.bin`;
-    const d8mPath = `${base}.d8.json`;
-    const lstPath = `${base}.lst`;
-    const asm80Path = `${base}.z80`;
-    const registerReportPath = `${base}.regcare.txt`;
-    const registerInterfacePath = `${base}.asmi`;
-    const writes = [];
-    const ensureDir = async (p) => mkdir(dirname(p), { recursive: true });
-    let primaryWrittenPath;
-    let registerReportWrittenPath;
-    let registerInterfaceWrittenPath;
-    let registerAnnotationWrittenPath;
-    const hex = byKind.get('hex');
-    if (hex && hex.kind === 'hex') {
-        await ensureDir(hexPath);
-        writes.push(writeFile(hexPath, hex.text, 'utf8'));
-        if (outputType === 'hex')
-            primaryWrittenPath = hexPath;
-    }
-    const bin = byKind.get('bin');
-    if (bin && bin.kind === 'bin') {
-        await ensureDir(binPath);
-        writes.push(writeFile(binPath, Buffer.from(bin.bytes)));
-        if (outputType === 'bin')
-            primaryWrittenPath = binPath;
-    }
-    const d8m = byKind.get('d8m');
-    if (d8m && d8m.kind === 'd8m') {
-        await ensureDir(d8mPath);
-        writes.push(writeFile(d8mPath, JSON.stringify(d8m.json, null, 2) + '\n', 'utf8'));
-    }
-    const lst = byKind.get('lst');
-    if (lst && lst.kind === 'lst') {
-        await ensureDir(lstPath);
-        writes.push(writeFile(lstPath, lst.text, 'utf8'));
-    }
-    const asm80 = byKind.get('asm80');
-    if (asm80 && asm80.kind === 'asm80') {
-        await ensureDir(asm80Path);
-        writes.push(writeFile(asm80Path, asm80.text, 'utf8'));
-    }
-    const registerReport = byKind.get('register-care-report');
-    if (registerReport && registerReport.kind === 'register-care-report') {
-        await ensureDir(registerReportPath);
-        writes.push(writeFile(registerReportPath, registerReport.text, 'utf8'));
-        registerReportWrittenPath = registerReportPath;
-    }
-    const registerInterface = byKind.get('register-care-interface');
-    if (registerInterface && registerInterface.kind === 'register-care-interface') {
-        await ensureDir(registerInterfacePath);
-        writes.push(writeFile(registerInterfacePath, registerInterface.text, 'utf8'));
-        registerInterfaceWrittenPath = registerInterfacePath;
-    }
-    const registerAnnotations = byKind.get('register-care-annotations');
-    if (registerAnnotations && registerAnnotations.kind === 'register-care-annotations') {
-        for (const file of registerAnnotations.files) {
-            await ensureDir(file.path);
-            writes.push(writeFile(file.path, file.text, 'utf8'));
-            registerAnnotationWrittenPath ??= file.path;
-        }
-    }
-    await Promise.all(writes);
-    const reportedPath = primaryWrittenPath ??
-        registerReportWrittenPath ??
-        registerInterfaceWrittenPath ??
-        registerAnnotationWrittenPath;
-    if (reportedPath) {
-        process.stdout.write(`${reportedPath}\n`);
-    }
-}
-function normalizeDiagnosticPath(file) {
-    const normalized = file.replace(/\\/g, '/');
-    return process.platform === 'win32' ? normalized.toLowerCase() : normalized;
-}
-function compareDiagnosticsForCli(a, b) {
-    const fileCmp = normalizeDiagnosticPath(a.file).localeCompare(normalizeDiagnosticPath(b.file));
-    if (fileCmp !== 0)
-        return fileCmp;
-    const lineCmp = (a.line ?? Number.POSITIVE_INFINITY) - (b.line ?? Number.POSITIVE_INFINITY);
-    if (lineCmp !== 0)
-        return lineCmp;
-    const colCmp = (a.column ?? Number.POSITIVE_INFINITY) - (b.column ?? Number.POSITIVE_INFINITY);
-    if (colCmp !== 0)
-        return colCmp;
-    const sevRank = (severity) => {
-        if (severity === 'error')
-            return 0;
-        if (severity === 'warning')
-            return 1;
-        return 2;
-    };
-    const sevCmp = sevRank(a.severity) - sevRank(b.severity);
-    if (sevCmp !== 0)
-        return sevCmp;
-    const idCmp = a.id.localeCompare(b.id);
-    if (idCmp !== 0)
-        return idCmp;
-    return a.message.localeCompare(b.message);
-}
-export async function runCli(argv) {
-    try {
-        const parsed = parseCliArgs(argv);
-        if ('code' in parsed)
-            return parsed.code;
-        const base = artifactBase(parsed.entryFile, parsed.outputType, parsed.outputPath);
-        const hexPath = `${base}.hex`;
-        const binPath = `${base}.bin`;
-        const lstPath = `${base}.lst`;
-        const compileOptions = {
-            emitBin: parsed.emitBin,
-            emitHex: parsed.emitHex,
-            emitD8m: parsed.emitD8m,
-            emitListing: parsed.emitListing,
-            emitAsm80: parsed.emitAsm80,
-            caseStyle: parsed.caseStyle,
-            includeDirs: parsed.includeDirs,
-            directiveAliasFiles: parsed.directiveAliasFiles,
-            ...(parsed.sourceRoot !== undefined ? { sourceRoot: parsed.sourceRoot } : {}),
-            d8mInputs: {
-                ...(parsed.sourceRoot !== undefined && parsed.emitListing ? { listing: lstPath } : {}),
-                ...(parsed.sourceRoot !== undefined && parsed.emitHex ? { hex: hexPath } : {}),
-                ...(parsed.sourceRoot !== undefined && parsed.emitBin ? { bin: binPath } : {}),
-            },
-            requireMain: false,
-            defaultCodeBase: 0,
-            registerCare: parsed.registerCare,
-            emitRegisterReport: parsed.emitRegisterReport,
-            emitRegisterInterface: parsed.emitRegisterInterface,
-            emitRegisterAnnotations: parsed.annotateRegisterContracts,
-            fixRegisterContracts: parsed.fixRegisterContracts,
-            acceptRegisterOutputCandidates: parsed.acceptRegisterOutputCandidates,
-            registerCareInterfaces: parsed.registerCareInterfaces,
-            ...(parsed.registerCareProfile !== undefined
-                ? { registerCareProfile: parsed.registerCareProfile }
-                : {}),
-        };
-        const res = await compile(parsed.entryFile, compileOptions, { formats: defaultFormatWriters });
-        const sortedDiagnostics = [...res.diagnostics].sort(compareDiagnosticsForCli);
-        if (sortedDiagnostics.length > 0) {
-            for (const d of sortedDiagnostics) {
-                const loc = d.line !== undefined && d.column !== undefined
-                    ? `${d.file}:${d.line}:${d.column}`
-                    : d.file;
-                process.stderr.write(`${loc}: ${d.severity}: [${d.id}] ${d.message}\n`);
-            }
-        }
-        if (sortedDiagnostics.some((d) => d.severity === 'error')) {
-            return 1;
-        }
-        await writeArtifacts(base, res.artifacts, parsed.outputType);
-        return 0;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        process.stderr.write(`azm: ${msg}\n`);
-        process.stderr.write(`${usage()}\n`);
-        return 2;
-    }
+export { parseCliArgs, runCli } from './cli/run.js';
+import { runCli } from './cli/run.js';
+function normalizePathForCompare(path) {
+    const resolved = resolve(path);
+    const canonical = (() => {
+        try {
+            return realpathSync(resolved);
+        }
+        catch {
+            return resolved;
+        }
+    })();
+    const normalized = canonical.replace(/\\/g, '/');
+    const normalizedDarwin = process.platform === 'darwin' ? normalized.replace(/^\/private\//, '/') : normalized;
+    return process.platform === 'win32' ? normalizedDarwin.toLowerCase() : normalizedDarwin;
 }
 function samePath(a, b) {
-    return (normalizePathForCompare(a, { realpath: true }) ===
-        normalizePathForCompare(b, { realpath: true }));
+    return normalizePathForCompare(a) === normalizePathForCompare(b);
 }
 function isDirectCliInvocation(invokedAs) {
     if (!invokedAs)
@@ -528,11 +27,8 @@ function isDirectCliInvocation(invokedAs) {
     const self = fileURLToPath(import.meta.url);
     if (samePath(invokedAs, self))
         return true;
-    const invoked = normalizePathForCompare(invokedAs, { realpath: true });
-    const normalizedSelf = normalizePathForCompare(self, { realpath: true });
-    // Windows CI can surface different canonical path spellings for the same file.
-    // Fall back to stable suffix matching for the built CLI entry path.
-    return invoked.endsWith('/dist/src/cli.js') && normalizedSelf.endsWith('/dist/src/cli.js');
+    const invoked = normalizePathForCompare(invokedAs);
+    return invoked.endsWith('/dist/src/cli.js');
 }
 if (isDirectCliInvocation(process.argv[1])) {
     void runCli(process.argv.slice(2)).then((code) => process.exit(code));

package/dist/src/core/compile-artifacts.d.ts

@@ -0,0 +1,26 @@
+import type { Diagnostic } from '../model/diagnostic.js';
+import { type CompileOptions } from './compile.js';
+export type CompileArtifactOptions = CompileOptions & {
+    readonly emitBin?: boolean;
+    readonly emitHex?: boolean;
+};
+/** @deprecated Use {@link CompileArtifactOptions}. */
+export type CompileNextArtifactOptions = CompileArtifactOptions;
+export type SourceArtifact = {
+    readonly kind: 'bin';
+    readonly bytes: Uint8Array;
+} | {
+    readonly kind: 'hex';
+    readonly text: string;
+};
+/** @deprecated Use {@link SourceArtifact}. */
+export type NextArtifact = SourceArtifact;
+export interface CompileArtifactsResult {
+    readonly diagnostics: readonly Diagnostic[];
+    readonly artifacts: readonly SourceArtifact[];
+}
+/** @deprecated Use {@link CompileArtifactsResult}. */
+export type CompileNextArtifactsResult = CompileArtifactsResult;
+export declare function compileArtifacts(sourceText: string, options?: CompileArtifactOptions): CompileArtifactsResult;
+/** @deprecated Use {@link compileArtifacts}. */
+export declare const compileNextArtifacts: typeof compileArtifacts;

package/dist/src/core/compile-artifacts.js

@@ -0,0 +1,17 @@
+import { compileSource } from './compile.js';
+export function compileArtifacts(sourceText, options = {}) {
+    const result = compileSource(sourceText, options);
+    if (result.diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {
+        return { diagnostics: result.diagnostics, artifacts: [] };
+    }
+    const artifacts = [];
+    if (options.emitBin !== false) {
+        artifacts.push({ kind: 'bin', bytes: result.bytes });
+    }
+    if (options.emitHex !== false) {
+        artifacts.push({ kind: 'hex', text: result.hexText });
+    }
+    return { diagnostics: result.diagnostics, artifacts };
+}
+/** @deprecated Use {@link compileArtifacts}. */
+export const compileNextArtifacts = compileArtifacts;

package/dist/src/core/compile.d.ts

@@ -0,0 +1,26 @@
+import type { Diagnostic } from '../model/diagnostic.js';
+import type { SourceItem } from '../model/source-item.js';
+import type { LogicalLine } from '../source/logical-lines.js';
+import type { DirectiveAliasPolicy } from '../syntax/directive-aliases.js';
+export interface CompileNextOptions {
+    readonly entryName?: string;
+}
+export interface CompileSourceResult {
+    readonly diagnostics: readonly Diagnostic[];
+    readonly symbols: Readonly<Record<string, number>>;
+    readonly bytes: Uint8Array;
+    readonly hexText: string;
+}
+interface ParseNextSourceItemsResult {
+    readonly diagnostics: readonly Diagnostic[];
+    readonly items: readonly SourceItem[];
+}
+interface ParseNextSourceItemsOptions {
+    readonly directiveAliasPolicy?: DirectiveAliasPolicy;
+}
+export declare function parseNextSourceItems(lines: readonly LogicalLine[], options?: ParseNextSourceItemsOptions): ParseNextSourceItemsResult;
+export type CompileOptions = CompileNextOptions;
+export declare function compileSource(sourceText: string, options?: CompileOptions): CompileSourceResult;
+/** @deprecated Use {@link compileSource}. */
+export declare const compileNext: typeof compileSource;
+export {};