From 72657692ee51d0c6ec24f01469bb3f3512d7b11b Mon Sep 17 00:00:00 2001
From: Hide_D <hided62@gmail.com>
Date: Sat, 4 Mar 2023 17:10:58 +0900
Subject: [PATCH] =?UTF-8?q?feat:=20GlobalMenu=20API=20-=20GlobalMenu=20?=
 =?UTF-8?q?=EC=9E=91=EC=84=B1=EC=9A=A9=20DTO(MenuItem,=20MenuMulti,=20Menu?=
 =?UTF-8?q?Split)=20-=20d=5Fsetting=EC=97=90=20GlobalMenu=EB=A5=BC=20?=
 =?UTF-8?q?=EC=A7=81=EC=A0=91=20=EC=9E=91=EC=84=B1=20=EA=B0=80=EB=8A=A5?=
 =?UTF-8?q?=ED=95=98=EB=8F=84=EB=A1=9D=20=EC=A0=9C=EA=B3=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 hwe/d_setting/GlobalMenu.orig.php      | 53 ++++++++++++++++++++++++++
 hwe/sammo/API/Global/GetGlobalMenu.php | 47 +++++++++++++++++++++++
 hwe/sammo/DTO/MenuItem.php             | 26 +++++++++++++
 hwe/sammo/DTO/MenuMulti.php            | 19 +++++++++
 hwe/sammo/DTO/MenuSplit.php            | 20 ++++++++++
 hwe/sammo/GlobalMenu.php               | 53 ++++++++++++++++++++++++++
 hwe/ts/SammoAPI.ts                     |  2 +
 hwe/ts/defs/API/Global.ts              | 26 +++++++++++++
 8 files changed, 246 insertions(+)
 create mode 100644 hwe/d_setting/GlobalMenu.orig.php
 create mode 100644 hwe/sammo/API/Global/GetGlobalMenu.php
 create mode 100644 hwe/sammo/DTO/MenuItem.php
 create mode 100644 hwe/sammo/DTO/MenuMulti.php
 create mode 100644 hwe/sammo/DTO/MenuSplit.php
 create mode 100644 hwe/sammo/GlobalMenu.php

