@zhin.js/game-kit 1.0.1

package/lib/game-action-alias.js

@@ -0,0 +1,117 @@
+const TTT_ACTIONS = {
+    bot: 'bot',
+    join: 'join',
+    leave: 'leave',
+    quit: 'quit',
+    spectate: 'spectate',
+    help: 'help',
+    人机: 'bot',
+    排队: 'join',
+    加入: 'join',
+    离开: 'leave',
+    认输: 'quit',
+    观战: 'spectate',
+    帮助: 'help',
+};
+const ADV_ACTIONS = {
+    start: 'start',
+    continue: 'continue',
+    map: 'map',
+    achievements: 'achievements',
+    achievement: 'achievements',
+    quit: 'quit',
+    help: 'help',
+    开始: 'start',
+    继续: 'continue',
+    地图: 'map',
+    成就: 'achievements',
+    放弃: 'quit',
+    退出: 'quit',
+    帮助: 'help',
+};
+const RPS_ACTIONS = {
+    start: 'start',
+    continue: 'continue',
+    quit: 'quit',
+    help: 'help',
+    开始: 'start',
+    继续: 'continue',
+    放弃: 'quit',
+    帮助: 'help',
+};
+const GUESS_ACTIONS = {
+    start: 'start',
+    quit: 'quit',
+    help: 'help',
+    开始: 'start',
+    放弃: 'quit',
+    帮助: 'help',
+};
+const DICE_ACTIONS = {
+    start: 'start',
+    continue: 'continue',
+    quit: 'quit',
+    help: 'help',
+    开始: 'start',
+    继续: 'continue',
+    放弃: 'quit',
+    帮助: 'help',
+};
+function lookup(map, raw) {
+    const t = raw.trim();
+    if (!t)
+        return 'help';
+    return map[t] ?? map[t.toLowerCase()] ?? t.toLowerCase();
+}
+export function normalizeTttAction(raw) {
+    return lookup(TTT_ACTIONS, raw);
+}
+export function normalizeAdvAction(raw) {
+    return lookup(ADV_ACTIONS, raw);
+}
+export function normalizeRpsAction(raw) {
+    return lookup(RPS_ACTIONS, raw);
+}
+export function normalizeGuessAction(raw) {
+    return lookup(GUESS_ACTIONS, raw);
+}
+export function normalizeDiceAction(raw) {
+    return lookup(DICE_ACTIONS, raw);
+}
+const CHAIN_ACTIONS = {
+    start: 'start_pinyin',
+    start_pinyin: 'start_pinyin',
+    start_char: 'start_char',
+    continue: 'continue',
+    quit: 'quit',
+    help: 'help',
+    pinyin: 'start_pinyin',
+    char: 'start_char',
+    开始: 'start_pinyin',
+    同音: 'start_pinyin',
+    同字: 'start_char',
+    继续: 'continue',
+    放弃: 'quit',
+    帮助: 'help',
+};
+const RIDDLE_ACTIONS = {
+    start: 'start',
+    continue: 'continue',
+    quit: 'quit',
+    help: 'help',
+    char: 'char',
+    idiom: 'idiom',
+    开始: 'start',
+    继续: 'continue',
+    放弃: 'quit',
+    帮助: 'help',
+    字谜: 'char',
+    成语: 'idiom',
+};
+export function normalizeChainAction(raw) {
+    return lookup(CHAIN_ACTIONS, raw);
+}
+export function normalizeRiddleAction(raw) {
+    return lookup(RIDDLE_ACTIONS, raw);
+}
+//# sourceMappingURL=game-action-alias.js.map

package/lib/game-action-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-action-alias.js","sourceRoot":"","sources":["../src/game-action-alias.ts"],"names":[],"mappings":"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"}

package/lib/game-commands.d.ts

@@ -0,0 +1,3 @@
+/** 展示用：`/猜拳` */
+export declare function slashCommandPrefix(name: string): string;
+//# sourceMappingURL=game-commands.d.ts.map

package/lib/game-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-commands.d.ts","sourceRoot":"","sources":["../src/game-commands.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/lib/game-commands.js

