@iruka-edu/create-iruka-game 1.0.2 → 1.0.4

package/dist/index.cjs

@@ -65,9 +65,17 @@ async function init() {
       name: "token",
       message: "Nh\u1EADp GitHub Token (\u0111\u1EC3 c\xE0i \u0111\u1EB7t SDK):",
       validate: (value) => value.length < 10 ? "Token kh\xF4ng h\u1EE3p l\u1EC7" : true
+    },
+    // [MỚI] Câu hỏi Install
+    {
+      type: "confirm",
+      name: "shouldInstall",
+      message: "T\u1EF1 \u0111\u1ED9ng t\u1EA3i th\u01B0 vi\u1EC7n ngay b\xE2y gi\u1EDD? (M\u1EA5t v\xE0i ph\xFAt)",
+      initial: false
+      // Mặc định là KHÔNG
     }
   ]);
-  const { projectName, templateType, token } = response;
+  const { projectName, templateType, token, shouldInstall } = response;
   if (!projectName || !templateType || !token) process.exit(1);
   const root = import_node_path.default.join(process.cwd(), projectName);
   const templateDir = import_node_path.default.resolve(__dirname, `../templates/${templateType}`);
@@ -94,29 +102,45 @@ async function init() {
 //npm.pkg.github.com/:_authToken=${token}
 `;
   import_fs_extra.default.writeFileSync(import_node_path.default.join(root, ".npmrc"), npmrcContent.trim());
-  const gitignoreContent = `
-node_modules
-.npmrc
-.env
+  const gitignoreSrc = import_node_path.default.join(root, "_gitignore");
+  const gitignoreDest = import_node_path.default.join(root, ".gitignore");
+  if (import_fs_extra.default.existsSync(gitignoreSrc)) {
+    import_fs_extra.default.renameSync(gitignoreSrc, gitignoreDest);
+  } else {
+    const basicGitignore = `node_modules
 dist
-.DS_Store
-`.trim();
-  import_fs_extra.default.writeFileSync(import_node_path.default.join(root, ".gitignore"), gitignoreContent);
-  console.log(import_picocolors.default.blue("\u{1F4E6} \u0110ang c\xE0i \u0111\u1EB7t th\u01B0 vi\u1EC7n..."));
+.npmrc
+.env`;
+    import_fs_extra.default.writeFileSync(gitignoreDest, basicGitignore);
+  }
+  if (shouldInstall) {
+    console.log(import_picocolors.default.blue("\u{1F4E6} \u0110ang c\xE0i \u0111\u1EB7t th\u01B0 vi\u1EC7n..."));
+    try {
+      const userAgent2 = process.env.npm_config_user_agent || "";
+      const pkgManager2 = userAgent2.startsWith("pnpm") ? "pnpm" : "npm";
+      (0, import_node_child_process.execSync)(`${pkgManager2} install`, { cwd: root, stdio: "inherit" });
+      console.log(import_picocolors.default.green(`
+\u2705 C\xE0i \u0111\u1EB7t ho\xE0n t\u1EA5t!`));
+    } catch (e) {
+      console.error(import_picocolors.default.red("\u274C L\u1ED7i khi c\xE0i \u0111\u1EB7t. Vui l\xF2ng th\u1EED ch\u1EA1y th\u1EE7 c\xF4ng."));
+    }
+  } else {
+    console.log(import_picocolors.default.yellow(`
+\u26A0\uFE0F  \u0110\xE3 b\u1ECF qua b\u01B0\u1EDBc c\xE0i \u0111\u1EB7t.`));
+  }
   try {
-    const userAgent = process.env.npm_config_user_agent || "";
-    const pkgManager = userAgent.startsWith("pnpm") ? "pnpm" : "npm";
-    (0, import_node_child_process.execSync)(`${pkgManager} install`, { cwd: root, stdio: "inherit" });
     (0, import_node_child_process.execSync)("git init", { cwd: root, stdio: "ignore" });
-    console.log(import_picocolors.default.green(`
-\u2705 Th\xE0nh c\xF4ng! Game ${templateType} \u0111\xE3 s\u1EB5n s\xE0ng.`));
-    console.log(`
-\u{1F449} Ch\u1EA1y l\u1EC7nh sau \u0111\u1EC3 b\u1EAFt \u0111\u1EA7u:
-`);
-    console.log(import_picocolors.default.cyan(`  cd ${projectName}`));
-    console.log(import_picocolors.default.cyan(`  ${pkgManager} run dev`));
-  } catch (error) {
-    console.error(import_picocolors.default.red("\u274C L\u1ED7i c\xE0i \u0111\u1EB7t. Ki\u1EC3m tra l\u1EA1i Token."));
+  } catch {
+  }
+  console.log(`
+\u{1F389} Project \u0111\xE3 s\u1EB5n s\xE0ng t\u1EA1i: ${import_picocolors.default.cyan(root)}`);
+  console.log(`\u{1F449} C\xE1c b\u01B0\u1EDBc ti\u1EBFp theo:`);
+  console.log(`   cd ${projectName}`);
+  const userAgent = process.env.npm_config_user_agent || "";
+  const pkgManager = userAgent.startsWith("pnpm") ? "pnpm" : "npm";
+  if (!shouldInstall) {
+    console.log(`   ${pkgManager} install`);
   }
+  console.log(`   ${pkgManager} run dev`);
 }
 init().catch((e) => console.error(e));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iruka-edu/create-iruka-game",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Create Iruka mini game (React + Phaser template)",
   "license": "MIT",
   "type": "module",

package/templates/basic-phaser/_gitignore

@@ -0,0 +1,29 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Dependencies
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs
+*.njsproj
+*.sln
+*.sw?
+
+# Security [QUAN TRỌNG]
+.env
+.npmrc

package/templates/basic-phaser/index.html

@@ -6,7 +6,7 @@
     <title>Basic Phaser Game</title>
   </head>
   <body>
-    <div id="game-container"></div>
+    <div id="app"></div>
     <script type="module" src="/src/main.ts"></script>
   </body>
 </html>

package/templates/basic-phaser/src/core/GameAdapter.ts

@@ -0,0 +1,61 @@
+import {
+  connectToHub,
+  type GameBridge,
+  type LaunchContext,
+} from "@iruka-edu/game-core";
+
+class GameAdapter {
+  private static instance: GameAdapter;
+  private bridge: GameBridge | null = null;
+
+  // Singleton pattern để truy cập mọi nơi
+  public static getInstance(): GameAdapter {
+    if (!GameAdapter.instance) {
+      GameAdapter.instance = new GameAdapter();
+    }
+    return GameAdapter.instance;
+  }
+
+  // 1. Kết nối (Gọi 1 lần ở main.ts)
+  public async init(): Promise<LaunchContext> {
+    try {
+      this.bridge = await connectToHub();
+      console.log("🔌 Connected to Hub. Context:", this.bridge.context);
+      return this.bridge.context;
+    } catch (err) {
+      console.error("Failed to connect", err);
+      throw err;
+    }
+  }
+
+  // Helper lấy context hiện tại (difficulty, locale...)
+  public getContext(): LaunchContext | undefined {
+    return this.bridge?.context;
+  }
+
+  // 2. Báo cáo Game Ready (khi tải xong assets)
+  public notifyReady() {
+    this.bridge?.send("EVT:READY");
+  }
+
+  // 3. Gửi điểm số / Kết thúc game
+  public submitResult(score: number, maxScore: number, data?: any) {
+    // Tự động tính % hoàn thành
+    const accuracy = maxScore > 0 ? score / maxScore : 0;
+
+    this.bridge?.send("EVT:COMPLETE", {
+      score,
+      accuracy,
+      completion: 1.0, // Đã chơi xong
+      timestamp: Date.now(),
+      detail: data, // Metadata thêm (số câu đúng, sai...)
+    });
+  }
+
+  // 4. Lưu game (Throttle save sẽ được handle ở Core hoặc ở đây)
+  public saveState(state: any) {
+    this.bridge?.send("REQUEST_SAVE", state);
+  }
+}
+
+export const adapter = GameAdapter.getInstance();

package/templates/basic-phaser/src/core/mockData.ts

@@ -0,0 +1,9 @@
+export const mockContext = {
+  difficulty: "medium",
+  locale: "vi",
+  userData: {
+    id: "user_123",
+    name: "Iruka Player",
+  },
+  config: {},
+};

package/templates/basic-phaser/src/main.ts

@@ -1,30 +1,47 @@
 import Phaser from "phaser";
+import "./style.css";
+import { adapter } from "./core/GameAdapter";
+import { BootScene } from "./scenes/BootScene";
+import { PreloadScene } from "./scenes/PreloadScene";
+import { GameScene } from "./scenes/GameScene";
+import { GAME_WIDTH, GAME_HEIGHT } from "./shared/constants";
 
-class DemoScene extends Phaser.Scene {
-  constructor() {
-    super("DemoScene");
-  }
+// Config Phaser
+const config: Phaser.Types.Core.GameConfig = {
+  type: Phaser.AUTO,
+  width: GAME_WIDTH,
+  height: GAME_HEIGHT,
+  parent: "app",
+  scale: {
+    mode: Phaser.Scale.FIT,
+    autoCenter: Phaser.Scale.CENTER_BOTH,
+  },
+  scene: [BootScene, PreloadScene, GameScene],
+};
 
-  preload() {
-    // Preload assets here
-  }
+// Hàm khởi tạo chính
+async function bootstrap() {
+  try {
+    console.log("🎮 Initializing Game...");
+
+    // 1. Đợi kết nối SDK (hoặc Mock nếu chạy local)
+    // SDK game-core sẽ tự động handle Mock Mode nếu không phát hiện được Hub
+    const context = await adapter.init();
 
-  create() {
-    this.add
-      .text(400, 300, "Iruka Basic Phaser Template", {
-        fontSize: "32px",
-        color: "#00ff00",
-      })
-      .setOrigin(0.5);
+    // 2. Sau khi có context, mới start game
+    const game = new Phaser.Game(config);
+
+    // 3. Truyền context vào Global Registry của Phaser để các Scene dùng
+    game.registry.set("context", context);
+  } catch (error) {
+    console.error("Critical Error:", error);
+    document.body.innerHTML = `
+      <div style="color: white; text-align: center;">
+        <h1>Không thể tải game :(</h1>
+        <p>${error instanceof Error ? error.message : "Lỗi kết nối SDK"}</p>
+      </div>
+    `;
   }
 }
 
-const config: Phaser.Types.Core.GameConfig = {
-  type: Phaser.AUTO,
-  width: 800,
-  height: 600,
-  scene: DemoScene,
-  parent: "game-container",
-};
-
-new Phaser.Game(config);
+bootstrap();

package/templates/basic-phaser/src/scenes/BootScene.ts

@@ -0,0 +1,16 @@
+import { Scene } from "phaser";
+import { SCENES } from "../shared/constants";
+
+export class BootScene extends Scene {
+  constructor() {
+    super(SCENES.BOOT);
+  }
+
+  preload() {
+    // Load minimal assets for loading screen if needed
+  }
+
+  create() {
+    this.scene.start(SCENES.PRELOAD);
+  }
+}

package/templates/basic-phaser/src/scenes/GameScene.ts

@@ -0,0 +1,112 @@
+import { Scene } from "phaser";
+import { adapter } from "../core/GameAdapter";
+import type { LaunchContext } from "@iruka-edu/game-core";
+import { SCENES } from "../shared/constants";
+
+export class GameScene extends Scene {
+  private context!: LaunchContext;
+  private score: number = 0;
+  private scoreText!: Phaser.GameObjects.Text;
+
+  constructor() {
+    super(SCENES.GAME);
+  }
+
+  init() {
+    // Lấy context đã lưu ở bước bootstrap trong main.ts
+    this.context = this.registry.get("context");
+    console.log("Game Mode:", this.context.difficulty);
+  }
+
+  create() {
+    const { width, height } = this.scale;
+
+    // Background color based on difficulty
+    const bgColors: Record<string, number> = {
+      easy: 0x27ae60,
+      medium: 0x2980b9,
+      hard: 0xc0392b,
+    };
+
+    this.add
+      .rectangle(
+        0,
+        0,
+        width,
+        height,
+        bgColors[this.context.difficulty || "medium"]
+      )
+      .setOrigin(0);
+
+    // Welcome text
+    this.add
+      .text(width / 2, 100, "Iruka Mini Game", {
+        fontSize: "48px",
+        color: "#ffffff",
+      })
+      .setOrigin(0.5);
+
+    this.add
+      .text(width / 2, 160, `Mode: ${this.context.difficulty?.toUpperCase()}`, {
+        fontSize: "24px",
+        color: "#ffffff",
+      })
+      .setOrigin(0.5);
+
+    // Add Logo
+    const logo = this.add.image(width / 2, height / 2, "logo");
+    logo.setInteractive();
+
+    // Score Text
+    this.scoreText = this.add
+      .text(width / 2, height - 100, `Score: ${this.score}`, {
+        fontSize: "32px",
+        color: "#ffffff",
+      })
+      .setOrigin(0.5);
+
+    // Instruction
+    this.add
+      .text(width / 2, height - 50, "Click logo to score & finish", {
+        fontSize: "18px",
+        color: "#ecf0f1",
+      })
+      .setOrigin(0.5);
+
+    // Interaction
+    logo.on("pointerdown", () => {
+      this.handleWin();
+    });
+
+    // Animation loop
+    this.tweens.add({
+      targets: logo,
+      y: height / 2 - 20,
+      duration: 1000,
+      ease: "Sine.easeInOut",
+      yoyo: true,
+      loop: -1,
+    });
+  }
+
+  private handleWin() {
+    this.score += 100;
+    this.scoreText.setText(`Score: ${this.score}`);
+
+    // Gửi kết quả về Hub
+    adapter.submitResult(this.score, 100, { stars: 3 });
+
+    // Feedback
+    this.add
+      .text(
+        this.scale.width / 2,
+        this.scale.height / 2 + 100,
+        "RESULT SUBMITTED!",
+        {
+          fontSize: "40px",
+          color: "#f1c40f",
+        }
+      )
+      .setOrigin(0.5);
+  }
+}

package/templates/basic-phaser/src/scenes/PreloadScene.ts

@@ -0,0 +1,56 @@
+import { Scene } from "phaser";
+import { SCENES } from "../shared/constants";
+import { adapter } from "../core/GameAdapter";
+
+export class PreloadScene extends Scene {
+  constructor() {
+    super(SCENES.PRELOAD);
+  }
+
+  preload() {
+    // Create loading bar
+    const width = this.cameras.main.width;
+    const height = this.cameras.main.height;
+
+    const progressBar = this.add.graphics();
+    const progressBox = this.add.graphics();
+    progressBox.fillStyle(0x222222, 0.8);
+    progressBox.fillRect(width / 2 - 160, height / 2 - 25, 320, 50);
+
+    const loadingText = this.make.text({
+      x: width / 2,
+      y: height / 2 - 50,
+      text: "Loading...",
+      style: {
+        font: "20px monospace",
+        color: "#ffffff",
+      },
+    });
+    loadingText.setOrigin(0.5, 0.5);
+
+    this.load.on("progress", (value: number) => {
+      progressBar.clear();
+      progressBar.fillStyle(0xffffff, 1);
+      progressBar.fillRect(width / 2 - 150, height / 2 - 15, 300 * value, 30);
+    });
+
+    this.load.on("complete", () => {
+      progressBar.destroy();
+      progressBox.destroy();
+      loadingText.destroy();
+
+      // Báo cáo SDK Ready
+      adapter.notifyReady();
+    });
+
+    // Tải assets mẫu
+    this.load.image(
+      "logo",
+      "https://raw.githubusercontent.com/photonstorm/phaser3-examples/master/public/assets/sprites/phaser3-logo.png"
+    );
+  }
+
+  create() {
+    this.scene.start(SCENES.GAME);
+  }
+}

package/templates/basic-phaser/src/shared/constants.ts

@@ -0,0 +1,9 @@
+export const SCENES = {
+  BOOT: "BootScene",
+  PRELOAD: "PreloadScene",
+  GAME: "GameScene",
+  RESULT: "ResultScene",
+};
+
+export const GAME_WIDTH = 1280;
+export const GAME_HEIGHT = 720;

package/templates/basic-phaser/src/style.css

@@ -0,0 +1,21 @@
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  overflow: hidden;
+  background-color: #000;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  height: 100vh;
+  width: 100vw;
+  font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+}
+
+#app {
+  width: 100%;
+  height: 100%;
+}

package/templates/react-phaser/_gitignore

@@ -0,0 +1,29 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Dependencies
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs
+*.njsproj
+*.sln
+*.sw?
+
+# Security [QUAN TRỌNG]
+.env
+.npmrc