抓大鹅B3实现

packages/shared/src/contracts/match3dAgent.ts

@@ -1,6 +1,13 @@
+/**
+ * 抓大鹅 Match3D 创作 Agent 共享契约。
+ * 字段按 HTTP facade 的 camelCase DTO 命名，后端领域层 snake_case 字段由 facade 映射。
+ */
 export type Match3DCreationStage =
+  | 'collecting'
   | 'collecting_config'
+  | 'ready_to_compile'
   | 'draft_ready'
+  | 'draft_compiled'
   | 'ready_to_publish'
   | 'published'
   | string;

packages/shared/src/contracts/match3dRuntime.ts

@@ -1,3 +1,7 @@
+/**
+ * 抓大鹅 Match3D 运行态共享契约。
+ * 前端可以使用 Flying 做即时表现；后端权威快照只应返回 InBoard、InTray、Cleared。
+ */
 export type Match3DRunStatus =
   | 'running'
   | 'won'

packages/shared/src/contracts/match3dWorks.ts

@@ -1,3 +1,7 @@
+/**
+ * 抓大鹅 Match3D 作品读写共享契约。
+ * 首版作品发布必须补齐游戏名称、标签、封面、题材、消除次数和难度。
+ */
 export type Match3DWorkPublicationStatus = 'draft' | 'published' | string;
 
 export interface PutMatch3DWorkRequest {

packages/shared/src/index.ts

@@ -3,14 +3,6 @@ export * from './contracts/auth';
 export type * from './contracts/bigFish';
 export * from './contracts/common';
 export type * from './contracts/customWorldAgent';
-export * from './contracts/rpgAgentActions';
-export * from './contracts/rpgAgentAnchors';
-export * from './contracts/rpgAgentDraft';
-export * from './contracts/rpgAgentSession';
-export * from './contracts/rpgCreationFixtures';
-export * from './contracts/rpgCreationPreview';
-export * from './contracts/rpgCreationResultView';
-export * from './contracts/rpgCreationWorkSummary';
 export * from './contracts/match3dAgent';
 export * from './contracts/match3dRuntime';
 export * from './contracts/match3dWorks';
@@ -20,6 +12,14 @@ export * from './contracts/puzzleAgentSession';
 export * from './contracts/puzzleResultPreview';
 export * from './contracts/puzzleRuntimeSession';
 export * from './contracts/puzzleWorkSummary';
+export * from './contracts/rpgAgentActions';
+export * from './contracts/rpgAgentAnchors';
+export * from './contracts/rpgAgentDraft';
+export * from './contracts/rpgAgentSession';
+export * from './contracts/rpgCreationFixtures';
+export * from './contracts/rpgCreationPreview';
+export * from './contracts/rpgCreationResultView';
+export * from './contracts/rpgCreationWorkSummary';
 export * from './contracts/rpgRuntimeChat';
 export * from './contracts/rpgRuntimeQuestAssist';
 export * from './contracts/rpgRuntimeStoryAction';