freelang-v4 4.3.0

package/src/repl.ts

@@ -0,0 +1,190 @@
+// FreeLang v4.1 — REPL (Read-Eval-Print Loop)
+// 대화형 쉘 구현
+
+import * as readline from "readline";
+import { Lexer } from "./lexer";
+import { Parser } from "./parser";
+import { TypeChecker } from "./checker";
+import { Compiler } from "./compiler";
+import { VM } from "./vm";
+
+export class REPL {
+  private rl: readline.Interface;
+  private vm: VM;
+  private globals: Map<string, any> = new Map();
+  private history: string[] = [];
+  private multiLineBuffer: string = "";
+  private isMultiLine: boolean = false;
+
+  constructor() {
+    this.rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: process.stdout.isTTY !== false,
+    });
+
+    this.vm = new VM();
+  }
+
+  async start(): Promise<void> {
+    console.log("🦁 FreeLang v4.1 REPL");
+    console.log('입력: "help" (도움말), "exit" (종료), "history" (이력)\n');
+
+    while (true) {
+      try {
+        const line = await this.readline(this.isMultiLine ? "... " : "> ");
+
+        if (!line) continue;
+
+        // 특수 명령어 처리
+        if (this.handleCommand(line)) {
+          continue;
+        }
+
+        // 멀티 라인 처리
+        if (line.endsWith("\\")) {
+          this.multiLineBuffer += line.slice(0, -1) + "\n";
+          this.isMultiLine = true;
+          continue;
+        }
+
+        const fullCode = this.multiLineBuffer + line;
+        this.multiLineBuffer = "";
+        this.isMultiLine = false;
+
+        // 실행
+        await this.eval(fullCode);
+        this.history.push(fullCode);
+      } catch (e: any) {
+        console.error(`❌ ${e.message}`);
+      }
+    }
+  }
+
+  private handleCommand(input: string): boolean {
+    const trimmed = input.trim();
+
+    switch (trimmed) {
+      case "exit":
+      case "quit":
+        console.log("👋 Bye!");
+        process.exit(0);
+
+      case "help":
+        this.printHelp();
+        return true;
+
+      case "history":
+        this.printHistory();
+        return true;
+
+      case "clear":
+        console.clear();
+        return true;
+
+      default:
+        return false;
+    }
+  }
+
+  private async eval(code: string): Promise<void> {
+    try {
+      // 1. Lexer
+      const lexer = new Lexer(code);
+      const { tokens, errors: lexErrors } = lexer.tokenize();
+
+      if (lexErrors.length > 0) {
+        console.error(`❌ Lex error: ${lexErrors[0].message}`);
+        return;
+      }
+
+      // 2. Parser
+      const parser = new Parser(tokens);
+      const { program, errors: parseErrors } = parser.parse();
+
+      if (parseErrors.length > 0) {
+        console.error(`❌ Parse error: ${parseErrors[0].message}`);
+        return;
+      }
+
+      // 3. Type Checker
+      const checker = new TypeChecker();
+      const checkErrors = checker.check(program);
+
+      if (checkErrors.length > 0) {
+        console.error(`❌ Type error: ${checkErrors[0].message}`);
+        return;
+      }
+
+      // 4. Compiler
+      const compiler = new Compiler();
+      const chunk = compiler.compile(program);
+
+      // 5. VM Execution
+      const { output, error } = await this.vm.run(chunk);
+
+      if (error) {
+        console.error(`❌ Runtime error: ${error}`);
+        return;
+      }
+
+      // 출력
+      for (const line of output) {
+        console.log(line);
+      }
+    } catch (e: any) {
+      console.error(`❌ ${e.message}`);
+    }
+  }
+
+  private printHelp(): void {
+    console.log(`
+📚 FreeLang REPL 명령어:
+
+특수 명령:
+  exit, quit          프로그램 종료
+  help                이 도움말 표시
+  history             명령어 이력 표시
+  clear               화면 지우기
+
+멀티라인 입력:
+  마지막에 \\ 추가하면 다음 줄에서 계속 입력 가능
+  예: var x = 10 \\
+      var y = 20 \\
+      println(x + y)
+
+예제:
+  > var x = 10
+  > fn add(a, b) { a + b }
+  > add(x, 5)
+  15
+    `);
+  }
+
+  private printHistory(): void {
+    if (this.history.length === 0) {
+      console.log("이력이 없습니다");
+      return;
+    }
+
+    console.log("\n📜 명령어 이력:");
+    this.history.forEach((cmd, i) => {
+      console.log(`${i + 1}. ${cmd}`);
+    });
+    console.log();
+  }
+
+  private readline(prompt: string): Promise<string> {
+    return new Promise((resolve) => {
+      this.rl.question(prompt, (answer) => {
+        resolve(answer);
+      });
+    });
+  }
+}
+
+// REPL 실행
+if (require.main === module) {
+  const repl = new REPL();
+  repl.start().catch(console.error);
+}

package/src/runtime/bytecode.ts