@@ -0,0 +1,5 @@
+/** 展示用：`/猜拳` */
+export function slashCommandPrefix(name) {
+    return name.startsWith('/') ? name : `/${name}`;
+}
+//# sourceMappingURL=game-commands.js.map

package/lib/game-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-commands.js","sourceRoot":"","sources":["../src/game-commands.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/lib/game-hub-feature.d.ts

@@ -0,0 +1,58 @@
+import { Feature, type FeatureJSON, type Plugin, type PluginLike } from '@zhin.js/core';
+export interface GameHubContext {
+    plugin: Plugin;
+    message: import('zhin.js').Message<any>;
+}
+export interface GameMenuAction {
+    id: string;
+    label: string;
+    style?: 'primary' | 'danger' | 'secondary';
+    groupOnly?: boolean;
+    privateOnly?: boolean;
+}
+export interface RegisteredGame {
+    id: string;
+    title: string;
+    icon: string;
+    description: string;
+    commandPrefix: string;
+    quickStart?: string;
+    aliases?: string[];
+    menus: GameMenuAction[];
+    runAction: (actionId: string, ctx: GameHubContext) => Promise<string | undefined | void>;
+}
+export interface GameHubContextExtensions {
+    registerGame(game: RegisteredGame): () => void;
+}
+declare module '@zhin.js/core' {
+    namespace Plugin {
+        interface Extensions extends GameHubContextExtensions {
+        }
+        interface Contexts {
+            game: GameHubFeature;
+        }
+    }
+}
+export declare class GameHubFeature extends Feature<RegisteredGame> {
+    readonly name: "game";
+    readonly icon = "Gamepad2";
+    readonly desc = "\u6E38\u620F";
+    private readonly byId;
+    private hubDisposers;
+    register(game: RegisteredGame, pluginName: string): () => void;
+    getGame(id: string): RegisteredGame | undefined;
+    remove(item: RegisteredGame, pluginName?: string): boolean;
+    toJSON(pluginName?: string): FeatureJSON;
+    get extensions(): {
+        registerGame(game: RegisteredGame): () => void;
+    };
+    mounted(plugin: PluginLike): void;
+    dispose(): void;
+}
+/**
+ * 在 root 上注册 `game` 服务（幂等）。游戏插件初始化时调用一次即可。
+ */
+export declare function ensureGameHubService(plugin: Plugin): GameHubFeature;
+export declare function getRegisteredGames(): readonly RegisteredGame[];
+export declare function getRegisteredGame(id: string): RegisteredGame | undefined;
+//# sourceMappingURL=game-hub-feature.d.ts.map

package/lib/game-hub-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-hub-feature.d.ts","sourceRoot":"","sources":["../src/game-hub-feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAwB,MAAM,eAAe,CAAC;AAIzH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;CAC1F;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;CAChD;AAED,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,MAAM,CAAC;QACf,UAAU,UAAW,SAAQ,wBAAwB;SAAG;QACxD,UAAU,QAAQ;YAChB,IAAI,EAAE,cAAc,CAAC;SACtB;KACF;CACF;AAID,qBAAa,cAAe,SAAQ,OAAO,CAAC,cAAc,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,IAAI,kBAAQ;IAErB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAsB;IAE1C,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAS9D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAItC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAKnE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAexC,IAAI,UAAU;2BAGS,cAAc,SApCqB,IAAI;MA6C7D;IAED,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAgBjC,OAAO,IAAI,IAAI;CAOhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAenE;AAED,wBAAgB,kBAAkB,IAAI,SAAS,cAAc,EAAE,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE"}

package/lib/game-hub-feature.js

