@specy/x86 2.2.1 → 2.3.0

package/dist/index.d.mts

@@ -259,16 +259,27 @@ type X86EmulatorEventHandler<T extends X86EmulatorEventName> = (event: X86Emulat
  * line of source for NASM; the same work in its own module takes single-digit
  * milliseconds, and produces byte-identical output.
  *
- * The object file comes back as bytes for the caller to stage wherever the
- * linker expects it, so the linker can keep running inside blink unchanged.
+ * The object files come back as bytes for the caller to stage wherever the
+ * linker expects them, so the linker can keep running inside blink unchanged.
  */
 interface WasmAssembler {
   assemble(project: X86Project): Promise<WasmAssemblyResult>;
 }
+/** One translation unit's object, and the Project File it was assembled from. */
+type WasmAssemblyUnit = {
+  path: string;
+  object: Uint8Array;
+};
 type WasmAssemblyResult = {
-  /** The assembler's exit status: 0 when it wrote an object file. */status: number; /** What it wrote to stdout, verbatim. */
+  /** The assembler's exit status: 0 when every translation unit assembled. */status: number; /** What it wrote to stdout, verbatim. */
   stdout: string; /** What it wrote to stderr, verbatim - the diagnostics a parser reads. */
-  stderr: string; /** The object file, or null when the assembly failed. */
+  stderr: string;
+  /**
+   * The objects to link, Entry first. Empty when any translation unit failed:
+   * a partial link would report missing symbols that are only missing because
+   * the File defining them is the one that did not assemble.
+   */
+  units: WasmAssemblyUnit[]; /** The Entry's object, or null when the assembly failed. */
   object: Uint8Array | null;
 };
 //#endregion
@@ -277,6 +288,14 @@ interface Binary {
   file: ResourceSource;
   commands: string;
 }
+interface LinkerBinary {
+  file: ResourceSource;
+  /**
+   * The command that links however many objects the Project's translation units produced. Every
+   * path it is given is one this package generated, so none of them needs escaping.
+   */
+  link(objects: readonly string[]): string;
+}
 interface DiagnosticLine {
   file?: string;
   line: number;
@@ -304,7 +323,7 @@ interface AssemblerMode {
      * portable C. Fasm is written in x86 assembly and has no such build.
      */
     assembler?: Binary;
-    linker?: Binary;
+    linker?: LinkerBinary;
   };
   /** Runs outside blink, and takes precedence over `binaries.assembler`. */
   wasmAssembler?: WasmAssembler;
@@ -322,7 +341,7 @@ declare const assemblers: {
       };
       linker: {
         file: URL;
-        commands: string;
+        link: (objects: readonly string[]) => string;
       };
     };
   };