@@ -0,0 +1,291 @@
+/**
+ * FreeLang Bytecode Definition
+ * 스택 머신의 모든 명령어를 정의
+ */
+
+import { Value } from './value';
+
+/**
+ * 모든 Bytecode 연산 타입
+ */
+export enum OpcodeType {
+  // 스택 연산
+  PUSH = 'PUSH',
+  POP = 'POP',
+  DUP = 'DUP',
+
+  // 산술 연산
+  ADD = 'ADD',
+  SUB = 'SUB',
+  MUL = 'MUL',
+  DIV = 'DIV',
+  MOD = 'MOD',
+
+  // 논리 연산
+  AND = 'AND',
+  OR = 'OR',
+  NOT = 'NOT',
+
+  // 비교 연산
+  EQ = 'EQ',
+  NE = 'NE',
+  LT = 'LT',
+  LTE = 'LTE',
+  GT = 'GT',
+  GTE = 'GTE',
+
+  // 제어 흐름
+  JUMP = 'JUMP',
+  JUMP_IF_TRUE = 'JUMP_IF_TRUE',
+  JUMP_IF_FALSE = 'JUMP_IF_FALSE',
+  CALL = 'CALL',
+  RETURN = 'RETURN',
+
+  // 변수 접근
+  LOAD_LOCAL = 'LOAD_LOCAL',
+  STORE_LOCAL = 'STORE_LOCAL',
+  LOAD_GLOBAL = 'LOAD_GLOBAL',
+  STORE_GLOBAL = 'STORE_GLOBAL',
+
+  // 배열/객체 연산
+  LOAD_ARRAY = 'LOAD_ARRAY',
+  STORE_ARRAY = 'STORE_ARRAY',
+  LOAD_OBJECT = 'LOAD_OBJECT',
+  STORE_OBJECT = 'STORE_OBJECT',
+
+  // 타입 변환
+  TO_INT = 'TO_INT',
+  TO_FLOAT = 'TO_FLOAT',
+  TO_STRING = 'TO_STRING',
+  TO_BOOL = 'TO_BOOL',
+
+  // 함수 호출
+  CALL_BUILTIN = 'CALL_BUILTIN',
+
+  // 기타
+  PRINT = 'PRINT',
+  HALT = 'HALT',
+  NOP = 'NOP',
+}
+
+/**
+ * 단일 Bytecode 명령어
+ */
+export interface Instruction {
+  op: OpcodeType;
+  arg?: any; // 명령어 인자 (값에 따라 다름)
+  line: number; // 소스 코드 라인 번호 (디버깅용)
+  column: number; // 소스 코드 열 번호 (디버깅용)
+}
+
+/**
+ * Bytecode 빌더 - 명령어를 생성하기 편하게 함
+ */
+export class BytecodeBuilder {
+  private instructions: Instruction[] = [];
+  private lineNo: number = 1;
+  private colNo: number = 1;
+
+  setLocation(line: number, col: number): void {
+    this.lineNo = line;
+    this.colNo = col;
+  }
+
+  push(value: Value): this {
+    this.instructions.push({
+      op: OpcodeType.PUSH,
+      arg: value,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  pop(): this {
+    this.instructions.push({
+      op: OpcodeType.POP,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  dup(): this {
+    this.instructions.push({
+      op: OpcodeType.DUP,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  add(): this {
+    this.instructions.push({
+      op: OpcodeType.ADD,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  sub(): this {
+    this.instructions.push({
+      op: OpcodeType.SUB,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  mul(): this {
+    this.instructions.push({
+      op: OpcodeType.MUL,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  div(): this {
+    this.instructions.push({
+      op: OpcodeType.DIV,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  mod(): this {
+    this.instructions.push({
+      op: OpcodeType.MOD,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  eq(): this {
+    this.instructions.push({
+      op: OpcodeType.EQ,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  ne(): this {
+    this.instructions.push({
+      op: OpcodeType.NE,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  lt(): this {
+    this.instructions.push({
+      op: OpcodeType.LT,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  jump(target: number): this {
+    this.instructions.push({
+      op: OpcodeType.JUMP,
+      arg: target,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  jumpIfTrue(target: number): this {
+    this.instructions.push({
+      op: OpcodeType.JUMP_IF_TRUE,
+      arg: target,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  jumpIfFalse(target: number): this {
+    this.instructions.push({
+      op: OpcodeType.JUMP_IF_FALSE,
+      arg: target,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  call(name: string, arity: number): this {
+    this.instructions.push({
+      op: OpcodeType.CALL_BUILTIN,
+      arg: { name, arity },
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  loadLocal(index: number): this {
+    this.instructions.push({
+      op: OpcodeType.LOAD_LOCAL,
+      arg: index,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  storeLocal(index: number): this {
+    this.instructions.push({
+      op: OpcodeType.STORE_LOCAL,
+      arg: index,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  print(): this {
+    this.instructions.push({
+      op: OpcodeType.PRINT,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  halt(): this {
+    this.instructions.push({
+      op: OpcodeType.HALT,
+      line: this.lineNo,
+      column: this.colNo,
+    });
+    return this;
+  }
+
+  build(): Instruction[] {
+    return this.instructions;
+  }
+}
+
+/**
+ * Bytecode 프린터 - 명령어를 읽기 좋게 출력
+ */
+export class BytecodePrinter {
+  static print(instructions: Instruction[]): string {
+    const lines: string[] = [];
+    instructions.forEach((instr, idx) => {
+      const argStr = instr.arg !== undefined ? ` ${JSON.stringify(instr.arg)}` : '';
+      lines.push(
+        `${String(idx).padStart(4, '0')}: ${instr.op.padEnd(15)}${argStr}`
+      );
+    });
+    return lines.join('\n');
+  }
+}