nadesiko3 3.3.45 → 3.3.49

package/core/src/nako_logger.mjs

@@ -0,0 +1,199 @@
+/** NakoLogger */
+import { NakoError } from './nako_errors.mjs';
+import { NakoColors } from './nako_colors.mjs';
+/** ログレベル - 数字が高いほど優先度が高い。 */
+export class LogLevel {
+    // string to level no
+    static fromS(levelStr) {
+        let level = LogLevel.trace;
+        switch (levelStr) {
+            case 'all':
+                level = LogLevel.all;
+                break;
+            case 'trace':
+                level = LogLevel.trace;
+                break;
+            case 'debug':
+                level = LogLevel.debug;
+                break;
+            case 'info':
+                level = LogLevel.info;
+                break;
+            case 'warn':
+                level = LogLevel.warn;
+                break;
+            case 'error':
+                level = LogLevel.error;
+                break;
+            case 'stdout':
+                level = LogLevel.stdout;
+                break;
+            default:
+                throw new Error('[NakoLogger] unknown logger level:' + levelStr);
+        }
+        return level;
+    }
+    static toString(level) {
+        const levels = ['all', 'trace', 'debug', 'info', 'warn', 'error', 'stdout'];
+        return levels[level];
+    }
+}
+// level no
+LogLevel.all = 0;
+LogLevel.trace = 1;
+LogLevel.debug = 2;
+LogLevel.info = 3;
+LogLevel.warn = 4;
+LogLevel.error = 5;
+LogLevel.stdout = 6;
+/**
+ * エラー位置を日本語で表示する。
+ * たとえば `stringifyPosition({ file: "foo.txt", line: 5 })` は `"foo.txt(6行目):"` を出力する。
+ */
+function stringifyPosition(p) {
+    if (!p) {
+        return '';
+    }
+    return `${p.file || ''}${p.line === undefined ? '' : `(${p.line + 1}行目): `}`;
+}
+/**
+ * コンパイラのログ情報を出力するためのクラス。
+ * trace(), debug(), info(), warn(), error() はそれぞれメッセージに `[警告]` などのタグとエラー位置の日本語表現を付けて表示する。
+ * error() は引数にエラーオブジェクトを受け取ることもでき、その場合エラーオブジェクトからエラーメッセージとエラー位置が取り出される。
+ */
+export class NakoLogger {
+    constructor() {
+        this.listeners = [];
+        this.logs = '';
+        this.position = '';
+    }
+    getErrorLogs() {
+        return [this.logs.replace(/\s+$/, ''), this.position];
+    }
+    clear() {
+        this.logs = '';
+        this.position = '';
+    }
+    /**
+     * sendメソッドで送られた情報を受け取るコールバックを設定する。
+     * @param levelStr
+     * @param callback
+     */
+    addListener(levelStr, callback) {
+        const level = LogLevel.fromS(levelStr);
+        this.listeners.push({ level, callback });
+    }
+    /**
+     * addListenerメソッドで設定したコールバックを取り外す。
+     * @param {LogListener} callback
+     */
+    removeListener(callback) {
+        this.listeners = this.listeners.filter((l) => l.callback !== callback);
+    }
+    /** 本体開発時のデバッグ情報（debugより更に詳細な情報）
+     * @param {string} message
+     * @param {Position | null} position
+     */
+    trace(message, position = null) {
+        this.sendI(LogLevel.trace, `${NakoColors.color.bold}[デバッグ情報（詳細）]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position);
+    }
+    /** 本体開発時のデバッグ情報
+     * @param {string} message
+     * @param {Position | null} position
+     */
+    debug(message, position = null) {
+        this.sendI(LogLevel.debug, `${NakoColors.color.bold}[デバッグ情報]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position);
+    }
+    /** ユーザープログラムのデバッグ情報（あまり重要ではないもの）
+     * @param {string} message
+     * @param {Position | null} position
+     */
+    info(message, position = null) {
+        this.sendI(LogLevel.info, `${NakoColors.color.bold}${NakoColors.color.blue}[情報]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position);
+    }
+    /** ユーザープログラムのデバッグ情報（重要なもの）
+     * @param {string} message
+     * @param {Position | null} position
+     */
+    warn(message, position = null) {
+        this.sendI(LogLevel.warn, `${NakoColors.color.bold}${NakoColors.color.green}[警告]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position);
+    }
+    /** エラーメッセージ
+     * @param {string | Error} message
+     * @param {Position | null} position
+     */
+    error(message, position = null) {
+        // NakoErrorか判定 (`message instanceof NakoError`では判定できない場合がある)
+        if (message instanceof Error && typeof message.type === 'string') {
+            // NakoErrorか
+            const etype = message.type;
+            switch (etype) {
+                case 'NakoRuntimeError':
+                case 'NakoError':
+                    if (message instanceof NakoError) {
+                        const e = message;
+                        let pos = position;
+                        if (pos === null || pos === undefined) {
+                            pos = { file: e.file, line: e.line || 0, startOffset: 0, endOffset: 0 };
+                        }
+                        this.sendI(LogLevel.error, e.message, pos);
+                        return;
+                    }
+            }
+        }
+        if (message instanceof Error) {
+            // 一般のエラーの場合は、messageのみ取得できる。
+            message = message.message;
+        }
+        this.sendI(LogLevel.error, `${NakoColors.color.bold}${NakoColors.color.red}[エラー]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position);
+    }
+    /** ユーザープログラムのデバッグ情報（すべて)
+     * @param {string} message
+     * @param {Position | null} position
+     */
+    stdout(message, position = null) {
+        this.sendI(LogLevel.stdout, `${message}`, position);
+    }
+    /** 指定したlevelのlistenerにメッセージを送る。htmlやbrowserConsoleは無ければnodeConsoleから生成する。 */
+    send(levelStr, nodeConsole, position, html = null, browserConsole = null) {
+        const i = LogLevel.fromS(levelStr);
+        this.sendI(i, nodeConsole, position, html, browserConsole);
+    }
+    /** 指定したlevelのlistenerにメッセージを送る。htmlやbrowserConsoleは無ければnodeConsoleから生成する。 */
+    sendI(level, nodeConsole, position, html = null, browserConsole = null) {
+        const makeData = () => {
+            // nodeConsoleからnoColor, nodeCondoleなどの形式を生成する。
+            const formats = NakoColors.convertColorTextFormat(nodeConsole);
+            // ログが複数行から構成される場合は、htmlでの表現にborderを設定する。
+            let style = '';
+            if (nodeConsole.includes('\n')) {
+                style += 'border-top: 1px solid #8080806b; border-bottom: 1px solid #8080806b;';
+            }
+            // 各イベントリスナーが受け取るデータ
+            const data = {
+                noColor: formats.noColor,
+                nodeConsole: formats.nodeConsole,
+                browserConsole: browserConsole || formats.browserConsole,
+                html: `<div style="${style}">` + (html || formats.html) + '</div>',
+                level: LogLevel.toString(level),
+                position
+            };
+            return data;
+        };
+        // エラーならログに追加
+        if (level === LogLevel.error) {
+            const data = makeData();
+            this.logs += data.noColor + '\n';
+            if (position && this.position !== null) {
+                this.position = `l${position.line}:${position.file}`;
+            }
+        }
+        // 登録したリスナーに通知する
+        for (const l of this.listeners) {
+            if (l.level <= level) {
+                const data = makeData();
+                l.callback(data);
+            }
+        }
+    }
+}

package/core/src/nako_logger.mts

@@ -0,0 +1,232 @@
+/** NakoLogger */
+import { NakoError } from './nako_errors.mjs'
+import { NakoColors } from './nako_colors.mjs'
+import { Token, Ast } from './nako_types.mjs'
+
+/** ログレベル - 数字が高いほど優先度が高い。 */
+
+export class LogLevel {
+  // level no
+  public static all = 0
+  public static trace = 1
+  public static debug = 2
+  public static info = 3
+  public static warn = 4
+  public static error = 5
+  public static stdout = 6
+
+  // string to level no
+  public static fromS (levelStr: string): number {
+    let level: number = LogLevel.trace
+    switch (levelStr) {
+      case 'all': level = LogLevel.all; break
+      case 'trace': level = LogLevel.trace; break
+      case 'debug': level = LogLevel.debug; break
+      case 'info': level = LogLevel.info; break
+      case 'warn': level = LogLevel.warn; break
+      case 'error': level = LogLevel.error; break
+      case 'stdout': level = LogLevel.stdout; break
+      default:
+        throw new Error('[NakoLogger] unknown logger level:' + levelStr)
+    }
+    return level
+  }
+
+  public static toString (level: number): string {
+    const levels: string[] = ['all', 'trace', 'debug', 'info', 'warn', 'error', 'stdout']
+    return levels[level]
+  }
+}
+
+/** Source Code Position */
+interface Position {
+  startOffset: number;
+  endOffset: number;
+  line: number;
+  file: string;
+}
+type PositionOrNull = Position | Token | Ast | null;
+
+interface LogListenerData {
+  position: PositionOrNull; // ログの送信時にposition引数で渡されたデータ
+  level: string; // ログの重要度(内部的にはnumber、入出力時stringに変換)
+  noColor: string; // 例: '[情報](2行目): foo'
+  nodeConsole: string; // 例: '\x1B[1m\x1B[34m[情報]\x1B[0m(2行目): foo\x1B[0m'
+  browserConsole: string[]; // 例: ['%c%c[情報]%c(2行目): foo', 'color: inherit; font-weight: bold;', ...]
+  html: string; // 例: '<div style="">...</div>'
+ }
+type LogListener = (data: LogListenerData) => void;
+
+/**
+ * エラー位置を日本語で表示する。
+ * たとえば `stringifyPosition({ file: "foo.txt", line: 5 })` は `"foo.txt(6行目):"` を出力する。
+ */
+function stringifyPosition (p: PositionOrNull): string {
+  if (!p) { return '' }
+  return `${p.file || ''}${p.line === undefined ? '' : `(${p.line + 1}行目): `}`
+}
+
+interface NakoLoggerListener {
+  level: number;
+  callback: LogListener;
+}
+
+/**
+ * コンパイラのログ情報を出力するためのクラス。
+ * trace(), debug(), info(), warn(), error() はそれぞれメッセージに `[警告]` などのタグとエラー位置の日本語表現を付けて表示する。
+ * error() は引数にエラーオブジェクトを受け取ることもでき、その場合エラーオブジェクトからエラーメッセージとエラー位置が取り出される。
+ */
+export class NakoLogger {
+  private listeners: NakoLoggerListener[];
+  private logs: string
+  private position: string
+  public constructor () {
+    this.listeners = []
+    this.logs = ''
+    this.position = ''
+  }
+
+  public getErrorLogs (): [string, string] {
+    return [this.logs.replace(/\s+$/, ''), this.position]
+  }
+
+  public clear (): void {
+    this.logs = ''
+    this.position = ''
+  }
+
+  /**
+   * sendメソッドで送られた情報を受け取るコールバックを設定する。
+   * @param levelStr
+   * @param callback
+   */
+  public addListener (levelStr: string, callback: LogListener): void {
+    const level: number = LogLevel.fromS(levelStr)
+    this.listeners.push({ level, callback })
+  }
+
+  /**
+   * addListenerメソッドで設定したコールバックを取り外す。
+   * @param {LogListener} callback
+   */
+  public removeListener (callback: LogListener): void {
+    this.listeners = this.listeners.filter((l) => l.callback !== callback)
+  }
+
+  /** 本体開発時のデバッグ情報（debugより更に詳細な情報）
+   * @param {string} message
+   * @param {Position | null} position
+   */
+  public trace (message: string, position: PositionOrNull = null):void {
+    this.sendI(LogLevel.trace, `${NakoColors.color.bold}[デバッグ情報（詳細）]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position)
+  }
+
+  /** 本体開発時のデバッグ情報
+   * @param {string} message
+   * @param {Position | null} position
+   */
+  public debug (message: string, position: PositionOrNull = null): void {
+    this.sendI(LogLevel.debug, `${NakoColors.color.bold}[デバッグ情報]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position)
+  }
+
+  /** ユーザープログラムのデバッグ情報（あまり重要ではないもの）
+   * @param {string} message
+   * @param {Position | null} position
+   */
+  public info (message: string, position: PositionOrNull = null): void {
+    this.sendI(LogLevel.info, `${NakoColors.color.bold}${NakoColors.color.blue}[情報]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position)
+  }
+
+  /** ユーザープログラムのデバッグ情報（重要なもの）
+   * @param {string} message
+   * @param {Position | null} position
+   */
+  public warn (message: string, position: PositionOrNull = null):void {
+    this.sendI(LogLevel.warn, `${NakoColors.color.bold}${NakoColors.color.green}[警告]${NakoColors.color.reset}${stringifyPosition(position)}${message}`, position)
+  }
+
+  /** エラーメッセージ
+   * @param {string | Error} message
+   * @param {Position | null} position
+   */
+  public error (message: string | Error | NakoError, position: PositionOrNull = null):void {
+    // NakoErrorか判定 (`message instanceof NakoError`では判定できない場合がある)
+    if (message instanceof Error && typeof (message as NakoError).type === 'string') {
+      // NakoErrorか
+      const etype: string = (message as NakoError).type
+      switch (etype) {
+        case 'NakoRuntimeError':
+        case 'NakoError':
+          if (message instanceof NakoError) {
+            const e: NakoError = message as NakoError
+            let pos: any = position
+            if (pos === null || pos === undefined) {
+              pos = { file: e.file, line: e.line || 0, startOffset: 0, endOffset: 0 }
+            }
+            this.sendI(LogLevel.error, e.message, pos)
+            return
+          }
+      }
+    }
+    if (message instanceof Error) {
+      // 一般のエラーの場合は、messageのみ取得できる。
+      message = message.message
+    }
+    this.sendI(
+      LogLevel.error,
+      `${NakoColors.color.bold}${NakoColors.color.red}[エラー]${NakoColors.color.reset}${stringifyPosition(position)}${message}`,
+      position)
+  }
+
+  /** ユーザープログラムのデバッグ情報（すべて)
+   * @param {string} message
+   * @param {Position | null} position
+   */
+  public stdout (message: string, position: PositionOrNull = null): void {
+    this.sendI(LogLevel.stdout, `${message}`, position)
+  }
+
+  /** 指定したlevelのlistenerにメッセージを送る。htmlやbrowserConsoleは無ければnodeConsoleから生成する。 */
+  public send (levelStr: string, nodeConsole: string, position: PositionOrNull, html: string|null = null, browserConsole: [string, string] | null = null): void {
+    const i = LogLevel.fromS(levelStr)
+    this.sendI(i, nodeConsole, position, html, browserConsole)
+  }
+
+  /** 指定したlevelのlistenerにメッセージを送る。htmlやbrowserConsoleは無ければnodeConsoleから生成する。 */
+  public sendI (level: number, nodeConsole: string, position: PositionOrNull, html: string|null = null, browserConsole: [string, string] | null = null): void {
+    const makeData = () => {
+      // nodeConsoleからnoColor, nodeCondoleなどの形式を生成する。
+      const formats = NakoColors.convertColorTextFormat(nodeConsole)
+      // ログが複数行から構成される場合は、htmlでの表現にborderを設定する。
+      let style = ''
+      if (nodeConsole.includes('\n')) {
+        style += 'border-top: 1px solid #8080806b; border-bottom: 1px solid #8080806b;'
+      }
+      // 各イベントリスナーが受け取るデータ
+      const data: LogListenerData = {
+        noColor: formats.noColor,
+        nodeConsole: formats.nodeConsole,
+        browserConsole: browserConsole || formats.browserConsole,
+        html: `<div style="${style}">` + (html || formats.html) + '</div>', // 各行を style: block で表示するために、<div>で囲む。
+        level: LogLevel.toString(level),
+        position
+      }
+      return data
+    }
+    // エラーならログに追加
+    if (level === LogLevel.error) {
+      const data = makeData()
+      this.logs += data.noColor + '\n'
+      if (position && this.position !== null) {
+        this.position = `l${position.line}:${position.file}`
+      }
+    }
+    // 登録したリスナーに通知する
+    for (const l of this.listeners) {
+      if (l.level <= level) {
+        const data = makeData()
+        l.callback(data)
+      }
+    }
+  }
+}