@@ -346,7 +365,7 @@ declare const assemblers: {
     binaries: {
       linker: {
         file: URL;
-        commands: string;
+        link: (objects: readonly string[]) => string;
       };
     };
     wasmAssembler: WasmAssembler;
@@ -357,6 +376,17 @@ declare const DEFAULT_ASSEMBLER_ID: AssemblerId;
 declare function nasmDiagnostics(str: string): DiagnosticLine[];
 declare function gnuDiagnostics(str: string): DiagnosticLine[];
 declare function fasmDiagnostics(str: string): DiagnosticLine[];
+/**
+ * What `ld` said, as diagnostics. Nothing else in the toolchain reports a symbol that no
+ * translation unit defines: NASM accepts every `extern` on the author's word, and the mistake
+ * only surfaces here. Without this the link simply failed and the build looked like it had
+ * succeeded, leaving the program unrunnable and nothing on screen to say why.
+ *
+ * `ld` writes a location as `file:line:(section+offset):`, and writes the notes that introduce an
+ * error - "in function `_start':" - as lines ending in a colon, which are skipped in favour of
+ * the error itself.
+ */
+declare function ldDiagnostics(str: string): DiagnosticLine[];
 /**
  * The one-based column a diagnostic belongs on. NASM reports a line and no
  * column, but it names the thing it is complaining about: `msg' in "symbol
@@ -522,7 +552,9 @@ declare class BlinkRuntime {
   private sourceMap;
   private sourceProject;
   private assembleOnly;
-  private assembledObject;
+  private assembledObjects;
+  /** What the linker said, kept apart from the assembler's log so `ld`'s own parser reads it. */
+  private linkerLogs;
   private readonly defaultArgc;
   private readonly defaultArgv;
   private constructor();
@@ -542,13 +574,21 @@ declare class BlinkRuntime {
   private checkProjectWithWasmAssembler;
   private buildProject;
   /**
-   * The object this build's assembler wrote, for the checks that read it
-   * rather than the assembler's own words. Null when the assembly failed, and
+   * The objects this build's assembler wrote, for the checks that read them
+   * rather than the assembler's own words. Empty when the assembly failed, and
    * when the assembler writes an executable directly and never produces one.
-   * Read once per build, so a previous build's object can never stand in for
-   * one that was never written.
+   * Read once per build, so a previous build's objects can never stand in for
+   * ones that were never written.
+   */
+  private takeAssembledObjects;
+  /**
+   * What the link had to say. A link that failed leaves no program to run, so a build that
+   * reported nothing would hand the caller a success it cannot act on - the state stays `Ready`
+   * and the next step or run fails with a message about the emulator rather than the mistake.
+   * The fallback covers a linker that fails in a way its parser does not recognise, so a failed
+   * link is always visible as an error whatever `ld` chose to say about it.
    */
-  private takeAssembledObject;
+  private linkDiagnostics;
   /**
    * Nothing in the toolchain treats a missing entry point as a failure: NASM
    * has no opinion on it and `ld` only warns, then starts the program at the
@@ -564,6 +604,12 @@ declare class BlinkRuntime {
    * the object itself.
    */
   private assembleWithWasmAssembler;
+  /**
+   * Starts the link, and starts a log of its own for it. The assembler's parser cannot read
+   * `ld`'s diagnostics and `ld`'s cannot read the assembler's, so what each of them said has to
+   * stay separable even though both reach the caller as one report.
+   */
+  private beginLinking;
   private collectAssemblerDiagnostics;
   private emitAssemblerOutput;
   private parseAssemblerDiagnostics;
@@ -626,6 +672,13 @@ declare function validateX86Project(project: X86Project): void;
  * preprocessor macros.
  */
 declare function stageX86Project(fs: EmscriptenFS, project: X86Project): void;
+/**
+ * Points the assembler at one staged Project File and leaves that File's own directory as the
+ * working directory, so its `%include`s and `incbin`s resolve from where it was written rather
+ * than from wherever the Entry happens to live. The Entry keeps its `/assembly.s` identity, which
+ * is the path its existing diagnostics and source maps are written in terms of.
+ */
+declare function selectX86Source(fs: EmscriptenFS, project: X86Project, path: string): string;
 /** Maps a path emitted by NASM or DWARF back to the exact Project path. */
 declare function x86ProjectSourcePath(sourcePath: string | undefined, project: Pick<X86Project, 'entry' | 'files'>): string;
 declare function x86ProjectText(project: X86Project, path: string): string;
@@ -710,5 +763,5 @@ declare class X86Emulator extends BaseEmulator<BlinkRuntime, X86RegisterName, X8
 }
 declare function createX86Emulator(options?: X86EmulatorOptions): Promise<X86Emulator>;
 //#endregion
-export { AssemblerId, AssemblerMode, BaseEmulator, Binary, BlinkRunOptions, BlinkRuntime, BlinkRuntimeCallbacks, BlinkRuntimeOptions, BlinkState, BlinkenlibModule, BlinkenlibModuleOptions, CompilationError, DEFAULT_ASSEMBLER_ID, DiagnosticLine, DiagnosticSeverity, DiagnosticsParser, DisassemblySnapshot, EmscriptenFS, EmulatorConfig, EmulatorDecoration, EmulatorStatus, ExecutionStep, Instruction, MaybePromise, MemoryReadResult, MemoryWriteResult, MonacoError, MutationOperation, NativeControlFlowKind, NativeInstruction, NativeMemoryWrite, NativeRunControls, NativeRunStop, NativeRunStopKind, NativeStepInfo, NativeSymbol, RegisterHex, RegisterSize, RegisterSnapshot, ResourceSource, StackFrame, StatusRegister, StopReason, StopReasonKind, X86Breakpoint, X86CompilationDiagnostic, X86CompileResult, X86Emulator, X86EmulatorEventHandler, X86EmulatorEventMap, X86EmulatorEventName, X86EmulatorOptions, X86Project, X86ProjectFile, X86RegisterName, X86SourceLocation, X86_PROJECT_ROOT, X86_REGISTER_NAMES, assemblers, createX86Emulator, defaultResourceUrl, fasmDiagnostics, gnuDiagnostics, isNodeRuntime, locateDiagnosticColumn, nasmDiagnostics, observeCallbackResult, readResourceBytes, stageX86Project, toResourceUrl, validateX86Project, x86ProjectSourcePath, x86ProjectText };
+export { AssemblerId, AssemblerMode, BaseEmulator, Binary, BlinkRunOptions, BlinkRuntime, BlinkRuntimeCallbacks, BlinkRuntimeOptions, BlinkState, BlinkenlibModule, BlinkenlibModuleOptions, CompilationError, DEFAULT_ASSEMBLER_ID, DiagnosticLine, DiagnosticSeverity, DiagnosticsParser, DisassemblySnapshot, EmscriptenFS, EmulatorConfig, EmulatorDecoration, EmulatorStatus, ExecutionStep, Instruction, LinkerBinary, MaybePromise, MemoryReadResult, MemoryWriteResult, MonacoError, MutationOperation, NativeControlFlowKind, NativeInstruction, NativeMemoryWrite, NativeRunControls, NativeRunStop, NativeRunStopKind, NativeStepInfo, NativeSymbol, RegisterHex, RegisterSize, RegisterSnapshot, ResourceSource, StackFrame, StatusRegister, StopReason, StopReasonKind, X86Breakpoint, X86CompilationDiagnostic, X86CompileResult, X86Emulator, X86EmulatorEventHandler, X86EmulatorEventMap, X86EmulatorEventName, X86EmulatorOptions, X86Project, X86ProjectFile, X86RegisterName, X86SourceLocation, X86_PROJECT_ROOT, X86_REGISTER_NAMES, assemblers, createX86Emulator, defaultResourceUrl, fasmDiagnostics, gnuDiagnostics, isNodeRuntime, ldDiagnostics, locateDiagnosticColumn, nasmDiagnostics, observeCallbackResult, readResourceBytes, selectX86Source, stageX86Project, toResourceUrl, validateX86Project, x86ProjectSourcePath, x86ProjectText };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/resources.ts","../src/interface.ts","../src/callbacks.ts","../src/types.ts","../src/wasm-assembler.ts","../src/assemblers.ts","../src/wasm-types.ts","../src/blink-runtime.ts","../src/project.ts","../src/x86-emulator.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/resources.ts","../src/interface.ts","../src/callbacks.ts","../src/types.ts","../src/wasm-assembler.ts","../src/assemblers.ts","../src/wasm-types.ts","../src/blink-runtime.ts","../src/project.ts","../src/x86-emulator.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -39,6 +39,16 @@ function stageX86Project(fs, project) {
 	fs.chdir(projectDirectory(project.entry));
 	stagedFiles.set(fs, current);
 }
+/**
+* Points the assembler at one staged Project File and leaves that File's own directory as the
+* working directory, so its `%include`s and `incbin`s resolve from where it was written rather
+* than from wherever the Entry happens to live. The Entry keeps its `/assembly.s` identity, which
+* is the path its existing diagnostics and source maps are written in terms of.
+*/
+function selectX86Source(fs, project, path) {
+	fs.chdir(projectDirectory(path));
+	return path === project.entry ? "/assembly.s" : `${X86_PROJECT_ROOT}/${path}`;
+}
 /** Maps a path emitted by NASM or DWARF back to the exact Project path. */
 function x86ProjectSourcePath(sourcePath, project) {
 	if (!sourcePath || sourcePath === "/assembly.s" || sourcePath === "assembly.s") return project.entry;
@@ -81,52 +91,155 @@ function x86ProjectText(project, path) {
 	return typeof contents === "string" ? contents : "";
 }
 //#endregion
+//#region src/translation-units.ts
+/**
+* Extensions that make a Project File assembler input in its own right. `.inc` is deliberately
+* absent: it is what an include fragment is conventionally called, and a fragment assembled on
+* its own would define its symbols a second time. A fragment under any other name is caught by
+* the dependency scan instead.
+*/
+const SOURCE_EXTENSIONS = [
+	".asm",
+	".s",
+	".nasm"
+];
+function isX86Source(path) {
+	const lower = path.toLowerCase();
+	return SOURCE_EXTENSIONS.some((extension) => lower.endsWith(extension));
+}
+/**
+* Every File that could be its own translation unit: assembled separately and linked with the
+* rest, which is what makes `global` in one File and `extern` in another resolve to each other.
+* The Entry comes first so it leads the link, and the rest follow in a stable order so two builds
+* of the same Project lay out identically.
+*/
+function x86TranslationUnitCandidates(project) {
+	const others = Object.keys(project.files).filter((path) => path !== project.entry).filter((path) => typeof project.files[path] === "string" && isX86Source(path)).sort();
+	return [project.entry, ...others];
+}
+/**
+* The Files named by one `nasm -M` run, as Project paths. A File that another source `%include`s
+* is already part of that source: assembling it again would define every one of its symbols a
+* second time, so the link would fail on duplicate definitions rather than on anything the author
+* wrote. Asking NASM rather than scanning for `%include` ourselves is what keeps macro-generated
+* and conditional includes right, since NASM is the only thing that knows which ones it took.
+*/
+function parseDependencyList(output, project) {
+	const separator = output.indexOf(":");
+	if (separator < 0) return [];
+	return output.slice(separator + 1).replace(/\\\r?\n/g, " ").split(/\s+/).filter(Boolean).map((written) => x86ProjectSourcePath(written, project));
+}
+//#endregion
 //#region src/wasm-assembler.ts
-const SOURCE_PATH = "/assembly.s";
 const OBJECT_PATH = "/program.o";
 /**
 * `-g -F dwarf` is what makes the source map possible: the debugger reads
 * `.debug_line` out of the linked executable to map an address back to the line
-* it was written on. The paths match what `stageX86Project` writes, and the
-* working directory it selects is what lets NASM resolve `%include` itself.
+* it was written on. The working directory `selectX86Source` selects is what
+* lets NASM resolve `%include` itself.
 */
 const NASM_ARGS = [
 	"-g",
 	"-F",
 	"dwarf",
-	"-felf64",
-	SOURCE_PATH,
-	"-o",
-	OBJECT_PATH
+	"-felf64"
 ];
-const nasmWasmAssembler = { async assemble(project) {
+async function createNasmModule() {
 	let stdout = "";
 	let stderr = "";
-	const module = await createNasm({
-		noInitialRun: true,
-		print: (line) => {
-			stdout += `${line}\n`;
-		},
-		printErr: (line) => {
-			stderr += `${line}\n`;
-		}
-	});
-	stageX86Project(module.FS, project);
+	return {
+		module: await createNasm({
+			noInitialRun: true,
+			print: (line) => {
+				stdout += `${line}\n`;
+			},
+			printErr: (line) => {
+				stderr += `${line}\n`;
+			}
+		}),
+		stdout: () => stdout,
+		stderr: () => stderr
+	};
+}
+/**
+* Emscripten's Node path sets `process.exitCode` from the status the module
+* exits with, so an assembly that failed would leave the host process exiting
+* non-zero for a reason of its own. NASM's status belongs to the caller of this
+* function, never to the host.
+*/
+function callNasm(module, args) {
 	const host = globalThis.process;
 	const hostExitCode = host?.exitCode;
-	const status = module.callMain([...NASM_ARGS]);
+	const status = module.callMain(args);
 	if (host) host.exitCode = hostExitCode;
-	const object = status === 0 && module.FS.analyzePath(OBJECT_PATH).exists ? module.FS.readFile(OBJECT_PATH) : null;
+	return status;
+}
+/**
+* Which Files the Project's candidate translation units `%include`, so that a fragment is
+* assembled as part of whatever includes it and never a second time on its own. Every candidate
+* is scanned before any of them is treated as a unit, because a fragment can be included by a
+* File that sorts after it.
+*/
+async function scanIncludedFiles(project, candidates) {
+	const included = /* @__PURE__ */ new Set();
+	if (candidates.length < 2) return included;
+	for (const path of candidates) {
+		const { module, stdout } = await createNasmModule();
+		stageX86Project(module.FS, project);
+		const source = selectX86Source(module.FS, project, path);
+		callNasm(module, [
+			"-M",
+			...NASM_ARGS,
+			source,
+			"-o",
+			OBJECT_PATH
+		]);
+		for (const dependency of parseDependencyList(stdout(), project)) if (dependency !== path) included.add(dependency);
+	}
+	return included;
+}
+const nasmWasmAssembler = { async assemble(project) {
+	const candidates = x86TranslationUnitCandidates(project);
+	const included = await scanIncludedFiles(project, candidates);
+	const units = candidates.filter((path) => path === project.entry || !included.has(path));
+	let stdout = "";
+	let stderr = "";
+	let status = 0;
+	const assembled = [];
+	for (const path of units) {
+		const { module, stdout: readStdout, stderr: readStderr } = await createNasmModule();
+		stageX86Project(module.FS, project);
+		const source = selectX86Source(module.FS, project, path);
+		const unitStatus = callNasm(module, [
+			...NASM_ARGS,
+			source,
+			"-o",
+			OBJECT_PATH
+		]);
+		stdout += readStdout();
+		stderr += readStderr();
+		if (!(unitStatus === 0 && module.FS.analyzePath(OBJECT_PATH).exists)) {
+			if (status === 0) status = unitStatus === 0 ? 1 : unitStatus;
+			continue;
+		}
+		assembled.push({
+			path,
+			object: module.FS.readFile(OBJECT_PATH)
+		});
+	}
+	const ok = status === 0 && assembled.length === units.length;
 	return {
 		status,
 		stdout,
 		stderr,
-		object
+		units: ok ? assembled : [],
+		object: ok ? assembled[0]?.object ?? null : null
 	};
 } };
 //#endregion
 //#region src/assemblers.ts
 const assemblerAsset = (filename) => new URL(`./assets/assemblers/${filename}`, import.meta.url);
+const linkCommand = (objects) => `/linker ${objects.join(" ")} -o /program`;
 const assemblers = {
 	GNU_trunk: {
 		id: "GNU_trunk",
@@ -140,7 +253,7 @@ const assemblers = {
 			},
 			linker: {
 				file: assemblerAsset("gnu-ld.2.43.50.elf"),
-				commands: "/linker /program.o -o /program"
+				link: linkCommand
 			}
 		}
 	},
@@ -161,7 +274,7 @@ const assemblers = {
 		diagnosticsParser: nasmDiagnostics,
 		binaries: { linker: {
 			file: assemblerAsset("gnu-ld.2.43.50.elf"),
-			commands: "/linker /program.o -o /program"
+			link: linkCommand
 		} },
 		wasmAssembler: nasmWasmAssembler
 	}
@@ -231,6 +344,36 @@ function fasmDiagnostics(str) {
 	return diagnostics;
 }
 /**
+* What `ld` said, as diagnostics. Nothing else in the toolchain reports a symbol that no
+* translation unit defines: NASM accepts every `extern` on the author's word, and the mistake
+* only surfaces here. Without this the link simply failed and the build looked like it had
+* succeeded, leaving the program unrunnable and nothing on screen to say why.
+*
+* `ld` writes a location as `file:line:(section+offset):`, and writes the notes that introduce an
+* error - "in function `_start':" - as lines ending in a colon, which are skipped in favour of
+* the error itself.
+*/
+function ldDiagnostics(str) {
+	const diagnostics = [];
+	const locatedRegex = /^(.*?):(\d+):(?:\([^)]*\))?:\s*(.+)$/;
+	for (const line of str.split(/\r?\n/)) {
+		const text = line.trim().replace(/^\/linker:\s*/, "");
+		if (!text || text.startsWith("$ ") || text.endsWith(":")) continue;
+		const located = text.match(locatedRegex);
+		const message = (located?.[3] ?? text).trim();
+		if (!message) continue;
+		if (message.includes("cannot find entry symbol")) continue;
+		const isWarning = message.startsWith("warning:");
+		diagnostics.push({
+			...located?.[1] ? { file: located[1] } : {},
+			line: located ? Number.parseInt(located[2] ?? "0", 10) : 1,
+			error: isWarning ? message.slice(8).trim() : message,
+			severity: isWarning ? "warning" : "error"
+		});
+	}
+	return diagnostics;
+}
+/**
 * The one-based column a diagnostic belongs on. NASM reports a line and no
 * column, but it names the thing it is complaining about: `msg' in "symbol
 * `msg' not defined", `.data' in a section warning. Finding that name in the
@@ -846,7 +989,9 @@ var BlinkRuntime = class BlinkRuntime {
 	sourceMap = null;
 	sourceProject = null;
 	assembleOnly = false;
-	assembledObject = null;
+	assembledObjects = [];
+	/** What the linker said, kept apart from the assembler's log so `ld`'s own parser reads it. */
+	linkerLogs = null;
 	defaultArgc = "/program";
 	defaultArgv = "";
 	constructor(module, mode, callbacks, scheduler) {
@@ -922,7 +1067,7 @@ var BlinkRuntime = class BlinkRuntime {
 		const sourceProject = copyX86Project(project);
 		const assembled = await this.mode.wasmAssembler.assemble(sourceProject);
 		const report = assembled.stdout + assembled.stderr;
-		return toCompileResult([...this.parseAssemblerDiagnostics(report, sourceProject), ...this.entryPointDiagnostics(assembled.object, sourceProject)], report);
+		return toCompileResult([...this.parseAssemblerDiagnostics(report, sourceProject), ...this.entryPointDiagnostics(assembled.units.map((unit) => unit.object), sourceProject)], report);
 	}
 	async buildProject(project, options) {
 		this.assertReadyForCompile();
@@ -932,7 +1077,8 @@ var BlinkRuntime = class BlinkRuntime {
 		this.assemblerLogs = "";
 		this.assemblerErrors = [];
 		this.assemblerDiagnostics = [];
-		this.assembledObject = null;
+		this.assembledObjects = [];
+		this.linkerLogs = null;
 		this.sourceMap = null;
 		this.assembleOnly = !options.link;
 		try {
@@ -942,24 +1088,49 @@ var BlinkRuntime = class BlinkRuntime {
 			this.assembleOnly = false;
 			this.module.FS.chdir("/");
 		}
-		const diagnostics = [...this.assemblerDiagnostics.map((diagnostic) => ({
-			...diagnostic,
-			file: x86ProjectSourcePath(diagnostic.file, sourceProject)
-		})), ...this.entryPointDiagnostics(this.takeAssembledObject(), sourceProject)];
+		const diagnostics = [
+			...this.assemblerDiagnostics.map((diagnostic) => ({
+				...diagnostic,
+				file: x86ProjectSourcePath(diagnostic.file, sourceProject)
+			})),
+			...this.entryPointDiagnostics(this.takeAssembledObjects(), sourceProject),
+			...this.linkDiagnostics(sourceProject)
+		];
 		if (this.state === "PROGRAM_LOADED") this.sourceMap = this.tryReadSourceMap();
 		return toCompileResult(diagnostics, this.assemblerLogs);
 	}
 	/**
-	* The object this build's assembler wrote, for the checks that read it
-	* rather than the assembler's own words. Null when the assembly failed, and
+	* The objects this build's assembler wrote, for the checks that read them
+	* rather than the assembler's own words. Empty when the assembly failed, and
 	* when the assembler writes an executable directly and never produces one.
-	* Read once per build, so a previous build's object can never stand in for
-	* one that was never written.
+	* Read once per build, so a previous build's objects can never stand in for
+	* ones that were never written.
 	*/
-	takeAssembledObject() {
-		const object = this.assembledObject;
-		this.assembledObject = null;
-		return object;
+	takeAssembledObjects() {
+		const objects = this.assembledObjects;
+		this.assembledObjects = [];
+		return objects;
+	}
+	/**
+	* What the link had to say. A link that failed leaves no program to run, so a build that
+	* reported nothing would hand the caller a success it cannot act on - the state stays `Ready`
+	* and the next step or run fails with a message about the emulator rather than the mistake.
+	* The fallback covers a linker that fails in a way its parser does not recognise, so a failed
+	* link is always visible as an error whatever `ld` chose to say about it.
+	*/
+	linkDiagnostics(sourceProject) {
+		if (this.linkerLogs === null) return [];
+		const diagnostics = ldDiagnostics(this.linkerLogs).map((diagnostic) => ({
+			...diagnostic,
+			file: x86ProjectSourcePath(diagnostic.file, sourceProject)
+		}));
+		if (this.state === "PROGRAM_LOADED" || diagnostics.some((diagnostic) => diagnostic.severity === "error")) return diagnostics;
+		return [...diagnostics, {
+			line: 1,
+			file: sourceProject.entry,
+			severity: "error",
+			error: "linking failed, so there is no program to run."
+		}];
 	}
 	/**
 	* Nothing in the toolchain treats a missing entry point as a failure: NASM
@@ -968,9 +1139,9 @@ var BlinkRuntime = class BlinkRuntime {
 	* is the least explicable thing a program can do to someone learning, so it
 	* is reported as an error here and the mistake is usually a misspelling.
 	*/
-	entryPointDiagnostics(object, sourceProject) {
-		if (!object || !this.mode.binaries.linker) return [];
-		const globals = readDefinedGlobalSymbols(object);
+	entryPointDiagnostics(objects, sourceProject) {
+		if (!objects.length || !this.mode.binaries.linker) return [];
+		const globals = objects.flatMap((object) => readDefinedGlobalSymbols(object));
 		if (globals.includes("_start")) return [];
 		const nearest = findNearestSymbol(DEFAULT_ENTRY_SYMBOL, globals);
 		const nearestHint = nearest ? ` Did you mean \`${DEFAULT_ENTRY_SYMBOL}\` where you wrote \`${nearest}\`?` : "";
@@ -991,7 +1162,7 @@ var BlinkRuntime = class BlinkRuntime {
 		this.module._blinkenlib_run_fast();
 		await this.waitForState((state) => state !== "ASSEMBLING" && state !== "LINKING");
 		if (this.assemblerErrors.length === 0) try {
-			this.assembledObject = this.module.FS.readFile("/program.o");
+			this.assembledObjects = [this.module.FS.readFile("/program.o")];
 		} catch {}
 	}
 	/**
@@ -1005,23 +1176,32 @@ var BlinkRuntime = class BlinkRuntime {
 		this.emitAssemblerOutput(assembled.stdout, this.callbacks.stdout);
 		this.emitAssemblerOutput(assembled.stderr, this.callbacks.stderr);
 		this.collectAssemblerDiagnostics();
-		if (!assembled.object) {
+		if (!assembled.units.length) {
 			this.setState("READY");
 			return;
 		}
+		this.assembledObjects = assembled.units.map((unit) => unit.object);
 		if (!options.link) {
-			this.assembledObject = assembled.object;
 			this.setState("READY");
 			return;
 		}
-		this.assembledObject = assembled.object;
-		this.writeExecutableSync("/program.o", assembled.object);
-		this.setState("LINKING");
+		const objectPaths = assembled.units.map((_, index) => index === 0 ? "/program.o" : `/program.${index}.o`);
+		assembled.units.forEach((unit, index) => this.writeExecutableSync(objectPaths[index], unit.object));
+		this.beginLinking();
 		await defer();
-		this.setEmulationArgs("/linker", this.mode.binaries.linker?.commands ?? "", "");
+		this.setEmulationArgs("/linker", this.mode.binaries.linker?.link(objectPaths) ?? "", "");
 		this.module._blinkenlib_run_fast();
 		await this.waitForState((state) => state !== "LINKING");
 	}
+	/**
+	* Starts the link, and starts a log of its own for it. The assembler's parser cannot read
+	* `ld`'s diagnostics and `ld`'s cannot read the assembler's, so what each of them said has to
+	* stay separable even though both reach the caller as one report.
+	*/
+	beginLinking() {
+		this.linkerLogs = "";
+		this.setState("LINKING");
+	}
 	collectAssemblerDiagnostics() {
 		this.assemblerDiagnostics = this.mode.diagnosticsParser?.(this.assemblerLogs) ?? [];
 		this.assemblerErrors = this.assemblerDiagnostics.filter((diagnostic) => diagnostic.severity === "error");
@@ -1218,7 +1398,10 @@ var BlinkRuntime = class BlinkRuntime {
 		this.module.blinkenlibSetRunControls(BigInt(limit), (options.breakpointAddresses ?? []).map((address) => address.toString()));
 	}
 	collectAssemblerLog(charCode) {
-		if (this.state === "ASSEMBLING" || this.state === "LINKING") this.assemblerLogs += String.fromCharCode(charCode);
+		if (this.state !== "ASSEMBLING" && this.state !== "LINKING") return;
+		const character = String.fromCharCode(charCode);
+		this.assemblerLogs += character;
+		if (this.state === "LINKING" && this.linkerLogs !== null) this.linkerLogs += character;
 	}
 	handleSignal(signal, code) {
 		if (signal !== SIGNALS.SIGTRAP) {
@@ -1297,9 +1480,9 @@ var BlinkRuntime = class BlinkRuntime {
 			this.setState("PROGRAM_LOADED");
 			return;
 		}
-		this.setState("LINKING");
+		this.beginLinking();
 		this.scheduler(() => {
-			this.setEmulationArgs("/linker", this.mode.binaries.linker?.commands ?? "", "");
+			this.setEmulationArgs("/linker", this.mode.binaries.linker?.link(["/program.o"]) ?? "", "");
 			this.module._blinkenlib_run_fast();
 		});
 	}
@@ -2020,6 +2203,6 @@ async function createX86Emulator(options = {}) {
 	return X86Emulator.create(options);
 }
 //#endregion
-export { BaseEmulator, BlinkRuntime, BlinkState, DEFAULT_ASSEMBLER_ID, EmulatorStatus, RegisterSize, X86Emulator, X86_PROJECT_ROOT, X86_REGISTER_NAMES, assemblers, createX86Emulator, defaultResourceUrl, fasmDiagnostics, gnuDiagnostics, isNodeRuntime, locateDiagnosticColumn, nasmDiagnostics, observeCallbackResult, readResourceBytes, stageX86Project, toResourceUrl, validateX86Project, x86ProjectSourcePath, x86ProjectText };
+export { BaseEmulator, BlinkRuntime, BlinkState, DEFAULT_ASSEMBLER_ID, EmulatorStatus, RegisterSize, X86Emulator, X86_PROJECT_ROOT, X86_REGISTER_NAMES, assemblers, createX86Emulator, defaultResourceUrl, fasmDiagnostics, gnuDiagnostics, isNodeRuntime, ldDiagnostics, locateDiagnosticColumn, nasmDiagnostics, observeCallbackResult, readResourceBytes, selectX86Source, stageX86Project, toResourceUrl, validateX86Project, x86ProjectSourcePath, x86ProjectText };
 
 //# sourceMappingURL=index.mjs.map