@zhin.js/plugin-text-adventure 1.0.0

package/lib/story-catalog.js

@@ -0,0 +1,104 @@
+import { SCENES } from './story-scenes.js';
+/** 区域中文名（用于地图 / 成就展示） */
+export const REGION_LABELS = {
+    start: '秘境入口',
+    rubble: '碎石廊',
+    watchtower: '瞭望石塔',
+    observatory: '星象台',
+    vine_path: '秘径',
+    corridor: '幽暗走廊',
+    mural_room: '铭文壁画',
+    whisper_gallery: '低语画廊',
+    spring: '精灵泉',
+    flooded_hall: '积水厅',
+    bell_tower: '钟楼',
+    garden: '古庭院',
+    greenhouse: '遗迹温室',
+    library: '尘封书库',
+    ember_forge: '锻炉间',
+    market_ruins: '废墟市集',
+    ghost_bridge: '冥河石桥',
+    crystal_cave: '晶洞',
+    moon_pool: '月池',
+    sunken_shrine: '水下沉殿',
+    depths: '墓穴岔口',
+    crypt_entry: '墓穴入口',
+    catacombs: '骸骨甬道',
+    ossuary: '龛室',
+    prison_cell: '囚室',
+    spider_nest: '蛛巢',
+    shadow_maze: '暗影迷宫',
+    sealed_gates: '封印密室',
+    vault: '宝藏前厅',
+    vault_open: '宝库',
+    throne_room: '王座厅',
+};
+export const ENDING_LABELS = {
+    treasure: '遗迹宝藏',
+    ascension: '星辉归位',
+    wisdom: '智者归途',
+    curse: '贪婪代价',
+    escape: '生还',
+    defeat: '陨落',
+    coward: '怯懦归途',
+    hermit: '庭院隐者',
+    redemption: '幽魂解脱',
+    drowned: '寒水沉眠',
+    spider: '茧中亡魂',
+    labyrinth: '迷宫迷失',
+    star_keeper: '星守誓约',
+    mask_king: '面具之王',
+    merchant: '行商结局',
+};
+/** 地图分区（便于 adv map 分组展示） */
+export const MAP_ZONES = [
+    {
+        name: '入口与塔',
+        sceneIds: ['start', 'rubble', 'watchtower', 'observatory', 'vine_path'],
+    },
+    {
+        name: '主廊与泉',
+        sceneIds: ['corridor', 'mural_room', 'whisper_gallery', 'spring', 'flooded_hall', 'bell_tower'],
+    },
+    {
+        name: '庭院书库',
+        sceneIds: ['garden', 'greenhouse', 'library', 'ember_forge'],
+    },
+    {
+        name: '冥域水线',
+        sceneIds: ['market_ruins', 'ghost_bridge', 'crystal_cave', 'moon_pool', 'sunken_shrine'],
+    },
+    {
+        name: '墓穴深处',
+        sceneIds: [
+            'depths',
+            'crypt_entry',
+            'catacombs',
+            'ossuary',
+            'prison_cell',
+            'spider_nest',
+            'shadow_maze',
+            'sealed_gates',
+            'vault',
+            'vault_open',
+            'throne_room',
+        ],
+    },
+];
+export function playableSceneIds() {
+    return Object.values(SCENES)
+        .filter((s) => !s.terminal)
+        .map((s) => s.id);
+}
+export function endingIds() {
+    return Object.values(SCENES)
+        .filter((s) => s.terminal)
+        .map((s) => s.id);
+}
+export function regionLabel(id) {
+    return REGION_LABELS[id] ?? ENDING_LABELS[id] ?? id;
+}
+export function endingLabel(id) {
+    return ENDING_LABELS[id] ?? id;
+}
+//# sourceMappingURL=story-catalog.js.map

package/lib/story-catalog.js.map

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

package/lib/story-items.d.ts

@@ -0,0 +1,5 @@
+/** 15 种可收集道具 */
+export declare const ITEM_LABELS: Record<string, string>;
+export declare const ITEM_IDS: string[];
+export declare function itemLabel(id: string): string;
+//# sourceMappingURL=story-items.d.ts.map

package/lib/story-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-items.d.ts","sourceRoot":"","sources":["../src/story-items.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgB9C,CAAC;AAEF,eAAO,MAAM,QAAQ,UAA2B,CAAC;AAEjD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/lib/story-items.js