@@ -0,0 +1,100 @@
+import { Feature, getPlugin } from '@zhin.js/core';
+import { mountGameHubUi, markGameHubUiMounted } from './game-hub-mount.js';
+import { registerGameRecordModels, initGameRecordDatabase } from './game-records.js';
+let activeFeature = null;
+export class GameHubFeature extends Feature {
+    name = 'game';
+    icon = 'Gamepad2';
+    desc = '游戏';
+    byId = new Map();
+    hubDisposers = [];
+    register(game, pluginName) {
+        const prev = this.byId.get(game.id);
+        if (prev) {
+            this.remove(prev);
+        }
+        this.byId.set(game.id, game);
+        return this.add(game, pluginName);
+    }
+    getGame(id) {
+        return this.byId.get(id);
+    }
+    remove(item, pluginName) {
+        this.byId.delete(item.id);
+        return super.remove(item, pluginName);
+    }
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : [...this.items];
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map((g) => ({
+                name: g.id,
+                desc: g.title,
+                usage: `${g.commandPrefix} ${g.quickStart ?? '开始'}`,
+            })),
+        };
+    }
+    get extensions() {
+        const feature = this;
+        return {
+            registerGame(game) {
+                const plugin = getPlugin();
+                ensureGameHubService(plugin);
+                const dispose = feature.register(game, plugin.name);
+                plugin.recordFeatureContribution(feature.name, game.id);
+                plugin.onDispose(dispose);
+                return dispose;
+            },
+        };
+    }
+    mounted(plugin) {
+        activeFeature = this;
+        const root = plugin;
+        const host = root.root ?? root;
+        registerGameRecordModels(host);
+        if (host.contextIsReady('database')) {
+            initGameRecordDatabase(host.inject('database'));
+        }
+        else {
+            host.useContext('database', (dbFeature) => {
+                initGameRecordDatabase(dbFeature);
+            });
+        }
+        this.hubDisposers = mountGameHubUi(host);
+        markGameHubUiMounted();
+    }
+    dispose() {
+        for (const d of this.hubDisposers)
+            d();
+        this.hubDisposers = [];
+        if (activeFeature === this) {
+            activeFeature = null;
+        }
+    }
+}
+/**
+ * 在 root 上注册 `game` 服务（幂等）。游戏插件初始化时调用一次即可。
+ */
+export function ensureGameHubService(plugin) {
+    const root = plugin.root;
+    if (root.contextIsReady('game')) {
+        return root.inject('game');
+    }
+    const feature = new GameHubFeature();
+    root.provide(feature);
+    activeFeature = feature;
+    if (root.started && feature.mounted) {
+        feature.mounted(root);
+    }
+    return root.inject('game');
+}
+export function getRegisteredGames() {
+    return activeFeature?.items ?? [];
+}
+export function getRegisteredGame(id) {
+    return activeFeature?.getGame(id);
+}
+//# sourceMappingURL=game-hub-feature.js.map

package/lib/game-hub-feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-hub-feature.js","sourceRoot":"","sources":["../src/game-hub-feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAwE,MAAM,eAAe,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAwCrF,IAAI,aAAa,GAA0B,IAAI,CAAC;AAEhD,MAAM,OAAO,cAAe,SAAQ,OAAuB;IAChD,IAAI,GAAG,MAAe,CAAC;IACvB,IAAI,GAAG,UAAU,CAAC;IAClB,IAAI,GAAG,IAAI,CAAC;IAEJ,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,YAAY,GAAmB,EAAE,CAAC;IAE1C,QAAQ,CAAC,IAAoB,EAAE,UAAkB;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAEQ,MAAM,CAAC,IAAoB,EAAE,UAAmB;QACvD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,UAAmB;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,CAAC,CAAC,EAAE;gBACV,IAAI,EAAE,CAAC,CAAC,KAAK;gBACb,KAAK,EAAE,GAAG,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,EAAE;aACpD,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED,IAAI,UAAU;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,OAAO;YACL,YAAY,CAAC,IAAoB;gBAC/B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACpD,MAAM,CAAC,yBAAyB,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAkB;QACxB,aAAa,GAAG,IAAI,CAAC;QACrB,MAAM,IAAI,GAAG,MAAgB,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAC/B,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAoB,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,SAA0B,EAAE,EAAE;gBACzD,sBAAsB,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACzC,oBAAoB,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACL,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY;YAAE,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAmB,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,aAAa,GAAG,OAAO,CAAC;IAExB,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAmB,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/lib/game-hub-flow.d.ts

