refactor: 收口公开详情启动意图

src/components/platform-entry/platformPublicWorkDetailFlow.ts

@@ -4,6 +4,7 @@ import type {
   JumpHopGalleryCardResponse,
   JumpHopWorkProfileResponse,
 } from '../../../packages/shared/src/contracts/jumpHop';
+import type { Match3DWorkSummary } from '../../../packages/shared/src/contracts/match3dWorks';
 import type { PuzzleRunSnapshot } from '../../../packages/shared/src/contracts/puzzleRuntimeSession';
 import type { PuzzleWorkSummary } from '../../../packages/shared/src/contracts/puzzleWorkSummary';
 import type { CustomWorldGalleryCard } from '../../../packages/shared/src/contracts/runtime';
@@ -121,6 +122,72 @@ export type PlatformPublicWorkRemixIntent =
       errorMessage: string;
     };
 
+export type PlatformPublicWorkStartIntent =
+  | {
+      type: 'blocked';
+      errorMessage: string;
+    }
+  | {
+      type: 'start-big-fish';
+      work: BigFishWorkSummary;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'start-puzzle';
+      work: PuzzleWorkSummary;
+      returnStage: 'work-detail';
+      authMode: 'isolated';
+    }
+  | {
+      type: 'start-jump-hop';
+      profileId: string;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'start-wooden-fish';
+      profileId: string;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'start-match3d';
+      work: Match3DWorkSummary;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'start-square-hole';
+      work: SquareHoleWorkSummary;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'start-visual-novel';
+      profileId: string;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'start-bark-battle';
+      work: BarkBattleWorkSummary;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'start-edutainment';
+      entry: PlatformPublicGalleryCard;
+      returnStage: 'work-detail';
+    }
+  | {
+      type: 'record-rpg-gallery-play';
+      entry: CustomWorldGalleryCard;
+    };
+
+export type PlatformPublicWorkStartIntentDeps = {
+  selectedPuzzleDetail?: PuzzleWorkSummary | null;
+  selectedRpgDetailEntry?: CustomWorldGalleryCard | null;
+  barkBattleGalleryEntries?: readonly BarkBattleWorkSummary[];
+  barkBattleWorks?: readonly BarkBattleWorkSummary[];
+  mapMatch3DWork: (
+    entry: PlatformPublicGalleryCard,
+  ) => Match3DWorkSummary | null;
+};
+
 export type PlatformPublicWorkDetailOpenDecision =
   | {
       type: 'blocked';
@@ -622,6 +689,149 @@ export function resolvePlatformPublicWorkRemixIntent(
   };
 }
 
+export function resolvePlatformPublicWorkStartIntent(
+  entry: PlatformPublicGalleryCard,
+  deps: PlatformPublicWorkStartIntentDeps,
+): PlatformPublicWorkStartIntent {
+  if (isBigFishGalleryEntry(entry)) {
+    const work = mapPublicWorkDetailToBigFishWork(entry);
+    if (!work) {
+      return {
+        type: 'blocked',
+        errorMessage: '当前作品缺少会话信息，暂时无法进入玩法。',
+      };
+    }
+
+    return {
+      type: 'start-big-fish',
+      work,
+      returnStage: 'work-detail',
+    };
+  }
+
+  if (isPuzzleGalleryEntry(entry)) {
+    const work =
+      deps.selectedPuzzleDetail?.profileId === entry.profileId
+        ? deps.selectedPuzzleDetail
+        : mapPublicWorkDetailToPuzzleWork(entry);
+    if (!work) {
+      return {
+        type: 'blocked',
+        errorMessage: '当前拼图作品信息不完整，暂时无法进入玩法。',
+      };
+    }
+
+    return {
+      type: 'start-puzzle',
+      work,
+      returnStage: 'work-detail',
+      authMode: 'isolated',
+    };
+  }
+
+  if (isJumpHopGalleryEntry(entry)) {
+    return {
+      type: 'start-jump-hop',
+      profileId: entry.profileId,
+      returnStage: 'work-detail',
+    };
+  }
+
+  if (isWoodenFishGalleryEntry(entry)) {
+    return {
+      type: 'start-wooden-fish',
+      profileId: entry.profileId,
+      returnStage: 'work-detail',
+    };
+  }
+
+  if (isMatch3DGalleryEntry(entry)) {
+    // 中文注释：抓大鹅运行态素材归一仍归 Match3D Module，公开详情 Flow 只接其 Adapter。
+    const work = deps.mapMatch3DWork(entry);
+    if (!work) {
+      return {
+        type: 'blocked',
+        errorMessage: '当前抓大鹅作品信息不完整，暂时无法进入玩法。',
+      };
+    }
+
+    return {
+      type: 'start-match3d',
+      work,
+      returnStage: 'work-detail',
+    };
+  }
+
+  if (isSquareHoleGalleryEntry(entry)) {
+    const work = mapPublicWorkDetailToSquareHoleWork(entry);
+    if (!work) {
+      return {
+        type: 'blocked',
+        errorMessage: '当前方洞挑战作品信息不完整，暂时无法进入玩法。',
+      };
+    }
+
+    return {
+      type: 'start-square-hole',
+      work,
+      returnStage: 'work-detail',
+    };
+  }
+
+  if (isVisualNovelGalleryEntry(entry)) {
+    return {
+      type: 'start-visual-novel',
+      profileId: entry.profileId,
+      returnStage: 'work-detail',
+    };
+  }
+
+  if (isBarkBattleGalleryEntry(entry)) {
+    const work =
+      deps.barkBattleGalleryEntries?.find(
+        (item) => item.workId === entry.workId,
+      ) ??
+      deps.barkBattleWorks?.find((item) => item.workId === entry.workId) ??
+      mapBarkBattlePublicDetailToWorkSummary(entry);
+    if (!work) {
+      return {
+        type: 'blocked',
+        errorMessage: '当前汪汪声浪作品信息不完整，暂时无法进入玩法。',
+      };
+    }
+
+    return {
+      type: 'start-bark-battle',
+      work,
+      returnStage: 'work-detail',
+    };
+  }
+
+  if (isEdutainmentGalleryEntry(entry)) {
+    return {
+      type: 'start-edutainment',
+      entry,
+      returnStage: 'work-detail',
+    };
+  }
+
+  const launchEntry =
+    deps.selectedRpgDetailEntry?.profileId === entry.profileId
+      ? deps.selectedRpgDetailEntry
+      : null;
+  if (!launchEntry) {
+    return {
+      type: 'blocked',
+      errorMessage: '作品详情尚未读取完成。',
+    };
+  }
+
+  return {
+    type: 'record-rpg-gallery-play',
+    entry: launchEntry,
+  };
+}
+
 export function resolvePlatformPublicWorkDetailOpenDecision(
   entry: PlatformPublicGalleryCard,
   deps: PlatformPublicWorkDetailOpenDecisionDeps = {},