@@ -0,0 +1,23 @@
+/** 15 种可收集道具 */
+export const ITEM_LABELS = {
+    torch: '火把',
+    key: '锈蚀钥匙',
+    gem: '幽蓝宝石',
+    herb: '荧光草药',
+    scroll: '残破卷轴',
+    amulet: '精灵护符',
+    silver_coin: '古银币',
+    rusted_blade: '生锈短剑',
+    moon_shard: '月华碎片',
+    elixir: '治愈灵药',
+    compass: '星象罗盘',
+    spirit_bell: '回音铃',
+    elf_feather: '银羽',
+    masquerade_mask: '仪式面具',
+    star_chart: '星图残页',
+};
+export const ITEM_IDS = Object.keys(ITEM_LABELS);
+export function itemLabel(id) {
+    return ITEM_LABELS[id] ?? id;
+}
+//# sourceMappingURL=story-items.js.map

package/lib/story-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-items.js","sourceRoot":"","sources":["../src/story-items.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,MAAM;IACvB,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAEjD,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/lib/story-path.d.ts

@@ -0,0 +1,3 @@
+/** 允许回路的最长路径（玩家可多次往返） */
+export declare function estimateLongestPlaythrough(maxDepth?: number): number;
+//# sourceMappingURL=story-path.d.ts.map

package/lib/story-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-path.d.ts","sourceRoot":"","sources":["../src/story-path.ts"],"names":[],"mappings":"AAwCA,yBAAyB;AACzB,wBAAgB,0BAA0B,CAAC,QAAQ,SAAK,GAAG,MAAM,CAiChE"}

package/lib/story-path.js

@@ -0,0 +1,66 @@
+import { SCENES } from './story-scenes.js';
+import { ITEM_IDS } from './story-items.js';
+import { resolveTransition } from './story-transitions.js';
+const OPTIMISTIC_FLAGS = {
+    spirit_met: true,
+    saw_map: true,
+    knows_sequence: true,
+    whisper_lore: true,
+    healed: true,
+    rested: true,
+    read_archive: true,
+    forged_blade: true,
+    amulet_upgraded: true,
+    moon_blessed: true,
+    shadow_banished: true,
+};
+function optimisticState(sceneId) {
+    return {
+        sceneId,
+        hp: 100,
+        inventory: [...ITEM_IDS],
+        flags: { ...OPTIMISTIC_FLAGS },
+        endingId: '',
+    };
+}
+function visibleChoiceIds(state) {
+    const scene = SCENES[state.sceneId];
+    if (!scene || scene.terminal)
+        return [];
+    return scene.choices
+        .filter((c) => !c.requires || c.requires(state))
+        .map((c) => c.id);
+}
+/** 允许回路的最长路径（玩家可多次往返） */
+export function estimateLongestPlaythrough(maxDepth = 70) {
+    let best = 0;
+    const memo = new Map();
+    function walk(sceneId, depth) {
+        if (depth >= maxDepth)
+            return depth;
+        const key = `${sceneId}:${depth}`;
+        const cached = memo.get(key);
+        if (cached != null)
+            return cached;
+        const scene = SCENES[sceneId];
+        if (scene?.terminal) {
+            best = Math.max(best, depth);
+            memo.set(key, depth);
+            return depth;
+        }
+        best = Math.max(best, depth);
+        let localBest = depth;
+        const state = optimisticState(sceneId);
+        for (const choiceId of visibleChoiceIds(state)) {
+            const result = resolveTransition(state, choiceId);
+            if (!result)
+                continue;
+            localBest = Math.max(localBest, walk(result.nextSceneId, depth + 1));
+        }
+        memo.set(key, localBest);
+        return localBest;
+    }
+    walk('start', 0);
+    return best;
+}
+//# sourceMappingURL=story-path.js.map

package/lib/story-path.js.map

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

package/lib/story-scenes.d.ts

@@ -0,0 +1,9 @@
+import type { Scene } from './story-types.js';
+/** 非终局场景 28 个 + 终局 12 个 */
+export declare const SCENES: Record<string, Scene>;
+export declare function countScenes(): {
+    total: number;
+    playable: number;
+    terminals: number;
+};
+//# sourceMappingURL=story-scenes.d.ts.map

package/lib/story-scenes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-scenes.d.ts","sourceRoot":"","sources":["../src/story-scenes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAIzD,2BAA2B;AAC3B,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAgfxC,CAAC;AAEF,wBAAgB,WAAW,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAIpF"}