@@ -0,0 +1,9 @@
+import type { Message, Plugin } from '@zhin.js/core';
+import { buildMainHubMenu } from './game-hub-menu.js';
+export declare function openMainMenu(message: Message<any>): ReturnType<typeof buildMainHubMenu> | string;
+export declare function handleHubChoice(plugin: Plugin, message: Message<any>, scopeId: string, choiceId: string): Promise<boolean>;
+export declare function parseHubPayload(payload: string): {
+    scopeId: string;
+    choiceId: string;
+} | null;
+//# sourceMappingURL=game-hub-flow.d.ts.map

package/lib/game-hub-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-hub-flow.d.ts","sourceRoot":"","sources":["../src/game-hub-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAEL,gBAAgB,EAMjB,MAAM,oBAAoB,CAAC;AAkC5B,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAAG,MAAM,CAShG;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CA+ClB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI7F"}

package/lib/game-hub-flow.js

@@ -0,0 +1,90 @@
+import { parseChoicePayload } from './choice-keyboard.js';
+import { buildGameHubMenu, buildMainHubMenu, formatHubEmptyMessage, HUB_PREFIX, hubActionChoiceId, hubGameChoiceId, parseHubChoiceId, } from './game-hub-menu.js';
+import { getRegisteredGame, getRegisteredGames } from './game-hub-feature.js';
+import { createHubScope, getHubContext, rememberHubMenu, } from './game-hub-menu-context.js';
+function mainMenuChoices() {
+    return getRegisteredGames().map((g) => ({
+        id: hubGameChoiceId(g.id),
+        label: `${g.icon} ${g.title}`,
+    }));
+}
+function gameMenuChoices(gameId, channelType) {
+    const game = getRegisteredGame(gameId);
+    if (!game)
+        return [];
+    const isGroup = channelType !== 'private';
+    const menus = game.menus.filter((m) => {
+        if (m.groupOnly && !isGroup)
+            return false;
+        if (m.privateOnly && isGroup)
+            return false;
+        return true;
+    });
+    return [
+        ...menus.map((m) => ({
+            id: hubActionChoiceId(game.id, m.id),
+            label: m.label,
+        })),
+        { id: 'back', label: '↩️ 返回大厅' },
+    ];
+}
+export function openMainMenu(message) {
+    const games = getRegisteredGames();
+    if (!games.length) {
+        return formatHubEmptyMessage();
+    }
+    const scopeId = createHubScope(message);
+    const choices = mainMenuChoices();
+    rememberHubMenu(message, scopeId, choices);
+    return buildMainHubMenu(scopeId, games, message.$channel.type);
+}
+export async function handleHubChoice(plugin, message, scopeId, choiceId) {
+    const ctx = getHubContext(scopeId);
+    if (!ctx) {
+        await message.$reply?.('菜单已过期，请重新发送「游戏」。');
+        return true;
+    }
+    const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+    if (ctx.channelKey !== ch) {
+        await message.$reply?.('请在本频道使用游戏大厅。');
+        return true;
+    }
+    const parsed = parseHubChoiceId(choiceId);
+    if (!parsed)
+        return false;
+    // 大厅导航（选游戏 / 返回）：同频道任何人都可点；具体开局由 runAction 用当前点击者 message
+    if (parsed.kind === 'back') {
+        const games = getRegisteredGames();
+        const choices = mainMenuChoices();
+        rememberHubMenu(message, scopeId, choices);
+        await message.$reply?.(buildMainHubMenu(scopeId, games, message.$channel.type));
+        return true;
+    }
+    if (parsed.kind === 'game') {
+        const game = getRegisteredGame(parsed.gameId);
+        if (!game) {
+            await message.$reply?.('该游戏未安装。');
+            return true;
+        }
+        const choices = gameMenuChoices(parsed.gameId, message.$channel.type);
+        rememberHubMenu(message, scopeId, choices);
+        await message.$reply?.(buildGameHubMenu(scopeId, game, message.$channel.type));
+        return true;
+    }
+    const game = getRegisteredGame(parsed.gameId);
+    if (!game) {
+        await message.$reply?.('该游戏未安装。');
+        return true;
+    }
+    const result = await game.runAction(parsed.actionId, { plugin, message });
+    if (typeof result === 'string')
+        await message.$reply?.(result);
+    return true;
+}
+export function parseHubPayload(payload) {
+    const parsed = parseChoicePayload(payload, HUB_PREFIX);
+    if (!parsed)
+        return null;
+    return { scopeId: parsed.sessionId, choiceId: parsed.choiceId };
+}
+//# sourceMappingURL=game-hub-flow.js.map

