hzengine-core/src/index.ts

An Visual Novel Engine for Zepp OS

/**
 * HZEngineCore
 * @copyright Copyright (c) 2024 CuberQAQ. All rights reserved.
 */

import { Async } from "./async/index.js";
import { Audio } from "./audio/index.js";
import { Config } from "./config/index.js";
import { Debug } from "./debug/index.js";
import Platform from "./platform/index.js";
import { basic_command } from "./plugins/basic_command/index.js";
import { global_gesture } from "./plugins/global_gesture/index.js";
import { registerPlugin } from "./plugins/transform/index.js";
import { Script } from "./script/index.js";
import { Storage } from "./storage/index.js";
import { System } from "./system/index.js";
import { UI } from "./ui/index.js";

class HZEngineCore<PlatformType extends Platform = any> {
  private _eventCallbacks: Map<string, Set<Function>> = new Map();
  public storage;
  public async;
  public ui;
  public script;
  public system;
  public config;
  public audio;
  public debug;
  constructor(public platform: PlatformType) {
    // 請不要調整這裡的初始化順序，不然會有問題（裝飾器裡有時候要用到前面初始化的東西）
    this.storage = new Storage(this);
    this.async = new Async(this);
    this.ui = new UI(this);
    this.script = new Script(this);
    this.system = new System(this);
    this.config = new Config(this);
    this.audio = new Audio(this);
    this.debug = new Debug(this);

    // internal plugin
    this.loadPlugin("global_gesture", global_gesture);
    this.loadPlugin("transform", registerPlugin);
    this.loadPlugin("basic_command", basic_command);
  }
  loadProject(options: {
    projectPath: string;
    cachePath: string;
    savePath: string;
  }) {
    this.storage.loadProject(options);
  }
  start(callback?: () => unknown) {
    // this.system.start()
    Async.nextTick(() => {
      this.debug.log("[HZEngine] Game Start");
      let title = this.storage.packageData?.name;
      if (title == null) {
        throw `[HZEngine] project name is null, please loadProject first or check your project.json format`;
      }
      this.ui.getRouter("page")!.push("title", {
        title,
      });

      // this.on("gameEnd", () => {
      //   let router = this.ui.getRouter("page")!;
      //   if (router.length > 0) return;
      //   router.push("title", {
      //     title,
      //   });
      // });
      callback?.();
    });
  }

  end() {
    this.debug.log("[HZEngine] Game End, return to title");

    let title = this.storage.packageData?.name;
    if (title == null) {
      throw `[HZEngine] project name is null, please loadProject first or check your project.json format`;
    }

    this.system.condition = System.Condition.Free;

    this.ui.resetUI();

    if (this.ui.getRouter("page")!.length > 0) return;
    this.ui.getRouter("page")!.push("title", {
      title,
    });
  }

  public plugins: Map<string, unknown> = new Map();
  // Load Plugin
  loadPlugin(name: string, plugin: Plugin<PlatformType>) {
    this.debug.log(`[HZEngine] load plugin [${name}]`);
    let slot = plugin(this);
    if (slot != undefined) this.plugins.set(name, slot);
  }

  // Event Bus
  on(event: string, cb: Function) {
    if (this._eventCallbacks.has(event)) {
      this._eventCallbacks.get(event)!.add(cb);
    } else {
      this._eventCallbacks.set(event, new Set<Function>().add(cb));
    }
  }
  off(event: string, cb: Function): boolean {
    return !!this._eventCallbacks.get(event)?.delete(cb);
  }
  emit(event: string, ...args: any[]) {
    this._eventCallbacks.get(event)?.forEach((cb) => {
      cb(...args);
    });
  }
}

type Plugin<PlatformType extends Platform> = (core: HZEngineCore<PlatformType>) => any;

export { HZEngineCore, UI, Storage, Script, System, Async, type Platform };
export * as TransformPlugin from "./plugins/transform/index.js";