diff --git a/hwe/d_setting/GlobalMenu.orig.php b/hwe/d_setting/GlobalMenu.orig.php
new file mode 100644
index 00000000..53c203dd
--- /dev/null
+++ b/hwe/d_setting/GlobalMenu.orig.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace sammo;
+
+use sammo\DTO\MenuItem;
+use sammo\DTO\MenuMulti;
+use sammo\DTO\MenuSplit;
+
+//변경을 원한다면 파일을 복제 후 수정
+
+class GlobalMenu {
+  /** @var (MenuItem|MenuMulti|MenuSplit)[] */
+
+  const version = 3;
+  static ?array $menu = null;
+  public static function getMenu(): array{
+    if(static::$menu !== null){
+      return static::$menu;
+    }
+    static::$menu = [
+      new MenuItem('천통국 베팅', 'v_nationBetting.php', condHighlightVar: 'nationBetting'),
+      new MenuMulti([
+        new MenuItem('세력일람', 'a_kingdomList.php', newTab: true),
+        new MenuItem('장수일람', 'a_genList.php', newTab: true),
+        new MenuItem('명장일람', 'a_bestGeneral.php', newTab: true),
+        new MenuItem('명예의전당', 'a_hallOfFame.php', newTab: true),
+        new MenuItem('왕조일람', 'a_emperior.php', newTab: true),
+      ]),
+      new MenuItem('연감', 'v_history.php', newTab: true),
+      new MenuSplit(
+        new MenuItem('게시판', '/board/community', newTab: true),
+        [
+          new MenuItem('건의/제안', '/board/request', newTab: true),
+          new MenuItem('팁/강좌', '/board/tip', newTab: true),
+          new MenuItem('패치 내역', '/board/patch', newTab: true),
+        ]
+      ),
+      new MenuSplit(
+        new MenuItem('공식 오픈 톡', 'https://open.kakao.com/o/', newTab: true),
+        [
+          new MenuItem('잡담 오픈 톡', 'https://open.kakao.com/o/', newTab: true)
+        ],
+      ),
+      new MenuItem('전투 시뮬레이터', 'battle_simulator.php', newTab: true),
+      new MenuMulti([
+        new MenuItem('접속량정보', 'a_traffic.php', newTab: true),
+        new MenuItem('빙의일람', 'a_npcList', newTab: true, condShowVar: 'npcMode'),
+      ]),
+      new MenuItem('설문조사', 'v_vote.php', newTab: true, condHighlightVar: 'vote'),
+    ];
+    return static::$menu;
+  }
+}
\ No newline at end of file
diff --git a/hwe/sammo/API/Global/GetGlobalMenu.php b/hwe/sammo/API/Global/GetGlobalMenu.php
new file mode 100644
index 00000000..bb2507b9
--- /dev/null
+++ b/hwe/sammo/API/Global/GetGlobalMenu.php
@@ -0,0 +1,47 @@
+<?php
+
+namespace sammo\API\Global;
+
+use LDTO\DTO;
+use sammo\APICacheResult;
+use sammo\BaseAPI;
+use sammo\GlobalMenu;
+use sammo\Session;
+
+class GetGlobalMenu extends BaseAPI
+{
+  public function getRequiredSessionMode(): int
+  {
+    return self::NO_SESSION;
+  }
+  function validateArgs(): ?string
+  {
+    return null;
+  }
+
+  function launch(Session $session, ?\DateTimeInterface $modifiedSince, ?string $reqEtag)
+  {
+    if ($reqEtag !== null) {
+      $version = GlobalMenu::version;
+      if ($reqEtag == "v{$version}") {
+        return null;
+      }
+    }
+    return [
+      'result' => true,
+      'menu' => array_map(function (DTO $dto) {
+        return $dto->toArray();
+      }, GlobalMenu::getMenu()),
+    ];
+  }
+  public function tryCache(): ?APICacheResult
+  {
+    $version = GlobalMenu::version;
+    return new APICacheResult(
+      null,
+      "v{$version}",
+      60 * 60 * 6,
+      true
+    );
+  }
+}
diff --git a/hwe/sammo/DTO/MenuItem.php b/hwe/sammo/DTO/MenuItem.php
new file mode 100644
index 00000000..1c3f1231
--- /dev/null
+++ b/hwe/sammo/DTO/MenuItem.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace sammo\DTO;
+
+use LDTO\Attr\NullIsUndefined;
+use LDTO\DTO;
+
+class MenuItem extends DTO{
+  public readonly string $type;
+
+  public function __construct(
+    public readonly string $name,
+    public readonly string $url,
+
+    #[NullIsUndefined]
+    public ?string $icon = null,
+    #[NullIsUndefined]
+    public ?bool $newTab = false,
+    #[NullIsUndefined]
+    public ?string $condHighlightVar = null,
+    #[NullIsUndefined]
+    public ?string $condShowVar = null,
+  ){
+    $this->type = 'item';
+  }
+}
\ No newline at end of file
diff --git a/hwe/sammo/DTO/MenuMulti.php b/hwe/sammo/DTO/MenuMulti.php
new file mode 100644
index 00000000..e3275e9a
--- /dev/null
+++ b/hwe/sammo/DTO/MenuMulti.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace sammo\DTO;
+
+use LDTO\Attr\Convert;
+use LDTO\DTO;
+use LDTO\Converter\ArrayConverter;
+
+class MenuMulti extends DTO{
+  public readonly string $type;
+
+  /** @param MenuItem[] $subMenu */
+  public function __construct(
+    #[Convert(ArrayConverter::class, [DTO::class])]
+    public array $subMenu,
+  ){
+    $this->type = 'multi';
+  }
+}
\ No newline at end of file
diff --git a/hwe/sammo/DTO/MenuSplit.php b/hwe/sammo/DTO/MenuSplit.php
new file mode 100644
index 00000000..a01df416
--- /dev/null
+++ b/hwe/sammo/DTO/MenuSplit.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace sammo\DTO;
+
+use LDTO\Attr\Convert;
+use LDTO\Converter\ArrayConverter;
+use LDTO\DTO;
+
+class MenuSplit extends DTO{
+  public readonly string $type;
+
+  /** @param MenuItem[] $subMenu */
+  public function __construct(
+    public MenuItem $main,
+    #[Convert(ArrayConverter::class, [DTO::class])]
+    public array $subMenu,
+  ){
+    $this->type = 'split';
+  }
+}
\ No newline at end of file
diff --git a/hwe/sammo/GlobalMenu.php b/hwe/sammo/GlobalMenu.php
new file mode 100644
index 00000000..11c2fa02
--- /dev/null
+++ b/hwe/sammo/GlobalMenu.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace sammo;
+
+use sammo\DTO\MenuItem;
+use sammo\DTO\MenuMulti;
+use sammo\DTO\MenuSplit;
+
+//변경을 원한다면 d_setting/GlobalMenu.orig.php 파일을 복제 후 수정
+
+class GlobalMenu {
+  /** @var (MenuItem|MenuMulti|MenuSplit)[] */
+
+  const version = 1;
+  static ?array $menu = null;
+  public static function getMenu(): array{
+    if(static::$menu !== null){
+      return static::$menu;
+    }
+    static::$menu = [
+      new MenuItem('천통국 베팅', 'v_nationBetting.php', condHighlightVar: 'nationBetting'),
+      new MenuMulti([
+        new MenuItem('세력일람', 'a_kingdomList.php', newTab: true),
+        new MenuItem('장수일람', 'a_genList.php', newTab: true),
+        new MenuItem('명장일람', 'a_bestGeneral.php', newTab: true),
+        new MenuItem('명예의전당', 'a_hallOfFame.php', newTab: true),
+        new MenuItem('왕조일람', 'a_emperior.php', newTab: true),
+      ]),
+      new MenuItem('연감', 'v_history.php', newTab: true),
+      new MenuSplit(
+        new MenuItem('게시판', '/board/community', newTab: true),
+        [
+          new MenuItem('건의/제안', '/board/request', newTab: true),
+          new MenuItem('팁/강좌', '/board/tip', newTab: true),
+          new MenuItem('패치 내역', '/board/patch', newTab: true),
+        ]
+      ),
+      new MenuSplit(
+        new MenuItem('공식 오픈 톡', 'https://open.kakao.com/o/', newTab: true),
+        [
+          new MenuItem('잡담 오픈 톡', 'https://open.kakao.com/o/', newTab: true)
+        ],
+      ),
+      new MenuItem('전투 시뮬레이터', 'battle_simulator.php', newTab: true),
+      new MenuMulti([
+        new MenuItem('접속량정보', 'a_traffic.php', newTab: true),
+        new MenuItem('빙의일람', 'a_npcList', newTab: true, condShowVar: 'npcMode'),
+      ]),
+      new MenuItem('설문조사', 'v_vote.php', newTab: true, condHighlightVar: 'vote'),
+    ];
+    return static::$menu;
+  }
+}
\ No newline at end of file
diff --git a/hwe/ts/SammoAPI.ts b/hwe/ts/SammoAPI.ts
index 1074fb1e..0a771e93 100644
--- a/hwe/ts/SammoAPI.ts
+++ b/hwe/ts/SammoAPI.ts
@@ -28,6 +28,7 @@ import type {
   GetDiplomacyResponse,
   GetFrontInfoResponse,
   GetHistoryResponse,
+  GetMenuResponse,
 GetRecentRecordResponse,
 } from "./defs/API/Global";
 import type { CachedMapResult, CommandTableResponse, GeneralListResponse, ItemTypeKey, MapResult } from "./defs";
