feat: add puzzle clear template runtime

src/components/platform-entry/platformEntryTypes.ts

@@ -36,6 +36,10 @@ export type SelectionStage =
   | 'jump-hop-result'
   | 'jump-hop-runtime'
   | 'jump-hop-gallery-detail'
+  | 'puzzle-clear-workspace'
+  | 'puzzle-clear-generating'
+  | 'puzzle-clear-result'
+  | 'puzzle-clear-runtime'
   | 'bark-battle-workspace'
   | 'bark-battle-generating'
   | 'bark-battle-result'

src/components/platform-entry/platformGenerationProgressClock.test.ts

@@ -0,0 +1,73 @@
+import { describe, expect, test } from 'vitest';
+
+import { createMiniGameDraftGenerationState } from '../../services/miniGameDraftGenerationProgress';
+import { shouldTickPlatformGenerationProgressClock } from './platformGenerationProgressClock';
+
+describe('platformGenerationProgressClock', () => {
+  test('ticks while puzzle clear generation is still running', () => {
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'puzzle-clear-generating',
+        generationState: createMiniGameDraftGenerationState('puzzle-clear'),
+      }),
+    ).toBe(true);
+  });
+
+  test('stops ticking after puzzle clear generation is ready or failed', () => {
+    const runningState = createMiniGameDraftGenerationState('puzzle-clear');
+
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'puzzle-clear-generating',
+        generationState: { ...runningState, phase: 'ready' },
+      }),
+    ).toBe(false);
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'puzzle-clear-generating',
+        generationState: { ...runningState, phase: 'failed' },
+      }),
+    ).toBe(false);
+  });
+
+  test('ticks for other shared mini game generation stages', () => {
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'jump-hop-generating',
+        generationState: createMiniGameDraftGenerationState('jump-hop'),
+      }),
+    ).toBe(true);
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'wooden-fish-generating',
+        generationState: createMiniGameDraftGenerationState('wooden-fish'),
+      }),
+    ).toBe(true);
+  });
+
+  test('ticks visual novel generation from its phase source', () => {
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'visual-novel-generating',
+        visualNovelGenerationStartedAtMs: 1000,
+        visualNovelGenerationPhase: 'generating',
+      }),
+    ).toBe(true);
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'visual-novel-generating',
+        visualNovelGenerationStartedAtMs: 1000,
+        visualNovelGenerationPhase: 'ready',
+      }),
+    ).toBe(false);
+  });
+
+  test('does not tick when no generating stage is active', () => {
+    expect(
+      shouldTickPlatformGenerationProgressClock({
+        selectionStage: 'platform',
+        generationState: createMiniGameDraftGenerationState('puzzle-clear'),
+      }),
+    ).toBe(false);
+  });
+});

src/components/platform-entry/platformGenerationProgressClock.ts

@@ -0,0 +1,36 @@
+import type { MiniGameDraftGenerationState } from '../../services/miniGameDraftGenerationProgress';
+import type { SelectionStage } from './platformEntryTypes';
+
+type VisualNovelEntryGenerationPhase = 'generating' | 'ready' | 'failed';
+
+type PlatformGenerationProgressClockInput = {
+  selectionStage: SelectionStage;
+  generationState?: MiniGameDraftGenerationState | null;
+  visualNovelGenerationStartedAtMs?: number | null;
+  visualNovelGenerationPhase?: VisualNovelEntryGenerationPhase;
+};
+
+export function shouldTickPlatformGenerationProgressClock({
+  selectionStage,
+  generationState,
+  visualNovelGenerationStartedAtMs,
+  visualNovelGenerationPhase,
+}: PlatformGenerationProgressClockInput) {
+  if (selectionStage === 'visual-novel-generating') {
+    return (
+      visualNovelGenerationStartedAtMs != null &&
+      visualNovelGenerationPhase !== 'ready' &&
+      visualNovelGenerationPhase !== 'failed'
+    );
+  }
+
+  if (!selectionStage.endsWith('-generating')) {
+    return false;
+  }
+
+  return Boolean(
+    generationState &&
+      generationState.phase !== 'ready' &&
+      generationState.phase !== 'failed',
+  );
+}