Method tryExecuteExport

src/engine/SingleMacroEngine.ts:204–360

(
		engine: MacroChoiceEngine,
		macroChoice: IMacroChoice,
		memberAccess: string[],
	)

	}

	private async tryExecuteExport(
		engine: MacroChoiceEngine,
		macroChoice: IMacroChoice,
		memberAccess: string[],
	): Promise<{ executed: boolean; result?: unknown }> {
		const originalCommands = macroChoice.macro?.commands;
		if (!originalCommands?.length) {
			return { executed: false };
		}

		const userScriptCommands = originalCommands
			.map((command, index) => ({ command, index }))
			.filter(
				(entry): entry is { command: IUserScript; index: number } =>
					entry.command.type === CommandType.UserScript,
			);

		if (userScriptCommands.length === 0) {
			return { executed: false };
		}

		const selection = await this.selectUserScriptCandidate(
			macroChoice,
			userScriptCommands,
			memberAccess,
		);
		const candidateId = selection.candidate.command.id;
		const preCommands = originalCommands.slice(0, selection.candidate.index);

		try {
			if (preCommands.length) {
				await engine.runSubset(preCommands);
				this.ensureNotAborted();
			}

			const updatedCommands = macroChoice.macro?.commands ?? originalCommands;
			// Pre-commands may have mutated the commands array, so re-resolve the selected
			// command by its stable id. Both the candidate and the post-command slice are
			// derived from this refreshed index so they cannot drift apart. The original
			// positional index is only a fallback for legacy commands that genuinely have
			// no id; if the command HAD an id but it is now gone (removed mid-run), leave
			// the index unresolved so the guard below aborts rather than silently routing
			// to a neighbouring script.
			let refreshedIndex: number;
			if (candidateId !== undefined) {
				refreshedIndex = updatedCommands.findIndex(
					(command) =>
						command.id === candidateId &&
						command.type === CommandType.UserScript,
				);
			} else {
				refreshedIndex = selection.candidate.index;
			}
			const refreshedCandidate =
				refreshedIndex >= 0 ? updatedCommands[refreshedIndex] : undefined;
			if (!refreshedCandidate || refreshedCandidate.type !== CommandType.UserScript) {
				throw new MacroAbortError(
					`Could not resolve the member-access script for '${macroChoice.name}'.`,