* Copyright (c) 2021-2026 Huawei Device Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef ES2PANDA_COMPILER_CORE_EMITTER_H
#define ES2PANDA_COMPILER_CORE_EMITTER_H
#include "compiler/base/literals.h"
#include <string_view>
#include <unordered_map>
#include "util/ustring.h"
namespace ark::pandasm {
struct Program;
class Function;
class Ins;
namespace debuginfo {
struct LocalVariable;
}
}
namespace ark::es2panda::varbinder {
class Scope;
class LocalVariable;
}
namespace ark::es2panda::public_lib {
struct Context;
}
namespace ark::es2panda::compiler {
class CodeGen;
class DebugInfo;
class Label;
class IRNode;
class ProgramElement;
class RegSpiller;
class ETSEmitter;
class FunctionEmitter {
public:
explicit FunctionEmitter(const CodeGen *cg, ProgramElement *programElement)
: cg_(cg), programElement_(programElement)
{
}
virtual ~FunctionEmitter() = default;
NO_COPY_SEMANTIC(FunctionEmitter);
NO_MOVE_SEMANTIC(FunctionEmitter);
void Generate();
protected:
using VariablesStartsMap = std::unordered_map<const varbinder::Variable *, uint32_t>;
protected:
virtual pandasm::Function *GenFunctionSignature() = 0;
virtual void GenFunctionAnnotations(pandasm::Function *func) = 0;
virtual void GenVariableSignature(pandasm::debuginfo::LocalVariable &variableDebug,
varbinder::LocalVariable *variable) const = 0;
virtual void GenSourceFileDebugInfo(pandasm::Function *func) = 0;
void GenInstructionDebugInfo(const IRNode *ins, ark::pandasm::Ins *pandaIns);
void GenFunctionInstructions(pandasm::Function *func);
void GenScopeVariableInfo(pandasm::Function *func, const varbinder::Scope *scope) const;
void GenScopeVariableInfoEnd(pandasm::Function *func, const varbinder::Scope *scope, uint32_t count,
uint32_t scopeStart, const VariablesStartsMap &starts) const;
void GenFunctionCatchTables(ark::pandasm::Function *func);
void GenVariablesDebugInfo(pandasm::Function *func);
util::StringView SourceCode() const;
const CodeGen *Cg() const
{
return cg_;
}
ProgramElement *GetProgramElement() const
{
return programElement_;
}
private:
const CodeGen *cg_;
ProgramElement *programElement_;
};
class Emitter {
public:
virtual ~Emitter();
NO_COPY_SEMANTIC(Emitter);
NO_MOVE_SEMANTIC(Emitter);
void AddLiteralBuffer(const LiteralBuffer &literals, uint32_t index);
virtual void AddProgramElement(ProgramElement *programElement);
static void DumpAsm(const pandasm::Program *prog);
pandasm::Program *DumpDebugInfo();
uint32_t &LiteralBufferIndex()
{
return literalBufferIndex_;
}
virtual void EmitRecords() = 0;
virtual bool IsETSEmitter()
{
return false;
}
ETSEmitter *AsETSEmitter()
{
ES2PANDA_ASSERT(IsETSEmitter());
return reinterpret_cast<ETSEmitter *>(this);
}
protected:
explicit Emitter(const public_lib::Context *context);
pandasm::Program *Program() const
{
return prog_;
}
pandasm::Program *SetProgram(pandasm::Program *prog)
{
return prog_ = prog;
}
const public_lib::Context *Context() const
{
return context_;
}
private:
pandasm::Program *prog_ = nullptr;
const public_lib::Context *context_ = nullptr;
uint32_t literalBufferIndex_ {};
};
}
#endif