@@ -158,6 +159,7 @@ const apiRealPath = {
       lastGeneralRecordID: number;
       lastWorldHistoryID: number;
     } | undefined, GetRecentRecordResponse>,
+    GetGlobalMenu: GET as APICallT<undefined, GetMenuResponse>,
   },
   InheritAction: {
     BuyHiddenBuff: PUT as APICallT<{
diff --git a/hwe/ts/defs/API/Global.ts b/hwe/ts/defs/API/Global.ts
index 4ad0618a..fbc0ff69 100644
--- a/hwe/ts/defs/API/Global.ts
+++ b/hwe/ts/defs/API/Global.ts
@@ -218,3 +218,29 @@ export type GetFrontInfoResponse = {
     >;
   };
 };
+
+export type MenuItem = {
+  type: 'item';
+  name: string;
+  url: string;
+  icon?: string;
+  newTab?: boolean;
+  condHightlightVar?: string;
+  condShowVar?: string;
+}
+
+export type MenuSplit = {
+  type: 'split';
+  main: MenuItem;
+  subMenu: MenuItem[];
+}
+
+export type MenuMulti = {
+  type: 'multi';
+  subMenu: MenuItem[];
+}
+
+export type GetMenuResponse = {
+  result: true;
+  menu: (MenuItem | MenuSplit | MenuMulti)[];
+}
\ No newline at end of file