package/lib/game-hub-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-hub-flow.js","sourceRoot":"","sources":["../src/game-hub-flow.ts"],"names":[],"mappings":"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"}

package/lib/game-hub-menu-context.d.ts

@@ -0,0 +1,25 @@
+import type { Message } from '@zhin.js/core';
+export interface HubMenuContext {
+    channelKey: string;
+    /** 打开菜单的用户（仅记录，大厅导航不限制点击者） */
+    openerId: string;
+    message: Message<any>;
+    expiresAt: number;
+}
+export interface HubMenuChoice {
+    id: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface LastHubMenu {
+    scopeId: string;
+    choices: HubMenuChoice[];
+    expiresAt: number;
+}
+export declare function createHubScope(message: Message<any>): string;
+export declare function rememberHubMenu(message: Message<any>, scopeId: string, choices: HubMenuChoice[]): void;
+export declare function getLastHubMenu(message: Message<any>): LastHubMenu | null;
+export declare function getHubContext(scopeId: string): HubMenuContext | null;
+/** 测试专用：清空菜单上下文 */
+export declare function resetHubMenuContextForTests(): void;
+//# sourceMappingURL=game-hub-menu-context.d.ts.map

package/lib/game-hub-menu-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-hub-menu-context.d.ts","sourceRoot":"","sources":["../src/game-hub-menu-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAU5D;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EAAE,GACvB,IAAI,CAON;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,GAAG,IAAI,CASxE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAQpE;AAYD,mBAAmB;AACnB,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/lib/game-hub-menu-context.js

@@ -0,0 +1,64 @@
+import { channelKey } from './board-sender.js';
+import { generateCompactId } from './random.js';
+const TTL_MS = 60 * 60 * 1000;
+const contexts = new Map();
+const lastMenus = new Map();
+/** 大厅 fallback 按频道共享，任意成员可回复数字或点按钮 */
+function hubMenuKey(message) {
+    return channelKey(message);
+}
+export function createHubScope(message) {
+    const scopeId = generateCompactId('h');
+    contexts.set(scopeId, {
+        channelKey: channelKey(message),
+        openerId: message.$sender.id,
+        message,
+        expiresAt: Date.now() + TTL_MS,
+    });
+    pruneExpired();
+    return scopeId;
+}
+export function rememberHubMenu(message, scopeId, choices) {
+    lastMenus.set(hubMenuKey(message), {
+        scopeId,
+        choices,
+        expiresAt: Date.now() + TTL_MS,
+    });
+    pruneExpired();
+}
+export function getLastHubMenu(message) {
+    pruneExpired();
+    const key = hubMenuKey(message);
+    const last = lastMenus.get(key);
+    if (!last || last.expiresAt < Date.now()) {
+        lastMenus.delete(key);
+        return null;
+    }
+    return last;
+}
+export function getHubContext(scopeId) {
+    pruneExpired();
+    const ctx = contexts.get(scopeId);
+    if (!ctx || ctx.expiresAt < Date.now()) {
+        contexts.delete(scopeId);
+        return null;
+    }
+    return ctx;
+}
+function pruneExpired() {
+    const now = Date.now();
+    for (const [id, ctx] of contexts) {
+        if (ctx.expiresAt < now)
+            contexts.delete(id);
+    }
+    for (const [key, menu] of lastMenus) {
+        if (menu.expiresAt < now)
+            lastMenus.delete(key);
+    }
+}
+/** 测试专用：清空菜单上下文 */
+export function resetHubMenuContextForTests() {
+    contexts.clear();
+    lastMenus.clear();
+}
+//# sourceMappingURL=game-hub-menu-context.js.map

package/lib/game-hub-menu-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-hub-menu-context.js","sourceRoot":"","sources":["../src/game-hub-menu-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAsBhD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;AACnD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEjD,sCAAsC;AACtC,SAAS,UAAU,CAAC,OAAqB;IACvC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE;QACpB,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;QAC5B,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM;KAC/B,CAAC,CAAC;IACH,YAAY,EAAE,CAAC;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAqB,EACrB,OAAe,EACf,OAAwB;IAExB,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;QACjC,OAAO;QACP,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM;KAC/B,CAAC,CAAC;IACH,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,YAAY,EAAE,CAAC;IACf,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACzC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,YAAY,EAAE,CAAC;IACf,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;QACjC,IAAI,GAAG,CAAC,SAAS,GAAG,GAAG;YAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,SAAS,GAAG,GAAG;YAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,2BAA2B;IACzC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}

package/lib/game-hub-menu.d.ts

@@ -0,0 +1,37 @@
+import { type SendContent } from '@zhin.js/core';
+import type { RegisteredGame } from './game-hub-feature.js';
+import { type CommandHelpSource } from './command-help.js';
+export declare const HUB_PREFIX = "hub";
+export declare function hubGameChoiceId(gameId: string): string;
+export declare function hubActionChoiceId(gameId: string, actionId: string): string;
+export declare function parseHubChoiceId(choiceId: string): {
+    kind: 'game';
+    gameId: string;
+} | {
+    kind: 'action';
+    gameId: string;
+    actionId: string;
+} | {
+    kind: 'back';
+} | null;
+export declare function buildMainHubMenu(scopeId: string, games: readonly RegisteredGame[], channelType: string): SendContent;
+export declare function buildGameHubMenu(scopeId: string, game: RegisteredGame, channelType: string): SendContent;
+/** 大厅主菜单：命令前缀提示 */
+export declare function formatCommandPrefixHint(games: readonly RegisteredGame[]): string;
+/** 游戏大厅帮助文案（随 registerGame 动态生成） */
+export declare function formatHubHelp(games: readonly RegisteredGame[], commands?: readonly CommandHelpSource[]): string;
+/** 顶层 /帮助：游戏大厅 + 已注册命令自动汇总 */
+export declare function formatBotHelp(games: readonly RegisteredGame[], options?: {
+    channelType?: string;
+    commands?: readonly CommandHelpSource[];
+}): string;
+/** 顶层 /帮助：HTML 卡片（QQ 等出站 policy 为 image 时渲染为 PNG；无 renderer 时回退文本） */
+export declare function buildBotHelpReply(games: readonly RegisteredGame[], options?: {
+    channelType?: string;
+    commands?: readonly CommandHelpSource[];
+}): SendContent;
+/** /游戏 帮助：大厅专用卡片 */
+export declare function buildHubHelpReply(games: readonly RegisteredGame[], commands?: readonly CommandHelpSource[]): SendContent;
+/** 无游戏时的提示 */
+export declare function formatHubEmptyMessage(): string;
+//# sourceMappingURL=game-hub-menu.d.ts.map

package/lib/game-hub-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-hub-menu.d.ts","sourceRoot":"","sources":["../src/game-hub-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAQ3B,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAEd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB,IAAI,CAcP;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,WAAW,EAAE,MAAM,GAClB,WAAW,CA4Bb;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,WAAW,EAAE,MAAM,GAClB,WAAW,CAyBb;AAED,mBAAmB;AACnB,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAKhF;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,GACtC,MAAM,CAsBR;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACzC,GACA,MAAM,CAoBR;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACzC,GACA,WAAW,CAab;AAED,oBAAoB;AACpB,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,GACtC,WAAW,CASb;AAED,cAAc;AACd,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C"}